@flighthq/app 0.1.0

package/dist/app.d.ts

@@ -0,0 +1,44 @@
+import type { App, AppActivationPolicy, AppBackend, AppLoginItem, AppLoginItemLike, AppPathKind, MenuItemTemplate } from '@flighthq/types';
+export declare function addAppRecentDocument(path: string): void;
+export declare function attachApp(app: App): void;
+export declare function bounceAppDock(): number;
+export declare function cancelAppAttention(id: number): void;
+export declare function cancelAppDockBounce(id: number): void;
+export declare function clearAppRecentDocuments(): void;
+export declare function createApp(): App;
+export declare function createAppLoginItem(): AppLoginItem;
+export declare function createWebAppBackend(): AppBackend;
+export declare function detachApp(app: App): void;
+export declare function disposeApp(app: App): void;
+export declare function focusApp(): void;
+export declare function getAppBackend(): AppBackend;
+export declare function getAppCommandLine(): readonly string[];
+export declare function getAppCommandLineSwitch(name: string): string | null;
+export declare function getAppDirectoryPath(kind: AppPathKind): string;
+export declare function getAppExecutablePath(): string;
+export declare function getAppLocale(): string;
+export declare function getAppLoginItem(): AppLoginItem;
+export declare function getAppName(): string;
+export declare function getAppPath(): string;
+export declare function getAppPreferredSystemLanguages(): readonly string[];
+export declare function getAppSystemLocale(): string;
+export declare function getAppVersion(): string;
+export declare function hasAppCommandLineSwitch(name: string): boolean;
+export declare function hasAppSingleInstanceLock(): boolean;
+export declare function hideApp(): boolean;
+export declare function isAppHidden(): boolean;
+export declare function quitApp(): void;
+export declare function relaunchApp(): void;
+export declare function releaseAppSingleInstanceLock(): void;
+export declare function requestAppAttention(critical: boolean): number;
+export declare function requestAppSingleInstanceLock(): boolean;
+export declare function setAppActivationPolicy(policy: AppActivationPolicy): void;
+export declare function setAppBackend(backend: AppBackend | null): void;
+export declare function setAppBadgeCount(count: number): boolean;
+export declare function setAppDockBadge(text: string): void;
+export declare function setAppDockMenu(items: readonly MenuItemTemplate[]): void;
+export declare function setAppLoginItem(settings: Readonly<AppLoginItemLike>): boolean;
+export declare function setAppName(name: string): boolean;
+export declare function setAppUserModelId(id: string): boolean;
+export declare function showApp(): boolean;
+//# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,GAAG,EACH,mBAAmB,EACnB,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAIzB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAEvD;AAOD,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CA0BxC;AAGD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAGD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEnD;AAGD,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEpD;AAGD,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAGD,wBAAgB,SAAS,IAAI,GAAG,CAS/B;AAGD,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD;AAID,wBAAgB,mBAAmB,IAAI,UAAU,CA4KhD;AAGD,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAMxC;AAID,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAEzC;AAGD,wBAAgB,QAAQ,IAAI,IAAI,CAE/B;AAGD,wBAAgB,aAAa,IAAI,UAAU,CAG1C;AAGD,wBAAgB,iBAAiB,IAAI,SAAS,MAAM,EAAE,CAErD;AAGD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnE;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE7D;AAGD,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AAGD,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAGD,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAGD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAGD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAID,wBAAgB,8BAA8B,IAAI,SAAS,MAAM,EAAE,CAElE;AAID,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAGD,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAGD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAGD,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAGD,wBAAgB,OAAO,IAAI,OAAO,CAEjC;AAGD,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAGD,wBAAgB,OAAO,IAAI,IAAI,CAE9B;AAGD,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAGD,wBAAgB,4BAA4B,IAAI,IAAI,CAEnD;AAID,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE7D;AAID,wBAAgB,4BAA4B,IAAI,OAAO,CAEtD;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAExE;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE9D;AAID,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvD;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAElD;AAGD,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAEvE;AAID,wBAAgB,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAE7E;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD;AAID,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAErD;AAGD,wBAAgB,OAAO,IAAI,OAAO,CAEjC"}

package/dist/app.js

