@addonova/browser 0.1.0 → 0.2.0

package/dist/content/context.js

@@ -0,0 +1,157 @@
+import { BrowserApiError } from '../shared/errors.js';
+export function createContentScriptContext(options = {}) {
+    const validateRuntime = options.validateRuntime ?? true;
+    const runtime = options.runtime ?? getGlobalRuntime();
+    const controller = new AbortController();
+    const timers = new Set();
+    const intervals = new Set();
+    const animationFrames = new Set();
+    const listeners = new Map();
+    const invalidationCallbacks = new Set();
+    const isValid = () => {
+        if (controller.signal.aborted) {
+            return false;
+        }
+        if (!validateRuntime) {
+            return true;
+        }
+        try {
+            return runtime?.id !== undefined && runtime.id !== '';
+        }
+        catch {
+            return false;
+        }
+    };
+    const context = {
+        get isValid() {
+            return isValid();
+        },
+        signal: controller.signal,
+        setTimeout(callback, timeout = 0, ...args) {
+            const timer = globalThis.setTimeout(() => {
+                timers.delete(timer);
+                if (!controller.signal.aborted) {
+                    callback(...args);
+                }
+            }, timeout);
+            timers.add(timer);
+            return timer;
+        },
+        clearTimeout(timer) {
+            timers.delete(timer);
+            globalThis.clearTimeout(timer);
+        },
+        setInterval(callback, timeout = 0, ...args) {
+            const timer = globalThis.setInterval(() => {
+                if (!controller.signal.aborted) {
+                    callback(...args);
+                }
+            }, timeout);
+            intervals.add(timer);
+            return timer;
+        },
+        clearInterval(timer) {
+            intervals.delete(timer);
+            globalThis.clearInterval(timer);
+        },
+        requestAnimationFrame(callback) {
+            if (typeof globalThis.requestAnimationFrame !== 'function') {
+                throw new BrowserApiError('BROWSER_UNSUPPORTED_API', 'requestAnimationFrame is not available in this environment.');
+            }
+            const id = globalThis.requestAnimationFrame((time) => {
+                animationFrames.delete(id);
+                if (!controller.signal.aborted) {
+                    callback(time);
+                }
+            });
+            animationFrames.add(id);
+            return id;
+        },
+        cancelAnimationFrame(id) {
+            animationFrames.delete(id);
+            globalThis.cancelAnimationFrame?.(id);
+        },
+        addEventListener(targetOrType, typeOrListener, listenerOrOptions, maybeOptions) {
+            const hasTarget = typeof targetOrType !== 'string';
+            const target = hasTarget
+                ? targetOrType
+                : getDefaultEventTarget();
+            const type = hasTarget ? typeOrListener : targetOrType;
+            const listener = hasTarget
+                ? listenerOrOptions
+                : typeOrListener;
+            const options = hasTarget
+                ? maybeOptions
+                : listenerOrOptions;
+            if (target === undefined) {
+                throw new BrowserApiError('BROWSER_UNSUPPORTED_ENVIRONMENT', 'No event target is available for the content script context.');
+            }
+            target.addEventListener(type, listener, options);
+            const remove = () => {
+                target.removeEventListener(type, listener, options);
+                listeners.delete(remove);
+            };
+            listeners.set(remove, {
+                target,
+                type,
+                listener,
+                ...(options === undefined ? {} : { options }),
+            });
+            return remove;
+        },
+        onInvalidated(callback) {
+            if (controller.signal.aborted) {
+                callback();
+                return () => { };
+            }
+            invalidationCallbacks.add(callback);
+            return () => invalidationCallbacks.delete(callback);
+        },
+        invalidate() {
+            if (controller.signal.aborted) {
+                return;
+            }
+            controller.abort();
+            for (const timer of timers) {
+                globalThis.clearTimeout(timer);
+            }
+            timers.clear();
+            for (const timer of intervals) {
+                globalThis.clearInterval(timer);
+            }
+            intervals.clear();
+            for (const id of animationFrames) {
+                globalThis.cancelAnimationFrame?.(id);
+            }
+            animationFrames.clear();
+            for (const remove of [...listeners.keys()]) {
+                remove();
+            }
+            listeners.clear();
+            for (const callback of [...invalidationCallbacks]) {
+                callback();
+            }
+            invalidationCallbacks.clear();
+        },
+    };
+    if (typeof window !== 'undefined') {
+        context.addEventListener(window, 'pagehide', () => context.invalidate(), {
+            once: true,
+        });
+    }
+    return context;
+}
+function getGlobalRuntime() {
+    const global = globalThis;
+    return global.browser?.runtime ?? global.chrome?.runtime;
+}
+function getDefaultEventTarget() {
+    if (typeof window !== 'undefined') {
+        return window;
+    }
+    if (typeof document !== 'undefined') {
+        return document;
+    }
+    return undefined;
+}
+//# sourceMappingURL=context.js.map

