@moni-labs/moni-ui 0.4.4 → 0.4.5

package/docs/components/tab.md

@@ -0,0 +1,133 @@
+# Tab
+
+Componente Material Design 3 Tab (Pestaña).
+
+Un elemento interactivo de pestaña individual diseñado para ser colocado dentro de un
+contenedor `<moni-tabs>`. Las pestañas organizan el contenido en diferentes pantallas,
+conjuntos de datos y otras interacciones.
+
+**Referencia a la especificación M3:** `m3-docs/components/tabs/specs.md`
+
+**Diseño visual e interacción:**
+Internamente se renderiza como un elemento `<a>` para soportar el comportamiento nativo
+de enlace cuando se proporciona un `href`, pero se comporta visualmente como un botón de pestaña.
+Muestra una etiqueta de texto y un icono opcional de Material. Si el `<moni-tabs>` padre tiene el
+atributo `vertical` configurado, el diseño se ajusta automáticamente para apilar el icono
+encima del texto.
+
+**Estado:**
+El atributo `active` resalta la pestaña, aplicando el color principal (primary) al
+texto y renderizando la línea indicadora activa (manejado vía CSS en el contenedor
+padre o mediante pseudo-elementos).
+
+- Tag: `moni-tab`
+- Clase: `MoniTab`
+- Fuente: `src/components/moni-tab.ts`
+
+## Cuándo usarlo
+
+Usa `moni-tab` cuando la interfaz necesite el patrón que describe este componente. Antes de elegirlo, revisa sus estados, contenido permitido y comportamiento accesible; las capturas del final muestran el resultado real de cada variante.
+
+## Uso básico
+
+```html
+<moni-tabs>
+  <moni-tab active icon="home" label="Inicio"></moni-tab>
+  <moni-tab icon="settings" label="Ajustes" href="/settings"></moni-tab>
+</moni-tabs>
+```
+
+## Ejemplo práctico con Tailwind CSS v4
+
+Tailwind controla composición, ancho, espaciado y responsividad alrededor del Web Component. Moni UI conserva el aspecto interno mediante Shadow DOM y design tokens.
+
+```html
+<div class="mx-auto flex w-full max-w-md flex-col gap-4 p-6">
+  <moni-tab label="Ejemplo">Resumen</moni-tab>
+</div>
+```
+
+No necesitas un plugin de Tailwind. En tu CSS v4 importa ambas capas una sola vez:
+
+```css
+@import "tailwindcss";
+@import "@moni-labs/moni-ui/styles";
+
+@theme {
+  --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;
+}
+```
+
+Las utilities aplicadas directamente al tag afectan su caja anfitriona. No uses selectores Tailwind para asumir acceso al DOM interno; personaliza únicamente con los CSS Parts y Custom Properties públicos enumerados más abajo.
+
+## Recomendaciones
+
+- Usa `moni-tab` para su propósito semántico; no lo sustituyas por un `div` estilizado.
+- Aplica Tailwind al layout exterior. Para el interior del Shadow DOM usa las variables CSS y `::part()` documentados.
+- Cuando el control muestre únicamente un icono, añade siempre un `aria-label` descriptivo.
+- Mantén el estado de apertura en una única fuente de verdad y devuelve el foco al disparador al cerrar.
+- Prueba los estados claro, oscuro, foco por teclado, deshabilitado y viewport móvil antes de publicar.
+
+## Propiedades y atributos
+
+| Atributo | Propiedad | Tipo | Default | Descripción |
+|---|---|---|---|---|
+| `active` | `active` | `boolean` | `false` | Indica si el elemento está activo. |
+| `icon` | `icon` | `string` | `''` | Nombre de Material Symbol mostrado por el componente. |
+| `label` | `label` | `string` | `''` | Etiqueta visible y accesible del control. |
+| `href` | `href` | `string` | `'#'` | Define `href`. Conserva el tipo indicado y usa la propiedad JavaScript cuando el valor no sea una cadena. |
+
+## Slots
+
+Este componente no declara slots públicos.
+
+## Eventos
+
+No declara eventos propios.
+
+## Métodos públicos
+
+No expone métodos públicos adicionales.
+
+## CSS Parts
+
+- `tab`: Parte interna personalizable.
+- `icon`: Parte interna personalizable.
+- `label`: Parte interna personalizable.
+
+## CSS Custom Properties consumidas
+
+- `--font`
+- `--on-surface-variant`
+- `--primary`
+- `--speed2`
+
+## Referencia visual por variable
+
+Cada imagen se genera con el componente real: cambia solo la variable indicada y mantiene estable el resto del escenario. Úsala para comparar estados, no como sustituto de la API.
+
+### `active`
+
+Indica si el elemento está activo.
+
+![moni-tab — active=false](../assets/moni-tab/active--false.png)
+
+![moni-tab — active=true](../assets/moni-tab/active--true.png)
+
+### `icon`
+
+Nombre de Material Symbol mostrado por el componente.
+
+![moni-tab — icon=default](../assets/moni-tab/icon--default.png)
+
+### `label`
+
+Etiqueta visible y accesible del control.
+
+![moni-tab — label=default](../assets/moni-tab/label--default.png)
+
+### `href`
+
+Define `href`. Conserva el tipo indicado y usa la propiedad JavaScript cuando el valor no sea una cadena.
+
+![moni-tab — href=default](../assets/moni-tab/href--default.png)

