Construiește și testează local
Un sandbox cu previzualizare live pentru plugin-urile de UI și un model de test offline pentru plugin-urile library și dbs, ambele rulate din folderul propriu al pluginului.
Fiecare folder de plugin din plugins/@xuda.io/ se construiește cu Vite (npm run dev /
npm run build în directorul propriu al pluginului), iar fiecare tip are propriul model de a încerca
pluginul înainte să fie încărcat undeva.
Plugin-uri de UI: previzualizarea live din plugin-sandbox
@xuda.io/plugin-sandbox este un pachet mic care afișează un configurator live pentru un plugin de UI:
un dropdown pentru fiecare proprietate și un panou de previzualizare care se redesenează pe măsură ce
le schimbi. tests/index.html al unui plugin de UI îl leagă direct de sursa proprie a pluginului, fără
pas de build:
initializeUiPlugin(el, plugin, properties, previewHtml) primește modulul de runtime, schema de
proprietăți și HTML-ul față de care se previzualizează pluginul. Rulează npm run dev în folderul
pluginului (Vite servește tests/ ca rădăcină, conform vite.config.js al pluginului) ca să îl
deschizi.
Plugin-uri library și dbs: un script de test offline
Un plugin a cărui muncă se petrece în server.mjs se testează singur cu un simplu script Node, nu cu
un sandbox de browser. xuda-library-plugin-xlsx este modelul de urmat: server.mjs exportă un
obiect internals cu funcțiile lui pure (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...), iar tests/local.mjs importă { internals } și le
exersează direct, fără drive, fără AI, fără conexiune la platformă:
care rulează node ./tests/local.mjs (vezi scripts.test:local din package.json al pluginului).
Faptul că logica exersată este scrisă ca exporturi cu nume în internals este ceea ce face acest
lucru posibil; un server.mjs care păstrează totul ca funcții locale neexportate nu are nimic pe care
să îl poată apela un script de test.
plugin_tester/
plugin_tester/ din rădăcina repo-ului este un tester mai vechi: index.html pornește o pagină
completă xuda-runtime-slim.js pe marcaj _default/xu-single-page, iar index.js este un runner de
plugin-uri bazat pe jQuery (func.UI.widgets, $(el), fields_ret = get_fields_data(...)) care
apelează un API de plugin-uri ppi.xuda.io. Forma lui (jQuery, xu-single-page, un endpoint
ppi.xuda.io, căutarea lui runtime/index.js în loc de runtime.mjs) nu se potrivește cu
manifestul, tipurile și semnătura de runtime fn(plugin_name, element, properties) documentate pe
celelalte pagini ale acestei secțiuni, iar niciunul dintre plugin-urile din plugins/@xuda.io/ nu îl
referă. Pare să preceadă fluxul actual cu plugin-sandbox, nu să fie modul întreținut de a testa un
plugin local.