@liminal-hq/plugin-desktop-integration 0.1.0 → 0.3.0

package/README.md

@@ -64,6 +64,12 @@ confirmation dialog. Call `set_shortcut_window(&window)` once your first window
 shown to kick off the deferred binding, and listen for the `shortcut-binding-result`
 event to know when it resolves.
 
+The compositor's own settings UI can also rebind the shortcut independently of the app
+(e.g. GNOME Settings → Apps → <App> → Global Shortcuts) — listen for the
+`shortcut-changed` event (Wayland-only) to keep your own UI in sync.
+`DesktopIntegrationExt::last_shortcut_trigger_description` covers the race where the
+rebind happens before your listener attaches.
+
 ### JavaScript
 
 JS-only apps (no custom Rust command of their own) can register shortcuts directly —
@@ -90,18 +96,65 @@ Rust consumers should prefer calling `DesktopIntegrationExt::register_shortcut`
 from `setup()` — it delivers activation via a real closure instead of an event
 round-trip. The `register_shortcut` command exists specifically for JS-only consumers.
 
+To detect an external rebind (Wayland-only), listen for `shortcut-changed` directly via
+`@tauri-apps/api/event`, and use `checkShortcutTriggerDescription` as a race guard for
+UI that mounts after a missed event:
+
+```typescript
+import { listen } from '@tauri-apps/api/event';
+import {
+	desktopIntegration,
+	type ShortcutChangedPayload,
+} from '@liminal-hq/plugin-desktop-integration';
+
+await listen<ShortcutChangedPayload>('shortcut-changed', ({ payload }) => {
+	console.log(`rebound externally to: ${payload.triggerDescription}`);
+});
+
+const lastKnownTrigger = await desktopIntegration.checkShortcutTriggerDescription();
+```
+
+### Services
+
+Besides window activation and shortcuts, the plugin offers desktop services that are not behind a portal. Use [`@liminal-hq/plugin-xdg-portal`](../xdg-portal) first where the portal exists, and these where it does not (or on Windows). Every service rejects with a `ServiceError`, `{ kind, message }`, where `kind` is one of `unsupported-platform`, `unavailable`, `needs-app-id`, `invalid-argument`, `not-found`, `conflict`, `timeout` or `failed`. D-Bus work runs off the main thread and every call is bounded by a 5 second timeout.
+
+`getStatus()` reports, per feature (`notify`, `notificationActions`, `inhibitSleep`, `launcherProgress`, `fileManager`, `globalShortcuts`), whether it works here and, if not, a typed `reason` (`platform-unsupported`, `no-session-bus`, `no-notification-server`, `no-logind`, `needs-app-id`, `no-display-server`, `actions-unsupported`) with the `detail` behind it. Hide options whose feature is unavailable.
+
+- **Notifications:** `notify({ id, title, body, defaultAction, urgency })` shows a notification and replaces the one with the same `id`; `withdrawNotification(id)` closes it; `onNotificationAction` reports a click on it as `{ id, action }`. On Linux it calls `org.freedesktop.Notifications` and sets the `desktop-entry` hint from `desktopId` (default: the bundle identifier). Add up to three buttons with `actions: [{ id, label }]` (ids are 1 to 256 bytes, unique, not `default` and different from `defaultAction`; labels are 1 to 100 characters; further buttons are dropped with a log line): they go to the `actions` array of `Notify` after the `default` key that `defaultAction` adds, and a press arrives through `onNotificationAction` as `{ id, action }` with the button's id. Signals for notifications this plugin did not send are ignored. The `notificationActions` feature is available when the server lists the `actions` capability; some servers show only the default click, and `detail` says so. On Windows it shows a WinRT toast, which needs an AppUserModelID: set one with `setAppUserModelId(id)` (or `SetCurrentProcessExplicitAppUserModelID` yourself) and until then `notify` rejects with `needs-app-id`.
+- **Sleep inhibit:** `inhibitSleep({ reason, kinds })` returns a `handle` for `releaseSleepInhibit`. On Linux it takes a blocking `sleep` (and, with the `idle` kind, `idle`) inhibitor from systemd-logind and holds its file descriptor; on Windows it holds a `PowerCreateRequest` for `PowerRequestSystemRequired`. Inhibitors end when released or when the app exits.
+- **Launcher progress:** `setLauncherProgress({ progress, count, desktopId, windowLabel })` shows `{ state: 'value', value }` (0 to 1), `{ state: 'indeterminate' }` or `{ state: 'cleared' }`. On Linux it emits the `com.canonical.Unity.LauncherEntry` `Update` signal (`progress`, `progress-visible`, `count`, `count-visible`) for `application://<desktopId>.desktop`; docks have no indeterminate state, so it shows an empty bar, and the signal is a broadcast that succeeds whether or not a dock listens. On Windows it sets `ITaskbarList3` progress on the button of `windowLabel` (default: the focused window, else the first label starting with `main`, else the first label in alphabetical order).
+- **File manager (Linux):** `ownFileManager()` takes `org.freedesktop.FileManager1` and serves `ShowFolders`, `ShowItems` and `ShowItemProperties`; each call arrives through `onFileManagerCall` as `{ method, targets, startupId }`, where each target has the URI and, for `file:` URIs on this machine, the decoded local `path`. A call with no usable URI is refused. Another process can take the name over (the app allows replacement); `onFileManagerOwnership` then reports `owned: false` (only for the ownership that lost the name, so giving the name back and taking it again is not undone by a late loss). `ownFileManager` rejects with `conflict` when another process holds the name and will not give it up, and `disownFileManager()` gives it back. Ship a D-Bus activation file for the name if the app should be started by other applications' calls.
+- **Windows global shortcuts:** `registerGlobalShortcut({ id, accelerator })` registers `RegisterHotKey` on a message-only window thread (an accelerator such as `Ctrl+Alt+K` with at least one modifier) and `onShortcutPressed` reports `{ id }`; `unregisterGlobalShortcut(id)` removes it. Registering an id again replaces its accelerator (the same accelerator included); a combination another application holds rejects with `conflict`, and the earlier binding of that id then stays. A call that rejects with `timeout` did not take effect and can be retried. On Linux use `registerShortcut`.
+
+```typescript
+import { desktopIntegration, isFeatureAvailable } from '@liminal-hq/plugin-desktop-integration';
+
+const status = await desktopIntegration.getStatus();
+if (isFeatureAvailable(status, 'launcherProgress')) {
+	await desktopIntegration.setLauncherProgress({
+		progress: { state: 'value', value: 0.4 },
+		count: 2,
+		desktopId: null,
+		windowLabel: null,
+	});
+}
+```
+
+From Rust, `app.desktop_services()` (the `DesktopServicesExt` trait) offers the same calls as async methods: `status`, `notify`, `withdraw_notification`, `inhibit_sleep`, `release_sleep_inhibit`, `set_launcher_progress`, `own_file_manager`, `disown_file_manager`, `register_global_shortcut`, `unregister_global_shortcut` and `set_app_user_model_id`. Events are emitted to every window, and Rust code can `listen` to them too.
+
 ### Generated types
 
