react-snackbar-glass 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.0] - 2026-10-28
+
+### Added
+
+- `layout` option: `'card' | 'compact' | 'inline'`, available per snackbar,
+  on `<SnackbarProvider layout="…">` and in the store config. `compact: true`
+  keeps working as sugar for `layout: 'compact'`.
+- `toast.single(message, options)` / `useSnackbar().single()`: message-only
+  status line with a hard one-line contract (ellipsis instead of wrapping),
+  no title, no hairline, and no close button while timed.
+- Animation presets: `animation`, `enterAnimation` and `exitAnimation`
+  (`'slide' | 'fade' | 'scale' | 'pop' | 'flip' | 'none'`).
+- `--prs-enter-duration` / `--prs-exit-duration` and `--prs-radius-inline`
+  CSS variables for pacing and shaping the new modes.
+- Demo: layout and motion selectors in the Studio panel, `toast.single()`
+  example, and position buttons now confirm with a single-line toast.
+
 ## [1.2.0] - 2026-10-28
 
 ### Added

package/README.md

@@ -9,6 +9,8 @@ dependencies**.
 - ⏳ **Promise aware** — one call moves a snackbar through loading → success → error
 - 👆 **Swipe to dismiss**, hover/focus/document-hidden pause, countdown hairline
 - 📦 **Compact + minimize** — one-line pills, or collapse the whole stack
+- ✏️ **Single-line status** — `toast.single()` for instant, title-less feedback
+- 🎞️ **Pick your motion** — slide, fade, scale, pop, flip or none
 - ♿ **Accessible** — polite/assertive live regions, keyboard reachable actions, `prefers-reduced-motion`
 - 🧩 **Typed** — written in TypeScript, ships ESM + CJS + `.d.ts`
 - 🪶 **Tiny** — React is the only peer dependency
