@mono-lit/helper 0.0.0-stage → 0.0.1

package/dist/src/components/tag-input/tag-input-types.d.ts

@@ -0,0 +1,394 @@
+import { MonoDataSource, LoadMoreMode } from '../../composables/data-source-controller';
+import { PanelSizeProps } from '../../composables/css-size';
+import { VisibilityProps } from '../../composables/visibility';
+import { MonoSearchValue } from '../../search/data-search';
+import { ChipBehaviour, ChipColor, ChipCssClass, ChipRounded, ChipSize, ChipVariant } from '../chip/chip-types';
+import { ChipLimitProps } from '../../composables/chip-limits';
+/** Re-exported so consumers can type a `search-value` binding without a deep import. */
+export type { MonoSearchValue };
+/** The `max` / `min` / `maxVisible` / `minVisible` keys the `chip` object accepts. */
+export type { ChipLimitProps };
+/** Re-exported so consumers can type a `chip.behaviour` without a deep import. */
+export type { ChipBehaviour };
+export type TagInputSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+export type TagInputColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'teal' | 'purple' | 'neutral' | 'dark';
+export type TagInputVariant = 'outlined' | 'filled' | 'underlined';
+/**
+ * Configuration for the tag chips inside the field, passed as one object:
+ * `<mono-tag-input :chip.prop="{ size: 'md', shape: 'rounded', dot: true }">`.
+ *
+ * The tags are rendered as `mono-chip` markup and painted by `chip.css`, so
+ * every key here is the corresponding {@link MonoChipProps} prop and takes the
+ * same values. Anything left unset follows the control instead of a fixed
+ * default:
+ *
+ * - `color` — defaults to the control's `color`. Setting it pins the chips to a
+ *   hue of their own, and they stop tracking `--mono-tag-input-focus-color`.
+ * - `variant` — defaults to a skin matching the control's `variant`
+ *   (`outlined` → `soft`, `filled` → `solid`, `underlined` → `outline`).
+ * - `size` — defaults to `sm`. The chip scale is independent of the control
+ *   height scale, so pick the step that sits well in your field.
+ * - `shape` — defaults to `pill`.
+ *
+ * Props the control owns are deliberately absent: the label comes from the tag
+ * value, `removable` follows `disabled`/`readonly`, and `href`/`selected` have
+ * no meaning for a tag.
+ */
+export interface TagInputChipProps extends ChipLimitProps {
+    /**
+     * How the chips are laid out in the field. Default `flex` — they wrap onto
+     * new lines and the field grows taller.
+     *
+     * `inline` keeps them on ONE line in a horizontally scrolling strip, so the
+     * field never changes height. The strip is moved ONLY by the `‹` / `›`
+     * buttons rendered before the clear button / caret: no scrollbar is painted,
+     * and wheel, click-drag and arrow-key scrolling are all inert.
+     *
+     * {@link TagInputProps.maxVisible} applies in both layouts: past it the rest
+     * collapse into a "+N more" chip (in the strip, when inline) whose panel
+     * lists them.
+     */
+    behaviour?: ChipBehaviour;
+    /** Chip scale. Default `sm`. */
+    size?: ChipSize;
+    /** Chip hue. Defaults to the control's `color`; setting it pins the chips. */
+    color?: ChipColor;
+    /** Chip skin. Defaults to the skin matching the control's `variant`. */
+    variant?: ChipVariant;
+    /** Corner radius. Unset keeps the pill a chip has by default. */
+    rounded?: ChipRounded;
+    /** Show a status dot before each tag label. */
+    dot?: boolean;
+    /** Accessible label for the remove button. Default `Remove <tag>`. */
+    closeLabel?: string;
+    /** Per-part class overrides, same keys as `mono-chip`'s `cssClass`. */
+    cssClass?: ChipCssClass;
+}
+export type TagInputValidationState = 'default' | 'valid' | 'invalid' | 'warning';
+export type TagInputValue = unknown;
+export interface TagInputItem {
+    label?: string;
+    value?: unknown;
+    description?: string;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+/** A field name or an accessor over the consumer's own row type — see `SelectDisplayValue`. */
+export type TagInputDisplayValue = string | ((item: any) => string);
+/**
+ * Per-level accessors for grouped options — one entry per group level. Each
+ * resolves a group header's label from a representative leaf row: a string reads
+ * `row[field]`; a function receives the row.
+ */
+export type TagInputDisplayGroup = Array<string | ((item: any) => string)>;
+/**
+ * Structural shape of a devextreme DataSource (duck-typed; no hard dependency).
+ * Aliased to the shared {@link MonoDataSource}.
+ */
+export type TagInputDataSource<T = TagInputItem> = MonoDataSource<T>;
+/**
+ * Incremental loading mode. Works with BOTH a paged DataSource and a plain
+ * `items` array (revealed one `page-size` chunk at a time):
+ * - 'button' → render a "Load more" button at the end of the suggestions.
+ * - 'scroll' → load/reveal the next chunk when scrolled near the bottom.
+ */
+export type TagInputLoadMore = LoadMoreMode;
+export interface TagInputCssClass {
+    root?: string;
+    label?: string;
+    required?: string;
+    field?: string;
+    chip?: string;
+    chipLabel?: string;
+    chipRemove?: string;
+    /** The one-line scrolling chip strip (`chip.behaviour: 'inline'` only). */
+    chipStrip?: string;
+    native?: string;
+    /** The trailing actions row holding the scroll buttons and clear / caret. */
+    actions?: string;
+    clear?: string;
+    /** The caret — shown in place of `clear` while the field has nothing to clear. */
+    arrow?: string;
+    /** The `‹` scroll-back button (inline only). */
+    scrollPrev?: string;
+    /** The `›` scroll-forward button (inline only). */
+    scrollNext?: string;
+    dropdown?: string;
+    group?: string;
+    /** The group header's label, when the header is a select-all button. */
+    groupLabel?: string;
+    /** The leading "All" row. Sits alongside `item`, which it also carries. */
+    selectAll?: string;
+    item?: string;
+    itemActive?: string;
+    itemSelected?: string;
+    itemDisabled?: string;
+    check?: string;
+    itemText?: string;
+    itemTitle?: string;
+    itemSub?: string;
+    empty?: string;
+    loadMore?: string;
+    moreChip?: string;
+    morePanel?: string;
+    messageWrap?: string;
+    message?: string;
+}
+/**
+ * Popup-panel sizing for {@link TagInputProps.dropdown}. Each key takes a CSS length string
+ * (`"38rem"`, `"80%"`) or a number, read as px.
+ *
+ * `height` is an EXACT height and `maxHeight` the cap — the same split this component's
+ * `dropdown-height` / `dropdown-max-height` attributes already carry.
+ */
+export type TagInputDropdownOptions = PanelSizeProps;
+export type TagInputModelEventDetail<TValue = TagInputValue[]> = {
+    modelValue: TValue;
+    currentValue: TValue;
+    oldValue: TValue;
+    value: TValue;
+    addedValue?: TagInputValue;
+    removedValue?: TagInputValue;
+    selectedItem?: TagInputItem;
+    sourceEvent?: Event;
+};
+export type TagInputModelEvent<TValue = TagInputValue[]> = CustomEvent<TagInputModelEventDetail<TValue>>;
+export interface TagInputProps extends VisibilityProps {
+    /** Two-way bound array of selected tag values. */
+    modelValue?: TagInputValue[];
+    'model-value'?: TagInputValue[];
+    modelvalue?: TagInputValue[] | string;
+    /** Selected tag values (kept in sync with modelValue). */
+    value?: TagInputValue[];
+    /** Suggestion items to choose from. */
+    items?: TagInputItem[] | string;
+    /** DataSource driving the suggestions; takes precedence over items. */
+    dataSource?: TagInputDataSource;
+    'data-source'?: TagInputDataSource;
+    datasource?: TagInputDataSource;
+    /** DataSource-only: auto-load the source on attach when it has no items yet. */
+    immediate?: boolean;
+    /** Incremental loading mode; enabling defaults to scroll, button opts into a button. */
+    loadMore?: TagInputLoadMore | boolean | '';
+    'load-more'?: TagInputLoadMore | boolean | '';
+    loadmore?: TagInputLoadMore | boolean | '';
+    /** Chunk size used when paging a plain items array (default 10). */
+    pageSize?: number;
+    'page-size'?: number;
+    pagesize?: number;
+    /**
+     * Sizes the popup PANEL only, independent of the field. Bind with `.prop`:
+     * `:dropdown.prop="{ width: 460, maxHeight: 320 }"`.
+     *
+     * Without it the panel matches the field's width, which is the right default for a picker whose
+     * options read as continuations of what was typed — and the wrong one for a full-width field,
+     * where it leaves the option rows running the width of the page.
+     *
+     * `height` is an exact height and `maxHeight` the cap — the same split the `dropdown-height` /
+     * `dropdown-max-height` attributes carry, and the same object `<mono-select>` and
+     * `<mono-dropdown-table>` take.
+     */
+    dropdown?: TagInputDropdownOptions;
+    /** Fixed height of the scrollable suggestions list. */
+    dropdownHeight?: string | number;
+    'dropdown-height'?: string | number;
+    dropdownheight?: string | number;
+    /** Max height of the scrollable suggestions list. */
+    dropdownMaxHeight?: string | number;
+    'dropdown-max-height'?: string | number;
+    dropdownmaxheight?: string | number;
+    /**
+     * Exempt this tag-input from every automatic close — clicking or focusing
+     * anything outside it, which includes opening another one. Not a lock: its own
+     * trigger, Escape and picking an item still close it.
+     */
+    stayOpen?: boolean;
+    'stay-open'?: boolean;
+    stayopen?: boolean;
+    /** Property name on each item used as the stored tag value. */
+    keyValue?: string;
+    'key-value'?: string;
+    keyvalue?: string;
+    /** Property name or selector function deriving each item's display text. */
+    displayValue?: TagInputDisplayValue;
+    'display-value'?: TagInputDisplayValue;
+    displayvalue?: TagInputDisplayValue;
+    /** Per-level accessors for grouped options (header label per group level). */
+    displayGroup?: TagInputDisplayGroup;
+    'display-group'?: TagInputDisplayGroup;
+    displaygroup?: TagInputDisplayGroup;
+    /** Field holding a group node's key (default 'key'). */
+    groupKey?: string;
+    'group-key'?: string;
+    groupkey?: string;
+    /** Field holding a group node's child array (default 'items'). */
+    groupItems?: string;
+    'group-items'?: string;
+    groupitems?: string;
+    /** Group a plain, paginated DataSource (or flat array) client-side. */
+    group?: boolean;
+    /** Keep group headers pinned to the top while their rows scroll. */
+    groupSticky?: boolean;
+    'group-sticky'?: boolean;
+    groupsticky?: boolean;
+    /**
+     * Show a leading "All" row that selects / clears every option the current search
+     * leaves visible (default `true`).
+     */
+    selectAll?: boolean;
+    'select-all'?: boolean;
+    selectall?: boolean;
+    /** Label of the select-all row (default `'All'`). */
+    selectAllLabel?: string;
+    'select-all-label'?: string;
+    selectalllabel?: string;
+    /**
+     * Turn every group header into its own select-all over that group's rows
+     * (default `true`). Only rendered while the list is grouped.
+     */
+    groupSelectAll?: boolean;
+    'group-select-all'?: boolean;
+    groupselectall?: boolean;
+    /** Whether typing in the field searches (default `true`; `false` = read-only input). */
+    searchable?: boolean;
+    /**
+     * Field(s) the search matches (server query + client filter target). A comma
+     * string or an array; entries may be plain columns, paths (`Company.Name`,
+     * `Transaction.[*].Price`), `*` patterns (`'*'`, `'*.[*].*'`) or, in array
+     * form, `{ field, custom }` clause builders.
+     */
+    searchValue?: MonoSearchValue;
+    'search-value'?: MonoSearchValue;
+    searchvalue?: MonoSearchValue;
+    /** devextreme search operation for server search (default 'contains'). */
+    searchOperation?: string;
+    'search-operation'?: string;
+    searchoperation?: string;
+    /** Debounce (ms) before a server search fires (default 300). */
+    searchDebounce?: number;
+    'search-debounce'?: number;
+    searchdebounce?: number;
+    /** Size of the tag input. */
+    size?: TagInputSize;
+    /** Color theme of the tag input. */
+    color?: TagInputColor;
+    /** Visual style of the tag input. */
+    variant?: TagInputVariant;
+    /**
+     * Tag chip configuration — the `mono-chip` props to apply to every tag.
+     * Bind it as a real property (`:chip.prop="{ size: 'md' }"`); a plain
+     * `chip='{"size":"md"}'` JSON attribute also works for static HTML.
+     */
+    chip?: TagInputChipProps | string;
+    /** Text label shown above the field. */
+    label?: string;
+    /** Placeholder text shown when the input is empty. */
+    placeholder?: string;
+    /** Helper text shown below the field. */
+    helperText?: string;
+    'helper-text'?: string;
+    helpertext?: string;
+    /** Validation state controlling field styling. */
+    validationState?: TagInputValidationState;
+    'validation-state'?: TagInputValidationState;
+    validationstate?: TagInputValidationState;
+    /** Message shown for the current validation state. */
+    validationMessage?: string;
+    'validation-message'?: string;
+    validationmessage?: string;
+    /** Error message that forces the invalid state. */
+    errorMessage?: string;
+    'error-message'?: string;
+    errormessage?: string;
+    /** Success message that forces the valid state. */
+    successMessage?: string;
+    'success-message'?: string;
+    successmessage?: string;
+    /** Form field name for the underlying input. */
+    name?: string;
+    /** Disables interaction with the tag input. */
+    disabled?: boolean;
+    /** Makes the tag input read-only. */
+    readonly?: boolean;
+    /** Marks the field as required. */
+    required?: boolean;
+    /** Shows a clear button to remove all tags. */
+    clearable?: boolean;
+    /** Allows adding custom tags not present in the items. */
+    allowCustom?: boolean;
+    'allow-custom'?: boolean;
+    allowcustom?: boolean;
+    /** Allows duplicate tag values. */
+    duplicate?: boolean;
+    /**
+     * Most tags the user can select; unset = unlimited. A pick past it is
+     * rejected — nothing is disabled, the pick just does not land (a typed tag is
+     * dropped, the query reset); bulk adds fill only the room left. `chip.max`
+     * pins over it. A `model-value` pushed in is never trimmed.
+     */
+    max?: number;
+    /**
+     * Fewest tags the user can leave; unset = 0. At the floor the chips lose their
+     * ✕, a deselect / Backspace is rejected, the clear button hides and a bulk
+     * deselect keeps the first `min`. `chip.min` pins over it.
+     */
+    min?: number;
+    /** Checkbox multi-select mode (selected rows stay checked, dropdown stays open). */
+    checkable?: boolean;
+    /**
+     * Chips drawn before the rest collapse into a clickable "+N more" chip whose
+     * panel lists them. Display-only. Applies in `flex` AND `inline` — in the
+     * strip the "+N more" chip sits after the visible chips. `chip.maxVisible`
+     * pins over it.
+     */
+    maxVisible?: number;
+    'max-visible'?: number;
+    maxvisible?: number;
+    /**
+     * Collapse floor: while the selection is at or under this, every chip is drawn
+     * regardless of `max-visible`. `chip.minVisible` pins over it.
+     */
+    minVisible?: number;
+    'min-visible'?: number;
+    minvisible?: number;
+    /** Accessible label for screen readers. */
+    ariaLabelText?: string;
+    ariaLabel?: string;
+    'aria-label'?: string;
+    'aria-label-text'?: string;
+    arialabel?: string;
+    arialabeltext?: string;
+    /**
+     * Explicit sizing of the field. Each accepts a CSS length string (`"320px"`,
+     * `"80%"`) or a number (interpreted as px). Use `width="100%"` for full width.
+     * (Distinct from `dropdownHeight`/`dropdownMaxHeight`, which size the popup.)
+     */
+    width?: string | number;
+    height?: string | number;
+    minWidth?: string | number;
+    'min-width'?: string | number;
+    maxWidth?: string | number;
+    'max-width'?: string | number;
+    minHeight?: string | number;
+    'min-height'?: string | number;
+    maxHeight?: string | number;
+    'max-height'?: string | number;
+    /** Per-part class overrides for styling internal elements. */
+    cssClass?: TagInputCssClass;
+    cssclass?: TagInputCssClass;
+    'css-class'?: TagInputCssClass | string;
+}
+export interface TagInputEvents {
+    change: TagInputModelEvent;
+    add: TagInputModelEvent;
+    remove: TagInputModelEvent;
+    clear: TagInputModelEvent;
+    'mno-change': TagInputModelEvent;
+    mnoChange: TagInputModelEvent;
+    'mno-add': TagInputModelEvent;
+    mnoAdd: TagInputModelEvent;
+    'mno-remove': TagInputModelEvent;
+    mnoRemove: TagInputModelEvent;
+    'mno-clear': TagInputModelEvent;
+    mnoClear: TagInputModelEvent;
+}

package/dist/src/components/tag-input/tag-input-utils.d.ts

@@ -0,0 +1,8 @@
+import { TagInputColor, TagInputSize, TagInputValidationState, TagInputVariant, TagInputItem } from './tag-input-types.js';
+export declare function validateTagInputProps(props: {
+    size?: TagInputSize;
+    color?: TagInputColor;
+    variant?: TagInputVariant;
+    validationState?: TagInputValidationState;
+}): boolean;
+export declare function normalizeSuggestions(items: TagInputItem[]): TagInputItem[];

package/dist/src/components/textarea/index.d.ts

@@ -0,0 +1,4 @@
+/// <reference path="../../../vue.d.ts" />
+export { MonoTextarea } from './mono-textarea.js';
+export type { TextareaSize, TextareaColor, TextareaVariant, TextareaValidationState, TextareaProps, TextareaEvents, } from './textarea-types.js';
+export { validateTextareaProps, } from './textarea-utils.js';

package/dist/src/components/textarea/index.shadow.d.ts

@@ -0,0 +1,5 @@
+/// <reference path="../../../vue.d.ts" />
+export { MonoTextareaShadow } from './mono-textarea.shadow.js';
+export { MonoTextareaCore, type TextareaSlotName } from './textarea-core.js';
+export type { TextareaSize, TextareaColor, TextareaVariant, TextareaValidationState, TextareaProps, TextareaEvents, } from './textarea-types.js';
+export { validateTextareaProps, } from './textarea-utils.js';

package/dist/src/components/textarea/mono-textarea.d.ts

@@ -0,0 +1,29 @@
+import { LitElement } from 'lit';
+declare const MonoTextarea_base: import('../../composables/hybird-prop').Constructor<import('./textarea-core.js').MonoTextareaCoreInterface> & typeof LitElement;
+/**
+ * Light-DOM `mono-textarea` (default build, `@mono-lit/helper/ui/textarea`).
+ *
+ * `createRenderRoot()` returns `this`, so it renders into light DOM and inherits
+ * the page's global stylesheet. Named slots (label/helper) are captured from the
+ * light-DOM children in `connectedCallback` and re-parented into the rendered
+ * `data-mono-slot` placeholders in `updated()`. All render-mode-agnostic logic is
+ * shared with the shadow build (`@mono-lit/helper/ui/shadow/textarea`) via
+ * `MonoTextareaCore`; both register `mono-textarea`, so a document loads one.
+ */
+export declare class MonoTextarea extends MonoTextarea_base {
+    static styles: import('lit').CSSResult[];
+    protected createRenderRoot(): HTMLElement;
+    private _slotsCaptured;
+    private _slotLabel;
+    private _slotHelper;
+    connectedCallback(): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private _captureSlots;
+    private _placeSlot;
+}
+declare global {
+    interface HTMLElementTagNameMap {
+        'mono-textarea': MonoTextarea;
+    }
+}
+export {};

package/dist/src/components/textarea/mono-textarea.shadow.d.ts

@@ -0,0 +1,31 @@
+import { LitElement, TemplateResult } from 'lit';
+import { TextareaSlotName } from './textarea-core.js';
+declare const MonoTextareaShadow_base: import('../../composables/hybird-prop').Constructor<import('./textarea-core.js').MonoTextareaCoreInterface> & typeof LitElement;
+/**
+ * Shadow-DOM `mono-textarea` (the opt-in SSR build, `@mono-lit/helper/ui/shadow/textarea`).
+ *
+ * Real shadow root + `static styles`, so `@lit-labs/ssr` serializes it to
+ * Declarative Shadow DOM and styles are scoped (`mono-textarea`→`:host`). The
+ * `<textarea>` + label/message/counter render server-side (no icons). The
+ * `label`/`helper` slots carry the prop text as native fallback (shown
+ * server-side); presence is detected in `firstUpdated()` via `assignedNodes()`
+ * (DSD assigns at parse time → no `slotchange` after upgrade) plus `@slotchange`.
+ * Interactivity needs the first client update to flush (so `@input` binds) —
+ * hence the defer-hydration poll. Shares all logic with the light build via
+ * `MonoTextareaCore`; both register `mono-textarea`, so a document loads one.
+ */
+export declare class MonoTextareaShadow extends MonoTextareaShadow_base {
+    static styles: import('lit').CSSResult[];
+    protected get _slotsAlwaysRender(): boolean;
+    connectedCallback(): void;
+    firstUpdated(changed: Map<string, unknown>): void;
+    protected updated(changed: Map<string, unknown>): void;
+    private _slotFor;
+    private _slotHasContent;
+    private _onSlotChange;
+    /** Reconcile the 2 slot-presence flags from their slots' assigned content. */
+    private _scanSlots;
+    /** Native `<slot>` carrying the prop fallback as native slot content. */
+    protected _slotOutlet(name: TextareaSlotName, fallback?: unknown): TemplateResult;
+}
+export {};

package/dist/src/components/textarea/textarea-core.d.ts

@@ -0,0 +1,60 @@
+import { LitElement, TemplateResult } from 'lit';
+import { TextareaSize, TextareaColor, TextareaVariant, TextareaValidationState, TextareaCssClass } from './textarea-types.js';
+import { Constructor } from '../../composables/hybird-prop';
+import { CssSizeValue } from '../../composables/css-size';
+/** Named slots projected by `mono-textarea` (light: captured; shadow: native). */
+export type TextareaSlotName = 'label' | 'helper';
+/**
+ * `MonoTextareaCore` — render-mode-agnostic logic for `mono-textarea` (props,
+ * hybrid aliases, value/model sync, validation, char counter, auto-resize, and
+ * the full `render()`). SSR-safe: the only DOM/`window` access (`_syncAutoResize`)
+ * is `isServer`-guarded. Each build supplies `createRenderRoot()` + `static styles`
+ * and the slot strategy via the `_slotOutlet` hook (light: `data-mono-slot`
+ * placeholders; shadow: native `<slot>`). Mirrors `switch-core`/`select-core`.
+ */
+export declare const MonoTextareaCore: <T extends Constructor<LitElement>>(superClass: T) => Constructor<MonoTextareaCoreInterface> & T;
+/** Public + shared-protected surface added by the core mixin. */
+export declare class MonoTextareaCoreInterface {
+    size: TextareaSize;
+    color: TextareaColor;
+    variant: TextareaVariant;
+    modelValue: string;
+    value: string;
+    name: string;
+    placeholder: string;
+    label: string;
+    helperText: string;
+    validationState: TextareaValidationState;
+    validationMessage: string;
+    errorMessage: string;
+    successMessage: string;
+    ariaLabelText?: string;
+    disabled: boolean;
+    readonly: boolean;
+    required: boolean;
+    autofocus: boolean;
+    autoResize: boolean;
+    showCounter: boolean;
+    rows?: number;
+    minRows?: number;
+    maxRows?: number;
+    minLength?: number;
+    maxLength?: number;
+    cssClass: TextareaCssClass;
+    cssClassName: string;
+    width?: CssSizeValue;
+    height?: CssSizeValue;
+    minWidth?: CssSizeValue;
+    maxWidth?: CssSizeValue;
+    minHeight?: CssSizeValue;
+    maxHeight?: CssSizeValue;
+    focus(): void;
+    blur(): void;
+    select(): void;
+    setSelectionRange(start: number, end: number, direction?: 'forward' | 'backward' | 'none'): void;
+    protected _hasLabelSlotState: boolean;
+    protected _hasHelperSlotState: boolean;
+    protected get _slotsAlwaysRender(): boolean;
+    protected _setSlotState(name: TextareaSlotName, has: boolean): void;
+    protected _slotOutlet(name: TextareaSlotName, fallback?: unknown): TemplateResult;
+}

package/dist/src/components/textarea/textarea-types.d.ts

@@ -0,0 +1,131 @@
+import { VisibilityProps } from '../../composables/visibility';
+export type TextareaSize = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+export type TextareaColor = 'primary' | 'secondary' | 'success' | 'danger' | 'warning' | 'info' | 'teal' | 'purple' | 'neutral' | 'dark';
+export type TextareaVariant = 'outlined' | 'filled' | 'underlined';
+export type TextareaValidationState = 'default' | 'valid' | 'invalid' | 'warning';
+export interface TextareaCssClass {
+    root?: string;
+    label?: string;
+    required?: string;
+    field?: string;
+    footer?: string;
+    messageWrap?: string;
+    message?: string;
+    counter?: string;
+}
+export type TextareaModelEventDetail = {
+    modelValue: string;
+    currentValue: string;
+    oldValue: string;
+    value: string;
+    name?: string;
+    sourceEvent?: Event;
+};
+export type TextareaModelEvent = CustomEvent<TextareaModelEventDetail>;
+export interface TextareaProps extends VisibilityProps {
+    /** Two-way bound text value of the textarea. */
+    modelValue?: string;
+    'model-value'?: string;
+    modelvalue?: string;
+    /** Text value (kept in sync with modelValue). */
+    value?: string;
+    /** Form field name for the underlying textarea. */
+    name?: string;
+    /** Placeholder text shown when empty. */
+    placeholder?: string;
+    /** Text label shown above the textarea. */
+    label?: string;
+    /** Helper text shown below the textarea. */
+    helperText?: string;
+    'helper-text'?: string;
+    helpertext?: string;
+    /** Validation state controlling field styling. */
+    validationState?: TextareaValidationState;
+    'validation-state'?: TextareaValidationState;
+    validationstate?: TextareaValidationState;
+    /** Message shown for the current validation state. */
+    validationMessage?: string;
+    'validation-message'?: string;
+    validationmessage?: string;
+    /** Error message that forces the invalid state. */
+    errorMessage?: string;
+    'error-message'?: string;
+    errormessage?: string;
+    /** Success message that forces the valid state. */
+    successMessage?: string;
+    'success-message'?: string;
+    successmessage?: string;
+    /** Size of the textarea. */
+    size?: TextareaSize;
+    /** Color theme of the textarea. */
+    color?: TextareaColor;
+    /** Visual style of the textarea. */
+    variant?: TextareaVariant;
+    /** Disables interaction with the textarea. */
+    disabled?: boolean;
+    /** Makes the textarea read-only. */
+    readonly?: boolean;
+    /** Marks the field as required. */
+    required?: boolean;
+    /** Focuses the textarea on first render. */
+    autofocus?: boolean;
+    /** Automatically grows the height to fit content. */
+    autoResize?: boolean;
+    'auto-resize'?: boolean;
+    autoresize?: boolean;
+    /** Initial number of visible text rows. */
+    rows?: number;
+    /** Minimum number of rows when auto-resizing. */
+    minRows?: number;
+    'min-rows'?: number;
+    minrows?: number;
+    /** Maximum number of rows when auto-resizing. */
+    maxRows?: number;
+    'max-rows'?: number;
+    maxrows?: number;
+    /** Minimum allowed character length. */
+    minLength?: number;
+    'min-length'?: number;
+    minlength?: number;
+    /** Maximum allowed character length. */
+    maxLength?: number;
+    'max-length'?: number;
+    maxlength?: number;
+    /** Shows a character counter below the field. */
+    showCounter?: boolean;
+    'show-counter'?: boolean;
+    showcounter?: boolean;
+    /** Accessible label for screen readers. */
+    ariaLabelText?: string;
+    ariaLabel?: string;
+    'aria-label'?: string;
+    'aria-label-text'?: string;
+    arialabel?: string;
+    arialabeltext?: string;
+    /**
+     * Explicit sizing. Each accepts a CSS length string (`"320px"`, `"80%"`) or a
+     * number (interpreted as px). Use `width="100%"` for a full-width field.
+     */
+    width?: string | number;
+    height?: string | number;
+    minWidth?: string | number;
+    'min-width'?: string | number;
+    maxWidth?: string | number;
+    'max-width'?: string | number;
+    minHeight?: string | number;
+    'min-height'?: string | number;
+    maxHeight?: string | number;
+    'max-height'?: string | number;
+    /** Per-part class overrides for styling internal elements. */
+    cssClass?: TextareaCssClass;
+    cssclass?: TextareaCssClass;
+    'css-class'?: TextareaCssClass | string;
+}
+export interface TextareaEvents {
+    input: TextareaModelEvent;
+    change: TextareaModelEvent;
+    'mno-input': TextareaModelEvent;
+    mnoInput: TextareaModelEvent;
+    'mno-change': TextareaModelEvent;
+    mnoChange: TextareaModelEvent;
+}

package/dist/src/components/textarea/textarea-utils.d.ts

@@ -0,0 +1,7 @@
+import { TextareaColor, TextareaSize, TextareaValidationState, TextareaVariant } from './textarea-types.js';
+export declare function validateTextareaProps(props: {
+    size?: TextareaSize;
+    color?: TextareaColor;
+    variant?: TextareaVariant;
+    validationState?: TextareaValidationState;
+}): boolean;