@domphy/ui 0.21.0 → 0.21.1

package/dist/index.d.cts

@@ -359,14 +359,23 @@ declare function details(props?: {
  * dialog, restores focus to the previously focused element on close, sets
  * `aria-modal`, and closes on outside (backdrop) click. Apply to a `<dialog>`.
  *
+ * Accessible name/description: pass `labelledBy`/`describedBy` the `id` of a
+ * heading/paragraph inside the dialog (Radix Title/Description parity). The
+ * native `ariaLabelledby`/`ariaDescribedby` attributes on the host element
+ * remain an equivalent escape hatch (the native element always wins).
+ *
  * @hostTag dialog
  * @param props.color - Theme color tone for the dialog surface. Defaults to "neutral".
  * @param props.open - Open state (`ValueOrState<boolean>`); set it to true/false to show/hide. Defaults to false.
- * @example { dialog: [...], $: [dialog({ open })] }
+ * @param props.labelledBy - `id` of the element labeling the dialog (wired to `aria-labelledby`). Optional.
+ * @param props.describedBy - `id` of the element describing the dialog (wired to `aria-describedby`). Optional.
+ * @example { dialog: [{ h2: "Confirm", id: "dlg-title" }], $: [dialog({ open, labelledBy: "dlg-title" })] }
  */
 declare function dialog(props?: {
     color?: ThemeColor;
     open?: ValueOrState<boolean>;
+    labelledBy?: string;
+    describedBy?: string;
 }): PartialElement;
 
 /**
@@ -1212,6 +1221,9 @@ declare function select(props?: {
  * A clickable select trigger box that renders the currently selected option(s) as removable
  * tags and toggles a floating popover (the dropdown content) anchored to itself. Selected
  * labels are derived from `options` matching the bound `value`; removing a tag updates the value.
+ * Keyboard: Enter/Space toggle, ArrowDown opens, Escape closes, and printable characters
+ * typeahead-search options (closed: selects the match; open: focuses the matching
+ * `[role=option]` in the panel; a repeated character cycles matches).
  *
  * @hostTag div
  * @param props.multiple - Whether multiple selection is allowed (renders removable tags and

package/dist/index.d.ts

@@ -359,14 +359,23 @@ declare function details(props?: {
  * dialog, restores focus to the previously focused element on close, sets
  * `aria-modal`, and closes on outside (backdrop) click. Apply to a `<dialog>`.
  *
+ * Accessible name/description: pass `labelledBy`/`describedBy` the `id` of a
+ * heading/paragraph inside the dialog (Radix Title/Description parity). The
+ * native `ariaLabelledby`/`ariaDescribedby` attributes on the host element
+ * remain an equivalent escape hatch (the native element always wins).
+ *
  * @hostTag dialog
  * @param props.color - Theme color tone for the dialog surface. Defaults to "neutral".
  * @param props.open - Open state (`ValueOrState<boolean>`); set it to true/false to show/hide. Defaults to false.
- * @example { dialog: [...], $: [dialog({ open })] }
+ * @param props.labelledBy - `id` of the element labeling the dialog (wired to `aria-labelledby`). Optional.
+ * @param props.describedBy - `id` of the element describing the dialog (wired to `aria-describedby`). Optional.
+ * @example { dialog: [{ h2: "Confirm", id: "dlg-title" }], $: [dialog({ open, labelledBy: "dlg-title" })] }
  */
 declare function dialog(props?: {
     color?: ThemeColor;
     open?: ValueOrState<boolean>;
+    labelledBy?: string;
+    describedBy?: string;
 }): PartialElement;
 
 /**
@@ -1212,6 +1221,9 @@ declare function select(props?: {
  * A clickable select trigger box that renders the currently selected option(s) as removable
  * tags and toggles a floating popover (the dropdown content) anchored to itself. Selected
  * labels are derived from `options` matching the bound `value`; removing a tag updates the value.
+ * Keyboard: Enter/Space toggle, ArrowDown opens, Escape closes, and printable characters
+ * typeahead-search options (closed: selects the match; open: focuses the matching
+ * `[role=option]` in the panel; a repeated character cycles matches).
  *
  * @hostTag div
  * @param props.multiple - Whether multiple selection is allowed (renders removable tags and