Παραγόμενο αποτέλεσμα

Πολλά πακέτα pantoken δημιουργούν αρχεία κατά το build — ένα φύλλο στυλ, ένα theme.json, ένα ενσωματωμένο module token. Για να παραμείνει το repo καθαρό και τα παραγόμενα σωστά, κάθε πακέτο ακολουθεί μια σύμβαση και ένα task του workspace επικυρώνει το σύνολο.

Η σύμβαση generated/

Κάθε πακέτο που παράγει ένα build artifact το γράφει σε έναν ανά-πακέτο κατάλογο generated/, και τίποτε άλλο δεν ζει εκεί. Ένας κανόνας σε .gitignore τα καλύπτει όλα:

**/generated/

Έτσι κανένα παραγόμενο αρχείο δεν δεσμεύεται — ένα build το αναπαράγει. Δύο είδη εξόδου καταλήγουν εκεί:

• Αρχεία προς αποστολή (Shippable statics) — αρχεία που ένας καταναλωτής εισάγει, όπως το @pantoken/css's style.css ή το @pantoken/scss's tokens.scss. Ο χάρτης exports του πακέτου διατηρεί το δημόσιο κλειδί ("./style.css") αλλά το δείχνει στο generated/, έτσι το API του καταναλωτή δεν αλλάζει ποτέ.
• Ενδιάμεσα του build (Build intermediates) — αρχεία που το ίδιο το source του πακέτου εισάγει και δένεται στο dist, όπως το παρεχόμενο JSON του @pantoken/tokens. Αυτά δεν δημοσιεύονται μόνα τους· συμπιέζονται στο build.

Επικύρωση του αποτελέσματος

@pantoken/validate-generated (ένα ιδιωτικό εργαλείο) τρέχει μετά το build και ελέγχει τρία πράγματα:

1. κάθε generator πακέτο έγραψε πράγματι έναν μη-κενό κατάλογο generated/,
2. το CLI pantoken εκπέμπει τουλάχιστον ένα αρχείο για κάθε υποστηριζόμενο target, και
3. κανένα παραγόμενο φύλλο στυλ δεν αποκλίνει από το token IR — danglingReferences για αυτοτελή sheets, και unknownReferences για τις γέφυρες που μόνο αναφέρονται σε tokens ορισμένα αλλού.

Εντολές

# Rebuild every package, regenerating all generated/ output.
pnpm run generate

# Rebuild, then run the validator.
pnpm run validate:generated

Ο validator είναι επίσης συνδεδεμένος με το pnpm run ready, έτσι η απόκλιση πιάνεται στην τυπική πύλη.