@warp-ds/elements 2.9.1-next.6 → 2.9.2-next.1

package/dist/index.d.ts

@@ -20,8 +20,11 @@ import type { ModalHeader } from "./packages/modal-header/modal-header.ts";
 import type { WarpPageIndicator } from "./packages/page-indicator/page-indicator.ts";
 import type { WarpPagination } from "./packages/pagination/pagination.ts";
 import type { WarpPill } from "./packages/pill/pill.ts";
-import type { WRadio } from "./packages/radio/radio.ts";
-import type { WRadioGroup } from "./packages/radio-group/radio-group.ts";
+import type { WarpRadio, WRadio } from "./packages/radio/radio.ts";
+import type {
+  WarpRadioGroup,
+  WRadioGroup,
+} from "./packages/radio-group/radio-group.ts";
 import type { WarpSelect } from "./packages/select/select.ts";
 import type { WarpSliderThumb } from "./packages/slider-thumb/slider-thumb.ts";
 import type { WarpSlider } from "./packages/slider/slider.ts";
@@ -1316,46 +1319,34 @@ export type WarpPillSolidJsProps = {
   textContent?: string | number;
 };
 
-export type WRadioProps = {
+export type WarpRadioProps = {
   /** The name of the radio, submitted as a name/value pair with form data. */
-  name?: WRadio["name"];
+  name?: WarpRadio["name"];
   /** The radio's value. When selected, the radio group will receive this value. */
-  value?: WRadio["value"];
+  value?: WarpRadio["value"];
   /** Draws the radio in a checked state (reflected to attribute). */
-  checked?: WRadio["checked"];
+  checked?: WarpRadio["checked"];
   /** Disables the radio. */
-  disabled?: WRadio["disabled"];
+  disabled?: WarpRadio["disabled"];
   /** Makes the radio a required field. */
-  required?: WRadio["required"];
+  required?: WarpRadio["required"];
   /** Draws the radio in an invalid state. */
-  invalid?: WRadio["invalid"];
-  /** Override tabIndex setter to set _groupTabIndex (for backwards compatibility).
-Radio-group should use _groupTabIndex directly for clarity. */
-  tabIndex?: WRadio["tabIndex"];
-  /** Internal tabindex for standalone radios (not in a group).
-Non-reflecting to avoid DOM changes during hydration. */
-  _standaloneTabIndex?: WRadio["_standaloneTabIndex"];
+  invalid?: WarpRadio["invalid"];
 };
 
-export type WRadioSolidJsProps = {
+export type WarpRadioSolidJsProps = {
   /** The name of the radio, submitted as a name/value pair with form data. */
-  "prop:name"?: WRadio["name"];
+  "prop:name"?: WarpRadio["name"];
   /** The radio's value. When selected, the radio group will receive this value. */
-  "prop:value"?: WRadio["value"];
+  "prop:value"?: WarpRadio["value"];
   /** Draws the radio in a checked state (reflected to attribute). */
-  "prop:checked"?: WRadio["checked"];
+  "prop:checked"?: WarpRadio["checked"];
   /** Disables the radio. */
-  "prop:disabled"?: WRadio["disabled"];
+  "prop:disabled"?: WarpRadio["disabled"];
   /** Makes the radio a required field. */
-  "prop:required"?: WRadio["required"];
+  "prop:required"?: WarpRadio["required"];
   /** Draws the radio in an invalid state. */
-  "prop:invalid"?: WRadio["invalid"];
-  /** Override tabIndex setter to set _groupTabIndex (for backwards compatibility).
-Radio-group should use _groupTabIndex directly for clarity. */
-  "prop:tabIndex"?: WRadio["tabIndex"];
-  /** Internal tabindex for standalone radios (not in a group).
-Non-reflecting to avoid DOM changes during hydration. */
-  "prop:_standaloneTabIndex"?: WRadio["_standaloneTabIndex"];
+  "prop:invalid"?: WarpRadio["invalid"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -1363,46 +1354,50 @@ Non-reflecting to avoid DOM changes during hydration. */
   textContent?: string | number;
 };
 
-export type WRadioGroupProps = {
-  /**  */
-  label?: WRadioGroup["label"];
-  /**  */
-  "help-text"?: WRadioGroup["helpText"];
-  /**  */
-  helpText?: WRadioGroup["helpText"];
-  /**  */
-  optional?: WRadioGroup["optional"];
-  /**  */
-  invalid?: WRadioGroup["invalid"];
-  /**  */
-  name?: WRadioGroup["name"];
-  /**  */
-  disabled?: WRadioGroup["disabled"];
-  /**  */
-  required?: WRadioGroup["required"];
-  /**  */
-  hasInteracted?: WRadioGroup["hasInteracted"];
-};
+export type WarpRadioGroupProps = {
+  /** Label for the radio group. */
+  label?: WarpRadioGroup["label"];
+  /** Help text for the radio group.
 
-export type WRadioGroupSolidJsProps = {
-  /**  */
-  "prop:label"?: WRadioGroup["label"];
-  /**  */
-  "attr:help-text"?: WRadioGroup["helpText"];
-  /**  */
-  "prop:helpText"?: WRadioGroup["helpText"];
-  /**  */
-  "prop:optional"?: WRadioGroup["optional"];
-  /**  */
-  "prop:invalid"?: WRadioGroup["invalid"];
-  /**  */
-  "prop:name"?: WRadioGroup["name"];
-  /**  */
-  "prop:disabled"?: WRadioGroup["disabled"];
-  /**  */
-  "prop:required"?: WRadioGroup["required"];
-  /**  */
-  "prop:hasInteracted"?: WRadioGroup["hasInteracted"];
+If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute. */
+  "help-text"?: WarpRadioGroup["helpText"];
+  /** Help text for the radio group.
+
+If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute. */
+  helpText?: WarpRadioGroup["helpText"];
+  /** Whether to show optional text next to the label. */
+  optional?: WarpRadioGroup["optional"];
+  /** Marks the radio group as invalid. */
+  invalid?: WarpRadioGroup["invalid"];
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form. */
+  name?: WarpRadioGroup["name"];
+  /** Disables the radio group and all child radios. */
+  disabled?: WarpRadioGroup["disabled"];
+  /** Makes selecting a radio in the the group required. */
+  required?: WarpRadioGroup["required"];
+};
+
+export type WarpRadioGroupSolidJsProps = {
+  /** Label for the radio group. */
+  "prop:label"?: WarpRadioGroup["label"];
+  /** Help text for the radio group.
+
+If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute. */
+  "attr:help-text"?: WarpRadioGroup["helpText"];
+  /** Help text for the radio group.
+
+If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute. */
+  "prop:helpText"?: WarpRadioGroup["helpText"];
+  /** Whether to show optional text next to the label. */
+  "prop:optional"?: WarpRadioGroup["optional"];
+  /** Marks the radio group as invalid. */
+  "prop:invalid"?: WarpRadioGroup["invalid"];
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form. */
+  "prop:name"?: WarpRadioGroup["name"];
+  /** Disables the radio group and all child radios. */
+  "prop:disabled"?: WarpRadioGroup["disabled"];
+  /** Makes selecting a radio in the the group required. */
+  "prop:required"?: WarpRadioGroup["required"];
 
   /** Set the innerHTML of the element */
   innerHTML?: string;
@@ -1417,19 +1412,25 @@ export type WarpSelectProps = {
   autoFocus?: WarpSelect["autoFocus"];
   /** Whether the element should receive focus on render */
   autofocus?: WarpSelect["autofocus"];
-  /** The content displayed as the help text. Paired with `invalid` to show the text as a validation error. */
+  /** The content displayed as the help text.
+
+Paired with `invalid` to show the text as a validation error. */
   "help-text"?: WarpSelect["helpText"];
-  /** The content displayed as the help text. Paired with `invalid` to show the text as a validation error. */
+  /** The content displayed as the help text.
+
+Paired with `invalid` to show the text as a validation error. */
   helpText?: WarpSelect["helpText"];
-  /** Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error. */
+  /** Renders the field in an invalid state.
+
+Paired with `help-text` to provide feedback about the error. */
   invalid?: WarpSelect["invalid"];
   /** @deprecated Use `help-text` instead and only set it if you want to display the help text. - Whether to always show a hint. */
   always?: WarpSelect["always"];
   /** @deprecated Use `help-text` instead. - The content displayed as the help text. */
   hint?: WarpSelect["hint"];
-  /** The content to disply as the label */
+  /** The content to display as the label. */
   label?: WarpSelect["label"];
-  /** Whether to show optional text */
+  /** Whether to show the optional indicator after the label. */
   optional?: WarpSelect["optional"];
   /** Renders the field in a disabled state. */
   disabled?: WarpSelect["disabled"];
@@ -1439,9 +1440,9 @@ export type WarpSelectProps = {
   readOnly?: WarpSelect["readOnly"];
   /** Renders the field in a readonly state. */
   readonly?: WarpSelect["readonly"];
-  /**  */
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form. */
   name?: WarpSelect["name"];
-  /**  */
+  /** Lets you set the current value. */
   value?: WarpSelect["value"];
 
   /**  */
@@ -1455,19 +1456,25 @@ export type WarpSelectSolidJsProps = {
   "prop:autoFocus"?: WarpSelect["autoFocus"];
   /** Whether the element should receive focus on render */
   "prop:autofocus"?: WarpSelect["autofocus"];
-  /** The content displayed as the help text. Paired with `invalid` to show the text as a validation error. */
+  /** The content displayed as the help text.
+
+Paired with `invalid` to show the text as a validation error. */
   "attr:help-text"?: WarpSelect["helpText"];
-  /** The content displayed as the help text. Paired with `invalid` to show the text as a validation error. */
+  /** The content displayed as the help text.
+
+Paired with `invalid` to show the text as a validation error. */
   "prop:helpText"?: WarpSelect["helpText"];
-  /** Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error. */
+  /** Renders the field in an invalid state.
+
+Paired with `help-text` to provide feedback about the error. */
   "prop:invalid"?: WarpSelect["invalid"];
   /** @deprecated Use `help-text` instead and only set it if you want to display the help text. - Whether to always show a hint. */
   "prop:always"?: WarpSelect["always"];
   /** @deprecated Use `help-text` instead. - The content displayed as the help text. */
   "prop:hint"?: WarpSelect["hint"];
-  /** The content to disply as the label */
+  /** The content to display as the label. */
   "prop:label"?: WarpSelect["label"];
-  /** Whether to show optional text */
+  /** Whether to show the optional indicator after the label. */
   "prop:optional"?: WarpSelect["optional"];
   /** Renders the field in a disabled state. */
   "prop:disabled"?: WarpSelect["disabled"];
@@ -1477,9 +1484,9 @@ export type WarpSelectSolidJsProps = {
   "prop:readOnly"?: WarpSelect["readOnly"];
   /** Renders the field in a readonly state. */
   "prop:readonly"?: WarpSelect["readonly"];
-  /**  */
+  /** The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form. */
   "prop:name"?: WarpSelect["name"];
-  /**  */
+  /** Lets you set the current value. */
   "prop:value"?: WarpSelect["value"];
   /**  */
   "on:change"?: (e: CustomEvent) => void;
@@ -2531,39 +2538,27 @@ export type CustomElements = {
    * - `disabled`: Disables the radio.
    * - `required`: Makes the radio a required field.
    * - `invalid`: Draws the radio in an invalid state.
-   * - `tabIndex`: Override tabIndex setter to set _groupTabIndex (for backwards compatibility).
-   * Radio-group should use _groupTabIndex directly for clarity. (property only)
-   * - `validationMessage`: Returns the validation message if the radio is invalid, otherwise an empty string (property only) (readonly)
-   * - `validity`: Returns the validity state of the radio (property only) (readonly)
-   * - `_standaloneTabIndex`: Internal tabindex for standalone radios (not in a group).
-   * Non-reflecting to avoid DOM changes during hydration. (property only)
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `checkValidity() => boolean`: Checks whether the radio passes constraint validation
-   * - `reportValidity() => boolean`: Checks validity and shows the browser's validation message if invalid
    */
-  "w-radio": Partial<WRadioProps & BaseProps<WRadio> & BaseEvents>;
+  "w-radio": Partial<WarpRadioProps & BaseProps<WarpRadio> & BaseEvents>;
 
   /**
+   * Radios allow users to select a single option from a list of choices.
    *
+   * Use with `w-radio`.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `label`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `optional`: undefined
-   * - `invalid`: undefined
-   * - `name`: undefined
-   * - `disabled`: undefined
-   * - `required`: undefined
-   * - `hasInteracted`: undefined (property only)
-   * - `validationTarget`: undefined (property only) (readonly)
+   * - `label`: Label for the radio group.
+   * - `help-text`/`helpText`: Help text for the radio group.
+   *
+   * If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute.
+   * - `optional`: Whether to show optional text next to the label.
+   * - `invalid`: Marks the radio group as invalid.
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.
+   * - `disabled`: Disables the radio group and all child radios.
+   * - `required`: Makes selecting a radio in the the group required.
    *
    * ## Slots
    *
@@ -2571,57 +2566,41 @@ export type CustomElements = {
    *
    * - `label`: Alternative to the `label` attribute should you need custom HTML.
    * - `help-text`: Alternative to the `help-text` attribute should you need custom HTML.
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `focus(options?: FocusOptions) => void`: undefined
-   * - `checkValidity() => void`: undefined
-   * - `reportValidity() => void`: undefined
    */
   "w-radio-group": Partial<
-    WRadioGroupProps & BaseProps<WRadioGroup> & BaseEvents
+    WarpRadioGroupProps & BaseProps<WarpRadioGroup> & BaseEvents
   >;
 
   /**
    * A dropdown component for selecting a single value.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-select--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `auto-focus`/`autoFocus`: Whether the element should receive focus on render.
    * - `autofocus`: Whether the element should receive focus on render
-   * - `help-text`/`helpText`: The content displayed as the help text. Paired with `invalid` to show the text as a validation error.
-   * - `invalid`: Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.
+   * - `help-text`/`helpText`: The content displayed as the help text.
+   *
+   * Paired with `invalid` to show the text as a validation error.
+   * - `invalid`: Renders the field in an invalid state.
+   *
+   * Paired with `help-text` to provide feedback about the error.
    * - `always`: Whether to always show a hint.
    * - `hint`: The content displayed as the help text.
-   * - `label`: The content to disply as the label
-   * - `optional`: Whether to show optional text
+   * - `label`: The content to display as the label.
+   * - `optional`: Whether to show the optional indicator after the label.
    * - `disabled`: Renders the field in a disabled state.
    * - `read-only`/`readOnly`: Renders the field in a readonly state.
    * - `readonly`: Renders the field in a readonly state.
-   * - `name`: undefined
-   * - `value`: undefined
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.
+   * - `value`: Lets you set the current value.
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
    * - `change`: undefined
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `formStateRestoreCallback(state: string | File | FormData | null, _reason: 'autocomplete' | 'restore') => void`: undefined
-   * - `handleKeyDown(event: KeyboardEvent) => void`: undefined
-   * - `onChange(event: Event) => void`: undefined
    */
   "w-select": Partial<WarpSelectProps & BaseProps<WarpSelect> & BaseEvents>;
 
@@ -3578,41 +3557,29 @@ export type CustomElementsSolidJs = {
    * - `disabled`: Disables the radio.
    * - `required`: Makes the radio a required field.
    * - `invalid`: Draws the radio in an invalid state.
-   * - `tabIndex`: Override tabIndex setter to set _groupTabIndex (for backwards compatibility).
-   * Radio-group should use _groupTabIndex directly for clarity. (property only)
-   * - `validationMessage`: Returns the validation message if the radio is invalid, otherwise an empty string (property only) (readonly)
-   * - `validity`: Returns the validity state of the radio (property only) (readonly)
-   * - `_standaloneTabIndex`: Internal tabindex for standalone radios (not in a group).
-   * Non-reflecting to avoid DOM changes during hydration. (property only)
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `checkValidity() => boolean`: Checks whether the radio passes constraint validation
-   * - `reportValidity() => boolean`: Checks validity and shows the browser's validation message if invalid
    */
   "w-radio": Partial<
-    WRadioProps & WRadioSolidJsProps & BaseProps<WRadio> & BaseEvents
+    WarpRadioProps & WarpRadioSolidJsProps & BaseProps<WarpRadio> & BaseEvents
   >;
 
   /**
+   * Radios allow users to select a single option from a list of choices.
    *
+   * Use with `w-radio`.
    *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
-   * - `label`: undefined
-   * - `help-text`/`helpText`: undefined
-   * - `optional`: undefined
-   * - `invalid`: undefined
-   * - `name`: undefined
-   * - `disabled`: undefined
-   * - `required`: undefined
-   * - `hasInteracted`: undefined (property only)
-   * - `validationTarget`: undefined (property only) (readonly)
+   * - `label`: Label for the radio group.
+   * - `help-text`/`helpText`: Help text for the radio group.
+   *
+   * If you set `required` and `invalid` the group gets a default error message, but you can override it with this attribute.
+   * - `optional`: Whether to show optional text next to the label.
+   * - `invalid`: Marks the radio group as invalid.
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.
+   * - `disabled`: Disables the radio group and all child radios.
+   * - `required`: Makes selecting a radio in the the group required.
    *
    * ## Slots
    *
@@ -3620,60 +3587,44 @@ export type CustomElementsSolidJs = {
    *
    * - `label`: Alternative to the `label` attribute should you need custom HTML.
    * - `help-text`: Alternative to the `help-text` attribute should you need custom HTML.
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `focus(options?: FocusOptions) => void`: undefined
-   * - `checkValidity() => void`: undefined
-   * - `reportValidity() => void`: undefined
    */
   "w-radio-group": Partial<
-    WRadioGroupProps &
-      WRadioGroupSolidJsProps &
-      BaseProps<WRadioGroup> &
+    WarpRadioGroupProps &
+      WarpRadioGroupSolidJsProps &
+      BaseProps<WarpRadioGroup> &
       BaseEvents
   >;
 
   /**
    * A dropdown component for selecting a single value.
    *
-   * [See Storybook for usage examples](https://warp-ds.github.io/elements/?path=/docs/forms-select--docs)
-   *
    * ## Attributes & Properties
    *
    * Component attributes and properties that can be applied to the element or by using JavaScript.
    *
    * - `auto-focus`/`autoFocus`: Whether the element should receive focus on render.
    * - `autofocus`: Whether the element should receive focus on render
-   * - `help-text`/`helpText`: The content displayed as the help text. Paired with `invalid` to show the text as a validation error.
-   * - `invalid`: Renders the field in an invalid state. Paired with `help-text` to provide feedback about the error.
+   * - `help-text`/`helpText`: The content displayed as the help text.
+   *
+   * Paired with `invalid` to show the text as a validation error.
+   * - `invalid`: Renders the field in an invalid state.
+   *
+   * Paired with `help-text` to provide feedback about the error.
    * - `always`: Whether to always show a hint.
    * - `hint`: The content displayed as the help text.
-   * - `label`: The content to disply as the label
-   * - `optional`: Whether to show optional text
+   * - `label`: The content to display as the label.
+   * - `optional`: Whether to show the optional indicator after the label.
    * - `disabled`: Renders the field in a disabled state.
    * - `read-only`/`readOnly`: Renders the field in a readonly state.
    * - `readonly`: Renders the field in a readonly state.
-   * - `name`: undefined
-   * - `value`: undefined
+   * - `name`: The [name](https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/input#name) of the select when submitting the form.
+   * - `value`: Lets you set the current value.
    *
    * ## Events
    *
    * Events that will be emitted by the component.
    *
    * - `change`: undefined
-   *
-   * ## Methods
-   *
-   * Methods that can be called to access component functionality.
-   *
-   * - `resetFormControl() => void`: undefined
-   * - `formStateRestoreCallback(state: string | File | FormData | null, _reason: 'autocomplete' | 'restore') => void`: undefined
-   * - `handleKeyDown(event: KeyboardEvent) => void`: undefined
-   * - `onChange(event: Event) => void`: undefined
    */
   "w-select": Partial<
     WarpSelectProps &

package/dist/packages/radio/radio.d.ts

@@ -1,9 +1,13 @@
 import type { PropertyValues } from 'lit';
 import { LitElement } from 'lit';
-declare const WRadio_base: import("@open-wc/form-control").Constructor<import("@open-wc/form-control").FormControlInterface> & typeof LitElement;
-export declare class WRadio extends WRadio_base {
+declare const WarpRadio_base: import("@open-wc/form-control").Constructor<import("@open-wc/form-control").FormControlInterface> & typeof LitElement;
+/**
+ * @parent w-radio-group
+ */
+export declare class WarpRadio extends WarpRadio_base {
     #private;
     static styles: import("lit").CSSResult[];
+    /** @internal */
     static shadowRootOptions: {
         delegatesFocus: boolean;
         clonable?: boolean;
@@ -12,17 +16,29 @@ export declare class WRadio extends WRadio_base {
         serializable?: boolean;
         slotAssignment?: SlotAssignmentMode;
     };
-    /** The name of the radio, submitted as a name/value pair with form data. */
+    /**
+     * The name of the radio, submitted as a name/value pair with form data.
+     */
     name: string;
-    /** The radio's value. When selected, the radio group will receive this value. */
+    /**
+     * The radio's value. When selected, the radio group will receive this value.
+     */
     value: string | null;
-    /** Draws the radio in a checked state (reflected to attribute). */
+    /**
+     * Draws the radio in a checked state (reflected to attribute).
+     */
     checked: boolean;
-    /** Disables the radio. */
+    /**
+     * Disables the radio.
+     */
     disabled: boolean;
-    /** Makes the radio a required field. */
+    /**
+     * Makes the radio a required field.
+     */
     required: boolean;
-    /** Draws the radio in an invalid state. */
+    /**
+     * Draws the radio in an invalid state.
+     */
     invalid: boolean;
     /**
      * Internal tabindex managed by parent radio-group.
@@ -33,11 +49,14 @@ export declare class WRadio extends WRadio_base {
     /**
      * Override tabIndex getter to return the computed internal tabIndex.
      * This allows external code to check if the radio is focusable.
+     * @internal
      */
     get tabIndex(): number;
     /**
      * Override tabIndex setter to set _groupTabIndex (for backwards compatibility).
      * Radio-group should use _groupTabIndex directly for clarity.
+     *
+     * @internal
      */
     set tabIndex(value: number);
     constructor();
@@ -49,14 +68,27 @@ export declare class WRadio extends WRadio_base {
     private handleClick;
     private handleInvalid;
     private handleKeyDown;
+    /** @internal */
     resetFormControl(): void;
-    /** Returns the validation message if the radio is invalid, otherwise an empty string */
+    /**
+     * Returns the validation message if the radio is invalid, otherwise an empty string
+     * @internal
+     */
     get validationMessage(): string;
-    /** Returns the validity state of the radio */
+    /**
+     * Returns the validity state of the radio
+     * @internal
+     */
     get validity(): ValidityState;
-    /** Checks whether the radio passes constraint validation */
+    /**
+     * Checks whether the radio passes constraint validation
+     * @internal
+     */
     checkValidity(): boolean;
-    /** Checks validity and shows the browser's validation message if invalid */
+    /**
+     * Checks validity and shows the browser's validation message if invalid
+     * @internal
+     */
     reportValidity(): boolean;
     private isInGroup;
     private getRadioScope;
@@ -70,6 +102,8 @@ export declare class WRadio extends WRadio_base {
     /**
      * Internal tabindex for standalone radios (not in a group).
      * Non-reflecting to avoid DOM changes during hydration.
+     *
+     * @internal
      */
     _standaloneTabIndex: number | undefined;
     protected firstUpdated(): void;
@@ -79,9 +113,13 @@ export declare class WRadio extends WRadio_base {
     private shouldSyncFormState;
     render(): import("lit").TemplateResult<1>;
 }
+/**
+ * @deprecated Exported for backwards compatibility only, use `WarpRadio`
+ */
+export declare const WRadio: typeof WarpRadio;
 declare global {
     interface HTMLElementTagNameMap {
-        'w-radio': WRadio;
+        'w-radio': WarpRadio;
     }
 }
 export {};