@domicile-desktop/sdk 0.0.0-alpha-e95270f0da70 → 0.0.0-alpha-51482e4eb22d

package/dist/connect-to-host.js

@@ -61,6 +61,7 @@ const absentHost = () => ({
     displays: null,
     focusApp: () => undefined,
     focusChrome: () => undefined,
+    focusedWindow: null,
     grabShortcut: () => undefined,
     invokeNotificationAction: () => undefined,
     key: () => undefined,
@@ -86,4 +87,5 @@ const absentHost = () => ({
     unlock: () => undefined,
     warpPointer: () => undefined,
     watchAudioLevels: () => undefined,
+    windows: [],
 });

package/dist/domicile-host.d.ts

@@ -56,6 +56,32 @@ export type DomicileDisplay = {
      */
     readonly transform: string;
 };
+/**
+ * One client window, as {@link DomicileHost.windows} lists it: what the
+ * compositor has said about it so far. Replaced, never edited — any change is
+ * a new `windows` array and a `windowschanged`.
+ */
+export type DomicileWindow = {
+    readonly appId: string;
+    /** Empty until the client names itself. */
+    readonly title: string;
+    /** The size the client last committed, in CSS pixels; `null` until it has. */
+    readonly width: number | null;
+    readonly height: number | null;
+    /** The limits the client asked for; `null` where it asked for none. */
+    readonly minWidth: number | null;
+    readonly minHeight: number | null;
+    readonly maxWidth: number | null;
+    readonly maxHeight: number | null;
+    readonly cursor: CursorShape;
+    /** A popup's parent window; `null` for a toplevel. */
+    readonly parent: string | null;
+    /** A popup's place relative to its parent; `null` for a toplevel. */
+    readonly x: number | null;
+    readonly y: number | null;
+    /** Whether a popup grabbed the pointer; `false` for a toplevel. */
+    readonly grab: boolean;
+};
 /**
  * A window event: appeared, resized, closed, focus changed, and similar.
  *
@@ -587,6 +613,19 @@ export type DomicileHostEventMap = {
      * {@link DomicileHost.browserWindows} for the new list.
      */
     browserwindowschanged: Event;
+    /**
+     * A window appeared, closed, or changed. Bare — read
+     * {@link DomicileHost.windows} for what they are now.
+     */
+    windowschanged: Event;
+    /**
+     * The compositor said where the keyboard is. Bare — read
+     * {@link DomicileHost.focusedWindow}. Every time, not only when it moves, and
+     * once after the windows already running are replayed to a page that has
+     * just connected: a window listed after the first of these is one opened
+     * now.
+     */
+    focusedwindowchanged: Event;
 };
 /**
  * The shell's control channel to the compositor.
@@ -773,6 +812,15 @@ export type DomicileHost = {
      * browser lists them, which it does as soon as something listens.
      */
     readonly browserWindows: readonly DomicileBrowserWindow[] | null;
+    /**
+     * Every client window, in the order they appeared. Reading it binds the
+     * channel, and the compositor announces the windows already running as it
+     * does, so a shell that reads late misses nothing: read, then listen for
+     * `windowschanged`. A different frozen array after every change.
+     */
+    readonly windows: readonly DomicileWindow[];
+    /** The window holding the keyboard, or `null` when the shell's page holds it. */
+    readonly focusedWindow: string | null;
     addEventListener<T extends keyof DomicileHostEventMap>(type: T, listener: (event: DomicileHostEventMap[T]) => void): void;
 };
 declare global {

package/package.json

@@ -150,7 +150,7 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-e95270f0da70",
+  "version": "0.0.0-alpha-51482e4eb22d",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cprussin/domicile.git",