@salt-ds/lab 1.0.0-alpha.91 → 1.0.0-alpha.92

package/dist-types/side-panel/useSidePanel.d.ts

@@ -1,3 +1,20 @@
+import type { ComponentPropsWithoutRef, MouseEvent, MutableRefObject, RefCallback } from "react";
+export interface SidePanelTriggerExtraProps {
+    /**
+     * Optional ref to forward alongside the focus-return registration.
+     */
+    ref?: RefCallback<HTMLElement | null> | MutableRefObject<HTMLElement | null> | null;
+    /**
+     * Click handler. Runs before the built-in toggle so consumers can
+     * preventDefault to skip the toggle.
+     */
+    onClick?: (event: MouseEvent<HTMLButtonElement>) => void;
+}
+export type SidePanelTriggerPropsResult = ComponentPropsWithoutRef<"button"> & {
+    "aria-expanded": boolean;
+    "aria-controls": string | undefined;
+    ref: RefCallback<HTMLElement | null>;
+};
 export interface SidePanelValue {
     /**
      * Whether the side panel is currently open.
@@ -18,16 +35,18 @@ export interface SidePanelValue {
      * ```
      *
      * You can pass additional props which are merged in. If you provide your
-     * own `onClick`, it runs before the built-in toggle.
+     * own `onClick`, it runs before the built-in toggle. If you provide your
+     * own `ref`, it is forwarded alongside the internal focus-return ref.
      *
      * For multi-trigger scenarios (e.g. table rows), use `setTriggerRef` and
      * manage ARIA attributes yourself instead.
      */
-    getTriggerProps: (userProps?: Record<string, unknown>) => Record<string, unknown>;
+    getTriggerProps: (userProps?: SidePanelTriggerExtraProps) => SidePanelTriggerPropsResult;
     /**
      * Registers the element that should receive focus when the panel closes.
      * Use this in multi-trigger scenarios (e.g. table rows) where each trigger
-     * needs explicit control over which element is the reference.
+     * needs explicit control over which element is the reference. Pass `null`
+     * to clear the previously-registered trigger.
      */
     setTriggerRef: (element: HTMLElement | null) => void;
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salt-ds/lab",
-  "version": "1.0.0-alpha.91",
+  "version": "1.0.0-alpha.92",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",