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

package/README.md

@@ -1,6 +1,6 @@
 # @flighthq/tray
 
-Tray icon and application badge over a swappable web/native backend
+Capability-refined tray icon Entities over explicitly injected host facets
 
 ## Install
 
@@ -13,5 +13,5 @@ Import the supported application-facing API from `@flighthq/tray`. The `@flighth
 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/tray@0.5.0-next.1944.cd6b6e7](https://github.com/flighthq/flight/tree/cd6b6e71eb472b3a4249830a7743333f019fa7b7/packages/tray)
-- [License](https://github.com/flighthq/flight/blob/cd6b6e71eb472b3a4249830a7743333f019fa7b7/LICENSE.md)
+- [Source for @flighthq/tray@0.5.1-edge.638.d4dbd4e](https://github.com/flighthq/flight/tree/d4dbd4e347dc8be10b180c85a766ab50333dcb51/packages/tray)
+- [License](https://github.com/flighthq/flight/blob/d4dbd4e347dc8be10b180c85a766ab50333dcb51/LICENSE.md)

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { disableTrayGuards, enableTrayGuards, createTrayIcon, destroyTrayIcon, displayTrayBalloon, explainTrayBackend, getTrayCapabilities, getTrayIconBounds, getTrayIconTitle, getTrayIconTooltip, getTrayIcons, isTrayDestroyed, isTrayIconAnimating, onTrayEvent, popupTrayContextMenu, removeTrayBalloon, setTrayIcon, setTrayIconContextMenu, setTrayIconTemplate, setTrayIconTitle, setTrayIconTooltip, setTrayIgnoreDoubleClickEvents, setTrayPressedIcon, startTrayIconAnimation, stopTrayIconAnimation, } from './contract';
+export { disableTrayGuards, enableTrayGuards, createTrayIcon, destroyTrayIcon, displayTrayBalloon, getTrayIconBounds, getTrayIconTitle, getTrayIconTooltip, getTrayIcons, isTrayDestroyed, isTrayIconAnimating, onTrayBalloonEvent, onTrayDrop, onTrayInteraction, onTrayMenuSelection, popupTrayContextMenu, removeTrayBalloon, setTrayIcon, setTrayIconContextMenu, setTrayIconTemplate, setTrayIconTitle, setTrayIconTooltip, setTrayIgnoreDoubleClickEvents, setTrayPressedIcon, startTrayIconAnimation, stopTrayIconAnimation, } from './contract';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,2 +1,2 @@
-export { disableTrayGuards, enableTrayGuards, createTrayIcon, destroyTrayIcon, displayTrayBalloon, explainTrayBackend, getTrayCapabilities, getTrayIconBounds, getTrayIconTitle, getTrayIconTooltip, getTrayIcons, isTrayDestroyed, isTrayIconAnimating, onTrayEvent, popupTrayContextMenu, removeTrayBalloon, setTrayIcon, setTrayIconContextMenu, setTrayIconTemplate, setTrayIconTitle, setTrayIconTooltip, setTrayIgnoreDoubleClickEvents, setTrayPressedIcon, startTrayIconAnimation, stopTrayIconAnimation, } from './contract';
+export { disableTrayGuards, enableTrayGuards, createTrayIcon, destroyTrayIcon, displayTrayBalloon, getTrayIconBounds, getTrayIconTitle, getTrayIconTooltip, getTrayIcons, isTrayDestroyed, isTrayIconAnimating, onTrayBalloonEvent, onTrayDrop, onTrayInteraction, onTrayMenuSelection, popupTrayContextMenu, removeTrayBalloon, setTrayIcon, setTrayIconContextMenu, setTrayIconTemplate, setTrayIconTitle, setTrayIconTooltip, setTrayIgnoreDoubleClickEvents, setTrayPressedIcon, startTrayIconAnimation, stopTrayIconAnimation, } from './contract';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,EACZ,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,UAAU,EACV,iBAAiB,EACjB,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/tray.d.ts

@@ -1,36 +1,27 @@
-import type { BackendExplanation } from '@flighthq/types/contract';
-import type { MenuItemTemplate, RectangleLike, TrayBackend, TrayBalloonOptions, TrayCapabilities, TrayEventData, TrayIcon, TrayIconOptions } from '@flighthq/types/contract';
-import type { Vector2Like } from '@flighthq/types/contract';
-export declare function createTrayIcon(options?: Readonly<TrayIconOptions>): TrayIcon | null;
-export declare function destroyTrayIcon(tray: TrayIcon): void;
-export declare function displayTrayBalloon(tray: TrayIcon, options: Readonly<TrayBalloonOptions>): void;
-export declare function explainTrayBackend(): BackendExplanation;
-export declare function getTrayBackend(): TrayBackend;
-export declare function getTrayCapabilities(): Readonly<TrayCapabilities>;
-export declare function getTrayIconBounds(tray: TrayIcon): Readonly<RectangleLike> | null;
-export declare function getTrayIcons(): readonly TrayIcon[];
-export declare function getTrayIconTitle(tray: TrayIcon): string;
-export declare function getTrayIconTooltip(tray: TrayIcon): string;
-export declare function installTrayHostBackend(backend: TrayBackend): void;
-export declare function isTrayDestroyed(tray: TrayIcon): boolean;
-export declare function isTrayIconAnimating(tray: TrayIcon): boolean;
-export declare function observeTrayHostResult(operation: string, succeeded: boolean): void;
-export declare function onTrayEvent(listener: (event: Readonly<TrayEventData>) => void): () => void;
-export declare function popupTrayContextMenu(tray: TrayIcon, position?: Readonly<Vector2Like>): void;
-export declare function removeTrayBalloon(tray: TrayIcon): void;
-export declare function resetTrayBackendForTest(): void;
-/** Installs the tray guard, or clears it with `null`. The seam exists so the messages and the
- *  `@flighthq/log` dependency live in the separately-importable guard module rather than here; not
- *  importing that module costs production nothing. Called by `enableTrayGuards`, not directly. */
+import type { HasTrayLifecycle, MenuItemTemplate, TrayAnimationStartResult, TrayAnimationStopResult, TrayBalloonDisplayResult, TrayBalloonEvent, TrayBalloonOptions, TrayBalloonRemoveResult, TrayBoundsResult, TrayCreateResult, TrayDestroyResult, TrayDoubleClickPolicyUpdateResult, TrayDropEvent, TrayEventAttachResult, TrayIcon, TrayIconForHost, TrayIconOptions, TrayIconSource, TrayImageUpdateResult, TrayInteractionEvent, TrayMenuSelectionEvent, TrayMenuUpdateResult, TrayPopupMenuResult, TrayPressedImageUpdateResult, TrayTemplateImageUpdateResult, TrayTitleReadResult, TrayTitleUpdateResult, TrayTooltipReadResult, TrayTooltipUpdateResult, TrayWithBalloon, TrayWithBalloonEvents, TrayWithBounds, TrayWithDoubleClickPolicy, TrayWithDropEvents, TrayWithImage, TrayWithInteractionEvents, TrayWithMenu, TrayWithMenuSelectionEvents, TrayWithPopupMenu, TrayWithPressedImage, TrayWithTemplateImage, TrayWithTitle, TrayWithTooltip, Vector2Like } from '@flighthq/types/contract';
+export declare function createTrayIcon<HostType extends HasTrayLifecycle>(host: HostType, options?: Readonly<TrayIconOptions>): Promise<TrayCreateResult<TrayIconForHost<HostType>>>;
+export declare function destroyTrayIcon(tray: TrayIcon): Promise<TrayDestroyResult>;
+export declare function displayTrayBalloon(tray: TrayWithBalloon, options: Readonly<TrayBalloonOptions>): Promise<TrayBalloonDisplayResult>;
+export declare function getTrayIconBounds(tray: TrayWithBounds): Promise<TrayBoundsResult>;
+export declare function getTrayIcons(host: HasTrayLifecycle): readonly TrayIcon[];
+export declare function getTrayIconTitle(tray: TrayWithTitle): Promise<TrayTitleReadResult>;
+export declare function getTrayIconTooltip(tray: TrayWithTooltip): Promise<TrayTooltipReadResult>;
+export declare function isTrayDestroyed(tray: Readonly<TrayIcon>): boolean;
+export declare function isTrayIconAnimating(tray: Readonly<TrayIcon>): boolean;
+export declare function onTrayBalloonEvent(tray: TrayWithBalloonEvents, listener: (event: Readonly<TrayBalloonEvent>) => void): TrayEventAttachResult;
+export declare function onTrayDrop(tray: TrayWithDropEvents, listener: (event: Readonly<TrayDropEvent>) => void): TrayEventAttachResult;
+export declare function onTrayInteraction(tray: TrayWithInteractionEvents, listener: (event: Readonly<TrayInteractionEvent>) => void): TrayEventAttachResult;
+export declare function onTrayMenuSelection(tray: TrayWithMenuSelectionEvents, listener: (event: Readonly<TrayMenuSelectionEvent>) => void): TrayEventAttachResult;
+export declare function popupTrayContextMenu(tray: TrayWithPopupMenu, position?: Readonly<Vector2Like>): Promise<TrayPopupMenuResult>;
+export declare function removeTrayBalloon(tray: TrayWithBalloon): Promise<TrayBalloonRemoveResult>;
 export declare function setTrayAnimationGuard(guard: ((tray: TrayIcon, frameCount: number, intervalMs: number) => void) | null): void;
-export declare function setTrayBackend(backend: TrayBackend | null): void;
-export declare function setTrayIcon(tray: TrayIcon, icon: string): void;
-export declare function setTrayIconContextMenu(tray: TrayIcon, items: readonly MenuItemTemplate[]): void;
-export declare function setTrayIconTemplate(tray: TrayIcon, isTemplate: boolean): void;
-export declare function setTrayIconTitle(tray: TrayIcon, title: string): void;
-export declare function setTrayIconTooltip(tray: TrayIcon, tooltip: string): void;
-export declare function setTrayIgnoreDoubleClickEvents(tray: TrayIcon, ignore: boolean): void;
-export declare function setTrayPressedIcon(tray: TrayIcon, icon: string): void;
-export declare function startTrayIconAnimation(tray: TrayIcon, frames: readonly string[], intervalMs: number): () => void;
-export declare function stopTrayIconAnimation(tray: TrayIcon): void;
+export declare function setTrayIcon(tray: TrayWithImage, icon: TrayIconSource): Promise<TrayImageUpdateResult>;
+export declare function setTrayIconContextMenu(tray: TrayWithMenu, items: readonly MenuItemTemplate[]): Promise<TrayMenuUpdateResult>;
+export declare function setTrayIconTemplate(tray: TrayWithTemplateImage, isTemplate: boolean): Promise<TrayTemplateImageUpdateResult>;
+export declare function setTrayIconTitle(tray: TrayWithTitle, title: string): Promise<TrayTitleUpdateResult>;
+export declare function setTrayIconTooltip(tray: TrayWithTooltip, tooltip: string): Promise<TrayTooltipUpdateResult>;
+export declare function setTrayIgnoreDoubleClickEvents(tray: TrayWithDoubleClickPolicy, ignore: boolean): Promise<TrayDoubleClickPolicyUpdateResult>;
+export declare function setTrayPressedIcon(tray: TrayWithPressedImage, icon: TrayIconSource): Promise<TrayPressedImageUpdateResult>;
+export declare function startTrayIconAnimation(tray: TrayWithImage, frames: readonly TrayIconSource[], intervalMs: number): Promise<TrayAnimationStartResult>;
+export declare function stopTrayIconAnimation(tray: TrayIcon): TrayAnimationStopResult;
 //# sourceMappingURL=tray.d.ts.map

package/dist/tray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,QAAQ,EACR,eAAe,EAChB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAgB5D,wBAAgB,cAAc,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,eAAe,CAAC,GAAG,QAAQ,GAAG,IAAI,CAGnF;AAOD,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAGpD;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,IAAI,CAE9F;AAED,wBAAgB,kBAAkB,IAAI,kBAAkB,CAavD;AAGD,wBAAgB,cAAc,IAAI,WAAW,CAE5C;AAKD,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAEhE;AAID,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI,CAEhF;AAGD,wBAAgB,YAAY,IAAI,SAAS,QAAQ,EAAE,CAIlD;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEvD;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAEzD;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAMjE;AAID,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEvD;AAID,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,IAAI,CAKjF;AAKD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC,aAAa,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI,CAE1F;AAKD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,IAAI,CAE3F;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAEtD;AAED,wBAAgB,uBAAuB,IAAI,IAAI,CAK9C;AAED;;kGAEkG;AAClG,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,GAC/E,IAAI,CAEN;AAGD,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI,CAEhE;AAID,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9D;AAID,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,gBAAgB,EAAE,GAAG,IAAI,CAE/F;AAKD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,GAAG,IAAI,CAE7E;AAGD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAEpE;AAGD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAExE;AAID,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAEpF;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAErE;AAcD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,IAAI,CAiBhH;AAYD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI,CAK1D"}
+{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../src/tray.ts"],"names":[],"mappings":"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"}

package/dist/tray.js

@@ -1,283 +1,231 @@
-// Web tray capability constants. Web has no system tray — all capabilities are false. Readonly and
-// shared: getCapabilities hands this same object to every caller, so a mutable one would let any of
-// them rewrite what the backend reports to all the others.
-const WEB_CAPABILITIES = {
-    balloon: false,
-    bounds: false,
-    clickEvents: false,
-    dropFiles: false,
-    pressedIcon: false,
-    title: false,
-};
-// Creates a tray icon, or null when the host has no system tray (e.g. web). The backend returns -1 to
-// signal no tray; this translates that to a null sentinel for the caller.
-export function createTrayIcon(options) {
-    const id = getTrayBackend().create(options ?? {});
-    return id < 0 ? null : { id };
-}
-// Destroys a tray icon and frees its host resource. No-op when the host has no tray.
-// Any icon animation running on this tray is stopped first: the interval writes through setTrayIcon,
-// and left running it would keep calling into a resource the host has freed — forever, since the
-// timer holds its own closure alive. Destroying the thing being animated is the clearest possible
-// signal that the animation is over, so the caller does not have to have kept the stop function.
-export function destroyTrayIcon(tray) {
-    stopTrayIconAnimation(tray);
-    getTrayBackend().destroy(tray.id);
-}
-// Displays a Windows balloon notification from the tray icon. No-op on macOS/Linux and on web.
-// Balloon lifecycle events (balloonShow/balloonClick/balloonClose) are emitted via onTrayEvent.
-export function displayTrayBalloon(tray, options) {
-    getTrayBackend().displayBalloon(tray.id, options);
-}
-export function explainTrayBackend() {
-    if (_custom !== null) {
-        return { conflict: _hostConflict, layer: 'custom', operation: null, viability: 'unobserved' };
+import { createEntity, createEntityRuntime } from '@flighthq/entity/contract';
+import { connectSignal, disconnectSignal } from '@flighthq/signals/contract';
+import { EntityRuntimeKey } from '@flighthq/types/contract';
+export async function createTrayIcon(host, options = {}) {
+    const tray = createEntity();
+    let result;
+    try {
+        result = await host.tray.lifecycle.create(tray, options);
     }
-    if (_host !== null) {
-        return {
-            conflict: _hostConflict,
-            layer: 'host',
-            operation: _hostObservation !== null ? _hostObservation.operation : null,
-            viability: _hostObservation !== null ? _hostObservation.viability : 'unobserved',
-        };
+    catch (error) {
+        return { error, outcome: 'tray-create-failed' };
     }
-    return { conflict: false, layer: 'host-not-enabled', operation: null, viability: 'unobserved' };
+    if (result.outcome !== 'created')
+        return result;
+    const runtime = createEntityRuntime();
+    runtime.animationGeneration = 0;
+    runtime.animationTimer = null;
+    runtime.animationWriteTail = Promise.resolve();
+    runtime.capabilities = { ...host.tray };
+    runtime.destroyPromise = null;
+    runtime.lifecycle = host.tray.lifecycle;
+    runtime.releases = new Set();
+    runtime.state = 'active';
+    tray[EntityRuntimeKey] = runtime;
+    return { outcome: 'created', tray };
 }
-// The active tray backend. Precedence: custom > host > sentinel.
-export function getTrayBackend() {
-    return _custom ?? _host ?? _sentinel;
+export function destroyTrayIcon(tray) {
+    const runtime = getTrayRuntime(tray);
+    if (runtime === null || runtime.state === 'destroyed')
+        return Promise.resolve({ outcome: 'already-destroyed' });
+    if (runtime.destroyPromise !== null)
+        return runtime.destroyPromise;
+    runtime.destroyPromise = destroyTrayRuntime(tray, runtime).finally(() => {
+        runtime.destroyPromise = null;
+    });
+    return runtime.destroyPromise;
 }
-// Returns the capability flags for the active tray backend. Use before calling APIs that may
-// silently no-op — for example, check capabilities.balloon before displayTrayBalloon, or
-// capabilities.bounds before getTrayIconBounds. On web all flags are false.
-export function getTrayCapabilities() {
-    return getTrayBackend().getCapabilities();
+export function displayTrayBalloon(tray, options) {
+    return invokeUpdate(tray, 'balloon', 'balloon-display-failed', (backend) => backend.display(tray, options));
 }
-// Returns the screen bounds of the tray icon (x/y/width/height), or null when the platform does not
-// expose icon geometry (Linux/AppIndicator, web). Use for anchoring popovers or windows to the icon.
 export function getTrayIconBounds(tray) {
-    return getTrayBackend().getBounds(tray.id);
+    return invokeRead(tray, 'bounds', 'bounds-read-failed', (backend) => backend.get(tray));
+}
+async function destroyTrayRuntime(tray, runtime) {
+    runtime.state = 'destroying';
+    stopTrayAnimationRuntime(runtime);
+    for (const release of [...runtime.releases])
+        await release.release();
+    let result;
+    try {
+        result = await runtime.lifecycle.destroy(tray);
+    }
+    catch (error) {
+        result = { failures: [{ error, step: 'native-resource' }], outcome: 'tray-destroy-failed' };
+    }
+    if (result.outcome === 'destroyed') {
+        runtime.state = 'destroyed';
+        return result;
+    }
+    runtime.state = 'partially-destroyed';
+    return result;
 }
-// Returns all live tray icon handles known to the active backend. On web this is always empty.
-export function getTrayIcons() {
-    return getTrayBackend()
-        .listIds()
-        .map((id) => ({ id }));
+export function getTrayIcons(host) {
+    return host.tray.lifecycle.list();
 }
-// Returns the current title text of a tray icon, or an empty string when unavailable (web, non-macOS).
 export function getTrayIconTitle(tray) {
-    return getTrayBackend().getTitle(tray.id);
+    return invokeRead(tray, 'title', 'title-read-failed', (backend) => backend.get(tray));
 }
-// Returns the current hover tooltip text of a tray icon, or an empty string when unavailable (web).
 export function getTrayIconTooltip(tray) {
-    return getTrayBackend().getTooltip(tray.id);
-}
-export function installTrayHostBackend(backend) {
-    if (_host !== null) {
-        if (_host !== backend)
-            _hostConflict = true;
-        return;
-    }
-    _host = backend;
+    return invokeRead(tray, 'tooltip', 'tooltip-read-failed', (backend) => backend.get(tray));
 }
-// Returns whether a tray icon has been destroyed. Returns true on web (no trays exist).
-// Use this to guard calls after destroyTrayIcon when the tray lifecycle is unclear.
 export function isTrayDestroyed(tray) {
-    return getTrayBackend().isDestroyed(tray.id);
+    const runtime = getTrayRuntime(tray);
+    return runtime === null || runtime.state !== 'active' || runtime.lifecycle.isDestroyed(tray);
 }
-// True while an icon animation started by startTrayIconAnimation is running on this tray. False once
-// it is stopped, replaced by a later start, or the tray is destroyed.
 export function isTrayIconAnimating(tray) {
-    return _animations.has(tray.id);
+    return getTrayRuntime(tray)?.animationTimer !== null;
 }
-export function observeTrayHostResult(operation, succeeded) {
-    _hostObservation = {
-        operation,
-        viability: succeeded ? 'available' : 'runtime-api-unavailable',
-    };
+export function onTrayBalloonEvent(tray, listener) {
+    return attachTrayEvent(tray, 'balloonEvents', listener);
+}
+export function onTrayDrop(tray, listener) {
+    return attachTrayEvent(tray, 'dropEvents', listener);
+}
+export function onTrayInteraction(tray, listener) {
+    return attachTrayEvent(tray, 'interactionEvents', listener);
 }
-// Subscribes to tray icon events, delivering a rich TrayEventData payload (id, type, bounds,
-// position, modifier keys, and drop payloads). Returns an unsubscribe function. On web this
-// never fires (no tray); a native host is required.
-export function onTrayEvent(listener) {
-    return getTrayBackend().subscribe(listener);
+export function onTrayMenuSelection(tray, listener) {
+    return attachTrayEvent(tray, 'menuSelectionEvents', listener);
 }
-// Programmatically shows the attached context menu, optionally at a specific screen position.
-// On web this is a no-op. Useful for showing the menu in response to a custom gesture or shortcut
-// without waiting for the user to right-click the tray icon.
 export function popupTrayContextMenu(tray, position) {
-    getTrayBackend().popUpContextMenu(tray.id, position);
+    return invokeUpdate(tray, 'popupMenu', 'popup-failed', (backend) => backend.popup(tray, position));
 }
-// Dismisses the currently-displayed Windows balloon notification. No-op on macOS/Linux and web.
 export function removeTrayBalloon(tray) {
-    getTrayBackend().removeBalloon(tray.id);
+    return invokeUpdate(tray, 'balloon', 'balloon-remove-failed', (backend) => backend.remove(tray));
 }
-export function resetTrayBackendForTest() {
-    _custom = null;
-    _host = null;
-    _hostConflict = false;
-    _hostObservation = null;
-}
-/** Installs the tray guard, or clears it with `null`. The seam exists so the messages and the
- *  `@flighthq/log` dependency live in the separately-importable guard module rather than here; not
- *  importing that module costs production nothing. Called by `enableTrayGuards`, not directly. */
 export function setTrayAnimationGuard(guard) {
     _animationGuard = guard;
 }
-// Installs a custom tray backend; pass null to clear the custom override.
-export function setTrayBackend(backend) {
-    _custom = backend;
-}
-// Sets the image for the tray icon. Accepts the same icon path/data-URI accepted by createTrayIcon.
-// Use this for runtime status updates (indicators, spinners, theme changes).
 export function setTrayIcon(tray, icon) {
-    getTrayBackend().setIcon(tray.id, icon);
+    return invokeUpdate(tray, 'image', 'image-update-failed', (backend) => backend.set(tray, icon));
 }
-// Sets the context menu attached to a tray icon. Shown on right-click (or popupTrayContextMenu).
-// No-op when the host has no tray.
 export function setTrayIconContextMenu(tray, items) {
-    getTrayBackend().setContextMenu(tray.id, items);
+    return invokeUpdate(tray, 'menu', 'menu-install-failed', (backend) => backend.set(tray, items));
 }
-// Marks the tray icon as a macOS template image. Template images auto-invert for light/dark menu
-// bars. No-op on Windows/Linux and on web. Set iconTemplate:true on TrayIconOptions at creation to
-// combine with the initial icon, or call this after creation to update the flag dynamically.
 export function setTrayIconTemplate(tray, isTemplate) {
-    getTrayBackend().setTemplate(tray.id, isTemplate);
+    return invokeUpdate(tray, 'templateImage', 'template-image-update-failed', (backend) => backend.set(tray, isTemplate));
 }
-// Sets the title text displayed next to the tray icon (macOS menu bar only). No-op on other platforms.
 export function setTrayIconTitle(tray, title) {
-    getTrayBackend().setTitle(tray.id, title);
+    return invokeUpdate(tray, 'title', 'title-update-failed', (backend) => backend.set(tray, title));
 }
-// Sets the hover tooltip for the tray icon. No-op when the host has no tray.
 export function setTrayIconTooltip(tray, tooltip) {
-    getTrayBackend().setTooltip(tray.id, tooltip);
+    return invokeUpdate(tray, 'tooltip', 'tooltip-update-failed', (backend) => backend.set(tray, tooltip));
+}
+function attachTrayEvent(tray, slot, listener) {
+    const runtime = getActiveTrayRuntime(tray);
+    if (runtime === null)
+        return { outcome: 'tray-destroyed' };
+    try {
+        const backend = runtime.capabilities[slot];
+        const signal = backend?.getSignal(tray) ?? null;
+        if (signal === null)
+            return { outcome: 'tray-destroyed' };
+        connectSignal(signal, listener);
+        const release = {
+            released: false,
+            async release() {
+                if (release.released)
+                    return { outcome: 'already-released' };
+                try {
+                    disconnectSignal(signal, listener);
+                    release.released = true;
+                    runtime.releases.delete(release);
+                    return { outcome: 'released' };
+                }
+                catch (error) {
+                    return { error, outcome: 'release-failed' };
+                }
+            },
+        };
+        runtime.releases.add(release);
+        return { outcome: 'attached', release };
+    }
+    catch (error) {
+        return { error, outcome: 'subscription-failed' };
+    }
 }
-// Sets whether the host should collapse double-click events into individual click events (macOS).
-// No-op on Windows/Linux and on web.
 export function setTrayIgnoreDoubleClickEvents(tray, ignore) {
-    getTrayBackend().setIgnoreDoubleClickEvents(tray.id, ignore);
+    return invokeUpdate(tray, 'doubleClickPolicy', 'double-click-policy-update-failed', (backend) => backend.setIgnore(tray, ignore));
 }
-// Sets the image shown when the tray icon is pressed (macOS only). Electron calls this
-// setPressedImage. No-op on Windows/Linux and on web.
 export function setTrayPressedIcon(tray, icon) {
-    getTrayBackend().setPressedIcon(tray.id, icon);
-}
-// Starts an animated icon sequence by cycling through the given frames at the specified interval,
-// returning a stop function. An empty frame list is a no-op. The tray icon is not destroyed when the
-// animation stops, and the last frame shown stays.
-//
-// A tray icon has one image, so it has one animation: starting a second on the same tray replaces the
-// first rather than running both. Without that, a perfectly ordinary sequence — swap a "syncing"
-// animation for an "error" one — left two intervals writing to the same icon on the same tick, and
-// the only handle to the orphaned one was a stop function the caller had no reason to still be
-// holding. The returned function stops only the animation it started, so calling a stale one cannot
-// cancel a newer animation.
-//
-// Note: interval timing is best-effort; the actual frame rate depends on the host event loop.
-export function startTrayIconAnimation(tray, frames, intervalMs) {
+    return invokeUpdate(tray, 'pressedImage', 'pressed-image-update-failed', (backend) => backend.set(tray, icon));
+}
+export async function startTrayIconAnimation(tray, frames, intervalMs) {
     if (frames.length === 0)
-        return _noopStop;
+        return { outcome: 'empty' };
+    const runtime = getActiveTrayRuntime(tray);
+    if (runtime === null)
+        return { outcome: 'tray-destroyed' };
     _animationGuard?.(tray, frames.length, intervalMs);
-    stopTrayIconAnimation(tray);
+    stopTrayAnimationRuntime(runtime);
+    const generation = runtime.animationGeneration;
+    const first = await queueAnimationWrite(tray, runtime, generation, frames[0]);
+    if (first.outcome !== 'updated')
+        return first;
+    if (runtime.state !== 'active' || runtime.animationGeneration !== generation)
+        return { outcome: 'tray-destroyed' };
     let index = 0;
-    setTrayIcon(tray, frames[index]);
-    const handle = setInterval(() => {
+    runtime.animationTimer = setInterval(() => {
         index = (index + 1) % frames.length;
-        setTrayIcon(tray, frames[index]);
+        void queueAnimationWrite(tray, runtime, generation, frames[index]);
     }, intervalMs);
-    _animations.set(tray.id, handle);
-    return () => {
-        // Only clear if this animation is still the current one; a later start already replaced it.
-        if (_animations.get(tray.id) !== handle)
-            return;
-        clearInterval(handle);
-        _animations.delete(tray.id);
+    const release = {
+        released: false,
+        async release() {
+            if (release.released)
+                return { outcome: 'already-released' };
+            release.released = true;
+            if (runtime.animationGeneration === generation)
+                stopTrayAnimationRuntime(runtime);
+            return { outcome: 'released' };
+        },
     };
+    return { outcome: 'started', release };
+}
+async function queueAnimationWrite(tray, runtime, generation, frame) {
+    let result = { outcome: 'tray-destroyed' };
+    runtime.animationWriteTail = runtime.animationWriteTail.then(async () => {
+        if (runtime.state !== 'active' || runtime.animationGeneration !== generation)
+            return;
+        result = await setTrayIcon(tray, frame);
+    });
+    await runtime.animationWriteTail;
+    return result;
+}
+function stopTrayAnimationRuntime(runtime) {
+    runtime.animationGeneration++;
+    if (runtime.animationTimer !== null)
+        clearInterval(runtime.animationTimer);
+    runtime.animationTimer = null;
 }
-// The interval per animating tray id. Module-scoped like the backend, and correct at that scope: an
-// id is the host's, so one id is one icon is one animation.
-const _animations = new Map();
-function _noopStop() { }
-// Stops the icon animation running on this tray, if any. Idempotent, and safe on a tray that never
-// animated. The named counterpart to startTrayIconAnimation for callers that hold the TrayIcon but
-// not the stop function it returned — which is most of them, since the handle is what gets passed
-// around and the closure is what gets dropped.
 export function stopTrayIconAnimation(tray) {
-    const handle = _animations.get(tray.id);
-    if (handle === undefined)
-        return;
-    clearInterval(handle);
-    _animations.delete(tray.id);
+    const runtime = getTrayRuntime(tray);
+    if (runtime === null || runtime.animationTimer === null)
+        return { outcome: 'already-stopped' };
+    stopTrayAnimationRuntime(runtime);
+    return { outcome: 'stopped' };
 }
 let _animationGuard = null;
-let _custom = null;
-let _host = null;
-let _hostConflict = false;
-let _hostObservation = null;
-const _sentinel = {
-    create() {
-        // No tray on web. -1 signals "unsupported"; createTrayIcon maps it to null.
-        return -1;
-    },
-    destroy() {
-        // No-op: web has no tray icon to destroy.
-    },
-    displayBalloon() {
-        // No-op: balloon notifications require a native host (Windows only).
-    },
-    getBounds() {
-        // No tray on web; null signals unavailable.
-        return null;
-    },
-    getCapabilities() {
-        return WEB_CAPABILITIES;
-    },
-    getTitle() {
-        // No tray on web.
-        return '';
-    },
-    getTooltip() {
-        // No tray on web.
-        return '';
-    },
-    isDestroyed() {
-        // No tray icons exist on web; treat every id as destroyed.
-        return true;
-    },
-    listIds() {
-        // No tray icons exist on web.
-        return [];
-    },
-    popUpContextMenu() {
-        // No-op: web has no context menu to pop up.
-    },
-    removeBalloon() {
-        // No-op: balloon notifications require a native host (Windows only).
-    },
-    setContextMenu() {
-        // No-op: web has no tray icon — a native host (Electron/Tauri) is required.
-    },
-    setIcon() {
-        // No-op: web has no tray icon to update.
-    },
-    setIgnoreDoubleClickEvents() {
-        // No-op: web has no tray icon double-click behavior to configure.
-    },
-    setPressedIcon() {
-        // No-op: web has no tray icon; pressed icon is macOS-specific.
-    },
-    setTemplate() {
-        // No-op: template images are a macOS menu-bar concept; irrelevant on web.
-    },
-    setTitle() {
-        // No-op: web has no tray icon to update.
-    },
-    setTooltip() {
-        // No-op: web has no tray icon to update.
-    },
-    subscribe() {
-        // No tray on web — a native host (Electron/Tauri) is required to emit tray events.
-        return () => { };
-    },
-};
+function getTrayRuntime(tray) {
+    return tray[EntityRuntimeKey] ?? null;
+}
+function getActiveTrayRuntime(tray) {
+    const runtime = getTrayRuntime(tray);
+    return runtime?.state === 'active' ? runtime : null;
+}
+async function invokeUpdate(tray, slot, failure, operation) {
+    const runtime = getActiveTrayRuntime(tray);
+    if (runtime === null)
+        return { outcome: 'tray-destroyed' };
+    try {
+        return await operation(runtime.capabilities[slot]);
+    }
+    catch (error) {
+        return { error, outcome: failure };
+    }
+}
+function invokeRead(tray, slot, failure, operation) {
+    return invokeUpdate(tray, slot, failure, operation);
+}
 //# sourceMappingURL=tray.js.map