@vacantthinker/firefox-addon-framework-easy 2026.606.751 → 2026.606.1403

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) {  }
@@ -61,11 +61,7 @@ export function browserRuntimeManifestName() {  }
 
 ### 📄 File: `src/browserRuntimeOnMessageCommon.js`
 ```javascript
-export function browserRuntimeOnMessageCommon(
-  act,
-  message,
-  sendResponse
-) {  }
+export function browserRuntimeOnMessageCommon(act, message, sendResponse) {  }
 
 ```
 
@@ -92,8 +88,8 @@ export class DomainORM extends BaseORM {  }
 ### 📄 File: `src/generate.js`
 ```javascript
 export async function generateHtmlByUserSettings(
-	userSettings,
-	radioItemClickCallback
+    userSettings,
+    radioItemClickCallback,
 ) {  }
 
 export function generateMkvScriptForSystemWindows({  }
@@ -167,8 +163,8 @@ export async function serviceDownloadByDownlink(message) {  }
 ### 📄 File: `src/serviceFetch.js`
 ```javascript
 export async function servicePostJson(
-  serverUrl,
-  message,
+    serverUrl,
+    message,
 ) {  }
 
 export async function serviceSendDataToLocalAria2(message) {  }
@@ -187,7 +183,7 @@ export function serviceGetCurrentDateYYYYMMDDHHMMSS() {  }
 ```javascript
 export async function serviceCopyContentToClipboard(data) {  }
 
-export function serviceSaveContentToLocal(content, filename, ext = "txt") {  }
+export function serviceSaveContentToLocal(content, filename, ext = 'txt') {  }
 
 export async function serviceGenerateMkvToolNixScript({  }
 
@@ -198,7 +194,7 @@ export function serviceRemoveIllegalWord(value) {  }
 ### 📄 File: `src/serviceOpJavascript.js`
 ```javascript
 export async function serviceTakeScreenshot(
-  {  }
+    {  }
 
 export async function serviceElementPicker(message) {  }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0606.0751",
+  "version": "2026.0606.1403",
   "description": "",
   "main": "index.js",
   "publishConfig": {
@@ -22,9 +22,5 @@
   },
   "dependencies": {
     "@types/firefox-webext-browser": "^143.0.0"
-  },
-  "devDependencies": {
-    "prettier": "^3.8.3",
-    "prettier-plugin-jsdoc": "^1.8.1"
   }
 }

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,18 +6,18 @@
  * @returns {Promise<void>}
  */
 export async function browserDownloadByDownlink(
-  {
-    downlink,
-    filename = null,
-  }) {
-		let url = downlink;
-		/** @type {browser.downloads._DownloadOptions} */
-		let options = {
-			url,
-			saveAs: false
-		};
-		if (filename) {
-			Object.assign(options, { filename });
-		}
-		await browser.downloads.download(options);
-	}
+    {
+      downlink,
+      filename = null,
+    }) {
+  let url = downlink;
+  /** @type {browser.downloads._DownloadOptions} */
+  let options = {
+    url,
+    saveAs: false,
+  };
+  if (filename) {
+    Object.assign(options, {filename});
+  }
+  await browser.downloads.download(options);
+}

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

@@ -4,34 +4,35 @@ import {browserTabSendMessage} from './browserTab.js';
 import {browserNotificationCreate} from './browserNotification.js';
 
 /**
- * offer common act <=> function, eg: actRemoveTab, actLog
+ * Offer common act <=> function
  *
  * @param act{
- *          |'actLog'
- *          |'actRequestTabIdTabUrl'
- *          |'actNotification'
- *          |'actRemoveTab'
- *          |'actDownloadFile'
- *          |'actSendMessageToTab'
- * }
+ *   |'actLog'
+ *   |'actMarco'
+ *   |'actRequestTabIdTabUrl'
+ *   |'actNotification'
+ *   |'actRemoveTab'
+ *   |'actDownloadFile'
+ *   |'actSendMessageToTab'
+ *   }
  * @param message
  * @param sendResponse
  */
