@tishlang/tish-desktop-api 1.0.0

package/LICENSE

@@ -0,0 +1,13 @@
+Pay It Forward License (PIF)
+
+Copyright (c) 2026-present The Tish Project Authors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+This license includes a perpetual, worldwide, non-exclusive, royalty-free, irrevocable (except as stated below) grant for patent claims necessarily infringed by the use of the Software or any contributions submitted to it; terminating automatically when an entity initiates patent litigation (including a cross-claim or counterclaim) alleging that the Software or any portion thereof infringes a patent.
+
+The software is provided "as is," without warranty of any kind, express or implied, including but not limited to the warranties of merchantability, fitness for a particular purpose, and non-infringement. In no event shall the authors or copyright holders be liable for any claim, damages, or other liability, whether in an action of contract, tort, or otherwise, arising from, out of, or in connection with the software or the use or other dealings in the software.
+
+Recipients of the Software should pay it forward by contributing to the open-source community through actions including but not limited to providing code, documentation, tutorials, guides, support, feedback, or promoting open-source projects through advocacy or related efforts that advance innovation and community growth.

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@tishlang/tish-desktop-api",
+  "version": "1.0.0",
+  "description": "Core UI bridge and app-api façade (invoke, listen, state.*) — no UI kit dependency",
+  "license": "PIF",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/tishlang/tish-desktop.git",
+    "directory": "packages/desktop-api"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "LICENSE"
+  ],
+  "tish": {
+    "module": "./src/appApi.tish"
+  },
+  "exports": {
+    ".": {
+      "tish": "./src/appApi.tish"
+    },
+    "./desktopHost": {
+      "tish": "./src/desktopHost.tish"
+    },
+    "./appApi": {
+      "tish": "./src/appApi.tish"
+    },
+    "./bridge": {
+      "import": "./src/bridge.js"
+    },
+    "./web": {
+      "import": "./src/web-bridge.js"
+    },
+    "./web-bridge": {
+      "import": "./src/web-bridge.js"
+    }
+  },
+  "dependencies": {
+    "@tishlang/tish-desktop-shared": "1.0.0"
+  },
+  "keywords": [
+    "tish",
+    "desktop",
+    "tauri",
+    "app-api"
+  ]
+}

package/src/appApi.tish

@@ -0,0 +1,66 @@
+// Core app API — invoke / listen / state.* / Platform. No lattish dependency.
+
+import { Platform, platformSelect, setPlatformFacts } from "@tishlang/tish-desktop-shared"
+import { EVT_STATE_CHANGED } from "@tishlang/tish-desktop-shared"
+
+fn bridge() {
+  let g = globalThis
+  let b = g.__TISH_APP__
+  if (b === null || b === undefined) b = g.__TISH_DESKTOP__
+  if (b === null || b === undefined) {
+    console.error("tish-app bridge not installed — import bridge.js or web-bridge.js first")
+    return null
+  }
+  return b
+}
+
+export fn getCurrentWindowLabel() {
+  let b = bridge()
+  if (b === null) return "main"
+  return b.getCurrentWindowLabel()
+}
+
+export fn invoke(cmd, args) {
+  let b = bridge()
+  let a = args === null || args === undefined ? {} : args
+  return b.invoke(cmd, a)
+}
+
+export fn listen(eventName, handler) {
+  let b = bridge()
+  return b.listen(eventName, handler)
+}
+
+export fn emit(eventName, payload) {
+  let b = bridge()
+  return b.emit(eventName, payload)
+}
+
+/** Plan contract: state.get({ path }) */
+export fn stateGet(path) {
+  return invoke("state.get", { path: path })
+}
+
+export fn stateSet(path, value) {
+  return invoke("state.set", { path: path, value: value })
+}
+
+export fn statePatch(path, value) {
+  return invoke("state.patch", { path: path, value: value })
+}
+
+/**
+ * Subscribe to `state:changed` for `path` (or all paths if null).
+ * Returns an unsubscribe promise/handle from listen.
+ */
+export fn useSharedState(path, onChange) {
+  return listen(EVT_STATE_CHANGED, (payload) => {
+    let p = payload.path
+    if (p === undefined) p = payload.key
+    if (path !== null && path !== undefined && p !== path) return
+    if (onChange) onChange(payload.value, p, payload.revision, payload.source)
+  })
+}
+
+export { Platform, platformSelect, setPlatformFacts }
+export const PROTOCOL = "desktop/v1"

