# AstrolUI — Guía de migración del refactor .NET 10

> **Para IA / agentes:** este documento es la fuente de verdad para migrar un proyecto que usa
> paquetes `Astrol.*` a la versión refactorizada. Cada cambio tiene un **ID estable** (`M-xxx`),
> un patrón de **detección** (regex o búsqueda literal), la **acción** a aplicar y un ejemplo
> **antes / después**. Aplica los cambios en orden de ID. Si un patrón no aparece en el proyecto,
> el cambio no aplica. No renombres clases de iconos `astrol-*`: se conservan todas.
>
> **Para humanos:** también sirve como base para documentar las novedades en
> `Astrol.Web.UI.Docuemnt`. La sección "Notas para la documentación" de cada cambio indica qué
> página del documentador hay que tocar.

## Convenciones

- Versionado de paquetes: `<versión .NET>.<consecutivo>` → con .NET 10.0.8 los paquetes eran `10.0.8.N`; desde el
  2026-10-24 todo AstrolUI usa .NET **10.0.13** y los paquetes son `10.0.13.N` (ver V-025).
- Ámbito: `[Assets]` = rutas CSS/JS en `index.html` / `App.razor` / `_Host.cshtml`;
  `[API]` = código C#/Razor; `[Visual]` = cambia el aspecto sin romper compilación;
  `[Interno]` = no requiere acción del consumidor.
- Severidad: **Rompe** (no compila o falla en runtime) · **Visual** (se ve distinto) · **Ninguna**.

## Versiones

El refactor se desarrolla en la rama `AI-NET-10` y **no se publica por partes**: cuando esté
pulido se publicará una única primera versión del refactor con todos los paquetes a la vez.
Hasta entonces, la última versión publicada de cada paquete es la previa al refactor:

| Paquete | Última publicada (pre-refactor) | Afectado por el refactor |
|---|---|---|
| Astrol.Entities.Basic | 10.0.8.2 | sí |
| Astrol.JSInterop.Base | 10.0.8.1 | sí |
| Astrol.Component.Basic | 10.0.8.7 | sí |
| Astrol.Component.RichText | 10.0.8.1 | sí (assets de Quill) |
| Astrol.Component.Board | 10.0.8.1 | sí (interact.js) |

---

## Lote 1 — Base y dieta de assets (Fase 0 + Fase 1)

Resultado medido en el documentador: el CSS de Basic pasa de ~220 KB en 4 peticiones
encadenadas (`@import`) a **1 fichero de 62 KB (12 KB gzip)**; interact.js (126 KB) y Quill
(260 KB) dejan de formar parte de Basic.

### M-001 · Bootstrap ya no se incluye en `astrol-basic.min.css` — [Assets][Visual] · Severidad: Visual

`astrol-basic.css` importaba `bootstrap.min.css` (159 KB). Se elimina y se sustituye por un
*reboot* mínimo propio (box-sizing, márgenes de títulos/párrafos, herencia de fuente en controles,
cursor en botones…).

**Detección** (clases de bootstrap en el proyecto consumidor):

```regex
class="[^"]*\b(container(-fluid)?|row|col(-(sm|md|lg|xl|xxl))?(-\d+)?|btn(-[a-z]+)*|form-(control|select|check|label)[a-z-]*|input-group[a-z-]*|d-(none|flex|block|inline[a-z-]*)|justify-content-[a-z]+|align-items-[a-z]+|m[trblxy]?-[0-5]|p[trblxy]?-[0-5]|w-(25|50|75|100)|h-100|text-(center|start|end|muted)|card[a-z-]*|table[a-z-]*|alert[a-z-]*|badge|navbar[a-z-]*|g-[0-5])\b
```

**Acción:**
- Si el proyecto **usa bootstrap de forma extensa**, añade bootstrap tú mismo antes de AstrolUI:
  ```html
  <link href="css/bootstrap/bootstrap.min.css" rel="stylesheet" />
  <link href="_content/Astrol.Component.Basic/css/astrol-basic.min.css" rel="stylesheet" />
  ```
- Si solo usa **unas pocas utilidades**, defínelas en el `app.css` del proyecto. Ejemplo usado en
  el documentador:
  ```css
  .w-100 { width: 100%; }
  ```
- Utilidades equivalentes que **sí** trae AstrolUI: `.w-1` … `.w-10` (10 %…100 %), `.fl`, `.fr`,
  `.tac`, `.tal`, `.tar`, `.to-upper`.

**Notas para la documentación:** página *Basic components › Installation*: indicar que AstrolUI no
depende de bootstrap.

---

### M-002 · interact.js sale de Basic — [Assets] · Severidad: Rompe (404 si se sigue referenciando)

Basic ya no usa interact.js: arrastrar y redimensionar modales/confirm y redimensionar columnas
del Grid se hace con Pointer Events nativos dentro de `Astrol.JSInterop.Base`. El fichero se movió
a `Astrol.Component.Board`, que sí lo necesita.

**Detección:**

```text
_content/Astrol.Component.Basic/js/interact.min.js
_content/Astrol.Component.Basic/js/interact.js
```

**Acción:**
- Proyecto **sin** `Astrol.Component.Board` → **elimina** la etiqueta `<script>`.
- Proyecto **con** `Astrol.Component.Board` → cambia la ruta:

```html
<!-- antes -->
<script src="_content/Astrol.Component.Basic/js/interact.min.js"></script>
<!-- después (solo si usas AstrolBoard) -->
<script src="_content/Astrol.Component.Board/js/interact.min.js"></script>
```

**Notas para la documentación:** *Basic › Installation* y *Charts › Installation* ya no muestran el
paso de interact.js (hecho). *Board › Example* ya muestra la nueva ruta (hecho).

---

### M-003 · Assets de Quill (RichText) se mueven a `Astrol.Component.RichText` — [Assets] · Severidad: Rompe

**Detección:**

```text
_content/Astrol.Component.Basic/js/astrol-rich-text
_content/Astrol.Component.Basic/css/astrol-rich-text
```

**Acción:** sustituir el prefijo `_content/Astrol.Component.Basic/` por
`_content/Astrol.Component.RichText/` en esas dos rutas.

```html
<!-- antes -->
<link href="_content/Astrol.Component.Basic/css/astrol-rich-text.min.css" rel="stylesheet" />
<script src="_content/Astrol.Component.Basic/js/astrol-rich-text.min.js"></script>
<!-- después -->
<link href="_content/Astrol.Component.RichText/css/astrol-rich-text.min.css" rel="stylesheet" />
<script src="_content/Astrol.Component.RichText/js/astrol-rich-text.min.js"></script>
```

Si el proyecto **no usa** `AstrolRichText`, elimina ambas etiquetas.

**Notas para la documentación:** *Rich text › Installation* ya muestra las rutas nuevas (hecho).

---

### M-004 · Fuente de iconos: solo WOFF2 y un único CSS — [Assets] · Severidad: Rompe solo si se referencian los ficheros eliminados

Se conservan **todos los nombres** de iconos (`astrol-*`, 1034 iconos). Se eliminan formatos y
variantes obsoletas: `fontello.eot`, `.ttf`, `.svg`, `.woff`, `fontello-codes.min.css`,
`fontello-embedded.min.css`, `fontello-ie7.min.css`, `fontello-ie7-codes.min.css`.
La `@font-face` usa ahora `font-display: block` (no muestra glifos falsos mientras carga).

**Detección:**

```regex
_content/Astrol\.Component\.Basic/fontello/(font/fontello\.(eot|ttf|svg|woff)\b|css/fontello-(codes|embedded|ie7|ie7-codes)\.min\.css)
```

**Acción:** elimina esas referencias. Los iconos ya vienen dentro de `astrol-basic.min.css`
(ver M-005). Si solo quieres los iconos sin el resto de estilos, usa
`_content/Astrol.Component.Basic/fontello/css/fontello.min.css`.

---

### M-005 · `astrol-basic.min.css` ahora incluye iconos y animación (sin `@import`) — [Assets] · Severidad: Ninguna (recomendado limpiar)

Antes `astrol-basic.min.css` hacía `@import` de bootstrap, fontello y animation (cadena de
peticiones que bloquea el render). Ahora es un único fichero que ya contiene
`fontello.min.css` y `animation.min.css`. El fichero fuente sin minificar
(`css/astrol-basic.css`) deja de publicarse en el paquete.

**Detección:**

```text
_content/Astrol.Component.Basic/fontello/css/fontello.min.css
_content/Astrol.Component.Basic/fontello/css/animation.min.css
_content/Astrol.Component.Basic/css/astrol-basic.css
```

**Acción:** si el proyecto ya enlaza `astrol-basic.min.css`, elimina los enlaces a
`fontello.min.css` y `animation.min.css` (estarían duplicados). Cambia `astrol-basic.css` por
`astrol-basic.min.css`.

---

### M-006 · Arrastrar / redimensionar nativo — [Interno][Visual] · Severidad: Ninguna

`AstrolJSInterop.DragAndDropModal`, `DragAndDropConfirm`, `Resizable`, `ResizableColumn` y
`RestoreTranslateByClassName` mantienen su firma. Cambios de comportamiento:
- El arrastre empieza tras mover 3 px (un clic simple ya no se interpreta como arrastre).
- Al soltar, el elemento se reajusta para quedar dentro de su contenedor.
- Arrastrar no selecciona texto y soltar fuera del modal ya no lo cierra.
- Al redimensionar un modal también se ajusta su `max-width`, así que ahora puede crecer por encima
  del ancho de su clase (`m-short`, `m-middle`…).
- Durante la interacción el elemento recibe las clases `aui-dragging` / `aui-resizing`
  (útiles para estilos).

---

### M-007 · `AuxiliarIcon` compacto — [API] · Severidad: Ninguna

`Astrol.Entities.Basic.Static.AuxiliarIcon.GetIconList()` y `GetOnlyClassIconArray()` devuelven
exactamente los mismos datos y en el mismo orden. El código fuente pasa de 175 KB a 20 KB y la DLL
de `Astrol.Entities.Basic` pesa mucho menos. Novedades: `AuxiliarIcon.Count` y
`AuxiliarIcon.Prefix` (`"astrol-"`).

---

### M-008 · Dependencias entre paquetes — [Interno] · Severidad: Ninguna

Las librerías de la solución se referencian ahora con `ProjectReference`; al empaquetar se
convierten en dependencias NuGet con la versión exacta de cada proyecto. Un proyecto consumidor
solo necesita referenciar el paquete de más alto nivel que use (p. ej. `Astrol.Component.Basic`),
y recibe `Astrol.Entities.Basic` y `Astrol.JSInterop.Base` de forma transitiva.

**Acción opcional:** quitar las `PackageReference` explícitas a `Astrol.Entities.Basic` /
`Astrol.JSInterop.Base` si solo se añadieron por arrastre.

---

## Lote 2 — Interop bajo demanda y componentes nativos (Fase 2)

Resultado: el módulo JS común baja de 18 KB a **8 KB** y solo se descarga en la primera llamada a
`AstrolJSInterop`. Arrastrar/redimensionar (6 KB) y los módulos de Modal, ComboBox y RichText
se descargan únicamente cuando se usa el componente. La paginación ya no hace llamadas JS para
habilitar o deshabilitar sus botones, y el modal ya no cuenta elementos del DOM para calcular su
`z-index`.

### M-009 · Nuevo `GetColorContrast` — [API] · Severidad: Ninguna (novedad)

`Astrol.Entities.Basic.Static.Extensions.StringExtensions.GetColorContrast(this string? colorHex, string lightColor = "#ffffff", string darkColor = "#222222")`
devuelve el color de texto con mayor contraste **WCAG** sobre el fondo indicado.
- Acepta `#rgb`, `#rgba`, `#rrggbb`, `#rrggbbaa`, con o sin `#` (el alfa se ignora).
- Devuelve `null` si el color está vacío o no es válido (no lanza excepción).
- No usa `System.Drawing`: seguro en Blazor WebAssembly.

```csharp
"#ffd800".GetColorContrast();               // "#222222"
"#c10000".GetColorContrast();               // "#ffffff"
"#ffd800".GetColorContrast("#fafafa", "#000"); // "#000"
```

> Nota: al usar contraste WCAG real, algunos azules medios (p. ej. `#007bff`) devuelven el color
> oscuro, cuando una fórmula de brillo simple habría devuelto blanco.

**Notas para la documentación:** añadir a la página de utilidades/extensiones.

---

### M-010 · Miembros eliminados de `AstrolJSInterop` — [API] · Severidad: Rompe (no compila si se usan)

Se eliminan los métodos que eran detalles internos de un componente y ahora viven en su propio módulo:

| Eliminado | Sustituto |
|---|---|
| `CreateQuill`, `CreateQuillAsync`, `GetHTML`, `GetText`, `GetContent`, `LoadQuillContent(Async)`, `LoadQuillHTMLContent` / `LoadQuillHtmlContentAsync`, `InsertQuillText(Async)`, `InsertQuillImage(Async)`, `InsertQuillVideo(Async)`, `EnableQuillEditor(Async)` | Usar los métodos públicos del componente `AstrolRichText` |
| `MountComboBoxDropdown`, `UpdateComboBoxDropdownPosition`, `UnmountComboBoxDropdown` | Ninguno (lo gestiona `AstrolComboBox` internamente) |
| `EnableNavButton` | Ninguno (`AstrolPagination` renderiza el estado `disabled`) |
| `SetClassBySelector` | Ninguno (la función JS nunca existió; fallaba en tiempo de ejecución) |

**Detección:**

```regex
\.(CreateQuill|GetHTML|GetText|GetContent|LoadQuill\w*|InsertQuill\w*|EnableQuillEditor\w*|MountComboBoxDropdown|UpdateComboBoxDropdownPosition|UnmountComboBoxDropdown|EnableNavButton|SetClassBySelector)\s*\(
```

Solo aplica si la instancia es un `AstrolJSInterop` (suele llamarse `jsI`).

**Se mantienen** con la misma firma: `Notification`, `CopyToClipboard` (ahora usa la Clipboard API
con fallback), `IdleTimer`, `SaveAs`, `GetPasteFunctionReference`, `FocusElement`,
`CountElementExistToHTML`, `GetWidthBySelector`, `GetHeightBySelector`, `Prompt`, `SetInputValue`,
`ParentComboBox` (ya no acumula listeners), `RemoveAllOcurrencesSelectorID`, `AddIdByClase`,
`DragAndDropModal`, `DragAndDropConfirm`, `Resizable`, `ResizableColumn`,
`RestoreTranslateByClassName`. Las cinco últimas cargan el módulo `astrolInteractions` bajo demanda.

