@vacantthinker/firefox-addon-framework-easy 2026.526.2259 → 2026.527.2043

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`
@@ -95,6 +105,8 @@ export async function tabOpCreate(urlOrArgs) {  }
 
 export async function tabOpCreateNormal(urlOrArgs) {  }
 
+export async function tabOpCreateByWindow(url) {  }
+
 export async function tabOpRemove(tabId) {  }
 
 export async function tabOpHide(tabId) {  }
@@ -149,6 +161,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.2259",
+  "version": "2026.0527.2043",
   "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.
@@ -51,17 +51,20 @@ export function generateHtmlByUserSettings(
           });
 
           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
@@ -70,7 +73,9 @@ export function generateHtmlByUserSettings(
         }
         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;
             }
@@ -79,7 +84,7 @@ export function generateHtmlByUserSettings(
             triggerVisibility(storageKey, currentSelected);
           });
 
-          eleLabel.onclick = function () {
+          eleLabel.onclick = function() {
             stoOpSet(storageKey, option).then(() => {
               console.info(`k=${storageKey} option=${option}`);
               if (typeof radioItemClickCallback === 'function') {
@@ -104,7 +109,9 @@ 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
@@ -131,7 +138,9 @@ 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
@@ -162,7 +171,7 @@ export function generateHtmlByUserSettings(
   function triggerVisibility(sourceKey, currentValue) {
     const config = userSettings[sourceKey];
     if (config && config.visibilityControl) {
-      const { targetField, expectedValue } = config.visibilityControl;
+      const {targetField, expectedValue} = config.visibilityControl;
       const targetElement = elementsMap[targetField];
 
       if (targetElement) {
@@ -174,4 +183,173 @@ export function generateHtmlByUserSettings(
   }
 
   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/opTab.js

@@ -51,7 +51,6 @@ export async function tabOpReload(tabId) {
  * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
  */
 export async function tabOpCreate(urlOrArgs) {
-  try {
     /**
      * @type {browser.tabs._CreateCreateProperties}
      */
@@ -66,8 +65,6 @@ export async function tabOpCreate(urlOrArgs) {
     Object.assign(urlOrArgs, source);
     let tab = await browser.tabs.create(urlOrArgs);
     return tabOpEnhance(tab)
-  } catch (e) {
-  }
 }
 
 /**
@@ -88,6 +85,25 @@ export async function tabOpCreateNormal(urlOrArgs) {
   return tabOpEnhance(tab)
 }
 
+/**
+ * Creates a normal tab using either a URL string or a properties object.
+ *
+ * @param {string} url
+ * @returns {Promise<(browser.tabs.Tab & {tabId: number})>}
+ */
+export async function tabOpCreateByWindow(url) {
+  // If it's a string, wrap it in an object
+  if (typeof url === 'string') {
+    let window = await browser.windows.create({
+      url
+    });
+    let tab = window.tabs.shift();
+    return tabOpEnhance(tab)
+  }
+}
+
+
+
 /**
  *
  * @param tabId{number}

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