xonecode 0.1.0

package/skills/xone-development/references/xml-ui/atributos-coll-group-frame.md

@@ -0,0 +1,235 @@
+# XOne XML — Referencia de atributos: coll, group y frame
+
+> Fuente: `xone/v2/xone-help-docs/topics/07-xml-attributes-reference.md` §1–§3. Referencia de la skill; el índice está en [../../SKILL.md](../../SKILL.md).
+
+Contenido: §1 todos los atributos de coll · §2 atributos de group · §3 atributos de frame, con tipo, valores permitidos y valor por defecto
+
+---
+
+## 1. Nodo `<coll>` — Coleccion/Pantalla
+
+Define una tabla de datos (mapeada a SQL) o una pantalla de UI. Es el nodo raiz de cada fichero `.xne`.
+
+> **REGLAS GENERALES DE NAMING (aplican a coll/group/frame/prop):**
+>
+> - **`name` es case-sensitive.** `name="MiNombre"` y `name="minombre"` son **distintos**. Aplica también a referencias cruzadas: `self.X`, `mapcol`, `linkedto`, `inherits`, `<field name="...">`, `getControl("...")`, `ui.openEditView("...")`, `appData.getCollection("...")`.
+> - **El `id` de `<group>` es obligatorio y único en la coll.** Dos `<group id="1">` en la misma coll producen comportamiento indefinido.
+> - **Unicidad de `name` en la coll.** No puede repetirse el `name` de ningun nodo dentro de una `<coll>`, aunque estén en grupos/frames distintos.
+
+### 1.1 Atributos de identificación y datos
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Sí** | — | Identificador único de la colección. Usar PascalCase. **Case-sensitive.** |
+| `title` | string | No | `name` | Título visible en la UI. |
+| `sql` | string | No | — | Sentencia SQL `SELECT`. Usar `##PREF##` para el prefijo de tabla. |
+| `objname` | string | No | — | Nombre de la tabla para operaciones de lectura. |
+| `updateobj` | string | No | — | Nombre de la tabla para INSERT/UPDATE/DELETE. |
+| `progid` | string | No | — | Identificador del objeto de negocio. **Opcional**: sin él la coll es un objeto de datos genérico (≡ `ASData.CASBasicDataObj`). Solo casos especiales: `ASGestion.CASEmpresa` (Empresas), `ASGestion.CASUser` (Usuarios). |
+| `connection` | string | No | conexión por defecto | Nombre de la conexión en `<connection>`. |
+| `filter` | string | No | `""` | Filtro SQL adicional (cláusula WHERE). |
+| `sort` | string | No | `""` | Orden de datos (cláusula ORDER BY). |
+| `loadall` | bool | No | `false` | Carga todos los registros al inicializar. |
+| `volatile` | bool | No | `false` | No cachea objetos; siempre relee de BD. |
+| `stringkey` | bool | No | `false` | La PK es de tipo string. |
+| `threshold` | int | No | `200` | Tamaño máximo de la caché LRU de objetos. |
+| `userawsql` | bool | No | `false` | No reescribe el SQL (lo usa tal cual). |
+| `idfieldname` | string | No | `ID` | Nombre del campo PK cuando no se llama `ID`. |
+| `dependent` | bool | No | `false` | Indica si la colección depende de una colección padre. |
+| `check-owner` | bool | No | `false` | Verifica que los registros pertenezcan al usuario/empresa actual. |
+| `autorefresh` | bool | No | `false` | Refresca datos automáticamente al regresar de otra ventana. |
+| `inherits` | string | No | `""` | Nombre de coll de la que se hereda estructura visual. |
+
+### 1.2 Atributos de UI/celda en listas
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `cell-width` | medida | auto | Ancho fijo de celda en grid. |
+| `cell-height` | medida | auto | Alto fijo de celda en grid. |
+| `cell-bgcolor` | color | heredado | Color de fondo de celda. |
+| `cell-bgcolor_out` | color | heredado | Color de fondo fuera del viewport. |
+| `cell-forecolor` | color | heredado | Color de texto de celda. |
+| `cell-forecolor_out` | color | heredado | Color texto fuera del viewport. |
+| `cell-border-color` | color | — | Color del borde de celda. |
+| `cell-border-width` | medida | `0` | Grosor del borde de celda. |
+| `cell-even-color` | color | — | Color para filas pares (zebra). |
+| `cell-odd-color` | color | — | Color para filas impares (zebra). |
+| `cell-selected-bgcolor` | color | — | Fondo de celda seleccionada. |
+| `cell-selected-forecolor` | color | — | Texto de celda seleccionada. |
+| `cell-selected-border-color` | color | — | Borde de celda seleccionada. |
+| `cell-selected-border-width` | medida | — | Grosor borde celda seleccionada. |
+| `editinline-rows` | int | `1` | Filas visibles en edición inline. |
+| `no-data-text` | string | `""` | Texto cuando no hay registros. |
+| `start-from-bottom` | bool | `false` | Scroll anclado al final de la lista (chats). Declarable en la coll o en el content (`type="Z"`); el del content tiene preferencia. |
+| `divider-height` | int | — | Alto (grosor) del separador entre ítems de la lista (`type="Z"`). En listas expandibles el default es `4`. |
+| `divider-color` | color | — | Color del separador entre ítems de la lista (`type="Z"`). |
+| `divider-background` | string | — | Imagen (ruta de recurso) usada como separador entre ítems; tiene prioridad sobre `divider-color`. |
+| `page-limit-off` | bool | `false` | Desactiva la paginación automática. |
+
+### 1.3 Atributos de pantalla y comportamiento
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `special` | bool | `false` | Coleccion de pantalla pura (sin datos). |
+| `notab` | bool | `false` | No muestra pestanas aunque haya varios grupos. |
+| `show-toolbar` | bool | `true` | Muestra la toolbar. |
+| `fullscreen` | bool | `false` | Pantalla a fullscreen. |
+| `secure-window` | bool | `false` | Bloquea capturas de pantalla del sistema. |
+| `disable-keyguard` | bool | `false` | Desbloquea el teclado al mostrar la pantalla. |
+| `keep-screen-on` | bool | `false` | Mantiene la pantalla encendida mientras esta visible. |
+| `ignore-safe-area` | bool | `false` | Ignora la safe-area del sistema (notch, barra de navegación). |
+| `load-imgbk` | bool | `false` | Carga la imagen de fondo durante la carga inicial. |
+| `load-wait` | bool | `true` | Muestra el dialogo de espera durante la carga. |
+| `show-async` | bool | `false` | Muestra la pantalla aunque aún estén cargando datos. |
+| `fixed-group` | int | `-1` | ID de grupo siempre visible (header fijo). |
+| `tab-height` | medida | auto | Alto de la barra de pestanas. |
+| `tab-orientation` | enum | `top` | `top` o `bottom`. Posición de la barra de pestanas. |
+| `toolbar-bgcolor` | color | — | Fondo de la toolbar. |
+| `toolbar-forecolor` | color | — | Texto de la toolbar. |
+| `window-keyboard-behaviour` | enum | `adjustResize` | Modo del teclado software: `adjustResize`, `adjustPan`, `adjustNothing`. |
+| `screen-orientation` | enum | `sensor` | `portrait`, `landscape`, `reversePortrait`, `reverseLandscape`, `sensorPortrait`, `sensorLandscape`, `sensor`. |
+| `resolution-width` | int | auto | Ancho lógico de diseño (el contenido se escala a este ancho). |
+| `resolution-height` | int | auto | Alto lógico de diseño. |
+| `remote-mapcoll` | string | `""` | Coleccion remota para uso con mapas. |
+| `login-coll` | string | `""` | Marca esta coll como pantalla de login. |
+| `logoff-coll` | string | `""` | Marca esta coll como pantalla de logoff. |
+| `readonly` | bool | `false` | Toda la colección es de **solo lectura a nivel de persistencia**: ni INSERT ni UPDATE en BD. Útil para colls que solo muestran datos sin permitir grabar. No tiene efecto sobre la UI de los controles individuales (esa se controla con `locked` / `disableedit` en cada `<prop>`). |
+| `class` | string | `""` | Clase CSS aplicada a la coleccion. |
+
+### 1.4 Nodos especiales hijos de `<coll>`
+
+| Nodo hijo | Descripción |
+|---|---|
+| `<create>` | Script ejecutado una sola vez al crear el objeto (primera apertura). |
+| `<before-edit>` | Script al abrir para edición. **Usar para inicializar la pantalla.** |
+| `<after-edit>` | Script tras entrar en modo edición. |
+| `<load>` | Se dispara **por cada DataObject** al cargarse desde la BD (startBrowse/loadAll/`<contents>`/cargas individuales). **NO es evento de pantalla** y **NO recomendado** por impacto en rendimiento. |
+| `<onchange>` | Script al cambiar el valor de un campo (necesita `<field name="CAMPO">`). |
+| `<selecteditem>` | Script al pulsar un item de lista. |
+| `<auto-selecteditem>` | Selecciona automáticamente un item al cargar. |
+| `<onlongpressitem>` | Script al hacer long-press sobre un item. |
+| `<onback>` | Script al pulsar el botón atrás. |
+| `<macro>` | Declara una macro de coleccion (ver sección 6). |
+| `<contents>` | Coleccion anidada embebida. |
+| `<permissions>` | Permisos del sistema requeridos. |
+| `<platform>` | Override de atributos por plataforma (ver sección 10). |
+
+```xml
+<coll name="MiPantalla" title="Mi Pantalla" special="true" notab="true"
+      show-toolbar="false" keep-screen-on="true" screen-orientation="portrait">
+    <before-edit refresh="false" show-wait-dialog="false">
+        <action name="runscript">
+            <script language="javascript">inicializar();</script>
+        </action>
+    </before-edit>
+    <group name="grpMain" id="1">
+        <!-- ... -->
+    </group>
+</coll>
+```
+
+---
+
+## 2. Nodo `<group>` — Grupo
+
+Agrupa propiedades en una pestana o sección lógica dentro de una coleccion.
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Si** | — | Nombre único del grupo dentro de la coll. |
+| `id` | int/string | **Si** | — | Identificador numérico **único dentro de la coll**. Si dos `<group>` comparten `id` en la misma coll el comportamiento es indefinido. Convencion: `1, 2, ...` normales; `999` HEADER fijo, `0` FOOTER fijo. |
+| `title` | string | No | `id` | Título visible de la pestana. |
+| `visible` | int (mask) | No | `-1` | Mascara binaria de visibilidad (misma lógica que `<prop>`). |
+| `disableedit` | formula | No | `""` | Si la fórmula es verdadera, todos los controles del grupo quedan bloqueados para edición en la **UI** (equivalente a aplicar `locked="true"` a todos los `<prop>` del grupo). No afecta a la persistencia. |
+| `disablevisible` | formula | No | `""` | Si la formula es verdadera, el grupo se oculta. |
+| `fixed` | bool | No | `false` | Grupo fijo: no scrollea con el contenido. |
+| `cache-groups` | bool | No | `false` | Cachea el contenido renderizado del grupo para mejorar rendimiento. |
+| `drawer-orientation` | enum | No | `left` | `left` o `right`. Lado por el que aparece el drawer lateral. |
+| `tab-theme` | string | No | tema actual | Tema visual de las pestanas. |
+| `tab-width` | medida | No | auto | Ancho de cada pestana. |
+| `group-theme` | string | No | tema actual | Tema visual del grupo. |
+| `group-swipe` | bool | No | `true` | Permite cambiar de grupo deslizando horizontalmente. |
+| `page-limit-off` | bool | No | `false` | Desactiva el limite de paginación visual del grupo. |
+| `page-margin` | medida | No | `10dp` | Margen entre páginas al paginar. |
+| `float-over-drawer` | bool | No | `false` | Los elementos flotantes se muestran sobre el drawer. |
+| `bgcolor` | color | No | heredado | Color de fondo del grupo. |
+| `forecolor` / `fgcolor` | color | No | heredado | Color de texto del grupo. |
+| `class` | string | No | `""` | Clase CSS. |
+
+```xml
+<group name="grpPrincipal" id="1" group-swipe="true" tab-orientation="bottom">
+    <!-- frames y props aquí -->
+</group>
+```
+
+---
+
+## 3. Nodo `<frame>` — Frame/Contenedor
+
+Contenedor visual dentro de un grupo. Puede anidarse.
+
+### 3.1 Identidad y posicionamiento
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Si** | — | Nombre único del frame dentro de la coll. |
+| `group` | int | **Si** | — | ID del grupo al que pertenece. |
+| `frame` | string | No | `""` | Nombre del frame padre (anidado). |
+| `title` | string | No | `""` | Título mostrado en la cabecera del frame (si aplica). |
+| `floating` | bool | No | `false` | Posicionamiento absoluto (saca el frame del flujo normal). |
+| `top` / `left` / `right` / `bottom` | medida | No | — | Posición absoluta. Solo con `floating="true"`. |
+| `width` / `height` | medida | No | auto | Tamaño explicito. `-1` = ocupar todo el espacio restante. `-2` = igual que `-1` pero con scroll. |
+| `min-width` / `max-width` / `min-height` / `max-height` | medida | No | — | Restricciones de tamaño. |
+| `newline` | bool | No | `true` | Salto de linea antes del frame. |
+| `zorder` | int | No | `0` | Orden Z (profundidad) del frame. |
+
+### 3.2 Comportamiento y scroll
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `scroll` | bool | `false` | Activa scroll interno en el frame. |
+| `modal` | bool | `false` | Frame modal (bloquea interaccion con el resto). |
+| `disableedit` | formula | `""` | Si verdadero, deshabilita el frame y todos sus hijos. |
+| `disablevisible` | formula | `""` | Si verdadero, oculta el frame. |
+| `ignore-touch-on-transparent-area` | bool | `false` | Los toques sobre áreas transparentes pasan al elemento del fondo. |
+| `blend-bgcolor-with-image` | bool | `false` | Mezcla el color de fondo con la imagen de fondo. |
+
+### 3.3 Drag & Drop
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `drag-enable` | bool | `false` | El frame es arrastrable. |
+| `drag-area` | string | `""` | Nombre del hijo que actua como manija de arrastre. |
+| `drag-opaque` | bool | `false` | El frame es opaco durante el arrastre. |
+| `drop-target` | bool | `false` | Este frame acepta elementos soltados (drop). |
+| `dropcoll` | string | `""` | Coleccion destino al soltar un elemento. |
+| `notify-only-when-dropped` | bool | `false` | Solo dispara el evento al soltar (no durante el arrastre). |
+
+### 3.4 Apariencia
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `bgcolor` | color | heredado | Color de fondo del frame. |
+| `forecolor` | color | heredado | Color de texto del frame. |
+| `border` | int (mask) | `0` | Bordes activos: top=1, right=2, bottom=4, left=8. Sumar para combinar. |
+| `border-color` | color | — | Color del borde. |
+| `border-width` | medida | `0` | Grosor del borde. |
+| `border-corner-radius` | medida | `0` | Radio de esquinas redondeadas. |
+| `tmargin` / `bmargin` / `lmargin` / `rmargin` | medida | `0` | Margenes externos. |
+| `tpadding` / `bpadding` / `lpadding` / `rpadding` | medida | `0` | Padding interno. |
+| `class` | string | `""` | Clase CSS. |
+| `imgbk` | string | `""` | Imagen de fondo del frame. |
+
+```xml
+<frame name="frmHeader" group="1" width="100%" height="140p"
+       bgcolor="#1565C0" lpadding="15p" rpadding="15p">
+    <!-- props aquí -->
+</frame>
+
+<!-- Frame flotante (overlay) -->
+<frame name="frmOverlay" group="1" floating="true"
+       top="50p" left="10%" width="80%" height="200p"
+       bgcolor="#FFFFFF" border-corner-radius="12" zorder="10">
+</frame>
+```
+

