@fkn/lib 0.9.64 → 0.9.65

package/packages-BEadIy_h.d.ts

@@ -0,0 +1,155 @@
+import { E as InstalledPackage, F as PackageResult, I as PackagesErrorCode, J as Radii, P as PackageQuery, R as PickOptions, Rt as SurfaceRect, T as InstallOptions, m as ConnectOptions, z as Placement } from "./contract-0rua6Wsh.js";
+import { Remote } from "osra";
+declare namespace packages_d_exports {
+  export { AppConnectOptions, Connect, ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, InstallOptions, InstalledPackage, MountOptions, MountedPackage, PackageConnection, PackageQuery, PackageResult, PackageView, PackagesError, PackagesErrorCode, PickOptions, Placement, Radii, RawPackageConnection, ShowOptions, SurfaceRect, attach, connect, hide, install, isVisible, list, mount, onConnect, onVisibilityChange, pick, search, show, uninstall };
+}
+type PackagesError = Error & {
+  code: PackagesErrorCode;
+};
+/** Search npm for FKN packages, e.g. `search({ type: 'plugin', id: 'stub' })`. */
+declare const search: (query: PackageQuery) => Promise<PackageResult[]>;
+/** FKN-rendered picker over the same search; resolves the user's selection, already installed. [] on cancel. */
+declare const pick: (query: PackageQuery, options?: PickOptions) => Promise<PackageResult[]>;
+/** Install a package for this app behind an FKN-rendered confirm, or with `{ noConfirm: true }` for a notice instead of a prompt. Resolves null when the user declines. */
+declare const install: (uri: string, options?: InstallOptions) => Promise<InstalledPackage | null>;
+/** The packages installed by this app. */
+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 = {
+  /**
+   * A placeholder the package frame is aligned to for as long as the view lives. The frame tracks its
+   * rect every animation frame, is clipped by its scrolling ancestors, and follows its border-radius,
+   * so it reads as inline content even though it renders in FKN's overlay.
+   */
+  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) */
+  port: MessagePort;
+};
+type AppConnectOptions = ConnectOptions & {
+  /** exposed to the package as ITS `remote` */
+  payload?: unknown;
+  signal?: AbortSignal;
+  /** skip the osra handshake and hand back the untouched port - e.g. to transfer it into a worker and attach() there */
+  raw?: boolean;
+};
+type RawPackageConnection = Omit<PackageConnection<never>, 'remote'>;
+type Connect = {
+  <T = unknown>(uri: string, options?: AppConnectOptions & {
+    raw?: false;
+  }): Promise<PackageConnection<T>>;
+  (uri: string, options: AppConnectOptions & {
+    raw: true;
+  }): Promise<RawPackageConnection>;
+};
+/** Connect to an installed package. Throws a PackagesError with code 'not-installed' when it is not. */
+declare const connect: Connect;
+type MountOptions = AppConnectOptions & {
+  /**
+   * the iframe the package is loaded into. YOU create it and YOU own it: its attributes, its styles and
+   * its place in your layout are yours, and `mount` only navigates it.
+   *
+   * Set `allow` yourself for anything the package needs delegated, e.g. `allow="fullscreen; autoplay"`.
+   * Permissions policy is not inherited, so a capability this frame is not granted cannot be recovered
+   * by the package or by anything it nests inside itself.
+   */
+  iframe: HTMLIFrameElement;
+};
+type MountedPackage<T = unknown> = PackageConnection<T> & {
+  /** the iframe you passed in, unchanged apart from its `src` */
+  frame: HTMLIFrameElement;
+  /** blank the frame and settle `closed`; the element stays in your layout because it is yours */
+  unmount: () => void;
+};
+/**
+ * Load a package into an iframe of YOUR OWN and connect to it, instead of positioning a frame the broker
+ * owns and clipping the overlay to it the way `show()` does.
+ *
+ * You pass the iframe, the same way `cloud.attachFrame` takes one. It lays out, scrolls, stacks and
+ * fullscreens with the rest of your page, there is no geometry to translate, and every attribute on it
+ * stays exactly as you set it: `mount` reads `sandbox` and `allow` to check the package can boot, then
+ * writes nothing but `src`. The package still gets its own origin and its own broker connection.
+ *
+ * Grant capabilities through the iframe's own `allow`, before calling this. Permissions policy is read
+ * at navigation and is not inherited, so it cannot be added afterwards on the frame handed back.
+ *
+ * Needs a package built against this version of the lib: an older one only accepts a port from fkn.app.
+ * The package reads `brokered: false`.
+ */
+declare const mount: <T = unknown>(uri: string, options: MountOptions) => Promise<MountedPackage<T>>;
+/** Run this end of an already-brokered connection port, e.g. after transferring it into a worker. */
+declare const attach: <T = unknown>(port: MessagePort, payload?: unknown, options?: {
+  signal?: AbortSignal;
+}) => Promise<Remote<T>>;
+type IncomingConnectionInfo = {
+  /**
+   * The connecting app's identity: its package uri when it runs on a sandbox origin, else its page
+   * origin. Proof of nothing unless `brokered` is true: under `packages.mount`, or in any page that
+   * frames this package's url itself, the embedder writes whatever it likes here.
+   */
+  from: string;
+  /**
+   * True only when fkn.app's broker made this connection (`packages.connect`), so `from` is the app the
+   * broker identified by its browser-set origin. False under `packages.mount` and for any other embedder.
+   * Worked out here from the origin of the message that carried the port, never read from the message.
+   * Key what a connection is allowed (a grant you stored, an app named to the person) to `from` only
+   * when this is true. A package built on a lib older than this field gets none, so test `=== true`.
+   */
+  brokered: boolean;
+  /** the contract tag the app passed to connect(), e.g. 'stub-source@1' */
+  protocol: string | null;
+  /** this package's normalized uri per the connecting app's install record, e.g. 'npm:@banou/stub-source-example' */
+  uri: string;
+  /** this package's npm name */
+  name: string;
+  /** the exact version this frame runs - the pin is encoded into the sandbox origin, immutable per version */
+  version: string;
+};
+type IncomingConnection<T = unknown> = IncomingConnectionInfo & PackageConnection<T>;
+/** produces the payload exposed to a connecting app - called once per incoming connection */
+type ConnectPayload = (info: IncomingConnectionInfo) => unknown;
+/**
+ * Serve connections from apps that installed this package. The first argument is called once per
+ * incoming connection with the connection info and returns the payload exposed to that app (its
+ * `remote`). The latest registration receives new connections; existing connections are unaffected.
+ */
+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;
+};
+export { pick as C, uninstall as E, packages_d_exports as S, show as T, isVisible as _, IncomingConnectionInfo as a, onConnect as b, PackageConnection as c, RawPackageConnection as d, ShowOptions as f, install as g, hide as h, IncomingConnection as i, PackageView as l, connect as m, Connect as n, MountOptions as o, attach as p, ConnectPayload as r, MountedPackage as s, AppConnectOptions as t, PackagesError as u, list as v, search as w, onVisibilityChange as x, mount as y };

