generator-class map. * * @var array|null */ private static $generators_cache = null; /** * Build (once) the map of block name => CSS generator class. * * The map is derived from the block catalog so adding a block only means * declaring its `generator` in Block_Manager. Add-ons can register a * generator for their own block via the `flexa_block_css_generators` filter. * * @return array */ public static function get_generators(): array { if ( null === self::$generators_cache ) { $map = []; foreach ( Block_Manager::get_block_catalog() as $block ) { if ( ! is_array( $block ) ) { continue; } $name = (string) ( $block['name'] ?? '' ); $generator = (string) ( $block['generator'] ?? '' ); if ( '' !== $name && '' !== $generator ) { $map[ $name ] = $generator; } } /** * Filter the block-name => CSS-generator-class map. * * @param array $map Block name => generator FQCN. */ self::$generators_cache = apply_filters( 'flexa_block_css_generators', $map ); } return self::$generators_cache ?? []; } /** * Clear the cached generator map (e.g. after blocks change, or in tests). */ public static function reset_generators(): void { self::$generators_cache = null; } /** * Cached block.json defaults per block type. * * @var array */ private static $defaults_cache = []; /** * Generate and store CSS for a post. * * @param int $post_id Post ID. * @return string */ public static function generate_for_post( $post_id ) { $post = get_post( $post_id ); if ( ! $post || empty( $post->post_content ) ) { self::clear_cache( $post_id ); return ''; } $blocks = parse_blocks( $post->post_content ); $css = self::generate_for_blocks( $blocks ); if ( '' !== $css ) { update_post_meta( $post_id, self::CSS_META_KEY, $css ); update_post_meta( $post_id, self::VERSION_META_KEY, FLEXA_BLOCK_VER ); } else { self::clear_cache( $post_id ); } return $css; } /** * Generate CSS for an array of parsed blocks. * * @param array $blocks Parsed blocks. * @return string */ public static function generate_for_blocks( $blocks ) { $builder = new CSS_Builder(); self::process_blocks( $blocks, $builder ); return $builder->get_output(); } /** * Recursively process blocks. * * @param array $blocks Blocks. * @param CSS_Builder $builder Builder. */ private static function process_blocks( $blocks, $builder ) { $generators = self::get_generators(); foreach ( $blocks as $block ) { if ( empty( $block['blockName'] ) ) { continue; } if ( isset( $generators[ $block['blockName'] ] ) ) { $attrs = self::merge_defaults( $block['blockName'], $block['attrs'] ?? [] ); // `blockId` is a user-controlled block attribute that becomes part of // the CSS selector (.flexa--) printed inline via // wp_add_inline_style(). Sanitize it HERE — once, for every generator — // exactly as each render.php sanitizes the matching class, so a crafted // id (e.g. "…") can't break out of the inline