docs(snackbar): review and enhancement

packages/snackbar/src/lib/element.ts

@@ -48,6 +48,7 @@ export class SnackbarElement extends LightDomMixin(LoggerMixin(LitElement)) {
    * Waits for the closing animation to end before removing the element.
    *
    * @internal
+   * This method should be used by the package API, not directly, to ensure proper signal unsubscription.
    */
   async close(): Promise<void> {
     this.logger_.logMethod?.('close');

packages/snackbar/src/lib/handler.ts

@@ -54,19 +54,19 @@ function createSnackbarElement(options: SnackbarOptions): SnackbarElement {
 function handleActionButtonClick(closeSnackbar: () => Promise<void>, handler?: SnackbarActionHandler): void {
   logger.logMethod?.('handleActionButtonClick');
 
-  const actionButtonClickHandler = async () => {
+  const actionButtonClickHandler = () => {
     logger.logOther?.('Snackbar action button clicked.');
 
-    await handler?.();
+    handler?.();
     return closeSnackbar();
   };
 
   /**
    * Store the function to unsubscribe the action button handler after close or action button clicked.
+   *
+   * TODO: check why once not work
    */
-  unsubscribeActionButtonHandler = snackbarActionButtonClickedSignal.subscribe(actionButtonClickHandler.bind(null), {
-    // once: true, // not work!
-  }).unsubscribe;
+  unsubscribeActionButtonHandler = snackbarActionButtonClickedSignal.subscribe(actionButtonClickHandler.bind(null)).unsubscribe;
 }
 
 /**
@@ -99,6 +99,7 @@ async function showSnackbar(options: SnackbarOptions): Promise<void> {
   }
 
   if (options.addCloseButton === true) {
+    // TODO: check why once not work
     unsubscribeCloseButtonHandler = snackbarCloseButtonClickedSignal.subscribe(closeSnackbar.bind(null)).unsubscribe;
   }
 

packages/snackbar/src/lib/type.ts

@@ -19,7 +19,7 @@ export type SnackbarOptions = {
    */
   action?: {
     /**
-     * The signal ID to be emitted when the action button is clicked.
+     * The handler to be called when the action button is clicked.
      */
     handler: SnackbarActionHandler;