package/packages-Cws_rcgf.js

@@ -0,0 +1,346 @@
+import { t as e } from "./rolldown-runtime-CGnMp29N.js";
+import { c as t, l as n, o as r, u as i } from "./api-DRglK7ft.js";
+import { i as a, t as o } from "./busy-C1JPjoZ_.js";
+import { expose as s } from "osra";
+// src/packages.ts
+var c = /* @__PURE__ */ e({
+	attach: () => I,
+	connect: () => A,
+	hide: () => k,
+	install: () => v,
+	isVisible: () => X,
+	list: () => y,
+	mount: () => F,
+	onConnect: () => Y,
+	onVisibilityChange: () => Z,
+	pick: () => _,
+	search: () => g,
+	show: () => O,
+	uninstall: () => b
+}), l = "fkn-packages-connection", u = "https://fkn.app", d = 3e4, f = (e, t) => Object.assign(Error(t), { code: e }), p = async () => {
+	if (!n) throw f("unavailable", "packages: no FKN transport in this realm - use relayWorker to bridge workers");
+	return r;
+}, m = (e, t, n) => s(e ?? {}, {
+	transport: t,
+	key: l,
+	unregisterSignal: n
+}), h = async (e, t, n = {}) => {
+	let { signal: r, closed: i } = n;
+	if (r?.aborted) throw f("unavailable", "packages.connect: aborted before connecting");
+	let a = new AbortController();
+	r && r.addEventListener("abort", () => a.abort(r.reason), { once: !0 });
+	let o = new AbortController(), s = new Promise((e, n) => {
+		let a = setTimeout(() => n(f("timeout", "packages.connect: the package did not complete the connection")), d);
+		o.signal.addEventListener("abort", () => clearTimeout(a), { once: !0 }), t.addEventListener("message", (e) => {
+			if (e.data?.type === "fkn-packages-nack") {
+				let t = e.data.message;
+				n(f("unavailable", typeof t == "string" && t ? t : "packages.connect: the package refused the connection"));
+			}
+		}, { signal: o.signal }), t.start(), r && r.addEventListener("abort", () => n(f("unavailable", "packages.connect: aborted before connecting")), {
+			once: !0,
+			signal: o.signal
+		}), i?.then(() => n(f("unavailable", "packages.connect: the package closed before connecting")));
+	});
+	try {
+		return await Promise.race([m(e, t, a.signal), s]);
+	} catch (e) {
+		a.abort(e);
+		try {
+			t.close();
+		} catch {}
+		throw e;
+	} finally {
+		o.abort();
+	}
+}, g = async (e) => {
+	let t = await (await p()).packages.search(e);
+	if ("error" in t) throw f(t.error, t.message);
+	return t.results;
+}, _ = async (e, t) => {
+	let n = await (await p()).packages.pick(e, t);
+	if ("error" in n) throw f(n.error, n.message);
+	return "declined" in n ? [] : n.results;
+}, v = async (e, t) => {
+	let n = await (await p()).packages.install(e, t);
+	if ("error" in n) throw f(n.error, n.message);
+	return "declined" in n ? null : n.installed;
+}, y = async () => (await (await p()).packages.list()).results, b = async (e) => {
+	let t = await (await p()).packages.uninstall(e);
+	if ("error" in t) throw f(t.error, t.message);
+}, x = ({ x: e, y: t, width: n, height: r }) => ({
+	x: Math.round(e),
+	y: Math.round(t),
+	width: Math.round(n),
+	height: Math.round(r)
+}), S = (e, t) => {
+	let n = Math.max(e.x, t.x), r = Math.max(e.y, t.y);
+	return {
+		x: n,
+		y: r,
+		width: Math.max(0, Math.min(e.x + e.width, t.x + t.width) - n),
+		height: Math.max(0, Math.min(e.y + e.height, t.y + t.height) - r)
+	};
+}, C = (e, t) => {
+	let n = t;
+	for (let t = e.parentElement; t; t = t.parentElement) {
+		let e = getComputedStyle(t);
+		if ((e.overflowX !== "visible" || e.overflowY !== "visible") && (n = S(n, x(t.getBoundingClientRect())), n.width === 0 || n.height === 0)) break;
+	}
+	return n;
+}, w = (e) => {
+	let t = getComputedStyle(e), n = [
+		t.borderTopLeftRadius,
+		t.borderTopRightRadius,
+		t.borderBottomRightRadius,
+		t.borderBottomLeftRadius
+	];
+	if (n.some((e) => e.includes("%") || e.includes(" "))) return;
+	let r = n.map((e) => {
+		let t = Number.parseFloat(e);
+		return Number.isFinite(t) && t > 0 ? t : 0;
+	});
+	return r.some((e) => e > 0) ? r : void 0;
+}, T = (e, t) => {
+	if (!e) return !1;
+	let n = (e, t) => e === t || !!e && !!t && e.x === t.x && e.y === t.y && e.width === t.width && e.height === t.height;
+	return n(e.rect, t.rect) && n(e.clip, t.clip) && ((e, t) => e === t || !!e && !!t && e.every((e, n) => e === t[n]))(e.radius, t.radius);
+}, E = /* @__PURE__ */ new Map();
+a("package view", () => E.size > 0);
+var D = async (e, t) => {
+	let n = E.get(e);
+	if (n) {
+		for (let e of n) t && e.element !== t || (e.stop(), n.delete(e));
+		if (n.size > 0) return;
+		E.delete(e);
+	}
+	let r = await (await p()).packages.hide(e);
+	if ("error" in r) throw f(r.error, r.message);
+}, O = async (e, t) => {
+	let { element: n, rect: r } = t;
+	if (!n && !r) throw f("invalid", "packages.show: pass an element or a rect");
+	let i = (await p()).packages, a = () => {
+		if (!n) return { rect: x(r) };
+		let e = x(n.getBoundingClientRect());
+		return {
+			rect: e,
+			clip: C(n, e),
+			radius: w(n)
+		};
+	}, o = !0, s, c = 0, l = async (t) => {
+		s = t;
+		let n = await i.show(e, t);
+		if ("error" in n) throw o = !1, f(n.error, n.message);
+	};
+	await l(a());
+	let u = () => {
+		if (!o) return;
+		let e = a();
+		T(s, e) || l(e).catch(() => {}), c = requestAnimationFrame(u);
+	};
+	n && (c = requestAnimationFrame(u));
+	let d = {
+		element: n,
+		stop: () => {
+			o = !1, cancelAnimationFrame(c);
+		}
+	}, m = E.get(e) ?? /* @__PURE__ */ new Set();
+	return m.add(d), E.set(e, m), {
+		hide: () => {
+			D(e, n).catch(() => {});
+		},
+		refresh: () => {
+			if (!o) return;
+			let e = a();
+			T(s, e) || l(e).catch(() => {});
+		}
+	};
+}, k = async (e, t = {}) => D(e, t.element), A = (async (e, n = {}) => {
+	let r = await (await p()).packages.connect(e, {
+		protocol: n.protocol,
+		...n.path === void 0 ? {} : { path: n.path }
+	});
+	if ("error" in r) throw f(r.error, r.message);
+	let a = o("package connection"), s = t()?.epoch ?? 0, c = i((e, t) => {
+		t !== s && (a(), c());
+	});
+	Promise.resolve(r.closed).then(() => {
+		a(), c();
+	}, () => {
+		a(), c();
+	});
+	let { port: l, closed: u } = r;
+	if (n.raw) return {
+		closed: u,
+		port: l
+	};
+	let d = await h(n.payload, l, {
+		signal: n.signal,
+		closed: u
+	});
+	return n.signal && n.signal.addEventListener("abort", () => {
+		try {
+			l.postMessage({ type: "fkn-packages-disconnect" });
+		} catch {}
+	}, { once: !0 }), {
+		remote: d,
+		closed: u,
+		port: l
+	};
+}), j = ["allow-scripts", "allow-same-origin"], M = (e) => {
+	let t = e.getAttribute("sandbox");
+	if (t !== null) {
+		let e = new Set(t.toLowerCase().split(/\s+/).filter(Boolean)), n = j.filter((t) => !e.has(t));
+		if (n.length) throw f("invalid", `packages.mount: the iframe's sandbox attribute must include ${n.join(" and ")}, or the package cannot start`);
+	}
+	if (globalThis.crossOriginIsolated && !new Set((e.getAttribute("allow") ?? "").toLowerCase().split(";").map((e) => e.trim().split(/\s+/)[0]).filter(Boolean)).has("cross-origin-isolated")) throw f("invalid", "packages.mount: this page is cross-origin isolated, so the iframe's allow attribute must include 'cross-origin-isolated' to hand that down to the package");
+}, N = 3e4, P = (e, t) => new Promise((n, r) => {
+	let i = (e) => {
+		clearTimeout(o), window.removeEventListener("message", a), e ? r(e) : n();
+	}, a = (n) => {
+		if (n.source !== e.contentWindow || n.origin !== t) return;
+		let r = n.data;
+		if (r?.type === "fkn-packages-ready") return i();
+		r?.type === "fkn-packages-failed" && i(f("unavailable", typeof r.message == "string" && r.message ? r.message : "packages.mount: the package failed to boot"));
+	}, o = setTimeout(() => i(f("timeout", "packages.mount: the package did not register a connection handler")), N);
+	window.addEventListener("message", a);
+}), F = async (e, t) => {
+	let { iframe: n } = t;
+	if (!(n instanceof HTMLIFrameElement)) throw f("invalid", "packages.mount: pass the iframe to load the package into");
+	if (!n.isConnected) throw f("invalid", "packages.mount: the iframe must be in the document before mounting into it");
+	M(n);
+	let r = await (await p()).packages.frame(e);
+	if ("error" in r) throw f(r.error, r.message);
+	n.src = r.url;
+	let i = { done: !1 }, a = () => {}, s = new Promise((e) => {
+		a = e;
+	}), c = o("mounted package"), l = () => {
+		if (!i.done) {
+			i.done = !0, c();
+			try {
+				n.contentWindow?.postMessage({ type: "fkn-packages-close" }, r.origin);
+			} catch {}
+			n.src = "about:blank", a();
+		}
+	};
+	try {
+		await P(n, r.origin);
+	} catch (e) {
+		throw l(), e;
+	}
+	let u = new MessageChannel(), d = n.contentWindow;
+	if (!d) throw l(), f("unavailable", "packages.mount: the frame was detached before it could connect");
+	d.postMessage({
+		type: "fkn-packages-port",
+		from: r.from,
+		protocol: t.protocol,
+		uri: r.uri,
+		name: r.name,
+		version: r.version
+	}, r.origin, [u.port2]);
+	try {
+		d.postMessage({
+			type: "fkn-packages-visibility",
+			visible: !0
+		}, r.origin);
+	} catch {}
+	if (t.raw) return {
+		closed: s,
+		port: u.port1,
+		frame: n,
+		unmount: l
+	};
+	try {
+		return {
+			remote: await h(t.payload, u.port1, {
+				signal: t.signal,
+				closed: s
+			}),
+			closed: s,
+			port: u.port1,
+			frame: n,
+			unmount: l
+		};
+	} catch (e) {
+		throw l(), e;
+	}
+}, I = (e, t, n) => h(t, e, { signal: n?.signal }), L = null, R = !1, z = /* @__PURE__ */ new Set(), B = [], V = /* @__PURE__ */ new Map(), H = !1, U = !1, W = (e) => {
+	let t = V.get(e);
+	t && (V.delete(e), t());
+}, G = (e, t) => {
+	try {
+		e.postMessage({
+			type: "fkn-packages-nack",
+			message: t
+		});
+	} catch {}
+	try {
+		e.close();
+	} catch {}
+}, K = async (e, t) => {
+	let { port: n, ...r } = e;
+	e.port.addEventListener("message", (t) => {
+		t.data?.type === "fkn-packages-disconnect" && W(e.port);
+	});
+	let i;
+	try {
+		i = await t.createPayload(r);
+	} catch (t) {
+		throw G(e.port, t instanceof Error ? t.message : "the package failed to produce a connection"), t;
+	}
+	let a = new Promise((t) => V.set(e.port, t)), o = await m(i, e.port);
+	t.handler?.({
+		...r,
+		remote: o,
+		closed: a,
+		port: e.port
+	});
+}, q = () => {
+	H || typeof window > "u" || window.parent === window || (H = !0, window.addEventListener("message", (e) => {
+		if (e.source !== window.parent) 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 : "",
+				brokered: e.origin === u,
+				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 : ""
+			};
+			L ? K(r, L).catch((e) => console.warn("packages.onConnect:", e)) : B.push(r);
+		}
+		if (t?.type === "fkn-packages-close") for (let e of [...V.keys()]) W(e);
+		if (t?.type === "fkn-packages-visibility") {
+			R = t.visible === !0;
+			for (let e of z) try {
+				e(R);
+			} catch {}
+		}
+	}));
+}, J = () => {
+	U || typeof window > "u" || window.parent === window || (U = !0, window.parent.postMessage({ type: "fkn-packages-ready" }, "*"));
+}, Y = (e, t) => {
+	if (typeof window > "u") return { unsubscribe: () => {} };
+	q();
+	let n = {
+		createPayload: e,
+		handler: t
+	};
+	for (L = n, J(); B.length && L === n;) K(B.shift(), n).catch((e) => console.warn("packages.onConnect:", e));
+	return { unsubscribe: () => {
+		L === n && (L = null);
+	} };
+}, X = () => R, Z = (e) => {
+	if (typeof window > "u") return { unsubscribe: () => {} };
+	q(), z.add(e);
+	try {
+		e(R);
+	} catch {}
+	return { unsubscribe: () => {
+		z.delete(e);
+	} };
+};
+export { X as a, Y as c, _ as d, g as f, v as i, Z as l, b as m, A as n, y as o, O as p, k as r, F as s, I as t, c as u };

