reflow_css.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"

typedef enum : uint16_t {
  k_ra8_css_max_rules   = 128U,  
  k_ra8_css_name_pool   = 2048U, 
  k_ra8_css_max_classes = 8U,    
  k_ra8_css_name_max    = 64U,   
  k_ra8_css_max_faces   = 16U,   
  k_ra8_css_max_anc     = 4U,    
} ra8_css_limits_t;

typedef enum : int16_t {
  k_ra8_css_no_face = -1, 
} ra8_css_face_match_t;

typedef enum : uint8_t {
  k_ra8_css_set_bold      = 1U << 0U, 
  k_ra8_css_set_italic    = 1U << 1U, 
  k_ra8_css_set_underline = 1U << 2U, 
  k_ra8_css_set_align     = 1U << 3U, 
  k_ra8_css_set_color     = 1U << 4U, 
  k_ra8_css_set_fontsize  = 1U << 5U, 
  k_ra8_css_set_display   = 1U << 6U, 
  k_ra8_css_set_family    = 1U << 7U, 
} ra8_css_set_t;

typedef enum : uint8_t {
  k_ra8_css_font_px  = 0U, 
  k_ra8_css_font_pct = 1U, 
} ra8_css_font_unit_t;

typedef struct {
  uint8_t  set;        
  uint8_t  style;      
  uint8_t  align;      
  uint8_t  font_unit;  
  uint32_t color;      
  uint16_t font_val;   
  uint8_t  display;    
  uint8_t  pad;        
  uint16_t family_off; 
  uint16_t family_len; 
} ra8_css_style_t;

typedef struct {
  uint8_t  tag;       
  uint8_t  pad8;      
  uint16_t class_off; 
  uint16_t class_len; 
  uint16_t id_off;    
  uint16_t id_len;    
} ra8_css_anc_t;

typedef struct {
  uint8_t         sel_tag;                
  uint8_t         anc_count;              
  uint16_t        class_off;              
  uint16_t        class_len;              
  uint16_t        id_off;                 
  uint16_t        id_len;                 
  uint16_t        order;                  
  ra8_css_anc_t   anc[k_ra8_css_max_anc]; 
  ra8_css_style_t decl;                   
} ra8_css_rule_t;

typedef struct {
  uint16_t family_off;   
  uint16_t family_len;   
  uint16_t src_off;      
  uint16_t src_len;      
  uint8_t  weight_bold;  
  uint8_t  style_italic; 
  uint16_t pad;          
} ra8_css_fontface_t;

typedef struct {
  ra8_css_rule_t     rules[k_ra8_css_max_rules]; 
  ra8_css_fontface_t faces[k_ra8_css_max_faces]; 
  uint16_t           rule_count;                 
  uint16_t           face_count;                 
  uint16_t           next_order;                 
  uint16_t           names_used;                 
  uint8_t            names[k_ra8_css_name_pool]; 
} ra8_css_sheet_t;

typedef struct {
  uint8_t     tag;       
  const char* id;        
  uint16_t    id_len;    
  const char* class_str; 
  uint16_t    class_len; 
} ra8_css_element_t;

[[nodiscard]] ra8_err_t ra8_css_sheet_reset(ra8_css_sheet_t* sheet);

[[nodiscard]] ra8_err_t ra8_css_parse(ra8_css_sheet_t* sheet, const char* css, uint32_t len);

[[nodiscard]] ra8_err_t ra8_css_parse_inline(const char* decls, uint32_t len, ra8_css_style_t* out);

[[nodiscard]] bool ra8_css_rule_matches(const ra8_css_rule_t*    rule,
                                        const ra8_css_element_t* el,
                                        const ra8_css_sheet_t*   sheet);

[[nodiscard]] ra8_css_style_t ra8_css_cascade(const ra8_css_sheet_t*   sheet,
                                              const ra8_css_element_t* el,
                                              ra8_css_style_t          inherited,
                                              ra8_css_style_t          inline_decl);

[[nodiscard]] ra8_css_style_t ra8_css_cascade_ctx(const ra8_css_sheet_t*   sheet,
                                                  const ra8_css_element_t* el,
                                                  ra8_css_style_t          inherited,
                                                  ra8_css_style_t          inline_decl,
                                                  const ra8_css_element_t* ancestors,
                                                  uint8_t                  n_anc);

[[nodiscard]] int16_t ra8_css_match_face(const ra8_css_sheet_t* sheet,
                                         const char*            family,
                                         uint16_t               family_len,
                                         bool                   want_bold,
                                         bool                   want_italic);

[[nodiscard]] bool ra8_css_face_src(const ra8_css_sheet_t* sheet,
                                    uint16_t               idx,
                                    const char**           out_src,
                                    uint16_t*              out_len);
 
#ifdef __cplusplus
}
#endif