@vacantthinker/firefox-addon-framework-easy 2026.524.1751 → 2026.525.2018

package/README.md

@@ -17,19 +17,19 @@ You can download, clone, or view the complete source code for this application h
 
 Below is a list of all public functions found inside the `src` directory:
 
-### File: `src/baseORM.js`
+### 📄 File: `src/baseORM.js`
 ```javascript
 export class BaseORM {  }
 
 ```
 
-### File: `src/browserNotification.js`
+### 📄 File: `src/browserNotification.js`
 ```javascript
 export async function browserNotificationCreate(content, title = null) {  }
 
 ```
 
-### File: `src/browserRuntime.js`
+### 📄 File: `src/browserRuntime.js`
 ```javascript
 export function browserRuntimeReload() {  }
 
@@ -47,7 +47,7 @@ export function browserRuntimeManifestVersion() {  }
 
 ```
 
-### File: `src/generate.js`
+### 📄 File: `src/generate.js`
 ```javascript
 export function generateHtmlByUserSettings(
     userSettings,
@@ -56,7 +56,7 @@ export function generateHtmlByUserSettings(
 
 ```
 
-### File: `src/opStorage.js`
+### 📄 File: `src/opStorage.js`
 ```javascript
 export async function stoOpCheck(k) {  }
 
@@ -74,7 +74,7 @@ export async function stoOpSetNull(k) {  }
 
 ```
 
-### File: `src/opTab.js`
+### 📄 File: `src/opTab.js`
 ```javascript
 export async function tabOpGet(tabId) {  }
 
@@ -106,7 +106,15 @@ export async function tabOpRemoveCssCode(tabId, code) {  }
 
 ```
 
-### File: `src/serviceFetch.js`
+### 📄 File: `src/serviceCommon.js`
+```javascript
+export async function serviceElementPicker(message) {  }
+
+export async function serviceGetFullPageRectData(message) {  }
+
+```
+
+### 📄 File: `src/serviceFetch.js`
 ```javascript
 export async function servicePostJson(
     serverUrl,
@@ -116,7 +124,7 @@ export async function servicePostJson(
 
 ```
 
-### File: `src/serviceGet.js`
+### 📄 File: `src/serviceGet.js`
 ```javascript
 export function serviceGetDomainByUrl(url) {  }
 
@@ -124,7 +132,7 @@ export function serviceGetCurrentDateYYYYMMDDHHMMSS() {  }
 
 ```
 
-### File: `src/serviceOpContent.js`
+### 📄 File: `src/serviceOpContent.js`
 ```javascript
 export function serviceCopyContentToClipboard(content) {  }
 
@@ -134,13 +142,13 @@ export function serviceRemoveIllegalWord(value) {  }
 
 ```
 
-### File: `src/servicePureVideolink.js`
+### 📄 File: `src/servicePureVideolink.js`
 ```javascript
 export function servicePureVideolinkYTB(videolinkOrigin) {  }
 
 ```
 
-### File: `src/serviceUpdateALLStyle.js`
+### 📄 File: `src/serviceUpdateTabStyle.js`
 ```javascript
 export async function serviceUpdataALLTextNodeColor(message) {  }
 
@@ -148,7 +156,7 @@ export async function serviceUpdataALLNodeBackgroundColor(message) {  }
 
 ```
 