package/dist/content/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/content/context.ts"],"names":[],"mappings":"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"}

package/dist/content/index.d.ts

@@ -0,0 +1,7 @@
+export { createContentScriptContext, } from './context.ts';
+export type { ContentScriptContext, ContentScriptContextOptions, ContentScriptRuntime, ContentScriptTimer, } from './context.ts';
+export { createInjectScript } from './inject-script.ts';
+export type { InjectScript, InjectScriptApis, InjectScriptOptions, } from './inject-script.ts';
+export { createIframeUi, createIntegratedUi, createShadowRootUi, } from './ui.ts';
+export type { AutoMountOptions, BaseUiOptions, ContentScriptUi, IframeUiOptions, IntegratedUiOptions, ShadowRootContentScriptUi, ShadowRootUiOptions, UiAlignment, UiAnchor, UiAppendMode, UiPosition, } from './ui.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/content/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,eAAe,EACf,mBAAmB,EACnB,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,UAAU,GACX,MAAM,SAAS,CAAC"}

package/dist/content/index.js

@@ -0,0 +1,4 @@
+export { createContentScriptContext, } from './context.js';
+export { createInjectScript } from './inject-script.js';
+export { createIframeUi, createIntegratedUi, createShadowRootUi, } from './ui.js';
+//# sourceMappingURL=index.js.map

package/dist/content/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,GAC3B,MAAM,cAAc,CAAC;AAOtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAMxD,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,SAAS,CAAC"}

package/dist/content/inject-root.d.ts

@@ -0,0 +1,2 @@
+export declare const injectScript: import("./inject-script.ts").InjectScript;
+//# sourceMappingURL=inject-root.d.ts.map

package/dist/content/inject-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-root.d.ts","sourceRoot":"","sources":["../../src/content/inject-root.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,2CAA0C,CAAC"}

package/dist/content/inject-root.js

@@ -0,0 +1,4 @@
+import { scripting, tabs } from '../api/singletons.js';
+import { createInjectScript } from './inject-script.js';
+export const injectScript = createInjectScript({ scripting, tabs });
+//# sourceMappingURL=inject-root.js.map

package/dist/content/inject-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-root.js","sourceRoot":"","sources":["../../src/content/inject-root.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC"}

package/dist/content/inject-script.d.ts

@@ -0,0 +1,16 @@
+import type { InjectionResult, ScriptingApi } from '../types/scripting.ts';
+import type { TabsApi } from '../types/tabs.ts';
+export interface InjectScriptOptions {
+    readonly tabId?: number;
+    readonly frameIds?: readonly number[];
+    readonly allFrames?: boolean;
+    readonly world?: 'ISOLATED' | 'MAIN' | string;
+    readonly injectImmediately?: boolean;
+}
+export interface InjectScriptApis {
+    readonly scripting: Pick<ScriptingApi, 'executeScript'>;
+    readonly tabs: Pick<TabsApi, 'query'>;
+}
+export type InjectScript = (path: string | readonly string[], options?: InjectScriptOptions) => Promise<InjectionResult[]>;
+export declare function createInjectScript(apis: InjectScriptApis): InjectScript;
+//# sourceMappingURL=inject-script.d.ts.map

