@vacantthinker/firefox-addon-framework-easy 2026.526.1707 → 2026.527.1212

package/README.md

@@ -23,6 +23,12 @@ export class BaseORM {  }
 
 ```
 
+### 📄 File: `src/browserDownload.js`
+```javascript
+export async function browserDownloadByDownlink({  }
+
+```
+
 ### 📄 File: `src/browserNotification.js`
 ```javascript
 export async function browserNotificationCreate(
@@ -59,6 +65,10 @@ export function generateHtmlByUserSettings(
     radioItemClickCallback,
 ) {  }
 
+export function generateMkvScriptForSystemWindows({  }
+
+export function generateMkvScriptForSystemFedora({  }
+
 ```
 
 ### 📄 File: `src/opStorage.js`
@@ -149,6 +159,8 @@ export async function serviceCopyContentToClipboard(data) {  }
 
 export function serviceSaveContentToLocal(content, filename, ext = 'txt') {  }
 
+export async function serviceGenerateMkvToolNixScript({  }
+
 export function serviceRemoveIllegalWord(value) {  }
 
 ```

package/index.js

@@ -1,4 +1,5 @@
 export * from './src/baseORM.js'
+export * from './src/browserDownload.js'
 export * from './src/browserNotification.js'
 export * from './src/browserRuntime.js'
 export * from './src/generate.js'

package/package.json

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

package/src/browserDownload.js

@@ -0,0 +1,11 @@
+/**
+ *
+ * @param param0
+ * @param param0.downlink{string}
+ * @param param0.filename{string}
+ * @returns {Promise<void>}
+ */
+export async function browserDownloadByDownlink({ downlink, filename }) {
+  let url = downlink;
+  await browser.downloads.download({url, filename});
+}

package/src/generate.js

@@ -1,4 +1,4 @@
-import { stoOpGet, stoOpSet } from './opStorage.js';
+import {stoOpGet, stoOpSet} from './opStorage.js';
 
 /**
  * Generates HTML elements based on a user settings schema object.
@@ -11,7 +11,10 @@ export function generateHtmlByUserSettings(
     userSettings,
     radioItemClickCallback,
 ) {
-  return Object.keys(userSettings).map((storageKey) => {
+  // Keeps track of all generated fieldsets by their storageKey
+  const elementsMap = {};
+
+  const fieldsets = Object.keys(userSettings).map((storageKey) => {
     const storageValue = userSettings[storageKey];
     const type = storageValue.type || 'text'; // Default to text if type is not specified
 
@@ -21,6 +24,9 @@ export function generateHtmlByUserSettings(
     eleTitle.textContent = storageKey;
     eleWrap.append(eleTitle);
 
+    // Save a reference to the wrapper element for visibility switching
+    elementsMap[storageKey] = eleWrap;
+
     // --- CONDITION 1: CHECKBOX & RADIO ---
     if (type === 'checkbox' || type === 'radio') {
       const options = storageValue.options || [];
@@ -39,37 +45,54 @@ export function generateHtmlByUserSettings(
             const initialArray = Array.from(v || storageValue.selected || []);
             const set = new Set(initialArray);
             eleInput.checked = set.has(option);
+
+            // Initial visibility evaluation
+            triggerVisibility(storageKey, initialArray);
           });
 
           eleInput.addEventListener('change', async () => {
-            const optionsCurrent = await stoOpGet(storageKey) || storageValue.selected || [];
+            const optionsCurrent = await stoOpGet(storageKey) ||
+                storageValue.selected || [];
             const set = new Set(Array.from(optionsCurrent));
 
             if (eleInput.checked) {
               set.add(option);
-            } else {
+            }
+            else {
               set.delete(option);
             }
 
             const valueNew = Array.from(set);
-            console.info(`k=${storageKey} option=${option} eleInput.checked=${eleInput.checked} valueNew=${valueNew}`);
+            console.info(
+                `k=${storageKey} option=${option} eleInput.checked=${eleInput.checked} valueNew=${valueNew}`);
             await stoOpSet(storageKey, valueNew);
+
+            // Dynamic visibility update
+            triggerVisibility(storageKey, valueNew);
           });
         }
         else if (type === 'radio') {
           stoOpGet(storageKey).then((v) => {
-            const currentSelected = (v !== undefined && v !== null) ? v : storageValue.selected;
+            const currentSelected = (v !== undefined && v !== null) ?
+                v :
+                storageValue.selected;
             if (option === currentSelected) {
               eleInput.checked = true;
             }
+
+            // Initial visibility evaluation
+            triggerVisibility(storageKey, currentSelected);
           });
 
-          eleLabel.onclick = function () {
+          eleLabel.onclick = function() {
             stoOpSet(storageKey, option).then(() => {
               console.info(`k=${storageKey} option=${option}`);
               if (typeof radioItemClickCallback === 'function') {
                 radioItemClickCallback(storageKey, option);
               }
+
+              // Dynamic visibility update
+              triggerVisibility(storageKey, option);
             });
           };
         }
@@ -86,14 +109,22 @@ 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;
+        let currentStatus = (v !== undefined && v !== null) ?
+            (v === true || v === 'true') :
+            storageValue.selected;
         eleButton.textContent = String(currentStatus);
 
+        // Initial visibility evaluation
+        triggerVisibility(storageKey, currentStatus);
+
         eleButton.addEventListener('click', async () => {
           currentStatus = !currentStatus; // Toggle state
           eleButton.textContent = String(currentStatus);
           console.info(`k=${storageKey} toggled to=${currentStatus}`);
           await stoOpSet(storageKey, currentStatus);
+
+          // Dynamic visibility update
+          triggerVisibility(storageKey, currentStatus);
         });
       });
 
@@ -107,8 +138,13 @@ export function generateHtmlByUserSettings(
       eleInput.name = storageKey;
 
       stoOpGet(storageKey).then((v) => {
-        const currentVal = (v !== undefined && v !== null) ? v : storageValue.selected;
+        const currentVal = (v !== undefined && v !== null) ?
+            v :
+            storageValue.selected;
         eleInput.value = currentVal;
+
+        // Initial visibility evaluation
+        triggerVisibility(storageKey, currentVal);
       });
 
       // Updates storage on every keystroke/change execution
@@ -118,6 +154,9 @@ export function generateHtmlByUserSettings(
 
         console.info(`k=${storageKey} value changed to=${finalizedValue}`);
         await stoOpSet(storageKey, finalizedValue);
+
+        // Dynamic visibility update
+        triggerVisibility(storageKey, finalizedValue);
       });
 
       eleWrap.append(eleInput);
@@ -125,4 +164,192 @@ export function generateHtmlByUserSettings(
 
     return eleWrap;
   });
+
+  /**
+   * 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) {
+        // String conversion guarantees type safety (e.g., matching boolean true against string "true")
+        const shouldBeVisible = String(currentValue) === String(expectedValue);
+        targetElement.style.display = shouldBeVisible ? '' : 'none';
+      }
+    }
+  }
+
+  return fieldsets;
 }
+
+export function generateMkvScriptForSystemWindows({vid, title}) {
+  let args = {vid, title};
+
+  return `if (true) {
+  const path = require('path');
+  const fs = require('fs');
+  const {execSync, exec} = require('node:child_process');
+  let pathDownload = path.join(__dirname);
+  let dot = '.';
+  let extMKV = 'mkv';
+
+  let {vid, title} = ${JSON.stringify(args)};
+  let playVideoAfterMerged = true;
+  let pathToMkvmerge = 'C:\\\\Program Files\\\\MKVToolNix\\\\mkvmerge.exe';
+
+  let pathMKVOutput = path.join(pathDownload, title.concat(dot, extMKV));
+  let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
+  let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
+  let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
+  let pathJsFile = path.join(__filename);
+
+  if (
+    fs.existsSync(pathToMkvmerge)
+  ) {
+
+    console.log('');
+    console.log(['file check ok!', title].join(' '));
+
+    let cmd_merge = [
+      [pathToMkvmerge].map(v => '"' + v + '"').join(''),
+
+      '-o',
+      [pathOutput]
+        .map(value => '"' + value + '"')
+        .join(' '),
+
+      '--no-video',
+      [pathInputAudio]
+        .map(value => '"' + value + '"')
+        .join(' '),
+
+      '--no-audio',
+      [pathInputVideo]
+        .map(value => '"' + value + '"')
+        .join(' '),
+    ].join(' ');
+
+    console.log('execute script merge ...')
+    console.log(cmd_merge);
+
+    let exec_merge = exec(cmd_merge);
+    exec_merge.stdout.on('data', (data) => {
+      console.log(data);
+    });
+    exec_merge.stderr.on('data', (data) => {
+      console.log('error', data);
+    });
+    exec_merge.stdout.on('close', (data) => {
+      console.log(['merge finish!', title].join(' '));
+
+      if (true) {
+        console.log('remove inputFile');
+        fs.unlinkSync(pathInputVideo);
+        fs.unlinkSync(pathInputAudio);
+      }
+
+      console.log('rename output mkv video...');
+      fs.renameSync(pathOutput, pathMKVOutput);
+
+      if (playVideoAfterMerged) {
+        console.log('play mkv video...');
+        execSync('"' + pathMKVOutput + '"');
+      }
+
+      if (true) {
+        console.log('remove script file');
+        fs.unlinkSync(pathJsFile);
+      }
+    });
+
+  } else {
+    console.log('pathToMkvmerge error')
+
+  }
+}
+  `;
+}
+
+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
+# This header tells Fedora to treat this file as a runnable bash script
+
+# Open a terminal window if not already running inside one
+if [ -z "$VTE_VERSION" ] && [ -z "$ALACRITTY_WINDOW_ID" ] && [ -z "$KITTY_WINDOW_ID" ] && [ "$1" != "--child" ]; then
+    # Re-run this same script inside a visible terminal window so the user sees progress
+    gnome-terminal -- "$0" --child
+    exit 0
+fi
+
+# Run the embedded Node.js code below
+node << 'EOF'
+const path = require('path');
+const fs = require('fs');
+const { execSync } = require('node:child_process');
+
+let pathDownload = path.join(__dirname);
+let dot = '.';
+let extMKV = 'mkv';
+
+let {vid, title} = ${JSON.stringify(args)};
+let playVideoAfterMerged = true;
+let pathToMkvmerge = '/usr/bin/mkvmerge';
+
+let pathMKVOutput = path.join(pathDownload, title.concat(dot, extMKV));
+let pathOutput = path.join(pathDownload, vid.concat(dot, extMKV));
+let pathInputAudio = path.join(pathDownload, vid.concat(dot, "mp3"));
+let pathInputVideo = path.join(pathDownload, vid.concat(dot, "mp4"));
+
+if (fs.existsSync(pathToMkvmerge)) {
+  console.log('\\nfile check ok! ' + title);
+
+  let cmd_merge = [
+    '"' + pathToMkvmerge + '"',
+    '-o', '"' + pathOutput + '"',
+    '--no-video', '"' + pathInputAudio + '"',
+    '--no-audio', '"' + pathInputVideo + '"',
+  ].join(' ');
+
+  console.log('execute script merge ...\\n' + cmd_merge);
+
+  try {
+    // Run merge synchronously so stdout pipes directly to the terminal
+    execSync(cmd_merge, { stdio: 'inherit' });
+    console.log('merge finish! ' + title);
+
+    console.log('remove inputFile');
+    if (fs.existsSync(pathInputVideo)) fs.unlinkSync(pathInputVideo);
+    if (fs.existsSync(pathInputAudio)) fs.unlinkSync(pathInputAudio);
+
+    console.log('rename output mkv video...');
+    fs.renameSync(pathOutput, pathMKVOutput);
+
+    if (playVideoAfterMerged) {
+      console.log('play mkv video...');
+      // xdg-open usually hands off to the player and exits immediately
+      execSync('xdg-open "' + pathMKVOutput + '"');
+    }
+  } catch (err) {
+    console.error('An error occurred during processing:', err.message);
+  }
+} else {
+  console.log('pathToMkvmerge error. run: sudo dnf install mkvtoolnix')
+}
+EOF
+
+# Prevent the terminal window from closing instantly so the user can read messages
+echo ""
+echo "Press Enter to exit and automatically delete this script..."
+read unused_input
+
+# Deletes the shell script file itself after completion
+rm -- "$0"
+`;
+}
+

package/src/serviceFetch.js

@@ -40,7 +40,7 @@ export async function servicePostJson(
  *        rpcsecret:string,
  *        rpcport:string
  *        }}
- * @returns {Promise<Response>}
+ * @returns {Promise<Response|null>}
  */
 export async function serviceSendDataToLocalAria2(message) {
   let {downlink, filename, rpcsecret, rpcport} = message;
@@ -76,8 +76,9 @@ export async function serviceSendDataToLocalAria2(message) {
 
     return response;
   } catch (e) {
+    await browserNotificationCreate(e)
     console.error(e);
-    await browserNotificationCreate(`error! ${e}`)
+    return null;
   }
 
 }

package/src/serviceOpContent.js

@@ -1,3 +1,9 @@
+import {browserRuntimePlatformInfo} from './browserRuntime.js';
+import {
+  generateMkvScriptForSystemFedora,
+  generateMkvScriptForSystemWindows,
+} from './generate.js';
+
 /**
  *
  * @param data
@@ -22,8 +28,8 @@ export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
 
         const extObj = {
           txt: 'text/plain',
-          json: 'application/json'
-        }
+          json: 'application/json',
+        };
         const type = extObj[ext];
 
         const file = new Blob([content], {type});
@@ -38,6 +44,26 @@ export function serviceSaveContentToLocal(content, filename, ext = 'txt') {
   // eleBtn.previousElementSibling
 }
 
+/**
+ * need install nodejs mkvtoolnix
+ * @param message{{
+ *      vid, title,
+ * }}
+ * @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');
+  }
+}
+
 /**
  *
  * @param {string} value