-`ShortcutBindingResult` and `ShortcutActivatedPayload` (the payloads of the
-`shortcut-binding-result` and `shortcut-activated` events) are generated from their Rust
-definitions via [`ts-rs`](https://github.com/Aleph-Alpha/ts-rs) into
-`guest-js/bindings/` and re-exported from the package root, so the JS/Rust shapes can't
-drift:
+`ShortcutBindingResult`, `ShortcutActivatedPayload`, and `ShortcutChangedPayload` (the
+payloads of the `shortcut-binding-result`, `shortcut-activated`, and `shortcut-changed`
+events) are generated from their Rust definitions via
+[`ts-rs`](https://github.com/Aleph-Alpha/ts-rs) into `guest-js/bindings/` and re-exported
+from the package root, so the JS/Rust shapes can't drift:
 
 ```typescript
 import type {
 	ShortcutActivatedPayload,
 	ShortcutBindingResult,
+	ShortcutChangedPayload,
 } from '@liminal-hq/plugin-desktop-integration';
 ```
 
@@ -116,16 +169,34 @@ This plugin requires these permissions:
 - `allow-register-shortcut`: Grants access to `register_shortcut`
 - `allow-check-shortcut-binding-complete`: Grants access to `check_shortcut_binding_complete`
 - `allow-check-shortcut-binding-error`: Grants access to `check_shortcut_binding_error`
+- `allow-check-shortcut-trigger-description`: Grants access to `check_shortcut_trigger_description`
+- `allow-get-status`: Grants access to `get_status`
+- `allow-notify`: Grants access to `notify`
+- `allow-withdraw-notification`: Grants access to `withdraw_notification`
+- `allow-set-app-user-model-id`: Grants access to `set_app_user_model_id`
+- `allow-inhibit-sleep`: Grants access to `inhibit_sleep`
+- `allow-release-sleep-inhibit`: Grants access to `release_sleep_inhibit`
+- `allow-set-launcher-progress`: Grants access to `set_launcher_progress`
+- `allow-own-file-manager`: Grants access to `own_file_manager`
+- `allow-disown-file-manager`: Grants access to `disown_file_manager`
+- `allow-register-global-shortcut`: Grants access to `register_global_shortcut`
+- `allow-unregister-global-shortcut`: Grants access to `unregister_global_shortcut`
+
+The `default` set grants the four shortcut commands and the read-only `get_status`; grant the rest explicitly.
 
 ## Platform Support
 
-| Platform | Support Level | Notes                                                         |
-| -------- | ------------- | ------------------------------------------------------------- |
-| Windows  | None          | X11/Wayland activation helpers only                           |
-| Linux    | Full          | X11 activation via `gdkx11`, Wayland shortcuts via the portal |
-| macOS    | None          | X11/Wayland activation helpers only                           |
-| Android  | None          | X11/Wayland activation helpers only                           |
-| iOS      | None          | X11/Wayland activation helpers only                           |
+| Platform | Support Level | Notes                                                                                                                                                              |
+| -------- | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| Windows  | Partial       | Toasts (with an AppUserModelID), sleep inhibit, taskbar progress and `RegisterHotKey` shortcuts; type-checked for `x86_64-pc-windows-msvc`, not yet run on Windows |
+| Linux    | Full          | X11 activation via `gdkx11`, Wayland shortcuts via the portal, notifications, logind sleep inhibit, launcher progress and `FileManager1` over zbus                 |
+| macOS    | None          | Every service reports `platform-unsupported`                                                                                                                       |
+| Android  | None          | Every service reports `platform-unsupported`                                                                                                                       |
+| iOS      | None          | Every service reports `platform-unsupported`                                                                                                                       |
+
+## Testing
+
+`cargo test -p tauri-plugin-desktop-integration` runs the headless tests (message and payload construction, id and handle bookkeeping, `FileManager1` URI parsing, accelerator parsing, status mapping). The `#[ignore]`d `live_*` tests touch the real session and are run by hand on a Linux desktop: `live_status` (read-only), `live_inhibit` (holds a logind inhibitor for 8 seconds; `systemd-inhibit --list` shows it), `live_launcher_entry` (emits three `Update` signals that `dbus-monitor "interface=com.canonical.Unity.LauncherEntry"` shows), `live_file_manager` and `live_file_manager_name_lost_and_taken` (briefly own `org.freedesktop.FileManager1`; run with `--test-threads=1`) and `live_notify` (shows one real notification).
 
 ## Licence
 

package/api-iife.js

@@ -6,6 +6,32 @@ var __TAURI_PLUGIN_DESKTOP_INTEGRATION__ = (function (exports, core, event) {
     //
     // (c) Copyright 2026 Liminal HQ, Scott Morris
     // SPDX-License-Identifier: Apache-2.0 OR MIT
+    /**
+     * Event emitted when the user clicks a notification shown through `notify` or presses one of its
+     * action buttons; the payload is `{ id, action }`.
+     */
+    const NOTIFICATION_ACTION_EVENT = 'desktop-integration://notification-action';
+    /** Event emitted for each `org.freedesktop.FileManager1` call another application makes. */
+    const FILE_MANAGER_CALL_EVENT = 'desktop-integration://file-manager';
+    /** Event emitted when the app gains or loses the `org.freedesktop.FileManager1` name. */
+    const FILE_MANAGER_OWNERSHIP_EVENT = 'desktop-integration://file-manager-ownership';
+    /** Event emitted when a Windows global shortcut is pressed. */
+    const SHORTCUT_PRESSED_EVENT = 'desktop-integration://shortcut-pressed';
+    /** Whether a rejection from one of the service commands is a {@link ServiceError}. */
+    function isServiceError(error) {
+        return (typeof error === 'object' &&
+            error !== null &&
+            typeof error.kind === 'string' &&
+            typeof error.message === 'string');
+    }
+    /** The status of one feature, or `undefined` when the plugin did not report it. */
+    function featureStatus(status, feature) {
+        return status.features.find((entry) => entry.feature === feature);
+    }
+    /** Whether a feature is available; the way to decide whether to show the option that needs it. */
+    function isFeatureAvailable(status, feature) {
+        return featureStatus(status, feature)?.available === true;
+    }
     const PREFIX = 'plugin:desktop-integration|';
     function cmd(name, args) {
         return core.invoke(`${PREFIX}${name}`, args);
@@ -19,7 +45,60 @@ var __TAURI_PLUGIN_DESKTOP_INTEGRATION__ = (function (exports, core, event) {
             activationCallback?.();
         });
     }
+    function on(event$1, callback) {
+        return event.listen(event$1, (e) => callback(e.payload));
+    }
     const desktopIntegration = {
+        /** Which services work on this system, with a reason for each that does not. */
+        getStatus: () => cmd('get_status'),
+        /**
+         * Shows a desktop notification outside the portal, or replaces the one with the same `id`.
+         * Windows needs an AppUserModelID (see {@link desktopIntegration.setAppUserModelId}); without
+         * one this rejects with kind `needs-app-id`.
+         */
+        notify: (request) => cmd('notify', { request }),
+        /** Takes a notification shown through `notify` off screen. */
+        withdrawNotification: (id) => cmd('withdraw_notification', { id }),
+        /** Sets the AppUserModelID of the process, which Windows toasts need. Windows only. */
+        setAppUserModelId: (id) => cmd('set_app_user_model_id', { id }),
+        /**
+         * Keeps the machine from sleeping (or idling, on Linux) until
+         * {@link desktopIntegration.releaseSleepInhibit} is called with the returned handle or the app
+         * exits.
+         */
+        inhibitSleep: (request) => cmd('inhibit_sleep', { request }),
+        /** Ends an inhibitor taken with {@link desktopIntegration.inhibitSleep}. */
+        releaseSleepInhibit: (handle) => cmd('release_sleep_inhibit', { handle }),
+        /**
+         * Shows one combined progress value (0 to 1), an indeterminate state or nothing on the app's
+         * dock or taskbar entry, with an optional badge count (Linux).
+         */
+        setLauncherProgress: (request) => cmd('set_launcher_progress', { request }),
+        /**
+         * Takes the `org.freedesktop.FileManager1` name so other applications' "Show in folder" reaches
+         * this app as {@link FILE_MANAGER_CALL_EVENT} events. Linux only.
+         */
+        ownFileManager: () => cmd('own_file_manager'),
+        /** Gives the `org.freedesktop.FileManager1` name back. */
+        disownFileManager: () => cmd('disown_file_manager'),
+        /**
+         * Registers a global shortcut with `RegisterHotKey`; {@link desktopIntegration.onShortcutPressed}
+         * reports presses. Registering an id again replaces its accelerator, the same one included; if
+         * the new accelerator is refused, the earlier binding stays. A call that rejects with
+         * `timeout` did not take effect. Windows only; Linux uses
+         * {@link desktopIntegration.registerShortcut}.
+         */
+        registerGlobalShortcut: (request) => cmd('register_global_shortcut', { request }),
+        /** Removes a shortcut registered with {@link desktopIntegration.registerGlobalShortcut}. */
+        unregisterGlobalShortcut: (id) => cmd('unregister_global_shortcut', { id }),
+        /** Subscribes to notification clicks and button presses; resolves to a function that unsubscribes. */
+        onNotificationAction: (callback) => on(NOTIFICATION_ACTION_EVENT, callback),
+        /** Subscribes to `FileManager1` calls from other applications. */
+        onFileManagerCall: (callback) => on(FILE_MANAGER_CALL_EVENT, callback),
+        /** Subscribes to the app losing the `FileManager1` name to another file manager. */
+        onFileManagerOwnership: (callback) => on(FILE_MANAGER_OWNERSHIP_EVENT, callback),
+        /** Subscribes to presses of Windows global shortcuts. */
+        onShortcutPressed: (callback) => on(SHORTCUT_PRESSED_EVENT, callback),
         /**
          * Registers a global shortcut. On X11 it's bound immediately; on Wayland,
          * binding is deferred until the compositor confirms it — see
@@ -49,9 +128,24 @@ var __TAURI_PLUGIN_DESKTOP_INTEGRATION__ = (function (exports, core, event) {
          * shortcut-binding-result listener — complements checkShortcutBindingComplete.
          */
         checkShortcutBindingError: () => cmd('check_shortcut_binding_error'),
+        /**
+         * Returns the trigger description (e.g. "Super+E") from the most recent
+         * shortcut-changed event, or null if the shortcut hasn't been externally
+         * rebound yet this session. Use this to hydrate UI that mounts after a missed
+         * event — listen for the `shortcut-changed` event directly via
+         * `@tauri-apps/api/event`'s `listen()` for live updates.
+         */
+        checkShortcutTriggerDescription: () => cmd('check_shortcut_trigger_description'),
     };
 
+    exports.FILE_MANAGER_CALL_EVENT = FILE_MANAGER_CALL_EVENT;
+    exports.FILE_MANAGER_OWNERSHIP_EVENT = FILE_MANAGER_OWNERSHIP_EVENT;
+    exports.NOTIFICATION_ACTION_EVENT = NOTIFICATION_ACTION_EVENT;
+    exports.SHORTCUT_PRESSED_EVENT = SHORTCUT_PRESSED_EVENT;
     exports.desktopIntegration = desktopIntegration;
+    exports.featureStatus = featureStatus;
+    exports.isFeatureAvailable = isFeatureAvailable;
+    exports.isServiceError = isServiceError;
 
     return exports;
 

package/dist-js/bindings/ActionButton.d.ts

@@ -0,0 +1,14 @@
+/**
+ * One action button on a notification.
+ */
+export type ActionButton = {
+    /**
+     * Reported as the event's `action` when the button is pressed.
+     */
+    id: string;
+    /**
+     * The text on the button.
+     */
+    label: string;
+};
+//# sourceMappingURL=ActionButton.d.ts.map

package/dist-js/bindings/ActionButton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ActionButton.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/ActionButton.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAC3B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/Feature.d.ts

@@ -0,0 +1,5 @@
+/**
+ * A feature the plugin can offer, as reported by `get_status`.
+ */
+export type Feature = "notify" | "notificationActions" | "inhibitSleep" | "launcherProgress" | "fileManager" | "globalShortcuts";
+//# sourceMappingURL=Feature.d.ts.map

package/dist-js/bindings/Feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Feature.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/Feature.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,QAAQ,GAAG,qBAAqB,GAAG,cAAc,GAAG,kBAAkB,GAAG,aAAa,GAAG,iBAAiB,CAAC"}

package/dist-js/bindings/FeatureStatus.d.ts

@@ -0,0 +1,18 @@
+import type { Feature } from "./Feature";
+import type { UnavailableReason } from "./UnavailableReason";
+/**
+ * Whether one feature works on this system.
+ */
+export type FeatureStatus = {
+    feature: Feature;
+    available: boolean;
+    /**
+     * Why the feature is unavailable; absent when it works.
+     */
+    reason: UnavailableReason | null;
+    /**
+     * The error text behind the reason, for logs and the Services panel.
+     */
+    detail: string | null;
+};
+//# sourceMappingURL=FeatureStatus.d.ts.map

package/dist-js/bindings/FeatureStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FeatureStatus.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/FeatureStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IACnE;;OAEG;IACH,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist-js/bindings/FileManagerCall.d.ts

@@ -0,0 +1,14 @@
+import type { FileManagerMethod } from "./FileManagerMethod";
+import type { FileManagerTarget } from "./FileManagerTarget";
+/**
+ * Payload of the `desktop-integration://file-manager` event.
+ */
+export type FileManagerCall = {
+    method: FileManagerMethod;
+    targets: Array<FileManagerTarget>;
+    /**
+     * The caller's startup id, for focus-stealing prevention; often empty.
+     */
+    startupId: string;
+};
+//# sourceMappingURL=FileManagerCall.d.ts.map

package/dist-js/bindings/FileManagerCall.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileManagerCall.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/FileManagerCall.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC,iBAAiB,CAAC,CAAC;IAC7F;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/FileManagerMethod.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The `org.freedesktop.FileManager1` method another application called.
+ */
+export type FileManagerMethod = "show-folders" | "show-items" | "show-item-properties";
+//# sourceMappingURL=FileManagerMethod.d.ts.map

package/dist-js/bindings/FileManagerMethod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileManagerMethod.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/FileManagerMethod.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,YAAY,GAAG,sBAAsB,CAAC"}

package/dist-js/bindings/FileManagerOwnership.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Whether this process owns `org.freedesktop.FileManager1`.
+ *
+ * This is the return value of `own_file_manager` and `disown_file_manager` and the payload of the
+ * `desktop-integration://file-manager-ownership` event, which also reports a name taken away.
+ */
+export type FileManagerOwnership = {
+    owned: boolean;
+    /**
+     * Why the name is not owned, when it was lost or could not be taken.
+     */
+    reason: string | null;
+};
+//# sourceMappingURL=FileManagerOwnership.d.ts.map

package/dist-js/bindings/FileManagerOwnership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileManagerOwnership.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/FileManagerOwnership.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IACpD;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist-js/bindings/FileManagerTarget.d.ts

@@ -0,0 +1,14 @@
+/**
+ * One URI from a `FileManager1` call.
+ */
+export type FileManagerTarget = {
+    /**
+     * The URI as the caller sent it.
+     */
+    uri: string;
+    /**
+     * The local path, percent-decoded, when the URI is a `file:` URI for this machine.
+     */
+    path: string | null;
+};
+//# sourceMappingURL=FileManagerTarget.d.ts.map

package/dist-js/bindings/FileManagerTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FileManagerTarget.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/FileManagerTarget.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAChC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IACZ;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist-js/bindings/GlobalShortcutPressed.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Payload of the `desktop-integration://shortcut-pressed` event.
+ */
+export type GlobalShortcutPressed = {
+    id: string;
+};
+//# sourceMappingURL=GlobalShortcutPressed.d.ts.map

package/dist-js/bindings/GlobalShortcutPressed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalShortcutPressed.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/GlobalShortcutPressed.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/GlobalShortcutRequest.d.ts

@@ -0,0 +1,14 @@
+/**
+ * A global shortcut to register on Windows.
+ */
+export type GlobalShortcutRequest = {
+    /**
+     * The caller's id for the shortcut, reported by the `pressed` event.
+     */
+    id: string;
+    /**
+     * A Tauri-style accelerator such as `Ctrl+Alt+K`.
+     */
+    accelerator: string;
+};
+//# sourceMappingURL=GlobalShortcutRequest.d.ts.map

package/dist-js/bindings/GlobalShortcutRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalShortcutRequest.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/GlobalShortcutRequest.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IACpC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/LauncherProgress.d.ts

@@ -0,0 +1,12 @@
+/**
+ * What the launcher or taskbar icon shows.
+ */
+export type LauncherProgress = {
+    "state": "value";
+    value: number;
+} | {
+    "state": "indeterminate";
+} | {
+    "state": "cleared";
+};
+//# sourceMappingURL=LauncherProgress.d.ts.map

package/dist-js/bindings/LauncherProgress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LauncherProgress.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/LauncherProgress.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE,GAAG;IAAE,OAAO,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC"}

package/dist-js/bindings/LauncherRequest.d.ts

@@ -0,0 +1,23 @@
+import type { LauncherProgress } from "./LauncherProgress";
+/**
+ * Progress and count for the app's dock or taskbar entry.
+ */
+export type LauncherRequest = {
+    progress: LauncherProgress;
+    /**
+     * A badge count, such as the number of running jobs; zero hides it. Absent leaves it alone.
+     * Linux only.
+     */
+    count: number | null;
+    /**
+     * The `.desktop` file id the dock matches the signal to; defaults to the bundle identifier.
+     * Linux only.
+     */
+    desktopId: string | null;
+    /**
+     * The window whose taskbar button shows the progress. Windows only; defaults to the focused
+     * window, else the first window whose label starts with `main`, else the first label in alphabetical order.
+     */
+    windowLabel: string | null;
+};
+//# sourceMappingURL=LauncherRequest.d.ts.map

package/dist-js/bindings/LauncherRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LauncherRequest.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/LauncherRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,gBAAgB,CAAC;IAC3D;;;OAGG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAAE,CAAC"}

package/dist-js/bindings/NotificationAction.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Payload of the `desktop-integration://notification-action` event.
+ */
+export type NotificationAction = {
+    /**
+     * The id of the notification the user acted on.
+     */
+    id: string;
+    /**
+     * The request's `defaultAction` for a click on the notification, or the `id` of the button
+     * that was pressed.
+     */
+    action: string;
+};
+//# sourceMappingURL=NotificationAction.d.ts.map

package/dist-js/bindings/NotificationAction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotificationAction.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/NotificationAction.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IACjC;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IACX;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/NotifyRequest.d.ts

@@ -0,0 +1,37 @@
+import type { ActionButton } from "./ActionButton";
+import type { Urgency } from "./Urgency";
+/**
+ * A desktop notification to show or replace.
+ */
+export type NotifyRequest = {
+    /**
+     * The caller's id. Sending the same id again replaces the shown notification.
+     */
+    id: string;
+    title: string;
+    body: string | null;
+    /**
+     * The action id reported through the `notification-action` event when the user clicks the
+     * notification itself.
+     */
+    defaultAction: string | null;
+    urgency: Urgency | null;
+    /**
+     * The application name the shell shows; defaults to the package name.
+     */
+    appName: string | null;
+    /**
+     * The `.desktop` file id of the app, so the shell can group and style the notification;
+     * defaults to the bundle identifier.
+     */
+    desktopId: string | null;
+    /**
+     * Buttons to show on the notification, in order. At most 3 are shown; extras are dropped.
+     * A press is reported through the `notification-action` event with the button's `id`
+     * (`default` is reserved for the click on the notification, and an id must differ from
+     * `defaultAction` so the two can be told apart). Servers that do not draw
+     * buttons (see the `notificationActions` feature) show only the default click.
+     */
+    actions?: Array<ActionButton>;
+};
+//# sourceMappingURL=NotifyRequest.d.ts.map

package/dist-js/bindings/NotifyRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NotifyRequest.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/NotifyRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC5B;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/C;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACtD;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;OAGG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;CAAE,CAAC"}

package/dist-js/bindings/PluginStatus.d.ts

@@ -0,0 +1,21 @@
+import type { FeatureStatus } from "./FeatureStatus";
+import type { UnavailableReason } from "./UnavailableReason";
+/**
+ * What the plugin can do on the running system.
+ */
+export type PluginStatus = {
+    /**
+     * True when at least one feature is available.
+     */
+    available: boolean;
+    /**
+     * Why nothing is available; absent otherwise.
+     */
+    reason: UnavailableReason | null;
+    features: Array<FeatureStatus>;
+    /**
+     * Whether this process currently owns `org.freedesktop.FileManager1`.
+     */
+    fileManagerOwned: boolean;
+};
+//# sourceMappingURL=PluginStatus.d.ts.map

package/dist-js/bindings/PluginStatus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginStatus.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/PluginStatus.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAC3B;;OAEG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC;IACjE;;OAEG;IACH,gBAAgB,EAAE,OAAO,CAAC;CAAE,CAAC"}

package/dist-js/bindings/ServiceError.d.ts

@@ -0,0 +1,9 @@
+import type { ServiceErrorKind } from "./ServiceErrorKind";
+/**
+ * The error of every service command: a `kind` to branch on and a `message` for logs.
+ */
+export type ServiceError = {
+    kind: ServiceErrorKind;
+    message: string;
+};
+//# sourceMappingURL=ServiceError.d.ts.map

package/dist-js/bindings/ServiceError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceError.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/ServiceError.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/ServiceErrorKind.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Why a service command failed, as a value a caller can branch on.
+ */
+export type ServiceErrorKind = "unsupported-platform" | "unavailable" | "needs-app-id" | "invalid-argument" | "not-found" | "conflict" | "timeout" | "failed";
+//# sourceMappingURL=ServiceErrorKind.d.ts.map

package/dist-js/bindings/ServiceErrorKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceErrorKind.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/ServiceErrorKind.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,sBAAsB,GAAG,aAAa,GAAG,cAAc,GAAG,kBAAkB,GAAG,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC"}

package/dist-js/bindings/ShortcutChangedPayload.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Payload emitted on the `shortcut-changed` event, fired when the user rebinds the
+ * shortcut through the compositor's own settings UI (e.g. GNOME Settings → Apps →
+ * <App> → Global Shortcuts) rather than through this app. Wayland-only — X11 direct
+ * grabs have no equivalent out-of-band rebind path, so this never fires there.
+ */
+export type ShortcutChangedPayload = {
+    sessionId: string;
+    triggerDescription: string;
+};
+//# sourceMappingURL=ShortcutChangedPayload.d.ts.map

package/dist-js/bindings/ShortcutChangedPayload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShortcutChangedPayload.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/ShortcutChangedPayload.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,sBAAsB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/SleepInhibitHandle.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The handle of a live sleep inhibitor, to give back to `release_sleep_inhibit`.
+ */
+export type SleepInhibitHandle = {
+    handle: number;
+};
+//# sourceMappingURL=SleepInhibitHandle.d.ts.map

package/dist-js/bindings/SleepInhibitHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepInhibitHandle.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/SleepInhibitHandle.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;CAAE,CAAC"}

package/dist-js/bindings/SleepInhibitRequest.d.ts

@@ -0,0 +1,15 @@
+import type { SleepKind } from "./SleepKind";
+/**
+ * A request to keep the machine awake.
+ */
+export type SleepInhibitRequest = {
+    /**
+     * What the user is told the app is doing, such as "Copying 3 files".
+     */
+    reason: string;
+    /**
+     * What to inhibit; empty means sleep only.
+     */
+    kinds: Array<SleepKind>;
+};
+//# sourceMappingURL=SleepInhibitRequest.d.ts.map

package/dist-js/bindings/SleepInhibitRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepInhibitRequest.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/SleepInhibitRequest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;CAAE,CAAC"}

package/dist-js/bindings/SleepKind.d.ts

@@ -0,0 +1,5 @@
+/**
+ * What to keep the machine from doing.
+ */
+export type SleepKind = "sleep" | "idle";
+//# sourceMappingURL=SleepKind.d.ts.map

package/dist-js/bindings/SleepKind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepKind.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/SleepKind.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC"}

package/dist-js/bindings/UnavailableReason.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Why a feature is not available.
+ */
+export type UnavailableReason = "platform-unsupported" | "no-session-bus" | "no-notification-server" | "no-logind" | "needs-app-id" | "no-display-server" | "actions-unsupported";
+//# sourceMappingURL=UnavailableReason.d.ts.map

package/dist-js/bindings/UnavailableReason.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UnavailableReason.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/UnavailableReason.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,sBAAsB,GAAG,gBAAgB,GAAG,wBAAwB,GAAG,WAAW,GAAG,cAAc,GAAG,mBAAmB,GAAG,qBAAqB,CAAC"}

package/dist-js/bindings/Urgency.d.ts

@@ -0,0 +1,5 @@
+/**
+ * How urgent a notification is.
+ */
+export type Urgency = "low" | "normal" | "critical";
+//# sourceMappingURL=Urgency.d.ts.map

package/dist-js/bindings/Urgency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Urgency.d.ts","sourceRoot":"","sources":["../../guest-js/bindings/Urgency.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,UAAU,CAAC"}

package/dist-js/index.cjs

@@ -7,6 +7,32 @@ var event = require('@tauri-apps/api/event');
 //
 // (c) Copyright 2026 Liminal HQ, Scott Morris
 // SPDX-License-Identifier: Apache-2.0 OR MIT
+/**
+ * Event emitted when the user clicks a notification shown through `notify` or presses one of its
+ * action buttons; the payload is `{ id, action }`.
+ */
+const NOTIFICATION_ACTION_EVENT = 'desktop-integration://notification-action';
+/** Event emitted for each `org.freedesktop.FileManager1` call another application makes. */
+const FILE_MANAGER_CALL_EVENT = 'desktop-integration://file-manager';
+/** Event emitted when the app gains or loses the `org.freedesktop.FileManager1` name. */
+const FILE_MANAGER_OWNERSHIP_EVENT = 'desktop-integration://file-manager-ownership';
+/** Event emitted when a Windows global shortcut is pressed. */
+const SHORTCUT_PRESSED_EVENT = 'desktop-integration://shortcut-pressed';
+/** Whether a rejection from one of the service commands is a {@link ServiceError}. */
+function isServiceError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        typeof error.kind === 'string' &&
+        typeof error.message === 'string');
+}
+/** The status of one feature, or `undefined` when the plugin did not report it. */
+function featureStatus(status, feature) {
+    return status.features.find((entry) => entry.feature === feature);
+}
+/** Whether a feature is available; the way to decide whether to show the option that needs it. */
+function isFeatureAvailable(status, feature) {
+    return featureStatus(status, feature)?.available === true;
+}
 const PREFIX = 'plugin:desktop-integration|';
 function cmd(name, args) {
     return core.invoke(`${PREFIX}${name}`, args);
@@ -20,7 +46,60 @@ function ensureActivationListener() {
         activationCallback?.();
     });
 }
