Shared CSS-generation pipeline for the Gro generator and the Vite plugin.
Both consumers extract classes from source files their own way (batch via the Gro filer, incrementally via Vite's transform hook), then funnel the aggregated result through this single function so their CSS output stays identical. Callers own banner wrapping and error/warning dispatch (those differ by logger), this owns the generate → resolve → bundle pipeline.
3 declarations
(options: GenerateCssOptions): GenerateCssResult Runs the full CSS-generation pipeline: utility classes via
generate_classes_css, then — when base or theme output is enabled and
bundled resources are available — base styles and theme variables via
resolve_css + generate_bundled_css. Returns the combined CSS and every
diagnostic produced along the way.
optionsGenerateCssResult GenerateCssOptions Inputs to generate_css. The first group mirrors the shape returned by
CssClasses.get_all() plus its diagnostics, so callers can forward it
directly.
all_classesAll detected class names, already exclude-filtered.
type Set<string>
all_classes_with_locationsSource locations per class, for diagnostics.
type Map<string, Array<SourceLocation> | null>
explicit_classesClasses from @fuz-classes/additional_classes; unresolved ones error.
type Set<string> | null
all_elementsAll detected HTML element names.
type Set<string>
explicit_elementsElements from @fuz-elements; unresolved ones error.
type Set<string> | null
explicit_variablesVariables from @fuz-variables; unresolved ones error.
type Set<string> | null
extraction_diagnosticsDiagnostics accumulated during extraction.
type Array<Diagnostic>
detected_css_variablesCSS variables referenced in source, already filtered to known theme
variables by the caller. @fuz-variables are merged in here automatically.
type Set<string>
class_definitionstype Record<string, CssClassDefinition | undefined>
interpreterstype Array<CssClassDefinitionInterpreter>
css_propertiesValid CSS properties for literal validation, or null to skip.
type Set<string> | null
include_basetype boolean
include_themetype boolean
resourcesBundled resources, or null for utility-only mode.
type BundledCssResources | null
additional_elementstype Iterable<string> | 'all'
additional_variablestype Iterable<string> | 'all'
exclude_elementstype Iterable<string>
exclude_variablestype Iterable<string>
theme_specificitytype number
logOptional logger; only used to emit resolution stats when include_stats.
type Logger
include_statsWhether to compute and log resolution statistics.
type boolean
GenerateCssResult cssFinal CSS without banner comments — callers add their own.
type string
diagnosticsExtraction + generation + resolution diagnostics, unfiltered.
type Array<Diagnostic>