@rettangoli/ui 1.4.2 → 1.6.0

package/src/deps/createGlobalUI.js

@@ -1,7 +1,7 @@
 /**
  * Creates a GlobalUI manager instance for controlling global UI components.
  * Provides methods for showing alerts, confirm dialogs, form dialogs,
- * dropdown menus, and closing all UI components.
+ * dropdown menus, toasts, and closing all UI components.
  *
  * @param {HTMLElement} globalUIElement - The globalUI component element
  * @returns {Object} GlobalUI manager instance
@@ -12,6 +12,7 @@
  * @returns {Function} returns.showFormDialog - Show a form dialog
  * @returns {Function} returns.showComponentDialog - Show a component dialog
  * @returns {Function} returns.showDropdownMenu - Show a dropdown menu
+ * @returns {Function} returns.showToast - Show a temporary toast message
  * @returns {Function} returns.closeAll - General-purpose function to close all currently open UI components
  */
 const createGlobalUI = (globalUIElement) => {
@@ -161,9 +162,27 @@ const createGlobalUI = (globalUIElement) => {
       return globalUIElement.transformedHandlers.handleShowDropdownMenu(options);
     },
 
+    /**
+     * Shows a top-centered toast message that auto-dismisses after 3 seconds.
+     *
+     * @param {Object} options - Toast configuration options
+     * @param {string} options.message - The toast message (required)
+     * @param {('sm'|'md'|'lg')} [options.size] - Toast width preset matching dialog sizing (default: "sm")
+     * @returns {void}
+     * @throws {Error} If globalUIElement is not initialized
+     */
+    showToast: (options) => {
+      if(!globalUIElement)
+      {
+        throw new Error("globalUIElement is not set. Make sure to initialize the global UI component and pass it to createGlobalUIManager.");
+      }
+      globalUIElement.transformedHandlers.handleShowToast(options);
+    },
+
     /**
      * General-purpose function to close all currently open UI components.
-     * This includes dialogs, popovers, tooltips, selects, dropdown menus, and any other floating UI elements.
+     * This includes dialogs, dropdown menus, toasts, and any other floating UI elements
+     * managed by rtgl-global-ui.
      * Useful for programmatically cleaning up the entire UI surface.
      *
      * @returns {Promise<void>} Promise that resolves when all UI components are closed

package/src/primitives/popover.js

@@ -255,7 +255,9 @@ class RettangoliPopoverElement extends HTMLElement {
 
     const hasContent = Array.from(wrapper.childNodes).some((node) => !this._isIgnorableTextNode(node));
 
-    if (hasContent) {
+    // Keep the content wrapper slotted while open so callers can intentionally
+    // show an empty popover shell, such as an empty select menu.
+    if (hasContent || this.hasAttribute("open")) {
       wrapper.setAttribute("slot", "content");
     } else {
       wrapper.removeAttribute("slot");