@vacantthinker/firefox-addon-framework-easy 2026.618.1242 → 2026.618.1419

package/dist/{ContentJsYTB.d.ts → ContentJs.d.ts}

@@ -29,14 +29,6 @@ export declare function ctJsRandomSleep501_800(): Promise<void>;
  * @returns {string} Normalized string representation of numbers, or "unknown".
  */
 export declare function ctJsExtractVideoQualityFromText(text: string): string;
-/**
- * Establishes a persistent baseline connection with the background script to
- * maintain runtime context.
- */
-export declare function ctJskeepAlive(tag?: string, enableLog?: boolean): void;
-export declare function ctJsCloseTab(): Promise<void>;
-export declare function ctJsFocusTargetTab(targetTabId: number): Promise<void>;
-export declare function ctJsRemoveDomainCache(domain: string): Promise<void>;
 /**
  * Executes a provided function once the DOM is ready.
  * If the DOM is already ready, it executes immediately.
@@ -45,6 +37,17 @@ export declare function ctJsRemoveDomainCache(domain: string): Promise<void>;
  */
 export declare function ctJsExecuteOnReady(fn: () => void | Promise<void>): Promise<void>;
 export declare function ctJsOpenPage(url: string): Promise<void>;
+export declare function ctJsRemoveDomainCache(domain: string): Promise<void>;
 export declare function ctJsOpenPageKeepOnlyOne(url: string): Promise<void>;
 export declare function ctJsHideElements(selectors: string[]): void;
-//# sourceMappingURL=ContentJsYTB.d.ts.map
+/**
+ * Establishes a persistent baseline connection with the background script to
+ * maintain runtime context.
+ */
+export declare function ctJskeepAlive(tag?: string, enableLog?: boolean): void;
+export declare function ctJsCloseTab(): Promise<void>;
+export declare function ctJsRemoveCurrentTab(): Promise<void>;
+export declare function ctJsFocusTargetTab(targetTabId: number): Promise<void>;
+export declare function ctJsInfoToBackground(info: string): Promise<void>;
+export declare function ctJsNotification(content: string): Promise<void>;
+//# sourceMappingURL=ContentJs.d.ts.map

package/dist/ContentJs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentJs.d.ts","sourceRoot":"","sources":["../src/ContentJs.ts"],"names":[],"mappings":"AAUA;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAE,MAAc,GAAG,IAAI,CAmCvG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,uBAAuB,kBAE5C;AAED,wBAAsB,sBAAsB,kBAE3C;AAGD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAGD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,iBAE7C;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,iBAExD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAKnD;AAQD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAO,QAU/D;AAED,wBAAsB,YAAY,kBAKjC;AAED,wBAAsB,oBAAoB,kBAKzC;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAM3D;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,iBAGtD;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,MAAM,iBAKrD"}

package/dist/{ContentJsYTB.js → ContentJs.js}

@@ -77,35 +77,6 @@ export function ctJsExtractVideoQualityFromText(text) {
     const num = parseInt(text, 10);
     return Number.isNaN(num) ? 'unknown' : num.toString();
 }
