@nysds/nys-select 1.19.0 → 1.19.2

package/dist/nys-select.d.ts

@@ -0,0 +1,116 @@
+import { LitElement } from "lit";
+/**
+ * A dropdown for selecting a single option from a list. Supports native `<option>` and `<optgroup>` elements.
+ * Form-associated with validation via ElementInternals.
+ *
+ * Use when users must choose one option from 7+ items. For fewer options, consider `nys-radiobutton`.
+ * For multiple selections, use `nys-checkbox` group instead.
+ *
+ * @summary Dropdown select for choosing one option from a list.
+ * @element nys-select
+ *
+ * @slot - Default slot for `<option>` and `<optgroup>` elements.
+ * @slot description - Custom HTML description content below the label.
+ *
+ * @fires nys-change - Fired when selection changes. Detail: `{id, value}`.
+ * @fires nys-focus - Fired when select gains focus.
+ * @fires nys-blur - Fired when select loses focus. Triggers validation.
+ *
+ * @example Basic select
+ * ```html
+ * <nys-select label="Select borough">
+ *   <option value="bronx">The Bronx</option>
+ *   <option value="brooklyn">Brooklyn</option>
+ *   <option value="manhattan">Manhattan</option>
+ * </nys-select>
+ * ```
+ *
+ * @example With option groups
+ * ```html
+ * <nys-select label="Select service">
+ *   <optgroup label="Transportation">
+ *     <option value="mta">MTA</option>
+ *     <option value="dmv">DMV</option>
+ *   </optgroup>
+ * </nys-select>
+ * ```
+ */
+export declare class NysSelect 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. */
+    name: string;
+    /** Visible label text. Required for accessibility. */
+    label: string;
+    /** Helper text below label. Use slot for custom HTML. */
+    description: string;
+    /** Currently selected option value. */
+    value: string;
+    /** Prevents interaction. */
+    disabled: boolean;
+    /** Marks as required. Shows "Required" flag and validates on blur. */
+    required: boolean;
+    /** Shows "Optional" flag. Use when most fields are required. */
+    optional: boolean;
+    /** Tooltip text shown on hover/focus of info icon. */
+    tooltip: string;
+    /** Form `id` to associate with when select is outside form element. */
+    form: string | null;
+    /** Adjusts colors for dark backgrounds. */
+    inverted: boolean;
+    /** Shows error message when true. Set by validation or manually. */
+    showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
+    errorMessage: string;
+    /**
+     * Select width: `sm` (88px), `md` (200px), `lg` (384px), `full` (100%, default).
+     * @default "full"
+     */
+    width: "sm" | "md" | "lg" | "full";
+    private _originalErrorMessage;
+    private _hasUserInteracted;
+    private _internals;
+    /**
+     * Lifecycle methods
+     * --------------------------------------------------------------------------
+     */
+    static formAssociated: boolean;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    private _handleSlotChange;
+    /**
+     * Form Integration
+     * --------------------------------------------------------------------------
+     */
+    private _setValue;
+    private _manageRequire;
+    private _setValidityMessage;
+    private _validate;
+    formResetCallback(): void;
+    /**
+     * Functions
+     * --------------------------------------------------------------------------
+     */
+    checkValidity(): boolean;
+    private _handleInvalid;
+    /**
+     * Event Handlers
+     * --------------------------------------------------------------------------
+     */
+    private _handleChange;
+    private _handleFocus;
+    private _handleBlur;
+    updated(changedProperties: Map<string, unknown>): void;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/nys-select.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nysds/nys-select",
-  "version": "1.19.0",
+  "version": "1.19.2",
   "description": "The Select component from the NYS Design System.",
   "module": "dist/nys-select.js",
   "exports": {
@@ -22,9 +22,9 @@
     "lit-analyze": "lit-analyzer '**/*.ts'"
   },
   "dependencies": {
-    "@nysds/nys-icon": "^1.19.0",
-    "@nysds/nys-label": "^1.19.0",
-    "@nysds/nys-errormessage": "^1.19.0"
+    "@nysds/nys-icon": "^1.19.2",
+    "@nysds/nys-label": "^1.19.2",
+    "@nysds/nys-errormessage": "^1.19.2"
   },
   "devDependencies": {
     "lit": "^3.3.1",
@@ -42,5 +42,6 @@
     "forms"
   ],
   "author": "New York State Design System Team",
-  "license": "MIT"
+  "license": "MIT",
+  "sideEffects": true
 }