@flighthq/host-tauri 0.1.0

package/dist/tauriTray.js

@@ -0,0 +1,167 @@
+// Maps Flight's TrayBackend onto Tauri's `@tauri-apps/api/tray`. Tauri's `TrayIcon.new` is async, while
+// TrayBackend.create is synchronous and must return a numeric id now — so create allocates the id
+// immediately, records it, and adopts the resolved `TrayIcon` handle when the async build settles;
+// method calls before the handle lands (setIcon/setTitle/…) queue nothing and simply no-op on the not-
+// yet-ready record, matching the "no-op when absent" pattern. Click/double-click are delivered through
+// the Tauri tray `action` callback and forwarded as TrayEventData to the single subscribed listener.
+// Tauri exposes no Windows balloon, no tray bounds, and no template/pressed-icon distinction here, so
+// those methods report the contract sentinels (null / no-op). Icons cross as string paths.
+export function createTauriTrayBackend(tauri) {
+    const trayModule = tauri.tray;
+    const menuModule = tauri.menu;
+    const trays = new Map();
+    let nextId = 0;
+    // The single tray event listener, owned by this backend and set via subscribe.
+    let eventListener = null;
+    const emit = (id, type) => {
+        eventListener?.({
+            altKey: false,
+            bounds: null,
+            ctrlKey: false,
+            dropFiles: null,
+            dropText: null,
+            id,
+            metaKey: false,
+            position: null,
+            shiftKey: false,
+            type,
+        });
+    };
+    return {
+        create(options) {
+            const id = nextId++;
+            const record = { icon: null, title: options.title ?? '', tooltip: options.tooltip ?? '' };
+            trays.set(id, record);
+            trayModule.TrayIcon.new({
+                icon: options.icon,
+                title: options.title,
+                tooltip: options.tooltip,
+                action: (event) => {
+                    const type = toTrayEventType(event);
+                    if (type !== null)
+                        emit(id, type);
+                },
+            })
+                .then((icon) => {
+                record.icon = icon;
+            })
+                .catch(() => {
+                /* tray creation failed — the record stays iconless and its methods no-op */
+            });
+            return id;
+        },
+        destroy(id) {
+            const record = trays.get(id);
+            if (!record)
+                return;
+            record.icon?.close().catch(() => { });
+            trays.delete(id);
+        },
+        displayBalloon() {
+            // Tauri has no Windows balloon API; no-op.
+        },
+        removeBalloon() {
+            // No balloon to remove.
+        },
+        getBounds() {
+            // Tauri does not report tray icon bounds; null sentinel.
+            return null;
+        },
+        getCapabilities() {
+            return { balloon: false, bounds: false, clickEvents: true, dropFiles: false, pressedIcon: false, title: true };
+        },
+        getTitle(id) {
+            return trays.get(id)?.title ?? '';
+        },
+        getTooltip(id) {
+            return trays.get(id)?.tooltip ?? '';
+        },
+        isDestroyed(id) {
+            return !trays.has(id);
+        },
+        listIds() {
+            return [...trays.keys()];
+        },
+        popUpContextMenu(id) {
+            // Tauri shows the tray menu on click via setMenu; it has no imperative popup here. No-op.
+            void id;
+        },
+        setContextMenu(id, items) {
+            const record = trays.get(id);
+            if (!record)
+                return;
+            void (async () => {
+                const built = await buildTrayItems(menuModule, items);
+                const menu = await menuModule.Menu.new({ items: built });
+                await record.icon?.setMenu(menu);
+            })().catch(() => { });
+        },
+        setIcon(id, icon) {
+            trays
+                .get(id)
+                ?.icon?.setIcon(icon)
+                .catch(() => { });
+        },
+        setIgnoreDoubleClickEvents() {
+            // Tauri has no double-click-ignore toggle; no-op.
+        },
+        setPressedIcon() {
+            // Tauri has no distinct pressed-state icon; no-op.
+        },
+        setTemplate() {
+            // Template-ness is set on the icon at creation in Tauri, not toggled here; no-op.
+        },
+        setTitle(id, title) {
+            const record = trays.get(id);
+            if (!record)
+                return;
+            record.title = title;
+            record.icon?.setTitle(title).catch(() => { });
+        },
+        setTooltip(id, tooltip) {
+            const record = trays.get(id);
+            if (!record)
+                return;
+            record.tooltip = tooltip;
+            record.icon?.setTooltip(tooltip).catch(() => { });
+        },
+        subscribe(listener) {
+            eventListener = listener;
+            return () => {
+                if (eventListener === listener)
+                    eventListener = null;
+            };
+        },
+    };
+}
+// Maps a Tauri tray pointer event onto Flight's TrayEventType, or null for events with no Flight
+// equivalent (enter/leave/move). A right-button click reports 'rightClick'.
+function toTrayEventType(event) {
+    if (event.type === 'DoubleClick')
+        return 'doubleClick';
+    if (event.type === 'Click')
+        return event.button === 'Right' ? 'rightClick' : 'click';
+    return null;
+}
+// Builds Tauri tray-menu item handles from Flight templates. Tray-menu selection is delivered through
+// the menu backend's listener, so these items carry no action callback (mirroring the electron seam).
+async function buildTrayItems(menuModule, items) {
+    const built = [];
+    for (const item of items) {
+        if (item.type === 'separator') {
+            built.push(await menuModule.PredefinedMenuItem.new({ item: 'Separator' }));
+        }
+        else if (item.submenu) {
+            built.push(await menuModule.Submenu.new({
+                text: item.label,
+                enabled: item.enabled,
+                items: await buildTrayItems(menuModule, item.submenu),
+            }));
+        }
+        else {
+            built.push(await menuModule.MenuItem.new({ id: item.id, text: item.label, enabled: item.enabled }));
+        }
+    }
+    return built;
+}
+//# sourceMappingURL=tauriTray.js.map

