@fkn/lib 0.9.64 → 0.9.65

package/packages.d.ts

@@ -1,156 +1,3 @@
-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-BGMJVvTg.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 };
-}
-export type PackagesError = Error & {
-  code: PackagesErrorCode;
-};
-/** Search npm for FKN packages, e.g. `search({ type: 'plugin', id: 'stub' })`. */
-export declare const search: (query: PackageQuery) => Promise<PackageResult[]>;
-/** FKN-rendered picker over the same search; resolves the user's selection, already installed. [] on cancel. */
-export 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. */
-export declare const install: (uri: string, options?: InstallOptions) => Promise<InstalledPackage | null>;
-/** The packages installed by this app. */
-export declare const list: () => Promise<InstalledPackage[]>;
-/** Uninstall a package from this app; its frames and connections are torn down. */
-export declare const uninstall: (uri: string) => Promise<void>;
-export 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;
-};
-export 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.
- */
-export 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.
- */
-export declare const hide: (uri: string, options?: ShowOptions) => Promise<void>;
-export 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;
-};
-export 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;
-};
-export type RawPackageConnection = Omit<PackageConnection<never>, 'remote'>;
-export 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. */
-export declare const connect: Connect;
-export 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;
-};
-export 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`.
- */
-export 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. */
-export declare const attach: <T = unknown>(port: MessagePort, payload?: unknown, options?: {
-  signal?: AbortSignal;
-}) => Promise<Remote<T>>;
-export 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;
-};
-export type IncomingConnection<T = unknown> = IncomingConnectionInfo & PackageConnection<T>;
-/** produces the payload exposed to a connecting app - called once per incoming connection */
-export 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.
- */
-export 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. */
-export 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.
- */
-export declare const onVisibilityChange: (handler: (visible: boolean) => void) => {
-  unsubscribe: () => void;
-};
-//#endregion
-export { type ConnectOptions, type InstallOptions, type InstalledPackage, type PackageQuery, type PackageResult, type PackagesErrorCode, type PickOptions, type Placement, type Radii, type SurfaceRect, packages_d_exports as t };
+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 { C as pick, E as uninstall, T as show, _ as isVisible, a as IncomingConnectionInfo, b as onConnect, c as PackageConnection, d as RawPackageConnection, f as ShowOptions, g as install, h as hide, i as IncomingConnection, l as PackageView, m as connect, n as Connect, o as MountOptions, p as attach, r as ConnectPayload, s as MountedPackage, t as AppConnectOptions, u as PackagesError, v as list, w as search, x as onVisibilityChange, y as mount } from "./packages-BEadIy_h.js";
+export { AppConnectOptions, Connect, type ConnectOptions, ConnectPayload, IncomingConnection, IncomingConnectionInfo, type InstallOptions, type InstalledPackage, MountOptions, MountedPackage, PackageConnection, type PackageQuery, type PackageResult, PackageView, PackagesError, type PackagesErrorCode, type PickOptions, type Placement, type Radii, RawPackageConnection, ShowOptions, type SurfaceRect, attach, connect, hide, install, isVisible, list, mount, onConnect, onVisibilityChange, pick, search, show, uninstall };

package/packages.js

@@ -1,347 +1 @@
-import { t as e } from "./rolldown-runtime-Dy4uBu1J.js";
-import { c as t, l as n, o as r, u as i } from "./api-BvJu2X1L.js";
-import { i as a, t as o } from "./busy-DsMWrSzc.js";
-import { expose as s } from "osra";
-//#region 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);
-	} };
-};
-//#endregion
-export { I as attach, A as connect, k as hide, v as install, X as isVisible, y as list, F as mount, Y as onConnect, Z as onVisibilityChange, _ as pick, g as search, O as show, c as t, b as uninstall };
+export { t as attach, n as connect, r as hide, i as install, a as isVisible, o as list, s as mount, c as onConnect, l as onVisibilityChange, d as pick, f as search, p as show, m as uninstall } from "./packages-Cws_rcgf.js";

package/{proxy-C4sYkxB5.js → proxy-BBAQxJmP.js}

@@ -1,8 +1,8 @@
-import { r as e } from "./broker-frame-B31OXcnH.js";
-import { o as t, s as n } from "./api-BvJu2X1L.js";
-import { t as r } from "./busy-DsMWrSzc.js";
-import { t as i } from "./relay-choice-BGwXRC5d.js";
-//#region src/proxy.ts
+import { r as e } from "./broker-frame-vjSpBa8d.js";
+import { o as t, s as n } from "./api-DRglK7ft.js";
+import { t as r } from "./busy-C1JPjoZ_.js";
+import { t as i } from "./relay-choice-Bb3oP2gw.js";
+// src/proxy.ts
 var a = typeof FinalizationRegistry > "u" ? void 0 : new FinalizationRegistry((e) => e()), o = (e) => {
 	let t = e.body;
 	if (!t) return e;
@@ -58,5 +58,4 @@ var a = typeof FinalizationRegistry > "u" ? void 0 : new FinalizationRegistry((e
 		body: i
 	});
 };
-//#endregion
 export { u as t };

package/{proxy-Dz60YyYy.d.ts → proxy-BP40IXYD.d.ts}

@@ -1,8 +1,6 @@
-import { X as Resolvers } from "./contract-BGMJVvTg.js";
-import "./api-xh6lzApn.js";
-//#region src/proxy.d.ts
+import { X as Resolvers } from "./contract-0rua6Wsh.js";
+import "./api-0Yp9uZcV.js";
 type ProxyFetch = Resolvers['cloud']['fetch'];
 type FetchParameters = Parameters<ProxyFetch>;
 declare const cloudFetch: (input: FetchParameters[0], init?: FetchParameters[1]) => Promise<Response>;
-//#endregion
 export { cloudFetch as t };

package/{proxy-jdE5tCwz.cjs → proxy-DVgGp6A8.cjs}

@@ -1 +1 @@
-const e=require("./broker-frame-CF4-yXtj.cjs"),t=require("./api-CrUO33y-.cjs"),n=require("./busy-BXbVH595.cjs"),r=require("./relay-choice-JC_JJY_M.cjs");var i=typeof FinalizationRegistry>`u`?void 0:new FinalizationRegistry(e=>e()),a=e=>{let t=e.body;if(!t)return e;let r=n.t(`streamed response`),a=t.getReader(),o=new ReadableStream({pull:async e=>{try{let{done:t,value:n}=await a.read();if(t){r(),e.close();return}e.enqueue(n)}catch(t){r(),e.error(t)}},cancel:async e=>{r(),await a.cancel(e).catch(()=>{})}}),s=new Response(o,{status:e.status,statusText:e.statusText,headers:e.headers});return i?.register(s,r),s},o=async e=>{if(e!=null)return typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)?e:new Request(`https://body.invalid/`,{method:`POST`,body:e,duplex:`half`}).arrayBuffer()},s=async e=>{if(e.method===`GET`||e.method===`HEAD`)return;let t=await e.clone().arrayBuffer();return t.byteLength?t:void 0},c=(e,n)=>(n?.relay===void 0?t.o:t.s(`a relay choice`)).then(t=>(n?.relay!==void 0&&r.t(t,`cloud.fetch`),t.cloud.fetch(e,n))).then(a),l=async(t,n)=>{if(e.r(t),typeof t==`object`&&t&&!(t instanceof URL)&&typeof t.url==`string`){let e=t,r={};e.headers.forEach((e,t)=>{r[t]=e});let i=await o(n?.body===void 0?await s(e):n.body);return c(e.url,{...n,method:n?.method??e.method,headers:n?.headers??r,body:i})}let r=t instanceof URL?t.href:t,i=await o(n?.body);return c(r,n?.body===void 0?n:{...n,body:i})};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});
+const e=require("./broker-frame-CF4-yXtj.cjs"),t=require("./api-DrvhPN56.cjs"),n=require("./busy-BXbVH595.cjs"),r=require("./relay-choice-JC_JJY_M.cjs");var i=typeof FinalizationRegistry>`u`?void 0:new FinalizationRegistry(e=>e()),a=e=>{let t=e.body;if(!t)return e;let r=n.t(`streamed response`),a=t.getReader(),o=new ReadableStream({pull:async e=>{try{let{done:t,value:n}=await a.read();if(t){r(),e.close();return}e.enqueue(n)}catch(t){r(),e.error(t)}},cancel:async e=>{r(),await a.cancel(e).catch(()=>{})}}),s=new Response(o,{status:e.status,statusText:e.statusText,headers:e.headers});return i?.register(s,r),s},o=async e=>{if(e!=null)return typeof e==`string`||e instanceof ArrayBuffer||ArrayBuffer.isView(e)?e:new Request(`https://body.invalid/`,{method:`POST`,body:e,duplex:`half`}).arrayBuffer()},s=async e=>{if(e.method===`GET`||e.method===`HEAD`)return;let t=await e.clone().arrayBuffer();return t.byteLength?t:void 0},c=(e,n)=>(n?.relay===void 0?t.o:t.s(`a relay choice`)).then(t=>(n?.relay!==void 0&&r.t(t,`cloud.fetch`),t.cloud.fetch(e,n))).then(a),l=async(t,n)=>{if(e.r(t),typeof t==`object`&&t&&!(t instanceof URL)&&typeof t.url==`string`){let e=t,r={};e.headers.forEach((e,t)=>{r[t]=e});let i=await o(n?.body===void 0?await s(e):n.body);return c(e.url,{...n,method:n?.method??e.method,headers:n?.headers??r,body:i})}let r=t instanceof URL?t.href:t,i=await o(n?.body);return c(r,n?.body===void 0?n:{...n,body:i})};Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return l}});