+function on(event$1, callback) {
+    return event.listen(event$1, (e) => callback(e.payload));
+}
 const desktopIntegration = {
+    /** Which services work on this system, with a reason for each that does not. */
+    getStatus: () => cmd('get_status'),
+    /**
+     * Shows a desktop notification outside the portal, or replaces the one with the same `id`.
+     * Windows needs an AppUserModelID (see {@link desktopIntegration.setAppUserModelId}); without
+     * one this rejects with kind `needs-app-id`.
+     */
+    notify: (request) => cmd('notify', { request }),
+    /** Takes a notification shown through `notify` off screen. */
+    withdrawNotification: (id) => cmd('withdraw_notification', { id }),
+    /** Sets the AppUserModelID of the process, which Windows toasts need. Windows only. */
+    setAppUserModelId: (id) => cmd('set_app_user_model_id', { id }),
+    /**
+     * Keeps the machine from sleeping (or idling, on Linux) until
+     * {@link desktopIntegration.releaseSleepInhibit} is called with the returned handle or the app
+     * exits.
+     */
+    inhibitSleep: (request) => cmd('inhibit_sleep', { request }),
+    /** Ends an inhibitor taken with {@link desktopIntegration.inhibitSleep}. */
+    releaseSleepInhibit: (handle) => cmd('release_sleep_inhibit', { handle }),
+    /**
+     * Shows one combined progress value (0 to 1), an indeterminate state or nothing on the app's
+     * dock or taskbar entry, with an optional badge count (Linux).
+     */
+    setLauncherProgress: (request) => cmd('set_launcher_progress', { request }),
+    /**
+     * Takes the `org.freedesktop.FileManager1` name so other applications' "Show in folder" reaches
+     * this app as {@link FILE_MANAGER_CALL_EVENT} events. Linux only.
+     */
+    ownFileManager: () => cmd('own_file_manager'),
+    /** Gives the `org.freedesktop.FileManager1` name back. */
+    disownFileManager: () => cmd('disown_file_manager'),
+    /**
+     * Registers a global shortcut with `RegisterHotKey`; {@link desktopIntegration.onShortcutPressed}
+     * reports presses. Registering an id again replaces its accelerator, the same one included; if
+     * the new accelerator is refused, the earlier binding stays. A call that rejects with
+     * `timeout` did not take effect. Windows only; Linux uses
+     * {@link desktopIntegration.registerShortcut}.
+     */
+    registerGlobalShortcut: (request) => cmd('register_global_shortcut', { request }),
+    /** Removes a shortcut registered with {@link desktopIntegration.registerGlobalShortcut}. */
+    unregisterGlobalShortcut: (id) => cmd('unregister_global_shortcut', { id }),
+    /** Subscribes to notification clicks and button presses; resolves to a function that unsubscribes. */
+    onNotificationAction: (callback) => on(NOTIFICATION_ACTION_EVENT, callback),
+    /** Subscribes to `FileManager1` calls from other applications. */
+    onFileManagerCall: (callback) => on(FILE_MANAGER_CALL_EVENT, callback),
+    /** Subscribes to the app losing the `FileManager1` name to another file manager. */
+    onFileManagerOwnership: (callback) => on(FILE_MANAGER_OWNERSHIP_EVENT, callback),
+    /** Subscribes to presses of Windows global shortcuts. */
+    onShortcutPressed: (callback) => on(SHORTCUT_PRESSED_EVENT, callback),
     /**
      * Registers a global shortcut. On X11 it's bound immediately; on Wayland,
      * binding is deferred until the compositor confirms it — see
@@ -50,7 +129,22 @@ const desktopIntegration = {
      * shortcut-binding-result listener — complements checkShortcutBindingComplete.
      */
     checkShortcutBindingError: () => cmd('check_shortcut_binding_error'),
+    /**
+     * Returns the trigger description (e.g. "Super+E") from the most recent
+     * shortcut-changed event, or null if the shortcut hasn't been externally
+     * rebound yet this session. Use this to hydrate UI that mounts after a missed
+     * event — listen for the `shortcut-changed` event directly via
+     * `@tauri-apps/api/event`'s `listen()` for live updates.
+     */
+    checkShortcutTriggerDescription: () => cmd('check_shortcut_trigger_description'),
 };
 
