uti 8.2.3 → 8.3.1

package/dist/uti.d.mts

@@ -0,0 +1,53 @@
+/**
+ * Registry of UTIs.
+ * @property {Map<string,UTI>} registry
+ * @property {Map<string,UTI>} utiByMimeType
+ * @property {Map<string,UTI>} utiByFileNameExtension
+ */
+export class UTIController {
+    registry: 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
+     */
+    register(types: any[]): void;
+    /**
+     * Lookup a given UTI.
+     * @param {string} name UTI
+     * @return {string|undefined} UTI for the given name or undefined if UTI is not present.
+     */
+    getUTI(name: string): string | undefined;
+    /**
+     * Lookup a UTIs for a mime type.
+     * @param {string} mimeType mime type to get UTIs for
+     * @return {string[]} UTIs for the given mime type
+     */
+    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[]} UTIs for the given fileName
+     */
+    getUTIsForFileName(fileName: string): string[];
+    /**
+     * Check whenever two UTI are conformant.
+     * If a conforms to b and b conforms to c then a also conforms to c.
+     * @param {string} a first UTI
+     * @param {string} b second UTI
+     * @return {boolean} true if UTI a conforms to UTI b.
+     */
+    conformsTo(a: string, b: string): boolean;
+    /**
+     * Lookup a UTI for a file name and check conformance.
+     * @param {string} fileName file to detect UTI for
+     * @param {string} uti to check conformance against
+     * @return {boolean} ture if utils for file name are conformant
+     */
+    fileNameConformsTo(fileName: string, uti: string): boolean;
+    assignMimeTypes(name: any, mimTypes: any): void;
+    assignExtensions(name: any, extensions: any): void;
+}

package/dist/well-known-utis.d.mts

@@ -0,0 +1,98 @@
+declare const _default: ({
+    name: string;
+    conformsTo?: undefined;
+    mimeType?: undefined;
+    fileNameExtension?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    mimeType?: undefined;
+    fileNameExtension?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    mimeType: string;
+    fileNameExtension: string;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    fileNameExtension: string;
+    mimeType?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    mimeType?: undefined;
+    fileNameExtension?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string;
+    mimeType: string;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string;
+    mimeType?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string[];
+    mimeType: string;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string;
+    mimeType: string[];
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string[];
+    mimeType?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    fileNameExtension: string[];
+    mimeType: string[];
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    fileNameExtension: string[];
+    mimeType: string[];
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    fileNameExtension: string[];
+    mimeType?: undefined;
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string[];
+    mimeType: string;
+    fileNameExtension: string[];
+    filNameExtension?: undefined;
+} | {
+    name: string;
+    conformsTo: string;
+    filNameExtension: string;
+    mimeType: string;
+    fileNameExtension?: undefined;
+} | {
+    name: string;
+    fileNameExtension: string[];
+    conformsTo?: undefined;
+    mimeType?: undefined;
+    filNameExtension?: undefined;
+})[];
+export default _default;

package/package.json

@@ -1,12 +1,15 @@
 {
   "name": "uti",
-  "version": "8.2.3",
+  "version": "8.3.1",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
   "exports": {
-    ".": "./src/uti.mjs"
+    ".": {
+      "types": "./dist/uti.d.mts",
+      "default": "./src/uti.mjs"
+    }
   },
   "description": "javascript implementation of a \"Uniform Type Identifier\" (UTI)",
   "keywords": [
@@ -22,6 +25,7 @@
   ],
   "license": "BSD-2-Clause",
   "scripts": {
+    "prepare": "tsc --allowJs --declaration --emitDeclarationOnly --declarationDir dist -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",
@@ -33,14 +37,14 @@
   },
   "devDependencies": {
     "ava": "^6.1.1",
-    "browser-ava": "^2.1.10",
+    "browser-ava": "^2.1.12",
     "c8": "^9.1.0",
     "documentation": "^14.0.3",
-    "semantic-release": "^23.0.0",
+    "semantic-release": "^23.0.2",
     "typescript": "^5.3.3"
   },
   "engines": {
-    "node": ">=18.18.2",
+    "node": ">=20.11.0",
     "bun": ">=1.0.0"
   },
   "repository": {
@@ -55,7 +59,8 @@
     "inheritFrom": [
       "arlac77/template-arlac77-github",
       "arlac77/template-browser-ava",
-      "arlac77/template-esm-only",
+      "arlac77/template-javascript-component",
+      "arlac77/template-node-component",
       "arlac77/template-typescript"
     ]
   }

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/utils/convert-uti.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import wellKnown from "../src/well-known-utis.mjs";
+
+function asArray(object) {
+  return Array.isArray(object) ? object : object === undefined ? [] : [object];
+}
+
+function asScalar(object) {
+  if (object !== undefined && object?.size > 0) {
+    if (object.size === 1) {
+      for (const o of object) {
+        return o;
+      }
+    }
+    return [...object];
+  }
+}
+
+const lsregister = spawn(
+  "/System/Library/Frameworks/CoreServices.framework/Frameworks/LaunchServices.framework/Versions/A/Support/lsregister",
+  ["-dump"]
+);
+
+let name, conformsTo, tags;
+
+for await (const line of lineIterator(lsregister.stdout)) {
+  let m = line.match(/^([^:]+):\s+(.+)/);
+  if (m) {
+    switch (m[1]) {
+      case "uti":
+        name = m[2];
+        break;
+      case "conforms to":
+        conformsTo = m[2].split(/\s*,\s*/);
+        break;
+      case "tags":
+        tags = m[2].split(/\s*,\s*/);
+        break;
+    }
+  }
+
+  if (name && line.match(/^-/)) {
+    const b = wellKnown.find(u => u.name === name);
+    const a = {
+      name,
+      conformsTo: asScalar([...asArray(conformsTo), ...asArray(b?.conformsTo)]),
+      fileNameExtension: asScalar(
+        new Set([
+          ...asArray(tags?.filter(t => t.match(/^\./))),
+          ...asArray(b?.fileNameExtension)
+        ])
+      ),
+      mimeType: asScalar([
+        ...asArray(tags?.filter(t => t.match(/^\w+\//))),
+        ...asArray(b?.mimeType)
+      ])
+    };
+
+    if (b) {
+      for (const p of ["conformsTo", "fileNameExtension", "mimeType"]) {
+        if (Array.isArray(b[p])) {
+          a[p] = b[p];
+        }
+      }
+    } else {
+      wellKnown.push(a);
+    }
+
+    name = undefined;
+    conformsTo = undefined;
+    tags = undefined;
+  }
+}
+
+console.log(JSON.stringify(wellKnown, undefined, 2));
+
+export async function* lineIterator(stream, decoder = new TextDecoder()) {
+  const re = /\r?\n/gm;
+  let chunk = "";
+  let startIndex = 0;
+
+  for await (const value of stream) {
+    chunk += decoder.decode(value);
+    while (true) {
+      const result = re.exec(chunk);
+      if (result) {
+        yield chunk.substring(startIndex, result.index);
+        startIndex = re.lastIndex;
+      } else {
+        chunk = chunk.substring(startIndex);
+        startIndex = re.lastIndex = 0;
+        break;
+      }
+    }
+  }
+
+  if (startIndex < chunk.length) {
+    yield chunk;
+  }
+}