@solazah/solazah-runtime 0.1.161 → 0.1.163

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solazah/solazah-runtime",
-  "version": "0.1.161",
+  "version": "0.1.163",
   "main": "index.cjs",
   "module": "index.js",
   "types": "types/index.d.ts",

package/types/Plugin.d.ts

@@ -65,6 +65,14 @@ export default class Plugin {
      * @returns 无返回。窗口不存在时静默忽略。
      */
     setHeight: (height: number) => Promise<any>;
+    /**
+     * 把发起方插件窗口的宽高一起设为指定像素值。调用前会清掉最小尺寸限制,免得被 minWidth/minHeight 钳住。
+     *
+     * @param width  目标宽度(像素)。
+     * @param height 目标高度(像素)。
+     * @returns 无返回。窗口不存在时静默忽略。
+     */
+    setSize: (width: number, height: number) => Promise<any>;
     /**
      * 读发起方插件窗口当前的位置与尺寸。
      * 用 -webkit-app-region 拖动时页面收不到任何鼠标事件,窗口位置只有主进程知道 ——
@@ -130,6 +138,35 @@ export default class Plugin {
      * @returns 无返回。
      */
     hide: () => Promise<any>;
+    /**
+     * 关掉发起方插件窗口:内容视图一并卸载,渲染进程立刻释放。发起方在主窗口里时退回启动器主页,不关主窗口。
+     *
+     * 与 hide 的分野是复用:hide 把窗口与视图整套留着换零延迟唤起,之后由巡检按收起时长回收。
+     * 每次都按新参数重建、没有可复用内容的窗口(采集边框、采集控制条这类)用 close,别占着一个渲染进程等巡检。
+     * 反过来,热路径上反复唤起的浮层(截图浮层这类)该留给 hide —— close 掉就等于每次都付一次冷启动。
+     *
+     * 调用方自己随即被销毁,这个 Promise **不会 resolve**:别 await 它,也别在它后面接代码。
+     *
+     * @returns 不 resolve。
+     */
+    close: () => Promise<any>;
+    /**
+     * 让发起方插件视图真正拿到键盘焦点:先激活承载它的窗口,再聚焦这个视图。
+     * 透明 floating 浮层鼠标可点但键盘不激活、输入框敲不进字时用它。
+     *
+     * @param force 顶到前台。授权流程从系统浏览器切回来这类场景要开:此刻前台是别的应用,
+     *              普通 focus 会被 Windows 的前台锁定丢成任务栏闪烁。
+     * @returns 无返回。
+     */
+    focus: (force?: boolean) => Promise<any>;
+    /**
+     * 设置发起方窗口是否置顶(screen-saver 级,压得住普通窗口与菜单栏)。
+     * 钉屏窗口加载时调它,确保始终置顶且失焦不收起。
+     *
+     * @param value 是否置顶。
+     * @returns 设置后的置顶状态(boolean)。
+     */
+    setAlwaysOnTop: (value: boolean) => Promise<boolean>;
     /**
      * 切换发起方窗口的置顶状态(screen-saver 级),返回切换后的状态。
      * 同时向发起方视图广播 plugin.alwaysOnTopChanged 事件,便于渲染层同步回显。