package/packages-DT8vPB5_.cjs

@@ -0,0 +1 @@
+const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-DrvhPN56.cjs"),n=require("./busy-BXbVH595.cjs");let r=require("osra");var i=e.t({attach:()=>M,connect:()=>E,hide:()=>T,install:()=>m,isVisible:()=>K,list:()=>h,mount:()=>j,onConnect:()=>G,onVisibilityChange:()=>q,pick:()=>p,search:()=>f,show:()=>w,uninstall:()=>g}),a=`fkn-packages-connection`,o=`https://fkn.app`,s=3e4,c=(e,t)=>Object.assign(Error(t),{code:e}),l=async()=>{if(!t.l)throw c(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.o},u=(e,t,n)=>(0,r.expose)(e??{},{transport:t,key:a,unregisterSignal:n}),d=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw c(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let o=new AbortController,l=new Promise((e,n)=>{let a=setTimeout(()=>n(c(`timeout`,`packages.connect: the package did not complete the connection`)),s);o.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(c(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:o.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(c(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:o.signal}),i?.then(()=>n(c(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([u(e,t,a.signal),l])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{o.abort()}},f=async e=>{let t=await(await l()).packages.search(e);if(`error`in t)throw c(t.error,t.message);return t.results},p=async(e,t)=>{let n=await(await l()).packages.pick(e,t);if(`error`in n)throw c(n.error,n.message);return`declined`in n?[]:n.results},m=async(e,t)=>{let n=await(await l()).packages.install(e,t);if(`error`in n)throw c(n.error,n.message);return`declined`in n?null:n.installed},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)},_=({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=(e,t)=>{let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y);return{x:n,y:r,width:Math.max(0,Math.min(e.x+e.width,t.x+t.width)-n),height:Math.max(0,Math.min(e.y+e.height,t.y+t.height)-r)}},y=(e,t)=>{let n=t;for(let t=e.parentElement;t;t=t.parentElement){let e=getComputedStyle(t);if((e.overflowX!==`visible`||e.overflowY!==`visible`)&&(n=v(n,_(t.getBoundingClientRect())),n.width===0||n.height===0))break}return n},b=e=>{let t=getComputedStyle(e),n=[t.borderTopLeftRadius,t.borderTopRightRadius,t.borderBottomRightRadius,t.borderBottomLeftRadius];if(n.some(e=>e.includes(`%`)||e.includes(` `)))return;let r=n.map(e=>{let t=Number.parseFloat(e);return Number.isFinite(t)&&t>0?t:0});return r.some(e=>e>0)?r:void 0},x=(e,t)=>{if(!e)return!1;let n=(e,t)=>e===t||!!e&&!!t&&e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height;return n(e.rect,t.rect)&&n(e.clip,t.clip)&&((e,t)=>e===t||!!e&&!!t&&e.every((e,n)=>e===t[n]))(e.radius,t.radius)},S=new Map;n.i(`package view`,()=>S.size>0);var C=async(e,t)=>{let n=S.get(e);if(n){for(let e of n)t&&e.element!==t||(e.stop(),n.delete(e));if(n.size>0)return;S.delete(e)}let r=await(await l()).packages.hide(e);if(`error`in r)throw c(r.error,r.message)},w=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=()=>{if(!n)return{rect:_(r)};let e=_(n.getBoundingClientRect());return{rect:e,clip:y(n,e),radius:b(n)}},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();x(s,e)||d(e).catch(()=>{}),u=requestAnimationFrame(f)};n&&(u=requestAnimationFrame(f));let p={element:n,stop:()=>{o=!1,cancelAnimationFrame(u)}},m=S.get(e)??new Set;return m.add(p),S.set(e,m),{hide:()=>{C(e,n).catch(()=>{})},refresh:()=>{if(!o)return;let e=a();x(s,e)||d(e).catch(()=>{})}}},T=async(e,t={})=>C(e,t.element),E=(async(e,r={})=>{let i=await(await l()).packages.connect(e,{protocol:r.protocol,...r.path===void 0?{}:{path:r.path}});if(`error`in i)throw c(i.error,i.message);let a=n.t(`package connection`),o=t.c()?.epoch??0,s=t.u((e,t)=>{t!==o&&(a(),s())});Promise.resolve(i.closed).then(()=>{a(),s()},()=>{a(),s()});let{port:u,closed:f}=i;if(r.raw)return{closed:f,port:u};let p=await d(r.payload,u,{signal:r.signal,closed:f});return r.signal&&r.signal.addEventListener(`abort`,()=>{try{u.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:p,closed:f,port:u}}),D=[`allow-scripts`,`allow-same-origin`],O=e=>{let t=e.getAttribute(`sandbox`);if(t!==null){let e=new Set(t.toLowerCase().split(/\s+/).filter(Boolean)),n=D.filter(t=>!e.has(t));if(n.length)throw c(`invalid`,`packages.mount: the iframe's sandbox attribute must include ${n.join(` and `)}, or the package cannot start`)}if(globalThis.crossOriginIsolated&&!new Set((e.getAttribute(`allow`)??``).toLowerCase().split(`;`).map(e=>e.trim().split(/\s+/)[0]).filter(Boolean)).has(`cross-origin-isolated`))throw c(`invalid`,`packages.mount: this page is cross-origin isolated, so the iframe's allow attribute must include 'cross-origin-isolated' to hand that down to the package`)},k=3e4,A=(e,t)=>new Promise((n,r)=>{let i=e=>{clearTimeout(o),window.removeEventListener(`message`,a),e?r(e):n()},a=n=>{if(n.source!==e.contentWindow||n.origin!==t)return;let r=n.data;if(r?.type===`fkn-packages-ready`)return i();r?.type===`fkn-packages-failed`&&i(c(`unavailable`,typeof r.message==`string`&&r.message?r.message:`packages.mount: the package failed to boot`))},o=setTimeout(()=>i(c(`timeout`,`packages.mount: the package did not register a connection handler`)),k);window.addEventListener(`message`,a)}),j=async(e,t)=>{let{iframe:r}=t;if(!(r instanceof HTMLIFrameElement))throw c(`invalid`,`packages.mount: pass the iframe to load the package into`);if(!r.isConnected)throw c(`invalid`,`packages.mount: the iframe must be in the document before mounting into it`);O(r);let i=await(await l()).packages.frame(e);if(`error`in i)throw c(i.error,i.message);r.src=i.url;let a={done:!1},o=()=>{},s=new Promise(e=>{o=e}),u=n.t(`mounted package`),f=()=>{if(!a.done){a.done=!0,u();try{r.contentWindow?.postMessage({type:`fkn-packages-close`},i.origin)}catch{}r.src=`about:blank`,o()}};try{await A(r,i.origin)}catch(e){throw f(),e}let p=new MessageChannel,m=r.contentWindow;if(!m)throw f(),c(`unavailable`,`packages.mount: the frame was detached before it could connect`);m.postMessage({type:`fkn-packages-port`,from:i.from,protocol:t.protocol,uri:i.uri,name:i.name,version:i.version},i.origin,[p.port2]);try{m.postMessage({type:`fkn-packages-visibility`,visible:!0},i.origin)}catch{}if(t.raw)return{closed:s,port:p.port1,frame:r,unmount:f};try{return{remote:await d(t.payload,p.port1,{signal:t.signal,closed:s}),closed:s,port:p.port1,frame:r,unmount:f}}catch(e){throw f(),e}},M=(e,t,n)=>d(t,e,{signal:n?.signal}),N=null,P=!1,F=new Set,I=[],L=new Map,R=!1,z=!1,B=e=>{let t=L.get(e);t&&(L.delete(e),t())},V=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},H=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&B(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw V(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>L.set(e.port,t)),o=await u(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},U=()=>{R||typeof window>`u`||window.parent===window||(R=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent)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:``,brokered:e.origin===o,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:``};N?H(r,N).catch(e=>console.warn(`packages.onConnect:`,e)):I.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...L.keys()])B(e);if(t?.type===`fkn-packages-visibility`){P=t.visible===!0;for(let e of F)try{e(P)}catch{}}}))},W=()=>{z||typeof window>`u`||window.parent===window||(z=!0,window.parent.postMessage({type:`fkn-packages-ready`},`*`))},G=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};U();let n={createPayload:e,handler:t};for(N=n,W();I.length&&N===n;)H(I.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{N===n&&(N=null)}}},K=()=>P,q=e=>{if(typeof window>`u`)return{unsubscribe:()=>{}};U(),F.add(e);try{e(P)}catch{}return{unsubscribe:()=>{F.delete(e)}}};Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return K}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return G}}),Object.defineProperty(exports,"d",{enumerable:!0,get:function(){return p}}),Object.defineProperty(exports,"f",{enumerable:!0,get:function(){return f}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"l",{enumerable:!0,get:function(){return q}}),Object.defineProperty(exports,"m",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return E}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"p",{enumerable:!0,get:function(){return w}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return T}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return j}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return M}}),Object.defineProperty(exports,"u",{enumerable:!0,get:function(){return i}});

