@lifecorner/angular-ui-kit 3.9.0 → 3.10.1

package/types/lifecorner-angular-ui-kit-textarea.d.ts

@@ -1,5 +1,6 @@
-import { ControlValueAccessor } from "@angular/forms";
 import * as i0 from "@angular/core";
+import { OutputRef } from "@angular/core";
+import { ControlValueAccessor } from "@angular/forms";
 /**
  * Textarea component for multi-line text input.
  *
@@ -11,91 +12,152 @@ import * as i0 from "@angular/core";
  * - Validation error message and helper text
  * - Disabled and readonly states
  * - ControlValueAccessor integration for reactive forms
+ * - Plain form posts without JavaScript: `name`, and a `value` that is
+ *   prerendered into the native `<textarea>`
  *
  * @example
  * ```html
  * <lc-textarea placeholder="Enter message" [autoResize]="true" [(ngModel)]="message" />
+ * <lc-textarea label="Message" name="message" [required]="true" [value]="draft" />
  * ```
  */
 export declare class TextareaComponent implements ControlValueAccessor {
   private readonly textareaElement;
+  private readonly isServer;
   /**
    * Visual variant of the textarea
+   * @default 'outline'
    */
   readonly variant: import("@angular/core").InputSignal<"outline" | "filled">;
   /**
    * Size of the textarea
+   * @default 'md'
    */
   readonly size: import("@angular/core").InputSignal<"xs" | "sm" | "md" | "lg">;
   /**
    * Whether the textarea is disabled
+   * @default false
    */
   readonly disabled: import("@angular/core").InputSignal<boolean>;
   /**
    * Whether the textarea is in error state
+   * @default false
    */
   readonly error: import("@angular/core").InputSignal<boolean>;
   /**
    * Whether the textarea is required
+   * @default false
    */
   readonly required: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Show the `*` after the label of a `required` field. `false` keeps the
+   * required semantics (`required`, `aria-required`) without the asterisk —
+   * for forms where every field is required.
+   * @default true
+   */
+  readonly requiredIndicator: import("@angular/core").InputSignal<boolean>;
+  /**
+   * Accessible name of the `*` marker, for API parity with `lc-input`.
+   * `lc-textarea` hides the `*` from assistive technology, because the native
+   * `required` state is announced already and naming the `*` would say
+   * "required" twice.
+   * @default 'required'
+   */
+  readonly requiredAriaLabel: import("@angular/core").InputSignal<string>;
   /**
    * Whether the textarea is readonly
+   * @default false
    */
   readonly readonly: import("@angular/core").InputSignal<boolean>;
   /**
    * Placeholder text
+   * @default ''
    */
   readonly placeholder: import("@angular/core").InputSignal<string>;
   /**
    * Label text displayed above the textarea
+   * @default ''
    */
   readonly label: import("@angular/core").InputSignal<string>;
   /**
    * Helper text displayed below the textarea
+   * @default ''
    */
   readonly helperText: import("@angular/core").InputSignal<string>;
   /**
    * Error message displayed when error is true
+   * @default ''
    */
   readonly errorMessage: import("@angular/core").InputSignal<string>;
   /**
    * ARIA label for accessibility
+   * @default undefined
    */
   readonly ariaLabel: import("@angular/core").InputSignal<string | undefined>;
+  /**
+   * Native `name` of the inner `<textarea>`, so a form posts the text without
+   * JavaScript. Unset = no attribute. A `disabled` textarea is not posted
+   * (HTML); use `readonly` to post a fixed text.
+   * @default undefined
+   */
+  readonly name: import("@angular/core").InputSignal<string | undefined>;
   /**
    * Number of visible text rows
+   * @default 3
    */
   readonly rows: import("@angular/core").InputSignal<number>;
   /**
    * Maximum number of characters allowed
+   * @default undefined
    */
   readonly maxLength: import("@angular/core").InputSignal<number | undefined>;
   /**
    * Whether to show character count
+   * @default false
    */
   readonly showCharacterCount: import("@angular/core").InputSignal<boolean>;
   /**
    * Whether to automatically resize based on content
+   * @default false
    */
   readonly autoResize: import("@angular/core").InputSignal<boolean>;
   /**
    * Minimum number of rows for auto-resize
+   * @default 3
    */
   readonly minRows: import("@angular/core").InputSignal<number>;
   /**
    * Maximum number of rows for auto-resize
+   * @default undefined
    */
   readonly maxRows: import("@angular/core").InputSignal<number | undefined>;
   /**
-   * Emitted when value changes
+   * Current text, two-way bindable (`[value]` / `[(value)]`). It pre-fills the
+   * native textarea, in prerendered HTML too, so a server-rendered page can
+   * keep a visitor's text. Emits `valueChange` whenever it changes: once per
+   * keystroke that changes the text, and when a bound form control or code
+   * sets a different text. With a form control, the control's value wins;
+   * don't bind both.
+   * @default ''
+   */
+  readonly value: import("@angular/core").ModelSignal<string>;
+  /**
+   * The model's change output as a class property, so code that subscribes to
+   * it (`textarea.valueChange.subscribe(…)`, `outputToObservable(…)`) keeps
+   * compiling as in 3.9. Template bindings `(valueChange)` use the model.
    */
-  readonly valueChange: import("@angular/core").OutputEmitterRef<string>;
+  readonly valueChange: OutputRef<string>;
   /** Per-instance id: links label, error and helper text to the control. */
   readonly textareaId: string;
   readonly errorId: string;
   readonly helperId: string;
-  readonly value: import("@angular/core").WritableSignal<string>;
+  /**
+   * The native textarea's value. On the server a leading line break gets one
+   * extra `\n`: the HTML parser drops the first line break after `<textarea>`,
+   * and the server's DOM serialiser doesn't add the one the HTML
+   * serialisation rules require, so the prerendered page would lose it.
+   */
+  protected readonly renderedValue: import("@angular/core").Signal<string>;
   private readonly formDisabled;
   /**
    * Computed disabled state from both input and form control
@@ -159,6 +221,16 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "requiredIndicator": {
+      "alias": "requiredIndicator";
+      "required": false;
+      "isSignal": true;
+    };
+    "requiredAriaLabel": {
+      "alias": "requiredAriaLabel";
+      "required": false;
+      "isSignal": true;
+    };
     "readonly": {
       "alias": "readonly";
       "required": false;
@@ -189,6 +261,11 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "name": {
+      "alias": "name";
+      "required": false;
+      "isSignal": true;
+    };
     "rows": {
       "alias": "rows";
       "required": false;
@@ -219,7 +296,12 @@ export declare class TextareaComponent implements ControlValueAccessor {
       "required": false;
       "isSignal": true;
     };
+    "value": {
+      "alias": "value";
+      "required": false;
+      "isSignal": true;
+    };
   }, {
-    "valueChange": "valueChange";
+    "value": "valueChange";
   }, never, never, true, never>;
 }