@nysds/nys-textarea 1.19.0 → 1.19.2

package/dist/nys-textarea.d.ts

@@ -0,0 +1,123 @@
+import { LitElement } from "lit";
+/**
+ * A multi-line text input for collecting longer responses like comments, descriptions, or feedback.
+ * Form-associated with validation support via ElementInternals.
+ *
+ * Use for detailed responses needing multiple lines. For single-line input, use `nys-textinput`.
+ * For predefined options, use `nys-select`, `nys-radiobutton`, or `nys-checkbox`.
+ *
+ * @summary Multi-line text input for comments, descriptions, and feedback.
+ * @element nys-textarea
+ *
+ * @slot description - Custom HTML description content below the label.
+ *
+ * @fires nys-input - Fired on input change. Detail: `{id, value}`.
+ * @fires nys-focus - Fired when textarea gains focus.
+ * @fires nys-blur - Fired when textarea loses focus. Triggers validation.
+ * @fires nys-select - Fired when user selects text. Detail: `{id, value}`.
+ *
+ * @example Basic textarea
+ * ```html
+ * <nys-textarea label="Comments" rows="4"></nys-textarea>
+ * ```
+ *
+ * @example Required with description
+ * ```html
+ * <nys-textarea label="Describe the incident" description="Please provide details" required></nys-textarea>
+ * ```
+ */
+export declare class NysTextarea 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;
+    /** Placeholder text. Don't use as label replacement. */
+    placeholder: string;
+    /** Current textarea value. */
+    value: string;
+    /** Prevents interaction. */
+    disabled: boolean;
+    /** Makes textarea read-only but focusable. */
+    readonly: 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;
+    /** Adjusts colors for dark backgrounds. */
+    inverted: boolean;
+    /** Form `id` to associate with when textarea is outside form element. */
+    form: string | null;
+    /** Maximum character length. */
+    maxlength: number | null;
+    /**
+     * Textarea width: `sm` (88px), `md` (200px), `lg` (384px), `full` (100%, default).
+     * @default "full"
+     */
+    width: "sm" | "md" | "lg" | "full";
+    /**
+     * Visible height in lines.
+     * @default 4
+     */
+    rows: number;
+    /**
+     * Resize behavior: `vertical` (default, user can resize height), `none` (fixed size).
+     * @default "vertical"
+     */
+    resize: "vertical" | "none";
+    /** Shows error message when true. Set by validation or manually. */
+    showError: boolean;
+    /** Error message text. Shown only when `showError` is true. */
+    errorMessage: string;
+    private _hasUserInteracted;
+    private _internals;
+    /**
+     * Lifecycle methods
+     * --------------------------------------------------------------------------
+     */
+    static formAssociated: boolean;
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    firstUpdated(): void;
+    updated(changedProperties: Map<string | number | symbol, unknown>): Promise<void>;
+    /**
+     * Form Integration
+     * --------------------------------------------------------------------------
+     */
+    private _setValue;
+    private _manageRequire;
+    private _setValidityMessage;
+    private _validate;
+    formResetCallback(): void;
+    /**
+     * Functions
+     * --------------------------------------------------------------------------
+     */
+    checkValidity(): boolean;
+    private _handleInvalid;
+    /**
+     * Event Handlers
+     * --------------------------------------------------------------------------
+     */
+    private _handleInput;
+    private _handleFocus;
+    private _handleBlur;
+    private _handleSelect;
+    private _handleSelectionChange;
+    render(): import("lit-html").TemplateResult<1>;
+}

package/dist/nys-textarea.js

@@ -6,7 +6,7 @@ import { ifDefined as o } from "lit/directives/if-defined.js";
    * █ █ █  █▄▄▄█  ▀▀▀▄▄  █   █ ▀▀▀▄▄
    * █  ▀█    █    █▄▄▄█  █▄▄▀  █▄▄▄█
    *
-   * Textarea Component v1.19.0
+   * Textarea 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-textarea",
-  "version": "1.19.0",
+  "version": "1.19.2",
   "description": "The Textarea component from the NYS Design System.",
   "module": "dist/nys-textarea.js",
   "types": "dist/index.d.ts",
@@ -23,9 +23,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
 }