Compilar y probar en local
Un sandbox de vista previa en vivo para plugins de interfaz y un patrón de pruebas sin conexión para plugins de librería y dbs, ambos ejecutados desde la carpeta del propio plugin.
Todas las carpetas de plugin de plugins/@xuda.io/ se compilan con Vite (npm run dev / npm run build dentro del directorio del propio plugin), y cada tipo tiene su propio patrón para probar el plugin antes de subirlo a ningún sitio.
Plugins de interfaz: la vista previa en vivo de plugin-sandbox
@xuda.io/plugin-sandbox es un paquete pequeño que muestra un configurador en vivo para un plugin de interfaz: un desplegable por propiedad y un panel de vista previa que se vuelve a dibujar a medida que las cambias. El tests/index.html de un plugin de interfaz lo conecta directamente con el código fuente del propio plugin, sin paso de compilación:
initializeUiPlugin(el, plugin, properties, previewHtml) recibe el módulo de runtime, el esquema de propiedades y el HTML sobre el que previsualizar el plugin. Ejecuta npm run dev en la carpeta del plugin (Vite sirve tests/ como raíz, según el vite.config.js del plugin) para abrirlo.
Plugins de librería y dbs: un script de pruebas sin conexión
Un plugin cuyo trabajo ocurre en server.mjs se prueba a sí mismo con un script de Node normal en lugar de un sandbox de navegador. xuda-library-plugin-xlsx es el patrón a seguir: server.mjs exporta un objeto internals con sus funciones puras (normalize_book, render_book, load_workbook, apply_operations, cell_value_of, ...), y tests/local.mjs importa { internals } y las ejercita directamente, sin drive, sin IA, sin conexión con la plataforma:
que ejecuta node ./tests/local.mjs (consulta el scripts.test:local del package.json del plugin). Escribir la lógica que se prueba como exportaciones con nombre en internals es lo que lo hace posible; un server.mjs que mantiene todo como funciones locales sin exportar no deja nada a lo que pueda llamar un script de pruebas.
plugin_tester/
plugin_tester/ en la raíz del repositorio es un probador más antiguo: index.html arranca una página completa de xuda-runtime-slim.js con marcado _default/xu-single-page, e index.js es un ejecutor de plugins basado en jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) que llama a una API de plugins de ppi.xuda.io. Su forma (jQuery, xu-single-page, un endpoint ppi.xuda.io, que busca runtime/index.js en lugar de runtime.mjs) no coincide con el manifiesto, los tipos y la firma de runtime fn(plugin_name, element, properties) documentados en las demás páginas de esta sección, y ninguno de los plugins de plugins/@xuda.io/ hace referencia a él. Parece anterior al flujo actual de plugin-sandbox, no la forma mantenida de probar un plugin en local.