@exponential_app/eui 0.0.0-stage → 0.2.0

package/dist/types/src/web/urls.d.ts

@@ -0,0 +1,21 @@
+import { type MediaRequest, type UrlPolicy } from "@exponential_app/eui";
+import type { AnyHostPlugin as HostPlugin } from "./host-types.js";
+/** VAPP-107: the page's OWN host when it is private (a dev server on
+ *  localhost): the renderer opts it in on top of the host's `allowPrivate`,
+ *  exactly as the Exponential app's hosts opt their own origin in. The page
+ *  already runs there; nothing else private is reached. */
+export declare function ownPrivateHosts(): string[];
+/** The URL policy a plugin's hrefs pass. */
+export declare function urlPolicyOf(host: HostPlugin): UrlPolicy;
+/** The href a link may navigate to, or undefined (paint it as text). */
+export declare function linkHref(host: HostPlugin, href: unknown): string | undefined;
+/** The media request for a src (`resolveUrl` rewrites first; the host's
+ *  `mediaRequest` or the plugin's `media` options build it), re-checked
+ *  against the media schemes/hosts so a host hook cannot widen them. Null =
+ *  nothing loads. */
+export declare function mediaRequestOf(host: HostPlugin, src: unknown): MediaRequest | null;
+/** Does an absolute media url pass the media schemes, hosts and private
+ *  opt-ins (VAPP-107; the page's own private host counts as opted in)? */
+export declare function mediaUrlAllowed(host: HostPlugin, url: string): boolean;
+/** The default opener: only what the policy allows, in a new tab. */
+export declare function openAllowed(host: HostPlugin, url: string): void;