package/react.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./connect-button-BpXDs7tw.cjs");let t=require("react");var n=({className:n,style:r}={})=>(0,t.createElement)(`iframe`,{src:e.t(),title:`Sign in to FKN`,className:n,style:{border:`none`,width:150,height:40,background:`transparent`,colorScheme:`normal`,...r}});exports.ConnectButton=n,exports.connectButtonUrl=e.t;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("./connect-button-BpXDs7tw.cjs");let t=require("react");var n=6,r=8,i=(e,t,n)=>r=>`var(--fkn-powered-by-${e}, ${r?`light-dark(${t}, ${n})`:n})`,a=i(`card`,`#ffffff`,`#1d1e23`),o=i(`border`,`#e5e6ea`,`#2a2c33`),s=i(`ink`,`#191b1f`,`#ecedf0`),c=i(`link`,`#3a629e`,`#8db0de`),l=i(`shadow`,`rgba(16, 18, 22, .05)`,`rgba(0, 0, 0, .4)`),u=[[`M198.4,0.1L365,288.6H162.3l-31.8,55l331.4-0.2L263.6,0L198.4,0.1z`,i(`mark-app`,`#8f5a0e`,`#f9aa40`)],[`M198.3,0L0,343.6l32.6,56.5l165.1-285.9l100.7,174.4h66.5L198.3,0z`,i(`mark-plat`,`#3a629e`,`#4572b5`)],[`M197.7,114.2l32.6,56.5l-99.8,172.9h331.4l-32.6,56.5H32.6L197.7,114.2z`,i(`mark-acct`,`#2a7c58`,`#51bb8d`)]],d=`http://www.w3.org/2000/svg`,f=0,p=({label:e=`Powered by FKN`,linkLabel:t=`How it works`,href:i=`https://docs.fkn.dev/`}={})=>{let p=`fkn-powered-by-${++f}`,m=document.createElement(`span`),h=document.createElement(`button`);h.type=`button`,h.title=e,h.setAttribute(`aria-label`,e),h.setAttribute(`aria-expanded`,`false`),h.setAttribute(`aria-controls`,p),h.style.cssText=`padding:4px;margin:-4px;border:none;border-radius:4px;background:none;font:inherit;color:inherit;cursor:pointer`;let g=CSS.supports(`color`,`light-dark(red, red)`),_=document.createElementNS(d,`svg`);_.setAttribute(`viewBox`,`0 0 461.9 400.1`),_.setAttribute(`aria-hidden`,`true`),_.style.cssText=`height:${CSS.supports(`height`,`1cap`)?`1cap`:`.7em`};width:auto`;for(let[e,t]of u){let n=document.createElementNS(d,`path`);n.setAttribute(`d`,e),n.style.fill=t(g),_.append(n)}h.append(_);let v=document.createElement(`div`);v.id=p,v.popover=`manual`,v.setAttribute(`role`,`group`),v.setAttribute(`aria-labelledby`,`${p}-title`),v.tabIndex=-1,v.style.cssText=`inset:auto;margin:0;padding:${n}px 0 0;border:none;background:transparent;overflow:visible;width:max-content;max-width:min(280px, calc(100vw - 16px));outline:none;cursor:default;user-select:text`;let y=document.createElement(`div`);y.style.cssText=`display:flex;flex-direction:column;gap:8px;box-sizing:border-box;overflow-y:auto;overflow-wrap:anywhere;padding:12px 14px;font-size:13px;font-weight:400;font-style:normal;line-height:1.4;letter-spacing:normal;text-transform:none;text-shadow:none;text-align:start;white-space:normal;color:${s(g)};background:${a(g)};border:1px solid ${o(g)};border-radius:10px;box-shadow:0 1px 2px ${l(g)}`;let b=document.createElement(`div`);b.id=`${p}-title`,b.textContent=e,b.style.fontWeight=`600`;let x=document.createElement(`a`);x.href=i,x.target=`_blank`,x.rel=`noreferrer`,x.textContent=t,x.style.cssText=`align-self:flex-start;color:${c(g)};font-weight:600;text-decoration:underline;text-underline-offset:2px;border-radius:4px`,y.append(b,x),v.append(y),m.append(h,v);let S=new Set,C,w,T=()=>{let e=h.getBoundingClientRect(),{width:t}=v.getBoundingClientRect(),i=document.documentElement.clientWidth;v.style.left=`${Math.min(Math.max(r,e.left+e.width/2-t/2),i-t-r)}px`,v.style.top=`${e.bottom}px`,y.style.maxHeight=`${Math.max(0,innerHeight-e.bottom-n-r)}px`},E=()=>{m.isConnected||S.clear();let e=S.size>0;if(e===(w!==void 0))return;if(h.setAttribute(`aria-expanded`,String(e)),!e){w.abort(),w=void 0,v.matches(`:popover-open`)&&v.hidePopover();return}v.showPopover(),T(),w=new AbortController;let{signal:t}=w;document.addEventListener(`keydown`,A,{signal:t}),document.addEventListener(`pointerdown`,e=>{e.composedPath().includes(m)||k()},{capture:!0,signal:t}),window.addEventListener(`blur`,()=>k(),{signal:t}),window.addEventListener(`scroll`,T,{capture:!0,passive:!0,signal:t}),window.addEventListener(`resize`,T,{signal:t})},D=()=>{clearTimeout(C),C=void 0},O=!1,k=(e=!1)=>{D(),S.clear(),E(),e&&(O=!0,h.focus(),O=!1)},A=e=>{if(e.key!==`Escape`)return;let t=m.contains(document.activeElement);t&&(e.preventDefault(),e.stopPropagation()),k(t)},j=e=>e.pointerType===`mouse`||e.pointerType===`pen`;return m.addEventListener(`pointerenter`,e=>{j(e)&&(D(),S.add(`hover`),E())}),m.addEventListener(`pointerleave`,e=>{j(e)&&S.has(`hover`)&&(D(),C=setTimeout(()=>{C=void 0,S.delete(`hover`),E()},300))}),h.addEventListener(`click`,()=>{if(S.has(`pinned`))return k();S.add(`pinned`),E()}),h.addEventListener(`focusin`,()=>{!O&&h.matches(`:focus-visible`)&&(S.add(`focus`),E())}),m.addEventListener(`focusout`,()=>setTimeout(()=>{m.contains(document.activeElement)||(S.delete(`focus`),S.delete(`pinned`),E())},0)),{element:m,destroy:()=>{k(),m.remove()}}},m=({className:n,style:r}={})=>(0,t.createElement)(`iframe`,{src:e.t(),title:`Sign in to FKN`,className:n,style:{border:`none`,width:150,height:40,background:`transparent`,colorScheme:`normal`,...r}}),h=({className:e,style:n,label:r,linkLabel:i,href:a})=>{let o=(0,t.useRef)(null);return(0,t.useEffect)(()=>{let e=p({label:r,linkLabel:i,href:a});return o.current.append(e.element),e.destroy},[r,i,a]),(0,t.createElement)(`span`,{ref:o,className:e,style:n})};exports.ConnectButton=m,exports.PoweredByFkn=h,exports.connectButtonUrl=e.t;