-export function browserRuntimeOnMessageCommon(
-  act,
-  message,
-  sendResponse
-) {
+export function browserRuntimeOnMessageCommon(act, message, sendResponse) {
   switch (act) {
     case 'actLog':
       console.log('act', act, 'message', message);
       break;
+    case 'actMarco': //Marco Polo pool game
+      sendResponse({status: 'Polo'});
+      return true;
+      break;
     case 'actRequestTabIdTabUrl':
       sendResponse(message);
-      break
+      break;
     case 'actNotification':
-      browserNotificationCreate(message.content)
-      break
+      browserNotificationCreate(message.content);
+      break;
     case 'actRemoveTab':
       tabOpRemove(message.tabId);
       break;
@@ -42,5 +43,4 @@ export function browserRuntimeOnMessageCommon(
       browserTabSendMessage(message.tabId, message);
       break;
   }
-
 }

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

@@ -1,12 +1,12 @@
-import { stoOpGet, stoOpSet } from "./opStorage.js";
+import {stoOpGet, stoOpSet} from './opStorage.js';
 
 // [Optimization 1] Introduce a debounce function to prevent triggering storage writes on every keystroke.
 function debounce(func, wait) {
-	let timeout;
-	return function (...args) {
-		clearTimeout(timeout);
-		timeout = setTimeout(() => func.apply(this, args), wait);
-	};
+  let timeout;
+  return function(...args) {
+    clearTimeout(timeout);
+    timeout = setTimeout(() => func.apply(this, args), wait);
+  };
 }
 
 /**
@@ -17,187 +17,188 @@ function debounce(func, wait) {
  * @returns {Promise<DocumentFragment>}
  */
 export async function generateHtmlByUserSettings(
-	userSettings,
-	radioItemClickCallback
+    userSettings,
+    radioItemClickCallback,
 ) {
-	const elementsMap = {};
-
-	// [Optimization 2] Use a DocumentFragment for off-screen DOM construction to improve rendering performance.
-	const fragment = document.createDocumentFragment();
-
-	const keys = Object.keys(userSettings);
-
-	// [Optimization 3] Batch fetch all stored values.
-	// Wait for all queries to complete to prevent async callbacks from interrupting the rendering pipeline.
-	const valuesArray = await Promise.all(keys.map((key) => stoOpGet(key)));
-	const storageData = {};
-	keys.forEach((key, index) => {
-		storageData[key] = valuesArray[index];
-	});
-
-	// First pass: Pre-create all container wrappers.
-	// This ensures all target elements exist in the DOM references before executing triggerVisibility later.
-	keys.forEach((storageKey) => {
-		const eleWrap = document.createElement("fieldset");
-		const eleTitle = document.createElement("legend");
-		eleTitle.textContent = storageKey;
-		eleWrap.append(eleTitle);
-
-		elementsMap[storageKey] = eleWrap;
-		fragment.append(eleWrap);
-	});
-
-	// Second pass: Synchronously populate form content and attach event listeners.
-	keys.forEach((storageKey) => {
-		const storageValue = userSettings[storageKey];
-		const type = storageValue.type || "text";
-		const eleWrap = elementsMap[storageKey];
-
-		// Retrieve pre-loaded value; fallback to the schema's default value if undefined.
-		const storedValue = storageData[storageKey];
-		const initialValue =
-			storedValue !== undefined && storedValue !== null
-				? storedValue
-				: storageValue.selected;
-
-		// --- CONDITION 1: CHECKBOX & RADIO ---
-		if (type === "checkbox" || type === "radio") {
-			/** @type {string[]} */
-			const options = storageValue.options || [];
-
-			options.forEach((option) => {
-				const eleLabel = document.createElement("label");
-				eleLabel.textContent = option;
-				const eleInput = document.createElement("input");
-				eleInput.name = storageKey;
-				eleInput.type = type;
-				eleInput.value = option;
-
-				if (type === "checkbox") {
-					const initialArray = Array.from(initialValue || []);
-					const set = new Set(initialArray);
-					eleInput.checked = set.has(option); // Apply state synchronously
-
-					eleInput.addEventListener("change", async () => {
-						// Derive state in real-time from the DOM (faster than reading from storage again)
-						const allCheckboxes = eleWrap.querySelectorAll(
-							'input[type="checkbox"]'
-						);
-						const valueNew = Array.from(allCheckboxes)
-							.filter((cb) => cb.checked)
-							.map((cb) => cb.value);
-
-						await stoOpSet(storageKey, valueNew);
-						triggerVisibility(storageKey, valueNew);
-					});
-				} else if (type === "radio") {
-					if (option === initialValue) {
-						eleInput.checked = true; // Apply state synchronously
-					}
-
-					// It is recommended to bind the 'change' event to the input rather than 'onclick' to the label
-					eleInput.addEventListener("change", () => {
-						stoOpSet(storageKey, option).then(() => {
-							if (typeof radioItemClickCallback === "function") {
-								radioItemClickCallback(storageKey, option);
-							}
-							triggerVisibility(storageKey, option);
-						});
-					});
-				}
-
-				// Fix: Native HTML typically places the input element before the text node inside a label.
-				eleLabel.prepend(eleInput);
-				eleWrap.append(eleLabel);
-			});
-		}
-
-		// --- CONDITION 2: TOGGLE BUTTON ---
-		else if (type === "button") {
-			const eleButton = document.createElement("button");
-			eleButton.type = "button";
-
-			let currentStatus = initialValue === true || initialValue === "true";
-			eleButton.textContent = String(currentStatus); // Apply state synchronously
-
-			eleButton.addEventListener("click", async () => {
-				currentStatus = !currentStatus;
-				eleButton.textContent = String(currentStatus);
-				await stoOpSet(storageKey, currentStatus);
-				triggerVisibility(storageKey, currentStatus);
-			});
-
-			eleWrap.append(eleButton);
-		}
-
-		// --- CONDITION 3: NUMBER & TEXT INPUTS ---
-		else if (type === "number" || type === "text") {
-			const eleInput = document.createElement("input");
-			eleInput.type = type;
-			eleInput.name = storageKey;
-			eleInput.value = initialValue !== undefined ? initialValue : ""; // Apply state synchronously
-
-			// [Optimization 4] Wrap the write operation with debounce, delaying storage writes by 500ms.
-			// This eliminates UI freezing regardless of typing speed.
-			const debouncedSave = debounce(async (val) => {
-				const finalizedValue = type === "number" ? Number(val) : val;
-				await stoOpSet(storageKey, finalizedValue);
-			}, 500);
-
-			eleInput.addEventListener("input", () => {
-				const rawValue = eleInput.value;
-				debouncedSave(rawValue);
-				triggerVisibility(storageKey, rawValue); // Visual UI updates do not require a delay
-			});
-
-			eleWrap.append(eleInput);
-		}
-
-		// --- CONDITION 4: SPAN / READ-ONLY TEXT ---
-		else if (type === "span") {
-			const eleSpan = document.createElement("span");
-			eleSpan.textContent = String(initialValue); // Apply state synchronously
-			eleWrap.append(eleSpan);
-		}
-	});
-
-	// [Optimization 5] Third pass: Globally trigger a single visibility check.
-	// At this point, all DOM elements exist and all initialValues are fully derived,
-	// preventing undefined errors or invalid target hiding.
-	keys.forEach((storageKey) => {
-		const storedValue = storageData[storageKey];
-		const initialValue =
-			storedValue !== undefined && storedValue !== null
-				? storedValue
-				: userSettings[storageKey].selected;
-
-		triggerVisibility(storageKey, initialValue);
-	});
-
-	/**
-	 * Evaluates the visibility rules for a given source key based on its current
-	 * value.
-	 */
-	function triggerVisibility(sourceKey, currentValue) {
-		const config = userSettings[sourceKey];
-		if (config && config.visibilityControl) {
-			const { targetField, expectedValue } = config.visibilityControl;
-			const targetElement = elementsMap[targetField];
-
-			if (targetElement) {
-				const shouldBeVisible = String(currentValue) === String(expectedValue);
-				targetElement.style.display = shouldBeVisible ? "" : "none";
-			}
-		}
-	}
-
-	return fragment;
+  const elementsMap = {};
+
+  // [Optimization 2] Use a DocumentFragment for off-screen DOM construction to improve rendering performance.
+  const fragment = document.createDocumentFragment();
+
+  const keys = Object.keys(userSettings);
+
+  // [Optimization 3] Batch fetch all stored values.
+  // Wait for all queries to complete to prevent async callbacks from interrupting the rendering pipeline.
+  const valuesArray = await Promise.all(keys.map((key) => stoOpGet(key)));
+  const storageData = {};
+  keys.forEach((key, index) => {
+    storageData[key] = valuesArray[index];
+  });
+
+  // First pass: Pre-create all container wrappers.
+  // This ensures all target elements exist in the DOM references before executing triggerVisibility later.
+  keys.forEach((storageKey) => {
+    const eleWrap = document.createElement('fieldset');
+    const eleTitle = document.createElement('legend');
+    eleTitle.textContent = storageKey;
+    eleWrap.append(eleTitle);
+
+    elementsMap[storageKey] = eleWrap;
+    fragment.append(eleWrap);
+  });
+
+  // Second pass: Synchronously populate form content and attach event listeners.
+  keys.forEach((storageKey) => {
+    const storageValue = userSettings[storageKey];
+    const type = storageValue.type || 'text';
+    const eleWrap = elementsMap[storageKey];
+
+    // Retrieve pre-loaded value; fallback to the schema's default value if undefined.
+    const storedValue = storageData[storageKey];
+    const initialValue =
+        storedValue !== undefined && storedValue !== null
+            ? storedValue
+            : storageValue.selected;
+
+    // --- CONDITION 1: CHECKBOX & RADIO ---
+    if (type === 'checkbox' || type === 'radio') {
+      /** @type {string[]} */
+      const options = storageValue.options || [];
+
+      options.forEach((option) => {
+        const eleLabel = document.createElement('label');
+        eleLabel.textContent = option;
+        const eleInput = document.createElement('input');
+        eleInput.name = storageKey;
+        eleInput.type = type;
+        eleInput.value = option;
+
+        if (type === 'checkbox') {
+          const initialArray = Array.from(initialValue || []);
+          const set = new Set(initialArray);
+          eleInput.checked = set.has(option); // Apply state synchronously
+
+          eleInput.addEventListener('change', async () => {
+            // Derive state in real-time from the DOM (faster than reading from storage again)
+            const allCheckboxes = eleWrap.querySelectorAll(
+                'input[type="checkbox"]',
+            );
+            const valueNew = Array.from(allCheckboxes).
+                filter((cb) => cb.checked).
+                map((cb) => cb.value);
+
+            await stoOpSet(storageKey, valueNew);
+            triggerVisibility(storageKey, valueNew);
+          });
+        }
+        else if (type === 'radio') {
+          if (option === initialValue) {
+            eleInput.checked = true; // Apply state synchronously
+          }
+
+          // It is recommended to bind the 'change' event to the input rather than 'onclick' to the label
+          eleInput.addEventListener('change', () => {
+            stoOpSet(storageKey, option).then(() => {
+              if (typeof radioItemClickCallback === 'function') {
+                radioItemClickCallback(storageKey, option);
+              }
+              triggerVisibility(storageKey, option);
+            });
+          });
+        }
+
+        // Fix: Native HTML typically places the input element before the text node inside a label.
+        eleLabel.prepend(eleInput);
+        eleWrap.append(eleLabel);
+      });
+    }
+
+    // --- CONDITION 2: TOGGLE BUTTON ---
+    else if (type === 'button') {
+      const eleButton = document.createElement('button');
+      eleButton.type = 'button';
+
+      let currentStatus = initialValue === true || initialValue === 'true';
+      eleButton.textContent = String(currentStatus); // Apply state synchronously
+
+      eleButton.addEventListener('click', async () => {
+        currentStatus = !currentStatus;
+        eleButton.textContent = String(currentStatus);
+        await stoOpSet(storageKey, currentStatus);
+        triggerVisibility(storageKey, currentStatus);
+      });
+
+      eleWrap.append(eleButton);
+    }
+
+    // --- CONDITION 3: NUMBER & TEXT INPUTS ---
+    else if (type === 'number' || type === 'text') {
+      const eleInput = document.createElement('input');
+      eleInput.type = type;
+      eleInput.name = storageKey;
+      eleInput.value = initialValue !== undefined ? initialValue : ''; // Apply state synchronously
+
+      // [Optimization 4] Wrap the write operation with debounce, delaying storage writes by 500ms.
+      // This eliminates UI freezing regardless of typing speed.
+      const debouncedSave = debounce(async (val) => {
+        const finalizedValue = type === 'number' ? Number(val) : val;
+        await stoOpSet(storageKey, finalizedValue);
+      }, 500);
+
+      eleInput.addEventListener('input', () => {
+        const rawValue = eleInput.value;
+        debouncedSave(rawValue);
+        triggerVisibility(storageKey, rawValue); // Visual UI updates do not require a delay
+      });
+
+      eleWrap.append(eleInput);
+    }
+
+    // --- CONDITION 4: SPAN / READ-ONLY TEXT ---
+    else if (type === 'span') {
+      const eleSpan = document.createElement('span');
+      eleSpan.textContent = String(initialValue); // Apply state synchronously
+      eleWrap.append(eleSpan);
+    }
+  });
+
+  // [Optimization 5] Third pass: Globally trigger a single visibility check.
+  // At this point, all DOM elements exist and all initialValues are fully derived,
+  // preventing undefined errors or invalid target hiding.
+  keys.forEach((storageKey) => {
+    const storedValue = storageData[storageKey];
+    const initialValue =
+        storedValue !== undefined && storedValue !== null
+            ? storedValue
+            : userSettings[storageKey].selected;
+
+    triggerVisibility(storageKey, initialValue);
+  });
+
+  /**
+   * Evaluates the visibility rules for a given source key based on its current
+   * value.
+   */
+  function triggerVisibility(sourceKey, currentValue) {
+    const config = userSettings[sourceKey];
+    if (config && config.visibilityControl) {
+      const {targetField, expectedValue} = config.visibilityControl;
+      const targetElement = elementsMap[targetField];
+
+      if (targetElement) {
+        const shouldBeVisible = String(currentValue) === String(expectedValue);
+        targetElement.style.display = shouldBeVisible ? '' : 'none';
+      }
+    }
+  }
+
+  return fragment;
 }
 
-export function generateMkvScriptForSystemWindows({ vid, title }) {
-	let args = { vid, title };
+export function generateMkvScriptForSystemWindows({vid, title}) {
+  let args = {vid, title};
 
-	return `if (true) {
+  return `if (true) {
   const path = require('path');
   const fs = require('fs');
   const {execSync, exec} = require('node:child_process');
@@ -282,11 +283,11 @@ export function generateMkvScriptForSystemWindows({ vid, title }) {
   `;
 }
 
-export function generateMkvScriptForSystemFedora({ vid, title }) {
-	let args = { vid, title };
+export function generateMkvScriptForSystemFedora({vid, title}) {
+  let args = {vid, title};
 
-	// We wrap the Node.js script inside a Linux Shell script block
-	return `#!/usr/bin/env bash
+  // We wrap the Node.js script inside a Linux Shell script block
+  return `#!/usr/bin/env bash
 # This header tells Fedora to treat this file as a runnable bash script
 
 # Open a terminal window if not already running inside one

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,15 +1,15 @@
-import { browserRuntimePlatformInfo } from "./browserRuntime.js";
+import {browserRuntimePlatformInfo} from './browserRuntime.js';
 import {
-	generateMkvScriptForSystemFedora,
-	generateMkvScriptForSystemWindows
-} from "./generate.js";
+  generateMkvScriptForSystemFedora,
+  generateMkvScriptForSystemWindows,
+} from './generate.js';
 
 /**
  * @param   data
  * @returns {Promise<void>}
  */
 export async function serviceCopyContentToClipboard(data) {
-	return await window.navigator.clipboard.writeText(data);
+  return await window.navigator.clipboard.writeText(data);
 }
 
 /**
@@ -19,29 +19,29 @@ export async function serviceCopyContentToClipboard(data) {
  * @param {string} filename Eg: abc
  * @param {string} ext      Txt json
  */
-export function serviceSaveContentToLocal(content, filename, ext = "txt") {
-	const eleBtn = document.createElement("button");
-	eleBtn.addEventListener(
-		"click",
-		function () {
-			const eleA = document.createElement("a");
+export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
+  const eleBtn = document.createElement('button');
+  eleBtn.addEventListener(
+      '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
-	);
-	eleBtn.click();
-	// eleBtn.previousElementSibling
+        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
 }
 
 /**
@@ -51,16 +51,17 @@ export function serviceSaveContentToLocal(content, filename, ext = "txt") {
  *   }}
  * @returns {Promise<void>}
  */
-export async function serviceGenerateMkvToolNixScript({ vid, title }) {
-	let message = { vid, title };
-	const platformInfo = await browserRuntimePlatformInfo();
-	if (platformInfo.os === "win") {
-		let content = generateMkvScriptForSystemWindows(message);
-		serviceSaveContentToLocal(content, title, "js");
-	} else if (platformInfo.os === "linux") {
-		let content = generateMkvScriptForSystemFedora(message);
-		serviceSaveContentToLocal(content, title, "sh");
-	}
+export async function serviceGenerateMkvToolNixScript({vid, title}) {
+  let message = {vid, title};
+  const platformInfo = await browserRuntimePlatformInfo();
+  if (platformInfo.os === 'win') {
+    let content = generateMkvScriptForSystemWindows(message);
+    serviceSaveContentToLocal(content, title, 'js');
+  }
+  else if (platformInfo.os === 'linux') {
+    let content = generateMkvScriptForSystemFedora(message);
+    serviceSaveContentToLocal(content, title, 'sh');
+  }
 }
 
 /**
@@ -68,15 +69,15 @@ export async function serviceGenerateMkvToolNixScript({ vid, title }) {
  * @returns {string}       -
  */
 export function serviceRemoveIllegalWord(value) {
-	if (!value) return "";
+  if (!value) return '';
 
-	let name = value.trim().split(/\r?\n/).shift();
+  let name = value.trim().split(/\r?\n/).shift();
 
-	name = name.replace(/[\p{P}\p{S}\p{C}]/gu, " ");
+  name = name.replace(/[\p{P}\p{S}\p{C}]/gu, ' ');
 
-	name = name.replace(/[~"#%&*:<>?/\\{|}]/g, " ");
+  name = name.replace(/[~"#%&*:<>?/\\{|}]/g, ' ');
 
-	name = name.replace(/[\s\u3000]+/g, " ").trim();
+  name = name.replace(/[\s\u3000]+/g, ' ').trim();
 
-	return name.replace(/^[-.]+|[-.]+$/g, "");
+  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,10 +70,10 @@ 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);
-
+      
       // 1. Create a dedicated "Always On Top" highlighter overlay
       const overlayId = 'extension-element-highlighter-overlay';
       let overlay = document.getElementById(overlayId);
@@ -109,7 +109,8 @@ export async function serviceElementPicker(message) {
             selector += '#' + el.id;
             path.unshift(selector);
             break;
-          } else {
+          }
+          else {
             let sib = el, nth = 1;
             while (sib = sib.previousElementSibling) {
               if (sib.nodeName.toLowerCase() === selector) nth++;
@@ -136,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');
@@ -164,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);
@@ -224,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)
     },
@@ -274,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();
@@ -292,11 +293,11 @@ export async function serviceFindAllMagnetLink(message) {
         }
 
         await browser.runtime.sendMessage(Object.assign(
-          {},
-          message,
-          {
-            data: findAllMagnetLinks(),
-          },
+            {},
+            message,
+            {
+              data: findAllMagnetLinks(),
+            },
         ));
 
         // todo end if(message)
@@ -329,13 +330,16 @@ export async function serviceDealWithMagnetLink(message) {
 
     if (handleOption === 'clipboard') {
       await serviceCopyContentToClipboard(content);
-    } else if (handleOption === 'txt') {
+    }
+    else if (handleOption === 'txt') {
       serviceSaveContentToLocal(content, filename);
-    } else if (handleOption === 'clipboardAndTxt') {
+    }
+    else if (handleOption === 'clipboardAndTxt') {
       await serviceCopyContentToClipboard(content);
       serviceSaveContentToLocal(content, filename);
     }
-  } else {
+  }
+  else {
     // todo notification => magnet link not found!
     await browserNotificationCreate('magnet link not found!');
   }

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

@@ -6,16 +6,16 @@ import {stoOpGet, stoOpSet} from './opStorage.js';
  * @returns {Promise<void>}
  */
 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);
-      }
-    });
+  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);
+        }
+      });
 
   await Promise.all(initPromises);
 }

package/.prettierrc.json

@@ -1,12 +0,0 @@
-{
-  "semi": true,
-  "trailingComma": "none",
-  "printWidth": 80,
-  "tabWidth": 2,
-  "useTabs": true,
-  "plugins": [
-    "prettier-plugin-jsdoc"
-  ],
-  "jsdocVerticalAlignment": true,
-  "jsdocLineWrappingStyle": "balance"
-}