package/packages.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./rolldown-runtime-BIInC43l.cjs"),t=require("./api-CrUO33y-.cjs"),n=require("./busy-BXbVH595.cjs");let r=require("osra");var i=e.t({attach:()=>M,connect:()=>E,hide:()=>T,install:()=>m,isVisible:()=>K,list:()=>h,mount:()=>j,onConnect:()=>G,onVisibilityChange:()=>q,pick:()=>p,search:()=>f,show:()=>w,uninstall:()=>g}),a=`fkn-packages-connection`,o=`https://fkn.app`,s=3e4,c=(e,t)=>Object.assign(Error(t),{code:e}),l=async()=>{if(!t.l)throw c(`unavailable`,`packages: no FKN transport in this realm - use relayWorker to bridge workers`);return t.o},u=(e,t,n)=>(0,r.expose)(e??{},{transport:t,key:a,unregisterSignal:n}),d=async(e,t,n={})=>{let{signal:r,closed:i}=n;if(r?.aborted)throw c(`unavailable`,`packages.connect: aborted before connecting`);let a=new AbortController;r&&r.addEventListener(`abort`,()=>a.abort(r.reason),{once:!0});let o=new AbortController,l=new Promise((e,n)=>{let a=setTimeout(()=>n(c(`timeout`,`packages.connect: the package did not complete the connection`)),s);o.signal.addEventListener(`abort`,()=>clearTimeout(a),{once:!0}),t.addEventListener(`message`,e=>{if(e.data?.type===`fkn-packages-nack`){let t=e.data.message;n(c(`unavailable`,typeof t==`string`&&t?t:`packages.connect: the package refused the connection`))}},{signal:o.signal}),t.start(),r&&r.addEventListener(`abort`,()=>n(c(`unavailable`,`packages.connect: aborted before connecting`)),{once:!0,signal:o.signal}),i?.then(()=>n(c(`unavailable`,`packages.connect: the package closed before connecting`)))});try{return await Promise.race([u(e,t,a.signal),l])}catch(e){a.abort(e);try{t.close()}catch{}throw e}finally{o.abort()}},f=async e=>{let t=await(await l()).packages.search(e);if(`error`in t)throw c(t.error,t.message);return t.results},p=async(e,t)=>{let n=await(await l()).packages.pick(e,t);if(`error`in n)throw c(n.error,n.message);return`declined`in n?[]:n.results},m=async(e,t)=>{let n=await(await l()).packages.install(e,t);if(`error`in n)throw c(n.error,n.message);return`declined`in n?null:n.installed},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)},_=({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=(e,t)=>{let n=Math.max(e.x,t.x),r=Math.max(e.y,t.y);return{x:n,y:r,width:Math.max(0,Math.min(e.x+e.width,t.x+t.width)-n),height:Math.max(0,Math.min(e.y+e.height,t.y+t.height)-r)}},y=(e,t)=>{let n=t;for(let t=e.parentElement;t;t=t.parentElement){let e=getComputedStyle(t);if((e.overflowX!==`visible`||e.overflowY!==`visible`)&&(n=v(n,_(t.getBoundingClientRect())),n.width===0||n.height===0))break}return n},b=e=>{let t=getComputedStyle(e),n=[t.borderTopLeftRadius,t.borderTopRightRadius,t.borderBottomRightRadius,t.borderBottomLeftRadius];if(n.some(e=>e.includes(`%`)||e.includes(` `)))return;let r=n.map(e=>{let t=Number.parseFloat(e);return Number.isFinite(t)&&t>0?t:0});return r.some(e=>e>0)?r:void 0},x=(e,t)=>{if(!e)return!1;let n=(e,t)=>e===t||!!e&&!!t&&e.x===t.x&&e.y===t.y&&e.width===t.width&&e.height===t.height;return n(e.rect,t.rect)&&n(e.clip,t.clip)&&((e,t)=>e===t||!!e&&!!t&&e.every((e,n)=>e===t[n]))(e.radius,t.radius)},S=new Map;n.i(`package view`,()=>S.size>0);var C=async(e,t)=>{let n=S.get(e);if(n){for(let e of n)t&&e.element!==t||(e.stop(),n.delete(e));if(n.size>0)return;S.delete(e)}let r=await(await l()).packages.hide(e);if(`error`in r)throw c(r.error,r.message)},w=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=()=>{if(!n)return{rect:_(r)};let e=_(n.getBoundingClientRect());return{rect:e,clip:y(n,e),radius:b(n)}},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();x(s,e)||d(e).catch(()=>{}),u=requestAnimationFrame(f)};n&&(u=requestAnimationFrame(f));let p={element:n,stop:()=>{o=!1,cancelAnimationFrame(u)}},m=S.get(e)??new Set;return m.add(p),S.set(e,m),{hide:()=>{C(e,n).catch(()=>{})},refresh:()=>{if(!o)return;let e=a();x(s,e)||d(e).catch(()=>{})}}},T=async(e,t={})=>C(e,t.element),E=(async(e,r={})=>{let i=await(await l()).packages.connect(e,{protocol:r.protocol,...r.path===void 0?{}:{path:r.path}});if(`error`in i)throw c(i.error,i.message);let a=n.t(`package connection`),o=t.c()?.epoch??0,s=t.u((e,t)=>{t!==o&&(a(),s())});Promise.resolve(i.closed).then(()=>{a(),s()},()=>{a(),s()});let{port:u,closed:f}=i;if(r.raw)return{closed:f,port:u};let p=await d(r.payload,u,{signal:r.signal,closed:f});return r.signal&&r.signal.addEventListener(`abort`,()=>{try{u.postMessage({type:`fkn-packages-disconnect`})}catch{}},{once:!0}),{remote:p,closed:f,port:u}}),D=[`allow-scripts`,`allow-same-origin`],O=e=>{let t=e.getAttribute(`sandbox`);if(t!==null){let e=new Set(t.toLowerCase().split(/\s+/).filter(Boolean)),n=D.filter(t=>!e.has(t));if(n.length)throw c(`invalid`,`packages.mount: the iframe's sandbox attribute must include ${n.join(` and `)}, or the package cannot start`)}if(globalThis.crossOriginIsolated&&!new Set((e.getAttribute(`allow`)??``).toLowerCase().split(`;`).map(e=>e.trim().split(/\s+/)[0]).filter(Boolean)).has(`cross-origin-isolated`))throw c(`invalid`,`packages.mount: this page is cross-origin isolated, so the iframe's allow attribute must include 'cross-origin-isolated' to hand that down to the package`)},k=3e4,A=(e,t)=>new Promise((n,r)=>{let i=e=>{clearTimeout(o),window.removeEventListener(`message`,a),e?r(e):n()},a=n=>{if(n.source!==e.contentWindow||n.origin!==t)return;let r=n.data;if(r?.type===`fkn-packages-ready`)return i();r?.type===`fkn-packages-failed`&&i(c(`unavailable`,typeof r.message==`string`&&r.message?r.message:`packages.mount: the package failed to boot`))},o=setTimeout(()=>i(c(`timeout`,`packages.mount: the package did not register a connection handler`)),k);window.addEventListener(`message`,a)}),j=async(e,t)=>{let{iframe:r}=t;if(!(r instanceof HTMLIFrameElement))throw c(`invalid`,`packages.mount: pass the iframe to load the package into`);if(!r.isConnected)throw c(`invalid`,`packages.mount: the iframe must be in the document before mounting into it`);O(r);let i=await(await l()).packages.frame(e);if(`error`in i)throw c(i.error,i.message);r.src=i.url;let a={done:!1},o=()=>{},s=new Promise(e=>{o=e}),u=n.t(`mounted package`),f=()=>{if(!a.done){a.done=!0,u();try{r.contentWindow?.postMessage({type:`fkn-packages-close`},i.origin)}catch{}r.src=`about:blank`,o()}};try{await A(r,i.origin)}catch(e){throw f(),e}let p=new MessageChannel,m=r.contentWindow;if(!m)throw f(),c(`unavailable`,`packages.mount: the frame was detached before it could connect`);m.postMessage({type:`fkn-packages-port`,from:i.from,protocol:t.protocol,uri:i.uri,name:i.name,version:i.version},i.origin,[p.port2]);try{m.postMessage({type:`fkn-packages-visibility`,visible:!0},i.origin)}catch{}if(t.raw)return{closed:s,port:p.port1,frame:r,unmount:f};try{return{remote:await d(t.payload,p.port1,{signal:t.signal,closed:s}),closed:s,port:p.port1,frame:r,unmount:f}}catch(e){throw f(),e}},M=(e,t,n)=>d(t,e,{signal:n?.signal}),N=null,P=!1,F=new Set,I=[],L=new Map,R=!1,z=!1,B=e=>{let t=L.get(e);t&&(L.delete(e),t())},V=(e,t)=>{try{e.postMessage({type:`fkn-packages-nack`,message:t})}catch{}try{e.close()}catch{}},H=async(e,t)=>{let{port:n,...r}=e;e.port.addEventListener(`message`,t=>{t.data?.type===`fkn-packages-disconnect`&&B(e.port)});let i;try{i=await t.createPayload(r)}catch(t){throw V(e.port,t instanceof Error?t.message:`the package failed to produce a connection`),t}let a=new Promise(t=>L.set(e.port,t)),o=await u(i,e.port);t.handler?.({...r,remote:o,closed:a,port:e.port})},U=()=>{R||typeof window>`u`||window.parent===window||(R=!0,window.addEventListener(`message`,e=>{if(e.source!==window.parent)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:``,brokered:e.origin===o,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:``};N?H(r,N).catch(e=>console.warn(`packages.onConnect:`,e)):I.push(r)}if(t?.type===`fkn-packages-close`)for(let e of[...L.keys()])B(e);if(t?.type===`fkn-packages-visibility`){P=t.visible===!0;for(let e of F)try{e(P)}catch{}}}))},W=()=>{z||typeof window>`u`||window.parent===window||(z=!0,window.parent.postMessage({type:`fkn-packages-ready`},`*`))},G=(e,t)=>{if(typeof window>`u`)return{unsubscribe:()=>{}};U();let n={createPayload:e,handler:t};for(N=n,W();I.length&&N===n;)H(I.shift(),n).catch(e=>console.warn(`packages.onConnect:`,e));return{unsubscribe:()=>{N===n&&(N=null)}}},K=()=>P,q=e=>{if(typeof window>`u`)return{unsubscribe:()=>{}};U(),F.add(e);try{e(P)}catch{}return{unsubscribe:()=>{F.delete(e)}}};exports.attach=M,exports.connect=E,exports.hide=T,exports.install=m,exports.isVisible=K,exports.list=h,exports.mount=j,exports.onConnect=G,exports.onVisibilityChange=q,exports.pick=p,exports.search=f,exports.show=w,Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return i}}),exports.uninstall=g;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./packages-DT8vPB5_.cjs");exports.attach=e.t,exports.connect=e.n,exports.hide=e.r,exports.install=e.i,exports.isVisible=e.a,exports.list=e.o,exports.mount=e.s,exports.onConnect=e.c,exports.onVisibilityChange=e.l,exports.pick=e.d,exports.search=e.f,exports.show=e.p,exports.uninstall=e.m;