Lokaal bouwen en testen
Een live previewsandbox voor UI-plugins en een offline testpatroon voor library- en dbs-plugins, beide vanuit de eigen map van de plugin.
Elke pluginmap onder plugins/@xuda.io/ bouwt met Vite (npm run dev / npm run build in de eigen
map van de plugin), en elke soort heeft een eigen patroon om de plugin uit te proberen voordat hij
ergens wordt geüpload.
UI-plugins: de live preview van plugin-sandbox
@xuda.io/plugin-sandbox is een klein pakket dat een live configurator toont voor één UI-plugin: een
dropdown per eigenschap en een previewvenster dat opnieuw rendert als je ze wijzigt. De
tests/index.html van een UI-plugin koppelt hem direct aan de eigen bron van de plugin, zonder
buildstap:
initializeUiPlugin(el, plugin, properties, previewHtml) neemt de runtimemodule, het
eigenschappenschema en de HTML waartegen de plugin wordt bekeken. Voer npm run dev uit in de map
van de plugin (Vite serveert tests/ als root, volgens de vite.config.js van de plugin) om hem te
openen.
Library- en dbs-plugins: een offline testscript
Een plugin waarvan het werk in server.mjs gebeurt, test zichzelf met een gewoon Node-script in
plaats van een browsersandbox. xuda-library-plugin-xlsx is het patroon om te volgen: server.mjs
exporteert een object internals met zijn pure functies (normalize_book, render_book,
load_workbook, apply_operations, cell_value_of, ...), en tests/local.mjs importeert
{ internals } en gebruikt ze direct, zonder drive, zonder AI en zonder verbinding met het platform:
Dat draait node ./tests/local.mjs (zie scripts.test:local in de package.json van de plugin). De
logica die je test als benoemde exports op internals schrijven maakt dit mogelijk; een server.mjs
die alles als niet-geëxporteerde lokale functies houdt, heeft niets wat een testscript kan aanroepen.
plugin_tester/
plugin_tester/ in de root van de repo is een oudere tester: index.html start een volledige pagina
met xuda-runtime-slim.js op _default/xu-single-page-opmaak, en index.js is een op jQuery
gebaseerde pluginrunner (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) die een
ppi.xuda.io-plugin-API aanroept. De vorm ervan (jQuery, xu-single-page, een ppi.xuda.io-endpoint,
zoeken naar runtime/index.js in plaats van runtime.mjs) komt niet overeen met het manifest, de
soorten en de runtimesignatuur fn(plugin_name, element, properties) die op de andere pagina's van
deze sectie staan, en geen van de plugins onder plugins/@xuda.io/ verwijst ernaar. Het lijkt van
vóór de huidige plugin-sandbox-workflow te zijn, en niet de onderhouden manier om een plugin lokaal te
testen.