CodeVetter · Repo Unpack · Extension points
postcss/postcss
The primary extension boundary is the plugin interface, with creators, packs, per-result preparation, filtered visitors, and lifecycle hooks. Parser and stringifier options provide a separate syntax boundary. AST factories and mutation methods allow extensions to construct or move nodes while retaining source information. Messages connect plugins to runners, while internal registration functions wire modules together and should be distinguished from public plugin APIs.
- Processor.normalize accepts creators marked postcss=true, postcss wrappers, objects containing plugins arrays, named plugin objects, and legacy functions; Processor.use exposes incremental registration.
- Plugin.prepare(result) can create per-processing state and return runtime listeners that are merged over the original plugin; Helpers supplies result, postcss, and the public API.
- PLUGIN_PROPS defines recognized lifecycle events; prepareVisitors builds listener arrays in plugin order, expands '*' handlers, lowercases named filters, and rejects unknown capitalized event names.
- Declaration and AtRule visitor filters use lowercased property/name keys; getEvents schedules general enter, filtered enter, children where applicable, general exit, and filtered exit.
- Custom parsing resolves syntax.parse first and then an explicit parser override; custom serialization resolves syntax.stringify first and then an explicit stringifier override, accepting function or method-bearing forms.
- Stringifier subclasses can override traversal methods; body only uses its built-in stack expansion when atrule, block, body, rule, and stringify retain their base implementations, preserving subclass dispatch otherwise.
- Plugins can append dependency and dir-dependency messages, including optional directory globs; runner guidelines assign watching and rebuild behavior to consumers of result.messages.
- Internal registerParse/registerRule/registerAtRule/registerRoot and Root/Document processor registrations resolve module dependencies; Parser.precheckMissedSemicolon is separately marked as a Safe Parser hook.