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 import {generate_css} from '@fuzdev/fuz_css/generate_css.js'; 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 import type {GenerateCssOptions} from '@fuzdev/fuz_css/generate_css.js'; 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, 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 Diagnostic[]
detected_css_variablesThe var(--*) names referenced in source, unfiltered: names the theme
doesn't define are ignored, since they may be the project's own.
@fuz-variables are merged in here automatically.
type Iterable<string, any, any>
class_definitionstype Record<string, CssClassDefinition | undefined>
interpreterscss_propertiesValid CSS properties for literal validation, or null to skip.
type Set<string> | null
include_basetype boolean
include_themetype boolean
theme?The configured theme option, if any - its variables were already
overlaid into resources' variable graph by the caller. Carried here so
the theme's own overlay can also render into the fuz.theme cascade
layer (above the fuz.preferences OS mappings, with a stance's
color-scheme pin), matching how the same theme behaves at runtime -
and so the footgun guard can flag a theme silently discarded by
variables: null.
type Theme | null
resourcesBundled resources, or null for utility-only mode.
type BundledCssResources | null
additional_elements?type Iterable<string, any, any> | "all"
additional_variables?type Iterable<string, any, any> | "all"
exclude_elements?type Iterable<string, any, any>
exclude_variables?type Iterable<string, any, any>
log?Optional logger; only used to emit resolution stats when include_stats.
type Logger
include_stats?Whether to compute and log resolution statistics.
type boolean
GenerateCssResult import type {GenerateCssResult} from '@fuzdev/fuz_css/generate_css.js'; cssFinal CSS without banner comments - callers add their own.
type string
diagnosticsExtraction + generation + resolution diagnostics, unfiltered.
type Diagnostic[]