xonecode 0.1.0

package/skills/xone-development/references/fundamentos/plataforma-y-anatomia-de-proyecto.md

@@ -0,0 +1,387 @@
+# XOne — Plataforma y anatomía de un proyecto
+
+> Fuente: `xone/v2/xone-help-docs/topics/01-xone-fundamentals.md` §1–§3, §5. Referencia de la skill; el índice está en [../../SKILL.md](../../SKILL.md).
+
+Contenido: §1 qué es XOne · §2 arquitectura: modelo declarativo + imperativo, ciclo de vida colección/objeto/propiedad, flujo de datos, sincronización con servidor · §3 anatomía del proyecto: archivos y carpetas obligatorias y opcionales, diagrama de estructura · §5 tipos de archivo
+
+---
+
+## 1. Que es XOne?
+
+XOne es una **plataforma de desarrollo de aplicaciones móviles** que permite generar apps nativas para Android e iOS a partir de un único código fuente. A diferencia de otros frameworks multiplataforma, XOne utiliza un enfoque **declarativo basado en XML** para definir la interfaz de usuario, combinado con **JavaScript** para la lógica de negocio.
+
+### Componentes del Ecosistema
+
+El ecosistema XOne se compone de tres elementos principales:
+
+| Componente | Descripción |
+|------------|-------------|
+| **Framework XOne** | Motor que interpreta los archivos XML, CSS y JS para generar las interfaces nativas en cada plataforma |
+| **Runtime XOne** | Entorno de ejecución que corre en el dispositivo móvil, renderizando la UI y ejecutando la lógica |
+| **Servidor de Replica** | Componente de backend que permite la sincronización bidireccional de datos entre dispositivos y servidor central |
+
+### Que hace diferente a XOne?
+
+Si vienes del desarrollo web, estas analogias te ayudaran a entender la filosofia de XOne:
+
+| Concepto Web | Equivalente XOne | Diferencia Clave |
+|-------------|-----------------|------------------|
+| HTML | Archivos `.xne` (XML) | XOne usa nodos como `<coll>`, `<prop>`, `<frame>` en vez de `<div>`, `<input>`, `<span>` |
+| CSS | `default.css` | Sintaxis similar pero con atributos propietarios; unidades `p` y `%` en vez de `px` y `em` |
+| JavaScript | `functions.js` | API propia (`ui.*`, `self.*`, `appData.*`) en vez de APIs del navegador (`document.*`, `window.*`) |
+| Base de datos | `bd/gestion.db` (SQLite) | Base de datos local integrada que se sincroniza automáticamente con el servidor |
+
+> **Nota importante:** Aunque la sintaxis pueda parecer familiar, XOne NO es desarrollo web. No tiene DOM, no tiene navegador, no tiene `document` ni `window`. Las APIs son completamente propias de la plataforma.
+
+### Ventajas Principales
+
+1. **Código único, apps nativas**: Un solo proyecto genera apps para Android e iOS con rendimiento nativo
+2. **Funcionamiento offline**: La base de datos SQLite local permite trabajar sin conexión
+3. **Sincronización automática**: El sistema de replica sincroniza datos cuando hay conectividad
+4. **Desarrollo rápido**: El modelo declarativo reduce drasticamente el código necesario
+5. **Sin compilación**: Los cambios en XML/CSS/JS se reflejan sin necesidad de recompilar
+
+---
+
+## 2. Arquitectura de XOne
+
+### 2.1 Modelo Declarativo + Imperativo
+
+XOne combina dos paradigmas de programación:
+
+**Declarativo (XML):** Define QUE mostrar en la pantalla. Se usa para:
+- Estructura de la interfaz de usuario
+- Definición de campos y tipos de datos
+- Layout y posicionamiento de elementos
+- Configuración de eventos
+
+**Imperativo (JavaScript):** Define COMO comportarse. Se usa para:
+- Lógica de negocio
+- Validaciones complejas
+- Navegación programatica
+- Integraciones con APIs externas
+- Manipulación de datos
+
+```
+ +-----------------------+     +------------------------+
+ |    XML Declarativo    |     |  JavaScript Imperativo |
+ |  (.xne / .xml / .css)|     |       (.js)            |
+ +-----------+-----------+     +-----------+------------+
+             |                             |
+             v                             v
+       +-----+-----------------------------+------+
+       |        Runtime XOne (Dispositivo)        |
+       |  - Renderiza UI nativa                   |
+       |  - Ejecuta logica JS                     |
+       |  - Gestiona BD local                     |
+       |  - Sincroniza con servidor               |
+       +------------------------------------------+
+                         |
+               +---------+---------+
+               |                   |
+         +-----+------+    +------+------+
+         |  Android   |    |    iOS      |
+         |  (Nativo)  |    |  (Nativo)   |
+         +------------+    +-------------+
+```
+
+### 2.2 Ciclo de Vida: Coleccion, Objeto, Propiedad
+
+El modelo de datos de XOne se organiza en tres niveles jerarquicos. Si vienes de bases de datos, la analogia es directa:
+
+| Nivel XOne | Equivalente BD | Equivalente Web | Descripción |
+|------------|---------------|-----------------|-------------|
+| **Coleccion** (`coll`) | Tabla | Página/Componente | Define estructura de datos + UI |
+| **Objeto** (DataObject) | Fila/Registro | Instancia | Una unidad de datos concreta |
+| **Propiedad** (`prop`) | Columna/Campo | Input/Label | Un dato individual + su representación visual |
+
+Cada coleccion tiene su propio ciclo de vida con eventos bien definidos:
+
+```
+  Coleccion creada
+       |
+       v
+   [create]  -->  Se ejecuta una sola vez al crear la instancia
+       |
+       v
+    [load]   -->  Se ejecuta cada vez que la pantalla se muestra
+       |
+       v
+  [onchange] -->  Se ejecuta cuando cambia el valor de un campo
+       |
+       v
+  [onback]   -->  Se ejecuta cuando el usuario pulsa el boton "atras"
+```
+
+**Ejemplo práctico del ciclo de vida:**
+
+```xml
+<coll name="DetalleTarea" title="Detalle de Tarea">
+    <!-- Se ejecuta UNA vez al crear la coleccion -->
+    <create>
+        <action name="runscript">
+            <script language="javascript">
+                // Inicializar valores por defecto
+                self.MAP_FECHA = new Date();
+                self.MAP_ESTADO = "PENDIENTE";
+            </script>
+        </action>
+    </create>
+
+    <!-- Se ejecuta CADA VEZ que la pantalla se muestra -->
+    <load>
+        <action name="runscript">
+            <script language="javascript">
+                // Actualizar contadores o datos dinamicos
+                actualizarContador();
+            </script>
+        </action>
+    </load>
+
+    <!-- Se ejecuta cuando CAMBIA el valor de un campo -->
+    <onchange>
+        <field name="MAP_ESTADO">
+            <action name="runscript">
+                <script language="javascript">
+                    // Reaccionar al cambio de estado
+                    if (self.MAP_ESTADO == "COMPLETADA") {
+                        self.MAP_FECHA_FIN = new Date();
+                    }
+                </script>
+            </action>
+        </field>
+    </onchange>
+
+    <!-- Contenido de la pantalla aquí -->
+
+    <!-- Se ejecuta al pulsar ATRAS -->
+    <onback>
+        <action name="runscript">
+            <script language="javascript">
+                let window = ui.getView(self);
+                if (window) {
+                    window.exit();
+                }
+            </script>
+        </action>
+    </onback>
+</coll>
+```
+
+### 2.3 Flujo de Datos
+
+El flujo de datos en XOne sigue un patron claro entre la base de datos local, las colecciones en memoria y la interfaz de usuario:
+
+```
+  +----------------+          +-------------------+          +----------+
+  | BD Local       |  <---->  | Coleccion         |  <---->  | UI       |
+  | (gestion.db)   |  SQL     | (objetos en       |  binding | (props,  |
+  | SQLite         |          |  memoria)         |          |  frames) |
+  +----------------+          +-------------------+          +----------+
+         ^
+         |  Sincronización
+         v
+  +----------------+
+  | Servidor       |
+  | de Replica     |
+  +----------------+
+```
+
+1. **BD Local -> Coleccion**: Las colecciones cargan datos de SQLite mediante el atributo `sql`
+2. **Coleccion -> UI**: Las propiedades (`prop`) muestran los datos de la coleccion automáticamente
+3. **UI -> Coleccion**: Cuando el usuario edita un campo, el valor se actualiza en el objeto (DataObject)
+4. **Coleccion -> BD Local**: Al llamar a `save()`, los cambios se persisten en SQLite
+5. **BD Local <-> Servidor**: El sistema de replica sincroniza los datos bidireccionalmente
+
+### 2.4 Sincronización con Servidor
+
+La sincronización es una de las caracteristicas más poderosas de XOne. Cada registro en la base de datos tiene un campo `ROWID` que contiene un GUID (identificador único global) de 32 caracteres hexadecimales. Este GUID permite:
+
+- Identificar de forma única cada registro en cualquier dispositivo
+- Resolver conflictos de sincronización
+- Mantener la integridad referencial entre dispositivos
+
+```
+  Dispositivo A          Servidor            Dispositivo B
+  +----------+          +--------+          +----------+
+  | ROWID:   |  push    |        |  pull    | ROWID:   |
+  | a1b2c3.. | -------> | a1b2.. | -------> | a1b2c3.. |
+  +----------+          +--------+          +----------+
+```
+
+> **Nota:** El `ROWID` es una **columna de plataforma**: el framework la crea y la rellena sola (autogenera el GUID de 32 caracteres hex en cada alta) y el motor de réplica la usa como clave global de fila. **No hace falta declararla** como `<prop>` (igual que el `ID`); declararla es válido pero redundante, así que mejor omitirla por limpieza.
+
+---
+
+## 3. Anatomia de un Proyecto XOne
+
+### 3.1 Archivos Obligatorios
+
+Todo proyecto XOne requiere estos archivos en la raiz:
+
+| Archivo | Proposito | Equivalente Web |
+|---------|-----------|-----------------|
+| `app.xml` | Configuración global de la aplicación | `package.json` + configuración del framework |
+| `app.ini` | Metadatos de la aplicación (nombre, icono) | `manifest.json` |
+| `mappings.xne` | Colecciones base (Empresas y Usuarios) | Schema de base de datos |
+| `default.css` | Estilos globales de la aplicación | Archivo CSS global |
+| `functions.js` | Funciones JavaScript compartidas | Archivo JS de utilidades |
+| `EntradaApp.xne` | Pantalla de entrada de la aplicación | `index.html` |
+
+Además, cada coleccion adicional y cada pantalla se define en su propio archivo `.xne`:
+
+```
+MenuPrincipal.xne     -->  Pantalla del menu principal
+ListaTareas.xne       -->  Pantalla con lista de tareas
+DetalleTarea.xne      -->  Pantalla de detalle/edicion
+Tareas.xne            -->  Definición de coleccion (tabla + campos)
+Categorias.xne        -->  Otra coleccion
+```
+
+### 3.2 Carpetas Obligatorias
+
+| Carpeta | Contenido | Por que es obligatoria |
+|---------|-----------|----------------------|
+| `bd/` | `gestion.db` (base de datos SQLite) | Sin BD la app no puede almacenar ni consultar datos |
+| `icons/` | Iconos y recursos gráficos (PNG, JPG, SVG) | La app necesita iconos para botones, menú, etc. (el splash NO va aquí — ver §4.1) |
+| `files/` | Archivos dinámicos (fotos, firmas, documentos) | Directorio de trabajo para archivos generados en runtime |
+
+### 3.3 Carpetas Opcionales
+
+| Carpeta | Contenido | Cuando usarla |
+|---------|-----------|---------------|
+| `fonts/` | Fuentes tipograficas (.ttf, .otf) | Cuando necesitas tipografía personalizada |
+| `lang/` | Subcarpetas por idioma (`en/`, `es/`, `fr/`) | Para apps multiidioma |
+| `native/` | Código nativo (`Android/`, `IOS/`) | Para integraciones nativas avanzadas |
+| `scripts/` | Scripts JS organizados en subcarpetas | En proyectos grandes con mucho JS |
+| `certificates/` | Certificados SSL/TLS (.crt, .pem) | Para conexiones seguras personalizadas |
+
+### 3.4 Diagrama de Estructura Completa
+
+A continuacion, el diagrama de un proyecto XOne típico. Los elementos marcados con `[OBL]` son obligatorios:
+
+```
+MiProyectoXOne/
+|
+|-- app.xml                    [OBL] Configuración de la aplicacion
+|-- app.ini                    [OBL] Metadatos (nombre, icono)
+|-- mappings.xne               [OBL] SOLO Empresas y Usuarios
+|-- default.css                [OBL] Estilos globales
+|-- functions.js               [OBL] Funciones JS globales
+|-- EntradaApp.xne             [OBL] Pantalla de entrada
+|-- splash.png                 [OPC] Imagen de splash (ver §4.1 "Pantalla de splash")
+|
+|-- MenuPrincipal.xne          Pantalla del menu
+|-- Login.xne                  Pantalla de login
+|-- ListaClientes.xne          Pantalla de listado
+|-- DetalleCliente.xne         Pantalla de detalle
+|-- Clientes.xne               Colección (datos de clientes)
+|-- Productos.xne              Colección (datos de productos)
+|
+|-- bd/                        [OBL] Base de datos
+|   +-- gestion.db             Archivo SQLite
+|
+|-- icons/                     [OBL] Recursos gráficos
+|   |-- app_icon.png           Icono de la app (192x192)
+|   |-- ic_menu.png            Icono de menú (48x48)
+|   |-- ic_search.png          Icono de búsqueda (48x48)
+|   +-- ic_arrow_back.png      Flecha atrás (48x48)
+|
+|-- files/                     [OBL] Archivos dinamicos
+|   |-- fotos/
+|   |-- documentos/
+|   +-- firmas/
+|
+|-- fonts/                     [REC] Fuentes tipograficas
+|   |-- Roboto-Regular.ttf
+|   +-- Roboto-Bold.ttf
+|
+|-- scripts/                   [OPC] Scripts organizados
+|   |-- login/
+|   +-- general/
+|
++-- lang/                      [OPC] Multiidioma
+    |-- en/
+    +-- es/
+```
+
+> **Regla crítica:** El archivo `mappings.xne` SOLO debe contener las colecciones `Empresas` y `Usuarios`. Todas las demas colecciones van en archivos `.xne` separados, uno por cada coleccion. Ver sección [4.3 mappings.xne](#43-mappingsxne) para más detalle.
+
+## 5. Tipos de Archivos en XOne
+
+XOne utiliza varios tipos de archivos, cada uno con un proposito especifico:
+
+| Extensión | Tipo | Proposito | Equivalente Web |
+|-----------|------|-----------|-----------------|
+| `.xne` | XML propietario | Definición de colecciones y pantallas | `.html` + `.json` (schema) |
+| `.css` | CSS propietario | Estilos visuales (NO es CSS web estándar) | `.css` (con diferencias importantes) |
+| `.js` | JavaScript | Lógica de negocio y funciones | `.js` (API diferente) |
+| `.xml` | XML estándar | Configuración (`app.xml`) | Archivos de configuración |
+| `.ini` | Texto plano | Metadatos (`app.ini`) | `.env` / `manifest.json` |
+| `.db` | SQLite | Base de datos local | Base de datos del backend |
+
+### Archivos .xne (fuente) vs .xml (generado por XOneStudio)
+
+En XOne hay una distincion fundamental entre **fuente** y **salida generada**:
+
+| Extensión | Rol | Quien lo edita |
+|-----------|-----|----------------|
+| `.xne` | **Fichero fuente** de colecciones y pantallas | El programador (y la IA) — es lo único que se edita |
+| `.xml` (de colecciones/pantallas) | **Artefacto generado automáticamente** por XOneStudio a partir del `.xne` correspondiente | **Nadie** — se regenera solo |
+| `app.xml` | Configuración global de la aplicación (única excepción) | El programador — es fuente, no tiene `.xne` que lo genere |
+
+Los archivos `.xne` son el corazón de XOne. Aunque tienen contenido XML, usan la extensión `.xne` (XOne Native Extensión). Un mismo archivo `.xne` puede definir:
+
+- **Una coleccion de datos** (como una tabla de BD con sus campos)
+- **Una pantalla** (con su layout, botones y lógica)
+- **Ambas cosas a la vez** (coleccion + presentación visual)
+
+#### Por que existen los `.xml` de colecciones
+
+XOneStudio genera automáticamente un `.xml` por cada `.xne` porque **algunos motores de ejecución del framework todavia leen `.xml`**. No son ficheros legacy ni restos de proyectos antiguos: se generan hoy, en proyectos nuevos, como artefacto de build. El plan de futuro es que desaparezcan y todo quede solo en `.xne`.
+
+#### Regla operativa: solo `.xne`
+
+> **Al trabajar sobre un proyecto XOne (nuevo o existente), solo se tocan los ficheros `.xne`. Los `.xml` de colecciones o pantallas que aparezcan se ignoran por completo: no se leen, no se editan, no se consultan, no se crean. La única excepción es `app.xml` (configuración global), que SI es fuente.**
+
+Esto aplica tanto si el proyecto tiene solo `.xne` como si tiene `.xne` y `.xml` conviviendo. La coexistencia es normal hoy en día; el trabajo con IA se comporta como si los `.xml` (excepto `app.xml`) no existieran.
+
+### Archivos .css (Estilos Propietarios)
+
+El CSS de XOne se parece al CSS web pero tiene diferencias cruciales:
+
+| Caracteristica | CSS Web | CSS XOne |
+|---------------|---------|----------|
+| Unidades de medida | `px`, `em`, `rem`, `vw` | `p` (puntos), `%` (porcentaje) |
+| Selectores | `#id`, `.clase`, `tag`, `[attr]` | `coll`, `prop`, `prop:TYPE`, `.clase` |
+| Herencia | `inherit`, cascada natural | `extends:.otraClase` |
+| Colores | `#RGB`, `rgb()`, `hsl()`, nombres | `#RRGGBB`, `#AARRGGBB` |
+| Modelo de caja | `box-sizing`, `margin`, `padding` | `tmargin`, `bmargin`, `lmargin`, `rmargin` |
+
+> Para la referencia completa de atributos CSS, consulta el tópico 04 - Estilos CSS en XOne.
+
+### Archivos .js (JavaScript)
+
+El JavaScript de XOne usa un motor propio con APIs específicas:
+
+```javascript
+// Esto NO funciona en XOne (APIs del DOM):
+document.getElementById("miCampo");     // NO existe
+window.addEventListener("click", fn);   // NO existe
+localStorage.setItem("key", "val");     // NO existe
+
+// Esto SÍ funciona en XOne (APIs propias):
+self.MAP_CAMPO;                         // Acceder a un campo
+ui.showToast("Mensaje");                // Mostrar notificación
+appData.getCollection("Tareas");        // Obtener coleccion
+$http.get(url, request, ok, err);       // Petición HTTP (forma idiomática)
+
+// Esto también funciona (implementación custom XOne, compatible con spec):
+fetch("https://api.com/datos").then(r => r.json());       // sí existe
+new Promise((resolve, reject) => { resolve(42); });        // sí existe (ES2024)
+setTimeout(() => console.log("hola"), 1000);               // sí existe
+class Tarea { constructor(t) { this.titulo = t; } }       // sí existe
+```
+
+> Para la referencia completa de la API JavaScript, consulta el tópico 03 - API JavaScript.
+

package/skills/xone-development/references/indice-completo.md

@@ -0,0 +1,77 @@
+# Índice completo de las referencias
+
+> Referencia de `xone-development`. Sale del `SKILL.md` para que las reglas
+> duras quepan en una lectura por omisión (100 líneas).
+
+## Referencias
+
+Lee el fichero que corresponda antes de responder sobre atributos concretos, valores admitidos o ejemplos.
+
+### Fundamentos
+- [fundamentos/plataforma-y-anatomia-de-proyecto.md](references/fundamentos/plataforma-y-anatomia-de-proyecto.md) — Qué es XOne, arquitectura, ciclo de vida colección/objeto/propiedad, sincronización, anatomía de carpetas y tipos de fichero
+- [fundamentos/configuracion-app-xml-ini-mappings.md](references/fundamentos/configuracion-app-xml-ini-mappings.md) — `app.xml` atributo por atributo, `app.ini` y `mappings.xne`
+- [fundamentos/conceptos-clave.md](references/fundamentos/conceptos-clave.md) — Colecciones, DataObject, props, `##PREF##`, macros del sistema, códigos de error y detalle de la sintaxis JS soportada
+- [fundamentos/navegacion-convenciones-y-primer-proyecto.md](references/fundamentos/navegacion-convenciones-y-primer-proyecto.md) — Flujo Splash→Login→EntradaApp→Menu, convenciones de nombres y creación de un proyecto básico paso a paso
+- [fundamentos/errores-comunes.md](references/fundamentos/errores-comunes.md) — Errores frecuentes al empezar y su corrección
+
+### XML / UI
+- [xml-ui/estructura-y-nodo-coll.md](references/xml-ui/estructura-y-nodo-coll.md) — Introducción a la UI y nodo `coll`: colecciones de datos vs especiales, valores de `progid`, `sql`, `loadall`
+- [xml-ui/nodos-group-y-frame.md](references/xml-ui/nodos-group-y-frame.md) — `group` (fijos, drawer, tabs) y `frame` (flotantes, bottom sheet, flujo de layout y `newline`)
+- [xml-ui/prop-atributos-y-condiciones.md](references/xml-ui/prop-atributos-y-condiciones.md) — Atributos comunes de `prop`, visibilidad completa, dimensiones, estilos inline, comportamiento, bordes, `disablevisible`/`disableedit`
+- [xml-ui/prop-tipos-basicos.md](references/xml-ui/prop-tipos-basicos.md) — Props de texto, número, label, botón, checkbox, fecha/hora, imagen (con animaciones Lottie y GIF), foto (con foto en movimiento), vídeo y escáner
+- [xml-ui/prop-tipos-listas-y-mapas.md](references/xml-ui/prop-tipos-listas-y-mapas.md) — Props de mapa, grid/lista, chips, kanban y coverflow
+- [xml-ui/prop-tipos-combos-y-controles.md](references/xml-ui/prop-tipos-combos-y-controles.md) — Combos, web, slider, progress, stepper, OTP, markdown, navbar, password, adjunto, THTML, firma DR, `onchange`, `updates` y `formula`
+- [xml-ui/contents-y-macros.md](references/xml-ui/contents-y-macros.md) — `contents` (vinculación, filtros dinámicos) y macros (sistema, `setMacro`/`getMacro`)
+- [xml-ui/asfilter-visibilidad-eventos-y-macros.md](references/xml-ui/asfilter-visibilidad-eventos-y-macros.md) — `asfilter`, event handlers detallados, sistema de visibilidad y catálogo de macros del sistema
+- [xml-ui/patrones-de-pantalla.md](references/xml-ui/patrones-de-pantalla.md) — Plantillas completas de pantalla: login, menú, lista con filtros, detalle, tabs, mapa, chat, dashboard, maestro-detalle, edición en línea, multi-selección
+- [xml-ui/layouts-herencia-y-buenas-practicas.md](references/xml-ui/layouts-herencia-y-buenas-practicas.md) — Layouts responsive, modales, FAB, herencia con `inherits`, `include-layout`, checklist de validación y unicidad de nombres
+- [xml-ui/atributos-coll-group-frame.md](references/xml-ui/atributos-coll-group-frame.md) — Cualquier atributo de `coll`, `group` o `frame` con tipo, valores y default
+- [xml-ui/atributos-prop.md](references/xml-ui/atributos-prop.md) — Cualquier atributo de `prop`: colores por estado, bordes, entrada, multimedia, ML, `classid`, sliders, stepper, OTP, kanban, coverflow, chips
+- [xml-ui/atributos-method-macro-script-event-app.md](references/xml-ui/atributos-method-macro-script-event-app.md) — Atributos de `method`, `macro`, `script`, `event`, `platform`, tipos y atributos globales de la app
+- [xml-ui/mappings-y-colecciones-separadas.md](references/xml-ui/mappings-y-colecciones-separadas.md) — `mappings.xne` obligatorio y colecciones en archivos separados
+- [xml-ui/mapas.md](references/xml-ui/mapas.md) — Mapas completos: atributos, eventos y API JavaScript del control
+- [xml-ui/eventos-ciclo-de-vida-e-interaccion.md](references/xml-ui/eventos-ciclo-de-vida-e-interaccion.md) — Catálogo de eventos: ciclo de vida e interacción (`onclick`, `onchange`, `selecteditem`, `onlongpressitem`, `onback`)
+- [xml-ui/eventos-sistema-login-y-personalizados.md](references/xml-ui/eventos-sistema-login-y-personalizados.md) — Eventos de drawer y bottom sheet, login, sistema (`onpushreceived`, `maintenance`, `sys-message`), ciclo de aplicación, inactividad, personalizados con `ExecuteNode` y acciones
+- [xml-ui/errores-comunes-xml.md](references/xml-ui/errores-comunes-xml.md) — Errores comunes de XML y su corrección
+
+### JavaScript
+- [javascript/motor-js-y-contexto-de-ejecucion.md](references/javascript/motor-js-y-contexto-de-ejecucion.md) — Motor JS, cómo se ejecuta desde eventos XML, diferencias con JS web, ámbitos y persistencia de variables, escape XML/CDATA en `.xne`
+- [javascript/self-y-dataobject.md](references/javascript/self-y-dataobject.md) — `self`: campos, `getOldValue`, `getOwnerCollection`, `getContents`, `setFieldPropertyValue`, `executeNode`, `save`, JSON y métodos de `DataCollection`
+- [javascript/ui-navegacion-mensajes-y-vista.md](references/javascript/ui-navegacion-mensajes-y-vista.md) — `ui`: navegación, `msgBox`/`showToast`/`showSnackbar`, refresco y acceso a controles, showcase, date/time pickers
+- [javascript/ui-gps-camara-y-multimedia.md](references/javascript/ui-gps-camara-y-multimedia.md) — `ui`: GPS completo, cámara (`startCamera` con foto en movimiento), escáner de documentos (`scanDocument`), OCR (`recognizeText`), archivos, firma, escáner QR, sleep y timers
+- [javascript/ui-catalogo-de-metodos.md](references/javascript/ui-catalogo-de-metodos.md) — `ui`: `executeActionAfterDelay`, cronómetros, API de Stepper y OTP, voz (TTS/STT), audio y catálogo completo de métodos
+- [javascript/coleccion-error-y-usuario.md](references/javascript/coleccion-error-y-usuario.md) — API completa de la colección actual (browse, filtros, búsqueda full-text, macros, metadatos, SQL, JSON), objeto de error y usuario logueado
+- [javascript/objetos-creables-a-m.md](references/javascript/objetos-creables-a-m.md) — Creables de FileManager a Animation (SqlManager, IniParser, AndroidIntent, Bluetooth, OAuth2, Worker)
+- [javascript/objetos-creables-n-z.md](references/javascript/objetos-creables-n-z.md) — Creables de Socket a XOneSigner (NFC, ImageDrawing, BarcodeGenerator, XOnePrinter, XOnePDF, OCR) y la lista canónica completa
+- [javascript/singletons-globales.md](references/javascript/singletons-globales.md) — API de cada singleton global
+- [javascript/patrones-criticos-seguridad-y-rendimiento.md](references/javascript/patrones-criticos-seguridad-y-rendimiento.md) — Patrones críticos (lock/unlock, browse, filter/restore, contexto en callbacks), seguridad y rendimiento
+- [javascript/plantillas-y-funciones-utilitarias.md](references/javascript/plantillas-y-funciones-utilitarias.md) — Plantillas completas: CRUD, filtrado, maestro-detalle, GPS, fotos, chat, QR, login; y utilidades para `functions.js`
+- [javascript/debugging-y-best-practices.md](references/javascript/debugging-y-best-practices.md) — Debugging de JavaScript y top 20 de buenas prácticas
+- [javascript/metodos-de-los-controles.md](references/javascript/metodos-de-los-controles.md) — Métodos que expone cada control por tipo: campos, numéricos, multimedia, listas, mapas, gráficas, AR, frames
+- [javascript/metodos-nativos-de-la-vista.md](references/javascript/metodos-nativos-de-la-vista.md) — Métodos que expone la vista nativa de Android/iOS bajo el frame o el control, no XOne: `setBlur`, `setSaturation`, sin contrato de compatibilidad
+- [javascript/patrones-de-navegacion-datos-y-codigo.md](references/javascript/patrones-de-navegacion-datos-y-codigo.md) — Patrones de navegación, de datos y patrones críticos de código
+- [javascript/patrones-de-ui-voz-integracion-y-seguridad.md](references/javascript/patrones-de-ui-voz-integracion-y-seguridad.md) — Patrones de UI, control por voz, integración y seguridad
+- [javascript/objeto-ai-llm-en-dispositivo.md](references/javascript/objeto-ai-llm-en-dispositivo.md) — Objeto `ai`: LLM en el dispositivo, descarga de modelos, `generate`, `chat` con streaming, function calling, skills y formatos
+
+### CSS
+- [css/selectores-unidades-colores.md](references/css/selectores-unidades-colores.md) — Selectores en detalle, unidades, paletas y formatos de color
+- [css/propiedades-y-herencia.md](references/css/propiedades-y-herencia.md) — Atributos por categoría con ejemplos largos (dimensiones, márgenes, padding, fuentes, texto, fondo, bordes, sombras, visibilidad, Material) y el sistema `extends` completo
+- [css/atributos-por-categoria.md](references/css/atributos-por-categoria.md) — Tablas compactas de atributos por categoría, incluidas etiquetas, checkbox/toggles, imágenes e iconos, atributos de `coll`, machine learning y la tabla de transparencia alpha
+- [css/dinamicos-cascada-y-componentes.md](references/css/dinamicos-cascada-y-componentes.md) — `##FLD_CAMPO##`, cascada de dispositivo, `strict-mode`, animaciones y tokens, gráficos, calendario y mapa
+- [css/patrones-material-y-temas.md](references/css/patrones-material-y-temas.md) — Patrones Material (header/body/footer, botones, inputs, tarjetas, FAB, toolbar, item de lista), temas light/dark y un `default.css` + `colors.css` completos y comentados
+- [css/buenas-practicas-y-parser.md](references/css/buenas-practicas-y-parser.md) — Buenas prácticas, anti-patrones, checklist de validación y detalle de las funciones del parser (`@import`, variables, `calc()`, `!important`, `!default`, `@extend`, modo estricto)
+
+### Datos e integración
+- [datos/appdata.md](references/datos/appdata.md) — `appData` completo: colecciones, login/logout, paso de datos entre pantallas, macros globales, SQL directo, detección de dispositivo, `loadIncludeFile` y `loadCssFile`
+- [datos/http.md](references/datos/http.md) — `$http`: verbos, descarga de fichero, futures y llamadas en paralelo, TLS y mutual TLS, pinning, proxy y WebSocket
+- [datos/oauth2-y-replica.md](references/datos/oauth2-y-replica.md) — OAuth2 completo y objeto `replica`
+- [datos/appdata-referencia-ampliada.md](references/datos/appdata-referencia-ampliada.md) — Segunda redacción del corpus para `appData`, con ejemplos adicionales
+- [datos/http-sqlmanager-y-crypto.md](references/datos/http-sqlmanager-y-crypto.md) — Segunda redacción para `$http`, más `SqlManager` y la API `crypto`
+
+### Dispositivo
+- [device/objetos-de-dispositivo.md](references/device/objetos-de-dispositivo.md) — FileManager, XOnePDF, XOnePrinter, BarcodeGenerator, Datawedge, XOneNFC, XOneOCR, BluetoothSerialPort, WifiManager, Animation, deviceInfo, GpsTools, OAuth2, WebSocket y fingerprintManager
+- [device/systemsettings-y-permisos.md](references/device/systemsettings-y-permisos.md) — `systemSettings`: permisos en runtime con futures, brillo, red, batería, memoria y espacio, hardware, rutas, MDM, XOneLive e Intune
+- [device/systemsettings-referencia-ampliada.md](references/device/systemsettings-referencia-ampliada.md) — Segunda redacción del corpus para `systemSettings`, más extensa
+- [device/biometria-imagedrawing-y-otros.md](references/device/biometria-imagedrawing-y-otros.md) — `biometricsManager`, `ImageDrawing`, otros objetos utilitarios y tabla resumen de complementarios
+
+Para crear un proyecto completo desde cero, `xone-project-generator`. Para validar y auditar el XML resultante, `xone-review` (`xone-simulator validate`); para diagnosticar un fallo a partir de su síntoma, `xone-debugging`.