בנייה ובדיקה מקומית
ארגז חול של תצוגה מקדימה חיה לתוספי ממשק, ודפוס בדיקה במצב לא מקוון לתוספי library ו-dbs, שניהם רצים מהתיקייה של התוסף עצמו.
כל תיקיית תוסף תחת plugins/@xuda.io/ נבנית עם Vite (npm run dev / npm run build
בתוך התיקייה של התוסף עצמו), ולכל סוג יש דפוס משלו לנסות את התוסף
לפני שמעלים אותו לאנשהו.
תוספי ממשק: תצוגה מקדימה חיה ב-plugin-sandbox
@xuda.io/plugin-sandbox היא חבילה קטנה שמציגה מגדיר חי לתוסף ממשק אחד: תפריט נפתח
לכל מאפיין, וחלונית תצוגה מקדימה שמתרנדרת מחדש כשמשנים אותם. הקובץ tests/index.html של תוסף ממשק
מחבר אותה ישירות מול המקור של התוסף עצמו, בלי שלב בנייה:
initializeUiPlugin(el, plugin, properties, previewHtml) מקבלת את מודול ה-runtime, את סכמת
המאפיינים, ואת ה-HTML שמולו מציגים את התוסף. מריצים npm run dev בתיקייה של התוסף
(Vite מגיש את tests/ כשורש, לפי vite.config.js של התוסף) כדי לפתוח אותה.
תוספי library ו-dbs: סקריפט בדיקה במצב לא מקוון
תוסף שהעבודה שלו מתבצעת ב-server.mjs נבדק בסקריפט Node פשוט ולא בארגז חול בדפדפן.
xuda-library-plugin-xlsx הוא הדפוס לפעול לפיו: server.mjs מייצא אובייקט
internals עם הפונקציות הטהורות שלו (normalize_book, render_book, load_workbook,
apply_operations, cell_value_of, ...), ו-tests/local.mjs מייבא { internals } ומפעיל
אותן ישירות, בלי drive, בלי AI, בלי חיבור לפלטפורמה:
שמריץ node ./tests/local.mjs (ראו scripts.test:local ב-package.json של התוסף). כתיבת
הלוגיקה הנבדקת כייצוא בעל שם על internals היא מה שמאפשר את זה; server.mjs
ששומר הכול כפונקציות מקומיות שאינן מיוצאות אין בו שום דבר שסקריפט בדיקה יכול לקרוא לו.
plugin_tester/
plugin_tester/ בשורש המאגר הוא בודק ישן יותר: index.html מעלה דף xuda-runtime-slim.js
מלא מול סימון _default/xu-single-page, ו-index.js הוא מריץ תוספים מבוסס jQuery
(func.UI.widgets, $(el), fields_ret = get_fields_data(...))
שקורא ל-API תוספים של ppi.xuda.io. המבנה שלו (jQuery, xu-single-page, נקודת קצה של ppi.xuda.io,
חיפוש runtime/index.js ולא runtime.mjs) לא מתאים למניפסט, לסוגים ולחתימת ה-runtime
fn(plugin_name, element, properties) שמתועדים בדפים האחרים של הפרק הזה,
ואף אחד מהתוספים תחת plugins/@xuda.io/ לא מפנה אליו. נראה שהוא קדם
לזרימת העבודה הנוכחית של plugin-sandbox, ואינו הדרך המתוחזקת לבדוק תוסף מקומית.