@rcarls/rc-adaptive-menu 0.5.0 → 0.7.0

package/dist/types/packages/rc-adaptive-menu/src/rc-adaptive-menu.d.ts

@@ -1,4 +1,5 @@
 import { LitElement } from 'lit';
+import { FlowController } from '@rcarls/rc-common';
 /** Detail payload for the `rc-adaptive-menu-toggle` event. */
 export interface RCAdaptiveMenuToggleEvent {
     /** The open state requested by the user. */
@@ -12,6 +13,19 @@ declare global {
         'rc-adaptive-menu-toggle': CustomEvent<RCAdaptiveMenuToggleEvent>;
     }
 }
+/** Built-in text of `rc-adaptive-menu`. */
+export interface RCAdaptiveMenuMessages {
+    /** Default accessible name of the toolbar, when `label` is unset. */
+    label: string;
+    /** Accessible name of the overflow trigger and popup. */
+    overflow: string;
+}
+export declare const DEFAULT_ADAPTIVE_MENU_MESSAGES: Readonly<RCAdaptiveMenuMessages>;
+declare module '@rcarls/rc-common' {
+    interface RcMessageCatalog {
+        'rc-adaptive-menu': RCAdaptiveMenuMessages;
+    }
+}
 /**
  * Priority-aware action toolbar that preserves authored light-DOM controls while moving
  * lower-priority actions into an overflow menu.
@@ -39,6 +53,10 @@ declare global {
  * space — a responsive breakpoint, a container query, a window size class —
  * owns that decision itself and writes the resulting `max-shown` value down.
  *
+ * Built-in text (the toolbar and overflow names) follows the element's own `lang`, else
+ * `<html lang>`: per element through `messages`, or for every instance
+ * through `registerMessages()` from `@rcarls/rc-common` under `rc-adaptive-menu`.
+ *
  * @see {@link https://richardcarls.github.io/rc-webcomponents/components/rc-adaptive-menu rc-adaptive-menu docs}
  * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/toolbar/ WAI-ARIA Toolbar pattern}
  * @see {@link https://www.w3.org/WAI/ARIA/apg/patterns/menu-button/ WAI-ARIA Menu Button pattern}
@@ -49,14 +67,15 @@ declare global {
  *
  * @fires rc-adaptive-menu-toggle - Fired when user interaction requests a change to `open`.
  *
- * @attr label - Accessible label for the toolbar. Defaults to `Actions`.
+ * @attr label - Accessible label for the toolbar. Defaults to the `label` message, `Actions`.
  * @attr max-shown - Maximum number of authored actions promoted ahead of the overflow trigger.
  *   A static declarative cap, not a measurement of available space — actions beyond it move to
  *   the overflow menu regardless of whether they'd visually fit. Defaults to 3.
  * @attr open - Whether the overflow menu is visible. Host writes are silent.
  * @attr default-open - Initial open state for uncontrolled usage.
- * @attr orientation - Toolbar layout and arrow-key axis: `horizontal` or `vertical`.
- * @attr overflow-label - Accessible label for the overflow trigger and popup. Defaults to `More actions`.
+ * @attr orientation - Toolbar layout along the inline (`horizontal`) or block (`vertical`) axis.
+ *   `aria-orientation` and the arrow keys follow the orientation actually rendered, which turns
+ *   over in vertical writing modes.
  *
  * @csspart root - Toolbar container.
  * @csspart overflow-trigger - Button that opens the overflow menu.
@@ -79,16 +98,25 @@ declare global {
  * @cssprop [--rc-adaptive-menu-trigger-radius=var(--rc-control-radius)] - Overflow trigger radius.
  * @cssprop [--rc-adaptive-menu-trigger-background=ButtonFace] - Overflow trigger background.
  * @cssprop [--rc-adaptive-menu-trigger-color=ButtonText] - Overflow trigger color.
+ * @cssprop [--rc-adaptive-menu-trigger-hover-background=var(--rc-adaptive-menu-trigger-background)] - Overflow trigger background under the pointer.
+ * @cssprop [--rc-adaptive-menu-trigger-shadow=none] - Overflow trigger box shadow.
+ * @cssprop [--rc-adaptive-menu-trigger-active-shadow=var(--rc-adaptive-menu-trigger-shadow)] - Overflow trigger box shadow while pressed.
+ * @cssprop [--rc-item-font-family=inherit] - Overflow action label font family; shared with menu and listbox items.
+ * @cssprop [--rc-item-font-size=inherit] - Overflow action label font size; shared with menu and listbox items.
+ * @cssprop [--rc-item-font-weight=inherit] - Overflow action label font weight; shared with menu and listbox items.
+ * @cssprop [--rc-item-line-height=inherit] - Overflow action label line height; shared with menu and listbox items.
+ * @cssprop [--rc-item-letter-spacing=inherit] - Overflow action label letter spacing; shared with menu and listbox items.
+ * @cssprop [--rc-item-icon-size=inherit] - Overflow action leading icon size; shared with menu items.
  * @cssprop [--rc-adaptive-menu-icon-size=1.5em] - Default overflow icon size.
  * @cssprop [--rc-adaptive-menu-popup-min-inline-size=10em] - Overflow popup minimum inline size.
  * @cssprop [--rc-adaptive-menu-popup-max-inline-size=calc(100dvi - 0.5rem)] - Overflow popup viewport-aware inline limit.
  * @cssprop [--rc-adaptive-menu-popup-max-block-size=calc(100dvb - 0.5rem)] - Overflow popup viewport-aware block limit.
- * @cssprop [--rc-adaptive-menu-popup-padding-block=0.25em] - Overflow popup block padding.
- * @cssprop [--rc-adaptive-menu-popup-border=var(--rc-border)] - Overflow popup border.
- * @cssprop [--rc-adaptive-menu-popup-radius=var(--rc-control-radius)] - Overflow popup radius.
- * @cssprop [--rc-adaptive-menu-popup-background=var(--rc-surface)] - Overflow popup background.
- * @cssprop [--rc-adaptive-menu-popup-shadow=var(--rc-shadow)] - Overflow popup shadow.
- * @cssprop [--rc-adaptive-menu-popup-color=var(--rc-field-text)] - Overflow popup foreground.
+ * @cssprop [--rc-adaptive-menu-popup-padding-block=var(--rc-popup-padding-block)] - Overflow popup block padding.
+ * @cssprop [--rc-adaptive-menu-popup-border=var(--rc-popup-border)] - Overflow popup border.
+ * @cssprop [--rc-adaptive-menu-popup-radius=var(--rc-popup-radius)] - Overflow popup radius.
+ * @cssprop [--rc-adaptive-menu-popup-background=var(--rc-popup-background)] - Overflow popup background.
+ * @cssprop [--rc-adaptive-menu-popup-shadow=var(--rc-popup-shadow)] - Overflow popup shadow.
+ * @cssprop [--rc-adaptive-menu-popup-color=var(--rc-popup-color)] - Overflow popup foreground.
  * @cssprop [--rc-adaptive-menu-item-min-block-size=2.5em] - Overflow action minimum block size.
  * @cssprop [--rc-adaptive-menu-item-padding-block=var(--rc-item-padding-block)] - Overflow action block padding.
  * @cssprop [--rc-adaptive-menu-item-padding-inline=var(--rc-item-padding-inline)] - Overflow action inline padding.
@@ -96,9 +124,12 @@ declare global {
  */
 export declare class RCAdaptiveMenu extends LitElement {
     static styles: import('lit').CSSResult;
+    /** Built-in text overrides; unset keys fall back to registered text, then English. */
+    messages: Partial<RCAdaptiveMenuMessages> | undefined;
+    private readonly _messages;
     private static readonly _styledRoots;
-    /** Accessible label for the toolbar. */
-    label: string;
+    /** Accessible label for the toolbar. Defaults to the `label` message. */
+    label: string | undefined;
     /**
      * Maximum authored actions promoted ahead of the overflow trigger. A
      * static declarative cap, re-evaluated whenever it changes — not a
@@ -117,8 +148,8 @@ export declare class RCAdaptiveMenu extends LitElement {
     set defaultOpen(value: boolean);
     /** Toolbar layout and arrow-key navigation axis. */
     orientation: 'horizontal' | 'vertical';
-    /** Accessible name for the overflow trigger and popup. */
-    overflowLabel: string;
+    /** Keeps the exposed aria-orientation on the orientation actually rendered. */
+    protected readonly _flow: FlowController;
     private _$trigger;
     private _$popup;
     private readonly _authored;
@@ -127,6 +158,7 @@ export declare class RCAdaptiveMenu extends LitElement {
     private _restoreFocusWhenClosed;
     private _focusWhenOpened;
     private readonly _anchor;
+    private readonly _popover;
     connectedCallback(): void;
     disconnectedCallback(): void;
     protected firstUpdated(): void;
@@ -143,7 +175,7 @@ export declare class RCAdaptiveMenu extends LitElement {
     closeMenu(returnFocus?: boolean): void;
     /** Toggles the overflow popup silently. */
     toggleMenu(focus?: 'first' | 'last' | 'none'): void;
-    protected render(): import('lit').TemplateResult<1>;
+    protected render(): import('lit-html').TemplateResult<1>;
     private static _ensureBaseStyles;
     private _onSlotChange;
     private _onMutation;

package/package.json

@@ -3,7 +3,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "Priority-aware action toolbar that preserves authored controls while moving lower-priority actions into an overflow menu.",
   "repository": {
     "type": "git",
@@ -45,7 +45,7 @@
     "test:browser:firefox": "vitest --run --project=firefox"
   },
   "dependencies": {
-    "@rcarls/rc-common": "0.5.0"
+    "@rcarls/rc-common": "0.7.0"
   },
   "devDependencies": {
     "@custom-elements-manifest/analyzer": "0.11.0",