@flighthq/app 0.5.0-next.1944.cd6b6e7 → 0.5.1-edge.638.d4dbd4e

package/README.md

@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/app`. The `@flighthq
 This package is part of the locked-version Flight SDK graph. Applications may instead install and import `@flighthq/sdk` when package-level tree shaking is sufficient.
 
 - [Flight project](https://github.com/flighthq/flight)
-- [Source for @flighthq/app@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/app)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/app@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/app)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/app.d.ts

@@ -1,48 +1,45 @@
-import type { App, AppActivationPolicy, AppBackend, AppLoginItem, AppLoginItemLike, AppPathKind, MenuItemTemplate } from '@flighthq/types/contract';
-import type { BackendExplanation } from '@flighthq/types/contract';
-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;
+import type { App, AppActivationPolicy, AppLoginItem, AppLoginItemLike, AppPathKind, HasAppActivate, HasAppActivationPolicy, HasAppAllWindowsClosed, HasAppBadge, HasAppDock, HasAppFocus, HasAppHiddenQuery, HasAppHide, HasAppLocale, HasAppLoginItem, HasAppName, HasAppNameWrite, HasAppOpenFile, HasAppPath, HasAppQuit, HasAppQuitRequest, HasAppReady, HasAppRecentDocuments, HasAppRelaunch, HasAppSecondInstance, HasAppShow, HasAppSingleInstance, HasAppUserModelId, HasAppVersion, MenuItemTemplate } from '@flighthq/types/contract';
+type HasAllAppEvents = HasAppActivate & HasAppAllWindowsClosed & HasAppOpenFile & HasAppQuitRequest & HasAppReady & HasAppSecondInstance;
+export declare function addAppRecentDocument(host: HasAppRecentDocuments, path: string): void;
+export declare function attachApp(host: HasAllAppEvents, app: App): void;
+export declare function attachAppActivate(host: HasAppActivate, app: App): void;
+export declare function attachAppAllWindowsClosed(host: HasAppAllWindowsClosed, app: App): void;
+export declare function attachAppOpenFile(host: HasAppOpenFile, app: App): void;
+export declare function attachAppQuitRequest(host: HasAppQuitRequest, app: App): void;
+export declare function attachAppReady(host: HasAppReady, app: App): void;
+export declare function attachAppSecondInstance(host: HasAppSecondInstance, app: App): void;
+export declare function bounceAppDock(host: HasAppDock): number;
+export declare function cancelAppAttention(host: HasAppDock, id: number): void;
+export declare function cancelAppDockBounce(host: HasAppDock, id: number): void;
+export declare function clearAppRecentDocuments(host: HasAppRecentDocuments): void;
 export declare function createApp(): App;
-export declare function createAppLoginItem(): AppLoginItem;
 export declare function detachApp(app: App): void;
 export declare function disposeApp(app: App): void;