package/dist/tauriTray.js.map

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

package/dist/tauriWindow.d.ts

@@ -0,0 +1,4 @@
+import type { WindowBackend } from '@flighthq/types';
+import type { TauriApi } from './tauriModule';
+export declare function createTauriWindowBackend(tauri: TauriApi): WindowBackend;
+//# sourceMappingURL=tauriWindow.d.ts.map

package/dist/tauriWindow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tauriWindow.d.ts","sourceRoot":"","sources":["../src/tauriWindow.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAExE,OAAO,KAAK,EAAE,QAAQ,EAAe,MAAM,eAAe,CAAC;AAU3D,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAgJvE"}

package/dist/tauriWindow.js

@@ -0,0 +1,166 @@
+import { emitSignal } from '@flighthq/signals';
+// Maps Flight's WindowBackend onto Tauri's `@tauri-apps/api/window`. Every Tauri window call is async
+// while WindowBackend's commands are synchronous (void), so the adapter fires each call and forgets,
+// swallowing rejections at the seam. `open` adopts the webview's current OS window (`getCurrentWindow`),
+// applies the WindowOptions, and wires Tauri's onMoved/onResized/onFocusChanged/onCloseRequested events
+// back onto the entity + its signals — the same pattern the electron seam uses for user-driven state
+// changes. `getBounds` cannot read Tauri's async position/size synchronously, so it reports the entity's
+// mirrored fields. Scope: this is the single current window (the browser-page-window analogue); creating
+// additional OS windows is a `WebviewWindow`-label concern left to the host and not modeled here.
+export function createTauriWindowBackend(tauri) {
+    const windowModule = tauri.window;
+    const windows = new WeakMap();
+    const run = (win, fn) => {
+        const w = windows.get(win);
+        if (w === undefined)
+            return;
+        fn(w).catch(() => {
+            /* window closed or the call is unsupported on this platform */
+        });
+    };
+    return {
+        open(win, options) {
+            const w = windowModule.getCurrentWindow();
+            windows.set(win, w);
+            if (options.title !== undefined)
+                w.setTitle(options.title).catch(() => { });
+            if (options.width !== undefined && options.height !== undefined) {
+                w.setSize(new windowModule.LogicalSize(options.width, options.height)).catch(() => { });
+            }
+            if (options.x !== undefined && options.y !== undefined) {
+                w.setPosition(new windowModule.LogicalPosition(options.x, options.y)).catch(() => { });
+            }
+            if (options.resizable !== undefined)
+                w.setResizable(options.resizable).catch(() => { });
+            if (options.alwaysOnTop !== undefined)
+                w.setAlwaysOnTop(options.alwaysOnTop).catch(() => { });
+            if (options.fullscreen !== undefined)
+                w.setFullscreen(options.fullscreen).catch(() => { });
+            if (options.minWidth !== undefined && options.minHeight !== undefined) {
+                w.setMinSize(new windowModule.LogicalSize(options.minWidth, options.minHeight)).catch(() => { });
+            }
+            if (options.maxWidth !== undefined && options.maxWidth >= 0 && options.maxHeight !== undefined) {
+                w.setMaxSize(new windowModule.LogicalSize(options.maxWidth, options.maxHeight)).catch(() => { });
+            }
+            if (options.center)
+                w.center().catch(() => { });
+            if (options.maximized)
+                w.maximize().catch(() => { });
+            if (options.minimized)
+                w.minimize().catch(() => { });
+            if (options.visible === false)
+                w.hide().catch(() => { });
+            else
+                w.show().catch(() => { });
+            w.onMoved((event) => {
+                win.x = event.payload.x;
+                win.y = event.payload.y;
+                emitSignal(win.onMove);
+            }).catch(() => { });
+            w.onResized((event) => {
+                win.width = event.payload.width;
+                win.height = event.payload.height;
+                emitSignal(win.onResize);
+            }).catch(() => { });
+            w.onFocusChanged((event) => {
+                win.focused = event.payload;
+                emitSignal(event.payload ? win.onFocusIn : win.onFocusOut);
+            }).catch(() => { });
+            w.onCloseRequested(() => emitSignal(win.onClose)).catch(() => { });
+            return true;
+        },
+        close(win) {
+            const w = windows.get(win);
+            if (w === undefined)
+                return;
+            w.close().catch(() => { });
+            windows.delete(win);
+        },
+        setTitle(win, title) {
+            run(win, (w) => w.setTitle(title));
+        },
+        setPosition(win, x, y) {
+            run(win, (w) => w.setPosition(new windowModule.LogicalPosition(x, y)));
+        },
+        setSize(win, width, height) {
+            run(win, (w) => w.setSize(new windowModule.LogicalSize(width, height)));
+        },
+        getBounds(win, out) {
+            // Tauri's position/size are async; report the entity's mirrored bounds rather than block.
+            out.x = win.x;
+            out.y = win.y;
+            out.width = win.width;
+            out.height = win.height;
+            return out;
+        },
+        minimize(win) {
+            run(win, (w) => w.minimize());
+        },
+        maximize(win) {
+            run(win, (w) => w.maximize());
+        },
+        restore(win) {
+            run(win, (w) => w.unmaximize());
+        },
+        focus(win) {
+            run(win, (w) => w.setFocus());
+        },
+        show(win) {
+            run(win, (w) => w.show());
+        },
+        hide(win) {
+            run(win, (w) => w.hide());
+        },
+        center(win) {
+            run(win, (w) => w.center());
+        },
+        setResizable(win, resizable) {
+            run(win, (w) => w.setResizable(resizable));
+        },
+        setAlwaysOnTop(win, alwaysOnTop) {
+            run(win, (w) => w.setAlwaysOnTop(alwaysOnTop));
+        },
+        setMinimumSize(win, width, height) {
+            run(win, (w) => w.setMinSize(new windowModule.LogicalSize(width, height)));
+        },
+        setMaximumSize(win, width, height) {
+            run(win, (w) => w.setMaxSize(new windowModule.LogicalSize(width, height)));
+        },
+        setFullscreen(win, fullscreen) {
+            run(win, (w) => w.setFullscreen(fullscreen));
+        },
+        setIcon(win, icon) {
+            run(win, (w) => w.setIcon(icon));
+        },
+        setOpacity() {
+            // Tauri's window API exposes no opacity control; no-op.
+        },
+        setSkipTaskbar(win, skip) {
+            run(win, (w) => w.setSkipTaskbar(skip));
+        },
+        setMenuBarVisible() {
+            // Tauri menus are not a per-window menu bar toggled here; no-op.
+        },
+        setParent() {
+            // Parenting an already-created window is not modeled through the current-window seam; no-op.
+        },
+        setProgress() {
+            // Taskbar progress is available via Tauri's setProgressBar but not modeled here; no-op.
+        },
+        requestAttention(win, attention) {
+            // Tauri's requestUserAttention takes a UserAttentionType (1 = Critical) or null to cancel.
+            run(win, (w) => w.requestUserAttention(attention ? 1 : null));
+        },
+        setContentProtection(win, enabled) {
+            run(win, (w) => w.setContentProtected(enabled));
+        },
+        flashWindowFrame(win) {
+            // Map a one-shot frame flash to an informational (2) attention request.
+            run(win, (w) => w.requestUserAttention(2));
+        },
+        setHasShadow(win, hasShadow) {
+            run(win, (w) => w.setShadow(hasShadow));
+        },
+    };
+}
+//# sourceMappingURL=tauriWindow.js.map

