<h2>File Contents: /home/planet5/www/wp-includes/php-ai-client/src/Files/ValueObjects/MimeType.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-includes/php-ai-client/src/Files/ValueObjects/MimeType.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

declare (strict_types=1);
namespace WordPress\AiClient\Files\ValueObjects;

use WordPress\AiClient\Common\Exception\InvalidArgumentException;
/**
 * Value object representing a MIME type.
 *
 * This immutable value object encapsulates MIME type validation and
 * provides convenient methods for checking MIME type categories.
 *
 * @since 0.1.0
 */
final class MimeType
{
    /**
     * @var string The MIME type value.
     */
    private string $value;
    /**
     * Common MIME type mappings for file extensions.
     *
     * @var array&lt;string, string&gt;
     */
    private static array $extensionMap = [
        // Text
        &#039;txt&#039; =&gt; &#039;text/plain&#039;,
        &#039;html&#039; =&gt; &#039;text/html&#039;,
        &#039;htm&#039; =&gt; &#039;text/html&#039;,
        &#039;css&#039; =&gt; &#039;text/css&#039;,
        &#039;js&#039; =&gt; &#039;application/javascript&#039;,
        &#039;json&#039; =&gt; &#039;application/json&#039;,
        &#039;xml&#039; =&gt; &#039;application/xml&#039;,
        &#039;csv&#039; =&gt; &#039;text/csv&#039;,
        &#039;md&#039; =&gt; &#039;text/markdown&#039;,
        // Images
        &#039;jpg&#039; =&gt; &#039;image/jpeg&#039;,
        &#039;jpeg&#039; =&gt; &#039;image/jpeg&#039;,
        &#039;png&#039; =&gt; &#039;image/png&#039;,
        &#039;gif&#039; =&gt; &#039;image/gif&#039;,
        &#039;bmp&#039; =&gt; &#039;image/bmp&#039;,
        &#039;webp&#039; =&gt; &#039;image/webp&#039;,
        &#039;svg&#039; =&gt; &#039;image/svg+xml&#039;,
        &#039;ico&#039; =&gt; &#039;image/x-icon&#039;,
        // Documents
        &#039;pdf&#039; =&gt; &#039;application/pdf&#039;,
        &#039;doc&#039; =&gt; &#039;application/msword&#039;,
        &#039;docx&#039; =&gt; &#039;application/vnd.openxmlformats-officedocument.wordprocessingml.document&#039;,
        &#039;xls&#039; =&gt; &#039;application/vnd.ms-excel&#039;,
        &#039;xlsx&#039; =&gt; &#039;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet&#039;,
        &#039;ppt&#039; =&gt; &#039;application/vnd.ms-powerpoint&#039;,
        &#039;pptx&#039; =&gt; &#039;application/vnd.openxmlformats-officedocument.presentationml.presentation&#039;,
        &#039;odt&#039; =&gt; &#039;application/vnd.oasis.opendocument.text&#039;,
        &#039;ods&#039; =&gt; &#039;application/vnd.oasis.opendocument.spreadsheet&#039;,
        // Archives
        &#039;zip&#039; =&gt; &#039;application/zip&#039;,
        &#039;tar&#039; =&gt; &#039;application/x-tar&#039;,
        &#039;gz&#039; =&gt; &#039;application/gzip&#039;,
        &#039;rar&#039; =&gt; &#039;application/x-rar-compressed&#039;,
        &#039;7z&#039; =&gt; &#039;application/x-7z-compressed&#039;,
        // Audio
        &#039;mp3&#039; =&gt; &#039;audio/mpeg&#039;,
        &#039;wav&#039; =&gt; &#039;audio/wav&#039;,
        &#039;ogg&#039; =&gt; &#039;audio/ogg&#039;,
        &#039;flac&#039; =&gt; &#039;audio/flac&#039;,
        &#039;m4a&#039; =&gt; &#039;audio/m4a&#039;,
        &#039;aac&#039; =&gt; &#039;audio/aac&#039;,
        // Video
        &#039;mp4&#039; =&gt; &#039;video/mp4&#039;,
        &#039;avi&#039; =&gt; &#039;video/x-msvideo&#039;,
        &#039;mov&#039; =&gt; &#039;video/quicktime&#039;,
        &#039;wmv&#039; =&gt; &#039;video/x-ms-wmv&#039;,
        &#039;flv&#039; =&gt; &#039;video/x-flv&#039;,
        &#039;webm&#039; =&gt; &#039;video/webm&#039;,
        &#039;mkv&#039; =&gt; &#039;video/x-matroska&#039;,
        // Fonts
        &#039;ttf&#039; =&gt; &#039;font/ttf&#039;,
        &#039;otf&#039; =&gt; &#039;font/otf&#039;,
        &#039;woff&#039; =&gt; &#039;font/woff&#039;,
        &#039;woff2&#039; =&gt; &#039;font/woff2&#039;,
        // Other
        &#039;php&#039; =&gt; &#039;application/x-httpd-php&#039;,
        &#039;sh&#039; =&gt; &#039;application/x-sh&#039;,
        &#039;exe&#039; =&gt; &#039;application/x-msdownload&#039;,
    ];
    /**
     * Document MIME types.
     *
     * @var array&lt;string&gt;
     */
    private static array $documentTypes = [&#039;application/pdf&#039;, &#039;application/msword&#039;, &#039;application/vnd.openxmlformats-officedocument.wordprocessingml.document&#039;, &#039;application/vnd.ms-excel&#039;, &#039;application/vnd.openxmlformats-officedocument.spreadsheetml.sheet&#039;, &#039;application/vnd.ms-powerpoint&#039;, &#039;application/vnd.openxmlformats-officedocument.presentationml.presentation&#039;, &#039;application/vnd.oasis.opendocument.text&#039;, &#039;application/vnd.oasis.opendocument.spreadsheet&#039;];
    /**
     * Constructor.
     *
     * @since 0.1.0
     *
     * @param string $value The MIME type value.
     * @throws InvalidArgumentException If the MIME type is invalid.
     */
    public function __construct(string $value)
    {
        if (!self::isValid($value)) {
            throw new InvalidArgumentException(sprintf(&#039;Invalid MIME type: %s&#039;, $value));
        }
        $this-&gt;value = strtolower($value);
    }
    /**
     * Gets the primary known file extension for this MIME type.
     *
     * @since 0.1.0
     *
     * @return string The file extension (without the dot).
     * @throws InvalidArgumentException If no known extension exists for this MIME type.
     */
    public function toExtension(): string
    {
        // Reverse lookup for the MIME type to find the extension.
        $extension = array_search($this-&gt;value, self::$extensionMap, \true);
        if ($extension === \false) {
            throw new InvalidArgumentException(sprintf(&#039;No known extension for MIME type: %s&#039;, $this-&gt;value));
        }
        return $extension;
    }
    /**
     * Creates a MimeType from a file extension.
     *
     * @since 0.1.0
     *
     * @param string $extension The file extension (without the dot).
     * @return self The MimeType instance.
     * @throws InvalidArgumentException If the extension is not recognized.
     */
    public static function fromExtension(string $extension): self
    {
        $extension = strtolower($extension);
        if (!isset(self::$extensionMap[$extension])) {
            throw new InvalidArgumentException(sprintf(&#039;Unknown file extension: %s&#039;, $extension));
        }
        return new self(self::$extensionMap[$extension]);
    }
    /**
     * Checks if a MIME type string is valid.
     *
     * @since 0.1.0
     *
     * @param string $mimeType The MIME type to validate.
     * @return bool True if valid.
     */
    public static function isValid(string $mimeType): bool
    {
        // Basic MIME type validation: type/subtype
        return (bool) preg_match(&#039;/^[a-zA-Z0-9][a-zA-Z0-9!#$&amp;\-\^_+.]*\/[a-zA-Z0-9][a-zA-Z0-9!#$&amp;\-\^_+.]*$/&#039;, $mimeType);
    }
    /**
     * Checks if this MIME type is a specific type.
     *
     * This method returns true when the stored MIME type begins with the
     * given prefix. For example, `&quot;audio&quot;` matches `&quot;audio/mpeg&quot;`.
     *
     * @since 0.1.0
     *
     * @param string $mimeType The MIME type prefix to check (e.g., &quot;audio&quot;, &quot;image&quot;).
     * @return bool True if this MIME type is of the specified type.
     */
    public function isType(string $mimeType): bool
    {
        return str_starts_with($this-&gt;value, strtolower($mimeType) . &#039;/&#039;);
    }
    /**
     * Checks if this is an image MIME type.
     *
     * @since 0.1.0
     *
     * @return bool True if this is an image type.
     */
    public function isImage(): bool
    {
        return $this-&gt;isType(&#039;image&#039;);
    }
    /**
     * Checks if this is an audio MIME type.
     *
     * @since 0.1.0
     *
     * @return bool True if this is an audio type.
     */
    public function isAudio(): bool
    {
        return $this-&gt;isType(&#039;audio&#039;);
    }
    /**
     * Checks if this is a video MIME type.
     *
     * @since 0.1.0
     *
     * @return bool True if this is a video type.
     */
    public function isVideo(): bool
    {
        return $this-&gt;isType(&#039;video&#039;);
    }
    /**
     * Checks if this is a text MIME type.
     *
     * @since 0.1.0
     *
     * @return bool True if this is a text type.
     */
    public function isText(): bool
    {
        return $this-&gt;isType(&#039;text&#039;);
    }
    /**
     * Checks if this is a document MIME type.
     *
     * @since 0.1.0
     *
     * @return bool True if this is a document type.
     */
    public function isDocument(): bool
    {
        return in_array($this-&gt;value, self::$documentTypes, \true);
    }
    /**
     * Checks if this MIME type equals another.
     *
     * @since 0.1.0
     *
     * @param self|string $other The other MIME type to compare.
     * @return bool True if equal.
     * @throws InvalidArgumentException If the other MIME type is invalid.
     */
    public function equals($other): bool
    {
        if ($other instanceof self) {
            return $this-&gt;value === $other-&gt;value;
        }
        if (is_string($other)) {
            return $this-&gt;value === strtolower($other);
        }
        throw new InvalidArgumentException(sprintf(&#039;Invalid MIME type comparison: %s&#039;, gettype($other)));
    }
    /**
     * Gets the string representation of the MIME type.
     *
     * @since 0.1.0
     *
     * @return string The MIME type value.
     */
    public function __toString(): string
    {
        return $this-&gt;value;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FFiles%2FValueObjects'>⬅ Back to Directory</a>