uti 8.3.0 → 8.3.2

package/README.md

@@ -1,5 +1,6 @@
 [![npm](https://img.shields.io/npm/v/uti.svg)](https://www.npmjs.com/package/uti)
 [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+[![Typed with TypeScript](https://flat.badgen.net/badge/icon/Typed?icon=typescript\&label\&labelColor=blue\&color=555555)](https://typescriptlang.org)
 [![bundlejs](https://deno.bundlejs.com/?q=uti\&badge=detailed)](https://bundlejs.com/?q=uti)
 [![downloads](http://img.shields.io/npm/dm/uti.svg?style=flat-square)](https://npmjs.org/package/uti)
 [![GitHub Issues](https://img.shields.io/github/issues/arlac77/uti.svg?style=flat-square)](https://github.com/arlac77/uti/issues)
@@ -54,6 +55,8 @@ public.plain-text
     *   [toJSON](#tojson)
 *   [UTIController](#uticontroller)
     *   [Properties](#properties-1)
+    *   [utiByMimeType](#utibymimetype)
+    *   [utiByFileNameExtension](#utibyfilenameextension)
     *   [register](#register)
         *   [Parameters](#parameters-2)
     *   [getUTI](#getuti)
@@ -115,6 +118,14 @@ Registry of UTIs.
 *   `utiByMimeType` **[Map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [UTI](#uti)>**&#x20;
 *   `utiByFileNameExtension` **[Map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [UTI](#uti)>**&#x20;
 
+### utiByMimeType
+
+Type: [Map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>>
+
+### utiByFileNameExtension
+
+Type: [Map](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Map)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String), [Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>>
+
 ### register
 
 Registers additional types.
@@ -131,7 +142,7 @@ Lookup a given UTI.
 
 *   `name` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** UTI
 
-Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** UTI for the given name or undefined if UTI is not present.
+Returns **([string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String) | [undefined](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/undefined))** UTI for the given name or undefined if UTI is not present.
 
 ### getUTIsForMimeType
 
@@ -141,7 +152,7 @@ Lookup a UTIs for a mime type.
 
 *   `mimeType` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** mime type to get UTIs for
 
-Returns **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** UTI for the given mime type or undefined if no UTI is registerd for the mime type
+Returns **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** UTIs for the given mime type
 
 ### getUTIsForFileName
 
@@ -153,7 +164,7 @@ Then a lookup in the reistered UTIs for file name extions is executed.
 
 *   `fileName` **[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)** file to detect UTI for
 
-Returns **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** UTI for the given fileName or undefined if no UTI is registerd for the file names extension
+Returns **[Array](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array)<[string](https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String)>** UTIs for the given fileName
 
 ### conformsTo
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uti",
-  "version": "8.3.0",
+  "version": "8.3.2",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -25,7 +25,7 @@
   ],
   "license": "BSD-2-Clause",
   "scripts": {
-    "prepare": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir dist -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs",
+    "prepare": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir types -t esnext -m esnext --module nodenext --moduleResolution nodenext ./src**/*.mjs",
     "test": "npm run test:browser-ava && npm run test:ava",
     "test:ava": "ava --timeout 4m tests/*-ava.mjs tests/*-ava-node.mjs",
     "test:browser-ava": "browser-ava --headless --no-keep-open tests/*-ava.mjs tests/*-ava-browser.mjs",
@@ -37,7 +37,7 @@
   },
   "devDependencies": {
     "ava": "^6.1.1",
-    "browser-ava": "^2.1.12",
+    "browser-ava": "^2.2.0",
     "c8": "^9.1.0",
     "documentation": "^14.0.3",
     "semantic-release": "^23.0.2",

package/src/uti.mjs

@@ -63,8 +63,8 @@ class UTI {
  */
 export class UTIController {
   registry = new Map();
-  utiByMimeType = new Map();
-  utiByFileNameExtension = new Map();
+  /** @type {Map<string,string[]>} */ utiByMimeType = new Map();
+  /** @type {Map<string,string[]>} */ utiByFileNameExtension = new Map();
 
   constructor() {
     this.register(types);
@@ -116,7 +116,7 @@ export class UTIController {
   /**
    * Lookup a given UTI.
    * @param {string} name UTI
-   * @return {string} UTI for the given name or undefined if UTI is not present.
+   * @return {string|undefined} UTI for the given name or undefined if UTI is not present.
    */
   getUTI(name) {
     return this.registry.get(name);
@@ -125,10 +125,10 @@ export class UTIController {
   /**
    * Lookup a UTIs for a mime type.
    * @param {string} mimeType mime type to get UTIs for
-   * @return {string} UTI for the given mime type or undefined if no UTI is registerd for the mime type
+   * @return {string[]} UTIs for the given mime type
    */
   getUTIsForMimeType(mimeType) {
-    return this.utiByMimeType.get(mimeType);
+    return this.utiByMimeType.get(mimeType) || [];
   }
 
   /**
@@ -136,7 +136,7 @@ export class UTIController {
    * First the file name extension is extracted.
    * Then a lookup in the reistered UTIs for file name extions is executed.
    * @param {string} fileName file to detect UTI for
-   * @return {string[]} UTI for the given fileName or undefined if no UTI is registerd for the file names extension
+   * @return {string[]} UTIs for the given fileName
    */
   getUTIsForFileName(fileName) {
     const m = fileName.match(/(\.[\.a-zA-Z_0-9]+)$/);

package/{dist → types}/uti.d.mts

@@ -6,8 +6,8 @@
  */
 export class UTIController {
     registry: Map<any, any>;
-    utiByMimeType: Map<any, any>;
-    utiByFileNameExtension: Map<any, any>;
+    /** @type {Map<string,string[]>} */ utiByMimeType: Map<string, string[]>;
+    /** @type {Map<string,string[]>} */ utiByFileNameExtension: Map<string, string[]>;
     /**
      * Registers additional types.
      * @param {Object[]} types
@@ -16,21 +16,21 @@ export class UTIController {
     /**
      * Lookup a given UTI.
      * @param {string} name UTI
-     * @return {string} UTI for the given name or undefined if UTI is not present.
+     * @return {string|undefined} UTI for the given name or undefined if UTI is not present.
      */
-    getUTI(name: string): string;
+    getUTI(name: string): string | undefined;
     /**
      * Lookup a UTIs for a mime type.
      * @param {string} mimeType mime type to get UTIs for
-     * @return {string} UTI for the given mime type or undefined if no UTI is registerd for the mime type
+     * @return {string[]} UTIs for the given mime type
      */
-    getUTIsForMimeType(mimeType: string): string;
+    getUTIsForMimeType(mimeType: string): string[];
     /**
      * Lookup a UTI for a file name.
      * First the file name extension is extracted.
      * Then a lookup in the reistered UTIs for file name extions is executed.
      * @param {string} fileName file to detect UTI for
-     * @return {string[]} UTI for the given fileName or undefined if no UTI is registerd for the file names extension
+     * @return {string[]} UTIs for the given fileName
      */
     getUTIsForFileName(fileName: string): string[];
     /**