package/react.d.ts

@@ -1,10 +1,22 @@
-import { t as connectButtonUrl } from "./connect-button-Cp0NS95-.js";
+import { t as connectButtonUrl } from "./connect-button-2FmOM8ai.js";
 import { CSSProperties, ReactElement } from "react";
-//#region src/react.d.ts
+type PoweredByOptions = {
+  /** The mark's accessible name and tooltip, and the popup's heading. Defaults to "Powered by FKN". */
+  label?: string;
+  /** The words of the popup's one link. Defaults to "How it works", as on fkn.app's "through FKN" popup. */
+  linkLabel?: string;
+  /** Where that link leads, in a new tab. Defaults to FKN's documentation, https://docs.fkn.dev/. */
+  href?: string;
+};
 export type ConnectButtonProps = {
   className?: string;
   style?: CSSProperties;
 };
 export declare const ConnectButton: ({ className, style }?: ConnectButtonProps) => ReactElement;
-//#endregion
-export { connectButtonUrl };
+export type PoweredByFknProps = PoweredByOptions & {
+  className?: string;
+  style?: CSSProperties;
+};
+/** FKN's mark and its popup, in a span that takes `className` and `style` (its font size sizes the mark). */
+export declare const PoweredByFkn: ({ className, style, label, linkLabel, href }: PoweredByFknProps) => ReactElement;
+export { type PoweredByOptions, connectButtonUrl };