@inglorious/ui 8.6.0 → 9.0.0

package/types/navigation/menu.d.ts

@@ -1,5 +1,7 @@
 import type { TemplateResult } from "@inglorious/web"
 
+import type { ButtonProps } from "../controls/button"
+
 export interface MenuItem {
   id?: string | number
   value?: string | number
@@ -14,9 +16,23 @@ export interface MenuItem {
 }
 
 export interface MenuProps {
+  /** Required with `trigger`: it links the button to the menu. */
   id?: string
   type?: string
   isOpen?: boolean
+  /**
+   * Content of a button that opens the menu. With it, the menu is a popover
+   * anchored to the button; without it, the menu renders in place while open.
+   */
+  trigger?: TemplateResult | string | number
+  /** Extra props for the trigger button, such as `variant` or `ariaLabel`. */
+  triggerProps?: ButtonProps
+  /**
+   * Called with the new state when the browser opens or closes an anchored
+   * menu. Without it, the browser alone keeps the open state and `isOpen` is
+   * not applied.
+   */
+  onToggle?: (isOpen: boolean) => void
   items?: MenuItem[]
   isDense?: boolean
   className?: string
@@ -26,6 +42,7 @@ export interface MenuProps {
 
 export type MenuType = {
   render(props: MenuProps): TemplateResult | null
+  renderTrigger(props: MenuProps): TemplateResult
   renderMenu(props: MenuProps): TemplateResult | null
   renderItem(item: MenuItem, index: number, props: MenuProps): TemplateResult
 }

package/types/navigation/speed-dial.d.ts

@@ -18,6 +18,11 @@ export interface SpeedDialProps {
   ariaLabel?: string
   direction?: "up" | "down" | "left" | "right"
   actions?: SpeedDialAction[]
+  /**
+   * Called with the new state when the browser opens or closes the actions.
+   * Without it, the browser alone keeps the open state and `isOpen` is not
+   * applied.
+   */
   onToggle?: (isOpen: boolean) => void
   onAction?: (value: string | number, action: SpeedDialAction) => void
   [key: string]: unknown

package/types/surfaces/accordion.d.ts

@@ -15,6 +15,8 @@ export interface AccordionProps {
   id?: string
   type?: string
   className?: string
+  /** Items sharing a name close each other: at most one is open at a time. */
+  name?: string
   items?: AccordionItem[]
   onItemToggle?: (item: AccordionItem, index: number, expanded: boolean) => void
   [key: string]: unknown