- 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.