-export declare function explainAppBackend(): BackendExplanation;
-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 installAppHostBackend(backend: AppBackend): void;
-export declare function isAppHidden(): boolean;
-export declare function observeAppHostResult(operation: string, succeeded: boolean): void;
-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 resetAppBackendForTest(): void;
-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;
+export declare function focusApp(host: HasAppFocus): void;
+export declare function getAppDirectoryPath(host: HasAppPath, kind: AppPathKind): string;
+export declare function getAppExecutablePath(host: HasAppPath): string;
+export declare function getAppLocale(host: HasAppLocale): string;
+export declare function getAppLoginItem(host: HasAppLoginItem): AppLoginItem;
+export declare function getAppName(host: HasAppName): string;
+export declare function getAppPath(host: HasAppPath): string;
+export declare function getAppPreferredSystemLanguages(host: HasAppLocale): readonly string[];
+export declare function getAppSystemLocale(host: HasAppLocale): string;
+export declare function getAppVersion(host: HasAppVersion): string;
+export declare function hasAppSingleInstanceLock(host: HasAppSingleInstance): boolean;
+export declare function hideApp(host: HasAppHide): void;
+export declare function isAppHidden(host: HasAppHiddenQuery): boolean;
+export declare function quitApp(host: HasAppQuit): void;
+export declare function relaunchApp(host: HasAppRelaunch): void;
+export declare function releaseAppSingleInstanceLock(host: HasAppSingleInstance): void;
+export declare function requestAppAttention(host: HasAppDock, critical: boolean): number;
+export declare function requestAppSingleInstanceLock(host: HasAppSingleInstance): boolean;
+export declare function setAppActivationPolicy(host: HasAppActivationPolicy, policy: AppActivationPolicy): void;
+export declare function setAppBadgeCount(host: HasAppBadge, count: number): Promise<boolean>;
+export declare function setAppDockBadge(host: HasAppDock, text: string): void;
+export declare function setAppDockMenu(host: HasAppDock, items: readonly MenuItemTemplate[]): void;
+export declare function setAppLoginItem(host: HasAppLoginItem, settings: Readonly<AppLoginItemLike>): void;
+export declare function setAppName(host: HasAppNameWrite, name: string): void;
+export declare function setAppUserModelId(host: HasAppUserModelId, id: string): void;
+export declare function showApp(host: HasAppShow): void;
+export {};
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,GAAG,EACH,mBAAmB,EACnB,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,sBAAsB,EACtB,sBAAsB,EACtB,WAAW,EACX,UAAU,EACV,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,eAAe,EACf,cAAc,EACd,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,qBAAqB,EACrB,cAAc,EACd,oBAAoB,EACpB,UAAU,EACV,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAElC,KAAK,eAAe,GAAG,cAAc,GACnC,sBAAsB,GACtB,cAAc,GACd,iBAAiB,GACjB,WAAW,GACX,oBAAoB,CAAC;AAWvB,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpF;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAQ/D;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMtE;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,sBAAsB,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMtF;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,cAAc,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMtE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,iBAAiB,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAS5E;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMhE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,EAAE,GAAG,EAAE,GAAG,GAAG,IAAI,CAMlF;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEtD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAErE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAEtE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,qBAAqB,GAAG,IAAI,CAEzE;AAED,wBAAgB,SAAS,IAAI,GAAG,CAS/B;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAKxC;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAQzC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEhD;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAE/E;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAE7D;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEvD;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,YAAY,CAEnE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,UAAU,GAAG,MAAM,CAEnD;AAED,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAEpF;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAEzD;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAE5E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAE5D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE9C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CAEtD;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAE7E;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,CAE/E;AAED,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAEhF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,EAAE,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAEtG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAEzF;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,IAAI,CAEjG;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAEpE;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAE3E;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI,CAE9C"}

package/dist/app.js

@@ -1,351 +1,161 @@
-import { createSignal, emitSignal } from '@flighthq/signals/contract';
-// 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) {
+import { createEntity } from '@flighthq/entity/contract';
+import { clearSignal, createSignal, emitSignal } from '@flighthq/signals/contract';
+export function addAppRecentDocument(host, path) {
+    host.app.recentDocuments.addRecentDocument(path);
+}
+export function attachApp(host, 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) => {
+    attachAppActivate(host, app);
+    attachAppAllWindowsClosed(host, app);
+    attachAppOpenFile(host, app);
+    attachAppQuitRequest(host, app);
+    attachAppReady(host, app);
+    attachAppSecondInstance(host, app);
+}
+export function attachAppActivate(host, app) {
+    replaceAppSubscription(app, 'activate', host.app.activate.subscribe(() => emitSignal(app.onActivate)));
+}
+export function attachAppAllWindowsClosed(host, app) {
+    replaceAppSubscription(app, 'allWindowsClosed', host.app.allWindowsClosed.subscribe(() => emitSignal(app.onAllWindowsClosed)));
+}
+export function attachAppOpenFile(host, app) {
+    replaceAppSubscription(app, 'openFile', host.app.openFile.subscribe((path) => emitSignal(app.onOpenFile, path)));
+}
+export function attachAppQuitRequest(host, app) {
+    replaceAppSubscription(app, 'quitRequest', host.app.quitRequest.subscribe((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.
+        if (app.onQuitRequest.data?.cancelled === true)
             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();
-    });
+    }));
+}
+export function attachAppReady(host, app) {
+    replaceAppSubscription(app, 'ready', host.app.ready.subscribe(() => emitSignal(app.onReady)));
+}
+export function attachAppSecondInstance(host, app) {
+    replaceAppSubscription(app, 'secondInstance', host.app.secondInstance.subscribe((argv) => emitSignal(app.onSecondInstance, argv)));
 }
