CoreFiles by mySites.guru
ModalityCombinationsUtil.php48 lines, 1,694 bytes, from wordpress-7.2-beta1.zip
Raw History Compare with 7.1-beta4
md5
0d71947648672969f7b3dcdf2bf427aa
sha1
13bda33550570e991de8df513eab76e855ef77ee
sha256
01ccdcab91ab8ce94a8b0b61ccf1f837f6b8cdb776f73e754aebb0e05186499c
<?php

declare (strict_types=1);
namespace WordPress\AiClient\Messages\Util;

use WordPress\AiClient\Messages\Enums\ModalityEnum;
/**
 * Utility class for building modality combinations.
 *
 * @since 1.4.0
 */
class ModalityCombinationsUtil
{
    /**
     * Builds all modality combinations that always include the required modalities
     * with every possible subset of the optional modalities.
     *
     * Uses binary representation to enumerate all 2^n subsets of the optional
     * modalities. Each subset is merged with the required modalities to form one
     * complete combination. Modality lists are unordered, so only unique
     * combinations (not permutations) are produced.
     *
     * @since 1.4.0
     *
     * @param list<ModalityEnum> $required Required modalities included in every combination.
     * @param list<ModalityEnum> $optional Optional modalities to generate subsets from.
     * @return list<list<ModalityEnum>> List of modality combinations, each containing
     *                                  all required modalities plus a unique subset of
     *                                  the optional modalities.
     */
    public static function buildCombinations(array $required, array $optional): array
    {
        $combinations = [];
        $count = count($optional);
        $subsetCount = 1 << $count;
        // 2^count.
        for ($i = 0; $i < $subsetCount; $i++) {
            $combo = $required;
            for ($j = 0; $j < $count; $j++) {
                if ($i & 1 << $j) {
                    $combo[] = $optional[$j];
                }
            }
            $combinations[] = $combo;
        }
        return $combinations;
    }
}

The same content is in 6 releases, WordPress 7.2-beta1 to 7.2-RC1. See them all, or every version of this file.