---

### M-011 · `Astrol.Component.RichText` ya no depende de `Astrol.JSInterop.Base` — [Interno] · Severidad: Ninguna

`AstrolRichText` usa su propio módulo (`BaseRichText.razor.js`) a través de `IJSRuntime`. Un
proyecto que **solo** use RichText ya no necesita registrar `AstrolJSInterop`. Las rutas de los
assets de Quill no cambian respecto a M-003.

---

### M-012 · Modal y Confirm usan `<dialog>` nativo — [Visual][Assets CSS] · Severidad: Visual / Rompe solo con CSS personalizado

`BaseModal` (y por tanto `AstrolModal`, `AstrolConfirm` y `AstrolUploadFile`) se abre con
`dialog.showModal()`. Mismos parámetros y mismo aspecto. Mejoras:
- Capa superior nativa: siempre por encima de todo, sin `z-index` y sin interop para contar modales.
- El resto de la página queda inerte (no se puede tabular ni hacer clic detrás del modal).
- Esc cierra solo el modal superior (si `ClosedInteractive = true`).
- Al cerrar, el foco vuelve al elemento que abrió el modal.
- `AstrolButton Autofocus="true"` dentro de un modal recibe el foco al abrirse (p. ej. "Aceptar" en
  Confirm, de modo que Enter confirma).
- Accesible: el título del modal es el nombre (`aria-labelledby`) del diálogo.

**Cambios en el DOM / CSS** (solo afectan a quien personalizó estilos):

| Antes | Ahora |
|---|---|
| `<div class="all-modal ... modal-index-N" style="--modal-z-index:…">` | `<dialog class="all-modal …">` (sin `modal-index-N` ni `--modal-z-index`) |
| fondo oscuro = `background` de `.all-modal` | `.all-modal::backdrop` |
| `id="head-modal"` (repetido en cada modal) | `id` único en el título: `aui-modal-title-…` |
| `interactive-<guid>` en el contenido | eliminado |

**Detección:**

```regex
modal-index-\d|--modal-z-index|#head-modal|\.all-modal\s*\{[^}]*z-index
```

**Acción:** mover estilos del fondo a `.all-modal::backdrop`; eliminar reglas de `z-index` sobre
modales; sustituir `#head-modal` por `.head-astrol-modal`.

> Elementos propios con `z-index` alto (menús, toasts de terceros) ya **no** pueden quedar por
> encima de un modal abierto. Las notificaciones de AstrolUI sí: su contenedor es un popover que se
> trae al frente con cada notificación. Mientras haya un modal abierto la notificación se ve, pero
> su botón de cerrar no responde (el navegador deja inerte lo que está fuera del modal); se cierra
> sola al acabar su tiempo.

---

### M-013 · ComboBox: desplegable con Popover API — [Visual] · Severidad: Ninguna

El desplegable de `AstrolComboBox` tiene `popover="manual"`: se pinta en la capa superior sin
moverlo de su sitio en el DOM (antes se trasladaba a un `#astrol-portal-host` en `body`, lo que
podía desincronizar a Blazor). Mejoras:
- Funciona dentro de Grid, modales y contenedores con `overflow: hidden`.
- Se abre hacia arriba si no hay espacio debajo (clase `aui-open-up`).
- Ancho mínimo = ancho del input, pero crece con el contenido (útil en filtros de columnas estrechas)
  sin salirse de la ventana.
- Hereda las variables de tema del layout.

**Detección (CSS personalizado):** `#astrol-portal-host`, `combo-options-placeholder`,
`data-astrol-portal-mounted`. **Acción:** eliminar esas reglas.

---

### M-014 · Paginación con botones reales — [Visual][Accesibilidad] · Severidad: Ninguna / CSS personalizado

Los controles de `AstrolPagination` (primera, anterior, siguiente, última, refrescar) son
`<button type="button" class="page-link">` con `disabled` cuando no aplican, en lugar de `<a>`
habilitados/deshabilitados por JS. Se pueden usar con teclado y lectores de pantalla. El input de
página tiene un `id` único por instancia (antes `_pageInput`, repetido si había dos grids).

**Detección (CSS personalizado):** `.page-item a`, `.disable-astrol a`, `#_pageInput`.
**Acción:** usar `.page-item .page-link`, `.disable-astrol .page-link`, `.label-page + input`.

---

## Lote 3 — Grid, ComboBox y correcciones (Fase 3)

### M-015 · `AstrolGrid` / `Column` reescritos — [API][Visual] · Severidad: Rompe solo en casos concretos

Arquitectura nueva: las `Column` se **registran** en el grid y este pinta cabeceras y celdas
directamente (antes había un componente `Column` por cada celda). Además:
- **Sin clonado profundo**: antes se clonaba toda la lista (por reflexión) en cada render del padre;
  ahora se filtra/ordena/pagina sobre `Data` sin copiarla ni modificarla.
- **Sin reflexión por celda**: el acceso a propiedades se crea una vez por tipo (delegados directos).
- Filas con `@key` (si hay `KeySelector`), roles ARIA (`table/row/cell/columnheader`, `aria-sort`).
- La primera carga se hace tras el primer render (con las columnas y sus `DefaultValue` ya registrados).

**Compatibilidad de marcado:** el uso habitual **no cambia**. Dentro de `<Column>` el contenido
recibe la fila como `context`, igual que antes:

```razor
<AstrolGrid TItem="Client" Data="clients" PageSize="5">
    <Columns>
        <Column Name="@nameof(Client.Id)" Title="Id" Sortable="true">
            <span>@context.Id</span>
        </Column>
        <Column Name="@nameof(Client.FullName)" Title="Nombre" Filtrable="true" />
    </Columns>
</AstrolGrid>
```

**Rompe si:**

| Caso | Detección | Acción |
|---|---|---|
| `Context` en `<Columns>` | `<Columns\s+Context=` | Mover `Context="x"` a cada `<Column>` que use la fila |
| Usar la fila fuera de una `<Column>` (dentro de `<Columns>`) | revisar `<Columns>` | Mover ese contenido dentro de una `<Column>` |
| Parámetro `Load` del grid | `<AstrolGrid[^>]*\bLoad=` | Eliminar (el grid gestiona su indicador; `ShowLoad` lo oculta) |
| Clase `CustomComparer` | `CustomComparer` | Eliminada; el grid ordena valores `IComparable` y diccionarios internamente |
| CSS sobre `.cell-grid[id=…]` o `#<Id de columna>` | `cell-grid\[id=` | Usar `[data-aui-col="<Id>"]`; las celdas ya no repiten `id` |
| Asumir que el grid trabaja con una copia de los datos | — | Ya no hay copia: los cambios en los objetos se ven en el siguiente render; para cambios de la lista llama a `RefreshGrid()` o cambia `DataVersion` (igual que antes) |

`Data` pasa de `IList<TItem>` a `IEnumerable<TItem>` (compatible con `List<T>`).

**Novedades:**

| Parámetro | En | Descripción |
|---|---|---|
| `Field="x => x.Cliente.Nombre"` | `Column` | Alternativa tipada a `Name`; admite rutas anidadas (`Name="Cliente.Nombre"` también) |
| `Format="dd/MM/yyyy"` / `"N2"` | `Column` | Formato del valor cuando no hay contenido propio |
| `Virtualize`, `RowHeight`, `OverscanCount` | `AstrolGrid` | Solo se pintan las filas visibles (páginas grandes o "Todos") |
| `SelectAllText`, `SelectRowText` | `AstrolGrid` | Etiquetas accesibles de los checkbox de selección |
| `GridInfo`, `CurrentPageItems` | `AstrolGrid` (propiedades) | Página/orden/filtros actuales y filas visibles |
| `Id` | `Column` | Ahora opcional también para `Resizable` |

Otros cambios de comportamiento:
- Redimensionar una columna guarda el ancho en la variable CSS `--aui-w-<Id>` del grid: se mantiene
  al cambiar de página, ordenar o con virtualización.
- El filtro de fechas (`datetime-local`) ya encuentra coincidencias (antes comparaba con una "T").
- Seleccionar sin `KeySelector` usa la igualdad del propio objeto; con `KeySelector` la selección se
  conserva entre páginas y recargas (igual que antes).

**Notas para la documentación:** página *Basic › Grid*: añadir `Field`, `Format`, `Virtualize`;
explicar que `context` es la fila dentro de `Column`.

---

### M-016 · `AstrolComboBox`: `Display` tipado y `@bind-Value` — [API] · Severidad: Ninguna / Rompe si se usaba `List` explícito en código

```razor
@* antes *@
<AstrolComboBox TItem="Person" PropertyShow="@nameof(Person.Name)" DataList="people" OnChange="OnChange" />

@* ahora (recomendado) *@
<AstrolComboBox TItem="Person" Display="p => p.Name" DataList="people" @bind-Value="selected" />
```

- `Display` (`Func<TItem, string?>`): texto de cada opción sin reflexión. `PropertyShow` sigue
  funcionando (ya no es obligatorio; admite rutas "A.B").
- `Value` / `ValueChanged` (`@bind-Value`). `InitialValue` y `OnChange` se mantienen.
- `DataList` pasa a `IEnumerable<TItem>`.
- Rendimiento: el texto normalizado de cada opción se calcula una vez por lista (no en cada tecla);
  se eliminan los eventos `mouseover/mouseout` que provocaban un render por cada movimiento del ratón.
- Accesibilidad: `aria-controls`, `aria-autocomplete`, ids de opción únicos.
- `PropertyShowIsHtml`: solo para contenido de confianza (se inserta sin escapar).

**Notas para la documentación:** página *Form › ComboBox*: mostrar `Display` y `@bind-Value`.

---

### M-017 · Notificaciones en texto plano por defecto — [API][Seguridad] · Severidad: Visual

`Notification.AllowHtml` y el parámetro `allowHtml` de `NotificationError/Success/Warning/Info/None/Base`
pasan a **`false`** por defecto: el mensaje se muestra como texto (evita XSS, p. ej. con nombres de
archivo o datos del usuario). Los saltos de línea `\n` se respetan.

**Detección:** mensajes con etiquetas HTML:

```regex
(Notification\w*\(|Message\s*=)[^;]*<(b|br|i|strong|span|a)\b
```

**Acción:** sustituir `<br />` por `\n`, o pasar `allowHtml: true` / `AllowHtml = true` si el HTML es
de confianza.

---

### M-018 · `MenuItem.Name` en texto plano — [API][Seguridad] · Severidad: Visual

`AstrolItemMenu` renderizaba `MenuItem.Name` como HTML. Ahora es texto, salvo con `NameIsHtml = true`.

```csharp
new MenuItem { Name = "<b class='color-green'>PE</b><b>RENDER</b>", NameIsHtml = true, URL = "/perender" }
```

**Detección:** `Name\s*=\s*[$@]*"[^"]*<` en inicializadores de `MenuItem`.

---

### M-019 · Correcciones en `Astrol.Entities.Basic` — [API] · Severidad: revisar los marcados

| Miembro | Cambio |
|---|---|
| `long.ConvertByteToMB()` | **Ahora devuelve MB** (antes devolvía KB por error). Nuevo `ConvertBytesToKB()` para KB. Revisar usos: `ConvertByteToMB\(` |
| `string.FormatPhoneNumber()` | Los números de 6 y 7 dígitos ahora se formatean (antes se perdía el formato) |
| `DateString(..., format: "…")` | El parámetro `format` ahora se aplica (antes se ignoraba) |
| `int.GenerateRandomKey()` | Usa `RandomNumberGenerator` (criptográfico) |
| `IQueryable.SortList(...)` | Construye `x => x.Propiedad`: EF Core lo traduce a SQL (antes ordenaba en memoria o fallaba). Admite rutas "A.B", ignora mayúsculas y nueva sobrecarga `SortList(SortInfo?)` |
| `DeepClone()` | Mucho más rápido (antes llamaba a `TimeZoneInfo.GetSystemTimeZones()` por cada campo) |
| `string.Encrypt/Decrypt` | Sin cambios de formato; documentado que es **ofuscación**, no cifrado |

---

### M-020 · `AstrolUploadFile` / `AstrolUploadFileEmbedded` — [Interno][Visual] · Severidad: Ninguna

- La vista previa de imágenes usa una miniatura generada por el navegador (`RequestImageFileAsync`, 96 px)
  en lugar de leer la imagen completa en memoria y convertirla a base64.
- El input de archivo tiene un `id` único por instancia (antes `file-load`, repetido).
- Los errores de extensión/tamaño se muestran en texto plano (ver M-017).

---

## Lote 4 — Accesibilidad, idioma y temas (Fase 4)

### M-021 · Textos por defecto según el idioma (`AstrolText`) — [API] · Severidad: Visual

Los textos por defecto de los componentes estaban fijos y mezclados (español en unos, inglés en
otros). Ahora salen de `Astrol.Component.Basic.AstrolText` según `CultureInfo.CurrentUICulture`:
**inglés** por defecto y **español** para cualquier cultura `es-*`.

- Los parámetros de texto (`TextClose`, `TextAccept`, `TextCancel`, `NoSearchResultText`,
  `PagePaginationText`, `TextBrowse`, `UnAssignedTitle`, `IconAriaLabel`, …) pasan de tener un valor
  fijo a ser `string?` con valor `null` = "usar el texto del idioma". Si los pasas explícitamente,
  se respetan igual que antes.
- Para traducir a otro idioma o cambiar textos de forma global (p. ej. desde `IStringLocalizer`):

```csharp
// Program.cs
AstrolText.Resolver = (key, culture) => key switch
{
    "Close" => "Fermer",
    _ => null // null = texto incluido
};
```

Claves disponibles: `Close, Maximize, Restore, Accept, Cancel, NoResults, NoData, Page, Of, PageSize,
Items, All, FirstPage, PreviousPage, NextPage, LastPage, Refresh, SelectAll, SelectRow, ClearFilter,
Search, Assigned, Unassigned, AssignSelected, UnassignSelected, Exchange, UploadTitle, UploadBrowse,
FileName, FileSize, RemoveFile, Save, ErrorMaxFiles, ErrorExtension, ErrorTooBig, ShowHidePassword,
IconAction, ToggleMenu, DarkMode, LightMode, Loading`.