package/dist/tauriWindow.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@flighthq/host-tauri",
+  "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/app": "0.1.0",
+    "@flighthq/application": "0.1.0",
+    "@flighthq/clipboard": "0.1.0",
+    "@flighthq/dialog": "0.1.0",
+    "@flighthq/menu": "0.1.0",
+    "@flighthq/notification": "0.1.0",
+    "@flighthq/platform": "0.1.0",
+    "@flighthq/shell": "0.1.0",
+    "@flighthq/shortcut": "0.1.0",
+    "@flighthq/signals": "0.1.0",
+    "@flighthq/tray": "0.1.0",
+    "@flighthq/types": "0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.0"
+  },
+  "description": "Tauri (v2) host backend: registers Tauri JS API implementations of Flight's window/app/dialog/clipboard/menu/tray/shortcut/platform/notification/shell seams over an injected TauriApi",
+  "sideEffects": false
+}

package/src/tauriApp.test.ts

@@ -0,0 +1,80 @@
+import { createTauriAppBackend } from './tauriApp';
+import type { TauriApi } from './tauriModule';
+
+function fakeTauri() {
+  const calls: string[] = [];
+  const tauri = {
+    app: {
+      async getName() {
+        return 'FlightApp';
+      },
+      async getVersion() {
+        return '2.3.4';
+      },
+      async hide() {
+        calls.push('hide');
+      },
+      async show() {
+        calls.push('show');
+      },
+    },
+    os: {
+      arch: () => 'x86_64',
+      locale: () => 'fr-FR',
+      platform: () => 'linux',
+      version: () => '',
+    },
+    process: {
+      async exit() {
+        calls.push('exit');
+      },
+      async relaunch() {
+        calls.push('relaunch');
+      },
+    },
+  } as unknown as TauriApi;
+  return { tauri, calls };
+}
+
+describe('createTauriAppBackend', () => {
+  it('serves name and version from the prefetch cache once it resolves', async () => {
+    const backend = createTauriAppBackend(fakeTauri().tauri);
+    // The sync getters read '' until the construction-time prefetch settles.
+    expect(backend.getName()).toBe('');
+    await Promise.resolve();
+    await Promise.resolve();
+    expect(backend.getName()).toBe('FlightApp');
+    expect(backend.getVersion()).toBe('2.3.4');
+  });
+
+  it('sources locale from the os plugin', () => {
+    const backend = createTauriAppBackend(fakeTauri().tauri);
+    expect(backend.getLocale()).toBe('fr-FR');
+    expect(backend.getSystemLocale()).toBe('fr-FR');
+    expect(backend.getPreferredSystemLanguages()).toEqual(['fr-FR']);
+  });
+
+  it('fires the process/app control methods', () => {
+    const { tauri, calls } = fakeTauri();
+    const backend = createTauriAppBackend(tauri);
+    backend.quit();
+    backend.relaunch();
+    expect(backend.hideApp()).toBe(true);
+    expect(backend.showApp()).toBe(true);
+    expect(calls).toContain('exit');
+    expect(calls).toContain('relaunch');
+    expect(calls).toContain('hide');
+    expect(calls).toContain('show');
+  });
+
+  it('reports sentinels for the unmapped surface', () => {
+    const backend = createTauriAppBackend(fakeTauri().tauri);
+    expect(backend.bounceDock()).toBe(-1);
+    expect(backend.setBadgeCount(3)).toBe(false);
+    expect(backend.setName('X')).toBe(false);
+    expect(backend.getAppPath()).toBe('');
+    expect(backend.getCommandLine()).toEqual([]);
+    expect(backend.isAppHidden()).toBe(false);
+    expect(typeof backend.subscribeReady(() => {})).toBe('function');
+  });
+});

