care-book-block-ultimate/phpstan-bootstrap.php

<?php
/**
 * PHPStan Bootstrap File - WordPress Functions
 *
 * Additional WordPress function definitions for better PHPStan analysis
 *
 * @package CareBook\Ultimate\Tests
 * @since 1.0.0
 */

declare(strict_types=1);

// Load main test bootstrap first
require_once __DIR__ . '/tests/bootstrap.php';

// Additional WordPress functions that might not be in stubs
if (!function_exists('admin_url')) {
    /**
     * Retrieves the URL to the admin area for the current site
     */
    function admin_url(string $path = '', string $scheme = 'admin'): string
    {
        return 'http://example.com/wp-admin/' . ltrim($path, '/');
    }
}

if (!function_exists('check_admin_referer')) {
    /**
     * Ensures intent by verifying that a user was referred from another admin page
     */
    function check_admin_referer(int|string $action = -1, string $query_arg = '_wpnonce'): int
    {
        return 1;
    }
}

if (!function_exists('is_plugin_active')) {
    /**
     * Checks whether a plugin is activated
     */
    function is_plugin_active(string $plugin): bool
    {
        return true;
    }
}

if (!function_exists('update_option')) {
    /**
     * Updates the value of an option that was already added
     */
    function update_option(string $option, mixed $value, ?bool $autoload = null): bool
    {
        return true;
    }
}

// WordPress debugging constants
if (!defined('WP_DEBUG')) {
    define('WP_DEBUG', true);
}

if (!defined('WP_DEBUG_LOG')) {
    define('WP_DEBUG_LOG', true);
}

if (!defined('WP_DEBUG_DISPLAY')) {
    define('WP_DEBUG_DISPLAY', true);
}

// WordPress filesystem constants
if (!defined('FS_CHMOD_FILE')) {
    define('FS_CHMOD_FILE', 0644);
}

if (!defined('FS_CHMOD_DIR')) {
    define('FS_CHMOD_DIR', 0755);
}

// WordPress cache constants
if (!defined('WP_CACHE')) {
    define('WP_CACHE', false);
}

// Additional WordPress plugin functions
if (!function_exists('plugin_dir_path')) {
    /**
     * Gets the filesystem directory path (with trailing slash) for the plugin
     */
    function plugin_dir_path(string $file): string
    {
        return dirname($file) . '/';
    }
}

if (!function_exists('plugin_dir_url')) {
    /**
     * Gets the URL (with trailing slash) for the plugin
     */
    function plugin_dir_url(string $file): string
    {
        return 'http://example.com/wp-content/plugins/' . basename(dirname($file)) . '/';
    }
}

if (!function_exists('register_activation_hook')) {
    /**
     * Sets the activation hook for a plugin
     */
    function register_activation_hook(string $file, callable $function): void
    {
        // Mock implementation
    }
}

if (!function_exists('register_deactivation_hook')) {
    /**
     * Sets the deactivation hook for a plugin
     */
    function register_deactivation_hook(string $file, callable $function): void
    {
        // Mock implementation
    }
}

if (!function_exists('register_uninstall_hook')) {
    /**
     * Sets the uninstall hook for a plugin
     */
    function register_uninstall_hook(string $file, callable $function): void
    {
        // Mock implementation
    }
}

// WordPress nonce functions
if (!function_exists('wp_nonce_field')) {
    /**
     * Retrieve or display nonce hidden field for forms
     */
    function wp_nonce_field(int|string $action = -1, string $name = '_wpnonce', bool $referer = true, bool $echo = true): string
    {
        $nonce_field = '<input type="hidden" name="' . $name . '" value="mock_nonce" />';
        if ($echo) {
            echo $nonce_field;
        }
        return $nonce_field;
    }
}

if (!function_exists('wp_nonce_url')) {
    /**
     * Retrieve URL with nonce added to URL query
     */
    function wp_nonce_url(string $actionurl, int|string $action = -1, string $name = '_wpnonce'): string
    {
        return $actionurl . '?' . $name . '=mock_nonce';
    }
}

if (!function_exists('wp_create_nonce')) {
    /**
     * Creates a cryptographic token tied to a specific action, user, user session
     */
    function wp_create_nonce(int|string $action = -1): string
    {
        return 'mock_nonce_' . $action;
    }
}

// WordPress internationalization functions
if (!function_exists('_e')) {
    /**
     * Displays translated text
     */
    function _e(string $text, string $domain = 'default'): void
    {
        echo $text;
    }
}

if (!function_exists('_n')) {
    /**
     * Translates and retrieves the singular or plural form based on the supplied number
     */
    function _n(string $single, string $plural, int $number, string $domain = 'default'): string
    {
        return $number === 1 ? $single : $plural;
    }
}

if (!function_exists('_x')) {
    /**
     * Translates string with gettext context
     */
    function _x(string $text, string $context, string $domain = 'default'): string
    {
        return $text;
    }
}

if (!function_exists('esc_attr__')) {
    /**
     * Retrieves the translation of $text and escapes it for safe use in an attribute
     */
    function esc_attr__(string $text, string $domain = 'default'): string
    {
        return esc_attr($text);
    }
}

if (!function_exists('esc_attr')) {
    /**
     * Escaping for HTML attributes
     */
    function esc_attr(string $text): string
    {
        return htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
    }
}

echo "PHPStan WordPress Bootstrap Complete\n";