**Rompe si:** el proyecto dependía del texto por defecto en un idioma distinto al de su cultura
(p. ej. app en inglés que esperaba "Cancelar"). **Acción:** pasar el texto explícitamente o usar
`AstrolText.Resolver`.

> Blazor WebAssembly carga el recurso español (`es/Astrol.Component.Basic.resources.dll`) cuando la
> cultura de la app es española. Con `InvariantGlobalization=true` los textos salen en inglés.

---

### M-022 · Controles accesibles por teclado — [Visual][Accesibilidad][CSS] · Severidad: Ninguna / CSS personalizado

Elementos que eran `<div>` o `<i>` clicables (sin teclado ni lector de pantalla) ahora son controles
reales. Se ven igual (clase `aui-reset-button`, sin estilos de botón del navegador):

| Componente | Antes | Ahora |
|---|---|---|
| `BaseModal` (cerrar / maximizar) | `<i class="astrol-close-control-modal…">` | `<button class="aui-modal-control …" aria-label>` |
| `AstrolItemMenu` con `URL` | `<div @onclick>` + `NavigateTo` | `<a href>` (Ctrl+clic abre otra pestaña, `aria-current="page"`) |
| `AstrolItemMenu` sin `URL` (submenús) | `<div>` | `<button aria-expanded>` |
| `AstrolLayoutMenu` (plegar menú) | `<div id="cont-astrol-open">` | `<button id="cont-astrol-open" aria-expanded>` |
| `SetOutline` (claro/oscuro) | `<i class="icon-style-mode">` | `<button class="icon-style-mode" aria-label>` |
| `Column` ordenable | `<div class="col-info sortable">` | `<button class="col-info sortable">` |
| `Column` limpiar filtro | `<div class="icon-clear-filter">` | `<button class="icon-clear-filter" aria-label>` |
| `AstrolUploadFileEmbedded` quitar archivo | `<div class="cont-trash-info-file">` | `<button …>` (visible también con foco) |
| `AstrolAssign` | `<div>`/`<span>` clicables | mismos elementos con `role`, `tabindex` y Enter/Espacio |
| `AstrolPagination` | botones sin nombre | `aria-label`/`title` en cada botón, `<label for>` en los selectores |

Además: anillo de foco visible al navegar con teclado (`:focus-visible`, color del tema).

**Detección (CSS personalizado):**

```regex
\.head-astrol-modal\s+i\b|#cont-astrol-open|\.icon-style-mode|div\.col-info|div\.icon-clear-filter|\.astrol-menu-item-(primary|secundary)
```

**Acción:** cambiar selectores por elemento (`i`, `div`) por la clase (`.aui-modal-control`,
`.col-info`, …). Si estilas los elementos del menú, recuerda que ahora pueden ser `<a>` o `<button>`.

---

### M-023 · `prefers-reduced-motion` — [Visual] · Severidad: Ninguna

Si el sistema del usuario pide reducir el movimiento, AstrolUI desactiva animaciones y transiciones
decorativas (aparición de modales, hover con desplazamiento, etc.). Se mantienen los spinners de carga
y las notificaciones (su tiempo de vida usa la animación).

---

### M-024 · Temas con atributos `data-aui-color` / `data-aui-mode` — [CSS][Assets] · Severidad: Rompe solo sin `AstrolLayoutMenu`

El CSS de todas las librerías (Basic, Board, Charts, PDFViewer, RichText) usa ahora atributos en
lugar de las seis clases por modo:

| Antes | Ahora |
|---|---|
| `:is(.yellow-dark-mode, .red-dark-mode, … .purple-dark-mode)` | `[data-aui-mode="dark"]` |
| `:is(.yellow-white-mode, … .purple-white-mode)` | `[data-aui-mode="light"]` |
| `:is(.green-white-mode, .green-dark-mode)` | `[data-aui-color="green"]` |

`AstrolLayoutMenu` emite **ambas cosas** (la clase de siempre, p. ej. `green-dark-mode`, y los
atributos), así que el CSS propio de tus apps que use las clases sigue funcionando.

**Rompe si:** la app aplica el tema **sin** `AstrolLayoutMenu`, poniendo la clase a mano.

**Detección:**

```regex
class="[^"]*\b(yellow|red|green|blue|orange|purple)-(dark|white)-mode\b
```

**Acción:** añadir los atributos junto a la clase (o en `<html>` para que también se apliquen a lo
que está fuera del layout, como las notificaciones):

```html
<div class="green-dark-mode" data-aui-color="green" data-aui-mode="dark">…</div>
```

En C#: `AstrolTheme.Green.GetThemeColor()` → `"green"`; `StyleExtensions.GetThemeMode(outline)` →
`"light"`/`"dark"`.

**Notas para la documentación:** página *Theme* y `CONTRIBUTING.md` (convención de temas).

---

## Lote 5 — Modo automático, tema global y tests (Fase 5)

### M-025 · Modo de color Auto y tema aplicado en `<html>` — [API][Visual] · Severidad: Ninguna / Rompe si se usa `SetOutline` directamente

`AstrolLayoutMenu` gana:

| Parámetro | Descripción |
|---|---|
| `Mode` (`AstrolThemeMode?`: `Light`, `Dark`, `Auto`) | Tiene prioridad sobre `Outline`. `Auto` sigue `prefers-color-scheme` del sistema y cambia en vivo |
| `OnChangeThemeMode` (`EventCallback<AstrolThemeMode>`) | Si se asigna, el botón de modo cicla claro → oscuro → automático |
| `ApplyThemeToDocument` (`bool`, por defecto `true`) | Copia `data-aui-color`/`data-aui-mode` en `<html>` |

Efectos:
- **Las notificaciones siguen el tema** (color y modo), porque viven en `<body>` y ahora heredan de
  `<html>`. Las notificaciones *outline* usan `--aui-notification-surface` / `--aui-notification-text`
  (fondo oscuro en modo oscuro).
- `color-scheme: dark|light` según el modo: scrollbars, calendarios y controles nativos del navegador
  también cambian.
- `Outline` + `OnChangeMode` (bool) siguen funcionando igual (2 estados).

```razor
<AstrolLayoutMenu Style="AstrolTheme.Yellow"
                  Mode="@mode"
                  ShowSetMode="true"
                  OnChangeThemeMode="m => mode = m">
```

**Rompe si** se usaba el componente `SetOutline` directamente (normalmente lo pinta el layout):
`Outline` (bool) pasa a `Mode` (`AstrolThemeMode`) y `OnChange` pasa de `EventCallback<bool>` a
`EventCallback<AstrolThemeMode>`. **Detección:** `<SetOutline\b`.

**Notas para la documentación:** página *Basic › Layout menu* (parámetros nuevos) y *Theme*
(modo automático). El documentador ya usa `Mode` con persistencia en `localStorage`
(`astrolui-theme-mode`, migrando la preferencia antigua `astrolui-mode`).

---

### M-026 · Tests y mediciones — [Interno] · Severidad: Ninguna

- Nuevo proyecto `2-Shared/Tests/Astrol.Component.Basic.Tests` (xUnit + bUnit, 43 tests) en la solución.
- Resultados de tamaño y rendimiento (antes/después) en [`MEDICIONES.md`](MEDICIONES.md), con el
  benchmark reproducible en `docs/refactor/bench`.

---

## Lote 6 — Servicios `IAstrolToast` e `IAstrolModal`

### M-027 · `services.AddAstrolBasic()` — [API] · Severidad: Ninguna (recomendado)

Registra de una vez `AstrolJSInterop`, `IAstrolToast` e `IAstrolModal`:

```csharp
// antes
builder.Services.AddScoped<AstrolJSInterop>();
// ahora
builder.Services.AddAstrolBasic();   // using Astrol.Component.Basic;
```

**Detección:** `AddScoped<AstrolJSInterop>\(\)`. Seguir registrando solo `AstrolJSInterop` funciona,
pero los servicios nuevos no estarán disponibles (sus hosts no pintan nada).

---

### M-028 · `IAstrolToast`: notificaciones renderizadas en Blazor — [API] · Severidad: Ninguna (recomendado)

Sustituto de `jsI.Notification(...)` (que sigue existiendo). Se pinta en Blazor por
`AstrolToastHost` (sin `innerHTML`), con el mismo aspecto, y además:
- Pausa al pasar el ratón por encima (también la barra de tiempo).
- Botón de cerrar accesible; `role="alert"` en errores y avisos, `role="status"` en el resto.
- `seconds <= 0` = permanente hasta que se cierre.
- Sigue el tema (está dentro del layout) y queda por encima de los modales.
- Si no hay host en la página, recurre automáticamente a la notificación JS de siempre.

```razor
@inject IAstrolToast Toast   @* using Astrol.Component.Basic.Toast *@

Toast.Success("Guardado");
Toast.Error("No se pudo guardar\nInténtalo de nuevo");
Toast.Show("Mensaje", AstrolStyle.Purple, icon: "astrol-star", seconds: 0);
Toast.Show(notification); // el modelo Notification de siempre
```

**Migración (opcional):**

| Antes | Ahora |
|---|---|
| `await jsI.Notification("x".NotificationSuccess());` | `Toast.Success("x");` |
| `await jsI.Notification("x".NotificationError());` | `Toast.Error("x");` |
| `await jsI.Notification("x".NotificationWarning());` | `Toast.Warning("x");` |
| `await jsI.Notification("x".NotificationInfo());` | `Toast.Info("x");` |
| `await jsI.Notification(notification);` | `Toast.Show(notification);` |

**Detección:** `jsI\.Notification\(`.

---

### M-029 · `IAstrolModal`: confirmaciones y modales desde código — [API] · Severidad: Ninguna (recomendado)

```razor
@inject IAstrolModal Modal   @* using Astrol.Component.Basic.Modal *@

@* Confirmación: sin <AstrolConfirm @ref="..."/> ni campo en la página *@
if (await Modal.ConfirmAsync("¿Seguro?", "Se borrará el elemento."))
    Toast.Success("Borrado");

@* Cualquier componente en un modal, con resultado *@
var result = await Modal.ShowAsync<EditUser>("Editar", new Dictionary<string, object?> { ["Id"] = 5 },
    new ModalOptions { Width = AstrolWidth.Large });
if (!result.Cancelled)
{
    var user = result.GetData<User>();
}
```

El componente abierto se cierra a sí mismo con la referencia en cascada:

```razor
@code {
    [CascadingParameter] public AstrolModalReference Modal { get; set; } = default!;
    private void Save() => Modal.Close(user);   // o Modal.Cancel()
}
```

- Se pintan con el mismo `BaseModal` (`<dialog>`): se apilan, Esc y clic fuera cancelan
  (si `ClosedInteractive`), el foco vuelve al elemento anterior.
- `ConfirmOptions`: `Icon`, `TextAccept`, `TextCancel`, `ButtonOutline`, `Width`, `Draggable`,
  `ClosedInteractive`, `Class`. `ModalOptions`: `Width`, `WidthMaximize`, `Draggable`, `Resizable`,
  `ClosedInteractive`, `ShowHead`, `ShowOptions`, `Outline`, `Class`, `TextClose`.
- Sin `AstrolModalHost` en la página, `ShowAsync`/`ConfirmAsync` lanzan una excepción que lo explica.

**Migración (opcional):**

| Antes | Ahora |
|---|---|
| `<AstrolConfirm @ref="_conf" />` + `await _conf.Confirmation("t", "m")` | `await Modal.ConfirmAsync("t", "m")` |
| `<AstrolModal Status="@open" OnChangeStatus="...">…</AstrolModal>` + campo `open` | `await Modal.ShowAsync<MiContenido>("Título")` |

`AstrolConfirm` y `AstrolModal` siguen existiendo; ambos comparten el contenido con el servicio
(nuevo componente interno `ConfirmBody`).

---

### M-030 · Hosts en `AstrolLayoutMenu` — [Interno] · Severidad: Ninguna

`AstrolLayoutMenu` pinta `<AstrolToastHost />` y `<AstrolModalHost />` (parámetro
`IncludeServiceHosts`, por defecto `true`). Sin `AstrolLayoutMenu`, añade ambos una vez en tu
layout. Si hay más de un host en la página, solo el primero pinta.

**Notas para la documentación:** página *Basic › Notification* (sección 3, ya añadida), *Confirm*
y *Modal* (añadir la variante con servicio) e *Installation* (`AddAstrolBasic`).

---

## Lote 7 — Fuente de iconos dividida

### M-031 · Núcleo + extra con `unicode-range` — [Assets] · Severidad: Ninguna (salvo referencias directas al .woff2)

La fuente de iconos se divide en dos archivos con el **mismo** `font-family` (`fontello`) y
`unicode-range`; el navegador descarga solo el que contiene los iconos que aparecen en la página.
**Ningún nombre de icono cambia** (`astrol-*`, 1034 iconos).

| Archivo | Contenido | Peso |
|---|---|---|
| `fontello/font/fontello-core.woff2` | 167 iconos: todos los que usan los componentes de AstrolUI y los más comunes (home, user, search, edit, ok, plus, trash, mail, calendar…) | 24 KB |
| `fontello/font/fontello-extra.woff2` | los otros 867 | 145 KB, solo si se usan |

**Rompe solo si** el proyecto referencia el archivo de fuente directamente (p. ej. un
`<link rel="preload">`). **Detección:** `fontello/font/fontello\.woff2`. **Acción:** usar
`fontello-core.woff2` (y opcionalmente precargarlo).

Mantenimiento: la lista del núcleo está en `Astrol.Component.Basic/Icons/core-icons.txt` y los
archivos se generan con `python 2-Shared/tools/split_icons.py` (ver `CONTRIBUTING.md`). El script
avisa si algún componente usa un icono que no está en el núcleo.

También se corrigió que `Icons/fontello-config.json` (146 KB) se publicaba dos veces dentro del
paquete NuGet: la carpeta `Icons/` ya no se empaqueta.

---

## Lote 8 — Correcciones encontradas al revisar la documentación

### M-032 · `AstrolToggle`: `@bind-Value` y `aria-checked` — [API][A11y] · Severidad: Ninguna

- Nuevo `ValueChanged` (`EventCallback<bool>`): admite `@bind-Value="miBool"`. `OnChange` y
  `OnChangeObject` siguen funcionando igual.
- `aria-checked` ahora vale siempre `"true"` / `"false"` (antes se pintaba vacío o se omitía, y los
  lectores de pantalla no anunciaban el estado del `role="switch"`). Se quita el `aria-disabled`
  redundante con `disabled`.

**Migración (opcional):** `Value="@v" OnChange="x => v = x"` → `@bind-Value="v"`.

