//! The artifact graph: which `styled-system/*` files exist, what config each //! depends on, so a config diff regenerates only the affected artifacts. use pandacss_config::CodegenFormat; use std::str::FromStr; use crate::{CodegenContext, EmitMode, Module, SourceExt, emit_module}; #[derive(Debug, Clone, Copy, PartialEq, Eq, PartialOrd, Ord, Hash)] pub enum ArtifactId { Conditions, Css, CssIndex, Cva, Cx, Helpers, JsxCreateRecipeContext, JsxCreateSlotRecipeContext, JsxFactory, JsxHelper, JsxIndex, JsxIsValidProp, JsxPatterns, Patterns, Recipes, Specs, Sva, Themes, Tokens, Types, ViewTransition, PositionTry, Keyframes, FirstThatWorks, } impl ArtifactId { pub const ALL: &'static [Self] = &[ Self::Conditions, Self::Css, Self::CssIndex, Self::Cva, Self::Cx, Self::Helpers, Self::JsxIsValidProp, Self::JsxHelper, Self::JsxFactory, Self::JsxPatterns, Self::JsxCreateRecipeContext, Self::JsxCreateSlotRecipeContext, Self::JsxIndex, Self::Patterns, Self::Recipes, Self::Specs, Self::Sva, Self::Themes, Self::Tokens, Self::Types, Self::ViewTransition, Self::PositionTry, Self::Keyframes, Self::FirstThatWorks, ]; /// Whether `panda codegen` writes this artifact. The spec is opt-in behind /// `--spec`. Exhaustive, so a new variant has to answer before it compiles. #[must_use] pub fn is_styled_system(self) -> bool { match self { Self::Specs => false, Self::Conditions | Self::Css | Self::CssIndex | Self::Cva | Self::Cx | Self::Helpers | Self::JsxCreateRecipeContext | Self::JsxCreateSlotRecipeContext | Self::JsxFactory | Self::JsxHelper | Self::JsxIndex | Self::JsxIsValidProp | Self::JsxPatterns | Self::Patterns | Self::Recipes | Self::Sva | Self::Themes | Self::Tokens | Self::Types | Self::ViewTransition | Self::PositionTry | Self::Keyframes | Self::FirstThatWorks => true, } } #[must_use] pub fn as_str(self) -> &'static str { match self { Self::Conditions => "conditions", Self::Css => "css", Self::CssIndex => "css-index", Self::Cva => "cva", Self::Cx => "cx", Self::Helpers => "helpers", Self::JsxCreateRecipeContext => "jsx-create-recipe-context", Self::JsxCreateSlotRecipeContext => "jsx-create-slot-recipe-context", Self::JsxFactory => "jsx-factory", Self::JsxHelper => "jsx-helper", Self::JsxIndex => "jsx-index", Self::JsxIsValidProp => "jsx-is-valid-prop", Self::JsxPatterns => "jsx-patterns", Self::Patterns => "patterns", Self::Recipes => "recipes", Self::Specs => "specs", Self::Sva => "sva", Self::Themes => "themes", Self::Tokens => "tokens", Self::Types => "types", Self::ViewTransition => "view-transition", Self::PositionTry => "position-try", Self::Keyframes => "keyframes", Self::FirstThatWorks => "first-that-works", } } } impl FromStr for ArtifactId { type Err = (); fn from_str(value: &str) -> Result { Self::ALL .iter() .copied() .find(|id| id.as_str() == value) .ok_or(()) } } #[derive(Debug, Clone, Copy, PartialEq, Eq)] #[repr(u8)] pub enum ConfigDependency { CodegenFormat = 0, CodegenImportExtensions, Conditions, DesignSystem, Hash, JsxFactory, JsxFramework, JsxStyleProps, Patterns, Prefix, Recipes, Separator, Themes, Tokens, Utilities, } impl ConfigDependency { pub const ALL: &'static [Self] = &[ Self::CodegenFormat, Self::CodegenImportExtensions, Self::Conditions, Self::DesignSystem, Self::Hash, Self::JsxFactory, Self::JsxFramework, Self::JsxStyleProps, Self::Patterns, Self::Prefix, Self::Recipes, Self::Separator, Self::Themes, Self::Tokens, Self::Utilities, ]; #[must_use] pub fn as_str(self) -> &'static str { match self { Self::CodegenFormat => "outExtension", Self::CodegenImportExtensions => "forceImportExtension", Self::Conditions => "conditions", Self::DesignSystem => "designSystem", Self::Hash => "hash", Self::JsxFactory => "jsxFactory", Self::JsxFramework => "jsxFramework", Self::JsxStyleProps => "jsxStyleProps", Self::Patterns => "patterns", Self::Prefix => "prefix", Self::Recipes => "recipes", Self::Separator => "separator", Self::Themes => "themes", Self::Tokens => "tokens", Self::Utilities => "utilities", } } } impl FromStr for ConfigDependency { type Err = (); fn from_str(value: &str) -> Result { Self::ALL .iter() .copied() .find(|dependency| dependency.as_str() == value) .ok_or(()) } } #[derive(Debug, Clone, Copy, Default, PartialEq, Eq)] pub struct DependencySet(u128); impl DependencySet { pub const EMPTY: Self = Self(0); #[must_use] pub const fn one(dependency: ConfigDependency) -> Self { Self(1u128 << dependency as u8) } #[must_use] pub const fn from_slice(dependencies: &[ConfigDependency]) -> Self { let mut bits = 0; let mut index = 0; while index < dependencies.len() { bits |= 1u128 << dependencies[index] as u8; index += 1; } Self(bits) } #[must_use] pub const fn intersects(self, other: Self) -> bool { self.0 & other.0 != 0 } #[must_use] pub const fn contains(self, dependency: ConfigDependency) -> bool { self.0 & Self::one(dependency).0 != 0 } #[must_use] pub const fn union(self, other: Self) -> Self { Self(self.0 | other.0) } #[must_use] pub fn to_vec(self) -> Vec { ConfigDependency::ALL .iter() .copied() .filter(|dependency| self.contains(*dependency)) .collect() } } #[derive(Debug, Clone, Copy, PartialEq, Eq)] pub struct ArtifactNode { pub id: ArtifactId, pub dependencies: DependencySet, } #[derive(Debug, Clone, PartialEq, Eq)] pub struct Artifact { pub id: ArtifactId, pub dependencies: DependencySet, pub files: Vec, } #[derive(Debug, Clone, PartialEq, Eq)] pub struct ArtifactFile { pub path: String, pub code: String, pub dependencies: DependencySet, } #[derive(Debug, Clone, Copy, PartialEq, Eq)] pub struct GenerateOptions { pub format: CodegenFormat, pub import_extensions: bool, } impl Default for GenerateOptions { fn default() -> Self { Self { format: CodegenFormat::Mjs, import_extensions: false, } } } #[derive(Debug, Clone, Copy, Default, PartialEq, Eq)] pub struct ArtifactGraph; impl ArtifactGraph { pub const NODES: &'static [ArtifactNode] = &[ ArtifactNode { id: ArtifactId::Helpers, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, // `toCssVar` bakes `prefix` / `hash` into the helpers module. ConfigDependency::Hash, ConfigDependency::Prefix, ]), }, ArtifactNode { id: ArtifactId::JsxIsValidProp, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Utilities, ]), }, ArtifactNode { id: ArtifactId::JsxFactory, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ]), }, ArtifactNode { id: ArtifactId::JsxHelper, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFramework, ]), }, ArtifactNode { id: ArtifactId::JsxPatterns, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Patterns, ]), }, ArtifactNode { id: ArtifactId::JsxCreateRecipeContext, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Recipes, ]), }, ArtifactNode { id: ArtifactId::JsxCreateSlotRecipeContext, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Recipes, ]), }, ArtifactNode { id: ArtifactId::JsxIndex, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Patterns, ]), }, ArtifactNode { id: ArtifactId::Patterns, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Patterns, ConfigDependency::Tokens, ConfigDependency::Utilities, ]), }, ArtifactNode { id: ArtifactId::Recipes, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Conditions, ConfigDependency::Hash, ConfigDependency::Prefix, ConfigDependency::Recipes, ConfigDependency::Separator, ]), }, ArtifactNode { id: ArtifactId::Themes, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Conditions, ConfigDependency::Hash, ConfigDependency::Prefix, ConfigDependency::Themes, ConfigDependency::Tokens, ]), }, ArtifactNode { id: ArtifactId::Types, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Conditions, ConfigDependency::DesignSystem, ConfigDependency::JsxFactory, ConfigDependency::JsxFramework, ConfigDependency::JsxStyleProps, ConfigDependency::Patterns, ConfigDependency::Recipes, ConfigDependency::Themes, ConfigDependency::Tokens, ConfigDependency::Utilities, ]), }, ArtifactNode { id: ArtifactId::Css, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Conditions, ConfigDependency::Hash, ConfigDependency::Prefix, ConfigDependency::Separator, ConfigDependency::Utilities, ]), }, ArtifactNode { id: ArtifactId::Cva, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ]), }, ArtifactNode { id: ArtifactId::Sva, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ]), }, ArtifactNode { id: ArtifactId::ViewTransition, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Prefix, ]), }, ArtifactNode { id: ArtifactId::PositionTry, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Prefix, ]), }, ArtifactNode { id: ArtifactId::Keyframes, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Prefix, ]), }, ArtifactNode { id: ArtifactId::FirstThatWorks, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ]), }, ArtifactNode { id: ArtifactId::Cx, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ]), }, ArtifactNode { id: ArtifactId::Tokens, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, // Prefix/hash live in helpers (`toCssVar`); tokens only owns the value map. ConfigDependency::Tokens, ]), }, ArtifactNode { id: ArtifactId::Specs, dependencies: DependencySet::from_slice(&[ConfigDependency::Tokens]), }, ArtifactNode { id: ArtifactId::CssIndex, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ]), }, ArtifactNode { id: ArtifactId::Conditions, dependencies: DependencySet::from_slice(&[ ConfigDependency::CodegenFormat, ConfigDependency::CodegenImportExtensions, ConfigDependency::Conditions, ConfigDependency::Tokens, ]), }, ]; #[must_use] pub fn nodes(self) -> &'static [ArtifactNode] { Self::NODES } /// The nodes `panda codegen` writes. pub fn styled_system(self) -> impl Iterator { Self::NODES.iter().filter(|node| node.id.is_styled_system()) } /// One node by id, whatever its kind. `Option` is `IntoIterator`, so it /// composes with the other selectors. #[must_use] pub fn node(self, id: ArtifactId) -> Option<&'static ArtifactNode> { Self::NODES.iter().find(|node| node.id == id) } /// The codegen nodes a config diff touches. pub fn affected(self, changed: DependencySet) -> impl Iterator { self.styled_system() .filter(move |node| node.dependencies.intersects(changed)) } /// Generates the given nodes. Selection is the caller's, so a run can mix /// sets — `styled_system().chain(node(Specs))` is one pass, not two. #[must_use] pub fn generate<'a, 'n>( self, source: impl Into>, options: GenerateOptions, nodes: impl IntoIterator, ) -> Vec { let ctx = source.into(); nodes .into_iter() .map(|node| generate_node(ctx, *node, options)) .collect() } /// Everything `panda codegen` writes. #[must_use] pub fn generate_all<'a>( self, source: impl Into>, options: GenerateOptions, ) -> Vec { self.generate(source, options, self.styled_system()) } } #[must_use] pub fn emit_module_files( stem: &str, module: &Module, format: CodegenFormat, has_jsx: bool, import_extensions: bool, dependencies: DependencySet, ) -> Vec { let mode = EmitMode::from_out_extension(format, has_jsx, import_extensions); let printed = emit_module(module, mode); match mode { EmitMode::SourceTs { ext, .. } => printed.source_ts.map_or_else(Vec::new, |code| { vec![ArtifactFile { path: format!("{stem}.{}", source_extension(ext)), code, dependencies, }] }), EmitMode::Split { format, import_extensions, } => { let mut files = Vec::with_capacity(2); if let Some(code) = printed.runtime.filter(|code| !code.is_empty()) { files.push(ArtifactFile { path: format!("{stem}.{}", format.runtime_extension()), code, dependencies, }); } let declaration_ext = if import_extensions { format.explicit_declaration_extension() } else { format.declaration_extension() }; if let (Some(ext), Some(code)) = ( declaration_ext, printed.types.filter(|code| !code.is_empty()), ) { files.push(ArtifactFile { path: format!("{stem}.{ext}"), code, dependencies, }); } files } } } fn generate_node( ctx: CodegenContext<'_>, node: ArtifactNode, options: GenerateOptions, ) -> Artifact { let span = tracing::trace_span!( target: "codegen", "artifact", id = node.id.as_str(), file_count = tracing::field::Empty, byte_count = tracing::field::Empty ); let _entered = span.enter(); let artifact = generate_node_inner(ctx, node, options); span.record("file_count", artifact.files.len()); span.record( "byte_count", artifact .files .iter() .map(|file| file.code.len()) .sum::(), ); artifact } fn generate_node_inner( ctx: CodegenContext<'_>, node: ArtifactNode, options: GenerateOptions, ) -> Artifact { match node.id { ArtifactId::Conditions => { crate::artifacts::conditions::generate(ctx, options, node.dependencies) } ArtifactId::Css => crate::artifacts::css::generate(ctx, options, node.dependencies), ArtifactId::CssIndex => { crate::artifacts::css_index::generate(ctx, options, node.dependencies) } ArtifactId::Cva => crate::artifacts::cva::generate(ctx, options, node.dependencies), ArtifactId::Sva => crate::artifacts::sva::generate(ctx, options, node.dependencies), ArtifactId::ViewTransition => { crate::artifacts::view_transition::generate(ctx, options, node.dependencies) } ArtifactId::PositionTry => { crate::artifacts::position_try::generate(ctx, options, node.dependencies) } ArtifactId::Keyframes => { crate::artifacts::keyframes::generate(ctx, options, node.dependencies) } ArtifactId::FirstThatWorks => { crate::artifacts::first_that_works::generate(ctx, options, node.dependencies) } ArtifactId::Themes => crate::artifacts::themes::generate(ctx, options, node.dependencies), ArtifactId::Tokens => crate::artifacts::tokens::generate(ctx, options, node.dependencies), ArtifactId::Specs => crate::artifacts::specs::generate(ctx, options, node.dependencies), ArtifactId::Cx => crate::artifacts::cx::generate(ctx, options, node.dependencies), ArtifactId::Helpers => crate::artifacts::helpers::generate(ctx, options, node.dependencies), ArtifactId::JsxCreateRecipeContext => { crate::artifacts::jsx::generate_create_recipe_context(ctx, options, node.dependencies) } ArtifactId::JsxCreateSlotRecipeContext => { crate::artifacts::jsx::generate_create_slot_recipe_context( ctx, options, node.dependencies, ) } ArtifactId::JsxFactory => { crate::artifacts::jsx::generate_factory(ctx, options, node.dependencies) } ArtifactId::JsxHelper => { crate::artifacts::jsx::generate_jsx_helper(ctx, options, node.dependencies) } ArtifactId::JsxIndex => { crate::artifacts::jsx::generate_index(ctx, options, node.dependencies) } ArtifactId::JsxIsValidProp => { crate::artifacts::jsx::generate_is_valid_prop(ctx, options, node.dependencies) } ArtifactId::JsxPatterns => { crate::artifacts::jsx::generate_patterns(ctx, options, node.dependencies) } ArtifactId::Patterns => { crate::artifacts::patterns::generate(ctx, options, node.dependencies) } ArtifactId::Recipes => crate::artifacts::recipes::generate(ctx, options, node.dependencies), ArtifactId::Types => crate::artifacts::types::generate(ctx, options, node.dependencies), } } fn source_extension(ext: SourceExt) -> &'static str { match ext { SourceExt::Ts => "ts", SourceExt::Tsx => "tsx", } }