Bygg og test lokalt
En live forhåndsvisningssandkasse for UI-plugins og et mønster for frakoblet testing av library- og dbs-plugins, begge kjørt fra pluginens egen mappe.
Hver plugin-mappe under plugins/@xuda.io/ bygges med Vite (npm run dev / npm run build inne i
pluginens egen mappe), og hver type har sitt eget mønster for å prøve pluginen ut før den lastes opp
noe sted.
UI-plugins: live forhåndsvisning i plugin-sandbox
@xuda.io/plugin-sandbox er en liten pakke som tegner en live konfigurator for én UI-plugin: en
nedtrekksliste per egenskap og et forhåndsvisningsfelt som tegnes på nytt når du endrer dem. En
UI-plugins tests/index.html kobler den direkte mot pluginens egen kildekode, uten byggetrinn:
initializeUiPlugin(el, plugin, properties, previewHtml) tar kjøretidsmodulen, egenskapsskjemaet og
HTML-en pluginen skal forhåndsvises mot. Kjør npm run dev i pluginens mappe (Vite serverer
tests/ som rot, ifølge pluginens vite.config.js) for å åpne den.
Library- og dbs-plugins: et frakoblet testskript
En plugin der arbeidet skjer i server.mjs tester seg selv med et vanlig Node-skript i stedet for en
nettleser-sandkasse. xuda-library-plugin-xlsx er mønsteret å følge: server.mjs eksporterer et
internals-objekt med de rene funksjonene sine (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...), og tests/local.mjs importerer { internals } og
kjører dem direkte, uten drive, uten AI og uten plattformtilkobling:
som kjører node ./tests/local.mjs (se pluginens package.json scripts.test:local). Å skrive den
testede logikken som navngitte eksporter på internals er det som gjør dette mulig. En server.mjs
som beholder alt som ueksporterte lokale funksjoner, har ingenting et testskript kan kalle.
plugin_tester/
plugin_tester/ i roten av depotet er en eldre tester: index.html starter en hel
xuda-runtime-slim.js-side mot _default/xu-single-page-markup, og index.js er en jQuery-basert
pluginkjører (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) som kaller et
ppi.xuda.io-plugin-API. Formen (jQuery, xu-single-page, et ppi.xuda.io-endepunkt, leter etter
runtime/index.js i stedet for runtime.mjs) stemmer ikke med manifestet, typene og
kjøretidssignaturen fn(plugin_name, element, properties) som er dokumentert på de andre sidene i
denne delen, og ingen av pluginene under plugins/@xuda.io/ refererer til den. Den ser ut til å
komme fra før dagens plugin-sandbox-arbeidsflyt, og er ikke den vedlikeholdte måten å teste en
plugin lokalt på.