tyrell-components 1.0.0-RC13 → 1.0.0-RC15

package/lib/components/textarea.d.ts

@@ -1,48 +1,13 @@
 /**
- * ty-textarea - Enhanced textarea component with auto-resize functionality
- *
- * Features:
- * - Auto-resize based on content
- * - Form-associated custom element
- * - Min/max height constraints
- * - Size variants (xs, sm, md, lg, xl)
- * - Validation states (error, required)
- * - Manual resize control options
- * - Accessibility support
- *
- * @example
- * ```html
- * <!-- Basic usage -->
- * <ty-textarea label="Description" placeholder="Enter details..."></ty-textarea>
- *
- * <!-- With validation -->
- * <ty-textarea
- *   label="Bio"
- *   required
- *   error="Bio is required"
- *   size="lg">
- * </ty-textarea>
- *
- * <!-- With height constraints -->
- * <ty-textarea
- *   min-height="100px"
- *   max-height="300px"
- *   placeholder="Auto-resizing textarea">
- * </ty-textarea>
- *
- * <!-- Manual resize control -->
- * <ty-textarea resize="vertical"></ty-textarea>
- * ```
+ * ty-textarea — form-associated textarea that auto-resizes to its content,
+ * within optional min-height/max-height constraints.
  *
  * @fires {CustomEvent<{value: string, originalEvent: Event}>} input - Emitted on input
  * @fires {CustomEvent<{value: string, originalEvent: Event}>} change - Emitted on change
  */
 import { TyComponent } from '../base/ty-component.js';
 import type { PropertyChange } from '../utils/property-manager.js';
-/**
- * Component internal state (for typing TyComponent)
- * Actual state stored as private fields
- */
+/** For typing TyComponent only — actual state lives in private fields. */
 interface TextareaState {
     value: string;
     isFocused: boolean;
@@ -106,7 +71,7 @@ export declare class TyTextarea extends TyComponent<TextareaState> implements Ty
         size: {
             type: "string";
             visual: boolean;
-            default: string;
+            default: import("../types/common.js").Size;
             validate: (v: any) => boolean;
             coerce: (v: any) => any;
         };
@@ -145,23 +110,10 @@ export declare class TyTextarea extends TyComponent<TextareaState> implements Ty
     private _scrollbar;
     private _isFocused;
     constructor();
-    /**
-     * Called when component connects to DOM
-     * TyComponent already handled pre-connection property capture
-     */
     protected onConnect(): void;
-    /**
-     * Called when component disconnects from DOM
-     */
     protected onDisconnect(): void;
-    /**
-     * Handle property changes - called BEFORE render
-     * This replaces the old attributeChangedCallback logic
-     */
+    /** Called BEFORE render. Visual property changes re-render automatically. */
     protected onPropertiesChanged(changes: PropertyChange[]): void;
-    /**
-     * Override form value to return current value
-     */
     protected getFormValue(): FormDataEntryValue | null;
     get value(): string;
     set value(v: string);
@@ -189,51 +141,20 @@ export declare class TyTextarea extends TyComponent<TextareaState> implements Ty
     set minHeight(v: string);
     get maxHeight(): string;
     set maxHeight(v: string);
-    /**
-     * Extract font-related CSS properties from element
-     */
     private getFontStyle;
-    /**
-     * Extract spacing-related CSS properties from element
-     */
     private getSpacingStyle;
-    /**
-     * Setup the hidden dummy element for height measurement
-     */
+    /** Hidden dummy element used to measure the content height. */
     private setupDummyElement;
-    /**
-     * Resize textarea based on dummy element content with min/max height constraints
-     */
+    /** Resize the textarea to the dummy's measured height, within min/max. */
     private resizeTextarea;
     private _setupScrollbar;
     private _destroyScrollbar;
-    /**
-     * Emit custom input and change events
-     */
     private emitValueEvents;
-    /**
-     * Handle textarea input event
-     */
     private handleInputEvent;
-    /**
-     * Handle textarea focus event
-     */
     private handleFocusEvent;
-    /**
-     * Handle textarea blur event
-     */
     private handleBlurEvent;
-    /**
-     * Build class list for textarea element
-     */
     private buildClassList;
-    /**
-     * Apply min/max height constraints to textarea element
-     */
     private applyHeightConstraints;
-    /**
-     * Setup event listeners for textarea
-     */
     private setupTextareaEvents;
     protected render(): void;
     /** required + empty => valueMissing; otherwise valid. Disabled fields are
@@ -241,4 +162,3 @@ export declare class TyTextarea extends TyComponent<TextareaState> implements Ty
     private updateValidity;
 }
 export {};
-//# sourceMappingURL=textarea.d.ts.map