-/**
- * Establishes a persistent baseline connection with the background script to
- * maintain runtime context.
- */
-export function ctJskeepAlive(tag = "", enableLog = false) {
-    setInterval(async () => {
-        if (enableLog) {
-            console.log(tag, "br send message actMarco");
-        }
-        let message = { act: 'actMarco' };
-        await browserRuntimeSendMessage(message);
-    }, 1000);
-}
-export async function ctJsCloseTab() {
-    let message = {
-        act: 'actRemoveCurrentTab',
-    };
-    await browserRuntimeSendMessage(message);
-}
-export async function ctJsFocusTargetTab(targetTabId) {
-    const message = {
-        targetTabId,
-        act: 'actFocusTargetTab'
-    };
-    await browserRuntimeSendMessage(message);
-}
-export async function ctJsRemoveDomainCache(domain) {
-    await browserBrowsingDataRemoveDomainCache(domain);
-}
 /**
  * Executes a provided function once the DOM is ready.
  * If the DOM is already ready, it executes immediately.
@@ -130,6 +101,9 @@ export async function ctJsExecuteOnReady(fn) {
 export async function ctJsOpenPage(url) {
     await tabOpCreateActiveTrue({ url });
 }
+export async function ctJsRemoveDomainCache(domain) {
+    await browserBrowsingDataRemoveDomainCache(domain);
+}
 export async function ctJsOpenPageKeepOnlyOne(url) {
     await tabOpCreateKeepOnlyOneFocusTrue(url);
 }
@@ -139,3 +113,50 @@ export function ctJsHideElements(selectors) {
             .forEach(ele => ele.hidden = true);
     });
 }
+//-------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------
+// -------------------------------------------------------------------------------
+/**
+ * Establishes a persistent baseline connection with the background script to
+ * maintain runtime context.
+ */
+export function ctJskeepAlive(tag = "", enableLog = true) {
+    setInterval(async () => {
+        if (enableLog) {
+            console.log(tag, "br send message actMarco");
+        }
+        let message = { act: 'actMarco' };
+        await browserRuntimeSendMessage(message);
+    }, 1000);
+}
+export async function ctJsCloseTab() {
+    let message = {
+        act: 'actRemoveCurrentTab',
+    };
+    await browserRuntimeSendMessage(message);
+}
+export async function ctJsRemoveCurrentTab() {
+    let message = {
+        act: 'actRemoveCurrentTab',
+    };
+    await browserRuntimeSendMessage(message);
+}
+export async function ctJsFocusTargetTab(targetTabId) {
+    const message = {
+        targetTabId,
+        act: 'actFocusTargetTab'
+    };
+    await browserRuntimeSendMessage(message);
+}
+export async function ctJsInfoToBackground(info) {
+    const message = { act: "actInfo", info, };
+    await browserRuntimeSendMessage(message);
+}
+export async function ctJsNotification(content) {
+    const message = {
+        act: "actNotification", content,
+    };
+    await browserRuntimeSendMessage(message);
+}

package/dist/backgroundJs.d.ts

@@ -0,0 +1,12 @@
+import { MessageActionBaseOptions } from "./types";
+export type ActHandlerFunc = (rest: any, tabId: number | undefined) => Promise<void>;
+/**
+ * Uses <T extends string> so the app can pass its own union type.
+ * It defaults to FrameworkBaseAction if no type is passed.
+ */
+export declare function bkJsCreateActionBaseHandlers<T extends string = MessageActionBaseOptions>(): Map<T, ActHandlerFunc>;
+/**
+ * Dispatcher also accepts the generic map
+ */
+export declare function bkJsRegisterMessageDispatcher<T extends string>(handlersMap: Map<T, ActHandlerFunc>, logTag?: string): void;
+//# sourceMappingURL=backgroundJs.d.ts.map

package/dist/backgroundJs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backgroundJs.d.ts","sourceRoot":"","sources":["../src/backgroundJs.ts"],"names":[],"mappings":"AAGA,OAAO,EAAC,wBAAwB,EAAC,MAAM,SAAS,CAAC;AAGjD,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAErF;;;GAGG;AACH,wBAAgB,4BAA4B,CAAC,CAAC,SAAS,MAAM,GAAG,wBAAwB,KACpF,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,CA4BzB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,EAC5D,WAAW,EAAE,GAAG,CAAC,CAAC,EAAE,cAAc,CAAC,EACnC,MAAM,GAAE,MAAyB,QAqBlC"}

package/dist/backgroundJs.js