+exports.FILE_MANAGER_CALL_EVENT = FILE_MANAGER_CALL_EVENT;
+exports.FILE_MANAGER_OWNERSHIP_EVENT = FILE_MANAGER_OWNERSHIP_EVENT;
+exports.NOTIFICATION_ACTION_EVENT = NOTIFICATION_ACTION_EVENT;
+exports.SHORTCUT_PRESSED_EVENT = SHORTCUT_PRESSED_EVENT;
 exports.desktopIntegration = desktopIntegration;
+exports.featureStatus = featureStatus;
+exports.isFeatureAvailable = isFeatureAvailable;
+exports.isServiceError = isServiceError;
 //# sourceMappingURL=index.cjs.map

package/dist-js/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sources":["../guest-js/index.ts"],"sourcesContent":[null],"names":["invoke","listen"],"mappings":";;;;;AAAA;AACA;AACA;AACA;AASA,MAAM,MAAM,GAAG,6BAA6B;AAE5C,SAAS,GAAG,CAAI,IAAY,EAAE,IAA8B,EAAA;IAC3D,OAAOA,WAAM,CAAI,CAAA,EAAG,MAAM,CAAA,EAAG,IAAI,CAAA,CAAE,EAAE,IAAI,CAAC;AAC3C;AAEA,IAAI,kBAAkB,GAAwB,IAAI;AAClD,IAAI,mBAAmB,GAA4B,IAAI;AAEvD,SAAS,wBAAwB,GAAA;AAChC,IAAA,IAAI,mBAAmB;QAAE;AACzB,IAAA,mBAAmB,GAAGC,YAAM,CAA2B,oBAAoB,EAAE,MAAK;QACjF,kBAAkB,IAAI;AACvB,IAAA,CAAC,CAAC;AACH;AAEO,MAAM,kBAAkB,GAAG;AACjC;;;;;;;;;;;AAWG;IACH,gBAAgB,EAAE,CACjB,SAAiB,EACjB,kBAA0B,EAC1B,QAAgB,EAChB,WAAuB,KACL;QAClB,kBAAkB,GAAG,WAAW;AAChC,QAAA,wBAAwB,EAAE;AAC1B,QAAA,OAAO,GAAG,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC7E,CAAC;AAED;;;;AAIG;AACH,IAAA,4BAA4B,EAAE,MAAM,GAAG,CAAU,iCAAiC,CAAC;AAEnF;;;;AAIG;AACH,IAAA,yBAAyB,EAAE,MAAM,GAAG,CAAgB,8BAA8B,CAAC;;;;;"}
+{"version":3,"file":"index.cjs","sources":["../guest-js/index.ts"],"sourcesContent":[null],"names":["invoke","listen","event"],"mappings":"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"}