package/dist/content/inject-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-script.d.ts","sourceRoot":"","sources":["../../src/content/inject-script.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,eAAe,EAGf,YAAY,EACb,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,YAAY,EAAE,eAAe,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;CACvC;AAED,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,EAChC,OAAO,CAAC,EAAE,mBAAmB,KAC1B,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;AAEhC,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,YAAY,CAmDvE"}

package/dist/content/inject-script.js

@@ -0,0 +1,39 @@
+import { BrowserApiError } from '../shared/errors.js';
+export function createInjectScript(apis) {
+    const findActiveTabId = async () => {
+        const [tab] = await apis.tabs.query({
+            active: true,
+            currentWindow: true,
+        });
+        if (tab?.id === undefined) {
+            throw new BrowserApiError('BROWSER_API_FAILED', 'Could not resolve an active tab for script injection.', { api: 'tabs.query' });
+        }
+        return tab.id;
+    };
+    const resolveTarget = async (options) => {
+        const tabId = options.tabId ?? (await findActiveTabId());
+        return {
+            tabId,
+            ...(options.frameIds === undefined
+                ? {}
+                : { frameIds: options.frameIds }),
+            ...(options.allFrames === undefined
+                ? {}
+                : { allFrames: options.allFrames }),
+        };
+    };
+    return async function injectScript(path, options = {}) {
+        const target = await resolveTarget(options);
+        const files = typeof path === 'string' ? [path] : [...path];
+        const injection = {
+            target,
+            files,
+            ...(options.world === undefined ? {} : { world: options.world }),
+            ...(options.injectImmediately === undefined
+                ? {}
+                : { injectImmediately: options.injectImmediately }),
+        };
+        return apis.scripting.executeScript(injection);
+    };
+}
+//# sourceMappingURL=inject-script.js.map

package/dist/content/inject-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-script.js","sourceRoot":"","sources":["../../src/content/inject-script.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AA2BtD,MAAM,UAAU,kBAAkB,CAAC,IAAsB;IACvD,MAAM,eAAe,GAAG,KAAK,IAAqB,EAAE;QAClD,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;YAClC,MAAM,EAAE,IAAI;YACZ,aAAa,EAAE,IAAI;SACpB,CAAC,CAAC;QAEH,IAAI,GAAG,EAAE,EAAE,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,IAAI,eAAe,CACvB,oBAAoB,EACpB,uDAAuD,EACvD,EAAE,GAAG,EAAE,YAAY,EAAE,CACtB,CAAC;QACJ,CAAC;QAED,OAAO,GAAG,CAAC,EAAE,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,aAAa,GAAG,KAAK,EACzB,OAA4B,EACF,EAAE;QAC5B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,MAAM,eAAe,EAAE,CAAC,CAAC;QAEzD,OAAO;YACL,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,QAAQ,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;YACnC,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS;gBACjC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;SACtC,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,KAAK,UAAU,YAAY,CAChC,IAAgC,EAChC,OAAO,GAAwB,EAAE;QAEjC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,KAAK,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAoB;YACjC,MAAM;YACN,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChE,GAAG,CAAC,OAAO,CAAC,iBAAiB,KAAK,SAAS;gBACzC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,CAAC;SACtD,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/content/ui.d.ts