@@ -0,0 +1,64 @@
+// --- IN YOUR FRAMEWORK ---
+import { browserTabSendMessageMarcoPolo } from "./browserTab";
+import { tabOpFocus, tabOpReload, tabOpRemove } from "./opTab";
+import { browserNotificationCreateBasicContent } from "./browserNotification";
+/**
+ * Uses <T extends string> so the app can pass its own union type.
+ * It defaults to FrameworkBaseAction if no type is passed.
+ */
+export function bkJsCreateActionBaseHandlers() {
+    // We use `any` internally to set the map up without TS complaining,
+    // but we return the strictly typed generic Map.
+    const map = new Map();
+    map.set("actNotification", async (rest) => {
+        if (rest && rest.content) {
+            await browserNotificationCreateBasicContent(rest.content);
+        }
+    });
+    map.set('actInfo', async (rest) => {
+        console.info('actInfo', rest);
+    });
+    map.set('actMarco', async (_rest, tabId) => {
+        if (tabId)
+            await browserTabSendMessageMarcoPolo(tabId);
+    });
+    map.set('actFocusTargetTab', async (rest) => {
+        if (rest)
+            await tabOpFocus(rest.targetTabId);
+    });
+    map.set('actReloadTargetTab', async (rest) => {
+        if (rest)
+            await tabOpReload(rest.targetTabId);
+    });
+    map.set('actRemoveCurrentTab', async (_rest, tabId) => {
+        if (tabId)
+            await tabOpRemove(tabId);
+    });
+    // Cast it to the consumer's type before returning
+    return map;
+}
+/**
+ * Dispatcher also accepts the generic map
+ */
+export function bkJsRegisterMessageDispatcher(handlersMap, logTag = "background.ts ") {
+    browser.runtime.onMessage.addListener(async (message, sender) => {
+        const { act, ...rest } = message;
+        if (!act)
+            return;
+        const tabId = sender?.tab?.id;
+        if (act !== "actMarco") {
+            console.info(logTag, act, `tabId=`, tabId);
+        }
+        else {
+            console.log(logTag, act, `tabId=`, tabId);
+        }
+        // Cast `act` to T so it can be used to query the Map
+        const handler = handlersMap.get(act);
+        if (handler) {
+            await handler(rest, tabId);
+        }
+        else {
+            console.warn(act, " not match!");
+        }
+    });
+}

package/dist/browserNotification.d.ts

@@ -1,14 +1,3 @@
-export interface NotificationTwoOptions {
-    message: string;
-    title?: string;
-}
-export declare function browserNotificationCreateBasicMessageOnly(message: string): Promise<string>;
-/**
- * Creates a browser notification with basic type,
- * if title null use addon manifest name.
- * @returns The notification identifier.
- * @param notificationTwoOptions
- */
-export declare function browserNotificationCreateBasicMessage(notificationTwoOptions: NotificationTwoOptions): Promise<string>;
+export declare function browserNotificationCreateBasicContent(content: string): Promise<string>;
 export declare function browserNotificationCreate(notificationOptions: browser.notifications.CreateNotificationOptions): Promise<string>;
 //# sourceMappingURL=browserNotification.d.ts.map

package/dist/browserNotification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserNotification.d.ts","sourceRoot":"","sources":["../src/browserNotification.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,yCAAyC,CAC7D,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAIjB;AAED;;;;;GAKG;AACH,wBAAsB,qCAAqC,CACzD,sBAAsB,EAAE,sBAAsB,GAC7C,OAAO,CAAC,MAAM,CAAC,CAYjB;AAED,wBAAsB,yBAAyB,CAC7C,mBAAmB,EAAE,OAAO,CAAC,aAAa,CAAC,yBAAyB,GACnE,OAAO,CAAC,MAAM,CAAC,CAGjB"}
+{"version":3,"file":"browserNotification.d.ts","sourceRoot":"","sources":["../src/browserNotification.ts"],"names":[],"mappings":"AAEA,wBAAsB,qCAAqC,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgB5F;AAED,wBAAsB,yBAAyB,CAC7C,mBAAmB,EAAE,OAAO,CAAC,aAAa,CAAC,yBAAyB,GACnE,OAAO,CAAC,MAAM,CAAC,CAEjB"}

package/dist/browserNotification.js

@@ -1,21 +1,15 @@
 import { browserRuntimeManifestName } from './browserRuntime';