package/dist-js/index.d.ts

@@ -1,7 +1,96 @@
+import type { ActionButton } from './bindings/ActionButton';
+import type { Feature } from './bindings/Feature';
+import type { FeatureStatus } from './bindings/FeatureStatus';
+import type { FileManagerCall } from './bindings/FileManagerCall';
+import type { FileManagerMethod } from './bindings/FileManagerMethod';
+import type { FileManagerOwnership } from './bindings/FileManagerOwnership';
+import type { FileManagerTarget } from './bindings/FileManagerTarget';
+import type { GlobalShortcutPressed } from './bindings/GlobalShortcutPressed';
+import type { GlobalShortcutRequest } from './bindings/GlobalShortcutRequest';
+import type { LauncherProgress } from './bindings/LauncherProgress';
+import type { LauncherRequest } from './bindings/LauncherRequest';
+import type { NotificationAction } from './bindings/NotificationAction';
+import type { NotifyRequest } from './bindings/NotifyRequest';
+import type { PluginStatus } from './bindings/PluginStatus';
+import type { ServiceError } from './bindings/ServiceError';
+import type { ServiceErrorKind } from './bindings/ServiceErrorKind';
 import type { ShortcutActivatedPayload } from './bindings/ShortcutActivatedPayload';
 import type { ShortcutBindingResult } from './bindings/ShortcutBindingResult';