### M-033 · `AstrolInputPassword`: visibilidad, atributos y validación — [Bug] · Severidad: Ninguna

- `ShowPassword` solo se aplica cuando cambia el parámetro: antes, tras mostrar la contraseña y
  cambiar el valor, el re-render del padre (`@bind-Value`) la volvía a ocultar.
- Los atributos extra (`maxlength`, `required`, `autofocus`, …) se aplican al `<input>`.
- Se añade la clase de validación de `InputBase` (`valid` / `invalid` / `modified`) al `<input>`.

### M-034 · `AstrolLabel`: `For` deja de ser `[EditorRequired]` — [API] · Severidad: Ninguna

Usar solo `ForExpression="x => x.Prop"` ya no da el aviso RZ2012. Debe indicarse `For` o `ForExpression`.

### M-035 · `AstrolGrid`: el filtro local excluye los valores `null` — [Bug] · Severidad: Cambia resultados

Con `Data` (filtrado en el cliente), una fila cuyo valor es `null` (p. ej. `Address.City` con
`Address = null`) ya **no** pasa un filtro con texto. Antes aparecía siempre.

### M-036 · Notificaciones outline: texto con contraste suficiente — [Visual][A11y] · Severidad: Ninguna

En las notificaciones `*-outline` (las de `IAstrolToast` y las extensiones `"texto".NotificationX()`)
el **texto** usa ahora el color neutro del tema (`--aui-notification-text`); el color del estilo queda
en el icono, el borde y la barra de tiempo. Antes el texto rojo, verde o naranja no llegaba a 4.5:1
(rojo sobre fondo oscuro ≈ 2.3:1). En modo oscuro el icono usa un tono más claro del color.
Para personalizar el color del icono: variable `--aui-toast-accent` en la clase de la notificación.

---

## Lote 9 — Astrol.Shared.Repository

Todas las llamadas existentes siguen compilando igual (`Get<T>`, `Post<T>`, `Post<T, TResponse>`, `Put`,
`Delete`, archivos, `.Response`, `.Error`, `.HttpResponseMessage`, `GetBody()`, `AddAstrolRepository(url)` y
`AddAstrolRepository(clientSetting)`). Documentado en el documentador: `/repository`.

### M-037 · Idioma por defecto = cultura de la app — [Comportamiento] · Severidad: Rompe solo si la API depende de recibir `en`

Antes, `language` valía `"en"` por defecto y toda llamada sin idioma enviaba `Accept-Language: en`. Ahora `null`
(por defecto) usa `CultureInfo.CurrentUICulture.Name` (p. ej. `es-PE`), o `RepositoryOptions.DefaultLanguage`.

**Detectar:** llamadas sin el argumento `language` contra APIs que devuelven textos traducidos.
**Migrar (solo si se quiere el comportamiento anterior):**
`AddAstrolRepository(url, o => o.DefaultLanguage = "en")`.

### M-038 · Los fallos de red y timeouts ya no lanzan excepción — [Comportamiento] · Severidad: Baja

Un servidor caído, un error de DNS/CORS (`HttpRequestException`), un timeout de `HttpClient` o un JSON inválido en
una respuesta correcta devuelven ahora el wrapper con `Error = true` (`IsNetworkError`, `Exception`,
`ErrorMessage`). `HttpResponseMessage` nunca es `null`: en un fallo de red es una respuesta sintética 503
(408 si fue timeout) cuyo cuerpo es el mensaje. La cancelación pedida con el `CancellationToken` se sigue lanzando.

**Detectar:** `try { await _repo.Get... } catch (HttpRequestException)`.
**Migrar:** mover el manejo al `if (result.Error)` / `if (result.IsNetworkError)`; o conservar el comportamiento
anterior con `AddAstrolRepository(url, o => o.ThrowExceptions = true)`.

### M-039 · Novedades del wrapper y del repositorio — [API] · Severidad: Ninguna (aditivo)

- `HttpResponseWrapper<T>`: `IsSuccess`, `StatusCode` (`HttpStatusCode?`, `null` sin respuesta),
  `ErrorMessage` (detail/title de ProblemDetails, mensajes de `errors` de validación uno por línea,
  `message`/`error`, texto del cuerpo o el estado HTTP; las páginas HTML de error se ignoran), `Exception`,
  `IsNetworkError`. `GetBody()` se puede llamar varias veces.
  **Migrar (recomendado):** `var body = await r.GetBody(); Toast.Error(body)` → `Toast.Error(r.ErrorMessage!)`;
  `r.HttpResponseMessage.StatusCode == HttpStatusCode.X` → `r.StatusCode == HttpStatusCode.X`.
- `IRepository`: `Patch<T>` / `Patch<T, TResponse>`, `Send<TResponse>(method, url, content)`; archivos con
  `fieldName` (por defecto `"files"`) y `fields` (campos de texto extra).
  ⚠ Si tiene una implementación propia de `IRepository` (fakes de tests), añada estos miembros.
- `Get<string>` devuelve el texto plano y `Get<byte[]>` los bytes (antes intentaba leer JSON y fallaba).
- `AddAstrolRepository(url | clientSetting, Action<RepositoryOptions>? configure)`: `JsonSerializerOptions`
  (Web por defecto; `TypeInfoResolver` para JSON generado en compilación), `DefaultLanguage`,
  `ThrowExceptions`, `AuthorizationScheme`, `ConfigureRequest`.
- `IRepositoryTokenProvider`: si está registrado, cada petición lleva `Authorization: Bearer {token}`.
  **Migrar (recomendado):** dejar de asignar `HttpClient.DefaultRequestHeaders.Authorization` (es compartido).
- El parámetro `enviar` se llama ahora `data` (solo afecta a llamadas con argumento con nombre `enviar:`).

### M-040 · Correcciones internas — [Rendimiento][Bug] · Severidad: Ninguna

- Las respuestas se leen completas (`ResponseContentRead`): la conexión se libera aunque no se lea el cuerpo
  (antes quedaba abierta con `ResponseHeadersRead`, relevante en Blazor Server).
- Un `ContentType` de archivo inválido ya no lanza al subir (`TryParse`).
- `ClientSetting.Address` se inicializa y sus URL son `string?` (sin avisos de nulos).
- Se quitó `Properties/launchSettings.json` (sobraba en una librería); el paquete incluye README y descripción.
- Tests: `Astrol.Shared.Repository.Tests` (24).

### M-041 · JSON generado en compilación y librería apta para trimming/AOT — [Rendimiento] · Severidad: Ninguna (opt-in)

- `RepositoryOptions.UseJsonContext(params IJsonTypeInfoResolver[])`: los tipos declarados en un
  `JsonSerializerContext` se envían y leen con código generado (sin reflexión: primera llamada más rápida en
  WebAssembly y la app se puede recortar mejor). Los demás tipos siguen usando reflexión.
  La política de nombres sigue siendo la de `RepositoryOptions.JsonSerializerOptions` (camelCase); los
  `JsonSourceGenerationOptions` del contexto no cambian el JSON.
- La librería se marca `IsTrimmable` / `IsAotCompatible` y usa `JsonTypeInfo<T>` internamente (0 avisos).
- `JsonSerializerOptions` se congela al registrar el repositorio (antes se congelaba en la primera petición):
  configúrelas dentro de `AddAstrolRepository(url, options => ...)`, no después.

**Migrar (recomendado en cada cliente WebAssembly):**
```csharp
[JsonSerializable(typeof(ClientDto))]
[JsonSerializable(typeof(List<ClientDto>))]          // también las colecciones que lea o envíe
internal partial class AppJsonContext : JsonSerializerContext { }

builder.Services.AddAstrolRepository(clientSetting, o => o.UseJsonContext(AppJsonContext.Default));
```
⚠ Los DTO deben estar en archivos `.cs`: el generador de JSON no ve las clases declaradas dentro de un `.razor`
(`@code`); muévalas antes de añadirlas al contexto.
**Detectar los tipos a declarar:** los `T` de `Get<T>`, `Post<T, TResponse>`, `Put<…>`, `Patch<…>`, `Delete<T>` y
`Send<TResponse>` del proyecto (`grep -rE "Repository\.(Get|Post|Put|Patch|Delete|Send)<"`).

---

## Lote 10 — Astrol.Component.PDFViewer

### M-042 · pdf.js 4.10.38 cargado bajo demanda (sin `<script>`) — [Assets][Seguridad] · Severidad: Rompe solo si se deja el `<script>` antiguo

- Se reemplaza pdf.js **3.11.174** (sin minificar, 946 KB + worker de 1,98 MB, con la vulnerabilidad
  **CVE-2024-4367**: un PDF malicioso podía ejecutar JavaScript) por **pdf.js 4.10.38** oficial minificado
  (`js/pdf.min.mjs` 345 KB + `js/pdf.worker.min.mjs` 1,34 MB, Apache-2.0, licencia en el paquete). Además se abre
  con `isEvalSupported: false`.
- El componente importa su módulo (`AstrolPDFViewer.razor.js`) y pdf.js **solo cuando hay un visor en pantalla**;
  el resto de páginas ya no descargan nada del visor.
- Ya no se inyecta `HttpClient` (la descarga usa el documento ya abierto): el visor funciona aunque la app no
  registre `HttpClient`.

**Detectar:** `astrol-pdf.js` en `index.html`, `App.razor` o `_Host.cshtml`.
**Migrar:** borrar `<script src="_content/Astrol.Component.PDFViewer/js/astrol-pdf.js"></script>` (el archivo ya no
existe: dejarlo produce un 404 en cada carga).

### M-043 · `Signature` e `IconLoad` obsoletos; nuevo `OnError` — [API] · Severidad: Aviso CS0618

- `Signature` ya no hace falta: cada visor es una instancia independiente (antes compartían funciones globales
  y dos visores con la misma firma se pisaban). `IconLoad` nunca tuvo efecto. Ambos siguen existiendo con
  `[Obsolete]` y no hacen nada.
- `OnError` (`EventCallback<string>`): se invoca si el PDF no se puede abrir (URL inaccesible, CORS o archivo
  dañado); el visor muestra un aviso en lugar de una excepción no controlada.

**Detectar:** `Signature=` / `IconLoad=` en `<AstrolPDFViewer`. **Migrar:** quitarlos; personalizar la carga con `Load`.

### M-044 · Pintado diferido, accesibilidad y correcciones — [Rendimiento][A11y][Bug] · Severidad: Ninguna

- Solo se pintan las páginas visibles (± 400 px) y se libera la memoria de las lejanas (antes se pintaban todas
  en cada zoom o giro). Los pintados anteriores se cancelan (sin errores al hacer zoom rápido) y las páginas son
  nítidas en pantallas de alta densidad (con tope de área para Safari/iOS).
- El zoom y el giro conservan la posición de lectura; el indicador de página sigue al desplazamiento también
  con páginas más altas que el visor (antes se quedaba fijo).
- El visor responde a cambios de `StylePDFViewer` y `PresentationMode` sin recrearlo; la barra clásica se
  maquetea con CSS (sin medirla desde JS).
- Los controles son `<button>` con nombre accesible (es/en), el área del documento es una región enfocable:
  flechas/AvPág/espacio desplazan de forma nativa, izquierda/derecha cambian de página, Inicio/Fin.
- Se liberan el documento, el worker y los observadores al destruir el componente (antes quedaban en memoria).

---

## Lote 11 — RichText y Charts bajo demanda

### M-045 · RichText: Quill y su CSS se cargan solos — [Assets] · Severidad: Ninguna

El módulo del editor descarga `js/astrol-rich-text.min.js` (Quill 1.3.6, 242 KB) y `css/astrol-rich-text.min.css`
(23 KB) la primera vez que se pinta un `AstrolRichText`. Si la app aún los incluye en `index.html` no se duplican.
**Migrar (recomendado):** quitar de `index.html` / `App.razor` / `_Host.cshtml`:
`<link href="_content/Astrol.Component.RichText/css/astrol-rich-text.min.css" … />` y
`<script src="_content/Astrol.Component.RichText/js/astrol-rich-text.min.js"></script>`.

### M-046 · RichText: correcciones — [Bug][Seguridad][A11y] · Severidad: Baja

- `SetHTMLAsync` ya no asigna `innerHTML`: limpia el HTML en un documento inerte (sin scripts, atributos `on*`,
  `javascript:`…) y lo convierte con Quill. Antes un `<img onerror>` en HTML de usuario ejecutaba código. El HTML
  que Quill no sabe representar se simplifica (igual que al editarlo).
- `MinHeight` / `MaxHeight` se aplican a cada editor (antes un `<style>` global hacía que el último editor de la
  página cambiara la altura de todos).
- `ShowCodeBlock` controla el botón de bloque de código (antes dependía de `ShowAlign`).
- `ShowFormula` necesita KaTeX en la página; sin él el botón lanzaba un error, ahora se oculta con un aviso en consola.
- Botones de la barra con `type="button"` (no envían el formulario que contenga al editor) y nombre accesible
  (es/en); sin `id` duplicados (`QuillEditor`, `QuillToolBar`).

### M-047 · Charts: ApexCharts y el tema se cargan solos — [Assets] · Severidad: Ninguna

`AstrolChart` ya importaba su módulo bajo demanda, pero el `<script type="module">` de `index.html` lo descargaba
(con ApexCharts, 599 KB) en todas las páginas. Ahora el módulo añade también `css/astrolcharts.min.css` (tema
AstrolUI) solo si la página no lo tiene. Se eliminan `exampleJsInterop.js` y `background.png` (restos de plantilla).
**Migrar (recomendado):** quitar `<script type="module" src="_content/Astrol.Component.Charts/js/astrolcharts.min.js">`
y `<link href="_content/Astrol.Component.Charts/css/astrolcharts.min.css" … />`.

### M-048 · Charts: área de rango combinada con otras series — [Bug] · Severidad: Ninguna

Una gráfica con `AstrolRangeAreaSeries` y otra serie (p. ej. una línea con la media) quedaba vacía: ApexCharts
necesita `chart.type = rangeArea` en ese caso. `AstrolChart` lo asigna solo si el tipo no se indicó (o es `Line`).

---

## Lote 12 — Astrol.Component.Board

Los parámetros, eventos, modelos (`Board`, `Box`, `Relation`, `Vertex`, `Position`) y `BoxRender` se conservan.

### M-049 · Sin interact.js ni scripts globales — [Assets][API] · Severidad: Rompe si se dejan los `<script>` antiguos

