@vacantthinker/firefox-addon-framework-easy 2026.612.1204 → 2026.612.2157

package/dist/browserRuntime.d.ts

@@ -9,15 +9,19 @@ export declare function browserRuntimeReload(): void;
 export declare function browserRuntimeSetUninstallURL(url?: string): Promise<void>;
 /**
  * Adds a listener for available updates.
- * @param callback Callback to execute when an update is available.
  */
-export declare function browserRuntimeOnUpdateAvailable(callback?: (details: browser.runtime._OnUpdateAvailableDetails) => void | Promise<void>): void;
+export declare function browserRuntimeOnUpdateAvailable(): void;
 /**
  * Converts a relative path to a fully qualified URL.
  * @param path The path to the resource.
  * @returns The absolute URL string.
  */
 export declare function browserRuntimeGetURL(path: string): string;
+/**
+ * `pages/${path}`
+ * @param path
+ */
+export declare function browserRuntimeGetPagesURL(path: string): string;
 /**
  * Retrieves the Gecko ID from the manifest.
  * @returns The Gecko ID or empty string if not found.

package/dist/browserRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserRuntime.d.ts","sourceRoot":"","sources":["../src/browserRuntime.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,GAAG,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,yBAAyB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACtF,IAAI,CAMN;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAExF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}
+{"version":3,"file":"browserRuntime.d.ts","sourceRoot":"","sources":["../src/browserRuntime.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,IAAI,CAE3C;AAED;;;GAGG;AACH,wBAAsB,6BAA6B,CAAC,GAAG,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;GAEG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAG9C;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAExF;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,IAAI,MAAM,CAEtD;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD"}

package/dist/browserRuntime.js

@@ -13,13 +13,9 @@ export async function browserRuntimeSetUninstallURL(url = '') {
 }
 /**
  * Adds a listener for available updates.
- * @param callback Callback to execute when an update is available.
  */