-export type { ShortcutActivatedPayload, ShortcutBindingResult };
+import type { ShortcutChangedPayload } from './bindings/ShortcutChangedPayload';
+import type { SleepInhibitHandle } from './bindings/SleepInhibitHandle';
+import type { SleepInhibitRequest } from './bindings/SleepInhibitRequest';
+import type { SleepKind } from './bindings/SleepKind';
+import type { UnavailableReason } from './bindings/UnavailableReason';
+import type { Urgency } from './bindings/Urgency';
+export type { ActionButton, Feature, FeatureStatus, FileManagerCall, FileManagerMethod, FileManagerOwnership, FileManagerTarget, GlobalShortcutPressed, GlobalShortcutRequest, LauncherProgress, LauncherRequest, NotificationAction, NotifyRequest, PluginStatus, ServiceError, ServiceErrorKind, ShortcutActivatedPayload, ShortcutBindingResult, ShortcutChangedPayload, SleepInhibitHandle, SleepInhibitRequest, SleepKind, UnavailableReason, Urgency, };
+/**
+ * Event emitted when the user clicks a notification shown through `notify` or presses one of its
+ * action buttons; the payload is `{ id, action }`.
+ */
+export declare const NOTIFICATION_ACTION_EVENT = "desktop-integration://notification-action";
+/** Event emitted for each `org.freedesktop.FileManager1` call another application makes. */
+export declare const FILE_MANAGER_CALL_EVENT = "desktop-integration://file-manager";
+/** Event emitted when the app gains or loses the `org.freedesktop.FileManager1` name. */
+export declare const FILE_MANAGER_OWNERSHIP_EVENT = "desktop-integration://file-manager-ownership";
+/** Event emitted when a Windows global shortcut is pressed. */
+export declare const SHORTCUT_PRESSED_EVENT = "desktop-integration://shortcut-pressed";
+/** Whether a rejection from one of the service commands is a {@link ServiceError}. */
+export declare function isServiceError(error: unknown): error is ServiceError;
+/** The status of one feature, or `undefined` when the plugin did not report it. */
+export declare function featureStatus(status: PluginStatus, feature: Feature): FeatureStatus | undefined;
+/** Whether a feature is available; the way to decide whether to show the option that needs it. */
+export declare function isFeatureAvailable(status: PluginStatus, feature: Feature): boolean;
 export declare const desktopIntegration: {
+    /** Which services work on this system, with a reason for each that does not. */
+    getStatus: () => Promise<PluginStatus>;
+    /**
+     * Shows a desktop notification outside the portal, or replaces the one with the same `id`.
+     * Windows needs an AppUserModelID (see {@link desktopIntegration.setAppUserModelId}); without
+     * one this rejects with kind `needs-app-id`.
+     */
+    notify: (request: NotifyRequest) => Promise<void>;
+    /** Takes a notification shown through `notify` off screen. */
+    withdrawNotification: (id: string) => Promise<void>;
+    /** Sets the AppUserModelID of the process, which Windows toasts need. Windows only. */
+    setAppUserModelId: (id: string) => Promise<void>;
+    /**
+     * Keeps the machine from sleeping (or idling, on Linux) until
+     * {@link desktopIntegration.releaseSleepInhibit} is called with the returned handle or the app
+     * exits.
+     */
+    inhibitSleep: (request: SleepInhibitRequest) => Promise<SleepInhibitHandle>;
+    /** Ends an inhibitor taken with {@link desktopIntegration.inhibitSleep}. */
+    releaseSleepInhibit: (handle: number) => Promise<void>;
+    /**
+     * Shows one combined progress value (0 to 1), an indeterminate state or nothing on the app's
+     * dock or taskbar entry, with an optional badge count (Linux).
+     */
+    setLauncherProgress: (request: LauncherRequest) => Promise<void>;
+    /**
+     * Takes the `org.freedesktop.FileManager1` name so other applications' "Show in folder" reaches
+     * this app as {@link FILE_MANAGER_CALL_EVENT} events. Linux only.
+     */
+    ownFileManager: () => Promise<FileManagerOwnership>;
+    /** Gives the `org.freedesktop.FileManager1` name back. */
+    disownFileManager: () => Promise<FileManagerOwnership>;
+    /**
+     * Registers a global shortcut with `RegisterHotKey`; {@link desktopIntegration.onShortcutPressed}
+     * reports presses. Registering an id again replaces its accelerator, the same one included; if
+     * the new accelerator is refused, the earlier binding stays. A call that rejects with
+     * `timeout` did not take effect. Windows only; Linux uses
+     * {@link desktopIntegration.registerShortcut}.
+     */
+    registerGlobalShortcut: (request: GlobalShortcutRequest) => Promise<void>;
+    /** Removes a shortcut registered with {@link desktopIntegration.registerGlobalShortcut}. */
+    unregisterGlobalShortcut: (id: string) => Promise<void>;
+    /** Subscribes to notification clicks and button presses; resolves to a function that unsubscribes. */
+    onNotificationAction: (callback: (_action: NotificationAction) => void) => Promise<() => void>;
+    /** Subscribes to `FileManager1` calls from other applications. */
+    onFileManagerCall: (callback: (_call: FileManagerCall) => void) => Promise<() => void>;
+    /** Subscribes to the app losing the `FileManager1` name to another file manager. */
+    onFileManagerOwnership: (callback: (_ownership: FileManagerOwnership) => void) => Promise<() => void>;
+    /** Subscribes to presses of Windows global shortcuts. */
+    onShortcutPressed: (callback: (_pressed: GlobalShortcutPressed) => void) => Promise<() => void>;
     /**
      * Registers a global shortcut. On X11 it's bound immediately; on Wayland,
      * binding is deferred until the compositor confirms it — see
@@ -27,5 +116,13 @@ export declare const desktopIntegration: {
      * shortcut-binding-result listener — complements checkShortcutBindingComplete.
      */
     checkShortcutBindingError: () => Promise<string | null>;
+    /**
+     * Returns the trigger description (e.g. "Super+E") from the most recent
+     * shortcut-changed event, or null if the shortcut hasn't been externally
+     * rebound yet this session. Use this to hydrate UI that mounts after a missed
+     * event — listen for the `shortcut-changed` event directly via
+     * `@tauri-apps/api/event`'s `listen()` for live updates.
+     */
+    checkShortcutTriggerDescription: () => Promise<string | null>;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist-js/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../guest-js/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAE9E,YAAY,EAAE,wBAAwB,EAAE,qBAAqB,EAAE,CAAC;AAkBhE,eAAO,MAAM,kBAAkB;IAC9B;;;;;;;;;;;OAWG;kCAES,MAAM,sBACG,MAAM,YAChB,MAAM,eACH,MAAM,IAAI,KACrB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;OAIG;;IAGH;;;;OAIG;;CAEH,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../guest-js/index.ts"],"names":[],"mappings":"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"}

package/dist-js/index.js

@@ -5,6 +5,32 @@ import { listen } from '@tauri-apps/api/event';
 //
 // (c) Copyright 2026 Liminal HQ, Scott Morris
 // SPDX-License-Identifier: Apache-2.0 OR MIT
+/**
+ * Event emitted when the user clicks a notification shown through `notify` or presses one of its
+ * action buttons; the payload is `{ id, action }`.
+ */
+const NOTIFICATION_ACTION_EVENT = 'desktop-integration://notification-action';
+/** Event emitted for each `org.freedesktop.FileManager1` call another application makes. */
+const FILE_MANAGER_CALL_EVENT = 'desktop-integration://file-manager';
+/** Event emitted when the app gains or loses the `org.freedesktop.FileManager1` name. */
+const FILE_MANAGER_OWNERSHIP_EVENT = 'desktop-integration://file-manager-ownership';
+/** Event emitted when a Windows global shortcut is pressed. */
+const SHORTCUT_PRESSED_EVENT = 'desktop-integration://shortcut-pressed';
+/** Whether a rejection from one of the service commands is a {@link ServiceError}. */
+function isServiceError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        typeof error.kind === 'string' &&
+        typeof error.message === 'string');
+}
+/** The status of one feature, or `undefined` when the plugin did not report it. */
+function featureStatus(status, feature) {
+    return status.features.find((entry) => entry.feature === feature);
+}
+/** Whether a feature is available; the way to decide whether to show the option that needs it. */
+function isFeatureAvailable(status, feature) {
+    return featureStatus(status, feature)?.available === true;
+}
 const PREFIX = 'plugin:desktop-integration|';
 function cmd(name, args) {
     return invoke(`${PREFIX}${name}`, args);
@@ -18,7 +44,60 @@ function ensureActivationListener() {
         activationCallback?.();
     });
 }