- El tablero carga su propio módulo (`AstrolBoard.razor.js`) y su CSS (`board.min.css`) la primera vez que aparece.
  Se eliminan `board.js`, `board.min.js` e **interact.js** (129 KB).
- `AddAstrolBoard()` ya no registra nada (se conserva vacío). Se eliminan `BoardJsInterop`,
  `JSInvokableComponent`, `LineCompnent`, `VertexComponent` y `RectComponent` (internos; las relaciones se pintan en
  `RelationComponent`).

**Detectar:** `interact.min.js`, `board.min.js`, `Astrol.Component.Board/board.css` en `index.html` / `App.razor` /
`_Host.cshtml`; `AddAstrolBoard`; `BoardJsInterop`.
**Migrar:** quitar esas tres líneas (los archivos ya no existen: darían 404) y, opcionalmente, `AddAstrolBoard()`.

### M-050 · Ya no bloquea nada fuera del tablero; varios tableros por página — [Bug] · Severidad: Ninguna

- Antes `board.js` desactivaba el **clic derecho en toda la aplicación**, capturaba Ctrl+rueda en toda la página y
  añadía a `document` (sin quitarlos nunca) listeners que bloqueaban Ctrl+A/Z/F, espacio y flechas en toda la app.
  Ahora todo eso solo ocurre con el foco o el puntero dentro del tablero y se libera al destruirlo.
- Antes solo funcionaba **un tablero por aplicación** (instancias `static`): con dos, los movimientos de uno llegaban
  al otro (y en Blazor Server se mezclaban usuarios). Ahora cada tablero es independiente.

### M-051 · Arrastre en el navegador; el modelo se actualiza al soltar — [Rendimiento][Comportamiento] · Severidad: Baja

- Mover, redimensionar, mover vértices, desplazar el tablero y el mini-mapa se resuelven en JS (Pointer Events, un
  pintado por fotograma). .NET recibe **una** llamada al soltar (`OnDragEnd`) y solo se repintan las cajas y
  relaciones que cambiaron. Medido con 500 cajas y 499 relaciones: cada paso del arrastre pasa de ~360 ms a ~2 ms;
  el montaje, de 651 ms a 335 ms (sin ~1000 llamadas de inicialización por caja).
- **Cambio:** durante el arrastre `Box.X/Y/Width/Height` no cambian; se actualizan al soltar (antes en cada
  movimiento). Si su `BoxRender` muestra coordenadas, se verán al soltar. `OnChangeBoard` se sigue invocando al final.
- El redimensionado respeta `MinWidth/MinHeight` y el área `MinLeft/MinTop/MaxRight/MaxBottom` en todas las asas
  (antes la esquina izquierda/superior podía saltarse los límites). Mayús + flechas mueve 20 px.

### M-052 · Historial: deshacer/rehacer en el mismo objeto — [API] · Severidad: Baja

- Cada estado guarda referencias y geometría (no clona `TBox` por reflexión). Deshacer restaura **sobre el mismo
  objeto `Board` del padre** e invoca `OnChangeBoard`; también recupera cajas o relaciones que el padre quitó.
- Nuevo: **Ctrl+Y / Ctrl+Mayús+Z** (rehacer) y los métodos públicos `UndoAsync()` / `RedoAsync()`.
- Asignar **otro objeto** `Board` reinicia la selección y el historial (antes mezclaba estados de objetos distintos).
  Añadir o quitar cajas/relaciones en el mismo objeto se detecta al repintar y entra en el historial.
- `_idBoxesSelected` pasa a ser una **copia** de la selección: modificar esa lista ya no cambia la selección
  (use `RemoveItemSelected(ids)`).

### M-053 · Guías al arrastrar: `ShowGuides` — [API] · Severidad: Ninguna (nuevo)

- `AstrolBoard ShowGuides="true"` (por defecto `false`): líneas guía discontinuas desde las esquinas y los lados de la
  caja seleccionada mientras se arrastra o redimensiona. `Box.ShowGuides` (`bool?`, `[NotMapped]`) lo fuerza por caja.
- Estilo con variables CSS `--border-line`, `--pbse-offset`, `--pbse-side-opacity` (tono propio en modo oscuro). El
  lienzo (`.p-board-canvas`, `overflow: clip`) evita que las líneas de `100vw` agranden el área desplazable.

### M-054 · DOM y accesibilidad — [CSS] · Severidad: Solo si su CSS dependía de la estructura

- Las cajas y relaciones están dentro de `.p-board-canvas`; el SVG usa la clase `.p-board-svg` (antes `#p-board-svg`,
  id repetido con varios tableros). Cada caja lleva `data-box`, `data-x/y/w/h`; las asas `data-handle="1..8"`; cada
  relación es un `<g class="p-relation" data-relation data-a data-b data-mode data-anchor-a data-anchor-b>` con
  tramos `line.p-line[data-seg]` (cada uno con una `line.p-line-hit` transparente de 10 px que recibe el clic
  derecho), vértices `data-vertex` y, con `EditAnchors`, asas `circle.p-anchor[data-anchor="a|b"]` (M-055).
- El tablero tiene `role="application"` y `aria-label` (`AriaLabel`); los controles del zoom, mini-mapa y búsqueda
  son `<button>` con nombre accesible (es/en). `BoxDelay` usa una clase en lugar de un `<style>` global.

### M-055 · Anclaje de las líneas: `RelationAnchor`, `BoxAnchor`, `EditAnchors` — [API] · Severidad: Ninguna (nuevo)

- `AstrolBoard RelationAnchor="RelationAnchor.Border"`: las líneas sin ancla fija empiezan y terminan en el borde de
  las cajas (en la dirección del otro extremo o del vértice más cercano). Por defecto `Center` (como antes).
- `Relation.AnchorA` / `AnchorB` (`BoxAnchor?`, `[NotMapped]`, como `Vertices`): punto fijo de cada caja, relativo a
  ella (`X`, `Y` de 0 a 1). Atajos `BoxAnchor.Top/Right/Bottom/Left/Center`. `null` = según `RelationAnchor`.
- `EditAnchors="true"`: al pasar el ratón por una línea aparecen asas en sus extremos; arrastrarlas fija el punto del
  borde (se ajusta a esquinas, cuartos y centros de los lados a menos de 8 px), doble clic lo libera. Se resuelve en
  JS y llega a .NET una sola vez (`OnAnchorEnd`), entra en el historial y dispara `OnChangeBoard`.