package/src/bridge.js

@@ -0,0 +1,74 @@
+/**
+ * Injects window.__TISH_APP__ (and compat __TISH_DESKTOP__).
+ * Rebind-safe for Vite HMR — call installBridge() from UI boot and hot.accept.
+ *
+ * Prefer an existing **host** bridge (tish-macos / tish-ios WK bootstrap with
+ * `webkit.messageHandlers.tish` + `__dispatch`) over the Tauri transport. Nested
+ * `<webview bridge>` pages load this module after document-start injection; overwriting
+ * with Tauri broke `state:changed` sync and `invoke` in hybrid SC4.
+ */
+export function installBridge() {
+  const g = typeof window !== "undefined" ? window : globalThis;
+
+  const existing = g.__TISH_APP__ || g.__TISH_DESKTOP__;
+  const hostWk =
+    typeof g.webkit !== "undefined" &&
+    g.webkit?.messageHandlers?.tish != null;
+  // Nested host WK (tish-macos/ios bootstrap): never replace with Tauri.
+  // Bootstrap has `__dispatch` for broker → pane events (`state:changed`).
+  if (hostWk) {
+    if (existing && typeof existing.__dispatch === "function") {
+      g.__TISH_APP__ = existing;
+      g.__TISH_DESKTOP__ = existing;
+      return existing;
+    }
+    console.warn(
+      "[tish-app] WK host bridge present but __dispatch missing — skip Tauri install (reload if sync is broken)"
+    );
+    if (existing) return existing;
+  }
+
+  if (!g.__TAURI__?.core?.invoke) {
+    console.warn("[tish-app] Tauri core.invoke not available yet");
+  }
+
+  const api = {
+    protocol: "desktop/v1",
+    surface: "webview",
+    getCurrentWindowLabel() {
+      try {
+        return g.__TAURI__?.webviewWindow?.getCurrentWebviewWindow?.()?.label ?? "main";
+      } catch {
+        return "main";
+      }
+    },
+    async invoke(cmd, args = {}) {
+      const core = g.__TAURI__?.core;
+      if (!core?.invoke) {
+        throw new Error("Tauri core.invoke unavailable");
+      }
+      return core.invoke("desktop_invoke", { cmd, args });
+    },
+    async listen(eventName, handler) {
+      const event = g.__TAURI__?.event;
+      if (!event?.listen) {
+        throw new Error("Tauri event.listen unavailable");
+      }
+      return event.listen(eventName, (e) => handler(e.payload));
+    },
+    async emit(eventName, payload) {
+      const event = g.__TAURI__?.event;
+      if (!event?.emit) return;
+      return event.emit(eventName, payload);
+    },
+  };
+
+  g.__TISH_APP__ = api;
+  g.__TISH_DESKTOP__ = api; // compat alias
+  return api;
+}
+
+export function getBridge() {
+  const g = typeof window !== "undefined" ? window : globalThis;
+  return g.__TISH_APP__ || g.__TISH_DESKTOP__ || installBridge();
+}

package/src/desktopHost.tish

@@ -0,0 +1,15 @@
+// UI façade over window.__TISH_APP__ / __TISH_DESKTOP__ (injected by bridge.js).
+// Re-exports app-api helpers for backward compatibility.
+
+export {
+  getCurrentWindowLabel,
+  invoke,
+  listen,
+  emit,
+  stateGet,
+  stateSet,
+  statePatch,
+  useSharedState,
+  Platform,
+  PROTOCOL,
+} from "./appApi.tish"

package/src/web-bridge.js

