vite-plugin-xu
תוסף Vite בזמן בנייה שמקמפל רכיב קובץ יחיד של .xu למודול ES אמיתי.
@xuda/vite-plugin-xu מקמפל רכיבי קובץ יחיד של .xu למודולי ES בזמן בנייה, וטוען אותם מחדש חם בפיתוח ברמה של טעינה מחדש של רכיב מלא.
@xuda/vite-plugin-xu וחבילת @xuda/compiler שהוא תלוי בה נושאים שניהם "private": true ב-package.json שלהם. בניגוד ל-xuda-cli, ל-create-xuda-cli ול-@xuda/core, אף אחת מהן עדיין לא מפורסמת ב-npm. הצרכן העובד היחיד במאגר הזה, examples/hello, מגיע אליו כתלות file:: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".
הגדרה
examples/hello הוא פרויקט עובד מלא שנבנה כך: מונה, טעינה מותנית ורשימה עם מפתחות, שמונעים כולם על ידי פונקציות רגילות ושינוי רגיל מעל חנות reactive(), בלי signals, בלי .value ובלי שכבת מקור נתונים שנראית ברכיב עצמו.
מה התוסף, מכנית
הוק transform אחד. ה-load ברירת המחדל של Vite כבר קרא את הקובץ, ולכן ההוק מקבל את מקור ה-.xu כטקסט, קורא ל-@xuda/compiler, ומחזיר את המודול שנפלט. אין פותר מותאם ואין מודול וירטואלי: .xu נשאר קובץ אמיתי עם נתיב אמיתי, וזה שומר על עקבות מחסנית וגרף HMR ישרים.
enforce: 'pre' חשוב: בלעדיו, vite:esbuild יכול להגיע לקובץ קודם ולהיכשל על <template>, וזה נראה כאילו הקובץ שבור ולא כאילו סדר הצינור שגוי. Vite גם מוסיף ?import לייבוא שאינו JS (ו-?t=… בבקשה חוזרת של HMR), ולכן התוסף מסיר את זה לפני בדיקת ה-include שלו, אחרת הקובץ פשוט לא מקומפל והדפדפן מדווח על שגיאת תחביר בקובץ שהכותב מעולם לא כתב.
HMR
הרמה שמומשה היא טעינה מחדש של רכיב מלא: בעריכה, המודול רץ מחדש, כל מופע טעון של הרכיב הזה נפרק וטעון מחדש מהמודול החדש, ומצב הרכיב מתאפס. reactive({ count: 0 }) ב-<script> חוזר ל-0. שימור מצב לא נוסה בכוונה, כי אחרי עריכה של <script> אין דרך אמינה לדעת איזה חצי של האובייקט הריאקטיבי הישן עדיין אומר אותו דבר.
במצב serve התוסף מוסיף כותרת תחתונה של import.meta.hot.accept. __XUDA_HMR__ מותקן על ידי createApp ב-@xuda/core בפעם הראשונה שאפליקציה נטענת, ולכן התוסף אף פעם לא מזריק ייבוא לקוד המשתמש. אם אף אפליקציה טעונה לא תובעת את הרכיב המעודכן (אף אחד לא הציג אותו, או שהדף עדיין לא עלה), העדכון חוזר לטעינה מחדש של הדף כולו במקום לא לעשות כלום בשקט. בנייה לייצור לא מקבלת כותרת תחתונה של HMR בכלל.
אפשרויות
ראו שפת .xu לדיאלקט מבוסס הבלוקים ש-xuda-cli מקמפל, ולהסבר שם על איך הדיאלקט של המהדר הזה שונה ממנו.