@d1g1tal/media-type 4.0.1 → 4.1.0

package/dist/media-type.js

@@ -24,34 +24,33 @@ var MediaType = (() => {
   });
 
   // src/utils.js
-  var removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(/^[ \t\n\r]+/u, "").replace(/[ \t\n\r]+$/u, "");
-  var removeTrailingHTTPWhitespace = (string) => string.replace(/[ \t\n\r]+$/u, "");
-  var isHTTPWhitespaceChar = (char) => char === " " || char === "	" || char === "\n" || char === "\r";
-  var solelyContainsHTTPTokenCodePoints = (string) => /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u.test(string);
-  var solelyContainsHTTPQuotedStringTokenCodePoints = (string) => /^[\t\u0020-\u007E\u0080-\u00FF]*$/u.test(string);
-  var asciiLowercase = (string) => string.replace(/[A-Z]/ug, (l) => l.toLowerCase());
+  var whitespaceCharacters = [" ", "	", "\n", "\r"];
+  var leadingWhitespace = /^[ \t\n\r]+/u;
+  var trailingWhitespace = /[ \t\n\r]+$/u;
+  var httpTokenCodePoints = /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u;
+  var httpQuotedTokenCodePoints = /^[\t\u0020-\u007E\u0080-\u00FF]*$/u;
+  var removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(leadingWhitespace, "").replace(trailingWhitespace, "");
+  var removeTrailingHTTPWhitespace = (string) => string.replace(trailingWhitespace, "");
+  var isHTTPWhitespaceChar = (char) => whitespaceCharacters.includes(char);
+  var solelyContainsHTTPTokenCodePoints = (string) => httpTokenCodePoints.test(string);
+  var solelyContainsHTTPQuotedStringTokenCodePoints = (string) => httpQuotedTokenCodePoints.test(string);
+  var asciiLowercase = (string) => {
+    let result = "";
+    for (const [char, charCode = char.charCodeAt(0)] of string) {
+      result += charCode >= 65 && charCode <= 90 ? String.fromCharCode(charCode + 32) : char;
+    }
+    return result;
+  };
   var collectAnHTTPQuotedString = (input, position) => {
     let value = "";
-    position++;
-    while (true) {
-      while (position < input.length && input[position] !== '"' && input[position] !== "\\") {
-        value += input[position];
-        ++position;
-      }
-      if (position >= input.length) {
+    for (let length = input.length, char; ++position < length; ) {
+      char = input[position];
+      if (char == "\\") {
+        value += ++position < length ? input[position] : char;
+      } else if (char == '"') {
         break;
-      }
-      const quoteOrBackslash = input[position];
-      ++position;
-      if (quoteOrBackslash === "\\") {
-        if (position >= input.length) {
-          value += "\\";
-          break;
-        }
-        value += input[position];
-        ++position;
       } else {
-        break;
+        value += char;
       }
     }
     return [value, position];
@@ -59,18 +58,50 @@ var MediaType = (() => {
 
   // src/media-type-parameters.js
   var MediaTypeParameters = class {
-    constructor(map) {
-      this._map = map;
-    }
+    /** @type {Map<string, string>} */
+    #map;
+    /**
+     * Create a new MediaTypeParameters instance.
+     *
+     * @param {Array<Array<string>>} entries An array of [name, value] tuples.
+     */
+    constructor(entries) {
+      this.#map = new Map(entries);
+    }
+    /**
+     * Gets the number of media type parameters.
+     *
+     * @returns {number} The number of media type parameters
+     */
     get size() {
-      return this._map.size;
-    }
+      return this.#map.size;
+    }
+    /**
+     * Gets the media type parameter value for the supplied name.
+     *
+     * @param {string} name The name of the media type parameter to retrieve.
+     * @returns {string} The media type parameter value.
+     */
     get(name) {
-      return this._map.get(asciiLowercase(String(name)));
-    }
+      return this.#map.get(asciiLowercase(String(name)));
+    }
+    /**
+     * Indicates whether the media type parameter with the specified name exists or not.
+     *
+     * @param {string} name The name of the media type parameter to check.
+     * @returns {boolean} true if the media type parameter exists, false otherwise.
+     */
     has(name) {
-      return this._map.has(asciiLowercase(String(name)));
-    }
+      return this.#map.has(asciiLowercase(String(name)));
+    }
+    /**
+     * Adds a new media type parameter using the specified name and value to the MediaTypeParameters.
+     * If an parameter with the same name already exists, the parameter will be updated.
+     *
+     * @param {string} name The name of the media type parameter to set.
+     * @param {string} value The media type parameter value.
+     * @returns {MediaTypeParameters} This instance.
+     */
     set(name, value) {
       name = asciiLowercase(String(name));
       value = String(value);
@@ -80,30 +111,84 @@ var MediaType = (() => {
       if (!solelyContainsHTTPQuotedStringTokenCodePoints(value)) {
         throw new Error(`Invalid media type parameter value "${value}": only HTTP quoted-string token code points are valid.`);
       }
-      this._map.set(name, value);
+      this.#map.set(name, value);
       return this;
     }
+    /**
+     * Clears all the media type parameters.
+     */
     clear() {
-      this._map.clear();
-    }
+      this.#map.clear();
+    }
+    /**
+     * Removes the media type parameter using the specified name.
+     *
+     * @param {string} name The name of the media type parameter to delete.
+     * @returns {boolean} true if the parameter existed and has been removed, or false if the parameter does not exist.
+     */
     delete(name) {
       name = asciiLowercase(String(name));
-      return this._map.delete(name);
-    }
+      return this.#map.delete(name);
+    }
+    /**
+     * Executes a provided function once per each name/value pair in the MediaTypeParameters, in insertion order.
+     *
+     * @param {function(string, string): void} callback The function called on each iteration.
+     * @param {*} [thisArg] Optional object when binding 'this' to the callback.
+     */
     forEach(callback, thisArg) {
-      this._map.forEach(callback, thisArg);
+      this.#map.forEach(callback, thisArg);
     }
+    /**
+     * Returns an iterable of parameter names.
+     *
+     * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter names.
+     */
     keys() {
-      return this._map.keys();
+      return this.#map.keys();
     }
+    /**
+     * Returns an iterable of parameter values.
+     *
+     * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter values.
+     */
     values() {
-      return this._map.values();
+      return this.#map.values();
     }
+    /**
+     * Returns an iterable of name, value pairs for every parameter entry in the media type parameters.
+     *
+     * @returns {IterableIterator<Array<Array<string>>>} The media type parameter entries.
+     */
     entries() {
-      return this._map.entries();
+      return this.#map.entries();
     }
+    /**
+     * A method that returns the default iterator for the {@link MediaTypeParameters}. Called by the semantics of the for-of statement.
+     *
+     * @returns {Iterator<string, string, undefined>} The {@link Symbol.iterator} for the media type parameters.
+     */
     [Symbol.iterator]() {
-      return this._map[Symbol.iterator]();
+      return this.#map[Symbol.iterator]();
+    }
+    /**
+     * Returns a string representation of the media type parameters.
+     * This method is called by the `String()` function.
+     *
+     * @example
+     * const parameters = new MediaTypeParameters(new Map([['charset', 'utf-8']]));
+     * String(parameters); // 'charset=utf-8'
+     * parameters.toString(); // 'charset=utf-8'
+     * parameters + ''; // 'charset=utf-8'
+     * `${parameters}`; // 'charset=utf-8'
+     * parameters[Symbol.toStringTag]; // 'MediaTypeParameters'
+     * parameters[Symbol.toStringTag](); // 'MediaTypeParameters'
+     * Object.prototype.toString.call(parameters); // '[object MediaTypeParameters]'
+     * parameters + ''; // 'charset=utf-8'
+     * @returns {string} The string representation of the media type parameters.
+     */
+    [Symbol.toStringTag]() {
+      return "MediaTypeParameters";
     }
   };
 
@@ -112,7 +197,7 @@ var MediaType = (() => {
     input = removeLeadingAndTrailingHTTPWhitespace(input);
     let position = 0;
     let type = "";
-    while (position < input.length && input[position] !== "/") {
+    while (position < input.length && input[position] != "/") {
       type += input[position];
       ++position;
     }
@@ -124,7 +209,7 @@ var MediaType = (() => {
     }
     ++position;
     let subtype = "";
-    while (position < input.length && input[position] !== ";") {
+    while (position < input.length && input[position] != ";") {
       subtype += input[position];
       ++position;
     }
@@ -143,26 +228,26 @@ var MediaType = (() => {
         ++position;
       }
       let parameterName = "";
-      while (position < input.length && input[position] !== ";" && input[position] !== "=") {
+      while (position < input.length && input[position] != ";" && input[position] != "=") {
         parameterName += input[position];
         ++position;
       }
       parameterName = asciiLowercase(parameterName);
       if (position < input.length) {
-        if (input[position] === ";") {
+        if (input[position] == ";") {
           continue;
         }
         ++position;
       }
       let parameterValue = null;
-      if (input[position] === '"') {
+      if (input[position] == '"') {
         [parameterValue, position] = collectAnHTTPQuotedString(input, position);
-        while (position < input.length && input[position] !== ";") {
+        while (position < input.length && input[position] != ";") {
           ++position;
         }
       } else {
         parameterValue = "";
-        while (position < input.length && input[position] !== ";") {
+        while (position < input.length && input[position] != ";") {
           parameterValue += input[position];
           ++position;
         }
@@ -186,12 +271,9 @@ var MediaType = (() => {
       return serialization;
     }
     for (let [name, value] of mediaType.parameters) {
-      serialization += ";";
-      serialization += name;
-      serialization += "=";
+      serialization += `;${name}=`;
       if (!solelyContainsHTTPTokenCodePoints(value) || value.length === 0) {
-        value = value.replace(/(["\\])/ug, "\\$1");
-        value = `"${value}"`;
+        value = `"${value.replace(/(["\\])/ug, "\\$1")}"`;
       }
       serialization += value;
     }
@@ -201,29 +283,56 @@ var MediaType = (() => {
 
   // src/media-type.js
   var MediaType = class {
-    constructor(string) {
-      string = String(string);
-      const result = parser_default(string);
-      if (result === null) {
-        throw new Error(`Could not parse media type string '${string}'`);
-      }
-      this._type = result.type;
-      this._subtype = result.subtype;
-      this._parameters = new MediaTypeParameters(result.parameters);
-    }
+    /** @type {string} */
+    #type;
+    /** @type {string} */
+    #subtype;
+    /** @type {MediaTypeParameters} */
+    #parameters;
+    /**
+     * Create a new MediaType instance from a string representation.
+     *
+     * @param {string} mediaType The media type to parse.
+     * @param {Object} [parameters] Optional parameters.
+     */
+    constructor(mediaType, parameters = {}) {
+      const { type, subtype, parameters: parsedParameters } = parser_default(mediaType);
+      this.#type = type;
+      this.#subtype = subtype;
+      this.#parameters = new MediaTypeParameters([...parsedParameters, ...Object.entries(parameters).map(([name, value]) => [asciiLowercase(name), asciiLowercase(value)])]);
+    }
+    /**
+     * Static factory method for parsing a media type.
+     *
+     * @param {string} string The media type to parse.
+     * @returns {MediaType} The parsed {@link MediaType} object or null if the string could not be parsed.
+     */
     static parse(string) {
       try {
-        return new this(string);
+        return new MediaType(string);
       } catch (e) {
-        return null;
+        throw new Error(`Could not parse media type string '${string}'`);
       }
     }
+    /**
+     * Gets the media type essence (type/subtype).
+     *
+     * @returns {string} The media type without any parameters
+     */
     get essence() {
-      return `${this.type}/${this.subtype}`;
+      return `${this.#type}/${this.#subtype}`;
     }
+    /**
+     * Gets the type.
+     *
+     * @returns {string} The type.
+     */
     get type() {
-      return this._type;
+      return this.#type;
     }
+    /**
+     * Sets the type.
+     */
     set type(value) {
       value = asciiLowercase(String(value));
       if (value.length === 0) {
@@ -232,11 +341,19 @@ var MediaType = (() => {
       if (!solelyContainsHTTPTokenCodePoints(value)) {
         throw new Error(`Invalid type ${value}: must contain only HTTP token code points`);
       }
-      this._type = value;
+      this.#type = value;
     }
+    /**
+     * Gets the subtype.
+     *
+     * @returns {string} The subtype.
+     */
     get subtype() {
-      return this._subtype;
+      return this.#subtype;
     }
+    /**
+     * Sets the subtype.
+     */
     set subtype(value) {
       value = asciiLowercase(String(value));
       if (value.length === 0) {
@@ -245,18 +362,35 @@ var MediaType = (() => {
       if (!solelyContainsHTTPTokenCodePoints(value)) {
         throw new Error(`Invalid subtype ${value}: must contain only HTTP token code points`);
       }
-      this._subtype = value;
+      this.#subtype = value;
     }
+    /**
+     * Gets the parameters.
+     *
+     * @returns {MediaTypeParameters} The media type parameters.
+     */
     get parameters() {
-      return this._parameters;
+      return this.#parameters;
     }
+    /**
+     * Gets the serialized version of the media type.
+     *
+     * @returns {string} The serialized media type.
+     */
     toString() {
       return serializer_default(this);
     }
+    /**
+     * Determines if this instance is a JavaScript media type.
+     *
+     * @param {Object} [options] Optional options.
+     * @param {boolean} [options.prohibitParameters=false] The option to prohibit parameters when checking if the media type is JavaScript.
+     * @returns {boolean} true if this instance represents a JavaScript media type, false otherwise.
+     */
     isJavaScript({ prohibitParameters = false } = {}) {
-      switch (this._type) {
+      switch (this.#type) {
         case "text": {
-          switch (this._subtype) {
+          switch (this.#subtype) {
             case "ecmascript":
             case "javascript":
             case "javascript1.0":
@@ -269,18 +403,18 @@ var MediaType = (() => {
             case "livescript":
             case "x-ecmascript":
             case "x-javascript":
-              return !prohibitParameters || this._parameters.size === 0;
+              return !prohibitParameters || this.#parameters.size === 0;
             default:
               return false;
           }
         }
         case "application": {
-          switch (this._subtype) {
+          switch (this.#subtype) {
             case "ecmascript":
             case "javascript":
             case "x-ecmascript":
             case "x-javascript":
-              return !prohibitParameters || this._parameters.size === 0;
+              return !prohibitParameters || this.#parameters.size === 0;
             default:
               return false;
           }
@@ -289,12 +423,27 @@ var MediaType = (() => {
           return false;
       }
     }
+    /**
+     * Determines if this instance is an XML media type.
+     *
+     * @returns {boolean} true if this instance represents an XML media type, false otherwise.
+     */
     isXML() {
-      return this._subtype === "xml" && (this._type === "text" || this._type === "application") || this._subtype.endsWith("+xml");
+      return this.#subtype === "xml" && (this.#type === "text" || this.#type === "application") || this.#subtype.endsWith("+xml");
     }
+    /**
+     * Determines if this instance is an HTML media type.
+     *
+     * @returns {boolean} true if this instance represents an HTML media type, false otherwise.
+     */
     isHTML() {
-      return this._subtype === "html" && this._type === "text";
+      return this.#subtype === "html" && this.#type === "text";
     }
+    /**
+     * Gets the name of the class.
+     *
+     * @returns {string} The class name
+     */
     get [Symbol.toStringTag]() {
       return "MediaType";
     }

package/dist/media-type.min.js

@@ -1,4 +1,4 @@
-var MediaType=(()=>{var m=Object.defineProperty;var w=Object.getOwnPropertyDescriptor;var _=Object.getOwnPropertyNames;var P=Object.prototype.hasOwnProperty;var b=(t,e)=>{for(var r in e)m(t,r,{get:e[r],enumerable:!0})},H=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of _(e))!P.call(t,n)&&n!==r&&m(t,n,{get:()=>e[n],enumerable:!(s=w(e,n))||s.enumerable});return t};var C=t=>H(m({},"__esModule",{value:!0}),t);var $={};b($,{default:()=>p});var u=t=>t.replace(/^[ \t\n\r]+/u,"").replace(/[ \t\n\r]+$/u,""),y=t=>t.replace(/[ \t\n\r]+$/u,""),T=t=>t===" "||t==="	"||t===`
-`||t==="\r",i=t=>/^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u.test(t),h=t=>/^[\t\u0020-\u007E\u0080-\u00FF]*$/u.test(t),a=t=>t.replace(/[A-Z]/ug,e=>e.toLowerCase()),g=(t,e)=>{let r="";for(e++;;){for(;e<t.length&&t[e]!=='"'&&t[e]!=="\\";)r+=t[e],++e;if(e>=t.length)break;let s=t[e];if(++e,s==="\\"){if(e>=t.length){r+="\\";break}r+=t[e],++e}else break}return[r,e]};var c=class{constructor(e){this._map=e}get size(){return this._map.size}get(e){return this._map.get(a(String(e)))}has(e){return this._map.has(a(String(e)))}set(e,r){if(e=a(String(e)),r=String(r),!i(e))throw new Error(`Invalid media type parameter name "${e}": only HTTP token code points are valid.`);if(!h(r))throw new Error(`Invalid media type parameter value "${r}": only HTTP quoted-string token code points are valid.`);return this._map.set(e,r),this}clear(){this._map.clear()}delete(e){return e=a(String(e)),this._map.delete(e)}forEach(e,r){this._map.forEach(e,r)}keys(){return this._map.keys()}values(){return this._map.values()}entries(){return this._map.entries()}[Symbol.iterator](){return this._map[Symbol.iterator]()}};var S=t=>{t=u(t);let e=0,r="";for(;e<t.length&&t[e]!=="/";)r+=t[e],++e;if(r.length===0||!i(r)||e>=t.length)return null;++e;let s="";for(;e<t.length&&t[e]!==";";)s+=t[e],++e;if(s=y(s),s.length===0||!i(s))return null;let n={type:a(r),subtype:a(s),parameters:new Map};for(;e<t.length;){for(++e;T(t[e]);)++e;let l="";for(;e<t.length&&t[e]!==";"&&t[e]!=="=";)l+=t[e],++e;if(l=a(l),e<t.length){if(t[e]===";")continue;++e}let o=null;if(t[e]==='"')for([o,e]=g(t,e);e<t.length&&t[e]!==";";)++e;else{for(o="";e<t.length&&t[e]!==";";)o+=t[e],++e;if(o=y(o),o==="")continue}l.length>0&&i(l)&&h(o)&&!n.parameters.has(l)&&n.parameters.set(l,o)}return n},d=S;var k=t=>{let e=`${t.type}/${t.subtype}`;if(t.parameters.size===0)return e;for(let[r,s]of t.parameters)e+=";",e+=r,e+="=",(!i(s)||s.length===0)&&(s=s.replace(/(["\\])/ug,"\\$1"),s=`"${s}"`),e+=s;return e},f=k;var p=class{constructor(e){e=String(e);let r=d(e);if(r===null)throw new Error(`Could not parse media type string '${e}'`);this._type=r.type,this._subtype=r.subtype,this._parameters=new c(r.parameters)}static parse(e){try{return new this(e)}catch{return null}}get essence(){return`${this.type}/${this.subtype}`}get type(){return this._type}set type(e){if(e=a(String(e)),e.length===0)throw new Error("Invalid type: must be a non-empty string");if(!i(e))throw new Error(`Invalid type ${e}: must contain only HTTP token code points`);this._type=e}get subtype(){return this._subtype}set subtype(e){if(e=a(String(e)),e.length===0)throw new Error("Invalid subtype: must be a non-empty string");if(!i(e))throw new Error(`Invalid subtype ${e}: must contain only HTTP token code points`);this._subtype=e}get parameters(){return this._parameters}toString(){return f(this)}isJavaScript({prohibitParameters:e=!1}={}){switch(this._type){case"text":switch(this._subtype){case"ecmascript":case"javascript":case"javascript1.0":case"javascript1.1":case"javascript1.2":case"javascript1.3":case"javascript1.4":case"javascript1.5":case"jscript":case"livescript":case"x-ecmascript":case"x-javascript":return!e||this._parameters.size===0;default:return!1}case"application":switch(this._subtype){case"ecmascript":case"javascript":case"x-ecmascript":case"x-javascript":return!e||this._parameters.size===0;default:return!1}default:return!1}}isXML(){return this._subtype==="xml"&&(this._type==="text"||this._type==="application")||this._subtype.endsWith("+xml")}isHTML(){return this._subtype==="html"&&this._type==="text"}get[Symbol.toStringTag](){return"MediaType"}};return C($);})();
+var MediaType=(()=>{var T=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var H=Object.getOwnPropertyNames;var S=Object.prototype.hasOwnProperty;var k=(t,e)=>{for(var r in e)T(t,r,{get:e[r],enumerable:!0})},b=(t,e,r,s)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of H(e))!S.call(t,i)&&i!==r&&T(t,i,{get:()=>e[i],enumerable:!(s=C(e,i))||s.enumerable});return t};var $=t=>b(T({},"__esModule",{value:!0}),t);var L={};k(L,{default:()=>l});var v=[" ","	",`
+`,"\r"],x=/^[ \t\n\r]+/u,d=/[ \t\n\r]+$/u,j=/^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u,E=/^[\t\u0020-\u007E\u0080-\u00FF]*$/u,m=t=>t.replace(x,"").replace(d,""),g=t=>t.replace(d,""),u=t=>v.includes(t),n=t=>j.test(t),p=t=>E.test(t),a=t=>{let e="";for(let[r,s=r.charCodeAt(0)]of t)e+=s>=65&&s<=90?String.fromCharCode(s+32):r;return e},f=(t,e)=>{let r="";for(let s=t.length,i;++e<s;)if(i=t[e],i=="\\")r+=++e<s?t[e]:i;else{if(i=='"')break;r+=i}return[r,e]};var h=class{#e;constructor(e){this.#e=new Map(e)}get size(){return this.#e.size}get(e){return this.#e.get(a(String(e)))}has(e){return this.#e.has(a(String(e)))}set(e,r){if(e=a(String(e)),r=String(r),!n(e))throw new Error(`Invalid media type parameter name "${e}": only HTTP token code points are valid.`);if(!p(r))throw new Error(`Invalid media type parameter value "${r}": only HTTP quoted-string token code points are valid.`);return this.#e.set(e,r),this}clear(){this.#e.clear()}delete(e){return e=a(String(e)),this.#e.delete(e)}forEach(e,r){this.#e.forEach(e,r)}keys(){return this.#e.keys()}values(){return this.#e.values()}entries(){return this.#e.entries()}[Symbol.iterator](){return this.#e[Symbol.iterator]()}[Symbol.toStringTag](){return"MediaTypeParameters"}};var z=t=>{t=m(t);let e=0,r="";for(;e<t.length&&t[e]!="/";)r+=t[e],++e;if(r.length===0||!n(r)||e>=t.length)return null;++e;let s="";for(;e<t.length&&t[e]!=";";)s+=t[e],++e;if(s=g(s),s.length===0||!n(s))return null;let i={type:a(r),subtype:a(s),parameters:new Map};for(;e<t.length;){for(++e;u(t[e]);)++e;let c="";for(;e<t.length&&t[e]!=";"&&t[e]!="=";)c+=t[e],++e;if(c=a(c),e<t.length){if(t[e]==";")continue;++e}let o=null;if(t[e]=='"')for([o,e]=f(t,e);e<t.length&&t[e]!=";";)++e;else{for(o="";e<t.length&&t[e]!=";";)o+=t[e],++e;if(o=g(o),o==="")continue}c.length>0&&n(c)&&p(o)&&!i.parameters.has(c)&&i.parameters.set(c,o)}return i},y=z;var W=t=>{let e=`${t.type}/${t.subtype}`;if(t.parameters.size===0)return e;for(let[r,s]of t.parameters)e+=`;${r}=`,(!n(s)||s.length===0)&&(s=`"${s.replace(/(["\\])/ug,"\\$1")}"`),e+=s;return e},w=W;var l=class{#e;#t;#r;constructor(e,r={}){let{type:s,subtype:i,parameters:c}=y(e);this.#e=s,this.#t=i,this.#r=new h([...c,...Object.entries(r).map(([o,P])=>[a(o),a(P)])])}static parse(e){try{return new l(e)}catch{throw new Error(`Could not parse media type string '${e}'`)}}get essence(){return`${this.#e}/${this.#t}`}get type(){return this.#e}set type(e){if(e=a(String(e)),e.length===0)throw new Error("Invalid type: must be a non-empty string");if(!n(e))throw new Error(`Invalid type ${e}: must contain only HTTP token code points`);this.#e=e}get subtype(){return this.#t}set subtype(e){if(e=a(String(e)),e.length===0)throw new Error("Invalid subtype: must be a non-empty string");if(!n(e))throw new Error(`Invalid subtype ${e}: must contain only HTTP token code points`);this.#t=e}get parameters(){return this.#r}toString(){return w(this)}isJavaScript({prohibitParameters:e=!1}={}){switch(this.#e){case"text":switch(this.#t){case"ecmascript":case"javascript":case"javascript1.0":case"javascript1.1":case"javascript1.2":case"javascript1.3":case"javascript1.4":case"javascript1.5":case"jscript":case"livescript":case"x-ecmascript":case"x-javascript":return!e||this.#r.size===0;default:return!1}case"application":switch(this.#t){case"ecmascript":case"javascript":case"x-ecmascript":case"x-javascript":return!e||this.#r.size===0;default:return!1}default:return!1}}isXML(){return this.#t==="xml"&&(this.#e==="text"||this.#e==="application")||this.#t.endsWith("+xml")}isHTML(){return this.#t==="html"&&this.#e==="text"}get[Symbol.toStringTag](){return"MediaType"}};return $(L);})();
 window.MediaType = MediaType.default;
 //# sourceMappingURL=media-type.min.js.map

package/dist/media-type.min.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/media-type.js", "../src/utils.js", "../src/media-type-parameters.js", "../src/parser.js", "../src/serializer.js"],
-  "sourcesContent": ["import MediaTypeParameters from './media-type-parameters.js';\nimport parse from './parser.js';\nimport serialize from './serializer.js';\nimport { asciiLowercase, solelyContainsHTTPTokenCodePoints } from './utils.js';\n\n/**\n * Class used to parse media types.\n *\n * @see https://mimesniff.spec.whatwg.org/#understanding-mime-types\n * @module MediaType\n */\nexport default class MediaType {\n\t/**\n\t * Create a new MediaType instance from a string representation.\n\t *\n\t * @param {string} string The media type to parse\n\t */\n\tconstructor(string) {\n\t\tstring = String(string);\n\t\tconst result = parse(string);\n\t\tif (result === null) {\n\t\t\tthrow new Error(`Could not parse media type string '${string}'`);\n\t\t}\n\n\t\tthis._type = result.type;\n\t\tthis._subtype = result.subtype;\n\t\tthis._parameters = new MediaTypeParameters(result.parameters);\n\t}\n\n\t/**\n\t * Static factor method for parsing a media type.\n\t *\n\t * @param {string} string The media type to parse\n\t * @returns {MediaType} The parsed {@link MediaType} object\n\t */\n\tstatic parse(string) {\n\t\ttry {\n\t\t\treturn new this(string);\n\t\t} catch (e) {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/**\n\t * Gets the media type essence (type/subtype).\n\t *\n\t * @returns {string} The media type without any parameters\n\t */\n\tget essence() {\n\t\treturn `${this.type}/${this.subtype}`;\n\t}\n\n\t/**\n\t * Gets the type.\n\t *\n\t * @returns {string} The type.\n\t */\n\tget type() {\n\t\treturn this._type;\n\t}\n\n\t/**\n\t * Sets the type.\n\t */\n\tset type(value) {\n\t\tvalue = asciiLowercase(String(value));\n\n\t\tif (value.length === 0) {\n\t\t\tthrow new Error('Invalid type: must be a non-empty string');\n\t\t}\n\t\tif (!solelyContainsHTTPTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid type ${value}: must contain only HTTP token code points`);\n\t\t}\n\n\t\tthis._type = value;\n\t}\n\n\t/**\n\t * Gets the subtype.\n\t *\n\t * @returns {string} The subtype.\n\t */\n\tget subtype() {\n\t\treturn this._subtype;\n\t}\n\n\t/**\n\t * Sets the subtype.\n\t */\n\tset subtype(value) {\n\t\tvalue = asciiLowercase(String(value));\n\n\t\tif (value.length === 0) {\n\t\t\tthrow new Error('Invalid subtype: must be a non-empty string');\n\t\t}\n\t\tif (!solelyContainsHTTPTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid subtype ${value}: must contain only HTTP token code points`);\n\t\t}\n\n\t\tthis._subtype = value;\n\t}\n\n\t/**\n\t * Gets the parameters.\n\t *\n\t * @returns {MediaTypeParameters} The media type parameters.\n\t */\n\tget parameters() {\n\t\treturn this._parameters;\n\t}\n\n\t/**\n\t * Gets the serialized version of the media type.\n\t *\n\t * @returns {string} The serialized media type.\n\t */\n\ttoString() {\n\t\t// The serialize function works on both 'media type records' (i.e. the results of parse) and on this class, since\n\t\t// this class's interface is identical.\n\t\treturn serialize(this);\n\t}\n\n\t/**\n\t * Determines if this instance is a JavaScript media type.\n\t *\n\t * @param {Object} [options] Optional options.\n\t * @param {boolean} [options.prohibitParameters=false] The option to prohibit parameters when checking if the media type is JavaScript.\n\t * @returns {boolean} true if this instance represents a JavaScript media type, false otherwise.\n\t */\n\tisJavaScript({prohibitParameters = false} = {}) {\n\t\tswitch (this._type) {\n\t\t\tcase 'text': {\n\t\t\t\tswitch (this._subtype) {\n\t\t\t\t\tcase 'ecmascript':\n\t\t\t\t\tcase 'javascript':\n\t\t\t\t\tcase 'javascript1.0':\n\t\t\t\t\tcase 'javascript1.1':\n\t\t\t\t\tcase 'javascript1.2':\n\t\t\t\t\tcase 'javascript1.3':\n\t\t\t\t\tcase 'javascript1.4':\n\t\t\t\t\tcase 'javascript1.5':\n\t\t\t\t\tcase 'jscript':\n\t\t\t\t\tcase 'livescript':\n\t\t\t\t\tcase 'x-ecmascript':\n\t\t\t\t\tcase 'x-javascript': return !prohibitParameters || this._parameters.size === 0;\n\t\t\t\t\tdefault: return false;\n\t\t\t\t}\n\t\t\t}\n\t\t\tcase 'application': {\n\t\t\t\tswitch (this._subtype) {\n\t\t\t\t\tcase 'ecmascript':\n\t\t\t\t\tcase 'javascript':\n\t\t\t\t\tcase 'x-ecmascript':\n\t\t\t\t\tcase 'x-javascript': return !prohibitParameters || this._parameters.size === 0;\n\t\t\t\t\tdefault: return false;\n\t\t\t\t}\n\t\t\t}\n\t\t\tdefault: return false;\n\t\t}\n\t}\n\n\t/**\n\t * Determines if this instance is an XML media type.\n\t *\n\t * @returns {boolean} true if this instance represents an XML media type, false otherwise.\n\t */\n\tisXML() {\n\t\treturn (this._subtype === 'xml' && (this._type === 'text' || this._type === 'application')) || this._subtype.endsWith('+xml');\n\t}\n\n\t/**\n\t * Determines if this instance is an HTML media type.\n\t *\n\t * @returns {boolean} true if this instance represents an HTML media type, false otherwise.\n\t */\n\tisHTML() {\n\t\treturn this._subtype === 'html' && this._type === 'text';\n\t}\n\n\t/**\n\t * Gets the name of the class.\n\t *\n\t * @returns {string} The class name\n\t */\n\tget [Symbol.toStringTag]() {\n\t\treturn 'MediaType';\n\t}\n}", "/** @module utils */\n\n/**\n * A function to remove any leading and trailing HTTP whitespace.\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string.\n */\nconst removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(/^[ \\t\\n\\r]+/u, '').replace(/[ \\t\\n\\r]+$/u, '');\n\n/**\n * A function to remove any trailing HTTP whitespace.\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string.\n */\nconst removeTrailingHTTPWhitespace = (string) => string.replace(/[ \\t\\n\\r]+$/u, '');\n\n/**\n * Determines if the provided character is whitespace.\n *\n * @param {string} char The character to evaluate.\n * @returns {boolean} true if the character is whitespace, false otherwise.\n */\nconst isHTTPWhitespaceChar = (char) => char === ' ' || char === '\\t' || char === '\\n' || char === '\\r';\n\n/**\n * Determines if the provided string contains only HTTP token code points.\n *\n * @param {string} string The string to evaluate.\n * @returns {boolean} true if the string contains only HTTP token code points.\n */\nconst solelyContainsHTTPTokenCodePoints = (string) => /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u.test(string);\n\n/**\n * Determines if the provided string contains only quoted HTTP token code points.\n *\n * @param {string} string The string to evaluate.\n * @returns {boolean} true if the string contains only quoted HTTP token code points.\n */\nconst solelyContainsHTTPQuotedStringTokenCodePoints = (string) => /^[\\t\\u0020-\\u007E\\u0080-\\u00FF]*$/u.test(string);\n\n/**\n * A function to lower case ASCII characters.\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string with all ASCII characters lower cased.\n */\nconst asciiLowercase = (string) => string.replace(/[A-Z]/ug, l => l.toLowerCase());\n\n/**\n * Collects all the HTTP quoted strings.\n * This variant only implements it with the extract-value flag set.\n *\n * @param {string} input The string to process.\n * @param {number} position The starting position.\n * @returns {Array<string | number>} An array that includes the resulting string and updated position.\n */\nconst collectAnHTTPQuotedString = (input, position) => {\n\tlet value = '';\n\n\tposition++;\n\n\twhile (true) {\n\t\twhile (position < input.length && input[position] !== '\"' && input[position] !== '\\\\') {\n\t\t\tvalue += input[position];\n\t\t\t++position;\n\t\t}\n\n\t\tif (position >= input.length) {\n\t\t\tbreak;\n\t\t}\n\n\t\tconst quoteOrBackslash = input[position];\n\t\t++position;\n\n\t\tif (quoteOrBackslash === '\\\\') {\n\t\t\tif (position >= input.length) {\n\t\t\t\tvalue += '\\\\';\n\t\t\t\tbreak;\n\t\t\t}\n\n\t\t\tvalue += input[position];\n\t\t\t++position;\n\t\t} else {\n\t\t\tbreak;\n\t\t}\n\t}\n\n\treturn [value, position];\n};\n\nexport { removeLeadingAndTrailingHTTPWhitespace, removeTrailingHTTPWhitespace, isHTTPWhitespaceChar, solelyContainsHTTPTokenCodePoints, solelyContainsHTTPQuotedStringTokenCodePoints, asciiLowercase, collectAnHTTPQuotedString };\n", "import { asciiLowercase, solelyContainsHTTPQuotedStringTokenCodePoints, solelyContainsHTTPTokenCodePoints } from './utils.js';\n\n/**\n * Class representing the parameters for a media type record.\n * This class has the equivalent surface API to a JavaScript {@link Map}.\n *\n * However, {@link MediaTypeParameters} methods will always interpret their arguments\n * as appropriate for media types, so parameter names will be lowercased,\n * and attempting to set invalid characters will throw an {@link Error}.\n *\n * @example charset=utf-8\n * @module MediaTypeParameters\n */\nexport default class MediaTypeParameters {\n\t/**\n\t * Create a new MediaTypeParameters instance.\n\t *\n\t * @param {Map.<string, string>} map The map of parameters for a media type.\n\t */\n\tconstructor(map) {\n\t\tthis._map = map;\n\t}\n\n\t/**\n\t * Gets the number of media type parameters.\n\t *\n\t * @returns {number} The number of media type parameters\n\t */\n\tget size() {\n\t\treturn this._map.size;\n\t}\n\n\t/**\n\t * Gets the media type parameter value for the supplied name.\n\t *\n\t * @param {string} name The name of the media type parameter to retrieve.\n\t * @returns {string} The media type parameter value.\n\t */\n\tget(name) {\n\t\treturn this._map.get(asciiLowercase(String(name)));\n\t}\n\n\t/**\n\t * Indicates whether the media type parameter with the specified name exists or not.\n\t *\n\t * @param {string} name The name of the media type parameter to check.\n\t * @returns {boolean} true if the media type parameter exists, false otherwise.\n\t */\n\thas(name) {\n\t\treturn this._map.has(asciiLowercase(String(name)));\n\t}\n\n\t/**\n\t * Adds a new media type parameter using the specified name and value to the MediaTypeParameters.\n\t * If an parameter with the same name already exists, the parameter will be updated.\n\t *\n\t * @param {string} name The name of the media type parameter to set.\n\t * @param {string} value The media type parameter value.\n\t * @returns {MediaTypeParameters} This instance.\n\t */\n\tset(name, value) {\n\t\tname = asciiLowercase(String(name));\n\t\tvalue = String(value);\n\n\t\tif (!solelyContainsHTTPTokenCodePoints(name)) {\n\t\t\tthrow new Error(`Invalid media type parameter name \"${name}\": only HTTP token code points are valid.`);\n\t\t}\n\n\t\tif (!solelyContainsHTTPQuotedStringTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid media type parameter value \"${value}\": only HTTP quoted-string token code points are valid.`);\n\t\t}\n\n\t\tthis._map.set(name, value);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Clears all the media type parameters.\n\t */\n\tclear() {\n\t\tthis._map.clear();\n\t}\n\n\t/**\n\t * Removes the media type parameter using the specified name.\n\t *\n\t * @param {string} name The name of the media type parameter to delete.\n\t * @returns {boolean} true if the parameter existed and has been removed, or false if the parameter does not exist.\n\t */\n\tdelete(name) {\n\t\tname = asciiLowercase(String(name));\n\t\treturn this._map.delete(name);\n\t}\n\n\t/**\n\t * Executes a provided function once per each name/value pair in the MediaTypeParameters, in insertion order.\n\t *\n\t * @param {function(string, string): void} callback The function called on each iteration.\n\t * @param {*} [thisArg] Optional object when binding 'this' to the callback.\n\t */\n\tforEach(callback, thisArg) {\n\t\tthis._map.forEach(callback, thisArg);\n\t}\n\n\t/**\n\t * Returns an iterable of parameter names.\n\t *\n\t * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter names.\n\t */\n\tkeys() {\n\t\treturn this._map.keys();\n\t}\n\n\t/**\n\t * Returns an iterable of parameter values.\n\t *\n\t * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter values.\n\t */\n\tvalues() {\n\t\treturn this._map.values();\n\t}\n\n\t/**\n\t * Returns an iterable of name, value pairs for every parameter entry in the media type parameters.\n\t *\n\t * @returns {IterableIterator<Array<Array<string>>>} The media type parameter entries.\n\t */\n\tentries() {\n\t\treturn this._map.entries();\n\t}\n\n\t/**\n\t * A method that returns the default iterator for the {@link MediaTypeParameters}. Called by the semantics of the for-of statement.\n\t *\n\t * @returns {Iterator<string, string, undefined>} The {@link Symbol.iterator} for the media type parameters.\n\t */\n\t[Symbol.iterator]() {\n\t\treturn this._map[Symbol.iterator]();\n\t}\n}", "import {\n\tasciiLowercase,\n\tcollectAnHTTPQuotedString, isHTTPWhitespaceChar, removeLeadingAndTrailingHTTPWhitespace,\n\tremoveTrailingHTTPWhitespace, solelyContainsHTTPQuotedStringTokenCodePoints, solelyContainsHTTPTokenCodePoints\n} from './utils.js';\n\n/**\n * Function to parse a media type.\n *\n * @module parser\n * @param {string} input The media type to parse\n * @returns {{ type: string, subtype: string, parameters: Map<string, string> }} An object populated with the parsed media type properties and any parameters.\n */\nconst parse = (input) => {\n\tinput = removeLeadingAndTrailingHTTPWhitespace(input);\n\n\tlet position = 0;\n\tlet type = '';\n\twhile (position < input.length && input[position] !== '/') {\n\t\ttype += input[position];\n\t\t++position;\n\t}\n\n\tif (type.length === 0 || !solelyContainsHTTPTokenCodePoints(type)) {\n\t\treturn null;\n\t}\n\n\tif (position >= input.length) {\n\t\treturn null;\n\t}\n\n\t// Skips past \"/\"\n\t++position;\n\n\tlet subtype = '';\n\twhile (position < input.length && input[position] !== ';') {\n\t\tsubtype += input[position];\n\t\t++position;\n\t}\n\n\tsubtype = removeTrailingHTTPWhitespace(subtype);\n\n\tif (subtype.length === 0 || !solelyContainsHTTPTokenCodePoints(subtype)) {\n\t\treturn null;\n\t}\n\n\tconst mediaType = {\n\t\ttype: asciiLowercase(type),\n\t\tsubtype: asciiLowercase(subtype),\n\t\tparameters: new Map()\n\t};\n\n\twhile (position < input.length) {\n\t\t// Skip past \";\"\n\t\t++position;\n\n\t\twhile (isHTTPWhitespaceChar(input[position])) {\n\t\t\t++position;\n\t\t}\n\n\t\tlet parameterName = '';\n\t\twhile (position < input.length && input[position] !== ';' && input[position] !== '=') {\n\t\t\tparameterName += input[position];\n\t\t\t++position;\n\t\t}\n\t\tparameterName = asciiLowercase(parameterName);\n\n\t\tif (position < input.length) {\n\t\t\tif (input[position] === ';') {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Skip past \"=\"\n\t\t\t++position;\n\t\t}\n\n\t\tlet parameterValue = null;\n\t\tif (input[position] === '\"') {\n\t\t\t[parameterValue, position] = collectAnHTTPQuotedString(input, position);\n\n\t\t\twhile (position < input.length && input[position] !== ';') {\n\t\t\t\t++position;\n\t\t\t}\n\t\t} else {\n\t\t\tparameterValue = '';\n\t\t\twhile (position < input.length && input[position] !== ';') {\n\t\t\t\tparameterValue += input[position];\n\t\t\t\t++position;\n\t\t\t}\n\n\t\t\tparameterValue = removeTrailingHTTPWhitespace(parameterValue);\n\n\t\t\tif (parameterValue === '') {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\tif (parameterName.length > 0 &&\n\t\t\tsolelyContainsHTTPTokenCodePoints(parameterName) &&\n\t\t\tsolelyContainsHTTPQuotedStringTokenCodePoints(parameterValue) &&\n\t\t\t!mediaType.parameters.has(parameterName)) {\n\t\t\tmediaType.parameters.set(parameterName, parameterValue);\n\t\t}\n\t}\n\n\treturn mediaType;\n};\n\nexport default parse;", "import { solelyContainsHTTPTokenCodePoints } from './utils.js';\n// eslint-disable-next-line jsdoc/valid-types\n/** @typedef { import('./media-type.js').default } MediaType */\n\n/**\n * A function that serializes the provided {@link mediaType} to a string.\n *\n * @module serializer\n * @param {MediaType} mediaType The media type to serialize.\n * @returns {string} The serialized media type.\n */\nconst serialize = (mediaType) => {\n\tlet serialization = `${mediaType.type}/${mediaType.subtype}`;\n\n\tif (mediaType.parameters.size === 0) {\n\t\treturn serialization;\n\t}\n\n\tfor (let [name, value] of mediaType.parameters) {\n\t\tserialization += ';';\n\t\tserialization += name;\n\t\tserialization += '=';\n\n\t\tif (!solelyContainsHTTPTokenCodePoints(value) || value.length === 0) {\n\t\t\tvalue = value.replace(/([\"\\\\])/ug, '\\\\$1');\n\t\t\tvalue = `\"${value}\"`;\n\t\t}\n\n\t\tserialization += value;\n\t}\n\n\treturn serialization;\n};\n\nexport default serialize;"],
-  "mappings": "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",
-  "names": ["media_type_exports", "__export", "MediaType", "removeLeadingAndTrailingHTTPWhitespace", "string", "removeTrailingHTTPWhitespace", "isHTTPWhitespaceChar", "char", "solelyContainsHTTPTokenCodePoints", "solelyContainsHTTPQuotedStringTokenCodePoints", "asciiLowercase", "l", "collectAnHTTPQuotedString", "input", "position", "value", "quoteOrBackslash", "MediaTypeParameters", "map", "name", "asciiLowercase", "value", "solelyContainsHTTPTokenCodePoints", "solelyContainsHTTPQuotedStringTokenCodePoints", "callback", "thisArg", "parse", "input", "removeLeadingAndTrailingHTTPWhitespace", "position", "type", "solelyContainsHTTPTokenCodePoints", "subtype", "removeTrailingHTTPWhitespace", "mediaType", "asciiLowercase", "isHTTPWhitespaceChar", "parameterName", "parameterValue", "collectAnHTTPQuotedString", "solelyContainsHTTPQuotedStringTokenCodePoints", "parser_default", "serialize", "mediaType", "serialization", "name", "value", "solelyContainsHTTPTokenCodePoints", "serializer_default", "MediaType", "string", "result", "parser_default", "MediaTypeParameters", "value", "asciiLowercase", "solelyContainsHTTPTokenCodePoints", "serializer_default", "prohibitParameters"]
+  "sourcesContent": ["import MediaTypeParameters from './media-type-parameters.js';\nimport parse from './parser.js';\nimport serialize from './serializer.js';\nimport { asciiLowercase, solelyContainsHTTPTokenCodePoints } from './utils.js';\n\n/**\n * Class used to parse media types.\n *\n * @module {MediaType} media-type\n * @see https://mimesniff.spec.whatwg.org/#understanding-mime-types\n */\nexport default class MediaType {\n\t/** @type {string} */\n\t#type;\n\t/** @type {string} */\n\t#subtype;\n\t/** @type {MediaTypeParameters} */\n\t#parameters;\n\n\t/**\n\t * Create a new MediaType instance from a string representation.\n\t *\n\t * @param {string} mediaType The media type to parse.\n\t * @param {Object} [parameters] Optional parameters.\n\t */\n\tconstructor(mediaType, parameters = {}) {\n\t\tconst { type, subtype, parameters: parsedParameters } = parse(mediaType);\n\t\tthis.#type = type;\n\t\tthis.#subtype = subtype;\n\t\tthis.#parameters = new MediaTypeParameters([...parsedParameters, ...Object.entries(parameters).map(([name, value]) => [asciiLowercase(name), asciiLowercase(value)])]);\n\t}\n\n\t/**\n\t * Static factory method for parsing a media type.\n\t *\n\t * @param {string} string The media type to parse.\n\t * @returns {MediaType} The parsed {@link MediaType} object or null if the string could not be parsed.\n\t */\n\tstatic parse(string) {\n\t\ttry {\n\t\t\treturn new MediaType(string);\n\t\t} catch (e) {\n\t\t\tthrow new Error(`Could not parse media type string '${string}'`);\n\t\t}\n\t}\n\n\t/**\n\t * Gets the media type essence (type/subtype).\n\t *\n\t * @returns {string} The media type without any parameters\n\t */\n\tget essence() {\n\t\treturn `${this.#type}/${this.#subtype}`;\n\t}\n\n\t/**\n\t * Gets the type.\n\t *\n\t * @returns {string} The type.\n\t */\n\tget type() {\n\t\treturn this.#type;\n\t}\n\n\t/**\n\t * Sets the type.\n\t */\n\tset type(value) {\n\t\tvalue = asciiLowercase(String(value));\n\n\t\tif (value.length === 0) {\n\t\t\tthrow new Error('Invalid type: must be a non-empty string');\n\t\t}\n\t\tif (!solelyContainsHTTPTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid type ${value}: must contain only HTTP token code points`);\n\t\t}\n\n\t\tthis.#type = value;\n\t}\n\n\t/**\n\t * Gets the subtype.\n\t *\n\t * @returns {string} The subtype.\n\t */\n\tget subtype() {\n\t\treturn this.#subtype;\n\t}\n\n\t/**\n\t * Sets the subtype.\n\t */\n\tset subtype(value) {\n\t\tvalue = asciiLowercase(String(value));\n\n\t\tif (value.length === 0) {\n\t\t\tthrow new Error('Invalid subtype: must be a non-empty string');\n\t\t}\n\t\tif (!solelyContainsHTTPTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid subtype ${value}: must contain only HTTP token code points`);\n\t\t}\n\n\t\tthis.#subtype = value;\n\t}\n\n\t/**\n\t * Gets the parameters.\n\t *\n\t * @returns {MediaTypeParameters} The media type parameters.\n\t */\n\tget parameters() {\n\t\treturn this.#parameters;\n\t}\n\n\t/**\n\t * Gets the serialized version of the media type.\n\t *\n\t * @returns {string} The serialized media type.\n\t */\n\ttoString() {\n\t\t// The serialize function works on both 'media type records' (i.e. the results of parse) and on this class, since\n\t\t// this class's interface is identical.\n\t\treturn serialize(this);\n\t}\n\n\t/**\n\t * Determines if this instance is a JavaScript media type.\n\t *\n\t * @param {Object} [options] Optional options.\n\t * @param {boolean} [options.prohibitParameters=false] The option to prohibit parameters when checking if the media type is JavaScript.\n\t * @returns {boolean} true if this instance represents a JavaScript media type, false otherwise.\n\t */\n\tisJavaScript({prohibitParameters = false} = {}) {\n\t\tswitch (this.#type) {\n\t\t\tcase 'text': {\n\t\t\t\tswitch (this.#subtype) {\n\t\t\t\t\tcase 'ecmascript':\n\t\t\t\t\tcase 'javascript':\n\t\t\t\t\tcase 'javascript1.0':\n\t\t\t\t\tcase 'javascript1.1':\n\t\t\t\t\tcase 'javascript1.2':\n\t\t\t\t\tcase 'javascript1.3':\n\t\t\t\t\tcase 'javascript1.4':\n\t\t\t\t\tcase 'javascript1.5':\n\t\t\t\t\tcase 'jscript':\n\t\t\t\t\tcase 'livescript':\n\t\t\t\t\tcase 'x-ecmascript':\n\t\t\t\t\tcase 'x-javascript': return !prohibitParameters || this.#parameters.size === 0;\n\t\t\t\t\tdefault: return false;\n\t\t\t\t}\n\t\t\t}\n\t\t\tcase 'application': {\n\t\t\t\tswitch (this.#subtype) {\n\t\t\t\t\tcase 'ecmascript':\n\t\t\t\t\tcase 'javascript':\n\t\t\t\t\tcase 'x-ecmascript':\n\t\t\t\t\tcase 'x-javascript': return !prohibitParameters || this.#parameters.size === 0;\n\t\t\t\t\tdefault: return false;\n\t\t\t\t}\n\t\t\t}\n\t\t\tdefault: return false;\n\t\t}\n\t}\n\n\t/**\n\t * Determines if this instance is an XML media type.\n\t *\n\t * @returns {boolean} true if this instance represents an XML media type, false otherwise.\n\t */\n\tisXML() {\n\t\treturn (this.#subtype === 'xml' && (this.#type === 'text' || this.#type === 'application')) || this.#subtype.endsWith('+xml');\n\t}\n\n\t/**\n\t * Determines if this instance is an HTML media type.\n\t *\n\t * @returns {boolean} true if this instance represents an HTML media type, false otherwise.\n\t */\n\tisHTML() {\n\t\treturn this.#subtype === 'html' && this.#type === 'text';\n\t}\n\n\t/**\n\t * Gets the name of the class.\n\t *\n\t * @returns {string} The class name\n\t */\n\tget [Symbol.toStringTag]() {\n\t\treturn 'MediaType';\n\t}\n}", "/** @module utils */\n\nconst whitespaceCharacters = [' ', '\\t', '\\n', '\\r'];\nconst leadingWhitespace = /^[ \\t\\n\\r]+/u;\nconst trailingWhitespace = /[ \\t\\n\\r]+$/u;\nconst httpTokenCodePoints = /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u;\nconst httpQuotedTokenCodePoints = /^[\\t\\u0020-\\u007E\\u0080-\\u00FF]*$/u;\n\n/**\n * A function to remove any leading and trailing HTTP whitespace.\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string.\n */\nconst removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(leadingWhitespace, '').replace(trailingWhitespace, '');\n\n/**\n * A function to remove any trailing HTTP whitespace.\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string.\n */\nconst removeTrailingHTTPWhitespace = (string) => string.replace(trailingWhitespace, '');\n\n/**\n * Determines if the provided character is whitespace.\n *\n * @param {string} char The character to evaluate.\n * @returns {boolean} true if the character is whitespace, false otherwise.\n */\nconst isHTTPWhitespaceChar = (char) => whitespaceCharacters.includes(char);\n\n/**\n * Determines if the provided string contains only HTTP token code points.\n *\n * @param {string} string The string to evaluate.\n * @returns {boolean} true if the string contains only HTTP token code points.\n */\nconst solelyContainsHTTPTokenCodePoints = (string) => httpTokenCodePoints.test(string);\n\n/**\n * Determines if the provided string contains only quoted HTTP token code points.\n *\n * @param {string} string The string to evaluate.\n * @returns {boolean} true if the string contains only quoted HTTP token code points.\n */\nconst solelyContainsHTTPQuotedStringTokenCodePoints = (string) => httpQuotedTokenCodePoints.test(string);\n\n/**\n * A function to lower case ASCII characters.\n * This implementation iterates over each element of the string, which is treated as an iterable.\n * The elements are destructured into [char, charCode] pairs, where char represents the character,\n * and charCode is assigned the character code using char.charCodeAt(0). If the charCode is not\n * provided, it falls back to the character code obtained from char.charCodeAt(0).\n *\n * @param {string} string The string to process.\n * @returns {string} The processed string with all ASCII characters lower cased.\n */\nconst asciiLowercase = (string) => {\n\tlet result = '';\n\tfor (const [char, charCode = char.charCodeAt(0)] of string) {\n\t\tresult += charCode >= 65 && charCode <= 90 ? String.fromCharCode(charCode + 32) : char;\n\t}\n\n\treturn result;\n};\n\n/**\n * Collects all the HTTP quoted strings.\n * This variant only implements it with the extract-value flag set.\n *\n * @param {string} input The string to process.\n * @param {number} position The starting position.\n * @returns {Array<string|number>} An array that includes the resulting string and updated position.\n */\nconst collectAnHTTPQuotedString = (input, position) => {\n\tlet value = '';\n\n\tfor (let length = input.length, char; ++position < length;) {\n\t\tchar = input[position];\n\n\t\tif (char == '\\\\') {\n\t\t\tvalue += ++position < length ? input[position] : char;\n\t\t} else if (char == '\"') {\n\t\t\tbreak;\n\t\t} else {\n\t\t\tvalue += char;\n\t\t}\n\t}\n\n\treturn [value, position];\n};\n\nexport { removeLeadingAndTrailingHTTPWhitespace, removeTrailingHTTPWhitespace, isHTTPWhitespaceChar, solelyContainsHTTPTokenCodePoints, solelyContainsHTTPQuotedStringTokenCodePoints, asciiLowercase, collectAnHTTPQuotedString };\n", "import { asciiLowercase, solelyContainsHTTPQuotedStringTokenCodePoints, solelyContainsHTTPTokenCodePoints } from './utils.js';\n\n/**\n * Class representing the parameters for a media type record.\n * This class has the equivalent surface API to a JavaScript {@link Map}.\n *\n * However, {@link MediaTypeParameters} methods will always interpret their arguments\n * as appropriate for media types, so parameter names will be lowercased,\n * and attempting to set invalid characters will throw an {@link Error}.\n *\n * @example charset=utf-8\n * @see https://mimesniff.spec.whatwg.org/#mime-type-essence\n * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record\n * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record-creation\n * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record-creation-algorithm\n * @module {MediaTypeParameters} media-type-parameters\n * @author D1g1talEntr0py <jason.dimeo@gmail.com>\n */\nexport default class MediaTypeParameters {\n\t/** @type {Map<string, string>} */\n\t#map;\n\n\t/**\n\t * Create a new MediaTypeParameters instance.\n\t *\n\t * @param {Array<Array<string>>} entries An array of [name, value] tuples.\n\t */\n\tconstructor(entries) {\n\t\tthis.#map = new Map(entries);\n\t}\n\n\t/**\n\t * Gets the number of media type parameters.\n\t *\n\t * @returns {number} The number of media type parameters\n\t */\n\tget size() {\n\t\treturn this.#map.size;\n\t}\n\n\t/**\n\t * Gets the media type parameter value for the supplied name.\n\t *\n\t * @param {string} name The name of the media type parameter to retrieve.\n\t * @returns {string} The media type parameter value.\n\t */\n\tget(name) {\n\t\treturn this.#map.get(asciiLowercase(String(name)));\n\t}\n\n\t/**\n\t * Indicates whether the media type parameter with the specified name exists or not.\n\t *\n\t * @param {string} name The name of the media type parameter to check.\n\t * @returns {boolean} true if the media type parameter exists, false otherwise.\n\t */\n\thas(name) {\n\t\treturn this.#map.has(asciiLowercase(String(name)));\n\t}\n\n\t/**\n\t * Adds a new media type parameter using the specified name and value to the MediaTypeParameters.\n\t * If an parameter with the same name already exists, the parameter will be updated.\n\t *\n\t * @param {string} name The name of the media type parameter to set.\n\t * @param {string} value The media type parameter value.\n\t * @returns {MediaTypeParameters} This instance.\n\t */\n\tset(name, value) {\n\t\tname = asciiLowercase(String(name));\n\t\tvalue = String(value);\n\n\t\tif (!solelyContainsHTTPTokenCodePoints(name)) {\n\t\t\tthrow new Error(`Invalid media type parameter name \"${name}\": only HTTP token code points are valid.`);\n\t\t}\n\n\t\tif (!solelyContainsHTTPQuotedStringTokenCodePoints(value)) {\n\t\t\tthrow new Error(`Invalid media type parameter value \"${value}\": only HTTP quoted-string token code points are valid.`);\n\t\t}\n\n\t\tthis.#map.set(name, value);\n\n\t\treturn this;\n\t}\n\n\t/**\n\t * Clears all the media type parameters.\n\t */\n\tclear() {\n\t\tthis.#map.clear();\n\t}\n\n\t/**\n\t * Removes the media type parameter using the specified name.\n\t *\n\t * @param {string} name The name of the media type parameter to delete.\n\t * @returns {boolean} true if the parameter existed and has been removed, or false if the parameter does not exist.\n\t */\n\tdelete(name) {\n\t\tname = asciiLowercase(String(name));\n\t\treturn this.#map.delete(name);\n\t}\n\n\t/**\n\t * Executes a provided function once per each name/value pair in the MediaTypeParameters, in insertion order.\n\t *\n\t * @param {function(string, string): void} callback The function called on each iteration.\n\t * @param {*} [thisArg] Optional object when binding 'this' to the callback.\n\t */\n\tforEach(callback, thisArg) {\n\t\tthis.#map.forEach(callback, thisArg);\n\t}\n\n\t/**\n\t * Returns an iterable of parameter names.\n\t *\n\t * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter names.\n\t */\n\tkeys() {\n\t\treturn this.#map.keys();\n\t}\n\n\t/**\n\t * Returns an iterable of parameter values.\n\t *\n\t * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter values.\n\t */\n\tvalues() {\n\t\treturn this.#map.values();\n\t}\n\n\t/**\n\t * Returns an iterable of name, value pairs for every parameter entry in the media type parameters.\n\t *\n\t * @returns {IterableIterator<Array<Array<string>>>} The media type parameter entries.\n\t */\n\tentries() {\n\t\treturn this.#map.entries();\n\t}\n\n\t/**\n\t * A method that returns the default iterator for the {@link MediaTypeParameters}. Called by the semantics of the for-of statement.\n\t *\n\t * @returns {Iterator<string, string, undefined>} The {@link Symbol.iterator} for the media type parameters.\n\t */\n\t[Symbol.iterator]() {\n\t\treturn this.#map[Symbol.iterator]();\n\t}\n\n\t/**\n\t * Returns a string representation of the media type parameters.\n\t * This method is called by the `String()` function.\n\t *\n\t * @example\n\t * const parameters = new MediaTypeParameters(new Map([['charset', 'utf-8']]));\n\t * String(parameters); // 'charset=utf-8'\n\t * parameters.toString(); // 'charset=utf-8'\n\t * parameters + ''; // 'charset=utf-8'\n\t * `${parameters}`; // 'charset=utf-8'\n\t * parameters[Symbol.toStringTag]; // 'MediaTypeParameters'\n\t * parameters[Symbol.toStringTag](); // 'MediaTypeParameters'\n\t * Object.prototype.toString.call(parameters); // '[object MediaTypeParameters]'\n\t * parameters + ''; // 'charset=utf-8'\n\t * @returns {string} The string representation of the media type parameters.\n\t */\n\t[Symbol.toStringTag]() {\n\t\treturn 'MediaTypeParameters';\n\t}\n}", "import {\n\tasciiLowercase,\n\tcollectAnHTTPQuotedString, isHTTPWhitespaceChar, removeLeadingAndTrailingHTTPWhitespace,\n\tremoveTrailingHTTPWhitespace, solelyContainsHTTPQuotedStringTokenCodePoints, solelyContainsHTTPTokenCodePoints\n} from './utils.js';\n\n/**\n * Function to parse a media type.\n *\n * @module parser\n * @param {string} input The media type to parse\n * @returns {{ type: string, subtype: string, parameters: Map<string, string> }} An object populated with the parsed media type properties and any parameters.\n */\nconst parse = (input) => {\n\tinput = removeLeadingAndTrailingHTTPWhitespace(input);\n\n\tlet position = 0;\n\tlet type = '';\n\twhile (position < input.length && input[position] != '/') {\n\t\ttype += input[position];\n\t\t++position;\n\t}\n\n\tif (type.length === 0 || !solelyContainsHTTPTokenCodePoints(type)) {\n\t\treturn null;\n\t}\n\n\tif (position >= input.length) {\n\t\treturn null;\n\t}\n\n\t// Skips past \"/\"\n\t++position;\n\n\tlet subtype = '';\n\twhile (position < input.length && input[position] != ';') {\n\t\tsubtype += input[position];\n\t\t++position;\n\t}\n\n\tsubtype = removeTrailingHTTPWhitespace(subtype);\n\n\tif (subtype.length === 0 || !solelyContainsHTTPTokenCodePoints(subtype)) {\n\t\treturn null;\n\t}\n\n\tconst mediaType = {\n\t\ttype: asciiLowercase(type),\n\t\tsubtype: asciiLowercase(subtype),\n\t\tparameters: new Map()\n\t};\n\n\twhile (position < input.length) {\n\t\t// Skip past \";\"\n\t\t++position;\n\n\t\twhile (isHTTPWhitespaceChar(input[position])) {\n\t\t\t++position;\n\t\t}\n\n\t\tlet parameterName = '';\n\t\twhile (position < input.length && input[position] != ';' && input[position] != '=') {\n\t\t\tparameterName += input[position];\n\t\t\t++position;\n\t\t}\n\t\tparameterName = asciiLowercase(parameterName);\n\n\t\tif (position < input.length) {\n\t\t\tif (input[position] == ';') {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Skip past \"=\"\n\t\t\t++position;\n\t\t}\n\n\t\tlet parameterValue = null;\n\t\tif (input[position] == '\"') {\n\t\t\t[parameterValue, position] = collectAnHTTPQuotedString(input, position);\n\n\t\t\twhile (position < input.length && input[position] != ';') {\n\t\t\t\t++position;\n\t\t\t}\n\t\t} else {\n\t\t\tparameterValue = '';\n\t\t\twhile (position < input.length && input[position] != ';') {\n\t\t\t\tparameterValue += input[position];\n\t\t\t\t++position;\n\t\t\t}\n\n\t\t\tparameterValue = removeTrailingHTTPWhitespace(parameterValue);\n\n\t\t\tif (parameterValue === '') {\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t}\n\n\t\tif (parameterName.length > 0 &&\tsolelyContainsHTTPTokenCodePoints(parameterName) &&\tsolelyContainsHTTPQuotedStringTokenCodePoints(parameterValue) && !mediaType.parameters.has(parameterName)) {\n\t\t\tmediaType.parameters.set(parameterName, parameterValue);\n\t\t}\n\t}\n\n\treturn mediaType;\n};\n\nexport default parse;", "import { solelyContainsHTTPTokenCodePoints } from './utils.js';\n\n/** @typedef { import('./media-type.js').default } MediaType */\n\n/**\n * A function that serializes the provided {@link mediaType} to a string.\n *\n * @module serializer\n * @param {MediaType} mediaType The media type to serialize.\n * @returns {string} The serialized media type.\n */\nconst serialize = (mediaType) => {\n\tlet serialization = `${mediaType.type}/${mediaType.subtype}`;\n\n\tif (mediaType.parameters.size === 0) {\n\t\treturn serialization;\n\t}\n\n\tfor (let [name, value] of mediaType.parameters) {\n\t\tserialization += `;${name}=`;\n\n\t\tif (!solelyContainsHTTPTokenCodePoints(value) || value.length === 0) {\n\t\t\tvalue = `\"${value.replace(/([\"\\\\])/ug, '\\\\$1')}\"`;\n\t\t}\n\n\t\tserialization += value;\n\t}\n\n\treturn serialization;\n};\n\nexport default serialize;"],
+  "mappings": "gbAAA,IAAAA,EAAA,GAAAC,EAAAD,EAAA,aAAAE,ICEA,IAAMC,EAAuB,CAAC,IAAK,IAAM;AAAA,EAAM,IAAI,EAC7CC,EAAoB,eACpBC,EAAqB,eACrBC,EAAsB,iCACtBC,EAA4B,qCAQ5BC,EAA0CC,GAAWA,EAAO,QAAQL,EAAmB,EAAE,EAAE,QAAQC,EAAoB,EAAE,EAQzHK,EAAgCD,GAAWA,EAAO,QAAQJ,EAAoB,EAAE,EAQhFM,EAAwBC,GAAST,EAAqB,SAASS,CAAI,EAQnEC,EAAqCJ,GAAWH,EAAoB,KAAKG,CAAM,EAQ/EK,EAAiDL,GAAWF,EAA0B,KAAKE,CAAM,EAYjGM,EAAkBN,GAAW,CAClC,IAAIO,EAAS,GACb,OAAW,CAACJ,EAAMK,EAAWL,EAAK,WAAW,CAAC,CAAC,IAAKH,EACnDO,GAAUC,GAAY,IAAMA,GAAY,GAAK,OAAO,aAAaA,EAAW,EAAE,EAAIL,EAGnF,OAAOI,CACR,EAUME,EAA4B,CAACC,EAAOC,IAAa,CACtD,IAAIC,EAAQ,GAEZ,QAASC,EAASH,EAAM,OAAQP,EAAM,EAAEQ,EAAWE,GAGlD,GAFAV,EAAOO,EAAMC,CAAQ,EAEjBR,GAAQ,KACXS,GAAS,EAAED,EAAWE,EAASH,EAAMC,CAAQ,EAAIR,MAC3C,IAAIA,GAAQ,IAClB,MAEAS,GAAST,EAIX,MAAO,CAACS,EAAOD,CAAQ,CACxB,ECzEA,IAAqBG,EAArB,KAAyC,CAExCC,GAOA,YAAYC,EAAS,CACpB,KAAKD,GAAO,IAAI,IAAIC,CAAO,CAC5B,CAOA,IAAI,MAAO,CACV,OAAO,KAAKD,GAAK,IAClB,CAQA,IAAIE,EAAM,CACT,OAAO,KAAKF,GAAK,IAAIG,EAAe,OAAOD,CAAI,CAAC,CAAC,CAClD,CAQA,IAAIA,EAAM,CACT,OAAO,KAAKF,GAAK,IAAIG,EAAe,OAAOD,CAAI,CAAC,CAAC,CAClD,CAUA,IAAIA,EAAME,EAAO,CAIhB,GAHAF,EAAOC,EAAe,OAAOD,CAAI,CAAC,EAClCE,EAAQ,OAAOA,CAAK,EAEhB,CAACC,EAAkCH,CAAI,EAC1C,MAAM,IAAI,MAAM,sCAAsCA,4CAA+C,EAGtG,GAAI,CAACI,EAA8CF,CAAK,EACvD,MAAM,IAAI,MAAM,uCAAuCA,0DAA8D,EAGtH,YAAKJ,GAAK,IAAIE,EAAME,CAAK,EAElB,IACR,CAKA,OAAQ,CACP,KAAKJ,GAAK,MAAM,CACjB,CAQA,OAAOE,EAAM,CACZ,OAAAA,EAAOC,EAAe,OAAOD,CAAI,CAAC,EAC3B,KAAKF,GAAK,OAAOE,CAAI,CAC7B,CAQA,QAAQK,EAAUC,EAAS,CAC1B,KAAKR,GAAK,QAAQO,EAAUC,CAAO,CACpC,CAOA,MAAO,CACN,OAAO,KAAKR,GAAK,KAAK,CACvB,CAOA,QAAS,CACR,OAAO,KAAKA,GAAK,OAAO,CACzB,CAOA,SAAU,CACT,OAAO,KAAKA,GAAK,QAAQ,CAC1B,CAOA,CAAC,OAAO,QAAQ,GAAI,CACnB,OAAO,KAAKA,GAAK,OAAO,QAAQ,EAAE,CACnC,CAkBA,CAAC,OAAO,WAAW,GAAI,CACtB,MAAO,qBACR,CACD,EC3JA,IAAMS,EAASC,GAAU,CACxBA,EAAQC,EAAuCD,CAAK,EAEpD,IAAIE,EAAW,EACXC,EAAO,GACX,KAAOD,EAAWF,EAAM,QAAUA,EAAME,CAAQ,GAAK,KACpDC,GAAQH,EAAME,CAAQ,EACtB,EAAEA,EAOH,GAJIC,EAAK,SAAW,GAAK,CAACC,EAAkCD,CAAI,GAI5DD,GAAYF,EAAM,OACrB,OAAO,KAIR,EAAEE,EAEF,IAAIG,EAAU,GACd,KAAOH,EAAWF,EAAM,QAAUA,EAAME,CAAQ,GAAK,KACpDG,GAAWL,EAAME,CAAQ,EACzB,EAAEA,EAKH,GAFAG,EAAUC,EAA6BD,CAAO,EAE1CA,EAAQ,SAAW,GAAK,CAACD,EAAkCC,CAAO,EACrE,OAAO,KAGR,IAAME,EAAY,CACjB,KAAMC,EAAeL,CAAI,EACzB,QAASK,EAAeH,CAAO,EAC/B,WAAY,IAAI,GACjB,EAEA,KAAOH,EAAWF,EAAM,QAAQ,CAI/B,IAFA,EAAEE,EAEKO,EAAqBT,EAAME,CAAQ,CAAC,GAC1C,EAAEA,EAGH,IAAIQ,EAAgB,GACpB,KAAOR,EAAWF,EAAM,QAAUA,EAAME,CAAQ,GAAK,KAAOF,EAAME,CAAQ,GAAK,KAC9EQ,GAAiBV,EAAME,CAAQ,EAC/B,EAAEA,EAIH,GAFAQ,EAAgBF,EAAeE,CAAa,EAExCR,EAAWF,EAAM,OAAQ,CAC5B,GAAIA,EAAME,CAAQ,GAAK,IACtB,SAID,EAAEA,EAGH,IAAIS,EAAiB,KACrB,GAAIX,EAAME,CAAQ,GAAK,IAGtB,IAFA,CAACS,EAAgBT,CAAQ,EAAIU,EAA0BZ,EAAOE,CAAQ,EAE/DA,EAAWF,EAAM,QAAUA,EAAME,CAAQ,GAAK,KACpD,EAAEA,MAEG,CAEN,IADAS,EAAiB,GACVT,EAAWF,EAAM,QAAUA,EAAME,CAAQ,GAAK,KACpDS,GAAkBX,EAAME,CAAQ,EAChC,EAAEA,EAKH,GAFAS,EAAiBL,EAA6BK,CAAc,EAExDA,IAAmB,GACtB,SAIED,EAAc,OAAS,GAAKN,EAAkCM,CAAa,GAAKG,EAA8CF,CAAc,GAAK,CAACJ,EAAU,WAAW,IAAIG,CAAa,GAC3LH,EAAU,WAAW,IAAIG,EAAeC,CAAc,EAIxD,OAAOJ,CACR,EAEOO,EAAQf,EC9Ff,IAAMgB,EAAaC,GAAc,CAChC,IAAIC,EAAgB,GAAGD,EAAU,QAAQA,EAAU,UAEnD,GAAIA,EAAU,WAAW,OAAS,EACjC,OAAOC,EAGR,OAAS,CAACC,EAAMC,CAAK,IAAKH,EAAU,WACnCC,GAAiB,IAAIC,MAEjB,CAACE,EAAkCD,CAAK,GAAKA,EAAM,SAAW,KACjEA,EAAQ,IAAIA,EAAM,QAAQ,YAAa,MAAM,MAG9CF,GAAiBE,EAGlB,OAAOF,CACR,EAEOI,EAAQN,EJpBf,IAAqBO,EAArB,KAA+B,CAE9BC,GAEAC,GAEAC,GAQA,YAAYC,EAAWC,EAAa,CAAC,EAAG,CACvC,GAAM,CAAE,KAAAC,EAAM,QAAAC,EAAS,WAAYC,CAAiB,EAAIC,EAAML,CAAS,EACvE,KAAKH,GAAQK,EACb,KAAKJ,GAAWK,EAChB,KAAKJ,GAAc,IAAIO,EAAoB,CAAC,GAAGF,EAAkB,GAAG,OAAO,QAAQH,CAAU,EAAE,IAAI,CAAC,CAACM,EAAMC,CAAK,IAAM,CAACC,EAAeF,CAAI,EAAGE,EAAeD,CAAK,CAAC,CAAC,CAAC,CAAC,CACtK,CAQA,OAAO,MAAME,EAAQ,CACpB,GAAI,CACH,OAAO,IAAId,EAAUc,CAAM,CAC5B,MAAE,CACD,MAAM,IAAI,MAAM,sCAAsCA,IAAS,CAChE,CACD,CAOA,IAAI,SAAU,CACb,MAAO,GAAG,KAAKb,MAAS,KAAKC,IAC9B,CAOA,IAAI,MAAO,CACV,OAAO,KAAKD,EACb,CAKA,IAAI,KAAKW,EAAO,CAGf,GAFAA,EAAQC,EAAe,OAAOD,CAAK,CAAC,EAEhCA,EAAM,SAAW,EACpB,MAAM,IAAI,MAAM,0CAA0C,EAE3D,GAAI,CAACG,EAAkCH,CAAK,EAC3C,MAAM,IAAI,MAAM,gBAAgBA,6CAAiD,EAGlF,KAAKX,GAAQW,CACd,CAOA,IAAI,SAAU,CACb,OAAO,KAAKV,EACb,CAKA,IAAI,QAAQU,EAAO,CAGlB,GAFAA,EAAQC,EAAe,OAAOD,CAAK,CAAC,EAEhCA,EAAM,SAAW,EACpB,MAAM,IAAI,MAAM,6CAA6C,EAE9D,GAAI,CAACG,EAAkCH,CAAK,EAC3C,MAAM,IAAI,MAAM,mBAAmBA,6CAAiD,EAGrF,KAAKV,GAAWU,CACjB,CAOA,IAAI,YAAa,CAChB,OAAO,KAAKT,EACb,CAOA,UAAW,CAGV,OAAOa,EAAU,IAAI,CACtB,CASA,aAAa,CAAC,mBAAAC,EAAqB,EAAK,EAAI,CAAC,EAAG,CAC/C,OAAQ,KAAKhB,GAAO,CACnB,IAAK,OACJ,OAAQ,KAAKC,GAAU,CACtB,IAAK,aACL,IAAK,aACL,IAAK,gBACL,IAAK,gBACL,IAAK,gBACL,IAAK,gBACL,IAAK,gBACL,IAAK,gBACL,IAAK,UACL,IAAK,aACL,IAAK,eACL,IAAK,eAAgB,MAAO,CAACe,GAAsB,KAAKd,GAAY,OAAS,EAC7E,QAAS,MAAO,EACjB,CAED,IAAK,cACJ,OAAQ,KAAKD,GAAU,CACtB,IAAK,aACL,IAAK,aACL,IAAK,eACL,IAAK,eAAgB,MAAO,CAACe,GAAsB,KAAKd,GAAY,OAAS,EAC7E,QAAS,MAAO,EACjB,CAED,QAAS,MAAO,EACjB,CACD,CAOA,OAAQ,CACP,OAAQ,KAAKD,KAAa,QAAU,KAAKD,KAAU,QAAU,KAAKA,KAAU,gBAAmB,KAAKC,GAAS,SAAS,MAAM,CAC7H,CAOA,QAAS,CACR,OAAO,KAAKA,KAAa,QAAU,KAAKD,KAAU,MACnD,CAOA,IAAK,OAAO,WAAW,GAAI,CAC1B,MAAO,WACR,CACD",
+  "names": ["media_type_exports", "__export", "MediaType", "whitespaceCharacters", "leadingWhitespace", "trailingWhitespace", "httpTokenCodePoints", "httpQuotedTokenCodePoints", "removeLeadingAndTrailingHTTPWhitespace", "string", "removeTrailingHTTPWhitespace", "isHTTPWhitespaceChar", "char", "solelyContainsHTTPTokenCodePoints", "solelyContainsHTTPQuotedStringTokenCodePoints", "asciiLowercase", "result", "charCode", "collectAnHTTPQuotedString", "input", "position", "value", "length", "MediaTypeParameters", "#map", "entries", "name", "asciiLowercase", "value", "solelyContainsHTTPTokenCodePoints", "solelyContainsHTTPQuotedStringTokenCodePoints", "callback", "thisArg", "parse", "input", "removeLeadingAndTrailingHTTPWhitespace", "position", "type", "solelyContainsHTTPTokenCodePoints", "subtype", "removeTrailingHTTPWhitespace", "mediaType", "asciiLowercase", "isHTTPWhitespaceChar", "parameterName", "parameterValue", "collectAnHTTPQuotedString", "solelyContainsHTTPQuotedStringTokenCodePoints", "parser_default", "serialize", "mediaType", "serialization", "name", "value", "solelyContainsHTTPTokenCodePoints", "serializer_default", "MediaType", "#type", "#subtype", "#parameters", "mediaType", "parameters", "type", "subtype", "parsedParameters", "parser_default", "MediaTypeParameters", "name", "value", "asciiLowercase", "string", "solelyContainsHTTPTokenCodePoints", "serializer_default", "prohibitParameters"]
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@d1g1tal/media-type",
   "description": "Parses, serializes, and manipulates media types, according to the WHATWG MIME Sniffing Standard",
-  "version": "4.0.1",
+  "version": "4.1.0",
   "author": "Domenic Denicola <d@domenic.me> (https://domenic.me/)",
   "maintainers": [
     {
@@ -53,21 +53,18 @@
   },
   "devDependencies": {
     "@skypack/package-check": "^0.2.2",
-    "esbuild": "^0.15.12",
-    "eslint": "^8.25.0",
-    "eslint-plugin-compat": "^4.0.2",
-    "eslint-plugin-jsdoc": "^39.3.14",
-    "jest": "^29.2.1",
-    "minipass-fetch": "^3.0.0",
+    "esbuild": "^0.17.19",
+    "eslint": "^8.41.0",
+    "eslint-plugin-compat": "^4.1.4",
+    "eslint-plugin-jsdoc": "^44.2.4",
+    "jest": "^29.5.0",
+    "minipass-fetch": "^3.0.3",
     "printable-string": "^0.3.0",
-    "rimraf": "^3.0.2",
+    "rimraf": "^5.0.1",
     "whatwg-encoding": "^2.0.0"
   },
   "browserslist": [
-    ">= 0.5%",
-    "last 2 major versions",
-    "Firefox ESR",
-    "not dead",
+    "defaults",
     "not ios_saf < 15",
     "not op_mini all"
   ],

package/src/media-type-parameters.js

@@ -9,16 +9,24 @@ import { asciiLowercase, solelyContainsHTTPQuotedStringTokenCodePoints, solelyCo
  * and attempting to set invalid characters will throw an {@link Error}.
  *
  * @example charset=utf-8
- * @module MediaTypeParameters
+ * @see https://mimesniff.spec.whatwg.org/#mime-type-essence
+ * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record
+ * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record-creation
+ * @see https://mimesniff.spec.whatwg.org/#mime-type-essence-record-creation-algorithm
+ * @module {MediaTypeParameters} media-type-parameters
+ * @author D1g1talEntr0py <jason.dimeo@gmail.com>
  */
 export default class MediaTypeParameters {
+	/** @type {Map<string, string>} */
+	#map;
+
 	/**
 	 * Create a new MediaTypeParameters instance.
 	 *
-	 * @param {Map.<string, string>} map The map of parameters for a media type.
+	 * @param {Array<Array<string>>} entries An array of [name, value] tuples.
 	 */
-	constructor(map) {
-		this._map = map;
+	constructor(entries) {
+		this.#map = new Map(entries);
 	}
 
 	/**
@@ -27,7 +35,7 @@ export default class MediaTypeParameters {
 	 * @returns {number} The number of media type parameters
 	 */
 	get size() {
-		return this._map.size;
+		return this.#map.size;
 	}
 
 	/**
@@ -37,7 +45,7 @@ export default class MediaTypeParameters {
 	 * @returns {string} The media type parameter value.
 	 */
 	get(name) {
-		return this._map.get(asciiLowercase(String(name)));
+		return this.#map.get(asciiLowercase(String(name)));
 	}
 
 	/**
@@ -47,7 +55,7 @@ export default class MediaTypeParameters {
 	 * @returns {boolean} true if the media type parameter exists, false otherwise.
 	 */
 	has(name) {
-		return this._map.has(asciiLowercase(String(name)));
+		return this.#map.has(asciiLowercase(String(name)));
 	}
 
 	/**
@@ -70,7 +78,7 @@ export default class MediaTypeParameters {
 			throw new Error(`Invalid media type parameter value "${value}": only HTTP quoted-string token code points are valid.`);
 		}
 
-		this._map.set(name, value);
+		this.#map.set(name, value);
 
 		return this;
 	}
@@ -79,7 +87,7 @@ export default class MediaTypeParameters {
 	 * Clears all the media type parameters.
 	 */
 	clear() {
-		this._map.clear();
+		this.#map.clear();
 	}
 
 	/**
@@ -90,7 +98,7 @@ export default class MediaTypeParameters {
 	 */
 	delete(name) {
 		name = asciiLowercase(String(name));
-		return this._map.delete(name);
+		return this.#map.delete(name);
 	}
 
 	/**
@@ -100,7 +108,7 @@ export default class MediaTypeParameters {
 	 * @param {*} [thisArg] Optional object when binding 'this' to the callback.
 	 */
 	forEach(callback, thisArg) {
-		this._map.forEach(callback, thisArg);
+		this.#map.forEach(callback, thisArg);
 	}
 
 	/**
@@ -109,7 +117,7 @@ export default class MediaTypeParameters {
 	 * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter names.
 	 */
 	keys() {
-		return this._map.keys();
+		return this.#map.keys();
 	}
 
 	/**
@@ -118,7 +126,7 @@ export default class MediaTypeParameters {
 	 * @returns {IterableIterator<string>} The {@link IterableIterator} of media type parameter values.
 	 */
 	values() {
-		return this._map.values();
+		return this.#map.values();
 	}
 
 	/**
@@ -127,7 +135,7 @@ export default class MediaTypeParameters {
 	 * @returns {IterableIterator<Array<Array<string>>>} The media type parameter entries.
 	 */
 	entries() {
-		return this._map.entries();
+		return this.#map.entries();
 	}
 
 	/**
@@ -136,6 +144,26 @@ export default class MediaTypeParameters {
 	 * @returns {Iterator<string, string, undefined>} The {@link Symbol.iterator} for the media type parameters.
 	 */
 	[Symbol.iterator]() {
-		return this._map[Symbol.iterator]();
+		return this.#map[Symbol.iterator]();
+	}
+
+	/**
+	 * Returns a string representation of the media type parameters.
+	 * This method is called by the `String()` function.
+	 *
+	 * @example
+	 * const parameters = new MediaTypeParameters(new Map([['charset', 'utf-8']]));
+	 * String(parameters); // 'charset=utf-8'
+	 * parameters.toString(); // 'charset=utf-8'
+	 * parameters + ''; // 'charset=utf-8'
+	 * `${parameters}`; // 'charset=utf-8'
+	 * parameters[Symbol.toStringTag]; // 'MediaTypeParameters'
+	 * parameters[Symbol.toStringTag](); // 'MediaTypeParameters'
+	 * Object.prototype.toString.call(parameters); // '[object MediaTypeParameters]'
+	 * parameters + ''; // 'charset=utf-8'
+	 * @returns {string} The string representation of the media type parameters.
+	 */
+	[Symbol.toStringTag]() {
+		return 'MediaTypeParameters';
 	}
 }

package/src/media-type.js

@@ -6,38 +6,41 @@ import { asciiLowercase, solelyContainsHTTPTokenCodePoints } from './utils.js';
 /**
  * Class used to parse media types.
  *
+ * @module {MediaType} media-type
  * @see https://mimesniff.spec.whatwg.org/#understanding-mime-types
- * @module MediaType
  */
 export default class MediaType {
+	/** @type {string} */
+	#type;
+	/** @type {string} */
+	#subtype;
+	/** @type {MediaTypeParameters} */
+	#parameters;
+
 	/**
 	 * Create a new MediaType instance from a string representation.
 	 *
-	 * @param {string} string The media type to parse
+	 * @param {string} mediaType The media type to parse.
+	 * @param {Object} [parameters] Optional parameters.
 	 */
-	constructor(string) {
-		string = String(string);
-		const result = parse(string);
-		if (result === null) {
-			throw new Error(`Could not parse media type string '${string}'`);
-		}
-
-		this._type = result.type;
-		this._subtype = result.subtype;
-		this._parameters = new MediaTypeParameters(result.parameters);
+	constructor(mediaType, parameters = {}) {
+		const { type, subtype, parameters: parsedParameters } = parse(mediaType);
+		this.#type = type;
+		this.#subtype = subtype;
+		this.#parameters = new MediaTypeParameters([...parsedParameters, ...Object.entries(parameters).map(([name, value]) => [asciiLowercase(name), asciiLowercase(value)])]);
 	}
 
 	/**
-	 * Static factor method for parsing a media type.
+	 * Static factory method for parsing a media type.
 	 *
-	 * @param {string} string The media type to parse
-	 * @returns {MediaType} The parsed {@link MediaType} object
+	 * @param {string} string The media type to parse.
+	 * @returns {MediaType} The parsed {@link MediaType} object or null if the string could not be parsed.
 	 */
 	static parse(string) {
 		try {
-			return new this(string);
+			return new MediaType(string);
 		} catch (e) {
-			return null;
+			throw new Error(`Could not parse media type string '${string}'`);
 		}
 	}
 
@@ -47,7 +50,7 @@ export default class MediaType {
 	 * @returns {string} The media type without any parameters
 	 */
 	get essence() {
-		return `${this.type}/${this.subtype}`;
+		return `${this.#type}/${this.#subtype}`;
 	}
 
 	/**
@@ -56,7 +59,7 @@ export default class MediaType {
 	 * @returns {string} The type.
 	 */
 	get type() {
-		return this._type;
+		return this.#type;
 	}
 
 	/**
@@ -72,7 +75,7 @@ export default class MediaType {
 			throw new Error(`Invalid type ${value}: must contain only HTTP token code points`);
 		}
 
-		this._type = value;
+		this.#type = value;
 	}
 
 	/**
@@ -81,7 +84,7 @@ export default class MediaType {
 	 * @returns {string} The subtype.
 	 */
 	get subtype() {
-		return this._subtype;
+		return this.#subtype;
 	}
 
 	/**
@@ -97,7 +100,7 @@ export default class MediaType {
 			throw new Error(`Invalid subtype ${value}: must contain only HTTP token code points`);
 		}
 
-		this._subtype = value;
+		this.#subtype = value;
 	}
 
 	/**
@@ -106,7 +109,7 @@ export default class MediaType {
 	 * @returns {MediaTypeParameters} The media type parameters.
 	 */
 	get parameters() {
-		return this._parameters;
+		return this.#parameters;
 	}
 
 	/**
@@ -128,9 +131,9 @@ export default class MediaType {
 	 * @returns {boolean} true if this instance represents a JavaScript media type, false otherwise.
 	 */
 	isJavaScript({prohibitParameters = false} = {}) {
-		switch (this._type) {
+		switch (this.#type) {
 			case 'text': {
-				switch (this._subtype) {
+				switch (this.#subtype) {
 					case 'ecmascript':
 					case 'javascript':
 					case 'javascript1.0':
@@ -142,16 +145,16 @@ export default class MediaType {
 					case 'jscript':
 					case 'livescript':
 					case 'x-ecmascript':
-					case 'x-javascript': return !prohibitParameters || this._parameters.size === 0;
+					case 'x-javascript': return !prohibitParameters || this.#parameters.size === 0;
 					default: return false;
 				}
 			}
 			case 'application': {
-				switch (this._subtype) {
+				switch (this.#subtype) {
 					case 'ecmascript':
 					case 'javascript':
 					case 'x-ecmascript':
-					case 'x-javascript': return !prohibitParameters || this._parameters.size === 0;
+					case 'x-javascript': return !prohibitParameters || this.#parameters.size === 0;
 					default: return false;
 				}
 			}
@@ -165,7 +168,7 @@ export default class MediaType {
 	 * @returns {boolean} true if this instance represents an XML media type, false otherwise.
 	 */
 	isXML() {
-		return (this._subtype === 'xml' && (this._type === 'text' || this._type === 'application')) || this._subtype.endsWith('+xml');
+		return (this.#subtype === 'xml' && (this.#type === 'text' || this.#type === 'application')) || this.#subtype.endsWith('+xml');
 	}
 
 	/**
@@ -174,7 +177,7 @@ export default class MediaType {
 	 * @returns {boolean} true if this instance represents an HTML media type, false otherwise.
 	 */
 	isHTML() {
-		return this._subtype === 'html' && this._type === 'text';
+		return this.#subtype === 'html' && this.#type === 'text';
 	}
 
 	/**

package/src/parser.js

@@ -16,7 +16,7 @@ const parse = (input) => {
 
 	let position = 0;
 	let type = '';
-	while (position < input.length && input[position] !== '/') {
+	while (position < input.length && input[position] != '/') {
 		type += input[position];
 		++position;
 	}
@@ -33,7 +33,7 @@ const parse = (input) => {
 	++position;
 
 	let subtype = '';
-	while (position < input.length && input[position] !== ';') {
+	while (position < input.length && input[position] != ';') {
 		subtype += input[position];
 		++position;
 	}
@@ -59,14 +59,14 @@ const parse = (input) => {
 		}
 
 		let parameterName = '';
-		while (position < input.length && input[position] !== ';' && input[position] !== '=') {
+		while (position < input.length && input[position] != ';' && input[position] != '=') {
 			parameterName += input[position];
 			++position;
 		}
 		parameterName = asciiLowercase(parameterName);
 
 		if (position < input.length) {
-			if (input[position] === ';') {
+			if (input[position] == ';') {
 				continue;
 			}
 
@@ -75,15 +75,15 @@ const parse = (input) => {
 		}
 
 		let parameterValue = null;
-		if (input[position] === '"') {
+		if (input[position] == '"') {
 			[parameterValue, position] = collectAnHTTPQuotedString(input, position);
 
-			while (position < input.length && input[position] !== ';') {
+			while (position < input.length && input[position] != ';') {
 				++position;
 			}
 		} else {
 			parameterValue = '';
-			while (position < input.length && input[position] !== ';') {
+			while (position < input.length && input[position] != ';') {
 				parameterValue += input[position];
 				++position;
 			}
@@ -95,10 +95,7 @@ const parse = (input) => {
 			}
 		}
 
-		if (parameterName.length > 0 &&
-			solelyContainsHTTPTokenCodePoints(parameterName) &&
-			solelyContainsHTTPQuotedStringTokenCodePoints(parameterValue) &&
-			!mediaType.parameters.has(parameterName)) {
+		if (parameterName.length > 0 &&	solelyContainsHTTPTokenCodePoints(parameterName) &&	solelyContainsHTTPQuotedStringTokenCodePoints(parameterValue) && !mediaType.parameters.has(parameterName)) {
 			mediaType.parameters.set(parameterName, parameterValue);
 		}
 	}

package/src/serializer.js

@@ -1,5 +1,5 @@
 import { solelyContainsHTTPTokenCodePoints } from './utils.js';
-// eslint-disable-next-line jsdoc/valid-types
+
 /** @typedef { import('./media-type.js').default } MediaType */
 
 /**
@@ -17,13 +17,10 @@ const serialize = (mediaType) => {
 	}
 
 	for (let [name, value] of mediaType.parameters) {
-		serialization += ';';
-		serialization += name;
-		serialization += '=';
+		serialization += `;${name}=`;
 
 		if (!solelyContainsHTTPTokenCodePoints(value) || value.length === 0) {
-			value = value.replace(/(["\\])/ug, '\\$1');
-			value = `"${value}"`;
+			value = `"${value.replace(/(["\\])/ug, '\\$1')}"`;
 		}
 
 		serialization += value;

package/src/utils.js

@@ -1,12 +1,18 @@
 /** @module utils */
 
+const whitespaceCharacters = [' ', '\t', '\n', '\r'];
+const leadingWhitespace = /^[ \t\n\r]+/u;
+const trailingWhitespace = /[ \t\n\r]+$/u;
+const httpTokenCodePoints = /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u;
+const httpQuotedTokenCodePoints = /^[\t\u0020-\u007E\u0080-\u00FF]*$/u;
+
 /**
  * A function to remove any leading and trailing HTTP whitespace.
  *
  * @param {string} string The string to process.
  * @returns {string} The processed string.
  */
-const removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(/^[ \t\n\r]+/u, '').replace(/[ \t\n\r]+$/u, '');
+const removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(leadingWhitespace, '').replace(trailingWhitespace, '');
 
 /**
  * A function to remove any trailing HTTP whitespace.
@@ -14,7 +20,7 @@ const removeLeadingAndTrailingHTTPWhitespace = (string) => string.replace(/^[ \t
  * @param {string} string The string to process.
  * @returns {string} The processed string.
  */
-const removeTrailingHTTPWhitespace = (string) => string.replace(/[ \t\n\r]+$/u, '');
+const removeTrailingHTTPWhitespace = (string) => string.replace(trailingWhitespace, '');
 
 /**
  * Determines if the provided character is whitespace.
@@ -22,7 +28,7 @@ const removeTrailingHTTPWhitespace = (string) => string.replace(/[ \t\n\r]+$/u,
  * @param {string} char The character to evaluate.
  * @returns {boolean} true if the character is whitespace, false otherwise.
  */
-const isHTTPWhitespaceChar = (char) => char === ' ' || char === '\t' || char === '\n' || char === '\r';
+const isHTTPWhitespaceChar = (char) => whitespaceCharacters.includes(char);
 
 /**
  * Determines if the provided string contains only HTTP token code points.
@@ -30,7 +36,7 @@ const isHTTPWhitespaceChar = (char) => char === ' ' || char === '\t' || char ===
  * @param {string} string The string to evaluate.
  * @returns {boolean} true if the string contains only HTTP token code points.
  */
-const solelyContainsHTTPTokenCodePoints = (string) => /^[-!#$%&'*+.^_`|~A-Za-z0-9]*$/u.test(string);
+const solelyContainsHTTPTokenCodePoints = (string) => httpTokenCodePoints.test(string);
 
 /**
  * Determines if the provided string contains only quoted HTTP token code points.
@@ -38,15 +44,26 @@ const solelyContainsHTTPTokenCodePoints = (string) => /^[-!#$%&'*+.^_`|~A-Za-z0-
  * @param {string} string The string to evaluate.
  * @returns {boolean} true if the string contains only quoted HTTP token code points.
  */
-const solelyContainsHTTPQuotedStringTokenCodePoints = (string) => /^[\t\u0020-\u007E\u0080-\u00FF]*$/u.test(string);
+const solelyContainsHTTPQuotedStringTokenCodePoints = (string) => httpQuotedTokenCodePoints.test(string);
 
 /**
  * A function to lower case ASCII characters.
+ * This implementation iterates over each element of the string, which is treated as an iterable.
+ * The elements are destructured into [char, charCode] pairs, where char represents the character,
+ * and charCode is assigned the character code using char.charCodeAt(0). If the charCode is not
+ * provided, it falls back to the character code obtained from char.charCodeAt(0).
  *
  * @param {string} string The string to process.
  * @returns {string} The processed string with all ASCII characters lower cased.
  */
-const asciiLowercase = (string) => string.replace(/[A-Z]/ug, l => l.toLowerCase());
+const asciiLowercase = (string) => {
+	let result = '';
+	for (const [char, charCode = char.charCodeAt(0)] of string) {
+		result += charCode >= 65 && charCode <= 90 ? String.fromCharCode(charCode + 32) : char;
+	}
+
+	return result;
+};
 
 /**
  * Collects all the HTTP quoted strings.
@@ -54,36 +71,20 @@ const asciiLowercase = (string) => string.replace(/[A-Z]/ug, l => l.toLowerCase(
  *
  * @param {string} input The string to process.
  * @param {number} position The starting position.
- * @returns {Array<string | number>} An array that includes the resulting string and updated position.
+ * @returns {Array<string|number>} An array that includes the resulting string and updated position.
  */
 const collectAnHTTPQuotedString = (input, position) => {
 	let value = '';
 
-	position++;
-
-	while (true) {
-		while (position < input.length && input[position] !== '"' && input[position] !== '\\') {
-			value += input[position];
-			++position;
-		}
+	for (let length = input.length, char; ++position < length;) {
+		char = input[position];
 
-		if (position >= input.length) {
+		if (char == '\\') {
+			value += ++position < length ? input[position] : char;
+		} else if (char == '"') {
 			break;
-		}
-
-		const quoteOrBackslash = input[position];
-		++position;
-
-		if (quoteOrBackslash === '\\') {
-			if (position >= input.length) {
-				value += '\\';
-				break;
-			}
-
-			value += input[position];
-			++position;
 		} else {
-			break;
+			value += char;
 		}
 	}