package/skills/xone-development/references/xml-ui/atributos-method-macro-script-event-app.md

@@ -0,0 +1,244 @@
+# XOne XML — Referencia de atributos: method, macro, script, event, platform, tipos y app
+
+> Fuente: `xone/v2/xone-help-docs/topics/07-xml-attributes-reference.md` §5–§11. Referencia de la skill; el índice está en [../../SKILL.md](../../SKILL.md).
+
+Contenido: §5 method · §6 macro · §7 script · §8 eventos disponibles · §9 platform (override por plataforma) · §10 tipos de propiedad · §11 atributos globales de la app
+
+---
+
+## 5. Nodo `<method>` — Método ejecutable
+
+Define un método reutilizable que puede ser invocado desde scripts via `self.executeNode("nombre")`.
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Si** | — | Nombre único del método dentro de la coll. |
+| `language` | enum | No | lenguaje por defecto | `javascript` (recomendado). `vbscript` esta descontinuado. |
+| `params` | string | No | `""` | Parámetros separados por coma. |
+| `return-type` | string | No | `""` | Tipo de retorno. |
+| `execute-async` | bool | No | `false` | Ejecuta de forma asíncrona. |
+| `disableedit` | formula | No | `""` | Si verdadero, el método no puede ejecutarse. |
+
+Requiere nodo hijo `<script language="javascript">` con el código.
+
+```xml
+<method name="calcularTotal" language="javascript">
+    <script language="javascript">
+        var base = self.getValue("IMPORTE_BASE");
+        var iva  = base * 0.21;
+        self.setValue("IVA", iva);
+        self.setValue("TOTAL", base + iva);
+    </script>
+</method>
+```
+
+> Llamada desde otro script: `self.executeNode("calcularTotal");`
+
+---
+
+## 6. Nodo `<macro>` — Macro de coleccion
+
+Variable de tipo string con ambito de la coleccion, usable en SQL y filtros mediante la sintaxis `##NOMBRE##`.
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Si** | — | Nombre de la macro. Usar formato `##NOMBRE##`. |
+| `value` | string | No | `""` | Valor inicial de la macro. |
+| `default` | bool | No | `false` | Si `true`, se usa como valor por defecto. |
+
+**Reglas críticas:**
+- El nodo `<macro>` se declara como **hijo directo de `<coll>`**, al mismo nivel que los `<group>`.
+- Sin declaración del nodo, `setMacro("##X##", valor)` no tiene efecto en el SQL.
+- Para leer/escribir desde JS: `selfDataColl.getMacro("##X##")` / `selfDataColl.setMacro("##X##", valor)`.
+- Para macros globales (toda la app): `appData.getGlobalMacro` / `appData.setGlobalMacro`.
+
+```xml
+<coll name="Pedidos" sql="SELECT * FROM ##PREF##Pedidos WHERE estado = ##FILTRO_ESTADO##">
+    <macro name="##FILTRO_ESTADO##" value="'pendiente'" default="true" />
+    <group name="grp1" id="1">
+        <!-- ... -->
+    </group>
+</coll>
+```
+
+---
+
+## 7. Nodo `<script>` — Script
+
+Nodo que contiene código JavaScript. Puede ser hijo de eventos, métodos o usarse inline.
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | No | `""` | Identificador del script. |
+| `language` | enum | No | lenguaje por defecto | `javascript` (recomendado). No usar `vbscript`. |
+| `type` | string | No | `text/javascript` | MIME type alternativo. |
+| `src` | string | No | `""` | URL o ruta a fichero externo. |
+| `ext-file` | string | No | `""` | Fichero externo relativo al proyecto. |
+
+**Escape XML del JS embebido.** Para JS no trivial, **forma preferida**: declarar la función en un fichero `.js` externo (`functions.js` u otro `<include>`-ado) y llamarla desde el `.xne` con `miFuncion();` — así el JS se escribe normal y el XML solo invoca. Para snippets cortos inline, hay dos formas válidas: (a) entidades XML dentro del JS (`&` → `&amp;`, `<` → `&lt;`, `>` → `&gt;`), o (b) envolver el bloque en `<![CDATA[…]]>` (solo válido dentro de nodos `<script>`; NO dentro de atributos XML como `onclick="…"`).
+
+(fence sin lenguaje para que las entidades se rendericen literales)
+
+```
+<!-- OPCIÓN A: entidades XML -->
+<script language="javascript">
+    if (a &gt; 0 &amp;&amp; b &lt; 10) {
+        self.setValue("RESULTADO", a + b);
+    }
+</script>
+
+<!-- OPCIÓN B: CDATA (también válido dentro de <script>) -->
+<script language="javascript"><![CDATA[
+    if (a > 0 && b < 10) {
+        self.setValue("RESULTADO", a + b);
+    }
+]]></script>
+```
+
+---
+
+## 8. Nodo `<event>` — Eventos disponibles
+
+| Evento | Aplicable a | Cuando dispara |
+|---|---|---|
+| `<create>` | coll | Una sola vez al crear el objeto (primera apertura). |
+| `<before-edit>` | coll | Al abrir para edición. **Usar para inicializar pantalla.** |
+| `<after-edit>` | coll | Después de entrar en modo edición. |
+| `<load>` | coll | Se dispara **por cada DataObject** al cargarse desde la BD (startBrowse/loadAll/`<contents>`/cargas individuales). **NO es evento de pantalla** y **NO recomendado** por impacto en rendimiento. |
+| `<onchange>` + `<field name="X">` | coll, prop | Al cambiar el valor del campo indicado. |
+| `<selecteditem>` | coll | Al seleccionar un item en lista. |
+| `<auto-selecteditem>` | coll | Selección automática al cargar. |
+| `<onlongpressitem>` | coll | Pulsacion larga sobre un item. |
+| `<onback>` | coll | Al pulsar el botón atrás. |
+| `<onfocus>` | prop | Al recibir foco. |
+| `<delete>` (con `<rule>` hijos) | coll | Define **reglas de borrado** que se evaluan antes de eliminar un objeto. No es un evento "antes/después"; es un bloque de reglas (`<rule>` con condiciones SQL/script). |
+| `<onlogon>` / `<login-ok>` / `<login-fail>` | coll de login | Flujo de autenticación. |
+| `<onlogoff>` | coll | Al cerrar sesión. |
+| `<onpushreceived>` | coll Empresas | **Exclusivo de la coll `Empresas`** (`ASGestion.CASEmpresa`). Al recibir una notificación push. |
+| `<maintenance>` | coll Empresas | **Exclusivo de la coll `Empresas`.** Tarea de mantenimiento periódico. |
+| `<sys-message>` | coll Empresas | **Exclusivo de la coll `Empresas`.** Mensaje de sistema (códigos 1000-1003, ver tópico 05 sección 5D). |
+| `<nodoCustom>` | coll | Nodo invocable con `self.executeNode("nodoCustom")`. |
+
+> **Nota:** `onclick` se declara **solo como atributo** del nodo `<prop>`, **nunca como nodo hijo** `<onclick>`. Los siguientes nombres **NO existen en ningún sitio** (ni nodo ni atributo): `onlostfocus`, `onblur`, `onsave`, `oncreate`, `oninit`. Hay además nombres que **SÍ existen como atributo de evento en `<prop>`** pero NO como nodo hijo de `<coll>`: `ontouch`, `onlongpress`, `ontextchanged`, `onfocuschanged`, `oneditoraction`, `onscroll`, `onkeydown`, `onswipe`, `oncodescanned`, `oncheckedchange`, etc. Casos específicos: `ondismiss` (atributo de `<prop>` con `behavior="swipe-dismiss"`), `beforesave`/`aftersave` (atributos de `<executeNode>`).
+>
+> **Caso especial — `<button>`:** existe como **alias legacy** de `<prop type="B">`. El motor lo trata como propiedad sintética con `type="B"`. **Forma canónica recomendada hoy:** `<prop type="B">`. Solo aparece como `<button>` en proyectos antiguos.
+
+---
+
+## 9. Nodo `<platform>` — Override por plataforma
+
+Permite sobrescribir atributos de cualquier nodo según la plataforma o tipo de dispositivo. Se declara como hijo del nodo que quiere sobreescribir.
+
+| Atributo | Tipo | Obligatorio | Default | Descripción |
+|---|---|---|---|---|
+| `name` | string | **Si** | — | Plataforma: `android`, `ios`, `windows`. |
+| `device` | string | No | `""` | Tipo de dispositivo: `phone`, `hiphone`, `tablet`, `mini`, `watchround`, `watchsquare`. |
+| *(cualquier atributo del padre)* | — | No | heredado | Sobrescribe el atributo cuando la plataforma coincide. |
+
+**Orden de resolución de atributos:**
+1. `<platform name="...">` que coincide con la plataforma actual.
+2. El nodo principal (el padre).
+3. Regla CSS por clase.
+4. Cadena vacia / valor por defecto.
+
+```xml
+<prop name="NOMBRE" type="T" visible="7" width="100%">
+    <!-- En tablet, el campo ocupa solo el 50% -->
+    <platform name="android" device="tablet">
+        <width>50%</width>
+    </platform>
+</prop>
+
+<coll name="MiPantalla" screen-orientation="portrait">
+    <!-- En tablet, la orientacion es libre -->
+    <platform name="android" device="tablet">
+        <screen-orientation>sensor</screen-orientation>
+    </platform>
+</coll>
+```
+
+---
+
+## 10. Tipos de propiedad (atributo `type`)
+
+| Código | Descripción | Notas |
+|---|---|---|
+| `T` | Texto editable. | El más usado para campos de texto. |
+| `TN` ... `TN6` | Texto numérico con N decimales. | Ej. `TN2` para 2 decimales. |
+| `N` ... `N6` | Numérico con N decimales. | `N` = entero, `N2` = 2 decimales. |
+| `D` | Fecha. | Requiere `date-format` para personalizar. |
+| `DT` | Fecha y hora. | |
+| `TT` | Solo hora/reloj. | Requiere `mask="Hh#:#Mm"` para ser visible. |
+| `B` | Botón en formulario. | Usar `onclick` como atributo. Soporta también `ontouchdown`/`ontouchup` para distinguir presionar de soltar (interacciones "mantener pulsado"). |
+| `L` | Etiqueta de solo lectura (label) — forma preferida. | No editable. Muestra el `title`; sin `title`, usa el valor del campo. Usar `MAP_` siempre que sea posible. |
+| `TL` | Alias legacy de `L`: se renderiza igual (label de solo lectura). | Equivalente a `type="L"`; el framework instancia el mismo control. Mantener por compatibilidad. |
+| `THTML` | Texto con formato HTML. | Soporta HTML básico. `link-color` para enlaces. |
+| `WEB` | WebView embebido. | Carga URLs o HTML local. |
+| `IMG` | Imagen referenciada (path o URL). | `scale-type`, `zoom`, `keep-aspect-ratio`. |
+| `PH` | Foto capturable con la camara. | Equivalente a `IMG` con captura. |
+| `VD` | Video o escaner. | `code-type` para QR/barcode. |
+| `DR` | Dibujo/firma. | `stroke-color`, `stroke-width`, `apply-format-to-file`. |
+| `NC` | Checkbox/toggle/radio/switch. | `check-type` para variante. |
+| `X` | Campo password. | `show-password-visibility-toggle` para ver/ocultar. |
+| `Z` | Contenedor de contenidos/lista embebida. | Requiere `contents="NombreColeccion"`. |
+| `AT` | Adjunto/fichero. | `attach-allowed` para filtrar tipos MIME. |
+| `O` | Sub-objeto JavaScript. | No persiste en BD. Ideal para callbacks. |
+
+---
+
+## 11. Atributos globales de la app
+
+Atributos del nodo raiz `<app>` en `mappings.xne` o `app.xml`.
+
+| Atributo | Tipo | Default | Descripción |
+|---|---|---|---|
+| `prefix` | string | `""` | Prefijo de tablas (macro `##PREF##`). Ej. `gen` genera `gen_` en el SQL. |
+| `versión` | string | — | Versión de la aplicación. |
+| `mainentry` | string | — | Coleccion de entry-point (pantalla inicial). |
+| `login-coll` | string | — | Coleccion de login. |
+| `default-language` | string | `javascript` | Lenguaje de scripts por defecto. Usar siempre `javascript`. |
+| `theme` | string | `default` | Tema visual global de la app. |
+| `scale-fontsize` | bool | `true` | Escala fuentes según `fontScale` del sistema (accesibilidad). |
+| `android-font-factor` | float | `7` | Factor adicional de escala de fuentes en Android. |
+| `appname` | string | nombre del fichero | Nombre lógico de la app. |
+| `license` | string | — | Licencia de la app. |
+| `compatibility-mode` | bool | `false` | Si `true`, ignora COMPLETAMENTE el CSS. |
+| `debug` | bool | `false` | Activa el modo debug. |
+
+### Macros de sistema disponibles
+
+| Macro | Descripción |
+|---|---|
+| `##PREF##` | Prefijo de tablas definido en `app.xml`. |
+| `##APP##` | Referencia a la app. |
+| `##DEFAULT##` | Valor por defecto. |
+| `##MAINFRAME##` | Frame raiz de la aplicación. |
+| `##MAINENTRYPOINT##` | Padre del menu principal. |
+| `##NOW_TIME##` | Fecha y hora actual. |
+| `##DEVICE_OS##` | Sistema operativo del dispositivo. |
+| `##DEVICE_OSSDKCODE##` | Código SDK del OS (Android API level). |
+| `##DEVICE_TYPE##` | Tipo de dispositivo (`phone`, `tablet`, etc.). |
+| `##CURRENT_ORIENTATION##` | Orientación actual (`portrait` o `landscape`). |
+| `##FRAME_VERSION_CODE##` | Versión del framework XOne. |
+| `##LIVEUPDATE_VERSION##` | Versión del LiveUpdate. |
+| `##RIGHT_IN##` | Animación de entrada desde la derecha. |
+| `##RIGHT_OUT##` | Animación de salida hacia la derecha. |
+| `##LEFT_IN##` | Animación de entrada desde la izquierda. |
+| `##LEFT_OUT##` | Animación de salida hacia la izquierda. |
+| `##TOP_IN##` | Animación de entrada desde arriba. |
+| `##BOTTOM_IN##` | Animación de entrada desde abajo. |
+| `##PUSH_IN##` / `##PUSH_OUT##` / `##PUSH_DOWN_IN##` | Variantes de animación tipo push. |
+| `##ALPHA_IN##` | Animación de entrada con fade. |
+| `##ZOOM_IN##` | Animación de entrada con zoom. |
+
+### Ficheros de configuración del proyecto
+
+| Fichero | Uso |
+|---|---|
+| `app.ini` | Configuración inicial: Name, Title, Caption, Icon, IconFolder, FilesFolder. |
+| `app.xml` | Definición global de la app (prefix, versión, CSS, scripts). |
+| `mappings.xne` | Mapping principal: solo colecciones Empresas y Usuarios. Encoding: iso-8859-15. |
+| `default.css` | Estilos globales. |
+| `functions.js` | Funciones JavaScript globales (carga automática). |
+| `license.ini` | Licencia de la aplicación. |
+