@nysds/nys-radiobutton 1.19.1 → 1.19.2

package/dist/nys-radiobutton.d.ts

@@ -0,0 +1,61 @@
+import { LitElement } from "lit";
+/**
+ * A radio button for single selection within a `nys-radiogroup`. Only one radio with the same `name` can be selected.
+ *
+ * Use within `nys-radiogroup` for 2-6 mutually exclusive options. For 7+ options, use `nys-select`.
+ * For multiple selections, use `nys-checkbox`.
+ *
+ * @summary Radio button for single selection from mutually exclusive options. This is a READONLY data component.
+ * @element nys-radiobutton
+ *
+ * @slot description - Custom HTML description content.
+ *
+ * @fires nys-change - Fired when selection changes. Detail: `{id, checked, name, value}`.
+ * @fires nys-focus - Fired when radio gains focus.
+ * @fires nys-blur - Fired when radio loses focus.
+ * @fires nys-other-input - Fired when "other" text input value changes. Detail: `{id, name, value}`.
+ *
+ * @example Radio group
+ * ```html
+ * <nys-radiogroup label="Select borough" required>
+ *   <nys-radiobutton name="borough" value="bronx" label="The Bronx"></nys-radiobutton>
+ *   <nys-radiobutton name="borough" value="brooklyn" label="Brooklyn"></nys-radiobutton>
+ * </nys-radiogroup>
+ * ```
+ */
+export declare class NysRadiobutton extends LitElement {
+    static styles: import("lit").CSSResult;
+    /** Whether this radio is selected. Only one per group can be checked. */
+    checked: boolean;
+    /** Prevents interaction. */
+    disabled: boolean;
+    /** Marks group as required. Set on radiogroup, not individual radios. */
+    required: boolean;
+    /** Visible label text. Required for accessibility. */
+    label: string;
+    /** Helper text below label. Use slot for custom HTML. */
+    description: string;
+    /** Unique identifier. Auto-generated if not provided. */
+    id: string;
+    /** Group name. Radios with same name are mutually exclusive. */
+    name: string;
+    /** Value submitted when this radio is selected. */
+    value: string;
+    /** Form `id` to associate with. */
+    form: string | null;
+    /**
+     * Radio size: `sm` (24px) or `md` (32px, default).
+     * @default "md"
+     */
+    size: "sm" | "md";
+    /** Renders as tile with larger clickable area. */
+    tile: boolean;
+    other: boolean;
+    showOtherError: boolean;
+    /**
+     * Lifecycle methods
+     * --------------------------------------------------------------------------
+     */
+    connectedCallback(): void;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/nys-radiobutton.js

@@ -6,7 +6,7 @@ import { ifDefined as v } from "lit/directives/if-defined.js";
    * █ █ █  █▄▄▄█  ▀▀▀▄▄  █   █ ▀▀▀▄▄
    * █  ▀█    █    █▄▄▄█  █▄▄▀  █▄▄▄█
    *
-   * Radiobutton Component v1.19.1
+   * Radiobutton Component v1.19.2
    * Part of the New York State Design System
    * Repository: https://github.com/its-hcd/nysds
    * License: MIT

package/dist/nys-radiogroup.d.ts

@@ -0,0 +1,117 @@
+import { LitElement } from "lit";
+/**
+ * A container for grouping `nys-radiobutton` elements as a single form control with enforced single selection.
+ * Handles keyboard navigation (arrow keys), validation, required constraints, and form integration.
+ *
+ * Use to let users select exactly one option from 2-6 choices. Apply `tile` and `size` to the group
+ * and all children inherit these styles automatically. For 7+ options, use `nys-select`.
+ *
+ * @summary Container for grouping radio buttons as a single form control.
+ * @element nys-radiogroup
+ *
+ * @slot - Default slot for `nys-radiobutton` elements.
+ * @slot description - Custom HTML description content.
+ *
+ * @example Basic radio group
+ * ```html
+ * <nys-radiogroup label="Select borough" required>
+ *   <nys-radiobutton name="borough" value="bronx" label="The Bronx"></nys-radiobutton>
+ *   <nys-radiobutton name="borough" value="brooklyn" label="Brooklyn"></nys-radiobutton>
+ *   <nys-radiobutton name="borough" value="manhattan" label="Manhattan"></nys-radiobutton>
+ * </nys-radiogroup>
+ * ```
+ */
+export declare class NysRadiogroup extends LitElement {
+    static styles: import("lit").CSSResult;
+    static shadowRootOptions: {
+        delegatesFocus: boolean;
+        clonable?: boolean;
+        customElementRegistry?: CustomElementRegistry;
+        mode: ShadowRootMode;
+        serializable?: boolean;
+        slotAssignment?: SlotAssignmentMode;
+    };
+    /** Unique identifier. Auto-generated if not provided. */
+    id: string;
+    /** Name for form submission. Auto-populated from child radiobuttons. */
+    name: string;
+    /** Requires a selection before form submission. */
+    required: boolean;
+    /** Shows "Optional" flag. */
+    optional: boolean;
+    /** Shows error message when true. */
+    showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
+    errorMessage: string;
+    /** Visible label text for the group. */
+    label: string;
+    /** Helper text below label. Use slot for custom HTML. */
+    description: string;
+    /** Renders all radiobuttons as tiles with larger clickable area. */
+    tile: boolean;
+    /** Tooltip text shown on hover/focus of info icon. */
+    tooltip: string;
+    /** Form `id` to associate with. Applied to all children. */
+    form: string | null;
+    /**
+     * Radio size for all children: `sm` (24px) or `md` (32px, default).
+     * @default "md"
+     */
+    size: "sm" | "md";
+    _showOtherError: boolean;
+    private selectedValue;
+    private _slottedDescriptionText;
+    private _radios;
+    private _mobileQuery;
+    private isMobile;
+    private _hasUserInteracted;
+    private _childObserver?;
+    private _internals;
+    /**
+     * Lifecycle methods
+     * --------------------------------------------------------------------------
+     */
+    static formAssociated: boolean;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): Promise<void>;
+    updated(changedProperties: Map<string | symbol, unknown>): void;
+    /**
+     * Form Integration
+     * --------------------------------------------------------------------------
+     */
+    private _setValue;
+    private _setRadioButtonRequire;
+    private _manageRequire;
+    checkValidity(): boolean;
+    private _initializeCheckedRadioValue;
+    private _getAllRadios;
+    private _handleKeyDown;
+    private _updateGroupTabIndex;
+    formResetCallback(): void;
+    /**
+     * Functions
+     * --------------------------------------------------------------------------
+     */
+    private _handleMobileQuery;
+    private _handleSlotChange;
+    private _initializeChildAttributes;
+    private _updateRadioButtonsSize;
+    private _selectRadio;
+    private _getSlotDescriptionForAria;
+    /**
+     * Event Handlers
+     * --------------------------------------------------------------------------
+     */
+    private _handleInvalid;
+    private _handleTextInput;
+    private _handleTextInputBlur;
+    private _validateOtherAndEmitError;
+    private _handleOtherKeydown;
+    private _handleGroupFocusout;
+    private _handleRadiobtnClick;
+    private _handleRadiobtnFocus;
+    private _handleRadiobtnBlur;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nysds/nys-radiobutton",
-  "version": "1.19.1",
+  "version": "1.19.2",
   "description": "The Radiobutton component from the NYS Design System.",
   "module": "dist/nys-radiobutton.js",
   "types": "dist/index.d.ts",
@@ -23,8 +23,8 @@
     "lit-analyze": "lit-analyzer '**/*.ts'"
   },
   "dependencies": {
-    "@nysds/nys-label": "^1.19.1",
-    "@nysds/nys-errormessage": "^1.19.1"
+    "@nysds/nys-label": "^1.19.2",
+    "@nysds/nys-errormessage": "^1.19.2"
   },
   "devDependencies": {
     "lit": "^3.3.1",
@@ -41,5 +41,6 @@
     "forms"
   ],
   "author": "New York State Design System Team",
-  "license": "MIT"
+  "license": "MIT",
+  "sideEffects": true
 }