-export function browserRuntimeOnUpdateAvailable(callback) {
-    browser.runtime.onUpdateAvailable.addListener(async (details) => {
-        if (callback) {
-            await callback(details);
-        }
+export function browserRuntimeOnUpdateAvailable() {
+    browser.runtime.onUpdateAvailable.addListener(() => {
     });
 }
 /**
@@ -30,6 +26,13 @@ export function browserRuntimeOnUpdateAvailable(callback) {
 export function browserRuntimeGetURL(path) {
     return browser.runtime.getURL(path);
 }
+/**
+ * `pages/${path}`
+ * @param path
+ */
+export function browserRuntimeGetPagesURL(path) {
+    return browser.runtime.getURL(`pages/${path}`);
+}
 /**
  * Retrieves the Gecko ID from the manifest.
  * @returns The Gecko ID or empty string if not found.

package/dist/browserTab.d.ts

@@ -1,34 +1,5 @@
-/**
- * Interface representing the structure of a message sent to a tab.
- * Includes optional properties for tab creation and specific message data.
- */
-export interface TabMessage {
-    targetTabId?: number;
-    previousTabId?: number;
-    url?: string;
-    focusNewTab?: boolean;
-    [key: string]: any;
-}
 /**
  * Sends a message to a specific tab.
  */
 export declare function browserTabSendMessage(tabId: number, message: any): Promise<void>;
-/**
- * Waits for a tab to finish loading (status: complete) before sending a message.
- */
-export declare function browserTabWaitReloadThenSendMessageToContentJs(message: TabMessage): void;
-/**
- * Creates a tab for download, waits for load, and then removes it.
- */
-export declare function browserTabCreateToDownload(message: TabMessage): Promise<void>;
-/**
- * Safely handles incoming messages to create tabs and send messages to content scripts.
- */
-export declare function browserTabCreateNearSendMessageToContentJs(message?: TabMessage): Promise<void>;
-/**
- * Watches a tab for reload, then removes it upon completion.
- */
-export declare function browserTabWaitReloadThenRemoveIt({ tabId }: {
-    tabId: number;
-}): void;
 //# sourceMappingURL=browserTab.d.ts.map

package/dist/browserTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserTab.d.ts","sourceRoot":"","sources":["../src/browserTab.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF;AAED;;GAEG;AACH,wBAAgB,8CAA8C,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAkBxF;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BnF;AAED;;GAEG;AACH,wBAAsB,0CAA0C,CAAC,OAAO,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAyCxG;AAED;;GAEG;AACH,wBAAgB,gCAAgC,CAAC,EAAC,KAAK,EAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAYjF"}
+{"version":3,"file":"browserTab.d.ts","sourceRoot":"","sources":["../src/browserTab.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAEtF"}

package/dist/browserTab.js

@@ -1,105 +1,6 @@
-import { tabOpCreate, tabOpCreateNear, tabOpRemove } from './opTab';
 /**
  * Sends a message to a specific tab.
  */
 export async function browserTabSendMessage(tabId, message) {
     await browser.tabs.sendMessage(tabId, message);
 }
-/**
- * Waits for a tab to finish loading (status: complete) before sending a message.
- */
-export function browserTabWaitReloadThenSendMessageToContentJs(message) {
-    const { targetTabId, ...rest } = message;
-    if (targetTabId === undefined)
-        return;
-    const listener = async (tabId, changeInfo) => {
-        if (tabId === targetTabId && changeInfo.status === 'complete') {
-            browser.tabs.onUpdated.removeListener(listener);
-            await browserTabSendMessage(tabId, rest);
-        }
-    };
-    browser.tabs.onUpdated.addListener(listener, {
-        tabId: targetTabId,
-        properties: ['status'],
-    });
-}
-/**
- * Creates a tab for download, waits for load, and then removes it.
- */
-export async function browserTabCreateToDownload(message) {
-    if (!message.url)
-        return;
-    const properties = {
-        url: message.url,
-    };
-    if (message.focusNewTab !== undefined) {
-        properties.active = message.focusNewTab;
-    }
-    const { tabId } = await tabOpCreate(properties);
-    const listener = async (updatedTabId, changeInfo) => {
-        if (updatedTabId === tabId && changeInfo.status === 'complete') {
-            browser.tabs.onUpdated.removeListener(listener);
-            await tabOpRemove(tabId);
-        }
-    };
-    browser.tabs.onUpdated.addListener(listener, {
-        tabId,
-        properties: ['status'],
-    });
-}
-/**
- * Safely handles incoming messages to create tabs and send messages to content scripts.
- */
-export async function browserTabCreateNearSendMessageToContentJs(message = {}) {
-    if (!message.url)
-        return;
-    const { previousTabId, ...rest } = message;
-    const properties = {
-        url: message.url,
-        active: message.focusNewTab ?? false,
-    };
-    const { tabId: createdTabId } = message.previousTabId
-        ? await tabOpCreateNear({ properties, previousTabId })
-        : await tabOpCreate(properties);
-    if (!createdTabId)
-        return;
-    const onUpdatedListener = async (tabId, changeInfo) => {
-        if (tabId === createdTabId && changeInfo.status === 'complete') {
-            cleanup();
-            await browserTabSendMessage(tabId, {
-                ...rest,
-                tabId: tabId,
-            });
-        }
-    };
-    // Listener to cleanup if tab is closed before loading completes
-    const onRemovedListener = (tabId) => {
-        if (tabId === createdTabId) {
-            cleanup();
-        }
-    };
-    const cleanup = () => {
-        browser.tabs.onUpdated.removeListener(onUpdatedListener);
-        browser.tabs.onRemoved.removeListener(onRemovedListener);
-    };
-    browser.tabs.onUpdated.addListener(onUpdatedListener, {
-        tabId: createdTabId,
-        properties: ['status'],
-    });
-    browser.tabs.onRemoved.addListener(onRemovedListener);
-}
-/**
- * Watches a tab for reload, then removes it upon completion.
- */
-export function browserTabWaitReloadThenRemoveIt({ tabId }) {
-    const listener = async (updatedTabId, changeInfo) => {
-        if (updatedTabId === tabId && changeInfo.status === 'complete') {
-            browser.tabs.onUpdated.removeListener(listener);
-            await tabOpRemove(tabId);
-        }
-    };
-    browser.tabs.onUpdated.addListener(listener, {
-        tabId,
-        properties: ['status'],
-    });
-}

package/dist/opTab.d.ts

@@ -12,6 +12,14 @@ export declare function tabOpEnhance(tab: browser.tabs.Tab): EnhancedTab | null;
  * Creates a standard tab.
  */
 export declare function tabOpCreate(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export declare function tabOpCreateActiveFalse(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export declare function tabOpCreateActiveTrue(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
 interface TabOpCreateNearOptions {
     properties: browser.tabs._CreateCreateProperties;
     previousTabId: number | undefined;
@@ -20,10 +28,6 @@ interface TabOpCreateNearOptions {
  * Creates a new tab positioned immediately after a specified existing tab.
  */
 export declare function tabOpCreateNear(options: TabOpCreateNearOptions): Promise<EnhancedTab>;
-/**
- * Creates a tab in the background (inactive and muted).
- */
-export declare function tabOpCreateActiveFalse(properties: browser.tabs._CreateCreateProperties): Promise<EnhancedTab>;
 /**
  * Creates a new window and returns its primary tab.
  */

package/dist/opTab.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opTab.d.ts","sourceRoot":"","sources":["../src/opTab.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO,CAAC,IAAI,CAAC,GAAG;IACnD,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,WAAW,GAAG,IAAI,CAGtE;AAsBD;;GAEG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAExG;AAED,UAAU,sBAAsB;IAC9B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,CAAC;IACjD,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,WAAW,CAAC,CAc3F;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,CAMnH;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAIvF;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAEvE;AAED;;GAEG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAEjE;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9D,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CACvC,EAAE,CAAC,CAaH;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7E;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAE5F;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAEzE;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE3E;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,MAAM,EACb,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,uBAAuB,GACrD,OAAO,CAAC,WAAW,CAAC,CAEtB;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAEhF;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQpE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAEnF"}
+{"version":3,"file":"opTab.d.ts","sourceRoot":"","sources":["../src/opTab.ts"],"names":[],"mappings":"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"}

package/dist/opTab.js

@@ -33,6 +33,25 @@ async function _update(tabId, properties) {
 export async function tabOpCreate(properties) {
     return _create(properties);
 }
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export async function tabOpCreateActiveFalse(properties) {
+    return _create({
+        ...properties,
+        active: false,
+        muted: true,
+    });
+}
+/**
+ * Creates a tab in the background (inactive and muted).
+ */
+export async function tabOpCreateActiveTrue(properties) {
+    return _create({
+        ...properties,
+        active: true,
+    });
+}
 /**
  * Creates a new tab positioned immediately after a specified existing tab.
  */
@@ -50,16 +69,6 @@ export async function tabOpCreateNear(options) {
     }
     return _create(properties);
 }
-/**
- * Creates a tab in the background (inactive and muted).
- */
-export async function tabOpCreateActiveFalse(properties) {
-    return _create({
-        ...properties,
-        active: false,
-        muted: true,
-    });
-}
 /**
  * Creates a new window and returns its primary tab.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0612.1204",
+  "version": "2026.0612.2157",
   "description": "",
   "type": "module",
   "main": "dist/index.js",