feat: add style_properties module for docs

Author: LastLeaf

float-pigment-css-macro/src/property_list.rs

@@ -532,7 +532,7 @@ impl ToTokens for PropertiesDefinition {
                 cur_index += 1;
                 let invalid_ident =
                     Ident::new(&format!("Invalid{:X}", cur_index), enum_name.span());
-                enum_fields.push(quote!(#[serde(rename = "_")] #invalid_ident));
+                enum_fields.push(quote!(#[doc(hidden)] #[serde(rename = "_")] #invalid_ident));
             }
             cur_index += 1;
             enum_fields.push(quote! {

float-pigment-css-macro/src/style_syntax.rs

@@ -737,10 +737,14 @@ impl Parse for StyleSyntaxDefinition {
 impl ToTokens for StyleSyntaxDefinition {
     fn to_tokens(&self, tokens: &mut TokenStream) {
         let Self { trait_name, items } = self;
+
+        // the parser functions
         let item_fn_list: Vec<_> = items.iter().map(|x| quote! { #x }).collect();
         tokens.append_all(quote! {
             #(#item_fn_list)*
         });
+
+        // the value parser mapping
         let map: Vec<_> = items
             .iter()
             .map(|item| {
@@ -846,6 +850,13 @@ impl ToTokens for StyleSyntaxDefinition {
                 Ok(false)
             }
         });
+
+        // a pub mod for docs
+        let mod_doc = format!("!!! TODO");
+        tokens.append_all(quote! {
+            #[doc = #mod_doc]
+            pub mod style_properties {}
+        });
     }
 }
 

float-pigment-css/src/lib.rs

@@ -14,6 +14,14 @@
 //! 1. Merge the `MatchedRuleList` into `NodeProperties` with `MatchedRuleList::merge_node_properties`.
 //!
 //! The result `NodeProperties` contains all supported CSS properties.
+//! 
+//! ### Supported CSS Features
+//! 
+//! The supported selectors can be found in [StyleQuery] docs.
+//! 
+//! The supported media features can be found in [MediaQueryStatus] docs.
+//! 
+//! The supported style properties can be found in [style_properties](crate::property::style_properties) module docs.
 //!
 //! ### The Binary Format
 //!