@@ -0,0 +1,157 @@
+/**
+ * Pure-browser stub bridge (`--surface web`).
+ * Plan contract: state.* uses `path` + revision; unsupported → `{ code, capability, platform }`.
+ */
+
+const memory = new Map();
+let rev = 0;
+const listeners = new Map();
+
+function unsupported(capability) {
+  return {
+    ok: false,
+    code: "unsupported",
+    capability,
+    platform: "web",
+    message: `${capability} is not supported on web`,
+  };
+}
+
+function emitLocal(eventName, payload) {
+  const set = listeners.get(eventName);
+  if (set) {
+    for (const h of set) {
+      try {
+        h(payload);
+      } catch (e) {
+        console.error("[tish-app web-bridge]", e);
+      }
+    }
+  }
+  if (typeof window !== "undefined") {
+    window.dispatchEvent(new CustomEvent(`tish:${eventName}`, { detail: payload }));
+  }
+}
+
+function pathOf(args) {
+  return args.path ?? args.key;
+}
+
+async function invokeState(cmd, args = {}) {
+  const path = pathOf(args);
+  if (cmd === "state.get") {
+    return {
+      ok: true,
+      path,
+      value: memory.has(path) ? memory.get(path) : null,
+      revision: rev,
+    };
+  }
+  if (cmd === "state.set") {
+    memory.set(path, args.value);
+    rev += 1;
+    const payload = {
+      path,
+      value: args.value,
+      revision: rev,
+      source: "web",
+    };
+    emitLocal("state:changed", payload);
+    return { ok: true, path, value: args.value, revision: rev };
+  }
+  if (cmd === "state.patch") {
+    const prev = memory.get(path) ?? {};
+    const patch = args.value ?? args.patch ?? {};
+    const next =
+      typeof prev === "object" && prev && typeof patch === "object" && patch
+        ? { ...prev, ...patch }
+        : patch;
+    memory.set(path, next);
+    rev += 1;
+    emitLocal("state:changed", { path, value: next, revision: rev, source: "web" });
+    return { ok: true, path, value: next, revision: rev };
+  }
+  if (cmd === "state.keys") {
+    return { ok: true, keys: [...memory.keys()] };
+  }
+  if (cmd === "state.delete") {
+    const deleted = memory.delete(path);
+    if (deleted) {
+      rev += 1;
+      emitLocal("state:changed", { path, value: null, revision: rev, source: "web" });
+    }
+    return { ok: true, deleted, revision: rev };
+  }
+  if (cmd === "state.surfaces") {
+    // Pure web has no native surface registry; expose the logical web surface.
+    return {
+      ok: true,
+      surfaces: [{ id: "web", kind: "web", label: "web" }],
+    };
+  }
+  return null;
+}
+
+async function invokeNotification(cmd, args = {}) {
+  if (cmd === "notification.permissionState") {
+    const perm =
+      typeof Notification !== "undefined" ? Notification.permission : "denied";
+    return { ok: true, state: perm };
+  }
+  if (cmd === "notification.requestPermission") {
+    if (typeof Notification === "undefined") return unsupported("notification");
+    const state = await Notification.requestPermission();
+    return { ok: true, state };
+  }
+  if (cmd === "notification.show") {
+    if (typeof Notification === "undefined") return unsupported("notification");
+    if (Notification.permission !== "granted") {
+      await Notification.requestPermission();
+    }
+    if (Notification.permission !== "granted") {
+      return { ok: false, code: "denied", capability: "notification", message: "permission denied" };
+    }
+    new Notification(args.title || "", { body: args.body || "" });
+    return { ok: true };
+  }
+  return null;
+}
+
+export function installWebBridge() {
+  const g = typeof window !== "undefined" ? window : globalThis;
+
+  const api = {
+    protocol: "desktop/v1",
+    surface: "web",
+    getCurrentWindowLabel() {
+      return "web";
+    },
+    async invoke(cmd, args = {}) {
+      const stateRes = await invokeState(cmd, args);
+      if (stateRes) return stateRes;
+      const noteRes = await invokeNotification(cmd, args);
+      if (noteRes) return noteRes;
+      if (cmd === "ping") {
+        return { ok: true, protocol: "desktop/v1", surface: "web", ts: Date.now() };
+      }
+      return unsupported(cmd.split(".")[0] || cmd);
+    },
+    async listen(eventName, handler) {
+      if (!listeners.has(eventName)) listeners.set(eventName, new Set());
+      listeners.get(eventName).add(handler);
+      return () => listeners.get(eventName)?.delete(handler);
+    },
+    async emit(eventName, payload) {
+      emitLocal(eventName, payload);
+    },
+  };
+
+  g.__TISH_APP__ = api;
+  g.__TISH_DESKTOP__ = api;
+  return api;
+}
+
+export function getBridge() {
+  const g = typeof window !== "undefined" ? window : globalThis;
+  return g.__TISH_APP__ || g.__TISH_DESKTOP__ || installWebBridge();
+}