@redvars/peacock 3.8.1 → 3.8.3

package/dist/src/code-highlighter/code-highlighter.d.ts

@@ -1,5 +1,5 @@
 import { LitElement } from 'lit';
-import { BundledLanguage } from 'shiki';
+import type { BundledLanguage } from 'shiki';
 /**
  * @label Code Highlighter
  * @tag wc-code-highlighter
@@ -34,7 +34,7 @@ export declare class CodeHighlighter extends LitElement {
     firstUpdated(): void;
     private decode;
     private __highlightCode;
-    protected updated(): void;
+    protected updated(changed: Map<PropertyKey, unknown>): void;
     private __handleCopyClick;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/src/color-picker/color-picker.d.ts

@@ -0,0 +1,85 @@
+import { LitElement } from 'lit';
+/**
+ * @label Color Picker
+ * @tag wc-color-picker
+ * @rawTag color-picker
+ *
+ * @summary A color picker component for selecting colors via a hue/saturation/value interface.
+ *
+ * @overview
+ * <p>The color picker presents a 2D saturation–brightness panel with a hue slider below it.
+ * An optional alpha slider allows controlling opacity. The current hex value is displayed in
+ * an editable text field.</p>
+ *
+ * @cssprop --color-picker-width - Overall width of the component. Defaults to 240px.
+ * @cssprop --color-picker-sv-height - Height of the saturation/brightness panel. Defaults to 160px.
+ *
+ * @fires {CustomEvent<{value: string, alpha: number}>} input - Dispatched continuously while the color is being changed.
+ * @fires {CustomEvent<{value: string, alpha: number}>} change - Dispatched when a color change is committed (pointer up, key, or input blur).
+ *
+ * @example
+ * ```html
+ * <wc-color-picker value="#2352d5"></wc-color-picker>
+ * ```
+ *
+ * @example
+ * ```html
+ * <wc-color-picker value="#ff573380" alpha></wc-color-picker>
+ * ```
+ */
+export declare class ColorPicker extends LitElement {
+    static styles: import("lit").CSSResultGroup[];
+    /**
+     * The current color as a 6-digit hex string (e.g. `"#ff5733"`).
+     */
+    value: string;
+    /**
+     * Whether to show the alpha (opacity) slider and input.
+     */
+    alpha: boolean;
+    /**
+     * Whether the color picker is disabled.
+     */
+    disabled: boolean;
+    /** Current hue, 0–360. */
+    private _hue;
+    /** Current saturation, 0–1 (x-axis of the SV panel). */
+    private _sat;
+    /** Current brightness (value in HSV), 0–1 (y-axis, 1 = bright). */
+    private _bri;
+    /** Current opacity, 0–1. */
+    private _opacity;
+    /** Intermediate value for the hex text input (without `#`). */
+    private _hexInput;
+    private _svPanel?;
+    private _hueTrack?;
+    private _alphaTrack?;
+    /** Tracks which drag handle is currently active. */
+    private _dragging;
+    /** The last `value` we set ourselves, used to skip redundant re-syncs in `updated`. */
+    private _lastEmittedValue;
+    connectedCallback(): void;
+    updated(changed: Map<PropertyKey, unknown>): void;
+    private _syncFromValue;
+    private _computeHex;
+    private _emitValue;
+    private _onSvPointerDown;
+    private _onSvPointerMove;
+    private _onSvPointerUp;
+    private _updateSv;
+    private _onSvKeyDown;
+    private _onHuePointerDown;
+    private _onHuePointerMove;
+    private _onHuePointerUp;
+    private _updateHue;
+    private _onHueKeyDown;
+    private _onAlphaPointerDown;
+    private _onAlphaPointerMove;
+    private _onAlphaPointerUp;
+    private _updateAlpha;
+    private _onAlphaKeyDown;
+    private _onHexInput;
+    private _onHexChange;
+    private _onAlphaNumberChange;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/src/color-picker/index.d.ts

@@ -0,0 +1 @@
+export { ColorPicker } from './color-picker.js';

package/dist/src/container/container.d.ts

@@ -15,8 +15,12 @@ type ContainerSize = 'max' | 'xl' | 'lg' | 'md' | 'sm' | 'full';
  * ```
  */
 export declare class Container extends LitElement {
-    size: ContainerSize;
     static styles: import("lit").CSSResultGroup[];
+    /**
+     * Max-width breakpoint of the container.
+     * Possible values are `"max"`, `"xl"`, `"lg"`, `"md"`, `"sm"`, `"full"`. Defaults to `"full"`.
+     */
+    size: ContainerSize;
     render(): import("lit-html").TemplateResult<1>;
 }
 export {};

package/dist/src/divider/divider.d.ts

@@ -20,7 +20,9 @@ import { LitElement } from 'lit';
  */
 export declare class Divider extends LitElement {
     static styles: import("lit").CSSResultGroup[];
+    /** When true, renders the divider vertically. Defaults to horizontal. */
     vertical: boolean;
+    /** True when the default slot contains content, used to show the label variant. */
     slotHasContent: boolean;
     firstUpdated(): void;
     render(): import("lit-html").TemplateResult<1>;

package/dist/src/empty-state/empty-state.d.ts

@@ -16,6 +16,7 @@ export declare class EmptyState extends LitElement {
     illustration: 'no-document' | 'page' | 'search';
     headline: string;
     description: string;
+    /** True when the component width is below 768px; triggers a stacked layout. */
     private vertical;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/src/field/field.d.ts

@@ -19,30 +19,48 @@ import { LitElement, nothing } from 'lit';
 export declare class Field extends LitElement {
     static shadowRootOptions: ShadowRootInit;
     static styles: import("lit").CSSResultGroup[];
+    /** Label text shown above the field input. */
     label: string;
+    /** Help text (deprecated — prefer `helperText`). */
     help: string;
+    /** When true, marks the field as required and shows a required indicator. */
     required: boolean;
+    /** When true, the field and its slotted input are disabled. */
     disabled: boolean;
+    /** When true, the field and its slotted input are read-only. */
     readonly: boolean;
+    /** When true, renders the field in a loading skeleton state. */
     skeleton: boolean;
+    /** Helper/hint text shown in the field footer. */
     helperText: string;
+    /** When true, the field is in an error state and `errorText` is shown. */
     error: boolean;
+    /** Error message displayed when `error` is true. */
     errorText: string;
+    /** When true, the field is in a warning state and `warningText` is shown. */
     warning: boolean;
+    /** Warning message displayed when `warning` is true. */
     warningText: string;
+    /** Character / word count string displayed at the trailing end of the footer. */
     textCount: string;
+    /** When true, applies focused styling (controlled externally by the slotted input). */
     focused: boolean;
+    /** When true, applies populated styling (controlled externally by the slotted input). */
     populated: boolean;
+    /** Visual variant of the field container. */
     variant: 'filled' | 'outlined' | 'default';
+    /** Reference to the host input element; used to forward click-on-label focus. */
     host?: HTMLElement;
+    /** True when the `field-start` slot contains at least one node. */
     slotStartHasContent: boolean;
+    /** True when the `field-end` slot contains at least one node. */
     slotEndHasContent: boolean;
     firstUpdated(): void;
     __handleClick(): void;
     __renderInputSlot(): import("lit-html").TemplateResult<1>;
     __renderFieldHeader(): typeof nothing | import("lit-html").TemplateResult<1>;
-    render(): import("lit-html").TemplateResult<1>;
     __renderFieldFooter(): typeof nothing | import("lit-html").TemplateResult<1>;
     __renderHelperText(): typeof nothing | import("lit-html").TemplateResult<1>;
     __renderWordCount(): typeof nothing | import("lit-html").TemplateResult<1>;
+    render(): import("lit-html").TemplateResult<1>;
 }

package/dist/src/focus-ring/focus-ring.d.ts

@@ -1,5 +1,5 @@
 import { LitElement, PropertyValues } from 'lit';
-import { Attachable } from '@/__controllers/attachable-controller.js';
+import { Attachable } from '@/__internal/controllers/attachable-controller.js';
 declare const HANDLED_BY_FOCUS_RING: unique symbol;
 interface FocusRingEvent extends Event {
     [HANDLED_BY_FOCUS_RING]: true;
@@ -19,13 +19,9 @@ interface FocusRingEvent extends Event {
  */
 export declare class FocusRing extends LitElement implements Attachable {
     static styles: import("lit").CSSResultGroup[];
-    /**
-     * Makes the focus ring visible.
-     */
+    /** When true, the focus ring is visible. Toggled automatically based on `:focus-visible` state. */
     visible: boolean;
-    /**
-     * Makes the focus ring animate inwards instead of outwards.
-     */
+    /** When true, the ring animates inward instead of outward (for use inside containers). */
     inward: boolean;
     get htmlFor(): string | null;
     set htmlFor(htmlFor: string | null);

package/dist/src/html-editor/html-editor.d.ts

@@ -7,7 +7,7 @@ import BaseInput from '../input/BaseInput.js';
  * @summary A Tiptap-powered HTML editor with visual and source editing modes.
  * @overview
  * <p>The HTML Editor provides a rich-text editing experience built on Tiptap.
- * It wraps the editable area in a Material 3 styled <code>wc-field</code>,
+ * It wraps the editable area in A styled <code>wc-field</code>,
  * exposes common formatting actions, and includes a segmented switch between
  * <strong>Visual</strong> and <strong>HTML</strong> source modes.</p>
  *

package/dist/src/icon/icon.d.ts

@@ -23,19 +23,24 @@ export declare class Icon extends LitElement {
      * This name corresponds to a specific SVG asset in the icon set.
      */
     name?: string;
+    /** URL of an external SVG file to fetch and render inline. */
     src?: string;
+    /** Icon library provider. Defaults to `"material-symbols"`. */
     provider: IconProvider;
+    /** Rendered SVG markup, updated after each successful fetch. */
     private svgContent;
+    /** True while an SVG fetch is in-flight. */
     private loading;
+    /** Holds the last fetch error, if any. */
     private error;
+    /** Monotonically incrementing token used to discard stale fetch results. */
     private _fetchId;
+    /** Timer handle for debouncing rapid property changes. */
     private _debounceTimer;
     firstUpdated(): void;
     updated(changedProperties: any): void;
-    render(): import("lit-html").TemplateResult<1>;
     private __scheduleUpdate;
-    /**
-     * @internal
-     */
+    /** @internal */
     private __updateSvg;
+    render(): import("lit-html").TemplateResult<1>;
 }

package/dist/src/image/image.d.ts

@@ -21,10 +21,14 @@ export declare class Image extends LitElement {
     imageTitle: string;
     /** Enable click-to-preview lightbox */
     preview: boolean;
+    /** True when the OS/app theme is dark, used to select `darkSrc`. */
     private _isDarkMode;
+    /** True once the image has entered the viewport and the `<img>` element has been rendered. */
     private _loaded;
     private _dialog?;
+    /** IntersectionObserver for lazy-loading the image when it enters the viewport. */
     private _intersectionObserver;
+    /** Cleanup function returned by `observeThemeChange`. */
     private _themeCleanup;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/src/index.d.ts

@@ -5,8 +5,8 @@ export { Divider } from './divider/index.js';
 export { Clock } from './clock/index.js';
 export { Elevation } from './elevation/index.js';
 export { Button, ButtonGroup, IconButton } from './button/index.js';
-export { Fab } from './fab/index.js';
-export { SegmentedButton, SegmentedButtonGroup } from './segmented-button/index.js';
+export { Fab } from './button/fab/index.js';
+export { SegmentedButton, SegmentedButtonGroup, } from './segmented-button/index.js';
 export { SplitButton } from './split-button/index.js';
 export { DropdownButton } from './dropdown-button/index.js';
 export { FocusRing } from './focus-ring/index.js';
@@ -45,14 +45,15 @@ export { Image } from './image/index.js';
 export { Svg } from './svg/index.js';
 export { Tab, TabGroup, TabPanel, Tabs } from './tabs/index.js';
 export { Slider } from './slider/index.js';
+export { ColorPicker } from './color-picker/index.js';
 export { ChartDoughnut } from './chart-doughnut/index.js';
 export { ChartPie } from './chart-pie/index.js';
 export { ChartBar, ChartStackedBar } from './chart-bar/index.js';
 export { Table } from './table/index.js';
 export { Pagination } from './pagination/index.js';
-export { SidebarMenu, SidebarMenuItem, SidebarSubMenu } from './sidebar-menu/index.js';
+export { SidebarMenu, SidebarMenuItem, SidebarSubMenu, } from './sidebar-menu/index.js';
 export { Card } from './card/index.js';
-export { Banner } from './banner/index.js';
+export { Alert } from './alert/index.js';
 export { Notification } from './notification/index.js';
 export { NotificationManager } from './notification-manager/index.js';
 export { Snackbar } from './snackbar/index.js';
@@ -65,11 +66,12 @@ export type { SelectOption } from './select/index.js';
 export { SelectOptionElement } from './select/index.js';
 export { Search } from './search/index.js';
 export { Toolbar } from './toolbar/index.js';
+export { AppBar } from './app-bar/index.js';
 export { NavigationRail, NavigationRailItem } from './navigation-rail/index.js';
-export { Calendar, CalendarColumnView, CalendarMonthView } from './calendar/index.js';
+export { Calendar, CalendarColumnView, CalendarMonthView, } from './calendar/index.js';
 export type { CalendarViewType, EventType } from './calendar/index.js';
 export { Canvas } from './canvas/index.js';
 export type { CanvasShape } from './canvas/index.js';
 export { FlowDesigner, FlowDesignerNode } from './flow-designer/index.js';
 export type { Workflow, WorkflowNode, WorkflowCommand, PositionedNode, ValidationError, HistoryEntry, EditorState, NodeType, WorkflowChangeEvent, SwimlaneConfig, NodeTemplate, } from './flow-designer/index.js';
-export { ConditionBuilder, CbPredicate, CbCompoundExpression, CbExpression, CbDivider } from './condition-builder/index.js';
+export { ConditionBuilder, CbPredicate, CbCompoundExpression, CbExpression, CbDivider, } from './condition-builder/index.js';

package/dist/src/item/item.d.ts

@@ -1,20 +1,21 @@
 import { LitElement } from 'lit';
-declare const Item_base: typeof LitElement & import("../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface> & import("../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeButtonMixin.js").NativeButtonInterface>;
+declare const Item_base: import("../__internal/mixins/mixin.js").MixinReturn<import("../__internal/mixins/mixin.js").MixinReturn<typeof LitElement, import("@/__internal/mixins/element-internals.js").WithElementInternals>>;
 /**
  * @label Item
  * @tag wc-item
  * @rawTag item
  *
- * @summary A Material 3 item with start, text and end slots.
+ * @summary A primitive element used to build higher-level item components such as menu-item, navigation-item, and list-item. Provides start, text, and end slots for flexible content composition.
  *
  * @example
  * ```html
- * <wc-item selected>
- *   <wc-icon slot="start" name="home"></wc-icon>
- *   <div slot="overline">Overline</div>
- *   <div slot="headline">Headline</div>
- *   <div slot="supporting-text">Supporting text</div>
- *   <div slot="trailing-supporting-text">Trailing</div>
+ * <wc-item>
+ *   <wc-icon slot="start" name="notifications"></wc-icon>
+ *
+ *   <span slot="headline">Notifications</span>
+ *   <span slot="supporting-text">Manage alerts and reminders</span>
+ *
+ *   <span slot="trailing-supporting-text">3</span>
  *   <wc-icon slot="end" name="chevron_right"></wc-icon>
  * </wc-item>
  * ```
@@ -22,28 +23,17 @@ declare const Item_base: typeof LitElement & import("../__mixins/MixinConstructo
  */
 export declare class Item extends Item_base {
     static styles: import("lit").CSSResultGroup[];
-    static get observedAttributes(): string[];
-    private readonly __contentObserver;
-    private __capturedTabIndex?;
-    private __isCapturingTabIndex;
-    selected: boolean;
-    readonly itemElement: HTMLElement | null;
-    isPressed: boolean;
-    private __handleSlotChange;
+    /**
+     * Only needed for SSR.
+     *
+     * Add this attribute when an item has two lines to avoid a Flash Of Unstyled
+     * Content. This attribute is not needed for single line items or items with
+     * three or more lines.
+     */
+    multiline: boolean;
+    private readonly textSlots;
     private __hasNamedSlot;
-    private __hasDefaultSlot;
-    connectedCallback(): void;
-    disconnectedCallback(): void;
-    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
-    focus(): void;
-    blur(): void;
-    __dispatchClick: (event: MouseEvent | KeyboardEvent) => void;
-    __handleKeyDown: (event: KeyboardEvent) => void;
-    __handlePress: (event: KeyboardEvent | MouseEvent) => void;
-    private __getForwardedAttribute;
-    private __captureHostTabIndex;
     render(): import("lit-html").TemplateResult<1>;
-    renderItemElement(cssClasses: any, role: string | undefined, tabIndex: string | undefined, ariaHasPopup: string | undefined, ariaControls: string | undefined, ariaExpanded: string | undefined): import("lit-html").TemplateResult<1>;
-    renderContent(): import("lit-html").TemplateResult<1>;
+    private handleTextSlotChange;
 }
 export {};

package/dist/src/link/link.d.ts

@@ -1,5 +1,5 @@
 import { LitElement } from 'lit';
-declare const Link_base: typeof LitElement & import("../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface>;
+declare const Link_base: typeof LitElement & import("../__internal/mixins/MixinConstructor.js").MixinConstructor<import("@/__internal/mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface>;
 /**
  * @label Link
  * @tag wc-link

package/dist/src/list/list-item.d.ts

@@ -1,11 +1,11 @@
 import { LitElement } from 'lit';
-declare const ListItem_base: typeof LitElement & import("../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface> & import("../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeButtonMixin.js").NativeButtonInterface>;
+declare const ListItem_base: import("../__internal/mixins/mixin.js").MixinReturn<import("../__internal/mixins/mixin.js").MixinReturn<import("../__internal/mixins/mixin.js").MixinReturn<import("../__internal/mixins/mixin.js").MixinReturn<typeof LitElement, import("@/__internal/mixins/element-internals.js").WithElementInternals>>, import("@/__internal/mixins/hyperlink.js").Hyperlink>, import("@/button/base-button/base-button.js").BaseButton>;
 /**
  * @label List Item
  * @tag wc-list-item
  * @rawTag list-item
  *
- * @summary A Material 3 list item with leading, trailing and content slots.
+ * @summary A list item with leading, trailing and content slots.
  *
  * @example
  * ```html
@@ -18,17 +18,21 @@ declare const ListItem_base: typeof LitElement & import("../__mixins/MixinConstr
  * @tags display
  */
 export declare class ListItem extends ListItem_base {
+    /** @nocollapse */ static shadowRootOptions: ShadowRootInit;
     static styles: import("lit").CSSResultGroup[];
     selected: boolean;
+    /** When true, renders the list-item in a loading skeleton state. */
+    skeleton: boolean;
+    actionable: boolean;
     readonly itemElement: HTMLElement | null;
-    isPressed: boolean;
+    constructor();
     connectedCallback(): void;
     focus(): void;
     blur(): void;
     __dispatchClick: (event: MouseEvent | KeyboardEvent) => void;
-    __handleKeyDown: (event: KeyboardEvent) => void;
-    __handlePress: (event: KeyboardEvent | MouseEvent) => void;
+    private __hasNamedSlot;
+    isClickable(): boolean;
     render(): import("lit-html").TemplateResult<1>;
-    renderContent(): import("lit-html").TemplateResult<1>;
+    renderContent(clickable: boolean): import("lit-html").TemplateResult<1>;
 }
 export {};

package/dist/src/list/list.d.ts

@@ -5,7 +5,7 @@ import { ListItem } from './list-item.js';
  * @tag wc-list
  * @rawTag list
  *
- * @summary A Material 3 list container for one or more list items.
+ * @summary A list container for one or more list items.
  *
  * @example
  * ```html
@@ -15,6 +15,13 @@ import { ListItem } from './list-item.js';
  *     Inbox
  *     <span slot="trailing">24</span>
  *   </wc-list-item>
+ *    <wc-list-item>
+ *       <wc-avatar slot="leading" name="Shivaji Varma"></wc-avatar>
+ *        Shivaji Varma
+ *       <span slot="supporting-text">Software Engineer</span>
+ *       <span slot="trailing-supporting-text">7</span>
+ *       <wc-icon slot="trailing" name="chevron_right"></wc-icon>
+ *     </wc-list-item>
  * </wc-list>
  * ```
  * @tags display
@@ -22,7 +29,25 @@ import { ListItem } from './list-item.js';
 export declare class List extends LitElement {
     static styles: import("lit").CSSResultGroup[];
     static Item: typeof ListItem;
-    variant: 'standard' | 'vibrant';
+    /**  */
+    variant: 'standard' | 'segmented';
+    /** Index of the currently active item within the clickable items list. */
+    private activeIndex;
     connectedCallback(): void;
+    disconnectedCallback(): void;
+    focus(): void;
+    get items(): ListItem[];
+    private _clickableItems;
+    private _syncRovingTabIndex;
+    private _setActiveByOffset;
+    private _setBoundaryActive;
+    private _getActiveItem;
+    private _getFirstClickableItem;
+    private _isEventFromThisList;
+    private _clickableItemFromEvent;
+    private _setActiveItem;
+    private _onKeyDown;
+    private _onClick;
+    private _onSlotChange;
     render(): import("lit-html").TemplateResult<1>;
 }

package/dist/src/menu/menu/menu.d.ts

@@ -31,20 +31,34 @@ type CloseReason = {
 export declare class Menu extends LitElement {
     static styles: import("lit").CSSResultGroup[];
     static Item: typeof MenuItem;
+    /** Whether the menu is currently visible. */
     open: boolean;
+    /** Visual variant of the menu. `"vibrant"` applies stronger color emphasis. */
     variant: 'standard' | 'vibrant';
+    /** ID of the anchor element the menu is positioned relative to. */
     anchor: string;
+    /** When true, renders the menu in a static preview state (always visible, no animation). */
     preview: boolean;
+    /** When true, the menu will not close when a click occurs outside it. */
     stayOpenOnOutsideClick: boolean;
+    /** When true, the menu will not close when focus leaves it. */
     stayOpenOnFocusout: boolean;
+    /** Set to true when this menu is being used as a submenu inside another menu. */
     isSubmenu: boolean;
+    /** Floating UI placement of the menu relative to its anchor. */
     placement: Placement;
+    /** Distance in pixels between the menu and its anchor element. */
     offset: number;
+    /** Index of the currently focused/active item within the enabled items list. */
     private activeIndex;
     private readonly menuListElement;
+    /** Direct reference to the anchor element; takes precedence over the `anchor` ID property. */
     anchorElement: HTMLElement | null;
+    /** Controller managing floating-UI positioning. */
     private readonly _floatingController;
+    /** Element that had focus before the menu opened; restored on close. */
     private _lastFocusedElement;
+    /** Reason that triggered the most recent close, included in the `closed` event detail. */
     private _closeReason;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/src/menu/menu-item/menu-item.d.ts

@@ -1,6 +1,5 @@
 import { LitElement } from 'lit';
-import { Item } from '@/item/item.js';
-declare const MenuItem_base: typeof LitElement & import("../../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface> & import("../../__mixins/MixinConstructor.js").MixinConstructor<import("@/__mixins/NativeButtonMixin.js").NativeButtonInterface>;
+declare const MenuItem_base: typeof LitElement & import("../../__internal/mixins/MixinConstructor.js").MixinConstructor<import("@/__internal/mixins/NativeHyperlinkMixin.js").NativeHyperlinkInterface> & import("../../__internal/mixins/MixinConstructor.js").MixinConstructor<import("@/__internal/mixins/NativeButtonMixin.js").NativeButtonInterface>;
 /**
  * @label Menu Item
  * @tag wc-menu-item
@@ -14,15 +13,23 @@ declare const MenuItem_base: typeof LitElement & import("../../__mixins/MixinCon
  * ```
  */
 export declare class MenuItem extends MenuItem_base {
+    static styles: import("lit").CSSResultGroup[];
+    /** The value associated with this menu item, used to identify it on selection. */
     value: string;
+    /** Whether this menu item is currently selected/highlighted. */
     selected: boolean;
+    /** When true, the menu stays open after this item is activated. */
     keepOpen: boolean;
+    /** When true, indicates this item has an associated submenu. */
     hasSubmenu: boolean;
+    /** Whether the associated submenu is currently open. */
     submenuOpen: boolean;
+    /** Visual variant of the menu item. */
     variant: 'standard' | 'vibrant';
-    static styles: import("lit").CSSResultGroup[];
-    readonly itemElement: Item | null;
+    readonly itemElement: HTMLElement | null;
+    /** MutationObserver that triggers re-render when slotted content changes. */
     private readonly _contentObserver;
+    /** Roving tabindex value managed by the parent Menu. */
     private _rovingTabIndex;
     connectedCallback(): void;
     disconnectedCallback(): void;

package/dist/src/modal/modal.d.ts

@@ -4,7 +4,7 @@ type ModalSize = 'xs' | 'sm' | 'md' | 'lg' | 'fullscreen';
  * @label Modal
  * @tag wc-modal
  * @rawTag modal
- * @summary A Material Design 3 dialog/modal for displaying content in a layer above the page, with optional header, body, and footer slots.
+ * @summary A dialog/modal for displaying content in a layer above the page, with optional header, body, and footer slots.
  *
  * @cssprop --modal-container-color - Background color of the dialog container.
  * @cssprop --modal-scrim-color - Color of the scrim backdrop.

package/dist/src/navigation-rail/navigation-rail-item.d.ts

@@ -34,18 +34,19 @@ export declare class NavigationRailItem extends LitElement {
     value?: string;
     /** Reason the item is disabled (shown to screen readers). */
     disabledReason: string;
-    /** Sets the delay for throttle in milliseconds. Defaults to 200 milliseconds. */
-    throttleDelay: number;
-    private _isPressed;
+    /** Sets the delay for throttle in milliseconds. When null (default), no throttle is applied. */
+    throttleDelay: number | null;
+    /** True when the default slot contains label content. */
     private _hasLabel;
+    /** True when the `active-icon` slot contains content. */
     private _hasActiveIcon;
     readonly itemElement: HTMLElement | null;
+    constructor();
     focus(): void;
     blur(): void;
     firstUpdated(): void;
     __dispatchClickWithThrottle: (event: MouseEvent | KeyboardEvent) => void;
     __dispatchClick: (event: MouseEvent | KeyboardEvent) => void;
-    __handlePress: (event: KeyboardEvent | MouseEvent) => void;
     __getDisabledReasonID(): string | typeof nothing;
     __renderDisabledReason(): typeof nothing | import("lit-html").TemplateResult<1>;
     __renderItemContent(): import("lit-html").TemplateResult<1>;

package/dist/src/navigation-rail/navigation-rail.d.ts

@@ -5,7 +5,7 @@ import { NavigationRailItem } from './navigation-rail-item.js';
  * @tag wc-navigation-rail
  * @rawTag navigation-rail
  *
- * @summary A vertical side navigation for medium-sized screens, following Material Design 3 specs.
+ * @summary A vertical side navigation for medium-sized screens,.
  * @overview
  * <p>Navigation rail provides access to primary destinations in an app using icons—with or without labels—on a vertical rail.</p>
  * <p>Use navigation rail on medium-sized screens (tablets) with 3–7 destinations.</p>

package/dist/src/radio/radio.d.ts

@@ -35,12 +35,17 @@ export declare class Radio extends LitElement {
      * Configuration object for aria attributes.
      */
     configAria: Record<string, string>;
+    /** True while the radio container has keyboard focus. */
     private hasFocus;
+    /** True while the user is actively pressing the radio (mouse/keyboard). */
     private isActive;
+    /** True when slotted label content or `label` property is present. */
     private slotHasContent;
+    /** True for the one radio in the group that should receive tab focus (roving tabindex). */
     private isGroupFocusTarget;
     private containerElement?;
     private nativeElement?;
+    /** Captured `tabindex` attribute value forwarded to the inner container. */
     private tabindex?;
     connectedCallback(): void;
     disconnectedCallback(): void;