Generated Files
PikaCSS 會刻意產生一些 generated artifacts。先搞清楚它們各自代表什麼,才不會把 generated output 誤認成需要手動維護的 source。
pika.css
pika.css 是一個 virtual module。你會在 app entry 匯入它,但不會直接編輯它。
ts
// 在 app entry 檔中匯入 virtual CSS module
import 'pika.css'pika.gen.ts
這個檔案提供產生的 typing 與 autocomplete 支援。它可能會擴充全域 pika() 函式,以及 plugin 定義的 selectors、shortcuts、variables 等內容。
pika.gen.css
這個檔案就是 integration 寫到磁碟上的產生 CSS。
不要編輯 generated files
你對 generated files 做的修改都會被覆蓋。如果輸出不對,應該回頭修 source style definition、engine config 或 integration 設定。
什麼時候 generated files 很有用
Generated files 很適合拿來除錯:
- 確認某個
pika()呼叫是否真的被轉換 - 檢查輸出了哪些 selectors 或 declarations
- 驗證 autocomplete 是否包含預期的 plugin 資料
什麼時候 generated files 不是答案
- 它們不是拿來自訂 design tokens 的地方。
- 它們不是拿來修 broken selectors 的地方。
- 它們不是拿來加入 preflights 或 plugins 的地方。
這些調整都應該回到 config 或 source 去做。