package/src/tauriClipboard.test.ts

@@ -0,0 +1,69 @@
+import { createTauriClipboardBackend } from './tauriClipboard';
+import type { TauriApi } from './tauriModule';
+
+function fakeTauri() {
+  const store = { text: '' };
+  const calls: string[] = [];
+  const tauri = {
+    clipboard: {
+      async readText() {
+        calls.push('readText');
+        return store.text;
+      },
+      async writeText(text: string) {
+        calls.push('writeText');
+        store.text = text;
+      },
+      async clear() {
+        calls.push('clear');
+        store.text = '';
+      },
+    },
+  } as unknown as TauriApi;
+  return { tauri, store, calls };
+}
+
+describe('createTauriClipboardBackend', () => {
+  it('round-trips text through the Tauri clipboard', async () => {
+    const { tauri, calls } = fakeTauri();
+    const backend = createTauriClipboardBackend(tauri);
+    expect(await backend.writeText('hi')).toBe(true);
+    expect(await backend.readText()).toBe('hi');
+    expect(await backend.hasText()).toBe(true);
+    expect(calls).toContain('writeText');
+    expect(calls).toContain('readText');
+  });
+
+  it('clears via the Tauri clipboard', async () => {
+    const { tauri, calls } = fakeTauri();
+    const backend = createTauriClipboardBackend(tauri);
+    await backend.writeText('x');
+    expect(await backend.clear()).toBe(true);
+    expect(calls).toContain('clear');
+    expect(await backend.hasText()).toBe(false);
+  });
+
+  it('reports sentinels for unsupported flavors', async () => {
+    const backend = createTauriClipboardBackend(fakeTauri().tauri);
+    expect(await backend.readHtml()).toBe('');
+    expect(await backend.writeHtml('<b/>')).toBe(false);
+    expect(await backend.readImage()).toBe('');
+    expect(await backend.readBookmark()).toBeNull();
+    expect(await backend.getFormats()).toEqual([]);
+    expect(await backend.readFiles()).toEqual([]);
+    expect(backend.getChangeCount()).toBe(-1);
+  });
+
+  it('resolves sentinels when the clipboard read throws', async () => {
+    const tauri = {
+      clipboard: {
+        async readText() {
+          throw new Error('denied');
+        },
+      },
+    } as unknown as TauriApi;
+    const backend = createTauriClipboardBackend(tauri);
+    expect(await backend.readText()).toBe('');
+    expect(await backend.hasText()).toBe(false);
+  });
+});

