Lokal bauen und testen
Eine Live-Vorschau-Sandbox für UI-Plugins und ein Offline-Testmuster für Library- und dbs-Plugins, beide aus dem eigenen Ordner des Plugins gestartet.
Jeder Plugin-Ordner unter plugins/@xuda.io/ wird mit Vite gebaut (npm run dev / npm run build
im eigenen Verzeichnis des Plugins), und jede Art hat ihr eigenes Muster, um das Plugin auszuprobieren,
bevor es irgendwohin hochgeladen wird.
UI-Plugins: die Live-Vorschau der plugin-sandbox
@xuda.io/plugin-sandbox ist ein kleines Paket, das einen Live-Konfigurator für ein UI-Plugin darstellt: ein
Dropdown pro Eigenschaft und einen Vorschaubereich, der sich beim Ändern neu rendert. Die tests/index.html eines UI-Plugins
verdrahtet es direkt gegen den eigenen Quellcode des Plugins, ohne Build-Schritt:
initializeUiPlugin(el, plugin, properties, previewHtml) nimmt das Runtime-Modul, das Eigenschaftsschema
und das HTML, gegen das das Plugin in der Vorschau gezeigt wird. Führe npm run dev im Ordner des Plugins aus
(Vite liefert tests/ als Root aus, gemäß der vite.config.js des Plugins), um sie zu öffnen.
Library- und dbs-Plugins: ein Offline-Testskript
Ein Plugin, dessen Arbeit in server.mjs stattfindet, testet sich mit einem schlichten Node-Skript statt mit einer
Browser-Sandbox. xuda-library-plugin-xlsx ist das Muster, dem du folgen kannst: server.mjs exportiert ein
internals-Objekt mit seinen reinen Funktionen (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...), und tests/local.mjs importiert { internals } und
ruft sie direkt auf, ohne Drive, ohne KI, ohne Plattformverbindung:
Das führt node ./tests/local.mjs aus (siehe scripts.test:local in der package.json des Plugins). Die getestete Logik
als benannte Exporte an internals zu schreiben, macht das erst möglich. Eine server.mjs,
die alles als nicht exportierte lokale Funktionen belässt, hat nichts, was ein Testskript aufrufen könnte.
plugin_tester/
plugin_tester/ im Stammverzeichnis des Repos ist ein älterer Tester: index.html startet eine komplette
xuda-runtime-slim.js-Seite gegen _default/xu-single-page-Markup, und index.js ist ein
jQuery-basierter Plugin-Runner (func.UI.widgets, $(el), fields_ret = get_fields_data(...)),
der eine ppi.xuda.io-Plugin-API aufruft. Seine Form (jQuery, xu-single-page, ein ppi.xuda.io-Endpunkt,
Suche nach runtime/index.js statt runtime.mjs) passt nicht zum Manifest, den Arten und der
Runtime-Signatur fn(plugin_name, element, properties), die auf den anderen Seiten dieses Abschnitts dokumentiert sind,
und keines der Plugins unter plugins/@xuda.io/ verweist darauf. Es wirkt, als stamme es aus der Zeit vor dem
aktuellen Plugin-Sandbox-Ablauf, statt der gepflegte Weg zu sein, ein Plugin lokal zu testen.