@@ -162,6 +164,9 @@ the snackbar only closes after the handler settles (`closeOnClick`, default
 | `dismissible` | `boolean` | `true` | Show the close button. |
 | `progress` | `boolean` | `true` | Show the countdown hairline. |
 | `compact` | `boolean` | `false` | Single-line pill for every snackbar. |
+| `layout` | `'card' \| 'compact' \| 'inline'` | `'card'` | Default layout; `compact` is sugar for `'compact'`. |
+| `animation` | `'slide' \| 'fade' \| 'scale' \| 'pop' \| 'flip' \| 'none'` | `'slide'` | Enter + exit animation preset. |
+| `enterAnimation` / `exitAnimation` | same as `animation` | — | Override a single phase. |
 | `minimizedLabel` | `(count: number) => ReactNode` | `"3 notifications"` | Text on the collapsed pill. |
 | `pauseOnHover` | `boolean` | `true` | Freeze the timer while hovered. |
 | `pauseOnFocus` | `boolean` | `true` | Freeze the timer while focus is inside. |
@@ -178,12 +183,55 @@ the snackbar only closes after the handler settles (`closeOnClick`, default
 ## `SnackbarOptions`
 
 `id`, `title`, `message`, `variant`, `duration`, `position`, `icon`,
-`action`, `dismissible`, `progress`, `compact`, `tone`, `size`, `className`,
-`style`, `onOpen`, `onClose`.
+`action`, `dismissible`, `progress`, `compact`, `layout`, `animation`,
+`enterAnimation`, `exitAnimation`, `tone`, `size`, `className`, `style`,
+`onOpen`, `onClose`.
 
 Reusing an `id` updates (or revives) the existing snackbar instead of stacking
 a duplicate — ideal for progress-style flows.
 
+## Single-line status notices
+
+`toast.single()` is the "one line, no ceremony" preset: content width, a hard
+one-line contract (long text truncates with an ellipsis instead of wrapping),
+no title, no countdown hairline and no close button while it is timed.
+
+```ts
+toast.single('Position set to top-center', { variant: 'success' });
+toast.single('Could not reach the server', { variant: 'error', duration: 8000 });
+```
+
+It is `layout: 'inline'` under the hood, so every entry point can do the same:
+
+```ts
+snackbar.show({ message: 'Synced', layout: 'inline' });
+useSnackbar().single('Copied to clipboard');
+<SnackbarProvider layout="inline" />;
+```
+
+## Animations
+
+One preset drives both phases; `enterAnimation` / `exitAnimation` override a
+single phase:
+
+```ts
+toast.success('Saved', { animation: 'fade' });
+toast.error('Failed', { animation: 'scale', exitAnimation: 'none' });
+<SnackbarProvider animation="pop" />;
+```
+
+| Preset | Feel |
+| --- | --- |
+| `slide` | Spring slide from the nearest edge with a soft blur (default). |
+| `fade` | Pure opacity cross-fade. |
+| `scale` | Zoom from the center. |
+| `pop` | Bouncy overshoot. |
+| `flip` | 3D flip on the X axis. |
+| `none` | Instant, no motion. |
+
+Pace them with `--prs-enter-duration` / `--prs-exit-duration` (defaults
+`440ms` / `190ms`); `prefers-reduced-motion` still disables everything.
+
 ## Compact and minimized stacks
 
 Two ways to reclaim screen space when snackbars would otherwise pile up.

package/dist/index.cjs

@@ -11,7 +11,10 @@ var DEFAULT_CONFIG = {
   duration: 5e3,
   dismissible: true,
   progress: true,
-  compact: false,
+  layout: "card",
+  animation: "slide",
+  enterAnimation: "slide",
+  exitAnimation: "slide",
   tone: "glass",
   size: "md",
   maxVisible: 3
@@ -39,23 +42,38 @@ function resolveContent(content, value) {
   const resolved = typeof content === "function" ? content(value) : content;
   return contentToOptions(resolved);
 }
-function createSnackbarStore(initialConfig = {}) {
-  let config = {
-    ...DEFAULT_CONFIG,
-    ...initialConfig.position !== void 0 ? { position: initialConfig.position } : null,
-    ...initialConfig.duration !== void 0 ? {
-      duration: normalizeDuration(
-        initialConfig.duration,
-        DEFAULT_CONFIG.duration
-      )
-    } : null,
-    ...initialConfig.dismissible !== void 0 ? { dismissible: initialConfig.dismissible } : null,
-    ...initialConfig.progress !== void 0 ? { progress: initialConfig.progress } : null,
-    ...initialConfig.compact !== void 0 ? { compact: initialConfig.compact } : null,
-    ...initialConfig.tone !== void 0 ? { tone: initialConfig.tone } : null,
-    ...initialConfig.size !== void 0 ? { size: initialConfig.size } : null,
-    ...initialConfig.maxVisible !== void 0 ? { maxVisible: Math.max(1, Math.floor(initialConfig.maxVisible)) } : null
+function resolveLayout(layout, compact, fallback) {
+  if (layout !== void 0) return layout;
+  if (compact !== void 0) return compact ? "compact" : "card";
+  return fallback;
+}
+function resolveLayoutPatch(record, options) {
+  if (options.layout === void 0 && options.compact === void 0) return {};
+  const layout = resolveLayout(options.layout, options.compact, record.layout);
+  return { layout, compact: layout === "compact" };
+}
+function mergeConfig(previous, patch) {
+  const layout = resolveLayout(patch.layout, patch.compact, previous.layout);
+  return {
+    position: patch.position ?? previous.position,
+    duration: patch.duration !== void 0 ? normalizeDuration(patch.duration, previous.duration) : previous.duration,
+    dismissible: patch.dismissible ?? previous.dismissible,
+    progress: patch.progress ?? previous.progress,
+    compact: layout === "compact",
+    layout,
+    animation: patch.animation ?? previous.animation,
+    enterAnimation: patch.enterAnimation ?? patch.animation ?? previous.enterAnimation,
+    exitAnimation: patch.exitAnimation ?? patch.animation ?? previous.exitAnimation,
+    tone: patch.tone ?? previous.tone,
+    size: patch.size ?? previous.size,
+    maxVisible: patch.maxVisible !== void 0 ? Math.max(1, Math.floor(patch.maxVisible)) : previous.maxVisible
   };
+}
+function createSnackbarStore(initialConfig = {}) {
+  let config = mergeConfig(
+    DEFAULT_CONFIG,
+    initialConfig
+  );
   let records = EMPTY;
   const listeners = /* @__PURE__ */ new Set();
   const timers = /* @__PURE__ */ new Map();
@@ -223,6 +241,7 @@ function createSnackbarStore(initialConfig = {}) {
       }
       return id;
     }
+    const layout = resolveLayout(options.layout, options.compact, config.layout);
     const record = {
       id,
       title: options.title,
@@ -236,7 +255,11 @@ function createSnackbarStore(initialConfig = {}) {
       action: options.action ?? null,
       dismissible: options.dismissible ?? config.dismissible,
       progress: options.progress ?? config.progress,
-      compact: options.compact ?? config.compact,
+      compact: layout === "compact",
+      layout,
+      animation: options.animation ?? config.animation,
+      enterAnimation: options.enterAnimation ?? options.animation ?? config.enterAnimation,
+      exitAnimation: options.exitAnimation ?? options.animation ?? config.exitAnimation,
       className: options.className,
       style: options.style,
       createdAt: Date.now(),
@@ -265,7 +288,14 @@ function createSnackbarStore(initialConfig = {}) {
       ...options.action !== void 0 ? { action: options.action } : null,
       ...options.dismissible !== void 0 ? { dismissible: options.dismissible } : null,
       ...options.progress !== void 0 ? { progress: options.progress } : null,
-      ...options.compact !== void 0 ? { compact: options.compact } : null,
+      ...resolveLayoutPatch(record, options),
+      ...options.animation !== void 0 ? {
+        animation: options.animation,
+        enterAnimation: options.animation,
+        exitAnimation: options.animation
+      } : null,
+      ...options.enterAnimation !== void 0 ? { enterAnimation: options.enterAnimation } : null,
+      ...options.exitAnimation !== void 0 ? { exitAnimation: options.exitAnimation } : null,
       ...options.className !== void 0 ? { className: options.className } : null,
       ...options.style !== void 0 ? { style: options.style } : null,
       ...options.onOpen !== void 0 ? { onOpen: options.onOpen } : null,
@@ -315,19 +345,7 @@ function createSnackbarStore(initialConfig = {}) {
     }
   };
   const setConfig = (patch) => {
-    config = {
-      ...config,
-      ...patch.position !== void 0 ? { position: patch.position } : null,
-      ...patch.duration !== void 0 ? {
-        duration: normalizeDuration(patch.duration, config.duration)
-      } : null,
-      ...patch.dismissible !== void 0 ? { dismissible: patch.dismissible } : null,
-      ...patch.progress !== void 0 ? { progress: patch.progress } : null,
-      ...patch.compact !== void 0 ? { compact: patch.compact } : null,
-      ...patch.tone !== void 0 ? { tone: patch.tone } : null,
-      ...patch.size !== void 0 ? { size: patch.size } : null,
-      ...patch.maxVisible !== void 0 ? { maxVisible: Math.max(1, Math.floor(patch.maxVisible)) } : null
-    };
+    config = mergeConfig(config, patch);
   };
   const promise = (input, messages, options = {}) => {
     const loadingOptions = contentToOptions(messages.loading ?? "Loading\u2026");
@@ -630,7 +648,10 @@ function SnackbarItem({
   };
   const resolvedIcon = record.icon === void 0 ? icons?.[variant] ?? defaultIcons[variant] : record.icon;
   const showIcon = record.icon !== false;
-  const showProgress = !record.compact && record.progress && Number.isFinite(duration) && duration > 0;
+  const isInline = record.layout === "inline";
+  const isTimed = Number.isFinite(duration) && duration > 0;
+  const showProgress = record.layout === "card" && record.progress && isTimed;
+  const showClose = record.dismissible && (!isInline || !isTimed);
   const style = {
     ...record.style,
     "--prs-drag-x": `${dragX}px`,
@@ -651,6 +672,9 @@ function SnackbarItem({
       "data-has-icon": showIcon ? "true" : "false",
       "data-dismissible": record.dismissible ? "true" : "false",
       "data-compact": record.compact ? "true" : "false",
+      "data-layout": record.layout,
+      "data-enter": record.enterAnimation,
+      "data-exit": record.exitAnimation,
       "data-prs-id": record.id,
       "data-position": record.position,
       style,
@@ -699,7 +723,7 @@ function SnackbarItem({
                 className: "prs-item__content",
                 "data-has-title": title !== void 0 && title !== null ? "true" : "false",
                 children: [
-                  title !== void 0 && title !== null ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "prs-item__title", children: title }) : null,
+                  title !== void 0 && title !== null && !isInline ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "prs-item__title", children: title }) : null,
                   message !== void 0 && message !== null ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "prs-item__message", children: message }) : null,
                   action ? /* @__PURE__ */ jsxRuntime.jsx("div", { className: "prs-item__actions", children: /* @__PURE__ */ jsxRuntime.jsxs(
                     "button",
@@ -718,7 +742,7 @@ function SnackbarItem({
                 ]
               }
             ),
-            record.dismissible ? /* @__PURE__ */ jsxRuntime.jsx(
+            showClose ? /* @__PURE__ */ jsxRuntime.jsx(
               "button",
               {
                 type: "button",
@@ -938,6 +962,10 @@ function SnackbarProvider({
   dismissible,
   progress,
   compact,
+  layout,
+  animation,
+  enterAnimation,
+  exitAnimation,
   tone,
   size,
   maxVisible,
@@ -960,6 +988,10 @@ function SnackbarProvider({
       dismissible,
       progress,
       compact,
+      layout,
+      animation,
+      enterAnimation,
+      exitAnimation,
       tone,
       size,
       maxVisible
@@ -971,6 +1003,10 @@ function SnackbarProvider({
     dismissible,
     progress,
     compact,
+    layout,
+    animation,
+    enterAnimation,
+    exitAnimation,
     tone,
     size,
     maxVisible
@@ -989,6 +1025,7 @@ function SnackbarProvider({
       info: preset2("info"),
       neutral: preset2("neutral"),
       custom: preset2("custom"),
+      single: (message, options = {}) => store.show({ ...options, message, layout: "inline" }),
       loading: (message, options = {}) => store.show({
         ...options,
         message,
@@ -1055,6 +1092,7 @@ function createToast() {
   toast2.info = preset("info");
   toast2.neutral = preset("neutral");
   toast2.custom = preset("custom");
+  toast2.single = (message, options = {}) => getDefaultStore().show({ ...options, message, layout: "inline" });
   toast2.loading = (message, options = {}) => getDefaultStore().show({
     ...options,
     message,