@@ -0,0 +1,50 @@
+import type { ContentScriptContext } from './context.ts';
+export type UiAnchor = string | Element | (() => string | Element | null | undefined) | null;
+export type UiAppendMode = 'first' | 'last' | 'before' | 'after' | 'replace' | ((anchor: Element, ui: HTMLElement) => void);
+export type UiPosition = 'inline' | 'overlay' | 'modal';
+export type UiAlignment = 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+export interface AutoMountOptions {
+    readonly once?: boolean;
+}
+export interface ContentScriptUi<T> {
+    readonly mounted: T | undefined;
+    readonly element: HTMLElement | undefined;
+    readonly isValid: boolean;
+    mount(): Promise<T>;
+    remove(): void;
+    unmount(): void;
+    autoMount(options?: AutoMountOptions): () => void;
+}
+export interface BaseUiOptions<T> {
+    readonly anchor?: UiAnchor;
+    readonly append?: UiAppendMode;
+    readonly position?: UiPosition;
+    readonly alignment?: UiAlignment;
+    readonly zIndex?: number;
+    readonly onRemove?: (mounted: T | undefined) => void;
+}
+export interface IntegratedUiOptions<T> extends BaseUiOptions<T> {
+    readonly tag?: string;
+    readonly onMount?: (container: HTMLElement) => T | Promise<T>;
+}
+export interface ShadowRootUiOptions<T> extends BaseUiOptions<T> {
+    readonly tag?: string;
+    readonly name?: string;
+    readonly css?: string;
+    readonly mode?: ShadowRootMode;
+    readonly isolateEvents?: boolean;
+    readonly onMount?: (container: HTMLElement) => T | Promise<T>;
+}
+export interface IframeUiOptions<T> extends BaseUiOptions<T> {
+    readonly page: string;
+    readonly tag?: string;
+    readonly onMount?: (iframe: HTMLIFrameElement, wrapper: HTMLElement) => T | Promise<T>;
+}
+export interface ShadowRootContentScriptUi<T> extends ContentScriptUi<T> {
+    readonly shadow: ShadowRoot | undefined;
+    readonly shadowHost: HTMLElement | undefined;
+}
+export declare function createIntegratedUi<T = HTMLElement>(ctx: ContentScriptContext, options?: IntegratedUiOptions<T>): ContentScriptUi<T>;
+export declare function createShadowRootUi<T = HTMLElement>(ctx: ContentScriptContext, options?: ShadowRootUiOptions<T>): ShadowRootContentScriptUi<T>;
+export declare function createIframeUi<T = HTMLIFrameElement>(ctx: ContentScriptContext, options: IframeUiOptions<T>): ContentScriptUi<T>;
+//# sourceMappingURL=ui.d.ts.map

package/dist/content/ui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui.d.ts","sourceRoot":"","sources":["../../src/content/ui.ts"],"names":[],"mappings":"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"}

package/dist/content/ui.js