@@ -0,0 +1,411 @@
+import { createSignal, emitSignal } from '@flighthq/signals';
+// Adds a path to the system's recent-documents list (Jump List on Windows; macOS recents). No-op on
+// web and platforms without a recents list.
+export function addAppRecentDocument(path) {
+    getAppBackend().addRecentDocument(path);
+}
+// Begins delivering app events to `app`'s signals by subscribing to the active backend. Wires
+// subscribeActivate→onActivate, subscribeAllWindowsClosed→onAllWindowsClosed,
+// subscribeOpenFile→onOpenFile, subscribeQuitRequest→onQuitRequest,
+// subscribeReady→onReady, subscribeSecondInstance→onSecondInstance.
+// Idempotent: a prior subscription is torn down first. Pair with detachApp/disposeApp.
+export function attachApp(app) {
+    detachApp(app);
+    const backend = getAppBackend();
+    const unsubscribeActivate = backend.subscribeActivate(() => emitSignal(app.onActivate));
+    const unsubscribeAllWindowsClosed = backend.subscribeAllWindowsClosed(() => emitSignal(app.onAllWindowsClosed));
+    const unsubscribeOpenFile = backend.subscribeOpenFile((path) => emitSignal(app.onOpenFile, path));
+    const unsubscribeQuitRequest = backend.subscribeQuitRequest((cancelHost) => {
+        emitSignal(app.onQuitRequest);
+        if (app.onQuitRequest.data?.cancelled === true) {
+            // A Flight listener vetoed the quit — cancel at the host level too so that Electron (and other
+            // native hosts) can call event.preventDefault() and prevent the OS from forcing a quit.
+            cancelHost();
+        }
+        else {
+            backend.quit();
+        }
+    });
+    const unsubscribeReady = backend.subscribeReady(() => emitSignal(app.onReady));
+    const unsubscribeSecondInstance = backend.subscribeSecondInstance((argv) => emitSignal(app.onSecondInstance, argv));
+    _subscriptions.set(app, () => {
+        unsubscribeActivate();
+        unsubscribeAllWindowsClosed();
+        unsubscribeOpenFile();
+        unsubscribeQuitRequest();
+        unsubscribeReady();
+        unsubscribeSecondInstance();
+    });
+}
+// Starts a dock bounce; returns a request id usable with cancelAppDockBounce, or -1 when unsupported.
+export function bounceAppDock() {
+    return getAppBackend().bounceDock();
+}
+// Cancels an app-level attention request previously started by requestAppAttention. No-op on web.
+export function cancelAppAttention(id) {
+    getAppBackend().cancelAttention(id);
+}
+// Cancels a dock bounce previously started by bounceAppDock.
+export function cancelAppDockBounce(id) {
+    getAppBackend().cancelDockBounce(id);
+}
+// Clears the system's recent-documents list (Jump List / macOS recents). No-op on web.
+export function clearAppRecentDocuments() {
+    getAppBackend().clearRecentDocuments();
+}
+// Allocates an App event entity with inert signals; call attachApp to start delivery.
+export function createApp() {
+    return {
+        onActivate: createSignal(),
+        onAllWindowsClosed: createSignal(),
+        onOpenFile: createSignal(),
+        onQuitRequest: createSignal(),
+        onReady: createSignal(),
+        onSecondInstance: createSignal(),
+    };
+}
+// Allocates an AppLoginItem with default values.
+export function createAppLoginItem() {
+    return { args: [], openAsHidden: false, openAtLogin: false, path: '' };
+}
+// Builds the default web backend over document/window/navigator. Degrades to empty strings and no-ops
+// where the APIs are absent. A web tab is inherently single-instance, so the lock is always held.
+export function createWebAppBackend() {
+    return {
+        addRecentDocument() {
+            // No web recent-documents list; no-op.
+        },
+        bounceDock() {
+            return -1;
+        },
+        cancelAttention() {
+            // No web attention API; no-op.
+        },
+        cancelDockBounce() {
+            // No web dock; no-op.
+        },
+        clearRecentDocuments() {
+            // No web recent-documents list; no-op.
+        },
+        focus() {
+            if (typeof window !== 'undefined') {
+                try {
+                    window.focus();
+                }
+                catch {
+                    // Focus may be blocked by the host; ignore.
+                }
+            }
+        },
+        getAppDirectoryPath() {
+            // Web sentinel '': a web tab has no app-identity-relative directory. Native: userData/logs/
+            // crashDumps under the per-app data root.
+            return '';
+        },
+        getAppPath() {
+            // Web sentinel '': no bundle/exe directory in a tab. Native: the application directory.
+            return '';
+        },
+        getCommandLine() {
+            // Web sentinel []: a tab has no process argv. Native: this process's command-line arguments.
+            return [];
+        },
+        getExecutablePath() {
+            // Web sentinel '': no executable in a tab. Native: the running executable's path.
+            return '';
+        },
+        getLocale() {
+            return typeof navigator !== 'undefined' ? (navigator.language ?? '') : '';
+        },
+        getPreferredSystemLanguages() {
+            if (typeof navigator !== 'undefined' && Array.isArray(navigator.languages)) {
+                return navigator.languages;
+            }
+            return [];
+        },
+        getSystemLocale() {
+            try {
+                return typeof Intl !== 'undefined' ? new Intl.DateTimeFormat().resolvedOptions().locale : '';
+            }
+            catch {
+                return '';
+            }
+        },
+        getLoginItem() {
+            // Web sentinel: a default with openAtLogin false — a tab has no launch-at-login concept.
+            // Native: the OS launch-at-login registration for this app.
+            return { args: [], openAsHidden: false, openAtLogin: false, path: '' };
+        },
+        getName() {
+            // Web: document.title stands in for the app name ('' when no document). Native: the app's
+            // display name.
+            return typeof document !== 'undefined' ? document.title : '';
+        },
+        getVersion() {
+            // Web sentinel '': a tab carries no app version. Native: the packaged app version string.
+            return '';
+        },
+        hasSingleInstanceLock() {
+            return true;
+        },
+        hideApp() {
+            // No web application-hide; no-op.
+            return false;
+        },
+        isAppHidden() {
+            return false;
+        },
+        quit() {
+            if (typeof window !== 'undefined') {
+                try {
+                    window.close();
+                }
+                catch {
+                    // window.close() is restricted for non-script-opened tabs; ignore.
+                }
+            }
+        },
+        relaunch() {
+            if (typeof location !== 'undefined') {
+                try {
+                    location.reload();
+                }
+                catch {
+                    // Reload may be blocked in some embedding contexts; ignore.
+                }
+            }
+        },
+        releaseSingleInstanceLock() {
+            // A web tab cannot relinquish a process-level lock; no-op.
+        },
+        requestAttention() {
+            return -1;
+        },
+        requestSingleInstanceLock() {
+            return true;
+        },
+        setActivationPolicy() {
+            // No macOS activation policy on web; no-op.
+        },
+        setBadgeCount(count) {
+            if (typeof navigator === 'undefined' || !('setAppBadge' in navigator))
+                return false;
+            try {
+                navigator.setAppBadge(count);
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        setDockBadge() {
+            // No web dock; no-op.
+        },
+        setDockMenu() {
+            // No web dock menu; a native host (Electron app.dock) is required.
+        },
+        setLoginItem() {
+            // Web tabs have no login-item concept; no-op.
+            return false;
+        },
+        setName() {
+            // Cannot rename the application from web context; no-op.
+            return false;
+        },
+        setUserModelId() {
+            // AppUserModelID is Windows-only; no-op on web.
+            return false;
+        },
+        showApp() {
+            // No web application-show; no-op.
+            return false;
+        },
+        subscribeActivate() {
+            // No web app-activate event; the listener is never called. Native: dock/taskbar re-activation.
+            return () => { };
+        },
+        subscribeAllWindowsClosed() {
+            // No web all-windows-closed event; the listener is never called. Native: last window closed.
+            return () => { };
+        },
+        subscribeOpenFile() {
+            // No web open-file event; the listener is never called. Native: OS file-open / "Open With".
+            return () => { };
+        },
+        subscribeQuitRequest(_listener) {
+            // A web tab cannot intercept the browser's quit path; the listener is never called.
+            return () => { };
+        },
+        subscribeReady(listener) {
+            // On the web the DOM is already ready by the time script runs; fire on the next microtask.
+            const id = Promise.resolve().then(() => listener());
+            void id;
+            return () => { };
+        },
+        subscribeSecondInstance() {
+            // No web second-instance event; the listener is never called. Native: another launch hands its
+            // argv to the lock holder.
+            return () => { };
+        },
+    };
+}
+// Stops delivery to `app` and forgets its subscription. Safe to call when not attached.
+export function detachApp(app) {
+    const unsubscribe = _subscriptions.get(app);
+    if (unsubscribe !== undefined) {
+        unsubscribe();
+        _subscriptions.delete(app);
+    }
+}
+// Releases `app` for garbage collection by detaching its backend subscription. The signals remain
+// plain GC-managed memory afterward.
+export function disposeApp(app) {
+    detachApp(app);
+}
+// Brings the application to the foreground.
+export function focusApp() {
+    getAppBackend().focus();
+}
+// The active app backend, or a lazily-created web default. There is always a backend.
+export function getAppBackend() {
+    if (_backend === null)
+        _backend = createWebAppBackend();
+    return _backend;
+}
+// The command-line arguments for this process, or [] on web.
+export function getAppCommandLine() {
+    return getAppBackend().getCommandLine();
+}
+// The value of a named command-line switch, or null when the switch is absent.
+export function getAppCommandLineSwitch(name) {
+    const prefix = `--${name}=`;
+    const args = getAppBackend().getCommandLine();
+    for (const arg of args) {
+        if (arg === `--${name}`)
+            return '';
+        if (arg.startsWith(prefix))
+            return arg.slice(prefix.length);
+    }
+    return null;
+}
+// The app-identity-relative directory path for the given kind (userData/logs/crashDumps); '' on web.
+// Note: bare OS directories (home, documents, downloads, appData, etc.) live in @flighthq/filesystem.
+export function getAppDirectoryPath(kind) {
+    return getAppBackend().getAppDirectoryPath(kind);
+}
+// The application executable path, or '' on web.
+export function getAppExecutablePath() {
+    return getAppBackend().getExecutablePath();
+}
+// The host UI locale (for example 'en-US'), or '' when unknown.
+export function getAppLocale() {
+    return getAppBackend().getLocale();
+}
+// The application login-item settings. Returns a default with openAtLogin: false on web.
+export function getAppLoginItem() {
+    return getAppBackend().getLoginItem();
+}
+// The application name, or '' when unknown.
+export function getAppName() {
+    return getAppBackend().getName();
+}
+// The application bundle/exe directory path, or '' on web.
+export function getAppPath() {
+    return getAppBackend().getAppPath();
+}
+// The ranked list of preferred system languages (for example ['en-US', 'fr-FR']), in preference
+// order; [] when unavailable (on web: navigator.languages).
+export function getAppPreferredSystemLanguages() {
+    return getAppBackend().getPreferredSystemLanguages();
+}
+// The OS-level system locale (for example 'en_US'), which may differ from the UI locale returned
+// by getAppLocale; '' when unavailable.
+export function getAppSystemLocale() {
+    return getAppBackend().getSystemLocale();
+}
+// The application version string, or '' when unknown.
+export function getAppVersion() {
+    return getAppBackend().getVersion();
+}
+// True when the switch is present in the command line; false otherwise.
+export function hasAppCommandLineSwitch(name) {
+    return getAppCommandLineSwitch(name) !== null;
+}
+// True when this process currently holds the single-instance lock.
+export function hasAppSingleInstanceLock() {
+    return getAppBackend().hasSingleInstanceLock();
+}
+// Hides the application (macOS hide-all-windows). Returns true when supported. No-op on web.
+export function hideApp() {
+    return getAppBackend().hideApp();
+}
+// True when the application is hidden (macOS only). Always false on web.
+export function isAppHidden() {
+    return getAppBackend().isAppHidden();
+}
+// Quits the application.
+export function quitApp() {
+    getAppBackend().quit();
+}
+// Relaunches the application.
+export function relaunchApp() {
+    getAppBackend().relaunch();
+}
+// Releases a previously acquired single-instance lock.
+export function releaseAppSingleInstanceLock() {
+    getAppBackend().releaseSingleInstanceLock();
+}
+// Draws attention to the application at the OS level (taskbar flash / dock bounce). Returns a
+// request id for cancelAppAttention, or -1 when unsupported.
+export function requestAppAttention(critical) {
+    return getAppBackend().requestAttention(critical);
+}
+// Attempts to acquire the single-instance lock. Returns true when this process owns it; false when
+// another instance already holds it.
+export function requestAppSingleInstanceLock() {
+    return getAppBackend().requestSingleInstanceLock();
+}
+// Sets the macOS activation policy, controlling dock presence and Command-Tab visibility. No-op on
+// non-macOS and web.
+export function setAppActivationPolicy(policy) {
+    getAppBackend().setActivationPolicy(policy);
+}
+// Installs a native host app backend; pass null to fall back to the web default.
+export function setAppBackend(backend) {
+    _backend = backend;
+}
+// Sets the numeric application badge (taskbar overlay / dock / PWA badge). Returns false when
+// unsupported. Canonical home for the app badge — the tray package no longer carries it.
+export function setAppBadgeCount(count) {
+    return getAppBackend().setBadgeCount(count);
+}
+// Sets the dock/taskbar badge text. Pass '' to clear it.
+export function setAppDockBadge(text) {
+    getAppBackend().setDockBadge(text);
+}
+// Sets the macOs dock menu (shown when right-clicking the dock icon). No-op where there is no dock.
+export function setAppDockMenu(items) {
+    getAppBackend().setDockMenu(items);
+}
+// Updates login-item (launch-at-startup) settings. Returns false when unsupported (web, some Linux
+// environments). Settings fields not provided keep their current values.
+export function setAppLoginItem(settings) {
+    return getAppBackend().setLoginItem(settings);
+}
+// Sets the application name. Returns false when unsupported (web). On macOS/Windows this updates
+// the display name shown in the dock/taskbar.
+export function setAppName(name) {
+    return getAppBackend().setName(name);
+}
+// Sets the Windows AppUserModelID used for taskbar grouping, badging, and Jump Lists. Returns false
+// when unsupported. Should be set at startup before creating any windows.
+export function setAppUserModelId(id) {
+    return getAppBackend().setUserModelId(id);
+}
+// Shows the application after hideApp (macOS). Returns true when supported. No-op on web.
+export function showApp() {
+    return getAppBackend().showApp();
+}
+let _backend = null;
+const _subscriptions = new WeakMap();
+//# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './app';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@flighthq/app",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/**/*.test.ts",
+    "!dist/**/*.test.js",
+    "!dist/**/*.test.d.ts",
+    "!dist/**/*.test.js.map",
+    "!dist/**/*.test.d.ts.map"
+  ],
+  "scripts": {
+    "build": "tsc -b",
+    "clean": "tsc -b --clean",
+    "test": "vitest run --config vitest.config.ts",
+    "test:watch": "vitest --watch --config vitest.config.ts",
+    "prepack": "npm run clean && npm run clean:dist && npm run build",
+    "clean:dist": "tsx ../../scripts/clean-package-dist.ts"
+  },
+  "dependencies": {
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Application identity, lifecycle control, single-instance locking, dock control, and app event signals over a swappable web/native backend",
+  "sideEffects": false
+}

package/src/app.test.ts

@@ -0,0 +1,757 @@
+import { cancelSignal, connectSignal } from '@flighthq/signals';
+import type { AppBackend, AppLoginItem, AppLoginItemLike, MenuItemTemplate } from '@flighthq/types';
+
+import {
+  addAppRecentDocument,
+  attachApp,
+  bounceAppDock,
+  cancelAppAttention,
+  cancelAppDockBounce,
+  clearAppRecentDocuments,
+  createApp,
+  createAppLoginItem,
+  createWebAppBackend,
+  detachApp,
+  disposeApp,
+  focusApp,
+  getAppBackend,
+  getAppCommandLine,
+  getAppCommandLineSwitch,
+  getAppDirectoryPath,
+  getAppExecutablePath,
+  getAppLocale,
+  getAppLoginItem,
+  getAppName,
+  getAppPath,
+  getAppPreferredSystemLanguages,
+  getAppSystemLocale,
+  getAppVersion,
+  hasAppCommandLineSwitch,
+  hasAppSingleInstanceLock,
+  hideApp,
+  isAppHidden,
+  quitApp,
+  relaunchApp,
+  releaseAppSingleInstanceLock,
+  requestAppAttention,
+  requestAppSingleInstanceLock,
+  setAppActivationPolicy,
+  setAppBackend,
+  setAppBadgeCount,
+  setAppDockBadge,
+  setAppDockMenu,
+  setAppLoginItem,
+  setAppName,
+  setAppUserModelId,
+  showApp,
+} from './app';
+
+function fakeBackend(): AppBackend & {
+  activationPolicy: string;
+  badge: string;
+  badgeCount: number;
+  bounceId: number;
+  cancelledAttention: number;
+  cancelledBounce: number;
+  commandLine: string[];
+  dockMenuItems: number;
+  focused: boolean;
+  hidden: boolean;
+  lastRecentDocument: string;
+  loginItem: AppLoginItem;
+  lock: boolean;
+  name: string;
+  preferredLanguages: string[];
+  recentDocumentsCleared: boolean;
+  systemLocale: string;
+  userModelId: string;
+  fireActivate: () => void;
+  fireAllWindowsClosed: () => void;
+  fireOpenFile: (path: string) => void;
+  fireQuitRequest: (cancel?: () => void) => void;
+  fireReady: () => void;
+  fireSecondInstance: (argv: readonly string[]) => void;
+} {
+  let activate: (() => void) | null = null;
+  let allWindowsClosed: (() => void) | null = null;
+  let openFile: ((path: string) => void) | null = null;
+  let quitRequest: ((cancel: () => void) => void) | null = null;
+  let ready: (() => void) | null = null;
+  let secondInstance: ((argv: readonly string[]) => void) | null = null;
+  return {
+    activationPolicy: '',
+    badge: '',
+    badgeCount: -1,
+    bounceId: -1,
+    cancelledAttention: -1,
+    cancelledBounce: -1,
+    commandLine: [],
+    dockMenuItems: -1,
+    focused: false,
+    hidden: false,
+    lastRecentDocument: '',
+    loginItem: { args: [], openAsHidden: false, openAtLogin: false, path: '' },
+    lock: false,
+    name: 'TestApp',
+    preferredLanguages: ['en-US', 'fr-FR'],
+    recentDocumentsCleared: false,
+    systemLocale: 'en_US',
+    userModelId: '',
+    addRecentDocument(path) {
+      this.lastRecentDocument = path;
+    },
+    bounceDock() {
+      this.bounceId = 7;
+      return 7;
+    },
+    cancelAttention(id) {
+      this.cancelledAttention = id;
+    },
+    cancelDockBounce(id) {
+      this.cancelledBounce = id;
+    },
+    clearRecentDocuments() {
+      this.recentDocumentsCleared = true;
+    },
+    focus() {
+      this.focused = true;
+    },
+    getAppDirectoryPath() {
+      return '/test/app/userData';
+    },
+    getAppPath() {
+      return '/test/app';
+    },
+    getCommandLine() {
+      return this.commandLine;
+    },
+    getExecutablePath() {
+      return '/test/app/bin';
+    },
+    getLocale() {
+      return 'en-US';
+    },
+    getPreferredSystemLanguages() {
+      return this.preferredLanguages;
+    },
+    getSystemLocale() {
+      return this.systemLocale;
+    },
+    getLoginItem() {
+      return this.loginItem;
+    },
+    getName() {
+      return this.name;
+    },
+    getVersion() {
+      return '1.2.3';
+    },
+    hasSingleInstanceLock() {
+      return this.lock;
+    },
+    hideApp() {
+      this.hidden = true;
+      return true;
+    },
+    isAppHidden() {
+      return this.hidden;
+    },
+    quit() {},
+    relaunch() {},
+    releaseSingleInstanceLock() {
+      this.lock = false;
+    },
+    requestAttention() {
+      return 42;
+    },
+    requestSingleInstanceLock() {
+      this.lock = true;
+      return true;
+    },
+    setActivationPolicy(policy) {
+      this.activationPolicy = policy;
+    },
+    setBadgeCount(count) {
+      this.badgeCount = count;
+      return true;
+    },
+    setDockBadge(text) {
+      this.badge = text;
+    },
+    setDockMenu(items) {
+      this.dockMenuItems = items.length;
+    },
+    setLoginItem(settings) {
+      this.loginItem = { ...this.loginItem, ...settings };
+      return true;
+    },
+    setName(n) {
+      this.name = n;
+      return true;
+    },
+    setUserModelId(id) {
+      this.userModelId = id;
+      return true;
+    },
+    showApp() {
+      this.hidden = false;
+      return true;
+    },
+    subscribeActivate(l) {
+      activate = l;
+      return () => {
+        activate = null;
+      };
+    },
+    subscribeAllWindowsClosed(l) {
+      allWindowsClosed = l;
+      return () => {
+        allWindowsClosed = null;
+      };
+    },
+    subscribeOpenFile(l) {
+      openFile = l;
+      return () => {
+        openFile = null;
+      };
+    },
+    subscribeQuitRequest(l) {
+      quitRequest = l;
+      return () => {
+        quitRequest = null;
+      };
+    },
+    subscribeReady(l) {
+      ready = l;
+      return () => {
+        ready = null;
+      };
+    },
+    subscribeSecondInstance(l) {
+      secondInstance = l;
+      return () => {
+        secondInstance = null;
+      };
+    },
+    fireActivate() {
+      activate?.();
+    },
+    fireAllWindowsClosed() {
+      allWindowsClosed?.();
+    },
+    fireOpenFile(path) {
+      openFile?.(path);
+    },
+    fireQuitRequest(cancel?: () => void) {
+      quitRequest?.(cancel ?? (() => {}));
+    },
+    fireReady() {
+      ready?.();
+    },
+    fireSecondInstance(argv) {
+      secondInstance?.(argv);
+    },
+  };
+}
+
+afterEach(() => setAppBackend(null));
+
+describe('addAppRecentDocument', () => {
+  it('forwards the path to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    addAppRecentDocument('/home/user/file.txt');
+    expect(backend.lastRecentDocument).toBe('/home/user/file.txt');
+  });
+});
+
+describe('attachApp', () => {
+  it('wires activate, all-windows-closed, open-file, quit-request, ready, and second-instance subscriptions', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const app = createApp();
+    let activations = 0;
+    let allWindowsClosedCount = 0;
+    let openedPath = '';
+    let readyCount = 0;
+    let argv: readonly string[] = [];
+    connectSignal(app.onActivate, () => activations++);
+    connectSignal(app.onAllWindowsClosed, () => allWindowsClosedCount++);
+    connectSignal(app.onOpenFile, (path) => (openedPath = path));
+    connectSignal(app.onReady, () => readyCount++);
+    connectSignal(app.onSecondInstance, (a) => (argv = a));
+    attachApp(app);
+    backend.fireActivate();
+    backend.fireAllWindowsClosed();
+    backend.fireOpenFile('/tmp/file.txt');
+    backend.fireReady();
+    backend.fireSecondInstance(['--flag']);
+    expect(activations).toBe(1);
+    expect(allWindowsClosedCount).toBe(1);
+    expect(openedPath).toBe('/tmp/file.txt');
+    expect(readyCount).toBe(1);
+    expect(argv).toEqual(['--flag']);
+  });
+
+  it('is idempotent — tears down the prior subscription before re-attaching', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const app = createApp();
+    let activations = 0;
+    connectSignal(app.onActivate, () => activations++);
+    attachApp(app);
+    attachApp(app);
+    backend.fireActivate();
+    expect(activations).toBe(1);
+  });
+
+  it('quits when onQuitRequest is not cancelled', () => {
+    let quits = 0;
+    const backend = fakeBackend();
+    backend.quit = () => {
+      quits++;
+    };
+    setAppBackend(backend);
+    const app = createApp();
+    attachApp(app);
+    backend.fireQuitRequest();
+    expect(quits).toBe(1);
+  });
+
+  it('does not quit when onQuitRequest is cancelled', () => {
+    let quits = 0;
+    const backend = fakeBackend();
+    backend.quit = () => {
+      quits++;
+    };
+    setAppBackend(backend);
+    const app = createApp();
+    connectSignal(app.onQuitRequest, () => cancelSignal(app.onQuitRequest));
+    attachApp(app);
+    backend.fireQuitRequest();
+    expect(quits).toBe(0);
+  });
+
+  it('calls the host cancel callback when onQuitRequest is vetoed', () => {
+    let hostCancelled = false;
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const app = createApp();
+    connectSignal(app.onQuitRequest, () => cancelSignal(app.onQuitRequest));
+    attachApp(app);
+    backend.fireQuitRequest(() => {
+      hostCancelled = true;
+    });
+    expect(hostCancelled).toBe(true);
+  });
+});
+
+describe('bounceAppDock', () => {
+  it('returns the backend bounce id', () => {
+    setAppBackend(fakeBackend());
+    expect(bounceAppDock()).toBe(7);
+  });
+});
+
+describe('cancelAppAttention', () => {
+  it('forwards the id to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    cancelAppAttention(42);
+    expect(backend.cancelledAttention).toBe(42);
+  });
+});
+
+describe('cancelAppDockBounce', () => {
+  it('forwards the id to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    cancelAppDockBounce(7);
+    expect(backend.cancelledBounce).toBe(7);
+  });
+});
+
+describe('clearAppRecentDocuments', () => {
+  it('clears via the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    clearAppRecentDocuments();
+    expect(backend.recentDocumentsCleared).toBe(true);
+  });
+});
+
+describe('createApp', () => {
+  it('creates an entity with six signals', () => {
+    const app = createApp();
+    expect(app.onActivate).toBeDefined();
+    expect(app.onAllWindowsClosed).toBeDefined();
+    expect(app.onOpenFile).toBeDefined();
+    expect(app.onQuitRequest).toBeDefined();
+    expect(app.onReady).toBeDefined();
+    expect(app.onSecondInstance).toBeDefined();
+  });
+});
+
+describe('createAppLoginItem', () => {
+  it('returns a default login item', () => {
+    const item = createAppLoginItem();
+    expect(item.openAtLogin).toBe(false);
+    expect(item.openAsHidden).toBe(false);
+    expect(item.args).toEqual([]);
+    expect(item.path).toBe('');
+  });
+});
+
+describe('createWebAppBackend', () => {
+  it('reads identity values without throwing', () => {
+    const backend = createWebAppBackend();
+    expect(typeof backend.getName()).toBe('string');
+    expect(typeof backend.getVersion()).toBe('string');
+    expect(typeof backend.getLocale()).toBe('string');
+    expect(backend.requestSingleInstanceLock()).toBe(true);
+    expect(backend.hasSingleInstanceLock()).toBe(true);
+    expect(backend.bounceDock()).toBe(-1);
+    expect(backend.subscribeActivate(() => {})).toBeInstanceOf(Function);
+  });
+
+  it('returns sentinel values for unavailable APIs', () => {
+    const backend = createWebAppBackend();
+    expect(backend.getAppPath()).toBe('');
+    expect(backend.getExecutablePath()).toBe('');
+    expect(backend.getCommandLine()).toEqual([]);
+    expect(backend.getLoginItem().openAtLogin).toBe(false);
+    expect(backend.hideApp()).toBe(false);
+    expect(backend.isAppHidden()).toBe(false);
+    expect(backend.requestAttention(false)).toBe(-1);
+    expect(backend.setLoginItem({})).toBe(false);
+    expect(backend.setName('X')).toBe(false);
+    expect(backend.setUserModelId('X')).toBe(false);
+    expect(backend.showApp()).toBe(false);
+  });
+
+  it('returns preferred system languages and system locale', () => {
+    const backend = createWebAppBackend();
+    expect(Array.isArray(backend.getPreferredSystemLanguages())).toBe(true);
+    expect(typeof backend.getSystemLocale()).toBe('string');
+  });
+});
+
+describe('detachApp', () => {
+  it('stops further delivery', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const app = createApp();
+    let activations = 0;
+    connectSignal(app.onActivate, () => activations++);
+    attachApp(app);
+    detachApp(app);
+    backend.fireActivate();
+    expect(activations).toBe(0);
+  });
+
+  it('is safe to call when not attached', () => {
+    expect(() => detachApp(createApp())).not.toThrow();
+  });
+});
+
+describe('disposeApp', () => {
+  it('detaches the subscription', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const app = createApp();
+    attachApp(app);
+    expect(() => disposeApp(app)).not.toThrow();
+  });
+});
+
+describe('focusApp', () => {
+  it('focuses through the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    focusApp();
+    expect(backend.focused).toBe(true);
+  });
+});
+
+describe('getAppBackend', () => {
+  it('falls back to a web backend', () => {
+    expect(getAppBackend()).not.toBeNull();
+  });
+});
+
+describe('getAppCommandLine', () => {
+  it('returns the command line from the backend', () => {
+    const backend = fakeBackend();
+    backend.commandLine = ['--flag', '--key=val'];
+    setAppBackend(backend);
+    expect(getAppCommandLine()).toEqual(['--flag', '--key=val']);
+  });
+});
+
+describe('getAppCommandLineSwitch', () => {
+  it('returns empty string for a bare flag', () => {
+    const backend = fakeBackend();
+    backend.commandLine = ['--debug'];
+    setAppBackend(backend);
+    expect(getAppCommandLineSwitch('debug')).toBe('');
+  });
+
+  it('returns the value for a key=value switch', () => {
+    const backend = fakeBackend();
+    backend.commandLine = ['--port=3000'];
+    setAppBackend(backend);
+    expect(getAppCommandLineSwitch('port')).toBe('3000');
+  });
+
+  it('returns null when the switch is absent', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppCommandLineSwitch('missing')).toBeNull();
+  });
+});
+
+describe('getAppDirectoryPath', () => {
+  it('returns the path from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppDirectoryPath('userData')).toBe('/test/app/userData');
+  });
+});
+
+describe('getAppExecutablePath', () => {
+  it('returns the executable path from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppExecutablePath()).toBe('/test/app/bin');
+  });
+});
+
+describe('getAppLocale', () => {
+  it('reads the backend locale', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppLocale()).toBe('en-US');
+  });
+});
+
+describe('getAppLoginItem', () => {
+  it('returns the login item from the backend', () => {
+    const backend = fakeBackend();
+    backend.loginItem = { args: ['--hidden'], openAsHidden: true, openAtLogin: true, path: '/app' };
+    setAppBackend(backend);
+    const item = getAppLoginItem();
+    expect(item.openAtLogin).toBe(true);
+    expect(item.openAsHidden).toBe(true);
+  });
+});
+
+describe('getAppName', () => {
+  it('reads the backend name', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppName()).toBe('TestApp');
+  });
+});
+
+describe('getAppPath', () => {
+  it('returns the app path from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppPath()).toBe('/test/app');
+  });
+});
+
+describe('getAppPreferredSystemLanguages', () => {
+  it('returns the preferred system languages from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppPreferredSystemLanguages()).toEqual(['en-US', 'fr-FR']);
+  });
+});
+
+describe('getAppSystemLocale', () => {
+  it('returns the system locale from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppSystemLocale()).toBe('en_US');
+  });
+});
+
+describe('getAppVersion', () => {
+  it('reads the backend version', () => {
+    setAppBackend(fakeBackend());
+    expect(getAppVersion()).toBe('1.2.3');
+  });
+});
+
+describe('hasAppCommandLineSwitch', () => {
+  it('returns true when the switch is present', () => {
+    const backend = fakeBackend();
+    backend.commandLine = ['--debug'];
+    setAppBackend(backend);
+    expect(hasAppCommandLineSwitch('debug')).toBe(true);
+  });
+
+  it('returns false when the switch is absent', () => {
+    setAppBackend(fakeBackend());
+    expect(hasAppCommandLineSwitch('missing')).toBe(false);
+  });
+});
+
+describe('hasAppSingleInstanceLock', () => {
+  it('reflects the backend lock state', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(hasAppSingleInstanceLock()).toBe(false);
+    requestAppSingleInstanceLock();
+    expect(hasAppSingleInstanceLock()).toBe(true);
+  });
+});
+
+describe('hideApp', () => {
+  it('hides the app and returns true from the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(hideApp()).toBe(true);
+    expect(backend.hidden).toBe(true);
+  });
+});
+
+describe('isAppHidden', () => {
+  it('reflects the backend hidden state', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(isAppHidden()).toBe(false);
+    hideApp();
+    expect(isAppHidden()).toBe(true);
+  });
+});
+
+describe('quitApp', () => {
+  it('quits without throwing', () => {
+    setAppBackend(fakeBackend());
+    expect(() => quitApp()).not.toThrow();
+  });
+});
+
+describe('relaunchApp', () => {
+  it('relaunches without throwing', () => {
+    setAppBackend(fakeBackend());
+    expect(() => relaunchApp()).not.toThrow();
+  });
+});
+
+describe('releaseAppSingleInstanceLock', () => {
+  it('releases the lock', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    requestAppSingleInstanceLock();
+    releaseAppSingleInstanceLock();
+    expect(backend.lock).toBe(false);
+  });
+});
+
+describe('requestAppAttention', () => {
+  it('returns the attention id from the backend', () => {
+    setAppBackend(fakeBackend());
+    expect(requestAppAttention(true)).toBe(42);
+  });
+});
+
+describe('requestAppSingleInstanceLock', () => {
+  it('acquires the lock', () => {
+    setAppBackend(fakeBackend());
+    expect(requestAppSingleInstanceLock()).toBe(true);
+  });
+});
+
+describe('setAppActivationPolicy', () => {
+  it('forwards the policy to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    setAppActivationPolicy('accessory');
+    expect(backend.activationPolicy).toBe('accessory');
+  });
+});
+
+describe('setAppBackend', () => {
+  it('clears back to the web fallback when passed null', () => {
+    setAppBackend(fakeBackend());
+    setAppBackend(null);
+    expect(getAppBackend()).not.toBeNull();
+  });
+});
+
+describe('setAppBadgeCount', () => {
+  it('forwards the count to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(setAppBadgeCount(5)).toBe(true);
+    expect(backend.badgeCount).toBe(5);
+  });
+
+  it('returns a boolean from the web backend without throwing', () => {
+    expect(typeof setAppBadgeCount(2)).toBe('boolean');
+  });
+});
+
+describe('setAppDockBadge', () => {
+  it('forwards the badge text to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    setAppDockBadge('3');
+    expect(backend.badge).toBe('3');
+  });
+});
+
+describe('setAppDockMenu', () => {
+  it('forwards the menu items to the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const items: readonly MenuItemTemplate[] = [{ id: 'new', label: 'New' }];
+    setAppDockMenu(items);
+    expect(backend.dockMenuItems).toBe(1);
+  });
+});
+
+describe('setAppLoginItem', () => {
+  it('updates the login item and returns true when supported', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    const settings: Readonly<AppLoginItemLike> = { openAtLogin: true, openAsHidden: false };
+    expect(setAppLoginItem(settings)).toBe(true);
+    expect(backend.loginItem.openAtLogin).toBe(true);
+  });
+
+  it('returns false on the web backend', () => {
+    expect(setAppLoginItem({ openAtLogin: true })).toBe(false);
+  });
+});
+
+describe('setAppName', () => {
+  it('updates the name via the backend and returns true', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(setAppName('MyApp')).toBe(true);
+    expect(backend.name).toBe('MyApp');
+  });
+
+  it('returns false on the web backend', () => {
+    expect(setAppName('X')).toBe(false);
+  });
+});
+
+describe('setAppUserModelId', () => {
+  it('forwards the ID to the backend and returns true', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    expect(setAppUserModelId('com.example.app')).toBe(true);
+    expect(backend.userModelId).toBe('com.example.app');
+  });
+
+  it('returns false on the web backend', () => {
+    expect(setAppUserModelId('X')).toBe(false);
+  });
+});
+
+describe('showApp', () => {
+  it('shows the app and returns true from the backend', () => {
+    const backend = fakeBackend();
+    setAppBackend(backend);
+    hideApp();
+    expect(showApp()).toBe(true);
+    expect(backend.hidden).toBe(false);
+  });
+});