@rcarls/rc-snackbar 0.0.0-next-20260921045401

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+# @rcarls/rc-snackbar
+
+## 0.0.0-next-20260921045401
+
+### Minor Changes
+
+- 57338f5: `rc-dialog`, `rc-bottom-sheet`, and `rc-snackbar` now fade in and out through
+  CSS alone, using `@starting-style` and a discrete `display`/`overlay`
+  transition, driven by the shared `--rc-motion-effects-*` tokens (and
+  `--rc-motion-spatial-*` for `rc-snackbar`'s slide). `showModal()`/`show()`/
+  `close()` all stay synchronous, and nothing in any of the three components
+  waits on the transition finishing, so a zero-duration theme or a browser
+  without support for the CSS involved both degrade to an instant, fully
+  correct open and close.
+
+  `rc-dialog` and `rc-bottom-sheet` animate opacity only, not a scale or slide
+  transform: both support pointer resize and read `getBoundingClientRect()` to
+  compute drag deltas, and a transform is a visual effect that
+  `getBoundingClientRect()` reports for as long as it's still animating,
+  corrupting that measurement if a resize or drag starts during the entrance.
+  `rc-snackbar` has no such feature, so it fades and slides up from the
+  block-end edge it's anchored to.
+
+## 0.6.0
+
+## 0.5.0
+
+## 0.4.2
+
+## 0.4.1
+
+## 0.4.0
+
+### Minor Changes
+
+- 4171a9d: Give `open` proper controlled/uncontrolled backing (host writes are silent,
+  new `default-open` attribute seeds initial visible state), matching every
+  other stateful `open`/`value` property in the library. `show()`, `close()`,
+  and `clear()` are unaffected.
+- 985068e: Add the rc-snackbar package for queued live-region status messages.
+
+### Patch Changes
+
+- 55e8ab5: Preserve UA-like control and surface styling until an optional theme supplies decorative tokens.
+  Restore themed button hover and pressed state layers, including a pointer-origin Material ripple.

package/README.md

@@ -0,0 +1,15 @@
+# @rcarls/rc-snackbar
+
+Live-region host for brief status messages and optional actions.
+
+```html
+<rc-snackbar id="snackbar"></rc-snackbar>
+<script type="module">
+  import '@rcarls/rc-snackbar/define';
+
+  document.querySelector('#snackbar').show({
+    message: 'Recipe saved',
+    actionLabel: 'Undo',
+  });
+</script>
+```

package/dist/custom-elements.json

@@ -0,0 +1,522 @@
+{
+  "schemaVersion": "1.0.0",
+  "readme": "",
+  "modules": [
+    {
+      "kind": "javascript-module",
+      "path": "src/define.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "custom-element-definition",
+          "name": "rc-snackbar",
+          "declaration": {
+            "name": "RCSnackbar",
+            "module": "/src/index.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/index.ts",
+      "declarations": [],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCSnackbar",
+          "declaration": {
+            "name": "default",
+            "module": "./rc-snackbar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCSnackbarActionDetail",
+          "declaration": {
+            "name": "RCSnackbarActionDetail",
+            "module": "./rc-snackbar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCSnackbarCloseDetail",
+          "declaration": {
+            "name": "RCSnackbarCloseDetail",
+            "module": "./rc-snackbar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCSnackbarCloseReason",
+          "declaration": {
+            "name": "RCSnackbarCloseReason",
+            "module": "./rc-snackbar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCSnackbarQueuePolicy",
+          "declaration": {
+            "name": "RCSnackbarQueuePolicy",
+            "module": "./rc-snackbar.js"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "RCSnackbarShowOptions",
+          "declaration": {
+            "name": "RCSnackbarShowOptions",
+            "module": "./rc-snackbar.js"
+          }
+        }
+      ]
+    },
+    {
+      "kind": "javascript-module",
+      "path": "src/rc-snackbar.ts",
+      "declarations": [
+        {
+          "kind": "class",
+          "description": "Snackbar live-region host for brief status messages and optional actions.\n\nFades and slides in from the block-end edge it's anchored to through CSS\nalone (`@starting-style` plus a discrete `display` transition), using the\nshared `--rc-motion-effects-*`/`--rc-motion-spatial-*` tokens.\n`show()`/`close()` stay synchronous; nothing waits on the transition\nfinishing.",
+          "name": "RCSnackbar",
+          "cssProperties": [
+            {
+              "description": "Inline-axis inset from the viewport edge.",
+              "name": "--rc-snackbar-inset-inline",
+              "default": "1rem"
+            },
+            {
+              "description": "Block-end inset from the viewport edge, before the safe-area inset.",
+              "name": "--rc-snackbar-inset-block-end",
+              "default": "1rem"
+            },
+            {
+              "description": "Stacking order.",
+              "name": "--rc-snackbar-z-index",
+              "default": "1000"
+            },
+            {
+              "description": "Gap between the message and action.",
+              "name": "--rc-snackbar-gap",
+              "default": "0.5rem"
+            },
+            {
+              "description": "Minimum surface block size.",
+              "name": "--rc-snackbar-min-block-size",
+              "default": "3rem"
+            },
+            {
+              "description": "Maximum surface inline size.",
+              "name": "--rc-snackbar-max-inline-size",
+              "default": "30rem"
+            },
+            {
+              "description": "Surface block-axis padding.",
+              "name": "--rc-snackbar-padding-block",
+              "default": "0.5rem"
+            },
+            {
+              "description": "Surface inline-axis padding.",
+              "name": "--rc-snackbar-padding-inline",
+              "default": "1rem"
+            },
+            {
+              "description": "Surface border.",
+              "name": "--rc-snackbar-border",
+              "default": "1px solid CanvasText"
+            },
+            {
+              "description": "Surface border radius.",
+              "name": "--rc-snackbar-radius",
+              "default": "0"
+            },
+            {
+              "description": "Surface background.",
+              "name": "--rc-snackbar-bg",
+              "default": "Canvas"
+            },
+            {
+              "description": "Surface text color.",
+              "name": "--rc-snackbar-color",
+              "default": "CanvasText"
+            },
+            {
+              "description": "Surface box shadow.",
+              "name": "--rc-snackbar-shadow",
+              "default": "none"
+            },
+            {
+              "description": "Action button border; defers to native button border when unset.",
+              "name": "--rc-snackbar-action-border"
+            },
+            {
+              "description": "Action button border radius; defers to native button radius when unset.",
+              "name": "--rc-snackbar-action-radius"
+            },
+            {
+              "description": "Action button block-axis padding; defers to native button padding when unset.",
+              "name": "--rc-snackbar-action-padding-block"
+            },
+            {
+              "description": "Action button inline-axis padding; defers to native button padding when unset.",
+              "name": "--rc-snackbar-action-padding-inline"
+            },
+            {
+              "description": "Action button background; defers to native button background when unset.",
+              "name": "--rc-snackbar-action-bg"
+            },
+            {
+              "description": "Action button text color; defers to native button color when unset.",
+              "name": "--rc-snackbar-action-color"
+            },
+            {
+              "description": "Action button font shorthand; defers to native button font when unset.",
+              "name": "--rc-snackbar-action-font"
+            },
+            {
+              "description": "Action button focus outline; defers to native focus styling when unset.",
+              "name": "--rc-snackbar-focus-ring"
+            },
+            {
+              "description": "Action button focus outline offset; defers to native focus styling when unset.",
+              "name": "--rc-snackbar-focus-ring-offset"
+            }
+          ],
+          "cssParts": [
+            {
+              "description": "Snackbar surface.",
+              "name": "surface"
+            },
+            {
+              "description": "Message text.",
+              "name": "message"
+            },
+            {
+              "description": "Optional action button.",
+              "name": "action"
+            }
+          ],
+          "members": [
+            {
+              "kind": "field",
+              "name": "_queue",
+              "type": {
+                "text": "RCSnackbarShowOptions[]"
+              },
+              "privacy": "private",
+              "default": "[]"
+            },
+            {
+              "kind": "field",
+              "name": "_timer",
+              "type": {
+                "text": "number | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_lastMessage",
+              "type": {
+                "text": "string"
+              },
+              "privacy": "private",
+              "default": "''"
+            },
+            {
+              "kind": "field",
+              "name": "_open",
+              "type": {
+                "text": "boolean | undefined"
+              },
+              "privacy": "private"
+            },
+            {
+              "kind": "field",
+              "name": "_defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "_openInitialized",
+              "type": {
+                "text": "boolean"
+              },
+              "privacy": "private",
+              "default": "false"
+            },
+            {
+              "kind": "field",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Whether the snackbar is currently visible. Host writes are silent.",
+              "attribute": "open",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "defaultOpen",
+              "type": {
+                "text": "boolean"
+              },
+              "description": "Initial visible state for uncontrolled usage, such as an already-queued\nmessage shown on first render.",
+              "attribute": "default-open"
+            },
+            {
+              "kind": "field",
+              "name": "message",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Visible message text.",
+              "attribute": "message",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "actionLabel",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "description": "Optional action button label.",
+              "attribute": "action-label",
+              "reflects": true
+            },
+            {
+              "kind": "field",
+              "name": "duration",
+              "type": {
+                "text": "number"
+              },
+              "default": "4000",
+              "description": "Auto-close duration in milliseconds. Set to 0 to keep open.",
+              "attribute": "duration"
+            },
+            {
+              "kind": "field",
+              "name": "queuePolicy",
+              "type": {
+                "text": "RCSnackbarQueuePolicy"
+              },
+              "default": "'queue'",
+              "description": "Queue behavior for show calls while open.",
+              "attribute": "queue-policy"
+            },
+            {
+              "kind": "method",
+              "name": "show",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "message",
+                  "type": {
+                    "text": "string | RCSnackbarShowOptions"
+                  }
+                }
+              ],
+              "description": "Shows a message or queues it according to `queuePolicy`."
+            },
+            {
+              "kind": "method",
+              "name": "close",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "reason",
+                  "default": "'api'",
+                  "type": {
+                    "text": "RCSnackbarCloseReason"
+                  }
+                }
+              ],
+              "description": "Closes the current snackbar."
+            },
+            {
+              "kind": "method",
+              "name": "clear",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "description": "Clears the current snackbar and all queued messages."
+            },
+            {
+              "kind": "method",
+              "name": "_showNow",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "next",
+                  "type": {
+                    "text": "RCSnackbarShowOptions"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_closeCurrent",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              },
+              "parameters": [
+                {
+                  "name": "reason",
+                  "type": {
+                    "text": "RCSnackbarCloseReason"
+                  }
+                },
+                {
+                  "name": "showNext",
+                  "type": {
+                    "text": "boolean"
+                  }
+                }
+              ]
+            },
+            {
+              "kind": "method",
+              "name": "_handleAction",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            },
+            {
+              "kind": "method",
+              "name": "_clearTimer",
+              "privacy": "private",
+              "return": {
+                "type": {
+                  "text": "void"
+                }
+              }
+            }
+          ],
+          "events": [
+            {
+              "name": "rc-snackbar-close",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired after a visible snackbar closes."
+            },
+            {
+              "name": "rc-snackbar-action",
+              "type": {
+                "text": "CustomEvent"
+              },
+              "description": "Fired when the action button is activated."
+            }
+          ],
+          "attributes": [
+            {
+              "description": "Whether the snackbar is currently visible. Host writes are silent.",
+              "name": "open",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "open"
+            },
+            {
+              "description": "Initial visible state for uncontrolled usage, such as an already-queued\nmessage shown on first render.",
+              "name": "default-open",
+              "type": {
+                "text": "boolean"
+              },
+              "fieldName": "defaultOpen"
+            },
+            {
+              "description": "Visible message text.",
+              "name": "message",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "message"
+            },
+            {
+              "description": "Optional action button label.",
+              "name": "action-label",
+              "type": {
+                "text": "string"
+              },
+              "default": "''",
+              "fieldName": "actionLabel"
+            },
+            {
+              "description": "Auto-close duration in milliseconds. Set to 0 to keep open.",
+              "name": "duration",
+              "type": {
+                "text": "number"
+              },
+              "default": "4000",
+              "fieldName": "duration"
+            },
+            {
+              "description": "Queue behavior for show calls while open.",
+              "name": "queue-policy",
+              "type": {
+                "text": "RCSnackbarQueuePolicy"
+              },
+              "default": "'queue'",
+              "fieldName": "queuePolicy"
+            }
+          ],
+          "superclass": {
+            "name": "LitElement",
+            "package": "lit"
+          },
+          "tagName": "rc-snackbar",
+          "customElement": true
+        }
+      ],
+      "exports": [
+        {
+          "kind": "js",
+          "name": "RCSnackbar",
+          "declaration": {
+            "name": "RCSnackbar",
+            "module": "src/rc-snackbar.ts"
+          }
+        },
+        {
+          "kind": "js",
+          "name": "default",
+          "declaration": {
+            "name": "RCSnackbar",
+            "module": "src/rc-snackbar.ts"
+          }
+        }
+      ]
+    }
+  ]
+}

package/dist/rc-snackbar-CGTWrbMU.js

@@ -0,0 +1,240 @@
+import { css as u, LitElement as d, html as h } from "lit";
+import { property as i } from "lit/decorators.js";
+const f = u`
+  :host {
+    position: fixed;
+    inset-inline: var(--rc-snackbar-inset-inline, 1rem);
+    inset-block-end: calc(
+      var(--rc-snackbar-inset-block-end, 1rem) + env(safe-area-inset-bottom, 0px)
+    );
+    z-index: var(--rc-snackbar-z-index, 1000);
+    display: none;
+    justify-content: center;
+    pointer-events: none;
+    color-scheme: inherit;
+  }
+
+  :host([hidden]) {
+    display: none;
+  }
+
+  :host([open]) {
+    display: flex;
+  }
+
+  /*
+   * Fade and slide up from the block-end edge it's anchored to. Unlike
+   * rc-dialog/rc-bottom-sheet, nothing here reads getBoundingClientRect()
+   * during the entrance, so a transform is safe: the host is a fixed
+   * positioning wrapper with no resize or drag feature of its own.
+   * show()/close() stay synchronous either way.
+   */
+  @media (prefers-reduced-motion: no-preference) {
+    :host {
+      opacity: 0;
+      translate: 0 100%;
+    }
+
+    :host([open]) {
+      opacity: 1;
+      translate: none;
+      transition:
+        opacity var(--rc-motion-effects-duration-default, 200ms)
+          var(--rc-motion-effects-easing-enter, ease-out),
+        translate var(--rc-motion-spatial-duration-default, 400ms)
+          var(--rc-motion-spatial-easing-enter, ease-out),
+        display var(--rc-motion-effects-duration-default, 200ms) allow-discrete;
+    }
+
+    :host(:not([open])) {
+      transition:
+        opacity var(--rc-motion-effects-duration-default, 200ms)
+          var(--rc-motion-effects-easing-exit, ease-in),
+        translate var(--rc-motion-spatial-duration-default, 400ms)
+          var(--rc-motion-spatial-easing-exit, ease-in),
+        display var(--rc-motion-effects-duration-default, 200ms) allow-discrete;
+    }
+
+    @starting-style {
+      :host([open]) {
+        opacity: 0;
+        translate: 0 100%;
+      }
+    }
+  }
+
+  [part='surface'] {
+    pointer-events: auto;
+    display: flex;
+    align-items: center;
+    gap: var(--rc-snackbar-gap, 0.5rem);
+    box-sizing: border-box;
+    min-block-size: var(--rc-snackbar-min-block-size, 3rem);
+    inline-size: min(100%, var(--rc-snackbar-max-inline-size, 30rem));
+    padding-block: var(--rc-snackbar-padding-block, 0.5rem);
+    padding-inline: var(--rc-snackbar-padding-inline, 1rem);
+    border: var(--rc-snackbar-border, 1px solid CanvasText);
+    border-radius: var(--rc-snackbar-radius, 0);
+    background: var(--rc-snackbar-bg, Canvas);
+    color: var(--rc-snackbar-color, CanvasText);
+    box-shadow: var(--rc-snackbar-shadow, none);
+  }
+
+  [part='message'] {
+    flex: 1 1 auto;
+  }
+
+  [part='action'] {
+    flex: 0 0 auto;
+    display: none;
+    border: var(--rc-snackbar-action-border, revert);
+    border-radius: var(--rc-snackbar-action-radius, revert);
+    padding-block: var(--rc-snackbar-action-padding-block, revert);
+    padding-inline: var(--rc-snackbar-action-padding-inline, revert);
+    background: var(--rc-snackbar-action-bg, revert);
+    color: var(--rc-snackbar-action-color, revert);
+    font: var(--rc-snackbar-action-font, revert);
+  }
+
+  :host([action-label]) [part='action'] {
+    display: inline-flex;
+  }
+
+  [part='action']:focus-visible {
+    outline: var(--rc-snackbar-focus-ring, revert);
+    outline-offset: var(--rc-snackbar-focus-ring-offset, revert);
+  }
+
+  @media (forced-colors: active) {
+    [part='surface'] {
+      border: 1px solid CanvasText;
+      background: CanvasText;
+      color: Canvas;
+    }
+
+    [part='action'] {
+      color: Highlight;
+    }
+  }
+`;
+var b = Object.defineProperty, m = Object.getOwnPropertyDescriptor, n = (p, e, t, s) => {
+  for (var a = s > 1 ? void 0 : s ? m(e, t) : e, o = p.length - 1, c; o >= 0; o--)
+    (c = p[o]) && (a = (s ? c(e, t, a) : c(a)) || a);
+  return s && a && b(e, t, a), a;
+};
+const l = class l extends d {
+  constructor() {
+    super(...arguments), this._queue = [], this._lastMessage = "", this._defaultOpen = !1, this._openInitialized = !1, this.message = "", this.actionLabel = "", this.duration = 4e3, this.queuePolicy = "queue";
+  }
+  get open() {
+    return this._open ?? this._defaultOpen;
+  }
+  set open(e) {
+    const t = this.open;
+    this._open = e, this._openInitialized = !0, this.requestUpdate("open", t);
+  }
+  get defaultOpen() {
+    return this._defaultOpen;
+  }
+  set defaultOpen(e) {
+    const t = this._defaultOpen;
+    this._defaultOpen = e, !this._openInitialized && this._open === void 0 && this.requestUpdate("open", t), this.requestUpdate("defaultOpen", t);
+  }
+  disconnectedCallback() {
+    this._clearTimer(), super.disconnectedCallback();
+  }
+  updated(e) {
+    e.has("open") && !this.open && this._clearTimer();
+  }
+  render() {
+    return h`
+      <div part="surface" role="status" aria-live="polite" aria-atomic="true">
+        <span part="message">${this.message}</span>
+        <button part="action" type="button" @click=${this._handleAction}>
+          ${this.actionLabel}
+        </button>
+      </div>
+    `;
+  }
+  /**
+   * Shows a message or queues it according to `queuePolicy`.
+   *
+   * @example
+   * snackbar.show({
+   *   message: 'Recipe saved',
+   *   actionLabel: 'Undo',
+   *   duration: 6000,
+   * });
+   */
+  show(e) {
+    const t = typeof e == "string" ? { message: e } : e;
+    if (this.open) {
+      this.queuePolicy === "replace" ? (this._closeCurrent("replace", !1), this._showNow(t)) : this._queue.push(t);
+      return;
+    }
+    this._showNow(t);
+  }
+  /** Closes the current snackbar. */
+  close(e = "api") {
+    this._closeCurrent(e, !0);
+  }
+  /** Clears the current snackbar and all queued messages. */
+  clear() {
+    this._queue = [], this._closeCurrent("clear", !1);
+  }
+  _showNow(e) {
+    const t = e.duration ?? this.duration;
+    this._clearTimer(), this.message = e.message, this.actionLabel = e.actionLabel ?? "", this._lastMessage = e.message, this.open = !0, t > 0 && (this._timer = window.setTimeout(() => this._closeCurrent("timeout", !0), t));
+  }
+  _closeCurrent(e, t) {
+    if (!this.open)
+      return;
+    const s = this.message;
+    if (this._clearTimer(), this.open = !1, this.message = "", this.actionLabel = "", this.dispatchEvent(
+      new CustomEvent("rc-snackbar-close", {
+        bubbles: !0,
+        composed: !0,
+        detail: { reason: e, message: s }
+      })
+    ), t) {
+      const a = this._queue.shift();
+      a && queueMicrotask(() => this._showNow(a));
+    }
+  }
+  _handleAction() {
+    this.open && (this.dispatchEvent(
+      new CustomEvent("rc-snackbar-action", {
+        bubbles: !0,
+        composed: !0,
+        detail: { message: this._lastMessage }
+      })
+    ), this._closeCurrent("action", !0));
+  }
+  _clearTimer() {
+    window.clearTimeout(this._timer), this._timer = void 0;
+  }
+};
+l.styles = f;
+let r = l;
+n([
+  i({ type: Boolean, reflect: !0 })
+], r.prototype, "open", 1);
+n([
+  i({ type: Boolean, attribute: "default-open" })
+], r.prototype, "defaultOpen", 1);
+n([
+  i({ type: String, reflect: !0 })
+], r.prototype, "message", 2);
+n([
+  i({ type: String, attribute: "action-label", reflect: !0 })
+], r.prototype, "actionLabel", 2);
+n([
+  i({ type: Number })
+], r.prototype, "duration", 2);
+n([
+  i({ type: String, attribute: "queue-policy" })
+], r.prototype, "queuePolicy", 2);
+export {
+  r as R
+};
+//# sourceMappingURL=rc-snackbar-CGTWrbMU.js.map

package/dist/rc-snackbar-CGTWrbMU.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-snackbar-CGTWrbMU.js","sources":["../src/rc-snackbar.styles.ts","../src/rc-snackbar.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const snackbarStyles = css`\n  :host {\n    position: fixed;\n    inset-inline: var(--rc-snackbar-inset-inline, 1rem);\n    inset-block-end: calc(\n      var(--rc-snackbar-inset-block-end, 1rem) + env(safe-area-inset-bottom, 0px)\n    );\n    z-index: var(--rc-snackbar-z-index, 1000);\n    display: none;\n    justify-content: center;\n    pointer-events: none;\n    color-scheme: inherit;\n  }\n\n  :host([hidden]) {\n    display: none;\n  }\n\n  :host([open]) {\n    display: flex;\n  }\n\n  /*\n   * Fade and slide up from the block-end edge it's anchored to. Unlike\n   * rc-dialog/rc-bottom-sheet, nothing here reads getBoundingClientRect()\n   * during the entrance, so a transform is safe: the host is a fixed\n   * positioning wrapper with no resize or drag feature of its own.\n   * show()/close() stay synchronous either way.\n   */\n  @media (prefers-reduced-motion: no-preference) {\n    :host {\n      opacity: 0;\n      translate: 0 100%;\n    }\n\n    :host([open]) {\n      opacity: 1;\n      translate: none;\n      transition:\n        opacity var(--rc-motion-effects-duration-default, 200ms)\n          var(--rc-motion-effects-easing-enter, ease-out),\n        translate var(--rc-motion-spatial-duration-default, 400ms)\n          var(--rc-motion-spatial-easing-enter, ease-out),\n        display var(--rc-motion-effects-duration-default, 200ms) allow-discrete;\n    }\n\n    :host(:not([open])) {\n      transition:\n        opacity var(--rc-motion-effects-duration-default, 200ms)\n          var(--rc-motion-effects-easing-exit, ease-in),\n        translate var(--rc-motion-spatial-duration-default, 400ms)\n          var(--rc-motion-spatial-easing-exit, ease-in),\n        display var(--rc-motion-effects-duration-default, 200ms) allow-discrete;\n    }\n\n    @starting-style {\n      :host([open]) {\n        opacity: 0;\n        translate: 0 100%;\n      }\n    }\n  }\n\n  [part='surface'] {\n    pointer-events: auto;\n    display: flex;\n    align-items: center;\n    gap: var(--rc-snackbar-gap, 0.5rem);\n    box-sizing: border-box;\n    min-block-size: var(--rc-snackbar-min-block-size, 3rem);\n    inline-size: min(100%, var(--rc-snackbar-max-inline-size, 30rem));\n    padding-block: var(--rc-snackbar-padding-block, 0.5rem);\n    padding-inline: var(--rc-snackbar-padding-inline, 1rem);\n    border: var(--rc-snackbar-border, 1px solid CanvasText);\n    border-radius: var(--rc-snackbar-radius, 0);\n    background: var(--rc-snackbar-bg, Canvas);\n    color: var(--rc-snackbar-color, CanvasText);\n    box-shadow: var(--rc-snackbar-shadow, none);\n  }\n\n  [part='message'] {\n    flex: 1 1 auto;\n  }\n\n  [part='action'] {\n    flex: 0 0 auto;\n    display: none;\n    border: var(--rc-snackbar-action-border, revert);\n    border-radius: var(--rc-snackbar-action-radius, revert);\n    padding-block: var(--rc-snackbar-action-padding-block, revert);\n    padding-inline: var(--rc-snackbar-action-padding-inline, revert);\n    background: var(--rc-snackbar-action-bg, revert);\n    color: var(--rc-snackbar-action-color, revert);\n    font: var(--rc-snackbar-action-font, revert);\n  }\n\n  :host([action-label]) [part='action'] {\n    display: inline-flex;\n  }\n\n  [part='action']:focus-visible {\n    outline: var(--rc-snackbar-focus-ring, revert);\n    outline-offset: var(--rc-snackbar-focus-ring-offset, revert);\n  }\n\n  @media (forced-colors: active) {\n    [part='surface'] {\n      border: 1px solid CanvasText;\n      background: CanvasText;\n      color: Canvas;\n    }\n\n    [part='action'] {\n      color: Highlight;\n    }\n  }\n`;\n\nexport default snackbarStyles;\n","import { LitElement, html } from 'lit';\nimport type { PropertyValues } from 'lit';\nimport { property } from 'lit/decorators.js';\n\nimport snackbarStyles from './rc-snackbar.styles.js';\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'rc-snackbar': RCSnackbar;\n  }\n\n  interface HTMLElementEventMap {\n    'rc-snackbar-action': CustomEvent<RCSnackbarActionDetail>;\n    'rc-snackbar-close': CustomEvent<RCSnackbarCloseDetail>;\n  }\n}\n\n/** Snackbar queue behavior when `show()` is called while open. */\nexport type RCSnackbarQueuePolicy = 'queue' | 'replace';\n\n/** Close reasons surfaced by `rc-snackbar-close`. */\nexport type RCSnackbarCloseReason = 'action' | 'api' | 'timeout' | 'replace' | 'clear';\n\n/** Options accepted by `show()`. */\nexport interface RCSnackbarShowOptions {\n  /** Message text to announce. */\n  message: string;\n  /** Optional action button label. */\n  actionLabel?: string;\n  /** Auto-close duration in milliseconds. */\n  duration?: number;\n}\n\n/** Detail payload for `rc-snackbar-action`. */\nexport interface RCSnackbarActionDetail {\n  /** Message that was visible when the action was activated. */\n  message: string;\n}\n\n/** Detail payload for `rc-snackbar-close`. */\nexport interface RCSnackbarCloseDetail {\n  /** Close reason. */\n  reason: RCSnackbarCloseReason;\n  /** Message that closed. */\n  message: string;\n}\n\n/**\n * Snackbar live-region host for brief status messages and optional actions.\n *\n * Fades and slides in from the block-end edge it's anchored to through CSS\n * alone (`@starting-style` plus a discrete `display` transition), using the\n * shared `--rc-motion-effects-*`/`--rc-motion-spatial-*` tokens.\n * `show()`/`close()` stay synchronous; nothing waits on the transition\n * finishing.\n *\n * @see {@link https://richardcarls.github.io/rc-webcomponents/components/rc-snackbar rc-snackbar docs}\n *\n * @fires rc-snackbar-action - Fired when the action button is activated.\n * @fires rc-snackbar-close - Fired after a visible snackbar closes.\n *\n * @csspart surface - Snackbar surface.\n * @csspart message - Message text.\n * @csspart action - Optional action button.\n *\n * @attr open - Whether a snackbar is currently visible. Host writes are silent.\n * @attr default-open - Initial visible state for uncontrolled usage.\n * @attr message - Visible snackbar message.\n * @attr action-label - Optional action button label.\n * @attr duration - Auto-close duration in milliseconds.\n * @attr queue-policy - `queue` appends while open; `replace` closes the current message.\n *\n * @cssprop [--rc-snackbar-inset-inline=1rem] - Inline-axis inset from the viewport edge.\n * @cssprop [--rc-snackbar-inset-block-end=1rem] - Block-end inset from the viewport edge, before\n *   the safe-area inset.\n * @cssprop [--rc-snackbar-z-index=1000] - Stacking order.\n * @cssprop [--rc-snackbar-gap=0.5rem] - Gap between the message and action.\n * @cssprop [--rc-snackbar-min-block-size=3rem] - Minimum surface block size.\n * @cssprop [--rc-snackbar-max-inline-size=30rem] - Maximum surface inline size.\n * @cssprop [--rc-snackbar-padding-block=0.5rem] - Surface block-axis padding.\n * @cssprop [--rc-snackbar-padding-inline=1rem] - Surface inline-axis padding.\n * @cssprop [--rc-snackbar-border=1px solid CanvasText] - Surface border.\n * @cssprop [--rc-snackbar-radius=0] - Surface border radius.\n * @cssprop [--rc-snackbar-bg=Canvas] - Surface background.\n * @cssprop [--rc-snackbar-color=CanvasText] - Surface text color.\n * @cssprop [--rc-snackbar-shadow=none] - Surface box shadow.\n * @cssprop [--rc-snackbar-action-border] - Action button border; defers to native button\n *   border when unset.\n * @cssprop [--rc-snackbar-action-radius] - Action button border radius; defers to native button\n *   radius when unset.\n * @cssprop [--rc-snackbar-action-padding-block] - Action button block-axis padding; defers to\n *   native button padding when unset.\n * @cssprop [--rc-snackbar-action-padding-inline] - Action button inline-axis padding; defers to\n *   native button padding when unset.\n * @cssprop [--rc-snackbar-action-bg] - Action button background; defers to native button\n *   background when unset.\n * @cssprop [--rc-snackbar-action-color] - Action button text color; defers to native button\n *   color when unset.\n * @cssprop [--rc-snackbar-action-font] - Action button font shorthand; defers to native button\n *   font when unset.\n * @cssprop [--rc-snackbar-focus-ring] - Action button focus outline; defers to native focus\n *   styling when unset.\n * @cssprop [--rc-snackbar-focus-ring-offset] - Action button focus outline offset; defers to\n *   native focus styling when unset.\n */\nexport class RCSnackbar extends LitElement {\n  static override styles = snackbarStyles;\n\n  private _queue: RCSnackbarShowOptions[] = [];\n  private _timer: number | undefined;\n  private _lastMessage = '';\n\n  private _open: boolean | undefined;\n  private _defaultOpen = false;\n  private _openInitialized = false;\n\n  /** Whether the snackbar is currently visible. Host writes are silent. */\n  @property({ type: Boolean, reflect: true })\n  get open(): boolean {\n    return this._open ?? this._defaultOpen;\n  }\n\n  set open(value: boolean | undefined) {\n    const oldValue = this.open;\n\n    this._open = value;\n    this._openInitialized = true;\n    this.requestUpdate('open', oldValue);\n  }\n\n  /** Initial visible state for uncontrolled usage, such as an already-queued\n   * message shown on first render. */\n  @property({ type: Boolean, attribute: 'default-open' })\n  get defaultOpen(): boolean {\n    return this._defaultOpen;\n  }\n\n  set defaultOpen(value: boolean) {\n    const oldValue = this._defaultOpen;\n\n    this._defaultOpen = value;\n\n    if (!this._openInitialized && this._open === undefined) {\n      this.requestUpdate('open', oldValue);\n    }\n\n    this.requestUpdate('defaultOpen', oldValue);\n  }\n\n  /** Visible message text. */\n  @property({ type: String, reflect: true })\n  message = '';\n\n  /** Optional action button label. */\n  @property({ type: String, attribute: 'action-label', reflect: true })\n  actionLabel = '';\n\n  /** Auto-close duration in milliseconds. Set to 0 to keep open. */\n  @property({ type: Number })\n  duration = 4000;\n\n  /** Queue behavior for show calls while open. */\n  @property({ type: String, attribute: 'queue-policy' })\n  queuePolicy: RCSnackbarQueuePolicy = 'queue';\n\n  override disconnectedCallback(): void {\n    this._clearTimer();\n    super.disconnectedCallback();\n  }\n\n  protected override updated(changed: PropertyValues<this>): void {\n    if (changed.has('open') && !this.open) {\n      this._clearTimer();\n    }\n  }\n\n  protected override render() {\n    return html`\n      <div part=\"surface\" role=\"status\" aria-live=\"polite\" aria-atomic=\"true\">\n        <span part=\"message\">${this.message}</span>\n        <button part=\"action\" type=\"button\" @click=${this._handleAction}>\n          ${this.actionLabel}\n        </button>\n      </div>\n    `;\n  }\n\n  /**\n   * Shows a message or queues it according to `queuePolicy`.\n   *\n   * @example\n   * snackbar.show({\n   *   message: 'Recipe saved',\n   *   actionLabel: 'Undo',\n   *   duration: 6000,\n   * });\n   */\n  show(message: string | RCSnackbarShowOptions): void {\n    const next = typeof message === 'string' ? { message } : message;\n\n    if (this.open) {\n      if (this.queuePolicy === 'replace') {\n        this._closeCurrent('replace', false);\n        this._showNow(next);\n      } else {\n        this._queue.push(next);\n      }\n\n      return;\n    }\n\n    this._showNow(next);\n  }\n\n  /** Closes the current snackbar. */\n  close(reason: RCSnackbarCloseReason = 'api'): void {\n    this._closeCurrent(reason, true);\n  }\n\n  /** Clears the current snackbar and all queued messages. */\n  clear(): void {\n    this._queue = [];\n    this._closeCurrent('clear', false);\n  }\n\n  private _showNow(next: RCSnackbarShowOptions): void {\n    const duration = next.duration ?? this.duration;\n\n    this._clearTimer();\n    this.message = next.message;\n    this.actionLabel = next.actionLabel ?? '';\n    this._lastMessage = next.message;\n    this.open = true;\n\n    if (duration > 0) {\n      this._timer = window.setTimeout(() => this._closeCurrent('timeout', true), duration);\n    }\n  }\n\n  private _closeCurrent(reason: RCSnackbarCloseReason, showNext: boolean): void {\n    if (!this.open) {\n      return;\n    }\n\n    const message = this.message;\n\n    this._clearTimer();\n    this.open = false;\n    this.message = '';\n    this.actionLabel = '';\n\n    this.dispatchEvent(\n      new CustomEvent<RCSnackbarCloseDetail>('rc-snackbar-close', {\n        bubbles: true,\n        composed: true,\n        detail: { reason, message },\n      }),\n    );\n\n    if (showNext) {\n      const next = this._queue.shift();\n\n      if (next) {\n        queueMicrotask(() => this._showNow(next));\n      }\n    }\n  }\n\n  private _handleAction(): void {\n    if (!this.open) {\n      return;\n    }\n\n    this.dispatchEvent(\n      new CustomEvent<RCSnackbarActionDetail>('rc-snackbar-action', {\n        bubbles: true,\n        composed: true,\n        detail: { message: this._lastMessage },\n      }),\n    );\n\n    this._closeCurrent('action', true);\n  }\n\n  private _clearTimer(): void {\n    window.clearTimeout(this._timer);\n    this._timer = undefined;\n  }\n}\n\nexport default RCSnackbar;\n"],"names":["snackbarStyles","css","_RCSnackbar","LitElement","value","oldValue","changed","html","message","next","reason","duration","showNext","RCSnackbar","__decorateClass","property"],"mappings":"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"}

package/dist/rc-snackbar-define.js

@@ -0,0 +1,3 @@
+import { R as a } from "./rc-snackbar-CGTWrbMU.js";
+customElements.get("rc-snackbar") || customElements.define("rc-snackbar", a);
+//# sourceMappingURL=rc-snackbar-define.js.map

package/dist/rc-snackbar-define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-snackbar-define.js","sources":["../src/define.ts"],"sourcesContent":["import { RCSnackbar } from './index.js';\n\ncustomElements.get('rc-snackbar') || customElements.define('rc-snackbar', RCSnackbar);\n"],"names":["RCSnackbar"],"mappings":";AAEA,eAAe,IAAI,aAAa,KAAK,eAAe,OAAO,eAAeA,CAAU;"}

package/dist/rc-snackbar.js

@@ -0,0 +1,5 @@
+import { R as o } from "./rc-snackbar-CGTWrbMU.js";
+export {
+  o as RCSnackbar
+};
+//# sourceMappingURL=rc-snackbar.js.map

package/dist/rc-snackbar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rc-snackbar.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/types/packages/rc-snackbar/src/define.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/packages/rc-snackbar/src/index.d.ts

@@ -0,0 +1,2 @@
+export { default as RCSnackbar } from './rc-snackbar.js';
+export type { RCSnackbarActionDetail, RCSnackbarCloseDetail, RCSnackbarCloseReason, RCSnackbarQueuePolicy, RCSnackbarShowOptions, } from './rc-snackbar.js';

package/dist/types/packages/rc-snackbar/src/rc-snackbar.d.ts

@@ -0,0 +1,140 @@
+import { LitElement, PropertyValues } from 'lit';
+declare global {
+    interface HTMLElementTagNameMap {
+        'rc-snackbar': RCSnackbar;
+    }
+    interface HTMLElementEventMap {
+        'rc-snackbar-action': CustomEvent<RCSnackbarActionDetail>;
+        'rc-snackbar-close': CustomEvent<RCSnackbarCloseDetail>;
+    }
+}
+/** Snackbar queue behavior when `show()` is called while open. */
+export type RCSnackbarQueuePolicy = 'queue' | 'replace';
+/** Close reasons surfaced by `rc-snackbar-close`. */
+export type RCSnackbarCloseReason = 'action' | 'api' | 'timeout' | 'replace' | 'clear';
+/** Options accepted by `show()`. */
+export interface RCSnackbarShowOptions {
+    /** Message text to announce. */
+    message: string;
+    /** Optional action button label. */
+    actionLabel?: string;
+    /** Auto-close duration in milliseconds. */
+    duration?: number;
+}
+/** Detail payload for `rc-snackbar-action`. */
+export interface RCSnackbarActionDetail {
+    /** Message that was visible when the action was activated. */
+    message: string;
+}
+/** Detail payload for `rc-snackbar-close`. */
+export interface RCSnackbarCloseDetail {
+    /** Close reason. */
+    reason: RCSnackbarCloseReason;
+    /** Message that closed. */
+    message: string;
+}
+/**
+ * Snackbar live-region host for brief status messages and optional actions.
+ *
+ * Fades and slides in from the block-end edge it's anchored to through CSS
+ * alone (`@starting-style` plus a discrete `display` transition), using the
+ * shared `--rc-motion-effects-*`/`--rc-motion-spatial-*` tokens.
+ * `show()`/`close()` stay synchronous; nothing waits on the transition
+ * finishing.
+ *
+ * @see {@link https://richardcarls.github.io/rc-webcomponents/components/rc-snackbar rc-snackbar docs}
+ *
+ * @fires rc-snackbar-action - Fired when the action button is activated.
+ * @fires rc-snackbar-close - Fired after a visible snackbar closes.
+ *
+ * @csspart surface - Snackbar surface.
+ * @csspart message - Message text.
+ * @csspart action - Optional action button.
+ *
+ * @attr open - Whether a snackbar is currently visible. Host writes are silent.
+ * @attr default-open - Initial visible state for uncontrolled usage.
+ * @attr message - Visible snackbar message.
+ * @attr action-label - Optional action button label.
+ * @attr duration - Auto-close duration in milliseconds.
+ * @attr queue-policy - `queue` appends while open; `replace` closes the current message.
+ *
+ * @cssprop [--rc-snackbar-inset-inline=1rem] - Inline-axis inset from the viewport edge.
+ * @cssprop [--rc-snackbar-inset-block-end=1rem] - Block-end inset from the viewport edge, before
+ *   the safe-area inset.
+ * @cssprop [--rc-snackbar-z-index=1000] - Stacking order.
+ * @cssprop [--rc-snackbar-gap=0.5rem] - Gap between the message and action.
+ * @cssprop [--rc-snackbar-min-block-size=3rem] - Minimum surface block size.
+ * @cssprop [--rc-snackbar-max-inline-size=30rem] - Maximum surface inline size.
+ * @cssprop [--rc-snackbar-padding-block=0.5rem] - Surface block-axis padding.
+ * @cssprop [--rc-snackbar-padding-inline=1rem] - Surface inline-axis padding.
+ * @cssprop [--rc-snackbar-border=1px solid CanvasText] - Surface border.
+ * @cssprop [--rc-snackbar-radius=0] - Surface border radius.
+ * @cssprop [--rc-snackbar-bg=Canvas] - Surface background.
+ * @cssprop [--rc-snackbar-color=CanvasText] - Surface text color.
+ * @cssprop [--rc-snackbar-shadow=none] - Surface box shadow.
+ * @cssprop [--rc-snackbar-action-border] - Action button border; defers to native button
+ *   border when unset.
+ * @cssprop [--rc-snackbar-action-radius] - Action button border radius; defers to native button
+ *   radius when unset.
+ * @cssprop [--rc-snackbar-action-padding-block] - Action button block-axis padding; defers to
+ *   native button padding when unset.
+ * @cssprop [--rc-snackbar-action-padding-inline] - Action button inline-axis padding; defers to
+ *   native button padding when unset.
+ * @cssprop [--rc-snackbar-action-bg] - Action button background; defers to native button
+ *   background when unset.
+ * @cssprop [--rc-snackbar-action-color] - Action button text color; defers to native button
+ *   color when unset.
+ * @cssprop [--rc-snackbar-action-font] - Action button font shorthand; defers to native button
+ *   font when unset.
+ * @cssprop [--rc-snackbar-focus-ring] - Action button focus outline; defers to native focus
+ *   styling when unset.
+ * @cssprop [--rc-snackbar-focus-ring-offset] - Action button focus outline offset; defers to
+ *   native focus styling when unset.
+ */
+export declare class RCSnackbar extends LitElement {
+    static styles: import('lit').CSSResult;
+    private _queue;
+    private _timer;
+    private _lastMessage;
+    private _open;
+    private _defaultOpen;
+    private _openInitialized;
+    /** Whether the snackbar is currently visible. Host writes are silent. */
+    get open(): boolean;
+    set open(value: boolean | undefined);
+    /** Initial visible state for uncontrolled usage, such as an already-queued
+     * message shown on first render. */
+    get defaultOpen(): boolean;
+    set defaultOpen(value: boolean);
+    /** Visible message text. */
+    message: string;
+    /** Optional action button label. */
+    actionLabel: string;
+    /** Auto-close duration in milliseconds. Set to 0 to keep open. */
+    duration: number;
+    /** Queue behavior for show calls while open. */
+    queuePolicy: RCSnackbarQueuePolicy;
+    disconnectedCallback(): void;
+    protected updated(changed: PropertyValues<this>): void;
+    protected render(): import('lit').TemplateResult<1>;
+    /**
+     * Shows a message or queues it according to `queuePolicy`.
+     *
+     * @example
+     * snackbar.show({
+     *   message: 'Recipe saved',
+     *   actionLabel: 'Undo',
+     *   duration: 6000,
+     * });
+     */
+    show(message: string | RCSnackbarShowOptions): void;
+    /** Closes the current snackbar. */
+    close(reason?: RCSnackbarCloseReason): void;
+    /** Clears the current snackbar and all queued messages. */
+    clear(): void;
+    private _showNow;
+    private _closeCurrent;
+    private _handleAction;
+    private _clearTimer;
+}
+export default RCSnackbar;

package/dist/types/packages/rc-snackbar/src/rc-snackbar.styles.d.ts

@@ -0,0 +1,2 @@
+export declare const snackbarStyles: import('lit').CSSResult;
+export default snackbarStyles;

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@rcarls/rc-snackbar",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.0.0-next-20260921045401",
+  "description": "Snackbar live-region host for brief status messages and optional actions.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/richardcarls/rc-webcomponents.git",
+    "directory": "packages/rc-snackbar"
+  },
+  "homepage": "https://richardcarls.github.io/rc-webcomponents/components/rc-snackbar",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "module": "./dist/rc-snackbar.js",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/packages/rc-snackbar/src/index.d.ts",
+        "default": "./dist/rc-snackbar.js"
+      }
+    },
+    "./define": {
+      "import": {
+        "types": "./dist/types/packages/rc-snackbar/src/define.d.ts",
+        "default": "./dist/rc-snackbar-define.js"
+      }
+    }
+  },
+  "types": "./dist/types/packages/rc-snackbar/src/index.d.ts",
+  "sideEffects": [
+    "./dist/rc-snackbar-define.js"
+  ],
+  "customElements": "dist/custom-elements.json",
+  "scripts": {
+    "build": "tsc && vite build && cem analyze",
+    "cem:analyze": "cem analyze",
+    "preview": "vite preview",
+    "test:browser": "vitest --run",
+    "test:browser:chrome": "vitest --run --project=chromium",
+    "test:browser:firefox": "vitest --run --project=firefox"
+  },
+  "devDependencies": {
+    "@custom-elements-manifest/analyzer": "0.11.0",
+    "@vitest/browser-playwright": "4.1.5",
+    "lit": "^3.0.0",
+    "playwright": "^1.56.0",
+    "rollup": "^4.60.2",
+    "typescript": "~5.9.3",
+    "vite": "^7.1.7",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.6",
+    "vitest-browser-lit": "^1.0.1"
+  },
+  "peerDependencies": {
+    "lit": "^3.0.0"
+  }
+}