functions.php

<?php
/**
 * Abira — functions.php
 *
 * @package Abira
 * @since   1.0.0
 */

if ( ! defined( 'ABSPATH' ) ) {
	exit;
}

// -----------------------------------------------------------------------
// Theme setup
// -----------------------------------------------------------------------

/**
 * Sets up theme defaults and registers support for various WordPress features.
 */
function abira_setup() {

	// Make theme available for translation.
	load_theme_textdomain( 'abira', get_template_directory() . '/languages' );

	// Add support for block styles.
	add_theme_support( 'wp-block-styles' );

	// Add support for editor styles.
	add_theme_support( 'editor-styles' );

	// Add support for post thumbnails.
	add_theme_support( 'post-thumbnails' );

	// Add support for HTML5 markup.
	add_theme_support(
		'html5',
		array(
			'search-form',
			'comment-form',
			'comment-list',
			'gallery',
			'caption',
			'style',
			'script',
			'navigation-widgets',
		)
	);

	// Add support for responsive embeds.
	add_theme_support( 'responsive-embeds' );

	// Remove core block patterns — starter theme ships clean.
	remove_theme_support( 'core-block-patterns' );

	// Editor stylesheets (frontend parity + editor-only adjustments).
	add_editor_style( array( 'style.css', 'assets/css/editor-style.css' ) );
}
add_action( 'after_setup_theme', 'abira_setup' );

// -----------------------------------------------------------------------
// Enqueue
// -----------------------------------------------------------------------

/**
 * Enqueue theme stylesheet.
 *
 * Block themes don't need a heavy frontend stylesheet.
 * style.css acts as theme registration; add custom CSS here only when
 * theme.json alone is not enough.
 */
function abira_enqueue_styles() {
	wp_enqueue_style(
		'abira-style',
		get_stylesheet_uri(),
		array(),
		wp_get_theme()->get( 'Version' )
	);
}
add_action( 'wp_enqueue_scripts', 'abira_enqueue_styles' );

// -----------------------------------------------------------------------
// Block styles
// -----------------------------------------------------------------------

/**
 * Enqueue block-specific styles.
 */
function abira_enqueue_block_styles() {
	wp_enqueue_block_style(
		'core/navigation',
		array(
			'handle' => 'abira-block-navigation',
			'src'    => get_template_directory_uri() . '/assets/css/block-style.css',
			'ver'    => wp_get_theme()->get( 'Version' ),
		)
	);

	// カスタムブロックスタイル（button / separator）.
	wp_enqueue_style(
		'abira-block-styles',
		get_template_directory_uri() . '/assets/css/block-styles.css',
		array(),
		wp_get_theme()->get( 'Version' )
	);
}
add_action( 'init', 'abira_enqueue_block_styles' );

// -----------------------------------------------------------------------
// Register block styles
// -----------------------------------------------------------------------

/**
 * Register custom block styles.
 *
 * Adds style variations to core blocks so editors can choose
 * from the block toolbar in the site editor.
 */
function abira_register_block_styles() {

	// Button: Outline.
	register_block_style(
		'core/button',
		array(
			'name'  => 'outline',
			'label' => __( 'Outline', 'abira' ),
		)
	);

	// Separator: Wavy（波線）.
	register_block_style(
		'core/separator',
		array(
			'name'  => 'wavy',
			'label' => __( 'Wavy', 'abira' ),
		)
	);
}
add_action( 'init', 'abira_register_block_styles' );

// -----------------------------------------------------------------------
// Block patterns
// -----------------------------------------------------------------------

/**
 * Register block pattern category and patterns.
 *
 * WordPress 6.0+ auto-discovers patterns in /patterns via file headers.
 * Only the category needs to be registered explicitly.
 */
function abira_register_patterns() {

	register_block_pattern_category(
		'abira',
		array( 'label' => __( 'Abira', 'abira' ) )
	);
}
add_action( 'init', 'abira_register_patterns' );

// -----------------------------------------------------------------------
// Accessibility: fix list structure in navigation blocks
// -----------------------------------------------------------------------

/**
 * Ensure <ul> elements inside navigation and page-list blocks
 * contain only valid children (<li>, <script>, <template>).
 *
 * WordPress core may render non-<li> elements (buttons, divs) as
 * direct children of <ul>, which violates HTML spec and fails
 * accessibility audits. This filter wraps any invalid children
 * in <li> elements using DOMDocument for safe HTML manipulation.
 *
 * @param string $block_content Rendered block HTML.
 * @param array  $block         Block data.
 * @return string Sanitised block HTML.
 */
function abira_fix_nav_list_structure( $block_content, $block ) {
	if ( empty( $block_content ) || false === strpos( $block_content, '<ul' ) ) {
		return $block_content;
	}

	$dom = new DOMDocument();
	libxml_use_internal_errors( true );
	$dom->loadHTML(
		'<html><head><meta charset="UTF-8"></head><body>' . $block_content . '</body></html>',
		LIBXML_HTML_NODEFDTD
	);
	libxml_clear_errors();

	$changed    = false;
	$valid_tags = array( 'li', 'script', 'template' );
	$uls        = $dom->getElementsByTagName( 'ul' );

	foreach ( $uls as $ul ) {
		// Collect invalid direct children first — cannot modify while iterating.
		$invalid = array();
		// phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
		foreach ( $ul->childNodes as $child ) {
			// phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
			if ( XML_ELEMENT_NODE !== $child->nodeType ) {
				continue;
			}
			// phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
			if ( ! in_array( strtolower( $child->nodeName ), $valid_tags, true ) ) {
				$invalid[] = $child;
			}
		}

		foreach ( $invalid as $node ) {
			$li = $dom->createElement( 'li' );
			$li->setAttribute( 'class', 'abira-nav-item-wrap' );
			// phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
			$node->parentNode->replaceChild( $li, $node );
			$li->appendChild( $node );
			$changed = true;
		}
	}

	if ( ! $changed ) {
		return $block_content;
	}

	// Extract only <body> inner content to avoid <html> wrapper.
	$body   = $dom->getElementsByTagName( 'body' )->item( 0 );
	$output = '';
	// phpcs:ignore WordPress.NamingConventions.ValidVariableName.UsedPropertyNotSnakeCase
	foreach ( $body->childNodes as $child ) {
		$output .= $dom->saveHTML( $child );
	}

	return $output;
}
add_filter( 'render_block_core/navigation', 'abira_fix_nav_list_structure', 10, 2 );
add_filter( 'render_block_core/page-list', 'abira_fix_nav_list_structure', 10, 2 );