@vacantthinker/firefox-addon-framework-easy 2026.605.843 → 2026.605.958

package/README.md

@@ -26,15 +26,15 @@ export class BaseORM {  }
 ### 📄 File: `src/browserDownload.js`
 ```javascript
 export async function browserDownloadByDownlink(
-    {  }
+  {  }
 
 ```
 
 ### 📄 File: `src/browserNotification.js`
 ```javascript
 export async function browserNotificationCreate(
-    content,
-    title = browserRuntimeManifestName(),
+  content,
+  title = browserRuntimeManifestName(),
 ) {  }
 
 ```
@@ -44,7 +44,7 @@ export async function browserNotificationCreate(
 export function browserRuntimeReload() {  }
 
 export async function browserRuntimeSetUninstallURL(
-    url = '',
+  url = '',
 ) {  }
 
 export function browserRuntimeOnUpdateAvailable(doWhat = null) {  }
@@ -62,13 +62,13 @@ export function browserRuntimeManifestName() {  }
 ### 📄 File: `src/browserRuntimeOnMessageCommon.js`
 ```javascript
 export function browserRuntimeOnMessageCommon(
-    act,
-    message,
-    sendResponse
+  act,
+  message,
+  sendResponse
 ) {  }
 
 export function browserRuntimeOnMessageMerge(
-    message, sender
+  message, sender
 ) {  }
 
 ```
@@ -96,8 +96,8 @@ export class DomainORM extends BaseORM {  }
 ### 📄 File: `src/generate.js`
 ```javascript
 export function generateHtmlByUserSettings(
-    userSettings,
-    radioItemClickCallback,
+  userSettings,
+  radioItemClickCallback,
 ) {  }
 
 export function generateMkvScriptForSystemWindows({  }
@@ -171,8 +171,8 @@ export async function serviceDownloadByDownlink(message) {  }
 ### 📄 File: `src/serviceFetch.js`
 ```javascript
 export async function servicePostJson(
-    serverUrl,
-    message,
+  serverUrl,
+  message,
 ) {  }
 
 export async function serviceSendDataToLocalAria2(message) {  }
@@ -202,7 +202,7 @@ export function serviceRemoveIllegalWord(value) {  }
 ### 📄 File: `src/serviceOpJavascript.js`
 ```javascript
 export async function serviceTakeScreenshot(
-    {  }
+  {  }
 
 export async function serviceElementPicker(message) {  }
 

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0605.0843",
+  "version": "2026.0605.0958",
   "description": "",
   "main": "index.js",
   "publishConfig": {
     "access": "public",
     "provenance": true
   },
-  "scripts": {},
+  "scripts": {
+    "install_package": "npm install"
+  },
   "author": "VacantThinker",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -20,5 +22,23 @@
   },
   "dependencies": {
     "@types/firefox-webext-browser": "^143.0.0"
+  },
+  "devDependencies": {
+    "prettier": "3.8.3",
+    "prettier-plugin-jsdoc": "1.8.1"
+  },
+  "prettier": {
+    "semi": true,
+    "singleQuote": true,
+    "tabWidth": 2,
+    "useTabs": false,
+    "printWidth": 80,
+    "plugins": [
+      "prettier-plugin-jsdoc"
+    ],
+    "jsdocVerticalizeParams": true,
+    "jsdocLineWrappingStyle": "balance",
+    "jsdocPreferToKeepShortOnOneLine": false,
+    "jsdocKeepUnpublished": false
   }
 }

package/src/BaseORM.js

@@ -19,7 +19,7 @@ export class BaseORM {
   constructor(prefix, id, defaultValue = {}) {
     if (new.target === BaseORM) {
       throw new TypeError(
-          'Cannot construct BaseORM instances directly (Abstract Class).');
+        'Cannot construct BaseORM instances directly (Abstract Class).');
     }
     if (!prefix || !id) {
       throw new Error('Both prefix and id must be specified.');

package/src/browserDownload.js

@@ -6,10 +6,10 @@
  * @returns {Promise<void>}
  */
 export async function browserDownloadByDownlink(
-    {
-      downlink,
-      filename = null,
-    }) {
+  {
+    downlink,
+    filename = null,
+  }) {
 
   let url = downlink;
   let options = {url};

package/src/browserNotification.js

@@ -7,8 +7,8 @@ import {browserRuntimeManifestName} from './browserRuntime.js';
  * @returns {Promise<string>}
  */
 export async function browserNotificationCreate(
-    content,
-    title = browserRuntimeManifestName(),
+  content,
+  title = browserRuntimeManifestName(),
 ) {
 
   const tag = 'browserNotificationCreate';

package/src/browserRuntime.js

@@ -7,7 +7,7 @@ export function browserRuntimeReload() {
  * @param url{string}
  */
 export async function browserRuntimeSetUninstallURL(
-    url = '',
+  url = '',
 ) {
   await browser.runtime.setUninstallURL(url);
 }

package/src/browserRuntimeOnMessageCommon.js

@@ -7,7 +7,7 @@ import {browserNotificationCreate} from './browserNotification.js';
  * offer common act <=> function, eg: actRemoveTab, actLog
  *
  * @param act{
- *          'actLog'
+ *          |'actLog'
  *          |'actRequestTabIdTabUrl'
  *          |'actNotification'
  *          |'actRemoveTab'
@@ -18,9 +18,9 @@ import {browserNotificationCreate} from './browserNotification.js';
  * @param sendResponse
  */
 export function browserRuntimeOnMessageCommon(
-    act,
-    message,
-    sendResponse
+  act,
+  message,
+  sendResponse
 ) {
   switch (act) {
     case 'actLog':
@@ -50,7 +50,7 @@ export function browserRuntimeOnMessageCommon(
  * @param message
  * @param sender
  * @returns {
- *          'actLog'
+ *          |'actLog'
  *          |'actRequestTabIdTabUrl'
  *          |'actNotification'
  *          |'actRemoveTab'
@@ -59,7 +59,7 @@ export function browserRuntimeOnMessageCommon(
  * }
  */
 export function browserRuntimeOnMessageMerge(
-    message, sender
+  message, sender
 ) {
   let keyAct = 'act';
   let act = message[keyAct];

package/src/browserTab.js

@@ -10,13 +10,13 @@ export async function browserTabSendMessage(tabId, message) {
 export function browserTabWaitReloadThenSendMessageToContentJs(message) {
   let tabId = message.tabId;
   browser.tabs.onUpdated.addListener(
-      async function lis(tabId, changeInfo) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          await browserTabSendMessage(tabId, message);
-        }
+    async function lis(tabId, changeInfo) {
+      if (changeInfo.status === 'complete') {
+        browser.tabs.onUpdated.removeListener(lis);
+        await browserTabSendMessage(tabId, message);
       }
-      , {tabId, properties: ['status']});
+    }
+    , {tabId, properties: ['status']});
 }
 
 /**
@@ -41,14 +41,14 @@ export async function browserTabCreateToDownload(message) {
 
   let {tabId} = await tabOpCreateNear(properties);
   browser.tabs.onUpdated.addListener(
-      async function lis(tabId, changeInfo) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          // todo code here
-          await tabOpRemove(tabId);
-        }
+    async function lis(tabId, changeInfo) {
+      if (changeInfo.status === 'complete') {
+        browser.tabs.onUpdated.removeListener(lis);
+        // todo code here
+        await tabOpRemove(tabId);
       }
-      , {tabId, properties: ['status']});
+    }
+    , {tabId, properties: ['status']});
 }
 
 /**
@@ -73,15 +73,15 @@ export async function browserTabCreateNearSendMessageToContentJs(message) {
 
   let {tabId} = await tabOpCreateNear(properties);
   browser.tabs.onUpdated.addListener(
-      async function lis(tabId, changeInfo) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          // todo code here
-          await browserTabSendMessage(
-              tabId, Object.assign({}, message, {tabId}));
-        }
+    async function lis(tabId, changeInfo) {
+      if (changeInfo.status === 'complete') {
+        browser.tabs.onUpdated.removeListener(lis);
+        // todo code here
+        await browserTabSendMessage(
+          tabId, Object.assign({}, message, {tabId}));
       }
-      , {tabId, properties: ['status']});
+    }
+    , {tabId, properties: ['status']});
 }
 
 /**
@@ -91,13 +91,13 @@ export async function browserTabCreateNearSendMessageToContentJs(message) {
  */
 export function browserTabWaitReloadThenRemoveIt({tabId}) {
   browser.tabs.onUpdated.addListener(
-      async function lis(tabId, changeInfo) {
-        if (changeInfo.status === 'complete') {
-          browser.tabs.onUpdated.removeListener(lis);
-          // todo code here
-          await tabOpRemove(tabId);
-        }
+    async function lis(tabId, changeInfo) {
+      if (changeInfo.status === 'complete') {
+        browser.tabs.onUpdated.removeListener(lis);
+        // todo code here
+        await tabOpRemove(tabId);
       }
-      , {tabId, properties: ['status']});
+    }
+    , {tabId, properties: ['status']});
 
 }

package/src/generate.js

@@ -8,8 +8,8 @@ import {stoOpGet, stoOpSet} from './opStorage.js';
  * @returns {HTMLFieldSetElement[]}
  */
 export function generateHtmlByUserSettings(
-    userSettings,
-    radioItemClickCallback,
+  userSettings,
+  radioItemClickCallback,
 ) {
   // Keeps track of all generated fieldsets by their storageKey
   const elementsMap = {};
@@ -56,7 +56,7 @@ export function generateHtmlByUserSettings(
 
           eleInput.addEventListener('change', async () => {
             const optionsCurrent = await stoOpGet(storageKey) ||
-                storageValue.selected || [];
+              storageValue.selected || [];
             const set = new Set(Array.from(optionsCurrent));
 
             if (eleInput.checked) {
@@ -76,8 +76,8 @@ export function generateHtmlByUserSettings(
         else if (type === 'radio') {
           stoOpGet(storageKey).then((v) => {
             const currentSelected = (v !== undefined && v !== null) ?
-                v :
-                storageValue.selected;
+              v :
+              storageValue.selected;
             if (option === currentSelected) {
               eleInput.checked = true;
             }
@@ -86,7 +86,7 @@ export function generateHtmlByUserSettings(
             triggerVisibility(storageKey, currentSelected);
           });
 
-          eleLabel.onclick = function() {
+          eleLabel.onclick = function () {
             stoOpSet(storageKey, option).then(() => {
               if (typeof radioItemClickCallback === 'function') {
                 radioItemClickCallback(storageKey, option);
@@ -111,8 +111,8 @@ export function generateHtmlByUserSettings(
       stoOpGet(storageKey).then((v) => {
         // Fallback to default schema configuration if no value is stored yet
         let currentStatus = (v !== undefined && v !== null) ?
-            (v === true || v === 'true') :
-            storageValue.selected;
+          (v === true || v === 'true') :
+          storageValue.selected;
         eleButton.textContent = String(currentStatus);
 
         // Initial visibility evaluation
@@ -139,8 +139,8 @@ export function generateHtmlByUserSettings(
 
       stoOpGet(storageKey).then((v) => {
         const currentVal = (v !== undefined && v !== null) ?
-            v :
-            storageValue.selected;
+          v :
+          storageValue.selected;
         eleInput.value = currentVal;
 
         // Initial visibility evaluation
@@ -162,7 +162,7 @@ export function generateHtmlByUserSettings(
     }
 
     // --- CONDITION 4: SPAN / READ-ONLY TEXT ---
-    else if (type === 'span' ) {
+    else if (type === 'span') {
       const eleSpan = document.createElement('span');
       // Optional: Add a class for styling read-only text differently
       // eleSpan.className = 'read-only-text';
@@ -170,8 +170,8 @@ export function generateHtmlByUserSettings(
       stoOpGet(storageKey).then((v) => {
         // Fallback to default schema configuration if no value is stored yet
         const currentVal = (v !== undefined && v !== null) ?
-            v :
-            storageValue.selected;
+          v :
+          storageValue.selected;
 
         // Render as plain text
         eleSpan.textContent = String(currentVal);

package/src/opTab.js

@@ -120,7 +120,7 @@ export async function tabOpReload(tabId) {
  * @returns {Promise<void>}
  */
 export async function tabOpRemove(tabId) {
-    await browser.tabs.remove(tabId);
+  await browser.tabs.remove(tabId);
 }
 
 /**

package/src/serviceFetch.js

@@ -5,8 +5,8 @@
  * @returns {Promise<Response>}
  */
 export async function servicePostJson(
-    serverUrl,
-    message,
+  serverUrl,
+  message,
 ) {
 
   let body = JSON.stringify(message);

package/src/serviceOpContent.js

@@ -1,8 +1,5 @@
 import {browserRuntimePlatformInfo} from './browserRuntime.js';
-import {
-  generateMkvScriptForSystemFedora,
-  generateMkvScriptForSystemWindows,
-} from './generate.js';
+import {generateMkvScriptForSystemFedora, generateMkvScriptForSystemWindows,} from './generate.js';
 
 /**
  *
@@ -22,23 +19,23 @@ export async function serviceCopyContentToClipboard(data) {
 export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
   const eleBtn = document.createElement('button');
   eleBtn.addEventListener(
-      'click',
-      function() {
-        const eleA = document.createElement('a');
+    'click',
+    function () {
+      const eleA = document.createElement('a');
 
-        const extObj = {
-          txt: 'text/plain',
-          json: 'application/json',
-        };
-        const type = extObj[ext];
+      const extObj = {
+        txt: 'text/plain',
+        json: 'application/json',
+      };
+      const type = extObj[ext];
 
-        const file = new Blob([content], {type});
-        eleA.href = URL.createObjectURL(file);
-        eleA.download = [filename, ext].join('.');
-        eleA.click();
-        URL.revokeObjectURL(eleA.href);
-      },
-      false,
+      const file = new Blob([content], {type});
+      eleA.href = URL.createObjectURL(file);
+      eleA.download = [filename, ext].join('.');
+      eleA.click();
+      URL.revokeObjectURL(eleA.href);
+    },
+    false,
   );
   eleBtn.click();
   // eleBtn.previousElementSibling
@@ -65,31 +62,19 @@ export async function serviceGenerateMkvToolNixScript({vid, title}) {
 }
 
 /**
- * 终极清理函数：过滤所有中英文标点、全角符号、以及非法/不可见字符。
- * （100% 预防下载报错和复制粘贴导致的乱码）
- * @param {string} value - 原始视频标题
- * @returns {string} - 干净、安全的纯文本/字母数字文件名
+ * @param {string} value -
+ * @returns {string} -
  */
 export function serviceRemoveIllegalWord(value) {
   if (!value) return '';
 
-  // 1. 获取第一行并去除两端空格
   let name = value.trim().split(/\r?\n/).shift();
 
-  // 2. 使用 Unicode 属性移除所有危险字符：
-  // \p{P} = 所有标点符号
-  // \p{S} = 所有符号（Emoji、数学符号、货币符号）
-  // \p{C} = 所有控制/格式化/代理字符（完美修复不可见的 U+202A/U+202C 导致崩溃的 Bug！）
   name = name.replace(/[\p{P}\p{S}\p{C}]/gu, ' ');
 
-  // 3. Firefox WebExtension 严格拦截的特殊字符。
-  // （大部分已经被 \p{P} 和 \p{S} 处理，但显式移除可以确保彻底杜绝边缘报错）
   name = name.replace(/[~"#%&*:<>?/\\{|}]/g, ' ');
 
-  // 4. 将连续的空格（包括全角/Unicode空格）合并为一个标准空格
   name = name.replace(/[\s\u3000]+/g, ' ').trim();
 
-  // 5. Firefox 下载 API 会因为文件名以点（.）或连字符（-）开头/结尾而报错
-  // 再次修剪以确保绝对安全
   return name.replace(/^[-.]+|[-.]+$/g, '');
 }

package/src/serviceOpJavascript.js

@@ -20,24 +20,24 @@ import {browserNotificationCreate} from './browserNotification.js';
  * @returns {Promise<void>}
  */
 export async function serviceTakeScreenshot(
-    {
-      tabId,
-      filename,
-      rect,
-    }) {
+  {
+    tabId,
+    filename,
+    rect,
+  }) {
 
   const tag = 'actTakeScreenshot()';
   let dataURI = await browser.tabs.captureTab(tabId, {
     rect: rect,
   });
   let assign = Object.assign(
-      {},
-      {dataURI, filename},
+    {},
+    {dataURI, filename},
   );
   await browser.scripting.executeScript({
     target: {tabId},
     args: [assign],
-    func: function(message) {
+    func: function (message) {
       if (message) {
         let {dataURI, filename} = message;
 
@@ -70,7 +70,7 @@ export async function serviceElementPicker(message) {
   await browser.scripting.executeScript({
     target: {tabId},
     args: [message],
-    func: async function(message) {
+    func: async function (message) {
       if (!message) return;
       console.log('picker.js initialized', message);
 
@@ -137,9 +137,9 @@ export async function serviceElementPicker(message) {
         overlay.style.setProperty('top', `${clientRect.top}px`, 'important');
         overlay.style.setProperty('left', `${clientRect.left}px`, 'important');
         overlay.style.setProperty('width', `${clientRect.width}px`,
-            'important');
+          'important');
         overlay.style.setProperty('height', `${clientRect.height}px`,
-            'important');
+          'important');
 
         // Change mouse cursor to indicate picking mode
         document.body.style.setProperty('cursor', 'crosshair', 'important');
@@ -165,13 +165,13 @@ export async function serviceElementPicker(message) {
 
         // Assuming 'target' is your clicked element (e.g., from e.target)
         let messageTakeScreenshot = Object.assign(
-            {}, // Start with a fresh, empty object
-            message, // Put the original message first so it doesn't overwrite your new data
-            {rect},
-            {
-              // The guaranteed unique CSS path (e.g., "div#wrap > ul > li:nth-of-type(2)")
-              uniqueSelector: getUniqueSelector(target),
-            },
+          {}, // Start with a fresh, empty object
+          message, // Put the original message first so it doesn't overwrite your new data
+          {rect},
+          {
+            // The guaranteed unique CSS path (e.g., "div#wrap > ul > li:nth-of-type(2)")
+            uniqueSelector: getUniqueSelector(target),
+          },
         );
 
         await browser.runtime.sendMessage(messageTakeScreenshot);
@@ -225,9 +225,9 @@ export async function serviceGetFullPageRectData(message) {
         x, y, width, height,
       };
       browser.runtime.sendMessage(Object.assign(
-          {},
-          message,
-          {rect},
+        {},
+        message,
+        {rect},
       ));
       // todo end if (message)
     },
@@ -275,7 +275,7 @@ export async function serviceFindAllMagnetLink(message) {
           // --- Type 2: Find inside raw text (for <div>, <span>, <td>, etc.) ---
           // We target elements that don't have children to avoid grabbing huge parent container blocks
           const allElements = document.querySelectorAll(
-              'div, span, td, p, a, button');
+            'div, span, td, p, a, button');
           allElements.forEach(el => {
             if (el.children.length === 0) { // Deepest element
               const text = el.textContent.trim();
@@ -293,11 +293,11 @@ export async function serviceFindAllMagnetLink(message) {
         }
 
         await browser.runtime.sendMessage(Object.assign(
-            {},
-            message,
-            {
-              data: findAllMagnetLinks(),
-            },
+          {},
+          message,
+          {
+            data: findAllMagnetLinks(),
+          },
         ));
 
         // todo end if(message)

package/src/serviceUpdateTabStyle.js

@@ -31,9 +31,9 @@ export async function serviceUpdataALLTextNodeColor(message) {
          */
         function nativeTreeWalkerFindALLElementHasNodeText() {
           const walker = document.createTreeWalker(
-              document.body,
-              NodeFilter.SHOW_TEXT,
-              null,
+            document.body,
+            NodeFilter.SHOW_TEXT,
+            null,
           );
 
           let node;
@@ -96,9 +96,9 @@ export async function serviceUpdataALLNodeBackgroundColor(message) {
          */
         function nativeTreeWalker() {
           const walker = document.createTreeWalker(
-              document.body,
-              NodeFilter.SHOW_ELEMENT,
-              null,
+            document.body,
+            NodeFilter.SHOW_ELEMENT,
+            null,
           );
 
           let node;

package/src/serviceUserSettings.js

@@ -7,15 +7,15 @@ import {stoOpGet, stoOpSet} from './opStorage.js';
  */
 export async function serviceInitUserSettings(userSettings) {
   const initPromises = Object.entries(userSettings)
-      .map(async ([key, setting]) => {
-        const oldValue = await stoOpGet(key);
-
-        // FIX: Check strictly for null or undefined.
-        // This allows `false` and `0` to be recognized as valid saved values.
-        if (oldValue === null || oldValue === undefined) {
-          await stoOpSet(key, setting.selected);
-        }
-      });
+    .map(async ([key, setting]) => {
+      const oldValue = await stoOpGet(key);
+
+      // FIX: Check strictly for null or undefined.
+      // This allows `false` and `0` to be recognized as valid saved values.
+      if (oldValue === null || oldValue === undefined) {
+        await stoOpSet(key, setting.selected);
+      }
+    });
 
   await Promise.all(initPromises);
 }