package/docs/components/tabs.md

@@ -0,0 +1,163 @@
+# Tabs
+
+Componente Material Design 3 Tabs container (Contenedor de pestañas).
+
+Un contenedor de navegación que agrupa múltiples elementos `<moni-tab>`. Las pestañas
+organizan el contenido en categorías de alto nivel y permiten al usuario alternar
+entre ellas.
+
+**Referencia a la especificación M3:** `m3-docs/components/tabs/specs.md`
+
+**Modos (Primario vs Secundario):**
+- `primary` (por defecto): Usado para navegación de nivel superior en la jerarquía más alta,
+  a menudo colocado directamente debajo de una barra de aplicación superior (top app bar).
+  Abarcan todo el ancho y presentan un indicador activo prominente.
+- `secondary`: Usado para jerarquías de contenido más profundas dentro de un área
+  o página específica. Típicamente son más sutiles.
+
+**Diseño y alineación:**
+- `scrollable`: Si el número de pestañas excede el ancho del contenedor, esto
+  habilita el desplazamiento horizontal (`overflow-x: auto`) en lugar de aplastarlas.
+- `align`: Controla cómo se distribuyen las pestañas (`default` space-around,
+  `left`, `center`, o `right`).
+- `vertical`: Apila el icono sobre la etiqueta de texto dentro de las pestañas hijas.
+
+**Indicador Activo:**
+El atributo `indicator-size` permite personalizar el ancho del
+indicador de subrayado activo (`default` se ajusta al contenido de la pestaña, `min` es estrecho, `max`
+llena todo el ancho de la pestaña).
+
+- Tag: `moni-tabs`
+- Clase: `MoniTabs`
+- Fuente: `src/components/moni-tabs.ts`
+
+## Cuándo usarlo
+
+Usa `moni-tabs` cuando la interfaz necesite el patrón que describe este componente. Antes de elegirlo, revisa sus estados, contenido permitido y comportamiento accesible; las capturas del final muestran el resultado real de cada variante.
+
+## Uso básico
+
+```html
+<!-- Pestañas primarias, con desplazamiento (scrollable) -->
+<moni-tabs scrollable>
+  <moni-tab active label="Vuelos"></moni-tab>
+  <moni-tab label="Viajes"></moni-tab>
+  <moni-tab label="Explorar"></moni-tab>
+</moni-tabs>
+
+<!-- Pestañas secundarias, centradas con diseño vertical -->
+<moni-tabs mode="secondary" align="center" vertical>
+  <moni-tab active icon="video_camera_front" label="Video"></moni-tab>
+  <moni-tab icon="photo_camera" label="Foto"></moni-tab>
+</moni-tabs>
+```
+
+## Ejemplo práctico con Tailwind CSS v4
+
+Tailwind controla composición, ancho, espaciado y responsividad alrededor del Web Component. Moni UI conserva el aspecto interno mediante Shadow DOM y design tokens.
+
+```html
+<div class="mx-auto flex w-full max-w-md flex-col gap-4 p-6">
+  <moni-tabs></moni-tabs>
+</div>
+```
+
+No necesitas un plugin de Tailwind. En tu CSS v4 importa ambas capas una sola vez:
+
+```css
+@import "tailwindcss";
+@import "@moni-labs/moni-ui/styles";
+
+@theme {
+  --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;
+}
+```
+
+Las utilities aplicadas directamente al tag afectan su caja anfitriona. No uses selectores Tailwind para asumir acceso al DOM interno; personaliza únicamente con los CSS Parts y Custom Properties públicos enumerados más abajo.
+
+## Recomendaciones
+
+- Usa `moni-tabs` para su propósito semántico; no lo sustituyas por un `div` estilizado.
+- Aplica Tailwind al layout exterior. Para el interior del Shadow DOM usa las variables CSS y `::part()` documentados.
+- Prueba los estados claro, oscuro, foco por teclado, deshabilitado y viewport móvil antes de publicar.
+
+## Propiedades y atributos
+
+| Atributo | Propiedad | Tipo | Default | Descripción |
+|---|---|---|---|---|
+| `mode` | `mode` | `'primary' \| 'secondary'` | `'primary'` | Selecciona el valor de `mode` entre las opciones documentadas. |
+| `scrollable` | `scrollable` | `boolean` | `false` | Activa o desactiva el comportamiento `scrollable`. En HTML, la presencia del atributo significa `true`; omítelo para `false`. |
+| `vertical` | `vertical` | `boolean` | `false` | Activa o desactiva el comportamiento `vertical`. En HTML, la presencia del atributo significa `true`; omítelo para `false`. |
+| `align` | `align` | `'default' \| 'left' \| 'center' \| 'right'` | `'default'` | Selecciona el valor de `align` entre las opciones documentadas. |
+| `indicator-size` | `indicatorSize` | `'default' \| 'min' \| 'max'` | `'default'` | Selecciona el valor de `indicatorSize` entre las opciones documentadas. |
+
+## Slots
+
+- `default`: Elementos hijos `<moni-tab>`.
+
+## Eventos
+
+No declara eventos propios.
+
+## Métodos públicos
+
+No expone métodos públicos adicionales.
+
+## CSS Parts
+
+- `tabs`: Parte interna personalizable.
+
+## CSS Custom Properties consumidas
+
+- `--font`
+- `--surface-variant`
+
+## Referencia visual por variable
+
+Cada imagen se genera con el componente real: cambia solo la variable indicada y mantiene estable el resto del escenario. Úsala para comparar estados, no como sustituto de la API.
+
+### `mode`
+
+Selecciona el valor de `mode` entre las opciones documentadas.
+
+![moni-tabs — mode=primary](../assets/moni-tabs/mode--primary.png)
+
+![moni-tabs — mode=secondary](../assets/moni-tabs/mode--secondary.png)
+
+### `scrollable`
+
+Activa o desactiva el comportamiento `scrollable`. En HTML, la presencia del atributo significa `true`; omítelo para `false`.
+
+![moni-tabs — scrollable=false](../assets/moni-tabs/scrollable--false.png)
+
+![moni-tabs — scrollable=true](../assets/moni-tabs/scrollable--true.png)
+
+### `vertical`
+
+Activa o desactiva el comportamiento `vertical`. En HTML, la presencia del atributo significa `true`; omítelo para `false`.
+
+![moni-tabs — vertical=false](../assets/moni-tabs/vertical--false.png)
+
+![moni-tabs — vertical=true](../assets/moni-tabs/vertical--true.png)
+
+### `align`
+
+Selecciona el valor de `align` entre las opciones documentadas.
+
+![moni-tabs — align=default](../assets/moni-tabs/align--default.png)
+
+![moni-tabs — align=left](../assets/moni-tabs/align--left.png)
+
+![moni-tabs — align=center](../assets/moni-tabs/align--center.png)
+
+![moni-tabs — align=right](../assets/moni-tabs/align--right.png)
+
+### `indicator-size`
+
+Selecciona el valor de `indicatorSize` entre las opciones documentadas.
+
+![moni-tabs — indicator-size=default](../assets/moni-tabs/indicatorSize--default.png)
+
+![moni-tabs — indicator-size=min](../assets/moni-tabs/indicatorSize--min.png)
+
+![moni-tabs — indicator-size=max](../assets/moni-tabs/indicatorSize--max.png)

