@vacantthinker/firefox-addon-framework-easy 2026.610.1322 → 2026.611.821

package/package.json

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

package/src/BaseORM.js

@@ -1,21 +1,14 @@
 import {stoOpCheck, stoOpGet, stoOpRem, stoOpSet} from './opStorage.js';
 
 /**
- * Abstract base class BaseORM (similar to Java's Abstract Class).
- * Provides encapsulated CRUD operations for specific Key-Value pairs bound at instantiation.
+ * Abstract base class BaseORM.
+ * Provides encapsulated CRUD operations for JSON-serializable Key-Value pairs.
  */
 export class BaseORM {
-  // Private fields for data encapsulation
-  #id; // Added to store the raw unique identifier
+  #id;
   #fullStorageKey;
   #defaultValue;
 
-  /**
-   * Constructor
-   * @param {string} prefix The prefix for the keys (e.g., 'magnetKey')
-   * @param {string} id The unique identifier for this instance
-   * @param {object} [defaultValue={}] Custom initial value
-   */
   constructor(prefix, id, defaultValue = {}) {
     if (new.target === BaseORM) {
       throw new TypeError(
@@ -25,47 +18,28 @@ export class BaseORM {
       throw new Error('Both prefix and id must be specified.');
     }
 
-    // Save the raw id to the private field
     this.#id = id;
-
     const formattedPrefix = prefix.endsWith(' ') ? prefix : `${prefix} `;
     this.#fullStorageKey = `${formattedPrefix}${id}`;
     this.#defaultValue = JSON.parse(JSON.stringify(defaultValue));
   }
 
-  /**
-   * Public Getter to retrieve the bound unique identifier (id).
-   * Can be accessed as `this.id` inside subclasses or `instance.id` externally.
-   * @return {string} The raw id
-   */
   get id() {
     return this.#id;
   }
 
-  /**
-   * Protected Getter for subclasses to safely access the complete key.
-   * Can be used in subclasses as `this.storageKey`.
-   * @protected
-   * @return {string} The full storage key
-   */
   get storageKey() {
     return this.#fullStorageKey;
   }
 
-  // Private helper method
   async #exists() {
     return await stoOpCheck(this.#fullStorageKey);
   }
 
-  // Private helper method
   async #initDefaultObject() {
     await stoOpSet(this.#fullStorageKey, this.#defaultValue);
   }
 
-  /**
-   * [Read] Retrieve the value associated with the bound key.
-   * @return {Promise<object>}
-   */
   async get() {
     if (!(await this.#exists())) {
       await this.#initDefaultObject();
@@ -73,31 +47,16 @@ export class BaseORM {
     return await stoOpGet(this.#fullStorageKey);
   }
 
-  /**
-   * [Create/Update] Overwrite the value of the bound key completely.
-   * @param {object} value The new Object data to store
-   * @return {Promise<void>}
-   */
   async set(value) {
     await stoOpSet(this.#fullStorageKey, value || this.#defaultValue);
   }
 
-  /**
-   * [Delete] Wipe the bound key from storage.
-   * @return {Promise<object>}
-   */
   async delete() {
     const previousValue = await this.get();
     await stoOpRem(this.#fullStorageKey);
     return previousValue;
   }
 
-  /**
-   * [Partial Update] Modify a single targeted key-value pair nested deep within the stored object.
-   * @param {string} objectKey The internal key path inside the main value object
-   * @param {*} objectValue The new value to map to that key
-   * @return {Promise<object>} Returns the fully updated object structure
-   */
   async updateValueKeyValue(objectKey, objectValue) {
     const currentData = await this.get();
     currentData[objectKey] = objectValue;

package/src/browserTab.js

@@ -29,7 +29,7 @@ export function browserTabWaitReloadThenSendMessageToContentJs(message) {
  * @param message
  * @param message.tabId{number}
  * @param message.url{string}
- * @param message.options.focusNewTab{boolean}
+ * @param message.focusNewTab{boolean}
  * @returns {Promise<void>}
  */
 export async function browserTabCreateToDownload(message) {
@@ -45,9 +45,9 @@ export async function browserTabCreateToDownload(message) {
       delete message.tabId;
     }
   }
-  if (message.options) {
-    let focusNewTab = message.options.focusNewTab;
-    Object.assign(properties, {active: focusNewTab});
+  
+  if (message?.focusNewTab !== undefined) {
+    Object.assign(properties, {active: message.focusNewTab});
   }
 
   let {tabId} = await tabOpCreateNear(properties);
@@ -70,8 +70,7 @@ export async function browserTabCreateToDownload(message) {
  * * @param {Object} message - The message payload.
  * @param {number} [message.tabId] - Optional Tab ID to attach to.
  * @param {string} [message.url] - The URL to open.
- * @param {Object} [message.options] - Additional options.
- * @param {boolean} [message.options.focusNewTab] - Whether the newly created tab should be active.
+ * @param {boolean} [message.focusNewTab] - Whether the newly created tab should be active.
  * @returns {Promise<void>}
  */
 export async function browserTabCreateNearSendMessageToContentJs(message = {}) {
@@ -92,8 +91,8 @@ export async function browserTabCreateNearSendMessageToContentJs(message = {}) {
 
   // Use optional chaining to safely extract nested properties.
   // Only assign 'active' if 'focusNewTab' was explicitly provided.
-  if (message?.options?.focusNewTab !== undefined) {
-    Object.assign(properties, {active: message.options.focusNewTab});
+  if (message?.focusNewTab !== undefined) {
+    Object.assign(properties, {active: message.focusNewTab});
   }
 
   let {tabId} = await tabOpCreateNear(properties);

package/src/generate.js

@@ -1,5 +1,3 @@
-// 新主题。
-
 /**
  *
  * @param videoInfo