-### File: `src/serviceUserSettings.js`
+### 📄 File: `src/serviceUserSettings.js`
 ```javascript
 export async function serviceInitUserSettings(userSettings) {  }
 

package/index.js

@@ -4,9 +4,10 @@ export * from './src/browserRuntime.js'
 export * from './src/generate.js'
 export * from './src/opStorage.js'
 export * from './src/opTab.js'
+export * from './src/serviceCommon.js'
 export * from './src/serviceFetch.js'
 export * from './src/serviceGet.js'
 export * from './src/serviceOpContent.js'
 export * from './src/servicePureVideolink.js'
-export * from './src/serviceUpdateALLStyle.js'
+export * from './src/serviceUpdateTabStyle.js'
 export * from './src/serviceUserSettings.js'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vacantthinker/firefox-addon-framework-easy",
-  "version": "2026.0524.1751",
+  "version": "2026.0525.2018",
   "description": "",
   "main": "index.js",
   "publishConfig": {

package/publish.sh

@@ -47,7 +47,7 @@ EOF
 # 2. Iterate through all js files, capture multi-line signatures, and append them to README
 for file in src/*.js; do
     if [ -f "$file" ]; then
-        echo "### File: \`$file\`" >> README.md
+        echo "### 📄 File: \`$file\`" >> README.md
         echo "\`\`\`javascript" >> README.md
 
         # Reads multi-line signatures up to the opening brace or semicolon

package/src/generate.js

@@ -8,10 +8,6 @@ import {stoOpGet, stoOpSet} from './opStorage.js';
  *     optionType: 'checkbox',
  *     options: ['Searcher1', 'Searcher2'],
  *     selected: ['Searcher1', 'Searcher2'],
- *     queryTitle: {
- *       'Searcher1': 'https://y2down.cc/',
- *       'Searcher2': 'https://ssyou.online',
- *     },
  *   },
  *   videoQuality: {
  *     options: ['360', '480', '720', '1080', '1440', '2160'],

package/src/serviceCommon.js

@@ -0,0 +1,176 @@
+/**
+ * will get => {{x, y, width, height, uniqueSelector}}
+ * @param message{{
+ *      tabId:number,
+ *      act:string
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function serviceElementPicker(message) {
+  let {tabId} = message;
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [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);
+
+      if (!overlay) {
+        overlay = document.createElement('div');
+        overlay.id = overlayId;
+        // !important and max z-index guarantees it will never be hidden by site CSS
+        overlay.style.cssText = `
+          position: fixed !important;
+          top: 0 !important;
+          left: 0 !important;
+          width: 0 !important;
+          height: 0 !important;
+          background-color: rgba(255, 0, 85, 0.2) !important;
+          outline: 2px dashed #ff0055 !important;
+          outline-offset: -2px !important;
+          z-index: 2147483647 !important;
+          pointer-events: none !important;
+          transition: all 0.05s ease-out !important;
+          display: none !important;
+        `;
+        // Appending to documentElement (<html>) avoids <body> layout restrictions
+        document.documentElement.appendChild(overlay);
+      }
+
+      function getUniqueSelector(el) {
+        if (!(el instanceof Element)) return '';
+        const path = [];
+        while (el.nodeType === Node.ELEMENT_NODE) {
+          let selector = el.nodeName.toLowerCase();
+          if (el.id) {
+            selector += '#' + el.id;
+            path.unshift(selector);
+            break;
+          }
+          else {
+            let sib = el, nth = 1;
+            while (sib = sib.previousElementSibling) {
+              if (sib.nodeName.toLowerCase() === selector) nth++;
+            }
+            if (nth !== 1) selector += `:nth-of-type(${nth})`;
+          }
+          path.unshift(selector);
+          el = el.parentNode;
+        }
+        return path.join(' > ');
+      }
+
+      function handleMouseOver(e) {
+        const target = e.target;
+
+        // Safety check to ensure we don't try to highlight our own UI
+        if (target.id === overlayId) return;
+
+        // Get exact coordinates of the hovered element
+        const rect = target.getBoundingClientRect();
+
+        // Move the floating overlay exactly over the target
+        overlay.style.setProperty('display', 'block', 'important');
+        overlay.style.setProperty('top', `${rect.top}px`, 'important');
+        overlay.style.setProperty('left', `${rect.left}px`, 'important');
+        overlay.style.setProperty('width', `${rect.width}px`, 'important');
+        overlay.style.setProperty('height', `${rect.height}px`, 'important');
+
+        // Change mouse cursor to indicate picking mode
+        document.body.style.setProperty('cursor', 'crosshair', 'important');
+      }
+
+      async function handleElementClick(e) {
+        e.preventDefault();
+        e.stopPropagation();
+
+        const target = e.target;
+
+        // Clean up the picker completely
+        stopPickingMode();
+
+        // Calculate screenshot coordinates
+        let rect = target.getBoundingClientRect();
+        let rectData = {
+          height: rect.height,
+          width: rect.width,
+          x: rect.left + window.scrollX,
+          y: rect.top + window.scrollY,
+          selector: getUniqueSelector(target),
+        };
+
+        console.log('Target Selected:', {rectData});
+
+        // 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
+            rectData,
+            {
+              // The guaranteed unique CSS path (e.g., "div#wrap > ul > li:nth-of-type(2)")
+              uniqueSelector: getUniqueSelector(target),
+            },
+        );
+
+        await browser.runtime.sendMessage(messageTakeScreenshot);
+      }
+
+      function startPickingMode() {
+        document.addEventListener('mouseover', handleMouseOver, true);
+        document.addEventListener('click', handleElementClick, true);
+      }
+
+      function stopPickingMode() {
+        document.removeEventListener('mouseover', handleMouseOver, true);
+        document.removeEventListener('click', handleElementClick, true);
+
+        // Restore normal mouse cursor
+        document.body.style.removeProperty('cursor');
+
+        // Remove the overlay from the DOM entirely
+        if (overlay) {
+          overlay.remove();
+        }
+      }
+
+      // Initialize the picker mode
+      startPickingMode();
+    },
+  });
+}
+
+/**
+ * will get => {{x, y, width, height,}}
+ * @param message{{
+ *      tabId:number,
+ *      act:string
+ * }}
+ * @returns {Promise<void>}
+ */
+export async function serviceGetFullPageRectData(message) {
+  let {tabId} = message;
+
+  await browser.scripting.executeScript({
+    target: {tabId},
+    args: [message],
+    func: async (message) => {
+
+      let x = 0, y = 0;
+      let width = document.documentElement.scrollWidth;
+      let height = document.documentElement.scrollHeight;
+
+      await browser.runtime.sendMessage(Object.assign(
+          {},
+          message,
+          {
+            x, y, width, height,
+          },
+      ));
+      // todo end if (message)
+    },
+  });
+}

package/src/serviceUserSettings.js

@@ -1,15 +1,12 @@
 import {stoOpGet, stoOpSet} from './opStorage.js';
 
 /**
- *
+ * this function connect with generateHtmlByUserSettings()
+ * example
  * searchEngine: {
  *     optionType: 'checkbox',
  *     options: ['Searcher1', 'Searcher2'],
  *     selected: ['Searcher1', 'Searcher2'],
- *     queryTitle: {
- *       'Searcher1': 'https://y2down.cc/',
- *       'Searcher2': 'https://ssyou.online',
- *     },
  *   },
  *   videoQuality: {
  *     options: ['360', '480', '720', '1080', '1440', '2160'],
@@ -37,7 +34,7 @@ export async function serviceInitUserSettings(userSettings) {
 }
 
 /**
- * // todo 当前这个文件 建议使用生成式脚本来处理
+ * // todo
  * @param userSettings{{}}
  * @returns {Promise<{}>}
  */