package/docs/components/text-field.md

@@ -0,0 +1,321 @@
+# Text Field
+
+Componente Material Design 3 Text Field (Campo de texto).
+
+Un campo de entrada con todas las funciones que envuelve un `<input>` nativo dentro de la
+estructura de campo M3 (clase `.field` de `fieldStyles`). Soporta etiquetas flotantes,
+variantes llenas (filled) y contorneadas (outlined), iconos iniciales/finales (leading/trailing),
+texto de ayuda y estados de error.
+
+**Referencia a la especificación M3:** `m3-docs/components/text-fields/specs.md`
+
+**Arquitectura visual:**
+Utiliza `fieldStyles` para toda la estructura CSS del campo. El contenedor del campo
+es un `<div class="field [modifiers]">` que envuelve:
+1. Icono inicial (leading) opcional.
+2. Elemento `<input>` nativo.
+3. `<label>` flotante (cuando se establece `label`).
+4. Icono final (trailing) opcional o indicador de carga (spinner).
+5. `<output>` para texto de ayuda/error.
+
+**Sincronización de eventos:**
+Emite `moni-input` en cada tipeo y `moni-change` al consolidar el valor (blur/enter).
+El valor interno del componente (`this.value`) se mantiene sincronizado automáticamente.
+
+- Tag: `moni-text-field`
+- Clase: `MoniTextField`
+- Fuente: `src/components/moni-text-field.ts`
+
+## Cuándo usarlo
+
+Usa `moni-text-field` cuando la interfaz necesite el patrón que describe este componente. Antes de elegirlo, revisa sus estados, contenido permitido y comportamiento accesible; las capturas del final muestran el resultado real de cada variante.
+
+## Uso básico
+
+```html
+<moni-text-field
+  label="Dirección de correo"
+  type="email"
+  name="email"
+  icon="mail"
+  variant="outlined"
+  helper="Nunca compartiremos tu correo."
+></moni-text-field>
+
+<moni-text-field
+  label="Monto"
+  type="number"
+  prefix="$"
+  error
+  error-text="El valor debe ser positivo"
+></moni-text-field>
+```
+
+## Ejemplo práctico con Tailwind CSS v4
+
+Tailwind controla composición, ancho, espaciado y responsividad alrededor del Web Component. Moni UI conserva el aspecto interno mediante Shadow DOM y design tokens.
+
+```html
+<div class="mx-auto flex w-full max-w-md flex-col gap-4 p-6">
+  <moni-text-field label="Ejemplo"></moni-text-field>
+</div>
+```
+
+No necesitas un plugin de Tailwind. En tu CSS v4 importa ambas capas una sola vez:
+
+```css
+@import "tailwindcss";
+@import "@moni-labs/moni-ui/styles";
+
+@theme {
+  --font-sans: Inter, ui-sans-serif, system-ui, sans-serif;
+}
+```
+
+Las utilities aplicadas directamente al tag afectan su caja anfitriona. No uses selectores Tailwind para asumir acceso al DOM interno; personaliza únicamente con los CSS Parts y Custom Properties públicos enumerados más abajo.
+
+## Recomendaciones
+
+- Usa `moni-text-field` para su propósito semántico; no lo sustituyas por un `div` estilizado.
+- Aplica Tailwind al layout exterior. Para el interior del Shadow DOM usa las variables CSS y `::part()` documentados.
+- Durante una operación asíncrona combina el estado `loading` —si existe— con `disabled` para evitar envíos duplicados.
+- En formularios controlados, sincroniza la propiedad `value` y escucha el evento documentado; no dependas solo del atributo inicial.
+- Cuando el control muestre únicamente un icono, añade siempre un `aria-label` descriptivo.
+- Prueba los estados claro, oscuro, foco por teclado, deshabilitado y viewport móvil antes de publicar.
+
+## Propiedades y atributos
+
+| Atributo | Propiedad | Tipo | Default | Descripción |
+|---|---|---|---|---|
+| `name` | `name` | `string` | `''` | El nombre del input, enviado con los datos del formulario. |
+| `label` | `label` | `string` | `''` | El texto de la etiqueta flotante. |
+| `variant` | `variant` | `'filled' \| 'outlined' \| 'underlined'` | `'filled'` | Variante visual del campo de texto. |
+| `size` | `size` | `'small' \| 'medium' \| 'large' \| 'extra'` | `'medium'` | Define las dimensiones del campo de texto. |
+| `shape` | `shape` | `'round' \| 'no-round'` | `'no-round'` | Forma del radio del borde (border-radius) del campo. |
+| `type` | `type` | `'text' \| 'password' \| 'email' \| 'number' \| 'tel' \| 'url' \| 'search'` | `'text'` | El tipo de input HTML nativo. |
+| `icon` | `icon` | `string` | `''` | Nombre del icono inicial (leading) (Material Symbols). |
+| `trailing-icon` | `trailingIcon` | `string` | `''` | Nombre del icono final (trailing) (Material Symbols). |
+| `prefix` | `prefix` | `string` | `''` | Prefijo de texto corto mostrado antes del valor del input. |
+| `suffix` | `suffix` | `string` | `''` | Sufijo de texto corto mostrado después del valor del input. |
+| `suffix-button-icon` | `suffixButtonIcon` | `string` | `''` | Icono del botón interactivo ubicado al final del campo. |
+| `suffix-button-label` | `suffixButtonLabel` | `string` | `'Acción del campo'` | Etiqueta accesible del botón suffix. |
+| `helper` | `helper` | `string` | `''` | Texto de ayuda mostrado debajo del campo. |
+| `error-text` | `errorText` | `string` | `''` | Texto de error mostrado debajo del campo cuando `error` es true. Sobrescribe el texto de ayuda. |
+| `error` | `error` | `boolean` | `false` | Si es true, establece el campo en un estado de error. |
+| `loading` | `loading` | `boolean` | `false` | Si es true, muestra un indicador de carga (progreso lineal/circular) al final. |
+| `disabled` | `disabled` | `boolean` | `false` | Deshabilita el campo de texto. |
+| `value` | `value` | `string` | `''` | El valor actual del input. |
+| `placeholder` | `placeholder` | `string` | `''` | Texto de marcador de posición (placeholder) mostrado cuando el input está vacío y la etiqueta es flotante. |
+| `mask` | `mask` | `string` | `''` | Patrón Inputmask. Admite opcionales `[]`, grupos `()`, alternadores `\|`, cuantificadores `{n,m}` y los tokens `9`, `a`, `*` y `K` (RUT). |
+| `mask-alias` | `maskAlias` | `string` | `''` | Alias integrado de Inputmask, por ejemplo `email`, `datetime`, `numeric`, `currency` o `ip`. |
+| `mask-options` | `maskOptions` | `InputmaskOptions` | `{}` | Opciones avanzadas de Inputmask. También acepta JSON mediante el atributo `mask-options`. |
+
+## Slots
+
+Este componente no declara slots públicos.
+
+## Eventos
+
+- `suffix-click`: evento compuesto y burbujeante emitido por el componente.
+
+## Métodos públicos
+
+- `maskOption(name: string): unknown;` — Lee o actualiza opciones de la instancia activa.
+- `maskOption(options: InputmaskOptions, noRemask?: boolean): InputmaskInstance | undefined;` — Método público maskOption.
+- `maskOption(nameOrOptions: string | InputmaskOptions, noRemask = false): unknown` — Método público maskOption.
+- `getEmptyMask(): string` — Método público getEmptyMask.
+- `hasMaskedValue(): boolean` — Método público hasMaskedValue.
+- `isMaskComplete(): boolean` — Método público isMaskComplete.
+- `isMaskValid(value?: string): boolean` — Método público isMaskValid.
+- `getMaskMetadata(): unknown` — Método público getMaskMetadata.
+- `formatWithMask(value: string, metadata = false): string |` — Método público formatWithMask.
+- `setMaskedValue(value: string): void` — Método público setMaskedValue.
+- `removeMask(): void` — Método público removeMask.
+
+## CSS Parts
+
+- `field`: Parte interna personalizable.
+- `input`: Parte interna personalizable.
+- `label`: Parte interna personalizable.
+- `helper`: Parte interna personalizable.
+- `error-output`: El elemento `<output>` de error.
+- `leading-icon`: Parte interna personalizable.
+- `prefix`: Parte interna personalizable.
+- `suffix`: Parte interna personalizable.
+- `suffix-action`: Parte interna personalizable.
+- `suffix-button`: Parte interna personalizable.
+- `trailing-icon`: Parte interna personalizable.
+
+## CSS Custom Properties consumidas
+
+- `--_middle`
+- `--on-surface-variant`
+- `--primary`
+
+## Referencia visual por variable
+
+Cada imagen se genera con el componente real: cambia solo la variable indicada y mantiene estable el resto del escenario. Úsala para comparar estados, no como sustituto de la API.
+
+### `name`
+
+El nombre del input, enviado con los datos del formulario.
+
+![moni-text-field — name=default](../assets/moni-text-field/name--default.png)
+
+### `label`
+
+El texto de la etiqueta flotante.
+
+![moni-text-field — label=default](../assets/moni-text-field/label--default.png)
+
+### `variant`
+
+Variante visual del campo de texto.
+
+![moni-text-field — variant=filled](../assets/moni-text-field/variant--filled.png)
+
+![moni-text-field — variant=outlined](../assets/moni-text-field/variant--outlined.png)
+
+![moni-text-field — variant=underlined](../assets/moni-text-field/variant--underlined.png)
+
+### `size`
+
+Define las dimensiones del campo de texto.
+
+![moni-text-field — size=small](../assets/moni-text-field/size--small.png)
+
+![moni-text-field — size=medium](../assets/moni-text-field/size--medium.png)
+
+![moni-text-field — size=large](../assets/moni-text-field/size--large.png)
+
+![moni-text-field — size=extra](../assets/moni-text-field/size--extra.png)
+
+### `shape`
+
+Forma del radio del borde (border-radius) del campo.
+
+![moni-text-field — shape=round](../assets/moni-text-field/shape--round.png)
+
+![moni-text-field — shape=no-round](../assets/moni-text-field/shape--no-round.png)
+
+### `type`
+
+El tipo de input HTML nativo.
+
+![moni-text-field — type=text](../assets/moni-text-field/type--text.png)
+
+![moni-text-field — type=password](../assets/moni-text-field/type--password.png)
+
+![moni-text-field — type=email](../assets/moni-text-field/type--email.png)
+
+![moni-text-field — type=number](../assets/moni-text-field/type--number.png)
+
+![moni-text-field — type=tel](../assets/moni-text-field/type--tel.png)
+
+![moni-text-field — type=url](../assets/moni-text-field/type--url.png)
+
+![moni-text-field — type=search](../assets/moni-text-field/type--search.png)
+
+### `icon`
+
+Nombre del icono inicial (leading) (Material Symbols).
+
+![moni-text-field — icon=default](../assets/moni-text-field/icon--default.png)
+
+### `trailing-icon`
+
+Nombre del icono final (trailing) (Material Symbols).
+
+![moni-text-field — trailing-icon=default](../assets/moni-text-field/trailingIcon--default.png)
+
+### `prefix`
+
+Prefijo de texto corto mostrado antes del valor del input.
+
+![moni-text-field — prefix=default](../assets/moni-text-field/prefix--default.png)
+
+### `suffix`
+
+Sufijo de texto corto mostrado después del valor del input.
+
+![moni-text-field — suffix=default](../assets/moni-text-field/suffix--default.png)
+
+### `suffix-button-icon`
+
+Icono del botón interactivo ubicado al final del campo.
+
+![moni-text-field — suffix-button-icon=default](../assets/moni-text-field/suffixButtonIcon--default.png)
+
+### `suffix-button-label`
+
+Etiqueta accesible del botón suffix.
+
+![moni-text-field — suffix-button-label=default](../assets/moni-text-field/suffixButtonLabel--default.png)
+
+### `helper`
+
+Texto de ayuda mostrado debajo del campo.
+
+![moni-text-field — helper=default](../assets/moni-text-field/helper--default.png)
+
+### `error-text`
+
+Texto de error mostrado debajo del campo cuando `error` es true.
+Sobrescribe el texto de ayuda.
+
+![moni-text-field — error-text=default](../assets/moni-text-field/errorText--default.png)
+
+### `error`
+
+Si es true, establece el campo en un estado de error.
+
+![moni-text-field — error=false](../assets/moni-text-field/error--false.png)
+
+![moni-text-field — error=true](../assets/moni-text-field/error--true.png)
+
+### `loading`
+
+Si es true, muestra un indicador de carga (progreso lineal/circular) al final.
+
+![moni-text-field — loading=false](../assets/moni-text-field/loading--false.png)
+
+![moni-text-field — loading=true](../assets/moni-text-field/loading--true.png)
+
+### `disabled`
+
+Deshabilita el campo de texto.
+
+![moni-text-field — disabled=false](../assets/moni-text-field/disabled--false.png)
+
+![moni-text-field — disabled=true](../assets/moni-text-field/disabled--true.png)
+
+### `value`
+
+El valor actual del input.
+
+![moni-text-field — value=default](../assets/moni-text-field/value--default.png)
+
+### `placeholder`
+
+Texto de marcador de posición (placeholder) mostrado cuando el input está vacío y la etiqueta es flotante.
+
+![moni-text-field — placeholder=default](../assets/moni-text-field/placeholder--default.png)
+
+### `mask`
+
+Patrón Inputmask. Admite opcionales `[]`, grupos `()`, alternadores `|`,
+cuantificadores `{n,m}` y los tokens `9`, `a`, `*` y `K` (RUT).
+
+![moni-text-field — mask=default](../assets/moni-text-field/mask--default.png)
+
+### `mask-alias`
+
+Alias integrado de Inputmask, por ejemplo `email`, `datetime`, `numeric`, `currency` o `ip`.
+
+![moni-text-field — mask-alias=default](../assets/moni-text-field/maskAlias--default.png)
+
+### `mask-options`
+
+Opciones avanzadas de Inputmask. También acepta JSON mediante el atributo `mask-options`.
+
+![moni-text-field — mask-options=default](../assets/moni-text-field/maskOptions--default.png)