- La geometría está en `RelationGeometry` (C#) y en `endpoint()` del módulo JS con las mismas reglas.
- Persistencia: si guarda las relaciones con EF, `AnchorA/AnchorB` no se mapean; guárdelos como sus vértices.

### M-056 · El teclado del tablero no actúa mientras se escribe dentro de una caja — [Bug] · Severidad: Ninguna

- Antes, con un `<input>`/`<textarea>` en `BoxRender`, **Supr** invocaba `OnKeyDownDelete` (borrando la caja en la
  mayoría de usos) y las flechas movían la caja mientras se escribía. Ahora el JS filtra las teclas: si vienen de un
  campo editable no llegan al tablero. Las teclas del tablero entran por `[JSInvokable] OnBoardKey(key, ctrl, shift)`
  (antes `@onkeydown` en `.p-board`); en tests bUnit llame a `OnBoardKey` en lugar de `KeyDown` sobre `.p-board`.

### M-057 · Clic derecho en las líneas más fácil — [UX] · Severidad: Ninguna

- Cada tramo lleva una línea transparente de 10 px que recibe el clic derecho (antes había que acertar en 1 px). Al
  pasar el ratón por una relación se resalta entera (`.p-relation:hover .p-line`).

### M-058 · Un solo menú contextual dentro del tablero — [Bug] · Severidad: Ninguna

- Al hacer clic derecho en una caja, una línea o un vértice se abría su menú **y** el del navegador encima (esos
  elementos detienen la propagación en Blazor, así que el `preventDefault` del tablero no llegaba a ejecutarse). Ahora
  el módulo JS cancela el menú del navegador en todo el tablero; solo aparece el del tablero, caja, línea o vértice.

### M-059 · Orden automático: `ArrangeAsync` y `BoardLayout.Arrange` — [API] · Severidad: Ninguna (nuevo)

- `AstrolBoard.ArrangeAsync(BoardLayoutOptions? options)` ordena todas las cajas según sus relaciones (método de
  Sugiyama por capas): rompe ciclos (DFS), asigna capas (camino más largo, acercando los orígenes a sus sucesores),
  añade un punto de paso por capa intermedia a las relaciones largas, reduce cruces (baricentros en barridos alternos,
  cruces contados en O(E log V), se queda el mejor orden) y coloca cada caja hacia la media de sus vecinas sin
  solaparse. Grupos no conectados uno al lado del otro (en filas de `MaxWidth`) y cajas sin relaciones al final.
- Solo mueve cajas y vértices: **no añade, quita ni modifica relaciones** (`BoxIdA/B`, `Content`, `AnchorA/B`) ni
  cambia tamaños. Las relaciones largas reciben vértices (se reutilizan los existentes, conservando su `Id`) y las
  demás quedan rectas; `UseVertices = false` las deja todas rectas. Respeta `MinLeft/MinTop` y limita el ancho a
  `MaxRight`. Entra en el historial (Ctrl+Z), invoca `OnChangeBoard` y anima las cajas (`Animate`; las líneas
  reaparecen al terminar, clase `.p-board-arranging`; sin animación con `prefers-reduced-motion`).
- `BoardLayout.Arrange(board, options)` (estático) hace lo mismo sin el componente. Opciones: `Direction`
  (`TopToBottom`/`LeftToRight`), `LayerSpacing`, `BoxSpacing`, `GroupSpacing`, `UseVertices`, `Left`, `Top`,
  `MaxWidth`, `Animate` (`BoardLayoutOptions` es un `record`).

### M-060 · Asas de los extremos encima de las cajas — [UX][CSS] · Severidad: Solo si su CSS dependía de la estructura

- Con `EditAnchors`, las asas ya no están dentro de `g.p-relation` (debajo de las cajas, medio tapadas): van en una
  capa `svg.p-board-svg-top` por encima de las cajas, un `g.p-anchors[data-relation]` por relación con
  `circle.p-anchor[data-anchor="a|b"][data-box]`. El JS las muestra (`.p-anchor-show`) al pasar el ratón por la línea o
  por la caja (seleccionada o no); ocultas no reciben el ratón. Tienen prioridad sobre las asas de redimensionar: si
  coinciden (p. ej. un extremo en el centro de un lado), se mueve primero el extremo y luego se redimensiona. Se
  arrastran igual y doble clic las libera.

### M-061 · Líneas rectas o curvas: `LineStyle` — [API] · Severidad: Ninguna (nuevo)

- `AstrolBoard LineStyle="RelationLineStyle.Curved"`: cada relación es un `path` de Bézier cúbicas que sale y llega
  perpendicular al lado de la caja (o por el eje dominante si el extremo es el centro) y pasa por los vértices con
  tangentes de Catmull-Rom. Por defecto `Straight` (tramos `line` como antes). Funciona con `RelationAnchor`,
  anclajes fijos, vértices, `DiscontinueLine` y el arrastre (el JS recalcula `d` con las mismas reglas que
  `RelationGeometry.CurvePath`). `RelationLineStyle` está en `Astrol.Entities.Basic.UI.Board`.

### M-062 · Relación de una caja consigo misma: bucle — [UX] · Severidad: Solo si su CSS usaba `rect.p-line-mm`

- Antes era un rectángulo de 100 × 100 superpuesto a la esquina de la caja, sin menú contextual. Ahora es un bucle
  (`path.p-line.p-line-self`) que sale del lado derecho y vuelve por el de abajo en la esquina inferior derecha
  (tamaño proporcional a la caja, 16–48 px), con su línea transparente para el clic derecho
  (`OnOpenRelationContextMenu` con `BoxIdA` = `BoxIdB`). El lienzo crece para que el bucle nunca quede recortado.

### M-063 · Flechas y etiquetas en las relaciones — [API] · Severidad: Ninguna (nuevo)

- `AstrolBoard RelationArrow` (`None` por defecto, `End`, `Start`, `Both`) y `Relation.Arrow` (`RelationArrow?`,
  `[NotMapped]`) por relación. Un marcador SVG por tablero (`marker#{Board.Id}-arrow`, `orient="auto-start-reverse"`,
  clase `.p-arrow`); en tramos rectos va en el primer/último `line`, en curvas y bucles en el `path`. Un extremo con
  flecha se lleva al borde aunque `RelationAnchor` sea `Center` (si no, la punta quedaría tapada).
- `Relation.Label` (`string`, `[NotMapped]`) o `AstrolBoard RelationRender` (`RenderFragment<Relation<TRelation>>`):
  etiqueta en `div.p-board-labels > .p-relation-label[data-label]`, entre las líneas y las cajas, en la mitad del
  recorrido (`RelationGeometry.LabelPoint`; curvas muestreadas a 16 puntos por tramo). El JS la recoloca al arrastrar.
  Clic derecho en la etiqueta abre el menú de la relación. Persistencia: como `Vertices`/`AnchorA`, no se mapean con EF.

### M-064 · Conectar cajas arrastrando: `AllowConnect` / `OnConnect` — [API] · Severidad: Ninguna (nuevo)

- Con `AllowConnect="true"`, al pasar por una caja aparecen cuatro puertos (`circle.p-port[data-port]`, 14 px fuera
  del centro de cada lado, en `svg.p-board-svg-top`). Arrastrar uno dibuja `line.p-connect-preview`, resalta la caja
  de destino (`.p-box-connect-target`) y al soltar llama a `[JSInvokable] OnConnectEnd(from, to)`.
- Los puertos siguen visibles mientras el puntero está en la caja, en un puerto o en la franja entre ambos (se ocultan
  al alejarse más de 26 px); se ocultan al empezar a mover o redimensionar la caja y reaparecen en su nuevo sitio al
  soltarla si el puntero sigue encima.
- `OnConnect` (`BoardConnectEventArgs<TRelation>`: `Relation`, `Cancel`) se invoca **antes** de añadirla: complete
  `Content`, `Label`, `Arrow`… o cancele. Después entra en el historial e invoca `OnChangeBoard`. Soltar en la misma
  caja crea una relación consigo misma.

### M-065 · Selección con rectángulo: `BackgroundDrag` — [API][Comportamiento] · Severidad: Ninguna

- `BoardBackgroundDrag.Pan` (por defecto): arrastrar el fondo desplaza (como antes) y **Mayús + arrastrar** selecciona
  con un rectángulo (`.p-selection-rect`). `Select`: al revés. Con Ctrl se suma a la selección.
  `[JSInvokable] OnSelectArea(ids, additive)`.

### M-066 · Ajuste a la cuadrícula y a otras cajas: `SnapToGrid` / `SnapToBoxes` — [API] · Severidad: Ninguna (nuevo)

- `SnapToGrid` (float, 0 = sin ajuste): mover y redimensionar caen en la cuadrícula. `SnapToBoxes`: al mover, la caja
  se alinea con bordes y centros de las demás cajas visibles (a menos de 6 px de pantalla, tiene prioridad sobre la
  cuadrícula) y se dibuja la guía (`line.p-snap-guide`). Todo en JS, sin llamadas a .NET durante el arrastre.

### M-067 · Copiar, pegar, duplicar y borrar integrados — [API][Comportamiento] · Severidad: Baja

- Ctrl+C / Ctrl+V / Ctrl+D (`AllowClipboard`, por defecto `true`; Ctrl+D ya no abre "añadir a marcadores" con el
  foco en el tablero): copian las cajas seleccionadas con las relaciones entre ellas (vértices, anclajes, flechas y
  etiqueta), desplazadas 20 px (acumulado en pegados sucesivos), quedan seleccionadas e invocan `OnBoxesAdded`.
  Contenido copiado con `CloneBox` / `CloneRelation` o, si no se indican, por JSON (si falla, misma referencia).
- **Supr**: si hay `OnKeyDownDelete`, se invoca como antes (sin borrar nada); **si no hay**, ahora se quitan la
  selección y sus relaciones (`OnBoxesRemoved` con `BoardRemovedEventArgs`). Antes Supr sin manejador no hacía nada.
- Métodos públicos: `CopySelection()`, `PasteAsync()`, `DuplicateSelectionAsync()`, `DeleteSelectionAsync()`.
  Todo entra en el historial (Ctrl+Z) e invoca `OnChangeBoard`.

---

## Lote 13 — Limpieza de parámetros sin efecto

### M-068 · Se quitan parámetros que no hacían nada — [API] · Severidad: Rompe al compilar/ejecutar si se usan

Blazor lanza una excepción en tiempo de ejecución si se pasa a un componente un parámetro que no existe
("does not have a property matching the name"). Ninguno de estos tenía efecto, así que basta con borrarlos:

| Componente | Parámetro quitado | Por qué no hacía nada |
|---|---|---|
| `AstrolLayoutMenu` | `MinWidth` | Su regla CSS (`min-width: var(--menu-min-width)`) estaba comentada; también se quita la variable. |
| `AstrolUploadFile` | `InModal` | No se leía: el componente siempre es un modal (para usarlo sin modal, `AstrolUploadFileEmbedded`). |
| `AstrolUploadFileEmbedded` | `Title`, `TextClose`, `TextSave` | No se pintaban (no tiene modal ni botones). En `AstrolUploadFile` siguen existiendo y funcionan. |
| `AstrolBoard` | `RestHeigh` | Sin efecto desde el lote 12 (el tablero ocupa el alto de su contenedor). |
| `AstrolPDFViewer` | `Signature`, `IconLoad` | `[Obsolete]` desde el lote 10: cada visor es independiente y el indicador de carga es `Load`. |

**Detectar:** `MinWidth=` en `<AstrolLayoutMenu`, `InModal=` en `<AstrolUploadFile`, `Title=` / `TextClose=` /
`TextSave=` en `<AstrolUploadFileEmbedded`, `RestHeigh=` en `<AstrolBoard`, `Signature=` / `IconLoad=` en
`<AstrolPDFViewer`. **Migrar:** borrar el atributo.

---

## Rediseño visual — Astrol.Component.Basic (variante "Neutro")

Prototipo de referencia: `docs/redesign/basic-preview.html`. Decisiones: variante Neutro (radio 8 px, bordes de 1 px,
grises neutros, una acción principal por vista), estilos solo en los componentes, amarillo `#facc15`.

### V-001 · Tokens `--aui-*` y alias de las variables antiguas — [CSS] · Severidad: Ninguna (salvo colores propios)

- Nuevos tokens en `astrol-basic.css`: `--aui-bg`, `--aui-surface`, `--aui-surface-2`, `--aui-surface-hover`,
  `--aui-border`, `--aui-border-strong`, `--aui-text`, `--aui-text-2`, `--aui-text-3`, `--aui-brand`,
  `--aui-brand-soft`, `--aui-brand-ring`, `--aui-brand-text`, `--aui-on-brand`, `--aui-danger/success/warning/info`,
  `--aui-radius-sm/-/lg/-pill` (6/8/12/999 px), `--aui-h-control` (38 px), `--aui-shadow-sm/-/lg`, `--aui-focus-ring`,
  `--aui-font`, `--aui-text-xs..xl`. Claro/oscuro con `data-aui-mode`, color con `data-aui-color` (se declaran también
  en esos elementos, así el tema funciona aunque solo lo lleve el div de `AstrolLayoutMenu`).
- Las variables antiguas (`--color-base`, `--background`, `--color-text`, `--layout-*`, `--background-menu`,
  `--shadow-control`, `--color-gray-a/b/c`...) siguen existiendo como **alias** de los tokens: el CSS propio de las
  aplicaciones y de Board/Charts/RichText/PDFViewer sigue funcionando y adopta la paleta nueva.
- Valores que cambian: grises neutros (zinc); `--color-gray-a` #808080 → #71717a; `--color-red` #c10000 → #dc2626;
  azul #007bff → #2563eb; verde #12ba38 → #16a34a; naranja #ff6a00 → #f97316; morado #b200ff → #9333ea; **amarillo
  #ffd800 → #facc15** (con texto oscuro encima, `--aui-on-brand`). El modo oscuro pasa de grises #2a2a2a/#4e4d4d a
  #111113/#18181b/#1f1f23. `--font-size-midle` 16 → 14 px (cuerpo a 14 px).
- **Detectar:** colores escritos a mano que imitaban los antiguos (`#ffd800`, `#4e4d4d`, `#2a2a2a`...).
  **Migrar:** usar los tokens `--aui-*`.

### V-002 · Sin estilos globales en `<input>`, `<textarea>`, `<label>` ni encabezados — [CSS] · Severidad: Media

- Antes `astrol-basic.css` daba estilo, con `!important`, a **todos** los `input`/`textarea` (alto 50 px, borde,
  fondo), a todos los `label` (negrita, 16 px) y a `h1`..`h5`. Ahora solo se estilan los campos dentro de los
  componentes (`AstrolContentInput`, `AstrolInputPassword`, `AstrolComboBox`, filtros del grid, paginación, Assign).
  Los encabezados conservan su tamaño, pero sin `!important`.
- **Detectar:** `<input`/`<textarea`/`<select` sueltos (sin `AstrolContentInput`) que dependían de ese aspecto.
  **Migrar:** envolverlos en `<AstrolContentInput>` o añadir la clase `aui-input` / `aui-textarea` (mismo aspecto,
  con anillo de foco); `AstrolLabel` o la clase `label-checkx-astrol` para etiquetas.
- `.sidebar` / `.nav-item` (restos de la plantilla de Bootstrap) ya no tienen estilos.

### V-003 · Layout, menú, ruta y título — [CSS][API] · Severidad: Baja

- `AstrolLayoutMenu.HeightTop` por defecto 50 → **56 px**. La barra superior es translúcida con borde fino (sigue
  siendo un bloque: su contenido lo maqueta la aplicación). Menú lateral blanco con borde; el cuerpo usa `--aui-bg`.
  El botón de plegar es una pestaña redonda en el borde del menú.
- Menú: elementos con `flex`, activo con el tinte de la marca (`.active-item`), submenús sangrados con línea guía,
  insignia `new` en pastilla. Breadcrumb discreto (sin iconos en círculo de color).
- **Nuevo:** `AstrolTitle Description="..."` (texto secundario). El icono va en un cuadro con el tinte de la marca;
  ya no hay barra lateral de color.

### V-004 · Botones, etiquetas y carga — [CSS][API] · Severidad: Baja

- `AstrolButton`: sin degradados ni brillos; sólido con `--btn-c`/`--btn-on`; `Outline` = superficie con borde y
  texto del color (nueva clase común `astrol-button-outline`); `White` = botón secundario neutro; `Black` se invierte
  en oscuro. Alto 38 px. **`BorderRadius` por defecto `null`** (usa `--aui-radius`, 8 px; antes `"5px"`).
- `AstrolBox`: etiquetas compactas; `Outline` = tinte suave. **`BorderRadius` por defecto `null`** (6 px).
- `AstrolAssign.BorderRadius` por defecto `null` (12 px). Carga: velo translúcido con desenfoque.
- **Detectar:** `BorderRadius="5px"` puesto solo para igualar el valor antiguo. **Migrar:** quitarlo.

### V-005 · Formularios, grid, modal y notificaciones — [CSS] · Severidad: Ninguna

- Campos con borde de 1 px, radio 8 px y anillo de foco de la marca (sustituye a la línea animada inferior). Toggle
  compacto. Desplegable del ComboBox con sombra y opción activa tintada (mismo estilo en claro y oscuro).
- Grid como tarjeta: cabecera gris suave, filas con borde fino y hover, fila seleccionada tintada, casillas propias,
  filtros compactos. Paginación con `flex`. Estado vacío con icono en círculo.
- Modal: velo con desenfoque, cabecera clara (antes oscura con barra de color), botones de icono discretos, pie gris
  claro con acciones a la derecha. Confirmación con icono en círculo tintado.
- Notificaciones: tarjetas con sombra; las sólidas usan el color con texto de contraste (sin transparencia); las
  `-outline` son neutras con el icono tintado y la barra de tiempo del color.

### V-006 · Menú lateral: elemento activo por URL, grupos y submenús completos — [API][Bug] · Severidad: Baja

- **Bug corregido:** con varios submenús abiertos, el contenedor del menú (columna `flex` con altura fija y scroll)
  encogía los submenús y quedaban cortados. Ahora no se encogen (`flex-shrink: 0`).
- **Bug corregido:** el elemento activo se buscaba por `Name`, así que varios elementos con el mismo nombre (p. ej.
  "Instalación" en cada paquete) se marcaban a la vez. Ahora se compara por referencia y `Name` puede repetirse.
- **Nuevo:** `AstrolMenuAdmin SelectByUrl` (por defecto `true`): marca el elemento cuya `URL` coincide con la página
  actual (si no hay coincidencia exacta, el de prefijo más largo: `/clientes/5` marca `/clientes`) y abre su submenú;
  también al navegar con enlaces o con atrás/adelante (`NavigationManager.LocationChanged`). Al hacer clic en un
  elemento con URL ya no se marca él mismo: lo marca la navegación. El padre de la página actual lleva la clase
  `has-active-child`. Con `SelectByUrl="false"` se usa `MenuItem.Active` y el clic, como antes.
- **Nuevo:** `MenuItem.Section` (string): título de grupo ("General", "Paquetes"...). El elemento que lo indica empieza
  un grupo nuevo (`.aui-menu-section`); los siguientes sin `Section` pertenecen a él.
- El contenedor del menú pasa de `<div>` a `<nav aria-label="Menú principal">` (misma clase `cont-astrol-menu`).
- **Detectar:** código que ponía `Active = true` a mano para reflejar la página actual. **Migrar:** se puede quitar.

### V-007 · `AstrolThemeSwitcher`: color del tema y modo, donde se quiera — [API] · Severidad: Ninguna (nuevo)

- Círculos con los 6 colores del tema y botón de modo (claro → oscuro → automático). Parámetros: `Theme` +
  `ThemeChanged` (`@bind-Theme`), `Mode` + `ModeChanged` (`@bind-Mode`), `AllowAuto` (true), `ShowColors` (true),
  `ShowMode` (true), `Class`. Pensado para la barra superior (`Top` de `AstrolLayoutMenu`, junto al usuario); con
  `ShowSetMode="false"` se quita el botón de modo del menú lateral. Guardar la preferencia lo hace la aplicación.
- `SetOutline` tiene `Inline` (en línea en lugar de en la esquina del menú).

### V-008 · Barra superior opaca y sombras de las notificaciones — [CSS] · Severidad: Ninguna

- La barra superior de `AstrolLayoutMenu` usa `background: var(--aui-surface)` (antes era translúcida con
  desenfoque y el contenido —por ejemplo un botón— se veía a través al hacer scroll).
- El contenedor de notificaciones (`#cont-astrol-all-notification`, `.aui-toast-host`) tiene relleno
  (`12px 16px 24px`) y ancho máximo de 372 px para que su `overflow` no recorte la sombra de cada aviso; la sombra
  de `.cont-astrol-notification` pasa a `var(--aui-shadow)`.
- El contenedor de notificaciones empieza **debajo** de la barra superior (`top: var(--top-height)`) y tiene
  `pointer-events: none` (solo las notificaciones reciben clics). Antes, aun vacío, tapaba los botones del extremo
  derecho de la barra (selector de tema, buscador). `AstrolLayoutMenu` publica `--top-height` en `<html>` junto con
  `data-aui-color` / `data-aui-mode` (`ApplyThemeToDocument`), así también lo ve el contenedor que crea
  `jsI.Notification` fuera del layout.

### V-009 · Botones más rápidos y con más respuesta — [CSS][Comportamiento] · Severidad: Baja

- `AstrolButton` ya no bloquea los clics durante 180 ms ni vuelve a pintar el componente al pulsar: `OnClick` se
  ejecuta al instante y la respuesta visual es solo CSS y sencilla (se oscurece al pasar el ratón y se hunde 1 px
  al pulsar, con transiciones de 0,1 s). Se quita la clase `astrol-button-clicking`.
- Si su código contaba con ese bloqueo para evitar dobles envíos, desactive el botón (`Status="false"`) mientras
  se procesa.

### V-010 · Arrastre de modales y confirmaciones más fluido — [CSS] · Severidad: Ninguna

- El fondo del `<dialog>` (`::backdrop`) ya no usa `backdrop-filter: blur`: obligaba a repintar toda la página en
  cada movimiento al arrastrar. Mientras se arrastra, el contenido lleva `will-change: transform` y una sombra menor.

### V-011 · `AstrolContentInput`: `ShowEffect` pasa a `FocusRing` — [API] · Severidad: Rompe al compilar si se usa

- El efecto de línea animada ya no existe; el parámetro controla el anillo de foco del color del tema y el borde al
  pasar el ratón. Renombrado `ShowEffect` → `FocusRing` (también en `AstrolInputPassword`). Se quita el
  `<div class="astrol-efect-input">` vacío. Reemplazo: `ShowEffect="false"` → `FocusRing="false"`.

### V-012 · Buscador en el menú: `ShowSearch` y `MenuItem.Keywords` — [API] · Severidad: Ninguna (nuevo)

- `AstrolMenuAdmin ShowSearch="true"` añade arriba un buscador que filtra las opciones sin distinguir mayúsculas ni
  tildes; todas las palabras deben aparecer en el nombre o en `MenuItem.Keywords` (un submenú cuenta también con las
  de su padre: "board instalación"). Los submenús con coincidencias se abren, los grupos vacíos se ocultan y Esc
  limpia. Textos: `SearchPlaceholder`, `NoResultsText` (por defecto `AstrolText.SearchMenu` / `NoMenuResults`).

## Rediseño visual — Board y Charts

### V-013 · AstrolBoard con los tokens `--aui-*` — [CSS][API] · Severidad: Baja

- `board.css` usa variables propias `--pb-*` que toman los tokens de Basic (`--aui-surface`, `--aui-brand`...) con
  valores de reserva, así el tablero funciona también sin Basic. Buscador, zoom y mini-mapa, menú contextual,
  etiquetas de las relaciones, asas, puertos y vértices siguen el estilo de Basic y el color del tema.
- Las líneas y los vértices ya no llevan `filter: drop-shadow` (se veían borrosos y costaban al pintar cientos de
  relaciones); la línea es `--aui-text-2` de 1,5 px y se resalta al pasar el ratón.
- `MenuOpion`: `IconBackground` e `IconColor` pasan a ser opcionales (antes, fondo verde y texto blanco por
  defecto). Sin ellos el icono es neutro; con `IconBackground` y sin `IconColor`, el icono va en blanco. Para una
  acción peligrosa use `IconColor="var(--aui-danger)"`.

### V-014 · AstrolChart con los tokens `--aui-*` — [CSS] · Severidad: Ninguna

- Textos de ejes y leyenda (`--aui-text-2`), título, cuadrícula (`--aui-border`), barra de herramientas con iconos
  discretos y la herramienta activa con el tinte de la marca, menú de exportar y tooltip como los menús de Basic,
  y selección de zoom del color del tema. Las etiquetas de datos dentro de barras y sectores conservan su color.

### V-015 · AstrolRichText con los tokens `--aui-*` y modo oscuro corregido — [CSS] · Severidad: Ninguna

- `astrol-rich-text.css` usa variables propias `--rt-*` tomadas de los tokens de Basic (con reserva). Barra de
  herramientas en `--aui-surface-2` con los grupos separados por una línea (antes, cajas con fondo que en modo
  oscuro salían blancas y dejaban los iconos invisibles), botones con hover y estado activo con el tinte de la
  marca, desplegables (fuente, tamaño, encabezado, color, alineación) como los menús de Basic, paleta de colores con
  el seleccionado marcado, área de edición con anillo de foco y tooltip de enlaces con botón de la marca.
- `AstrolRichText.razor.css` solo conserva `MinHeight` / `MaxHeight`. Nuevo `bundleconfig.json` para regenerar
  `astrol-rich-text.min.css` con `2-Shared/tools/bundle.py`.

### V-016 · AstrolPDFViewer con los tokens `--aui-*` — [CSS][Comportamiento] · Severidad: Baja

- `AstrolPDFViewer.razor.css` usa variables `--pv-*` tomadas de los tokens de Basic (con reserva). Contenedor con
  borde y radio del tema, barra **Traditional** clara (`--aui-surface`) con los grupos alineados con flex (página a la
  izquierda, zoom en el centro, acciones a la derecha), controles **Modern** flotantes como paneles con borde y
  sombra, campo de página con anillo de foco, carga con el color de la marca y barras de desplazamiento finas. Las
  hojas siguen siendo blancas también en modo oscuro (es el color del documento).
- `Outline` cambia de significado: antes alternaba entre controles oscuros y claros; ahora los colores siguen el
  modo del tema y `Outline="true"` deja los controles solo con borde, sin sombra.

## Componentes nuevos en Astrol.Component.Basic

### V-017 · `AstrolTabs` + `AstrolContentTab` — [API] · Severidad: Ninguna (nuevo)

- Espacio de nombres `Astrol.Component.Basic.Tabs`. `AstrolTabs`: `@bind-ActiveTabIndex`, `Pills`, `KeepAlive`
  (paneles inactivos ocultos que conservan su estado), `AriaLabel`, `Class`, método `SelectAsync(int)`.
  `AstrolContentTab`: `Title`, `Icon`, `Badge`, `Disabled`, `ChildContent`.
- Accesible: `role="tablist"/"tab"/"tabpanel"`, `aria-selected`, `aria-controls`; flechas, Inicio y Fin cambian de
  pestaña y saltan las desactivadas. Cada pestaña se registra al crearse y se quita al eliminarse.
- Si un proyecto tenía su propio `AstrolTabs` (con `IsActive` en `AstrolContentTab`), cambie al de Basic: quite
  `IsActive` (la pestaña activa la decide `ActiveTabIndex`) y el `@using` del componente propio.

### V-018 · `AstrolCheckbox`, `AstrolRadioGroup` + `AstrolRadio` — [API] · Severidad: Ninguna (nuevo)

- `Astrol.Component.Basic.Form`. Inputs nativos (`appearance: none`) con el aspecto del tema: teclado, lectores de
  pantalla y formularios funcionan como siempre.
- `AstrolCheckbox`: `@bind-Value` (bool), `Text` o `ChildContent`, `Indeterminate`, `Disabled`, `AriaLabel`, `Id`,
  `Class`; atributos extra al input. Dentro de un `EditForm` avisa del cambio (`NotifyFieldChanged`) y lleva la clase
  `invalid` si no valida.
- `AstrolRadioGroup<TValue>`: `@bind-Value` de cualquier tipo (se deduce en las opciones), `Horizontal`,
  `Disabled`, `Name`, `AriaLabel`, `Class`; mismo comportamiento en `EditForm`. `AstrolRadio<TValue>`: `Value`,
  `Text` o `ChildContent`, `Disabled`.
- `AstrolGrid` los usa: casillas de selección con `AstrolCheckbox` (la de "seleccionar todo" queda intermedia con
  algunas filas marcadas) y el filtro de columnas `bool`. Se quita su CSS propio de casillas
  (`input[type="checkbox"]` en `AstrolGrid.razor.css` y `Column.razor.css`).

### V-019 · `AstrolDropdown`, `AstrolTooltip`, `AstrolAlert`, `AstrolBadge` y `AstrolStatus` — [API] · Severidad: Ninguna (nuevo)

- `AstrolStatus` (`Astrol.Component.Basic`): `Neutral`, `Brand`, `Info`, `Success`, `Warning`, `Danger`. Da el color
  (y el icono en los avisos) de `AstrolAlert` y `AstrolBadge`.
- `AstrolDropdown` (`Astrol.Component.Basic.Dropdown`): botón con menú de acciones (`role="menu"`) en un popover
  (no lo recortan grids ni modales); sin `Text` es un botón de icono «⋮». `Align` (`Start`/`End`), `ShowChevron`,
  `Disabled`, `AriaLabel`, `ButtonClass`, `OnToggle`, `IsOpen`, `OpenAsync()`, `CloseAsync()`. Opciones:
  `AstrolDropdownItem` (`Text`/`ChildContent`, `Icon`, `Shortcut`, `OnClick` o `Href`+`Target`, `Disabled`, `Danger`,
  `KeepOpen`) y `AstrolDropdownSeparator` (`Title` opcional). Teclado: Intro/Espacio/Flecha abajo abren, flechas e
  Inicio/Fin recorren (saltan las desactivadas), Esc cierra y devuelve el foco, Tab y clic fuera cierran.
- `AstrolTooltip` (`Astrol.Component.Basic.Tooltip`): ayuda al pasar el ratón (`Delay`, 300 ms) o al enfocar con
  teclado; `Text` o `Content`, `Placement` (`Top`/`Bottom`/`Left`/`Right`, se da la vuelta si no cabe). Globo en un
  popover con colores invertidos; el elemento enfocable recibe `aria-describedby`; Esc lo cierra.
- `AstrolAlert` (`Astrol.Component.Basic.Alert`): aviso en la página con `Status` (por defecto `Info`), `Title`,
  `Text`/`ChildContent`, `Actions`, `Icon`, `ShowIcon`, `Closable` + `OnClose`, `Show()`. `role="alert"` en `Danger` y
  `Warning`, `role="status"` en el resto.
- `AstrolBadge` (`Astrol.Component.Basic.Badge`): etiqueta con `Status`, `Text`/`ChildContent`, `Icon` o `Dot`,
  `Outline`, `Title`. Sustituye a usar `AstrolBox` como etiqueta de estado.
- `AstrolText.MoreActions` (texto accesible por defecto del botón «⋮»).
- `AstrolLanguageSwitcher` (`Astrol.Component.Basic.Layout`): control segmentado de idioma (globo + ES | EN con
  marca deslizante). `Languages` (por defecto `es`, `en`), `@bind-Value`, `ShowIcon`, `AriaLabel`, `Class`; el título
  de cada botón es el nombre nativo del idioma. Solo avisa del cambio: guardar la cultura lo hace la aplicación.
  `AstrolText.Language`.

### V-020 · Astrol.JSInterop.Base: sessionStorage y funciones cotidianas — [API] · Severidad: Ninguna (nuevo)

- `GetFromSessionStorage<T>`, `SetInSessionStorage<T>`, `ExistsInSessionStorage`, `RemoveFromSessionStorage` y
  `ClearSessionStorage`: misma API que las de `localStorage` (extensiones de `IJSRuntime`, `useEncrypt` por defecto
  `true`). Internamente local y session comparten el código.
- `AstrolJSInterop`: `DownloadFile(url, fileName)` y `GetTimeZone()` (ya existían en el JS sin método en C#),
  `GetBrowserLanguage()`, `MatchesMedia(query)`, `OpenInNewTab(url)` (con `noopener`), `ScrollToElement(selector,
  smooth)` y `ScrollToTop(smooth)` (también dentro del cuerpo de `AstrolLayoutMenu`).
- `SaveAs` usa un Blob en lugar de una URL `data:`: ya no falla con archivos grandes.
- `useEncrypt` ofusca el valor guardado (no se lee a simple vista); no es cifrado de seguridad: no guardar contraseñas
  ni tokens en el navegador.

### V-021 · Carga inicial y error no controlado de Blazor en `astrol-basic.css` — [CSS] · Severidad: Ninguna (nuevo)

Clases opcionales para `wwwroot/index.html`; se pintan con los tokens `--aui-*`, así que hay que poner
`data-aui-color` / `data-aui-mode` en `<html>` antes de que cargue Blazor (un script en `<head>`).

- Esqueleto: `.aui-boot` con `__top`, `__progress` (barra con `--blazor-load-percentage`), `__side`, `__main`,
  `__cards`, `__pct` (porcentaje) y bloques `.aui-sk` (brillo animado). `data-aui-menu="closed"` en `<html>` estrecha
  el lateral.
- Anillo: `.aui-boot-ring` > `.aui-boot-ring__ring` > `.aui-boot-ring__inner` (porcentaje) + `<small>` opcional.
- Error: `<div id="blazor-error-ui" class="aui-error-ui">` con `.aui-err` > `.aui-err__icon`, `.aui-err__text`
  (`<b>` título + `<span>`), `a.reload` y `a.dismiss` (Blazor los enlaza por clase). Aviso flotante abajo al centro.
- Los estilos antiguos de `#blazor-error-ui` (fondo rojo, icono girando) siguen aplicándose solo al marcado por
  defecto de Blazor (`#blazor-error-ui:not(.aui-error-ui)`).
- Documentador y landing guardan en `localStorage` la clave `aui-boot` en claro (`{color, mode, lang, menu}`) cada vez
  que cambia el tema, el modo, el idioma o el menú; el script de `<head>` la lee para que la carga salga ya con el tema
  del usuario y los textos en su idioma (`[data-es]` / `[data-en]`).

### V-022 · Astrol.Entities.Basic: extensiones reorganizadas y ampliadas — [API] · Severidad: Rompe al compilar si se usan los nombres antiguos

Las extensiones de `Astrol.Entities.Basic.Static.Extensions` se agrupan por tema (texto, colores, números, tamaños de
archivo, fechas, consultas, colecciones, enumeraciones, JSON y copias), aceptan null y no lanzan por un valor vacío.
Documentación: página `/basic-component/extensions` («Extensiones .NET»).

**Renombres / sustituciones** (detección literal → acción):

| Antes | Ahora |
|---|---|
| `text.NormalizeText(true)` (buscar sin tildes) | `text.ToSearchKey()` (minúsculas, sin tildes ni ñ, espacios simplificados) |
| `text.NormalizeText()` | `text.RemoveDiacritics()` (conserva la ñ; `keepEnye: false` la quita) |
| `text.RemoveHtmlTags(isHtml)` | `isHtml ? text.RemoveHtmlTags() : text` (ahora también decodifica entidades) |
| `text.RemoveAllSpaces()` | `text.RemoveWhitespace()` |
| `text.RemoveDoubleSpaces()` | `text.CollapseWhitespace()` |
| `text.FormatName()` | `text.ToTitleCase()` |
| `text.FirstCharToUpper()` | `text.Capitalize()` (ya no pasa el resto a minúsculas) |
| `fileName.ValidateFileExtensions(list)` | `fileName.IsAllowedExtension(list)` (acepta ".pdf" o "pdf") |
| `fileName.GetExtensions()` | `Path.GetExtension(fileName)` |
| `list.ConcatenateString(sep)` | `items.JoinText(sep)` (omite null/vacíos; `skipEmpty: false` para conservarlos) |
| `text.Encrypt(key)` / `text.Decrypt(key)` | `text.Obfuscate(key)` / `text.Deobfuscate(key)` (mismo algoritmo: lo guardado sigue siendo legible) |
| `bytes.ConvertBytesToKB()` / `ConvertByteToMB()` | `bytes.ToKilobytes()` / `ToMegabytes()`; para mostrar: `bytes.ToFileSize()` ("1.5 MB") |
| `size.ConvertToBytes(unit)` | `size.ToBytes(unit)` |
| `32.GenerateRandomKey()` | `Auxiliar.NewKey(32)` |
| `date.DateString(formatType, format, toLocal)` / `DateStringLocalTime(...)` | `date.ToDisplay(format = "g", toLocalTime)` |
| `total.GetPartToTotal_Percent(p)` | `amount.ApplyPercent(p)` |
| `total.Get_Percent(part)` | `part.PercentOf(total)` |
| `n.ToStringMoney(coin)` (decimal/float) | `n.ToMoney(currencyCode)` (formato de moneda de la cultura) |
| `Type.IsPrimitive()` (extensión pública) / `ReferenceEqualityComparer` / `ArrayExtensions.ForEach` | eliminados (internos de DeepClone) |
| `Paginate`/`SortList` sobre `IOrderedQueryable` | las versiones de `IQueryable` (Paginate ya no lanza con Page 0: usa la 1) |

**Nuevas:** `HasValue`, `IfEmpty`, `Truncate`, `ContainsIgnoreAccents`, `ToSlug`, `GetInitials`, `DigitsOnly`,
`IsValidEmail`; `IsHexColor`, `NormalizeHexColor`, `GetContrastRatio` (además de `GetColorContrast`, que pasa a
`ColorExtensions`); `ToCompact`; `ToRelativeTime`, `StartOfDay`, `EndOfDay`, `StartOfWeek`, `StartOfMonth`,
`EndOfMonth`, `IsWeekend`, `GetAge`; `WhereIf` (IQueryable e IEnumerable), `ToPaginatedResponse(GridInfo)`;
`IsNullOrEmpty`, `HasItems`, `OrEmpty`; `GetDisplayName`, `EnumExtensions.ToSelectList<TEnum>()`; `ToJson`,
`FromJson<T>`; `Auxiliar.NewDomId()`. `DeepClone` se reescribió (sin recursión por tipo base, con DateOnly/TimeOnly,
Guid, decimal... como inmutables). `SelectList<T>.Name` y `AstrolPaginatedResponse<T>.PageItems` ya no son null por
defecto.

### V-023 · Tema con color propio en todo AstrolUI — [API][CSS] · Severidad: Ninguna (nuevo)

- `AstrolTheme.Custom` (valor 6) y `data-aui-color="custom"`: `--aui-brand`, `--aui-brand-strong` y `--aui-on-brand`
  salen de `--aui-custom-brand` (obligatoria), `--aui-custom-brand-strong` y `--aui-custom-on-brand` (con valor por
  defecto). Lo usan todos los paquetes, porque todos se pintan con esos tokens.
- `AstrolCustomTheme` (Astrol.Entities.Basic.UI): `GetVariables(hex)`, `GetStyle(hex)` (atributo style) y
  `GetCss(hex, selector)` (hoja de estilo) calculan la versión fuerte (22 % más oscura) y el texto con más contraste.
- `AstrolLayoutMenu.CustomColor`: con `Style="AstrolTheme.Custom"` aplica las variables al layout y a `<html>`.
- `AstrolThemeSwitcher`: `AllowCustomColor` (selector de color), `CustomColor` / `CustomColorChanged`
  (`@bind-CustomColor`), `Colors` (qué colores predefinidos ofrecer) y `ShowTooltips` (por defecto true: nombres y
  acción del modo con AstrolTooltip; false: sin ayuda visible). `SetOutline.ShowTooltip` (bool?: null = title nativo
  como antes, true = AstrolTooltip, false = nada). `AstrolText.ColorCustom`.
- Documentador: color propio en la barra superior (se guarda en `astrolui-custom-color` y en `aui-boot.custom`, que el
  script de `<head>` aplica antes de cargar Blazor) y logo pintado con ese color. Docs: `/theme` (sección «Tema propio»)
  y `/basic-component/theme-switcher`.

### V-024 · Astrol.Shared.Repository pasa a ser gratuito — [Licencia] · Severidad: Ninguna

Desde el 2026-10-24 solo `Astrol.Component.Board` tiene licencia comercial; Repository se suma a los gratuitos (Basic,
Entities, JSInterop, Charts, PDFViewer, RichText). Actualizados: `/license` del documentador y de la landing, chips de
la portada, lista de paquetes de la landing y nota `l_pk_note`.

### V-025 · .NET 10.0.13 y versiones 10.0.13.N — [Paquetes] · Severidad: Ninguna

`AspNetVersion` = 10.0.13 en `2-Shared/Directory.Build.props` (Microsoft.AspNetCore.Components.Web/Authorization,
Identity.EntityFrameworkCore, DependencyInjection) y en las dos aplicaciones (WebAssembly, DevServer, Localization).
Todos los paquetes Astrol.* pasan a **10.0.13.1**. Las apps consumidoras deben usar el runtime/SDK de .NET 10 con
ASP.NET Core 10.0.13 o posterior (las dependencias son `>=`).

---

## Documentación (documentador)

Basic: página **Vista general** (`/overview`, varios componentes juntos), páginas nuevas de **Pagination** y
**ThemeSwitcher**; menú con grupos General / Componentes / Paquetes y el color del tema y el modo arriba a la derecha.
**FileExplorer** sale del documentador (prototipo aplazado): páginas, referencia y entradas del sitemap.
Se quita la página `/basic-component` (las rutas de navegación de Basic llevan a `/overview`); **Repository** pasa
al grupo Paquetes. La página **Tema** cambia el color y el modo al momento, sin recargar: el documentador comparte
el estado en `Class/ThemeState` (servicio scoped) entre el layout, el `AstrolThemeSwitcher` de la barra superior y
la página, y documenta los tokens `--aui-*`. La página **PERENDER** se reescribe: qué es, el problema de las SPA,
cómo funciona (detección del bot, render, caché, recacheo), qué incluye (reglas de indexado, artículos,
categorías, sitemaps alojados, SEO para SPA), integraciones (Cloudflare, IIS/Apache, middleware), API con token y
recomendaciones de `HeadContent` para SPA con AstrolUI.
Página nueva de **Licencia** (`/license`): Basic, Entities.Basic, JSInterop.Base, PDFViewer, Charts y RichText
gratuitos; Repository y Board con licencia comercial (misma condición en la landing, `Astrol.Web.Client/Pages/Legal`).
**Buscador** del documentador en la barra superior (Ctrl+K o "/"): busca en el texto de todas las páginas
(`wwwroot/search/index.{es,en}.json`) y muestra cada resultado con su ubicación en el menú; el menú lateral usa
`ShowSearch`. ContentInput explicado con una comparación con y sin el contenedor y un ejemplo con `EditForm`.
Iconos: PERENDER `astrol-globe`, RichText `astrol-doc-text`, Instalación `astrol-download`, ContentInput
`astrol-i-cursor`.
Páginas nuevas **Tabs** (`/basic-component/tabs`), **Checkbox** (`/form/checkbox`) y **Radio** (`/form/radio`); los
ejemplos del Board usan `AstrolCheckbox` y `AstrolRadioGroup` en lugar de inputs nativos. Páginas **Alert**, **Badge**, **Dropdown** y
**Tooltip**; la Vista general usa `AstrolBadge`, `AstrolAlert`, `AstrolTooltip` y un `AstrolDropdown` «⋮» en las filas
del grid. La URL del menú y del sitemap de Grid pasa a minúsculas (`/basic-component/grid`). Página **Utilidades JS**
(`/basic-component/js-interop`) con demos de almacenamiento, portapapeles, archivos y datos del navegador. El logo
de la barra superior tiene versión para modo oscuro (`img/logos/logo-astrolui-*-dark.svg`: letras claras).

Landing (`Astrol.Web.Client`): rediseño completo con los tokens `--aui-*` (claro, oscuro y los 6 colores sin recargar,
`LandingTheme` + `AstrolThemeSwitcher`): hero con una ventana de demostración hecha con componentes reales
(Tabs, Checkbox, Badge, Dropdown, Toggle, Radio, Alert), comando de instalación copiable, cifras, cinta de
componentes, ventajas en formato «bento», paquetes gratis/comerciales, tres pasos, IA, PERENDER y pie nuevo. Se
quitan `Banner.razor`, `top_menu.css`, `banner.css`, `footer.css`, `animation.css` e imágenes sin uso; los estilos
están en `wwwroot/css/landing.css` (+ `.min`, `bundleconfig.json`). Documentador y landing usan `AstrolLanguageSwitcher` en lugar de
las banderas. Portada del documentador rehecha (hero con logo del tema, comando copiable, «Empiece aquí», catálogo
por grupos, novedades, comunidad y contacto con el LinkedIn del autor). Propuestas de carga inicial y de error no
controlado en `docs/redesign/loading-error-proposals.html`.

Board: **Instalación**, **AstrolBoard** (modelo de datos, ratón y teclado, menús contextuales, anclaje de las líneas,
orden automático, guías, rendimiento, parámetros y métodos), 11 ejemplos (`/board-example`: básico, editor de diagramas, menús del tablero y de las cajas con
`MenuOpion`, anclajes, vértices con menú contextual, orden automático, diapositivas tipo PowerPoint con el logo de AstrolUI en el
color del tema, guías, relaciones, historial y límites) y prueba de rendimiento con 100/500/1000 cajas (`/board-performance`), con el
mismo sistema de código real incrustado que las gráficas. El `sitemap.xml` incluye todas las páginas nuevas
(Novedades, Repository, gráficas y board).

Gráficas: sección nueva con **Instalación**, **AstrolChart** (descripción, ejemplo mínimo, cómo se conectan los
datos, tipos de series, opciones, tema, parámetros, eventos y métodos) y 25 ejemplos en 5 páginas (básicas,
circulares, otros tipos, rangos y finanzas, interacción). Cada ejemplo es un componente de
`Pages/Chart/Examples` y la documentación muestra su archivo real (recurso incrustado), así que el código mostrado
es el que se ejecuta. Se quitan la página `/chart/line` y los datos de ejemplo antiguos; `/chart/chart-example`
lleva a las gráficas básicas.

Revisión completa de las páginas de Astrol.Component.Basic contra el código (parámetros, valores por
defecto y ejemplos que compilan): Assign, Box, Breadcrumb, Button, Icon, Title, Load, Confirm, Modal,
Notification, UploadFile, LayoutMenu, MenuAdmin, ComboBox, ContentInput, InputPassword, Label, Toggle
(antes era una copia de Label) y Grid (demo 2 con `SortList`/`Paginate` y su ejemplo de código).

Actualizado en el documentador (`Astrol.Web.UI.Docuemnt`), en español e inglés (`Resource.resx` / `Resource.en.resx`):
- Nueva página **Novedades / What's new** (`/whats-new`, primera del menú) con el resumen del refactor y
  los pasos de migración para personas; esta guía sigue siendo la referencia completa.
- Instalación (sin bootstrap ni interact.js, `AddAstrolBasic()`), Grid (`Field`, `Format`, `Virtualize`,
  `KeySelector`, `SortList`/`Paginate`), ComboBox (`Display`, `@bind-Value`), Modal (`<dialog>`,
  `IAstrolModal.ShowAsync`), Confirm (`IAstrolModal.ConfirmAsync`), Notification (`IAstrolToast`,
  `AllowHtml`), Layout menu (`Mode`, `OnChangeThemeMode`, `ApplyThemeToDocument`, `IncludeServiceHosts`)
  y Theme (`data-aui-*`, modo automático).

---

## Herramientas para mantener la librería

- `python 2-Shared/tools/docs_ai_export.py` genera la documentación para IA (formato llms.txt): `wwwroot/llms.txt`
  (índice), `wwwroot/llms-full.txt` (todo junto) y `wwwroot/ai/<página>.txt` (Markdown de cada página con su código
  real, en inglés) más `ai/migration.txt` (esta guía). Página **Para IA** (`/for-ai`) y enlace «Markdown para IA» al
  pie de cada página. Se usa `.txt` porque IIS no sirve `.md` sin tipo MIME.
- `python 2-Shared/tools/docs_search_index.py` regenera el índice del buscador del documentador a partir de las
  páginas y de `Resource.resx` / `Resource.en.resx`. Ejecútelo cuando cambien textos o páginas.
- `python 2-Shared/tools/bundle.py [carpeta-proyecto]` regenera los `.min.css` / `.min.js` desde el
  `bundleconfig.json` de cada proyecto (mismo formato que la extensión *Bundler & Minifier*).
  Concatena, reescribe `url(...)` relativas y minifica.
- `2-Shared/Directory.Build.props` define `$(AspNetVersion)` (10.0.8) para todos los paquetes
  `Microsoft.AspNetCore.*`; al pasar a otra versión de .NET basta con cambiarla ahí.
- La configuración de fontello para regenerar la fuente está en
  `Astrol.Component.Basic/Icons/fontello-config.json`; la fuente maestra completa en
  `Icons/fontello.woff2` y la lista del núcleo en `Icons/core-icons.txt` (nada de `Icons/` se publica).
- `python 2-Shared/tools/split_icons.py` genera `fontello-core.woff2` / `fontello-extra.woff2` y
  actualiza los `@font-face` de `fontello.min.css` (requiere `pip install fonttools brotli`).

## Pendiente (próximos lotes)

- **Publicación:** la primera versión del refactor se publicó el 2026-10-23 (ver [PUBLICACION.md](PUBLICACION.md)):
  Entities.Basic 10.0.8.3, JSInterop.Base 10.0.8.2, Shared.Repository 10.0.8.2, Component.Basic 10.0.8.8, Board
  10.0.8.2, Charts 10.0.8.2, PDFViewer 10.0.8.5, RichText 10.0.8.2, Model.Authorization 10.0.8.2 y
  Component.Authorization 10.0.8.8.
- **PDFViewer:** los PDF con fuentes CJK sin incrustar necesitarían `cmaps` de pdf.js (no se incluyen, igual que antes).
- **FileExplorer (aplazado):** es un prototipo (explorador, árbol `AstrolTree` y detección de tipos de archivo) que
  no se usa en proyectos reales. No se refactoriza por ahora ni entra en la primera publicación del refactor. Más
  adelante: pasar el árbol a Basic como componente independiente y, si hace falta, terminar el explorador sobre él
  (menús contextuales, arrastrar y soltar, renombrar, selección múltiple, teclado, carga bajo demanda).
- **Authorization:** se descontinuará; se revisa al final.
- **Rediseño visual:** hecho para Basic (sección "Rediseño visual"); faltan Board, Charts, RichText y PDFViewer
  (de momento heredan la paleta nueva a través de los alias).