Import AITURK IDE 1.0.0-beta.1 from Hermes 63279301; preserve MIT license

apps/desktop/electron/hud-overlay.ts

@@ -0,0 +1,41 @@
+/**
+ * HUD overlay adapters.
+ *
+ * Electron `alwaysOnTop` is the generic ask. Some compositors ignore it
+ * (Hyprland tiles the toplevel; COSMIC drops z-order). Each adapter speaks
+ * that compositor's dialect; `promoteHudOverlay` is the one call site.
+ */
+
+import { promoteHudOnHyprland } from './hud-hyprland'
+
+export interface HudElectronOverlayWindow {
+  setAlwaysOnTop(flag: boolean, level?: string): void
+  setVisibleOnAllWorkspaces?(
+    visible: boolean,
+    options?: { skipTransformProcessType?: boolean; visibleOnFullScreen?: boolean }
+  ): void
+}
+
+/** Chrome Electron itself can honour. Compositor IPC is `promoteHudOverlay`. */
+export function applyHudElectronOverlay(win: HudElectronOverlayWindow, platform: string): void {
+  win.setAlwaysOnTop(true, platform === 'darwin' ? 'floating' : 'screen-saver')
+
+  if (platform !== 'darwin') {
+    return
+  }
+
+  try {
+    win.setVisibleOnAllWorkspaces?.(true, { visibleOnFullScreen: true, skipTransformProcessType: true })
+  } catch {
+    // Not supported everywhere — best effort.
+  }
+}
+
+/**
+ * Ask the running compositor to treat the HUD as an overlay. Hyprland is the
+ * first adapter (float + pin). Sway/niri hang off this same function later.
+ * Returns true when an adapter applied; false is "nothing to do / not that WM".
+ */
+export async function promoteHudOverlay(options: { title: string }): Promise<boolean> {
+  return promoteHudOnHyprland(options)
+}