<?php
/**
 * Public helper functions for widget authors.
 *
 * @link       https://www.softvoltai.com/
 * @since      1.0.0
 *
 * @package    Nexwordx
 * @subpackage Nexwordx/includes
 */

// If this file is called directly, abort.
if ( ! defined( 'WPINC' ) ) {
	die;
}

/**
 * Register a widget from an array definition (CONTRACT §4.1 keys, plus an optional
 * 'render' callable for server-rendered widgets). Call it on `nexwordx_widgets_register`
 * (or earlier: registrations before the registry loads are queued).
 *
 * @since  1.0.0
 * @param  array $definition { name, title, icon, categories, keywords, render, rootClass, sections, controls, inlineEditing, common, resolves }.
 * @return bool Whether the widget was registered (false on a taken or invalid name).
 */
function nexwordx_register_widget( array $definition ) {
	if ( empty( $definition['name'] ) || ! is_string( $definition['name'] ) ) {
		_doing_it_wrong( __FUNCTION__, esc_html__( 'A widget definition needs a "name".', 'nexwordx' ), '1.0.0' );
		return false;
	}
	return Nexwordx_Widgets::instance()->register( $definition );
}

/**
 * The capabilities the document sanitiser needs, for the current (or a given) user.
 *
 * @since  1.0.0
 * @param  int|null $user_id User id; the current user when null.
 * @return array { unfiltered_html: bool, edit_css: bool }
 */
function nexwordx_sanitize_caps( $user_id = null ) {
	return Nexwordx_Controls::caps_for_user( $user_id );
}