-// Starts a dock bounce; returns a request id usable with cancelAppDockBounce, or -1 when unsupported.
-export function bounceAppDock() {
-    return getAppBackend().bounceDock();
+export function bounceAppDock(host) {
+    return host.app.dock.bounceDock();
 }
-// Cancels an app-level attention request previously started by requestAppAttention. No-op on web.
-export function cancelAppAttention(id) {
-    getAppBackend().cancelAttention(id);
+export function cancelAppAttention(host, id) {
+    host.app.dock.cancelAttention(id);
 }
-// Cancels a dock bounce previously started by bounceAppDock.
-export function cancelAppDockBounce(id) {
-    getAppBackend().cancelDockBounce(id);
+export function cancelAppDockBounce(host, id) {
+    host.app.dock.cancelDockBounce(id);
 }
-// Clears the system's recent-documents list (Jump List / macOS recents). No-op on web.
-export function clearAppRecentDocuments() {
-    getAppBackend().clearRecentDocuments();
+export function clearAppRecentDocuments(host) {
+    host.app.recentDocuments.clearRecentDocuments();
 }
-// Allocates an App event entity with inert signals; call attachApp to start delivery.
 export function createApp() {
-    return {
+    return createEntity({
         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: '' };
+    });
 }
-// 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.
+    const subscriptions = _subscriptions.get(app);
+    if (subscriptions === undefined)
+        return;
+    _subscriptions.delete(app);
+    for (const unsubscribe of Object.values(subscriptions))
+        unsubscribe?.();
+}
 export function disposeApp(app) {
     detachApp(app);
+    clearSignal(app.onActivate);
+    clearSignal(app.onAllWindowsClosed);
+    clearSignal(app.onOpenFile);
+    clearSignal(app.onQuitRequest);
+    clearSignal(app.onReady);
+    clearSignal(app.onSecondInstance);
+}
+export function focusApp(host) {
+    host.app.focus.focus();
+}
+export function getAppDirectoryPath(host, kind) {
+    return host.app.path.getAppDirectoryPath(kind);
+}
+export function getAppExecutablePath(host) {
+    return host.app.path.getExecutablePath();
+}
+export function getAppLocale(host) {
+    return host.app.locale.getLocale();
+}
+export function getAppLoginItem(host) {
+    return host.app.loginItem.getLoginItem();
+}
+export function getAppName(host) {
+    return host.app.name.getName();
+}
+export function getAppPath(host) {
+    return host.app.path.getAppPath();
+}
+export function getAppPreferredSystemLanguages(host) {
+    return host.app.locale.getPreferredSystemLanguages();
+}
+export function getAppSystemLocale(host) {
+    return host.app.locale.getSystemLocale();
+}
+export function getAppVersion(host) {
+    return host.app.version.getVersion();
+}
+export function hasAppSingleInstanceLock(host) {
+    return host.app.singleInstance.hasSingleInstanceLock();
+}
+export function hideApp(host) {
+    host.app.hide.hideApp();
+}
+export function isAppHidden(host) {
+    return host.app.hiddenQuery.isAppHidden();
+}
+export function quitApp(host) {
+    host.app.quit.quit();
+}
+export function relaunchApp(host) {
+    host.app.relaunch.relaunch();
+}
+export function releaseAppSingleInstanceLock(host) {
+    host.app.singleInstance.releaseSingleInstanceLock();
+}
+export function requestAppAttention(host, critical) {
+    return host.app.dock.requestAttention(critical);
+}
+export function requestAppSingleInstanceLock(host) {
+    return host.app.singleInstance.requestSingleInstanceLock();
+}
+export function setAppActivationPolicy(host, policy) {
+    host.app.activationPolicy.setActivationPolicy(policy);
+}
+export function setAppBadgeCount(host, count) {
+    return host.app.badge.setBadgeCount(count);
+}
+export function setAppDockBadge(host, text) {
+    host.app.dock.setDockBadge(text);
+}
+export function setAppDockMenu(host, items) {
+    host.app.dock.setDockMenu(items);
+}
+export function setAppLoginItem(host, settings) {
+    host.app.loginItem.setLoginItem(settings);
+}
+export function setAppName(host, name) {
+    host.app.nameWrite.setName(name);
+}
+export function setAppUserModelId(host, id) {
+    host.app.userModelId.setUserModelId(id);
+}
+export function showApp(host) {
+    host.app.show.showApp();
 }
-export function explainAppBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
-    }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
-    }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
-}
-// Brings the application to the foreground.
-export function focusApp() {
-    getAppBackend().focus();
-}
-export function getAppBackend() {
-    return _custom ?? _host ?? _sentinel;
-}
-// 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();
-}
-export function installAppHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
-}
-// True when the application is hidden (macOS only). Always false on web.
-export function isAppHidden() {
-    return getAppBackend().isAppHidden();
-}
-export function observeAppHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
-}
-// 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();
-}
-export function resetAppBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-// 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);
-}
-export function setAppBackend(backend) {
-    _custom = 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();
-}
-const _noop = () => () => { };
-const _sentinel = {
-    addRecentDocument() { },
-    bounceDock() {
-        return -1;
-    },
-    cancelAttention() { },
-    cancelDockBounce() { },
-    clearRecentDocuments() { },
-    focus() { },
-    getAppDirectoryPath() {
-        return '';
-    },
-    getAppPath() {
-        return '';
-    },
-    getCommandLine() {
-        return [];
-    },
-    getExecutablePath() {
-        return '';
-    },
-    getLocale() {
-        return '';
-    },
-    getLoginItem() {
-        return { args: [], openAsHidden: false, openAtLogin: false, path: '' };
-    },
-    getName() {
-        return '';
-    },
-    getPreferredSystemLanguages() {
-        return [];
-    },
-    getSystemLocale() {
-        try {
-            return typeof Intl !== 'undefined' ? new Intl.DateTimeFormat().resolvedOptions().locale : '';
-        }
-        catch {
-            return '';
-        }
-    },
-    getVersion() {
-        return '';
-    },
-    hasSingleInstanceLock() {
-        return false;
-    },
-    hideApp() {
-        return false;
-    },
-    isAppHidden() {
-        return false;
-    },
-    quit() { },
-    relaunch() { },
-    releaseSingleInstanceLock() { },
-    requestAttention() {
-        return -1;
-    },
-    requestSingleInstanceLock() {
-        return false;
-    },
-    setActivationPolicy() { },
-    setBadgeCount() {
-        return false;
-    },
-    setDockBadge() { },
-    setDockMenu() { },
-    setLoginItem() {
-        return false;
-    },
-    setName() {
-        return false;
-    },
-    setUserModelId() {
-        return false;
-    },
-    showApp() {
-        return false;
-    },
-    subscribeActivate: _noop,
-    subscribeAllWindowsClosed: _noop,
-    subscribeOpenFile: _noop,
-    subscribeQuitRequest: _noop,
-    subscribeReady: _noop,
-    subscribeSecondInstance: _noop,
-};
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
 const _subscriptions = new WeakMap();
+function replaceAppSubscription(app, key, unsubscribe) {
+    const subscriptions = _subscriptions.get(app) ?? {};
+    subscriptions[key]?.();
+    subscriptions[key] = unsubscribe;
+    _subscriptions.set(app, subscriptions);
+}
 //# sourceMappingURL=app.js.map