@fkn/lib 0.9.7 → 0.9.8

package/{api-9O1SM4CR.d.ts → api-BdGpFv2D.d.ts}

@@ -1,4 +1,4 @@
-import { C as PackageResult, E as PickOptions, S as PackageQuery, T as PackagesFail, b as InstallOptions, v as Caller, x as InstalledPackage, y as ConnectOptions } from "./packages-CSZGUtem.js";
+import { D as InstalledPackage, E as InstallOptions, M as PickOptions, N as SurfaceRect, O as PackageQuery, T as ConnectOptions, j as PackagesFail, k as PackageResult, w as Caller } from "./packages-DU1D-pr4.js";
 import { t as AddressLookupResult } from "./lookup-BtwWaCZJ.js";
 //#region src/api/storage.d.ts
 type StorageEntry = {
@@ -684,6 +684,12 @@ declare const makeResolvers: (callerOf: () => Caller | undefined) => {
       port: MessagePort;
       closed: Promise<void>;
     }>;
+    show: (uri: string, rect: SurfaceRect) => Promise<PackagesFail | {
+      ok: true;
+    }>;
+    hide: (uri: string) => Promise<PackagesFail | {
+      ok: true;
+    }>;
   };
   readonly account: {
     readonly info: () => Promise<Account | null>;

package/cloud/fetch.d.ts

@@ -1,2 +1,2 @@
-import { t as cloudFetch } from "../proxy-pCTWR0E6.js";
+import { t as cloudFetch } from "../proxy-CsFzuq-x.js";
 export { cloudFetch as fetch };

package/cloud/net.d.ts

@@ -1,2 +1,2 @@
-import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "../net-BDjZxAEZ.js";
+import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "../net-BVC0ImHf.js";
 export { Server, Socket, _default, _default as default, connect, createConnection, createServer, isIP, isIPv4, isIPv6 };

package/{cloud-wrRNWHAn.d.ts → cloud-C002L8iN.d.ts}

@@ -1,8 +1,8 @@
-import { t as cloudFetch } from "./proxy-pCTWR0E6.js";
+import { t as cloudFetch } from "./proxy-CsFzuq-x.js";
 import { d as Frame, u as AttachFrameOptions } from "./index-DQfP-Uhy.js";
 import { t as dns_d_exports } from "./dns.js";
 import { n as fs_d_exports } from "./fs-DTmSCXwa.js";
-import { s as net_d_exports } from "./net-BDjZxAEZ.js";
+import { s as net_d_exports } from "./net-BVC0ImHf.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 

package/cloud.d.ts

@@ -1,8 +1,8 @@
-import { t as cloudFetch } from "./proxy-pCTWR0E6.js";
-import { a as attachFrame, i as quota, r as QuotaStatus, t as available } from "./cloud-wrRNWHAn.js";
+import { t as cloudFetch } from "./proxy-CsFzuq-x.js";
+import { a as attachFrame, i as quota, r as QuotaStatus, t as available } from "./cloud-C002L8iN.js";
 import { t as dns_d_exports } from "./dns.js";
 import { n as fs_d_exports } from "./fs-DTmSCXwa.js";
-import { s as net_d_exports } from "./net-BDjZxAEZ.js";
+import { s as net_d_exports } from "./net-BVC0ImHf.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 export { type QuotaStatus, attachFrame, available, dgram_d_exports as dgram, dns_d_exports as dns, cloudFetch as fetch, fs_d_exports as fs, http_d_exports as http, net_d_exports as net, quota };

package/dgram.d.ts

@@ -1,4 +1,4 @@
-import { n as UdpSocketOption, t as Resolvers } from "./api-9O1SM4CR.js";
+import { n as UdpSocketOption, t as Resolvers } from "./api-BdGpFv2D.js";
 import { Buffer } from "buffer";
 import { AddressInfo } from "net";
 import { EventEmitter } from "events";

package/http.d.ts

@@ -1,4 +1,4 @@
-import { n as Socket, t as Server$1 } from "./net-BDjZxAEZ.js";
+import { n as Socket, t as Server$1 } from "./net-BVC0ImHf.js";
 import { Buffer } from "buffer";
 import { Stream } from "stream";
 import { IncomingHttpHeaders, OutgoingHttpHeaders, RequestOptions } from "http";

package/index.d.ts

@@ -1,9 +1,9 @@
 import { t as account_d_exports } from "./account.js";
-import { m as packages_d_exports } from "./packages-CSZGUtem.js";
+import { y as packages_d_exports } from "./packages-DU1D-pr4.js";
 import { A as LOCATOR_DENIED, B as SelectorPart, C as RemoteVideoElement, D as isType, E as createVideoElementHandle, F as isTerminalError, G as setRequestHeaderRule, H as RequestHeaderRule, I as Executor, J as cookies, K as CookieDetails, L as Gate, M as LOCATOR_UNSUPPORTED, N as isLocatorDenied, O as revive, P as isLocatorUnsupported, Q as assertFetchableUrl, R as GateTools, S as BoxedVideoElement, T as box, U as modifyRequestHeadersPermission, V as HeaderOperation, W as removeRequestHeaderRule, X as FetchInit, Y as readCookiePermission, Z as ProxyFetchRequest, _ as gotoPermission, a as PermissionGrant, at as FORGEABLE_HEADERS, b as isBlockedFrameUrl, c as ATTACH_FRAME_EVENT_KEY, ct as hasForgedCookie, d as Frame, et as fetchCredentialedPermission, f as FrameBackend, g as createFrame, h as attachFramePermission, i as waitForExtensionExposure, it as isLocalNetworkUrl, j as LOCATOR_ERROR, k as type, m as Locator, n as isExtensionExposed, nt as fetchPermission, o as PermissionRequest, ot as assertForgeableHeaders, p as GotoOptions, q as SiteCookie, r as setMissingExtensionHandler, rt as isBlockedFetchUrl, s as permissions, st as assertOneCookieIdentity, tt as fetchLocalPermission, u as AttachFrameOptions, v as assertAttachableFrameUrl, w as VideoElementState, x as handleRevivableModules, y as assertLockdownApplicable, z as OperationRequest } from "./index-DQfP-Uhy.js";
-import { n as cloud_d_exports } from "./cloud-wrRNWHAn.js";
+import { n as cloud_d_exports } from "./cloud-C002L8iN.js";
 import { t as dns_d_exports } from "./dns.js";
-import { s as net_d_exports } from "./net-BDjZxAEZ.js";
+import { s as net_d_exports } from "./net-BVC0ImHf.js";
 import { t as dgram_d_exports } from "./dgram.js";
 import { t as http_d_exports } from "./http.js";
 import { t as desktop_d_exports } from "./desktop.js";

package/{net-BDjZxAEZ.d.ts → net-BVC0ImHf.d.ts}

@@ -1,4 +1,4 @@
-import { i as TcpSocketOption, r as LocalTcpSocket, t as Resolvers } from "./api-9O1SM4CR.js";
+import { i as TcpSocketOption, r as LocalTcpSocket, t as Resolvers } from "./api-BdGpFv2D.js";
 import { AddressInfo, ListenOptions, Server, ServerOpts, Socket, SocketConnectOpts, SocketConstructorOpts } from "net";
 import { DuplexOptions, Stream } from "stream";
 import { EventEmitter } from "events";

package/net.d.ts

@@ -1,2 +1,2 @@
-import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-BDjZxAEZ.js";
+import { a as createConnection, c as isIP, i as connect, l as isIPv4, n as Socket, o as createServer, r as _default, t as Server, u as isIPv6 } from "./net-BVC0ImHf.js";
 export { Server, Socket, _default, _default as default, connect, createConnection, createServer, isIP, isIPv4, isIPv6 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fkn/lib",
-  "version": "0.9.7",
+  "version": "0.9.8",
   "main": "index.js",
   "types": "index.d.ts",
   "type": "module",

package/{packages-CSZGUtem.d.ts → packages-DU1D-pr4.d.ts}

@@ -41,6 +41,13 @@ type InstallOptions = {
 type ConnectOptions = {
   /** opaque contract tag delivered to the package's onConnect, e.g. 'stub-source@1' */protocol?: string;
 };
+/** viewport coordinates, the space both the app and the broker frame measure in */
+type SurfaceRect = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
 type PackagesErrorCode = 'invalid' | 'not-installed' | 'unaddressable' | 'timeout' | 'unavailable' | 'denied';
 type PackagesFail = {
   error: PackagesErrorCode;
@@ -59,7 +66,7 @@ type Caller = {
   origin: string;
 };
 declare namespace packages_d_exports {
-  export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, PackageConnection, PackageQuery, PackageResult, PackagesError, PackagesErrorCode, PickOptions, RawPackageConnection, attach, connect, install, list, onConnect, pick, search, uninstall };
+  export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, PackageConnection, PackageQuery, PackageResult, PackageView, PackagesError, PackagesErrorCode, PickOptions, RawPackageConnection, ShowOptions, SurfaceRect, attach, connect, hide, install, isVisible, list, onConnect, onVisibilityChange, pick, search, show, uninstall };
 }
 type PackagesError = Error & {
   code: PackagesErrorCode;
@@ -74,6 +81,27 @@ declare const install: (uri: string, options?: InstallOptions) => Promise<Instal
 declare const list: () => Promise<InstalledPackage[]>;
 /** Uninstall a package from this app; its frames and connections are torn down. */
 declare const uninstall: (uri: string) => Promise<void>;
+type ShowOptions = {
+  /** the package frame is kept aligned to this element's viewport rect until the view is released */element?: HTMLElement; /** an explicit viewport rect, for a caller that tracks placement itself */
+  rect?: SurfaceRect;
+};
+type PackageView = {
+  /** release this view; equivalent to `packages.hide(uri, { element })` */hide: () => void; /** force a re-measure, e.g. right after a layout change the tracker cannot observe */
+  refresh: () => void;
+};
+/**
+ * Show an installed, connected package's frame over this page, aligned to `element` (or an explicit
+ * `rect`). The package renders its own UI there; the app keeps the space in its own layout. Take it
+ * back down with `hide()` on the returned view, or with `packages.hide(uri)`. Throws a PackagesError
+ * with code 'not-installed' when the package has not been connected by this app.
+ */
+declare const show: (uri: string, options: ShowOptions) => Promise<PackageView>;
+/**
+ * Hide a package's frame again, the counterpart to `show()`. Pass the same `element` to release only
+ * the view bound to it; with no element every view of this package is released. The connection is
+ * untouched, so the package can be shown again.
+ */
+declare const hide: (uri: string, options?: ShowOptions) => Promise<void>;
 type PackageConnection<T = unknown> = {
   /** the package's exposed payload */remote: Remote<T>; /** settles when the package side of the connection dies (uninstall, reload, crash) - reconnect by calling connect() again */
   closed: Promise<void>; /** the raw channel under `remote`, for direct messaging (osra envelopes ride it too - filter by your own message shape) */
@@ -117,5 +145,14 @@ type ConnectPayload = (info: IncomingConnectionInfo) => unknown;
 declare const onConnect: <T = unknown>(createPayload: ConnectPayload, handler?: (connection: IncomingConnection<T>) => void) => {
   unsubscribe: () => void;
 };
+/** True while a host app is showing this package's frame. Packages start hidden. */
+declare const isVisible: () => boolean;
+/**
+ * Observe whether a host app is showing this package's frame, so it can render its UI only while on
+ * screen. The handler is called immediately with the current state, and on every change after.
+ */
+declare const onVisibilityChange: (handler: (visible: boolean) => void) => {
+  unsubscribe: () => void;
+};
 //#endregion
-export { PackageResult as C, PickOptions as E, PackageQuery as S, PackagesFail as T, uninstall as _, IncomingConnectionInfo as a, InstallOptions as b, RawPackageConnection as c, install as d, list as f, search as g, pick as h, IncomingConnection as i, attach as l, packages_d_exports as m, Connect as n, PackageConnection as o, onConnect as p, ConnectPayload as r, PackagesError as s, AppConnectOptions as t, connect as u, Caller as v, PackagesErrorCode as w, InstalledPackage as x, ConnectOptions as y };
+export { PackagesErrorCode as A, uninstall as C, InstalledPackage as D, InstallOptions as E, PickOptions as M, SurfaceRect as N, PackageQuery as O, show as S, ConnectOptions as T, onConnect as _, IncomingConnectionInfo as a, pick as b, PackagesError as c, attach as d, connect as f, list as g, isVisible as h, IncomingConnection as i, PackagesFail as j, PackageResult as k, RawPackageConnection as l, install as m, Connect as n, PackageConnection as o, hide as p, ConnectPayload as r, PackageView as s, AppConnectOptions as t, ShowOptions as u, onVisibilityChange as v, Caller as w, search as x, packages_d_exports as y };

package/packages.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-C9Mh5v0z.cjs");let n=require("osra");var r=e.t({attach:()=>_,connect:()=>g,install:()=>p,list:()=>m,onConnect:()=>O,pick:()=>f,search:()=>d,uninstall:()=>h}),i=`https://fkn.app`,a=`fkn-packages-connection`,o=3e4,s=(e,t)=>Object.assign(Error(t),{code:e}),c=async()=>{if(!t.r)throw s(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.t},l=(e,t,r)=>(0,n.expose)(e??{},{transport:t,key:a,unregisterSignal:r}),u=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw s(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let c=new AbortController,u=new Promise((e,n)=>{let a=setTimeout(()=>n(s(`timeout`,`packages.connect: the package did not complete the connection`)),o);c.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(s(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:c.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(s(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:c.signal}),i?.then(()=>n(s(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([l(e,t,a.signal),u])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{c.abort()}},d=async e=>{let t=await(await c()).packages.search(e);if(`error`in t)throw s(t.error,t.message);return t.results},f=async(e,t)=>{let n=await(await c()).packages.pick(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?[]:n.results},p=async(e,t)=>{let n=await(await c()).packages.install(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?null:n.installed},m=async()=>(await(await c()).packages.list()).results,h=async e=>{let t=await(await c()).packages.uninstall(e);if(`error`in t)throw s(t.error,t.message)},g=(async(e,t={})=>{let n=await(await c()).packages.connect(e,{protocol:t.protocol});if(`error`in n)throw s(n.error,n.message);let{port:r,closed:i}=n;if(t.raw)return{closed:i,port:r};let a=await u(t.payload,r,{signal:t.signal,closed:i});return t.signal&&t.signal.addEventListener(`abort`,()=>{try{r.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:a,closed:i,port:r}}),_=(e,t,n)=>u(t,e,{signal:n?.signal}),v=null,y=[],b=new Map,x=!1,S=!1,C=e=>{let t=b.get(e);t&&(b.delete(e),t())},w=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},T=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&C(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw w(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>b.set(e.port,t)),o=await l(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},E=()=>{x||typeof window>`u`||window.parent===window||(x=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent||e.origin!==i)return;let t=e.data;if(t?.type===`fkn-packages-port`){let n=e.ports[0];if(!n)return;let r={port:n,from:typeof t.from==`string`?t.from:``,protocol:typeof t.protocol==`string`?t.protocol:null,uri:typeof t.uri==`string`?t.uri:``,name:typeof t.name==`string`?t.name:``,version:typeof t.version==`string`?t.version:``};v?T(r,v).catch(e=>console.warn(`packages.onConnect:`,e)):y.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...b.keys()])C(e)}))},D=()=>{S||typeof window>`u`||window.parent===window||(S=!0,window.parent.postMessage({type:`fkn-packages-ready`},i))},O=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};E();let n={createPayload:e,handler:t};for(v=n,D();y.length&&v===n;)T(y.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{v===n&&(v=null)}}};exports.attach=_,exports.connect=g,exports.install=p,exports.list=m,exports.onConnect=O,exports.pick=f,exports.search=d,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.uninstall=h;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-C9Mh5v0z.cjs");let n=require("osra");var r=e.t({attach:()=>C,connect:()=>S,hide:()=>x,install:()=>p,isVisible:()=>L,list:()=>m,onConnect:()=>I,onVisibilityChange:()=>R,pick:()=>f,search:()=>d,show:()=>b,uninstall:()=>h}),i=`https://fkn.app`,a=`fkn-packages-connection`,o=3e4,s=(e,t)=>Object.assign(Error(t),{code:e}),c=async()=>{if(!t.r)throw s(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.t},l=(e,t,r)=>(0,n.expose)(e??{},{transport:t,key:a,unregisterSignal:r}),u=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw s(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let c=new AbortController,u=new Promise((e,n)=>{let a=setTimeout(()=>n(s(`timeout`,`packages.connect: the package did not complete the connection`)),o);c.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(s(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:c.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(s(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:c.signal}),i?.then(()=>n(s(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([l(e,t,a.signal),u])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{c.abort()}},d=async e=>{let t=await(await c()).packages.search(e);if(`error`in t)throw s(t.error,t.message);return t.results},f=async(e,t)=>{let n=await(await c()).packages.pick(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?[]:n.results},p=async(e,t)=>{let n=await(await c()).packages.install(e,t);if(`error`in n)throw s(n.error,n.message);return`declined`in n?null:n.installed},m=async()=>(await(await c()).packages.list()).results,h=async e=>{let t=await(await c()).packages.uninstall(e);if(`error`in t)throw s(t.error,t.message)},g=(e,t)=>!!e&&e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height,_=({x:e,y:t,width:n,height:r})=>({x:Math.round(e),y:Math.round(t),width:Math.round(n),height:Math.round(r)}),v=new Map,y=async(e,t)=>{let n=v.get(e);if(n){for(let e of n)t&&e.element!==t||(e.stop(),n.delete(e));if(n.size>0)return;v.delete(e)}let r=await(await c()).packages.hide(e);if(`error`in r)throw s(r.error,r.message)},b=async(e,t)=>{let{element:n,rect:r}=t;if(!n&&!r)throw s(`invalid`,`packages.show: pass an element or a rect`);let i=(await c()).packages,a=()=>_(n?n.getBoundingClientRect():r),o=!0,l,u=0,d=async t=>{l=t;let n=await i.show(e,t);if(`error`in n)throw o=!1,s(n.error,n.message)};await d(a());let f=()=>{if(!o)return;let e=a();g(l,e)||d(e).catch(()=>{}),u=requestAnimationFrame(f)};n&&(u=requestAnimationFrame(f));let p={element:n,stop:()=>{o=!1,cancelAnimationFrame(u)}},m=v.get(e)??new Set;return m.add(p),v.set(e,m),{hide:()=>{y(e,n).catch(()=>{})},refresh:()=>{if(!o)return;let e=a();g(l,e)||d(e).catch(()=>{})}}},x=async(e,t={})=>y(e,t.element),S=(async(e,t={})=>{let n=await(await c()).packages.connect(e,{protocol:t.protocol});if(`error`in n)throw s(n.error,n.message);let{port:r,closed:i}=n;if(t.raw)return{closed:i,port:r};let a=await u(t.payload,r,{signal:t.signal,closed:i});return t.signal&&t.signal.addEventListener(`abort`,()=>{try{r.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:a,closed:i,port:r}}),C=(e,t,n)=>u(t,e,{signal:n?.signal}),w=null,T=!1,E=new Set,D=[],O=new Map,k=!1,A=!1,j=e=>{let t=O.get(e);t&&(O.delete(e),t())},M=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},N=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&j(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw M(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>O.set(e.port,t)),o=await l(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},P=()=>{k||typeof window>`u`||window.parent===window||(k=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent||e.origin!==i)return;let t=e.data;if(t?.type===`fkn-packages-port`){let n=e.ports[0];if(!n)return;let r={port:n,from:typeof t.from==`string`?t.from:``,protocol:typeof t.protocol==`string`?t.protocol:null,uri:typeof t.uri==`string`?t.uri:``,name:typeof t.name==`string`?t.name:``,version:typeof t.version==`string`?t.version:``};w?N(r,w).catch(e=>console.warn(`packages.onConnect:`,e)):D.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...O.keys()])j(e);if(t?.type===`fkn-packages-visibility`){T=t.visible===!0;for(let e of E)try{e(T)}catch{}}}))},F=()=>{A||typeof window>`u`||window.parent===window||(A=!0,window.parent.postMessage({type:`fkn-packages-ready`},i))},I=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};P();let n={createPayload:e,handler:t};for(w=n,F();D.length&&w===n;)N(D.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{w===n&&(w=null)}}},L=()=>T,R=e=>{if(typeof window>`u`)return{unsubscribe:()=>{}};P(),E.add(e);try{e(T)}catch{}return{unsubscribe:()=>{E.delete(e)}}};exports.attach=C,exports.connect=S,exports.hide=x,exports.install=p,exports.isVisible=L,exports.list=m,exports.onConnect=I,exports.onVisibilityChange=R,exports.pick=f,exports.search=d,exports.show=b,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return r}}),exports.uninstall=h;

package/packages.d.ts

@@ -1,2 +1,2 @@
-import { C as PackageResult, E as PickOptions, S as PackageQuery, _ as uninstall, a as IncomingConnectionInfo, b as InstallOptions, c as RawPackageConnection, d as install, f as list, g as search, h as pick, i as IncomingConnection, l as attach, n as Connect, o as PackageConnection, p as onConnect, r as ConnectPayload, s as PackagesError, t as AppConnectOptions, u as connect, w as PackagesErrorCode, x as InstalledPackage, y as ConnectOptions } from "./packages-CSZGUtem.js";
-export { AppConnectOptions, Connect, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, PackageConnection, type PackageQuery, type PackageResult, PackagesError, type PackagesErrorCode, type PickOptions, RawPackageConnection, attach, connect, install, list, onConnect, pick, search, uninstall };
+import { A as PackagesErrorCode, C as uninstall, D as InstalledPackage, E as InstallOptions, M as PickOptions, N as SurfaceRect, O as PackageQuery, S as show, T as ConnectOptions, _ as onConnect, a as IncomingConnectionInfo, b as pick, c as PackagesError, d as attach, f as connect, g as list, h as isVisible, i as IncomingConnection, k as PackageResult, l as RawPackageConnection, m as install, n as Connect, o as PackageConnection, p as hide, r as ConnectPayload, s as PackageView, t as AppConnectOptions, u as ShowOptions, v as onVisibilityChange, x as search } from "./packages-DU1D-pr4.js";
+export { AppConnectOptions, Connect, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, PackageConnection, type PackageQuery, type PackageResult, PackageView, PackagesError, type PackagesErrorCode, type PickOptions, RawPackageConnection, ShowOptions, type SurfaceRect, attach, connect, hide, install, isVisible, list, onConnect, onVisibilityChange, pick, search, show, uninstall };

package/packages.js

@@ -3,13 +3,17 @@ import { r as t, t as n } from "./api-BU8zNmQI.js";
 import { expose as r } from "osra";
 //#region src/lib/packages.ts
 var i = /* @__PURE__ */ e({
-	attach: () => v,
-	connect: () => _,
+	attach: () => w,
+	connect: () => C,
+	hide: () => S,
 	install: () => m,
+	isVisible: () => R,
 	list: () => h,
-	onConnect: () => k,
+	onConnect: () => L,
+	onVisibilityChange: () => z,
 	pick: () => p,
 	search: () => f,
+	show: () => x,
 	uninstall: () => g
 }), a = "https://fkn.app", o = "fkn-packages-connection", s = 3e4, c = (e, t) => Object.assign(Error(t), { code: e }), l = async () => {
 	if (!t) throw c("unavailable", "packages: no FKN transport in this realm - use relayWorker to bridge workers");
@@ -61,7 +65,52 @@ var i = /* @__PURE__ */ e({
 }, h = async () => (await (await l()).packages.list()).results, g = async (e) => {
 	let t = await (await l()).packages.uninstall(e);
 	if ("error" in t) throw c(t.error, t.message);
-}, _ = (async (e, t = {}) => {
+}, _ = (e, t) => !!e && e.x === t.x && e.y === t.y && e.width === t.width && e.height === t.height, v = ({ x: e, y: t, width: n, height: r }) => ({
+	x: Math.round(e),
+	y: Math.round(t),
+	width: Math.round(n),
+	height: Math.round(r)
+}), y = /* @__PURE__ */ new Map(), b = async (e, t) => {
+	let n = y.get(e);
+	if (n) {
+		for (let e of n) t && e.element !== t || (e.stop(), n.delete(e));
+		if (n.size > 0) return;
+		y.delete(e);
+	}
+	let r = await (await l()).packages.hide(e);
+	if ("error" in r) throw c(r.error, r.message);
+}, x = async (e, t) => {
+	let { element: n, rect: r } = t;
+	if (!n && !r) throw c("invalid", "packages.show: pass an element or a rect");
+	let i = (await l()).packages, a = () => v(n ? n.getBoundingClientRect() : r), o = !0, s, u = 0, d = async (t) => {
+		s = t;
+		let n = await i.show(e, t);
+		if ("error" in n) throw o = !1, c(n.error, n.message);
+	};
+	await d(a());
+	let f = () => {
+		if (!o) return;
+		let e = a();
+		_(s, e) || d(e).catch(() => {}), u = requestAnimationFrame(f);
+	};
+	n && (u = requestAnimationFrame(f));
+	let p = {
+		element: n,
+		stop: () => {
+			o = !1, cancelAnimationFrame(u);
+		}
+	}, m = y.get(e) ?? /* @__PURE__ */ new Set();
+	return m.add(p), y.set(e, m), {
+		hide: () => {
+			b(e, n).catch(() => {});
+		},
+		refresh: () => {
+			if (!o) return;
+			let e = a();
+			_(s, e) || d(e).catch(() => {});
+		}
+	};
+}, S = async (e, t = {}) => b(e, t.element), C = (async (e, t = {}) => {
 	let n = await (await l()).packages.connect(e, { protocol: t.protocol });
 	if ("error" in n) throw c(n.error, n.message);
 	let { port: r, closed: i } = n;
@@ -82,10 +131,10 @@ var i = /* @__PURE__ */ e({
 		closed: i,
 		port: r
 	};
-}), v = (e, t, n) => d(t, e, { signal: n?.signal }), y = null, b = [], x = /* @__PURE__ */ new Map(), S = !1, C = !1, w = (e) => {
-	let t = x.get(e);
-	t && (x.delete(e), t());
-}, T = (e, t) => {
+}), w = (e, t, n) => d(t, e, { signal: n?.signal }), T = null, E = !1, D = /* @__PURE__ */ new Set(), O = [], k = /* @__PURE__ */ new Map(), A = !1, j = !1, M = (e) => {
+	let t = k.get(e);
+	t && (k.delete(e), t());
+}, N = (e, t) => {
 	try {
 		e.postMessage({
 			type: "fkn-packages-nack",
@@ -95,26 +144,26 @@ var i = /* @__PURE__ */ e({
 	try {
 		e.close();
 	} catch {}
-}, E = async (e, t) => {
+}, P = async (e, t) => {
 	let { port: n, ...r } = e;
 	e.port.addEventListener("message", (t) => {
-		t.data?.type === "fkn-packages-disconnect" && w(e.port);
+		t.data?.type === "fkn-packages-disconnect" && M(e.port);
 	});
 	let i;
 	try {
 		i = await t.createPayload(r);
 	} catch (t) {
-		throw T(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
+		throw N(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
 	}
-	let a = new Promise((t) => x.set(e.port, t)), o = await u(i, e.port);
+	let a = new Promise((t) => k.set(e.port, t)), o = await u(i, e.port);
 	t.handler?.({
 		...r,
 		remote: o,
 		closed: a,
 		port: e.port
 	});
-}, D = () => {
-	S || typeof window > "u" || window.parent === window || (S = !0, window.addEventListener("message", (e) => {
+}, F = () => {
+	A || typeof window > "u" || window.parent === window || (A = !0, window.addEventListener("message", (e) => {
 		if (e.source !== window.parent || e.origin !== a) return;
 		let t = e.data;
 		if (t?.type === "fkn-packages-port") {
@@ -128,23 +177,38 @@ var i = /* @__PURE__ */ e({
 				name: typeof t.name == "string" ? t.name : "",
 				version: typeof t.version == "string" ? t.version : ""
 			};
-			y ? E(r, y).catch((e) => console.warn("packages.onConnect:", e)) : b.push(r);
+			T ? P(r, T).catch((e) => console.warn("packages.onConnect:", e)) : O.push(r);
+		}
+		if (t?.type === "fkn-packages-close") for (let e of [...k.keys()]) M(e);
+		if (t?.type === "fkn-packages-visibility") {
+			E = t.visible === !0;
+			for (let e of D) try {
+				e(E);
+			} catch {}
 		}
-		if (t?.type === "fkn-packages-close") for (let e of [...x.keys()]) w(e);
 	}));
-}, O = () => {
-	C || typeof window > "u" || window.parent === window || (C = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, a));
-}, k = (e, t) => {
+}, I = () => {
+	j || typeof window > "u" || window.parent === window || (j = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, a));
+}, L = (e, t) => {
 	if (typeof window > "u") return { unsubscribe: () => {} };
-	D();
+	F();
 	let n = {
 		createPayload: e,
 		handler: t
 	};
-	for (y = n, O(); b.length && y === n;) E(b.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
+	for (T = n, I(); O.length && T === n;) P(O.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
+	return { unsubscribe: () => {
+		T === n && (T = null);
+	} };
+}, R = () => E, z = (e) => {
+	if (typeof window > "u") return { unsubscribe: () => {} };
+	F(), D.add(e);
+	try {
+		e(E);
+	} catch {}
 	return { unsubscribe: () => {
-		y === n && (y = null);
+		D.delete(e);
 	} };
 };
 //#endregion
-export { v as attach, _ as connect, m as install, h as list, k as onConnect, p as pick, f as search, i as t, g as uninstall };
+export { w as attach, C as connect, S as hide, m as install, R as isVisible, h as list, L as onConnect, z as onVisibilityChange, p as pick, f as search, x as show, i as t, g as uninstall };

package/{proxy-pCTWR0E6.d.ts → proxy-CsFzuq-x.d.ts}

@@ -1,4 +1,4 @@
-import { t as Resolvers } from "./api-9O1SM4CR.js";
+import { t as Resolvers } from "./api-BdGpFv2D.js";
 
 //#region src/lib/proxy.d.ts
 type ProxyFetch = Resolvers['cloud']['fetch'];