+function on(event, callback) {
+    return listen(event, (e) => callback(e.payload));
+}
 const desktopIntegration = {
+    /** Which services work on this system, with a reason for each that does not. */
+    getStatus: () => cmd('get_status'),
+    /**
+     * Shows a desktop notification outside the portal, or replaces the one with the same `id`.
+     * Windows needs an AppUserModelID (see {@link desktopIntegration.setAppUserModelId}); without
+     * one this rejects with kind `needs-app-id`.
+     */
+    notify: (request) => cmd('notify', { request }),
+    /** Takes a notification shown through `notify` off screen. */
+    withdrawNotification: (id) => cmd('withdraw_notification', { id }),
+    /** Sets the AppUserModelID of the process, which Windows toasts need. Windows only. */
+    setAppUserModelId: (id) => cmd('set_app_user_model_id', { id }),
+    /**
+     * Keeps the machine from sleeping (or idling, on Linux) until
+     * {@link desktopIntegration.releaseSleepInhibit} is called with the returned handle or the app
+     * exits.
+     */
+    inhibitSleep: (request) => cmd('inhibit_sleep', { request }),
+    /** Ends an inhibitor taken with {@link desktopIntegration.inhibitSleep}. */
+    releaseSleepInhibit: (handle) => cmd('release_sleep_inhibit', { handle }),
+    /**
+     * Shows one combined progress value (0 to 1), an indeterminate state or nothing on the app's
+     * dock or taskbar entry, with an optional badge count (Linux).
+     */
+    setLauncherProgress: (request) => cmd('set_launcher_progress', { request }),
+    /**
+     * Takes the `org.freedesktop.FileManager1` name so other applications' "Show in folder" reaches
+     * this app as {@link FILE_MANAGER_CALL_EVENT} events. Linux only.
+     */
+    ownFileManager: () => cmd('own_file_manager'),
+    /** Gives the `org.freedesktop.FileManager1` name back. */
+    disownFileManager: () => cmd('disown_file_manager'),
+    /**
+     * Registers a global shortcut with `RegisterHotKey`; {@link desktopIntegration.onShortcutPressed}
+     * reports presses. Registering an id again replaces its accelerator, the same one included; if
+     * the new accelerator is refused, the earlier binding stays. A call that rejects with
+     * `timeout` did not take effect. Windows only; Linux uses
+     * {@link desktopIntegration.registerShortcut}.
+     */
+    registerGlobalShortcut: (request) => cmd('register_global_shortcut', { request }),
+    /** Removes a shortcut registered with {@link desktopIntegration.registerGlobalShortcut}. */
+    unregisterGlobalShortcut: (id) => cmd('unregister_global_shortcut', { id }),
+    /** Subscribes to notification clicks and button presses; resolves to a function that unsubscribes. */
+    onNotificationAction: (callback) => on(NOTIFICATION_ACTION_EVENT, callback),
+    /** Subscribes to `FileManager1` calls from other applications. */
+    onFileManagerCall: (callback) => on(FILE_MANAGER_CALL_EVENT, callback),
+    /** Subscribes to the app losing the `FileManager1` name to another file manager. */
+    onFileManagerOwnership: (callback) => on(FILE_MANAGER_OWNERSHIP_EVENT, callback),
+    /** Subscribes to presses of Windows global shortcuts. */
+    onShortcutPressed: (callback) => on(SHORTCUT_PRESSED_EVENT, callback),
     /**
      * Registers a global shortcut. On X11 it's bound immediately; on Wayland,
      * binding is deferred until the compositor confirms it — see
@@ -48,7 +127,15 @@ const desktopIntegration = {
      * shortcut-binding-result listener — complements checkShortcutBindingComplete.
      */
     checkShortcutBindingError: () => cmd('check_shortcut_binding_error'),
+    /**
+     * Returns the trigger description (e.g. "Super+E") from the most recent
+     * shortcut-changed event, or null if the shortcut hasn't been externally
+     * rebound yet this session. Use this to hydrate UI that mounts after a missed
+     * event — listen for the `shortcut-changed` event directly via
+     * `@tauri-apps/api/event`'s `listen()` for live updates.
+     */
+    checkShortcutTriggerDescription: () => cmd('check_shortcut_trigger_description'),
 };
 