@@ -0,0 +1,331 @@
+import { BrowserApiError } from '../shared/errors.js';
+export function createIntegratedUi(ctx, options = {}) {
+    return createUi(ctx, options, {
+        createHost(document) {
+            return createHost(document, options.tag ?? 'div');
+        },
+        createContainer(host) {
+            return host;
+        },
+        async mount(container) {
+            return options.onMount === undefined
+                ? container
+                : options.onMount(container);
+        },
+        ...(options.onRemove === undefined
+            ? {}
+            : { onRemove: options.onRemove }),
+    });
+}
+export function createShadowRootUi(ctx, options = {}) {
+    let shadow;
+    let shadowHost;
+    const ui = createUi(ctx, options, {
+        createHost(document) {
+            shadowHost = createHost(document, options.tag ?? 'div');
+            if (options.name !== undefined) {
+                shadowHost.setAttribute('data-addonova-ui-name', options.name);
+            }
+            if (options.isolateEvents === true) {
+                isolateEvents(shadowHost);
+            }
+            return shadowHost;
+        },
+        createContainer(host, document) {
+            shadow = host.attachShadow({ mode: options.mode ?? 'open' });
+            if (options.css !== undefined && options.css !== '') {
+                const style = document.createElement('style');
+                style.textContent = options.css;
+                shadow.append(style);
+            }
+            const container = document.createElement('div');
+            shadow.append(container);
+            return container;
+        },
+        async mount(container) {
+            return options.onMount === undefined
+                ? container
+                : options.onMount(container);
+        },
+        ...(options.onRemove === undefined
+            ? {}
+            : { onRemove: options.onRemove }),
+    });
+    return Object.defineProperties(ui, {
+        shadow: {
+            configurable: true,
+            enumerable: true,
+            get() {
+                return shadow;
+            },
+        },
+        shadowHost: {
+            configurable: true,
+            enumerable: true,
+            get() {
+                return shadowHost;
+            },
+        },
+    });
+}
+export function createIframeUi(ctx, options) {
+    return createUi(ctx, options, {
+        createHost(document) {
+            return createHost(document, options.tag ?? 'div');
+        },
+        createContainer(host, document) {
+            const iframe = document.createElement('iframe');
+            iframe.src = resolveIframeUrl(options.page);
+            host.append(iframe);
+            return iframe;
+        },
+        async mount(container, host) {
+            const iframe = container;
+            return options.onMount === undefined
+                ? iframe
+                : options.onMount(iframe, host);
+        },
+        ...(options.onRemove === undefined
+            ? {}
+            : { onRemove: options.onRemove }),
+    });
+}
+function createUi(ctx, options, internals) {
+    let host;
+    let mounted;
+    let hasMounted = false;
+    let mounting;
+    let stopAutoMount;
+    const requireDocument = () => {
+        if (typeof document === 'undefined') {
+            throw new BrowserApiError('BROWSER_UNSUPPORTED_ENVIRONMENT', 'A DOM document is required to mount a content script UI.');
+        }
+        return document;
+    };
+    const attach = (hostElement) => {
+        const document = requireDocument();
+        const anchor = resolveAnchor(options.anchor, document);
+        if (anchor === null) {
+            throw new BrowserApiError('BROWSER_API_FAILED', 'Could not find an anchor element for the content script UI.');
+        }
+        applyPosition(hostElement, options);
+        insertUi(anchor, hostElement, options.append ?? 'last');
+    };
+    const mount = async () => {
+        if (hasMounted) {
+            return mounted;
+        }
+        if (mounting !== undefined) {
+            return mounting;
+        }
+        if (!ctx.isValid) {
+            throw new BrowserApiError('BROWSER_UNSUPPORTED_ENVIRONMENT', 'The content script context is no longer valid.');
+        }
+        mounting = (async () => {
+            const document = requireDocument();
+            host = internals.createHost(document);
+            try {
+                attach(host);
+                const container = internals.createContainer(host, document);
+                mounted = await internals.mount(container, host);
+                hasMounted = true;
+                return mounted;
+            }
+            catch (error) {
+                host.remove();
+                host = undefined;
+                throw error;
+            }
+            finally {
+                mounting = undefined;
+            }
+        })();
+        return mounting;
+    };
+    const remove = () => {
+        if (!hasMounted && host === undefined) {
+            return;
+        }
+        const currentHost = host;
+        const currentMounted = mounted;
+        hasMounted = false;
+        mounted = undefined;
+        host = undefined;
+        try {
+            internals.onRemove?.(currentMounted);
+        }
+        finally {
+            currentHost?.remove();
+        }
+    };
+    const autoMount = (autoOptions = {}) => {
+        if (stopAutoMount !== undefined) {
+            return stopAutoMount;
+        }
+        if (typeof document === 'undefined' || document.documentElement === null) {
+            return () => { };
+        }
+        let stopped = false;
+        let invalidatedCleanup;
+        const check = () => {
+            if (stopped) {
+                return;
+            }
+            const anchor = resolveAnchor(options.anchor, document);
+            if (anchor === null) {
+                if (hasMounted || host !== undefined) {
+                    remove();
+                }
+                return;
+            }
+            if (!hasMounted) {
+                void mount().catch(() => { });
+            }
+            else if (host !== undefined && !host.isConnected) {
+                remove();
+                void mount().catch(() => { });
+            }
+            if (autoOptions.once === true && hasMounted) {
+                stop();
+            }
+        };
+        const observer = new MutationObserver(check);
+        observer.observe(document.documentElement, {
+            childList: true,
+            subtree: true,
+        });
+        const stop = () => {
+            if (stopped) {
+                return;
+            }
+            stopped = true;
+            observer.disconnect();
+            invalidatedCleanup?.();
+            stopAutoMount = undefined;
+        };
+        invalidatedCleanup = ctx.onInvalidated(() => {
+            stop();
+            remove();
+        });
+        stopAutoMount = stop;
+        check();
+        return stop;
+    };
+    return {
+        get mounted() {
+            return mounted;
+        },
+        get element() {
+            return host;
+        },
+        get isValid() {
+            return ctx.isValid;
+        },
+        mount,
+        remove,
+        unmount: remove,
+        autoMount,
+    };
+}
+function createHost(document, tag) {
+    const host = document.createElement(tag);
+    host.setAttribute('data-addonova-ui', '');
+    return host;
+}
+function resolveAnchor(anchor, document) {
+    if (anchor === undefined) {
+        return document.body ?? document.documentElement;
+    }
+    if (anchor === null) {
+        return null;
+    }
+    const resolved = typeof anchor === 'function' ? anchor() : anchor;
+    if (resolved === null || resolved === undefined) {
+        return null;
+    }
+    return typeof resolved === 'string'
+        ? document.querySelector(resolved)
+        : resolved;
+}
+function insertUi(anchor, ui, mode) {
+    if (typeof mode === 'function') {
+        mode(anchor, ui);
+        return;
+    }
+    switch (mode) {
+        case 'first':
+            anchor.prepend(ui);
+            break;
+        case 'last':
+            anchor.append(ui);
+            break;
+        case 'before':
+            anchor.before(ui);
+            break;
+        case 'after':
+            anchor.after(ui);
+            break;
+        case 'replace':
+            anchor.replaceWith(ui);
+            break;
+    }
+}
+function applyPosition(host, options) {
+    const position = options.position ?? 'inline';
+    if (position === 'inline') {
+        return;
+    }
+    host.style.position = 'fixed';
+    host.style.zIndex = String(options.zIndex ?? 2147483647);
+    if (position === 'modal') {
+        host.style.top = '0';
+        host.style.left = '0';
+        host.style.width = '100%';
+        host.style.height = '100%';
+        host.style.display = 'flex';
+        host.style.alignItems = 'center';
+        host.style.justifyContent = 'center';
+        return;
+    }
+    const alignment = options.alignment ?? 'top-left';
+    const [vertical, horizontal] = alignment.split('-');
+    host.style[vertical] = '0';
+    host.style[horizontal] = '0';
+}
+function isolateEvents(host) {
+    const events = [
+        'click',
+        'dblclick',
+        'mousedown',
+        'mouseup',
+        'pointerdown',
+        'pointerup',
+        'keydown',
+        'keyup',
+        'keypress',
+        'input',
+        'change',
+        'submit',
+        'wheel',
+        'touchstart',
+        'touchend',
+    ];
+    for (const event of events) {
+        host.addEventListener(event, (value) => value.stopPropagation());
+    }
+}
+function resolveIframeUrl(page) {
+    if (/^(?:[a-z][a-z\d+.-]*:|\/\/)/i.test(page)) {
+        return page;
+    }
+    const runtime = getGlobalRuntime();
+    if (runtime === undefined || typeof runtime.getURL !== 'function') {
+        throw new BrowserApiError('BROWSER_UNSUPPORTED_ENVIRONMENT', 'The extension runtime is not available to resolve the iframe URL.');
+    }
+    return runtime.getURL(page);
+}
+function getGlobalRuntime() {
+    const global = globalThis;
+    return global.browser?.runtime ?? global.chrome?.runtime;
+}
+//# sourceMappingURL=ui.js.map