@domicile-desktop/sdk 0.0.0-alpha-59b63cdb292c → 0.0.0-alpha-452a746292aa

package/dist/portal.d.ts

@@ -318,11 +318,15 @@ export declare const CastSource: {
         id: string;
         /** Its title as the shell named it, for the sharing indicator. */
         title: string;
+        /** Part of its page alone, as a window's `area` is. */
+        area?: ShotRect | undefined;
     }) => {
         /** Its id, as `DomicileHost.browserWindows` lists it. */
         id: string;
         /** Its title as the shell named it, for the sharing indicator. */
         title: string;
+        /** Part of its page alone, as a window's `area` is. */
+        area?: ShotRect | undefined;
         kind: CastSourceKind.BrowserWindow;
     };
     Monitor: (monitor: {
@@ -357,6 +361,11 @@ export declare const CastSource: {
         title: string;
         /** Its Wayland app id, which names its desktop entry; empty if unset. */
         appId: string;
+        /**
+         * Part of the window alone, in pixels of its frame as
+         * `System.previewWindow` draws it. All of it when unset.
+         */
+        area?: ShotRect | undefined;
     }) => {
         /** The window's id, as `DomicileHost.windows` lists it. */
         id: string;
@@ -364,6 +373,11 @@ export declare const CastSource: {
         title: string;
         /** Its Wayland app id, which names its desktop entry; empty if unset. */
         appId: string;
+        /**
+         * Part of the window alone, in pixels of its frame as
+         * `System.previewWindow` draws it. All of it when unset.
+         */
+        area?: ShotRect | undefined;
         kind: CastSourceKind.Window;
     };
 };
@@ -796,13 +810,19 @@ export declare const PortalAnswer: {
      * A browser window, by its `DomicileBrowserWindow` id; `copy` as above.
      * Nothing the shell draws over the window is in the shot.
      */
-    ScreenshotBrowserWindow: (id: string, copy: boolean) => {
+    ScreenshotBrowserWindow: (id: string, copy: boolean, area?: ShotRect | undefined) => {
+        area: ShotRect | undefined;
         copy: boolean;
         id: string;
         kind: PortalAnswerKind.ScreenshotBrowserWindow;
     };
-    /** One of the request's windows, by {@link ShotWindow.id}; `copy` as above. */
-    ScreenshotWindow: (id: string, copy: boolean) => {
+    /**
+     * One of the request's windows, by {@link ShotWindow.id}; `copy` as above.
+     * `area` is part of it, in pixels of its frame as `System.previewWindow`
+     * draws it; all of it when unset.
+     */
+    ScreenshotWindow: (id: string, copy: boolean, area?: ShotRect | undefined) => {
+        area: ShotRect | undefined;
         copy: boolean;
         id: string;
         kind: PortalAnswerKind.ScreenshotWindow;

package/dist/portal.js

@@ -353,13 +353,19 @@ export const PortalAnswer = {
      * A browser window, by its `DomicileBrowserWindow` id; `copy` as above.
      * Nothing the shell draws over the window is in the shot.
      */
-    ScreenshotBrowserWindow: (id, copy) => ({
+    ScreenshotBrowserWindow: (id, copy, area) => ({
+        area,
         copy,
         id,
         kind: PortalAnswerKind.ScreenshotBrowserWindow,
     }),
-    /** One of the request's windows, by {@link ShotWindow.id}; `copy` as above. */
-    ScreenshotWindow: (id, copy) => ({
+    /**
+     * One of the request's windows, by {@link ShotWindow.id}; `copy` as above.
+     * `area` is part of it, in pixels of its frame as `System.previewWindow`
+     * draws it; all of it when unset.
+     */
+    ScreenshotWindow: (id, copy, area) => ({
+        area,
         copy,
         id,
         kind: PortalAnswerKind.ScreenshotWindow,
@@ -1029,9 +1035,15 @@ const wireAnswer = (answer) => {
         case PortalAnswerKind.Screenshot:
             return { area: answer.area, copy: answer.copy, kind: "screenshot" };
         case PortalAnswerKind.ScreenshotWindow:
-            return { copy: answer.copy, id: answer.id, kind: "screenshot_window" };
+            return {
+                ...wireArea(answer.area),
+                copy: answer.copy,
+                id: answer.id,
+                kind: "screenshot_window",
+            };
         case PortalAnswerKind.ScreenshotBrowserWindow:
             return {
+                ...wireArea(answer.area),
                 copy: answer.copy,
                 id: answer.id,
                 kind: "screenshot_browser_window",
@@ -1054,15 +1066,22 @@ const wireOptions = (options) => ({
 const wireSource = (source) => {
     switch (source.kind) {
         case CastSourceKind.Window:
-            return { id: source.id, type: "window" };
+            return { ...wireArea(source.area), id: source.id, type: "window" };
         case CastSourceKind.BrowserWindow:
-            return { id: source.id, title: source.title, type: "browser_window" };
+            return {
+                ...wireArea(source.area),
+                id: source.id,
+                title: source.title,
+                type: "browser_window",
+            };
         case CastSourceKind.Monitor:
             return { name: source.name, type: "monitor" };
         case CastSourceKind.Region:
             return { position: source.position, size: source.size, type: "region" };
     }
 };
+/** Part of a window, when only part is picked. */
+const wireArea = (area) => area === undefined ? {} : { area };
 /** The value `pairs` gives `wire`. Every wire name the schema takes is listed. */
 const valueFor = (pairs, wire) => {
     const found = pairs.find(([listed]) => listed === wire);

package/package.json

@@ -140,7 +140,7 @@
     "test:unit": "bun test"
   },
   "type": "module",
-  "version": "0.0.0-alpha-59b63cdb292c",
+  "version": "0.0.0-alpha-452a746292aa",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/cprussin/domicile.git",