@domicile-desktop/system-apps 0.0.0-alpha-59d60d9540df → 0.0.0-alpha-75f1c331c3ad

package/README.md

@@ -2,7 +2,8 @@
 
 Installed applications and bookmarks for a shell's launcher, read through
 [`@domicile-desktop/sdk/system`](../chrome-sdk/README.md). Manganese's launcher
-uses it (`src/launcher/app-search.ts`).
+uses it (`src/launcher/app-search.ts`), and the component library's portal
+dialogs name applications with it.
 
 ## Usage
 
@@ -28,6 +29,7 @@ const editors = findApps(apps, "edit", 50);
 | `./installed` | Every desktop entry under them; an earlier directory hides a later one's ID. |
 | `./desktop-entry` | One entry parsed: name, comment, argv, icon and `X-Domicile-Preview`. |
 | `./find-apps`, `./bookmark` | The launcher's matching and ranking; bookmarks and their Zod schema. |
+| `./describe-apps` | Application IDs named and drawn by their entries, for a shell to say who asks. |
 | `./mime-apps` | A content type's default applications from every `mimeapps.list`, the desktop's own (`domicile-mimeapps.list`) first. |
 | `./omit` | Desktop file IDs left out, as globs. |
 | `./app-icons` | Icon names resolved in `hicolor` and `pixmaps` to `data:` URLs (PNG, SVG, 128 KiB at most). |

package/package.json

@@ -1,7 +1,7 @@
 {
   "dependencies": {
     "@cprussin/option-result": "^2.0.1",
-    "@domicile-desktop/sdk": "0.0.0-alpha-59d60d9540df",
+    "@domicile-desktop/sdk": "0.0.0-alpha-75f1c331c3ad",
     "zod": "^4.5.4"
   },
   "description": "Installed applications and bookmarks for a Domicile shell's launcher, read through @domicile-desktop/sdk/system.",
@@ -16,6 +16,7 @@
     "./bookmark": "./src/bookmark.ts",
     "./curl": "./src/curl.ts",
     "./data-dirs": "./src/data-dirs.ts",
+    "./describe-apps": "./src/describe-apps.ts",
     "./desktop-entry": "./src/desktop-entry.ts",
     "./fake-system": "./src/fake-system.ts",
     "./favicon": "./src/favicon.ts",
@@ -46,5 +47,5 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-59d60d9540df"
+  "version": "0.0.0-alpha-75f1c331c3ad"
 }

package/src/describe-apps.ts

@@ -0,0 +1,60 @@
+// Applications named and drawn by their desktop entries, for a shell to show
+// who asks for something.
+
+import type { Option } from "@cprussin/option-result";
+import { None, Ok, Result } from "@cprussin/option-result";
+import type { System, SystemError } from "@domicile-desktop/sdk/system";
+
+import type { IconLookup } from "./app-icons";
+import { appIcons } from "./app-icons";
+import { dataDirs } from "./data-dirs";
+import type { DesktopEntry } from "./desktop-entry";
+import { installedApps } from "./installed";
+
+/** An application, as its desktop entry describes it. */
+export type DescribedApp = {
+  /** Its desktop file ID without `.desktop`, as portals and windows name it. */
+  id: string;
+  /** Its entry's `Name`, or `id` when it has no entry. */
+  name: string;
+  /** A `data:` URL, or `undefined` for none. */
+  icon: string | undefined;
+};
+
+/** Each of `ids`, in order, described by its installed desktop entry. */
+export const describeApps = async (
+  system: System,
+  ids: readonly string[],
+): Promise<Result<DescribedApp[], SystemError>> =>
+  (await dataDirs(system)).andThenAsync(async (dirs) => {
+    const icons = appIcons(system, dirs);
+    return (await installedApps(system, dirs)).andThenAsync(
+      async (installed) => {
+        const entries = new Map(
+          installed.map((entry) => [entry.id.replace(/\.desktop$/, ""), entry]),
+        );
+        return Result.collect(
+          await Promise.all(
+            ids.map((id) => described(icons, id, entries.get(id))),
+          ),
+        );
+      },
+    );
+  });
+
+/** App `id`, named and drawn by its `entry` when it has one. */
+const described = async (
+  icons: IconLookup,
+  id: string,
+  entry: DesktopEntry | undefined,
+): Promise<Result<DescribedApp, SystemError>> =>
+  entry === undefined
+    ? Ok({ icon: undefined, id, name: id })
+    : (entry.icon === undefined
+        ? Ok<Option<string>, SystemError>(None())
+        : await icons(entry.icon)
+      ).map((icon) => ({
+        icon: icon.match({ None: () => undefined, Some: (url) => url }),
+        id,
+        name: entry.name,
+      }));