-export { desktopIntegration };
+export { FILE_MANAGER_CALL_EVENT, FILE_MANAGER_OWNERSHIP_EVENT, NOTIFICATION_ACTION_EVENT, SHORTCUT_PRESSED_EVENT, desktopIntegration, featureStatus, isFeatureAvailable, isServiceError };
 //# sourceMappingURL=index.js.map

package/dist-js/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../guest-js/index.ts"],"sourcesContent":[null],"names":[],"mappings":";;;AAAA;AACA;AACA;AACA;AASA,MAAM,MAAM,GAAG,6BAA6B;AAE5C,SAAS,GAAG,CAAI,IAAY,EAAE,IAA8B,EAAA;IAC3D,OAAO,MAAM,CAAI,CAAA,EAAG,MAAM,CAAA,EAAG,IAAI,CAAA,CAAE,EAAE,IAAI,CAAC;AAC3C;AAEA,IAAI,kBAAkB,GAAwB,IAAI;AAClD,IAAI,mBAAmB,GAA4B,IAAI;AAEvD,SAAS,wBAAwB,GAAA;AAChC,IAAA,IAAI,mBAAmB;QAAE;AACzB,IAAA,mBAAmB,GAAG,MAAM,CAA2B,oBAAoB,EAAE,MAAK;QACjF,kBAAkB,IAAI;AACvB,IAAA,CAAC,CAAC;AACH;AAEO,MAAM,kBAAkB,GAAG;AACjC;;;;;;;;;;;AAWG;IACH,gBAAgB,EAAE,CACjB,SAAiB,EACjB,kBAA0B,EAC1B,QAAgB,EAChB,WAAuB,KACL;QAClB,kBAAkB,GAAG,WAAW;AAChC,QAAA,wBAAwB,EAAE;AAC1B,QAAA,OAAO,GAAG,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;IAC7E,CAAC;AAED;;;;AAIG;AACH,IAAA,4BAA4B,EAAE,MAAM,GAAG,CAAU,iCAAiC,CAAC;AAEnF;;;;AAIG;AACH,IAAA,yBAAyB,EAAE,MAAM,GAAG,CAAgB,8BAA8B,CAAC;;;;;"}
+{"version":3,"file":"index.js","sources":["../guest-js/index.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist-js/index.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.test.d.ts.map

package/dist-js/index.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.d.ts","sourceRoot":"","sources":["../guest-js/index.test.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liminal-hq/plugin-desktop-integration",
-	"version": "0.1.0",
+	"version": "0.3.0",
 	"license": "Apache-2.0 OR MIT",
 	"authors": [
 		"Liminal HQ Contributors"