package/src/tauriDialog.test.ts

@@ -0,0 +1,83 @@
+import { createTauriDialogBackend } from './tauriDialog';
+import type { TauriApi, TauriDialogOpenOptions } from './tauriModule';
+
+interface DialogCalls {
+  open: TauriDialogOpenOptions[];
+  confirm: { message: string; kind?: string }[];
+  message: { message: string; kind?: string }[];
+}
+
+function fakeTauri(openResult: string | string[] | null, saveResult: string | null) {
+  const calls: DialogCalls = { open: [], confirm: [], message: [] };
+  const tauri = {
+    dialog: {
+      async open(options: TauriDialogOpenOptions) {
+        calls.open.push(options);
+        return openResult;
+      },
+      async save() {
+        return saveResult;
+      },
+      async message(message: string, options?: { kind?: string }) {
+        calls.message.push({ message, kind: options?.kind });
+      },
+      async confirm(message: string, options?: { kind?: string }) {
+        calls.confirm.push({ message, kind: options?.kind });
+        return true;
+      },
+      async ask() {
+        return true;
+      },
+    },
+  } as unknown as TauriApi;
+  return { tauri, calls };
+}
+
+describe('createTauriDialogBackend', () => {
+  it('maps openFile results to populated file handles', async () => {
+    const { tauri, calls } = fakeTauri('/home/u/a.txt', null);
+    const backend = createTauriDialogBackend(tauri);
+    const handles = await backend.openFile({ title: 'Open', filters: [{ name: 'Text', extensions: ['txt'] }] });
+    expect(handles).toHaveLength(1);
+    expect(handles[0]).toEqual({ kind: 'File', name: 'a.txt', path: '/home/u/a.txt' });
+    expect(calls.open[0].directory).toBeUndefined();
+    expect(calls.open[0].filters).toEqual([{ name: 'Text', extensions: ['txt'] }]);
+  });
+
+  it('normalizes a multi-select array and cancel (null) result', async () => {
+    const multi = await createTauriDialogBackend(fakeTauri(['/a', '/b'], null).tauri).openFile({ multiple: true });
+    expect(multi.map((h) => h.path)).toEqual(['/a', '/b']);
+    const cancelled = await createTauriDialogBackend(fakeTauri(null, null).tauri).openFile({});
+    expect(cancelled).toEqual([]);
+  });
+
+  it('opens directories with the directory flag and Directory kind', async () => {
+    const { tauri, calls } = fakeTauri('/home/u/dir', null);
+    const handles = await backend(tauri).openDirectory({});
+    expect(calls.open[0].directory).toBe(true);
+    expect(handles[0].kind).toBe('Directory');
+  });
+
+  it('maps saveFile to a single handle or null', async () => {
+    expect((await backend(fakeTauri(null, '/out.png').tauri).saveFile({}))?.path).toBe('/out.png');
+    expect(await backend(fakeTauri(null, null).tauri).saveFile({})).toBeNull();
+  });
+
+  it('maps message to an acknowledgement result and confirm to a boolean', async () => {
+    const { tauri, calls } = fakeTauri(null, null);
+    const result = await backend(tauri).message({ message: 'Hi', kind: 'question' });
+    expect(result).toEqual({ buttonIndex: 0, cancelled: false, checkboxChecked: false });
+    // 'question' has no Tauri glyph and falls back to 'info'.
+    expect(calls.message[0].kind).toBe('info');
+    expect(await backend(tauri).confirm({ message: 'Sure?', kind: 'warning' })).toBe(true);
+    expect(calls.confirm[0].kind).toBe('warning');
+  });
+
+  it('reports the null sentinel for prompt (no Tauri text dialog)', async () => {
+    expect(await backend(fakeTauri(null, null).tauri).prompt({ message: 'Name?' })).toBeNull();
+  });
+});
+
+function backend(tauri: TauriApi) {
+  return createTauriDialogBackend(tauri);
+}