-export async function browserNotificationCreateBasicMessageOnly(message) {
-    return await browserNotificationCreateBasicMessage({ message });
-}
-/**
- * Creates a browser notification with basic type,
- * if title null use addon manifest name.
- * @returns The notification identifier.
- * @param notificationTwoOptions
- */
-export async function browserNotificationCreateBasicMessage(notificationTwoOptions) {
+export async function browserNotificationCreateBasicContent(content) {
+    const notification = ({
+        content: content,
+    });
     const notificationOptions = {
         message: "",
         type: 'basic',
         title: browserRuntimeManifestName()
     };
     const options = {
-        ...notificationOptions, ...notificationTwoOptions
+        ...notificationOptions, ...notification
     };
     return await browserNotificationCreate(options);
 }

package/dist/browserRuntime.d.ts

@@ -1,4 +1,4 @@
-import { MessagePayloadAct } from "./types";
+import { MessagePayloadAction } from "./types";
 /**
  * Reloads the current extension.
  */
@@ -48,5 +48,5 @@ export declare function browserRuntimeManifestVersion(): string;
  * @returns The extension name.
  */
 export declare function browserRuntimeManifestName(): string;
-export declare function browserRuntimeSendMessage(message: MessagePayloadAct): Promise<void>;
+export declare function browserRuntimeSendMessage(message: MessagePayloadAction): Promise<void>;
 //# sourceMappingURL=browserRuntime.d.ts.map

package/dist/browserRuntime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browserRuntime.d.ts","sourceRoot":"","sources":["../src/browserRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,SAAS,CAAC;AAE1C;;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,sCAAsC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;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;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,iBAAiB,iBAG3B"}
+{"version":3,"file":"browserRuntime.d.ts","sourceRoot":"","sources":["../src/browserRuntime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAC,MAAM,SAAS,CAAC;AAE7C;;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,sCAAsC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3E;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAI9C;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;AAED,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,oBAAoB,iBAG9B"}

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './backgroundJs';
 export * from './BaseNumberKeyORM';
 export * from './BaseORM';
 export * from './BaseStringKeyORM';
@@ -6,7 +7,7 @@ export * from './browserDownload';
 export * from './browserNotification';
 export * from './browserRuntime';
 export * from './browserTab';
-export * from './ContentJsYTB';
+export * from './ContentJs';
 export * from './opStorage';
 export * from './opTab';
 export * from './serviceCommon';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,SAAS,CAAC"}

package/dist/index.js

@@ -1,3 +1,4 @@
+export * from './backgroundJs';
 export * from './BaseNumberKeyORM';
 export * from './BaseORM';
 export * from './BaseStringKeyORM';
@@ -6,7 +7,7 @@ export * from './browserDownload';
 export * from './browserNotification';
 export * from './browserRuntime';
 export * from './browserTab';
-export * from './ContentJsYTB';
+export * from './ContentJs';
 export * from './opStorage';
 export * from './opTab';
 export * from './serviceCommon';

package/dist/serviceCommon.d.ts

@@ -5,7 +5,8 @@ import { DownloadParams } from './browserDownload';
 export declare function serviceResetAddon(): Promise<void>;
 /**
  * Service to handle download operations.
- * Attempts a full download with filename; if it fails, retries with downlink only.
+ * Attempts a full download with filename; if it fails, retries with downlink
+ * only.
  * * @param params The download parameters.
  */
 export declare function serviceDownloadByDownlink(params: DownloadParams): Promise<void>;

package/dist/serviceCommon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serviceCommon.d.ts","sourceRoot":"","sources":["../src/serviceCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,cAAc,EACf,MAAM,mBAAmB,CAAC;AAS3B;;GAEG;AACH,wBAAsB,iBAAiB,kBAGtC;AAED;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrF"}
+{"version":3,"file":"serviceCommon.d.ts","sourceRoot":"","sources":["../src/serviceCommon.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,cAAc,EAAC,MAAM,mBAAmB,CAAC;AAK5E;;GAEG;AACH,wBAAsB,iBAAiB,kBAGtC;AAED;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBrF"}

package/dist/serviceCommon.js

@@ -1,5 +1,5 @@
 import { browserDownloadByDownlink } from './browserDownload';
-import { browserNotificationCreateBasicMessageOnly } from './browserNotification';
+import { browserNotificationCreateBasicContent } from './browserNotification';
 import { stoOpClear } from "./opStorage";
 import { browserRuntimeReload } from "./browserRuntime";
 /**
@@ -11,7 +11,8 @@ export async function serviceResetAddon() {
 }
 /**
  * Service to handle download operations.
- * Attempts a full download with filename; if it fails, retries with downlink only.
+ * Attempts a full download with filename; if it fails, retries with downlink
+ * only.
  * * @param params The download parameters.
  */
 export async function serviceDownloadByDownlink(params) {
@@ -19,12 +20,12 @@ export async function serviceDownloadByDownlink(params) {
     try {
         // Attempt 1: Full download with provided parameters
         await browserDownloadByDownlink(params);
-        await browserNotificationCreateBasicMessageOnly(`downloading! ${filename ??
+        await browserNotificationCreateBasicContent(`downloading! ${filename ??
             'file'}`);
     }
     catch (error) {
         // Notify about the failure
-        await browserNotificationCreateBasicMessageOnly(`reason=${error}`);
+        await browserNotificationCreateBasicContent(`reason=${error}`);
         // Attempt 2: Fallback retry using only the downlink
         await browserDownloadByDownlink({ downlink });
     }

package/dist/serviceOpJavascript.js

@@ -1,6 +1,6 @@
 import { serviceGetCurrentDateYYYYMMDDHHMMSS } from './serviceGet';
 import { serviceCopyContentToClipboard, serviceRemoveIllegalWord, serviceSaveContentToLocal, } from './serviceOpContent';
-import { browserNotificationCreateBasicMessageOnly } from './browserNotification';
+import { browserNotificationCreateBasicContent } from './browserNotification';
 // --- Services ---
 /**
  * Captures a tab's screenshot and triggers a local download in the target tab.
@@ -192,7 +192,7 @@ export async function serviceDealWithMagnetLink(message) {
     if (!Array.isArray(data) ||
         data.length ===
             0) {
-        await browserNotificationCreateBasicMessageOnly('magnet link not found!');
+        await browserNotificationCreateBasicContent('magnet link not found!');
         return;
     }
     const content = `${data.join('\n')}\n`;

package/dist/types.d.ts

@@ -1,8 +1,15 @@
-export type MessageActionOptions = "actMarco" | "actRemoveCurrentTab" | "actFocusTargetTab" | "actReloadTargetTab";
-export interface MessagePayloadAct {
-    act: MessageActionOptions;
+export type MessageActionBaseOptions = "actNotification" | 'actInfo' | "actMarco" | "actRemoveCurrentTab" | "actFocusTargetTab" | "actReloadTargetTab";
+export interface MessagePayloadAction {
+    act: MessageActionBaseOptions;
 }
-export interface MessagePayloadTargetTab extends MessagePayloadAct {
+export interface MessagePayloadNotification extends MessagePayloadAction {
+    content: string;
+    title?: string;
+}
+export interface MessagePayloadInfo extends MessagePayloadAction {
+    info: string;
+}
+export interface MessagePayloadTargetTab extends MessagePayloadAction {
     targetTabId: number;
 }
 export type MessagePayloadFocusTargetTab = MessagePayloadTargetTab;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAA;AAGxB,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,oBAAoB,CAAA;CAC1B;AAED,MAAM,WAAW,uBAAwB,SAAQ,iBAAiB;IAChE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AACnE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,wBAAwB,GAChC,iBAAiB,GACjB,SAAS,GACT,UAAU,GACV,qBAAqB,GACrB,mBAAmB,GACnB,oBAAoB,CAAA;AAExB,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,wBAAwB,CAAA;CAC9B;AAED,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,oBAAoB;IACnE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AACnE,MAAM,MAAM,6BAA6B,GAAG,uBAAuB,CAAC"}

package/package.json

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

package/dist/ContentJsYTB.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"ContentJsYTB.d.ts","sourceRoot":"","sources":["../src/ContentJsYTB.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,iCAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,GAAE,MAAc,GAAG,IAAI,CAmCvG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAOvE;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,wBAAwB,kBAE7C;AAED,wBAAsB,uBAAuB,kBAE5C;AAED,wBAAsB,sBAAsB,kBAE3C;AAGD;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKpE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAW,EAAE,SAAS,UAAQ,QAUhE;AAED,wBAAsB,YAAY,kBAKjC;AAED,wBAAsB,kBAAkB,CAAC,WAAW,EAAE,MAAM,iBAM3D;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE,MAAM,iBAEzD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBtF;AAED,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,iBAE7C;AAED,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,iBAExD;AAED,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,QAKnD"}