arch: rewrite code and use modules everywhere

and fix quite a few typo bugs and logic issues, including issues up to #381

Author: gdh1995

.eslintrc.json

@@ -109,8 +109,8 @@
     "radix": "off",
     "space-before-function-paren": "off",
     "spaced-comment": [ "error", "always", {
-      "line": { "markers": [ "/" ] },
-      "block": { "exceptions": [ "#__NOINLINE__", "#__INLINE__" ] }
+      "line": { "markers": [ "/", "#region" ], "exceptions": ["#endregion"] },
+      "block": { "exceptions": [ "#__NOINLINE__", "#__INLINE__" ], "balanced": false }
     } ],
     "use-isnan": "error",
     "valid-typeof": "off"

_locales/en/messages.json

@@ -4,5 +4,6 @@
 	},
 	"description": {
 		"message": "一款支持全键盘操作浏览器的辅助工具，只用键盘即可点击任意链接、切换标签页和快速搜索任意内容，支持自定义快捷键和调整操作细节"
-	}
+	},
+  "i18n": { "message": "zh" }
 }

_locales/fr/messages.json

@@ -4,5 +4,6 @@
 	},
 	"description": {
 		"message": "一款支持全鍵盤操作瀏覽器的輔助工具，只用鍵盤即可點擊任意鏈結、切換分頁和快速搜索任意內容，支持自定義快速鍵和調整操作細節"
-	}
+	},
+  "i18n": { "message": "zh" }
 }

_locales/zh/messages.json

@@ -0,0 +1,110 @@
+import {
+  framesForTab_, CurCVer_, OnChrome, set_setIcon_, setIcon_, set_iconData_, iconData_, blank_
+} from "./store"
+import * as BgUtils_ from "./utils"
+import * as settings_ from "./settings"
+import { trans_ } from "./i18n"
+import { browser_, runtimeError_ } from "./browser"
+import { asyncIterFrames_ } from "./ports"
+
+const knownIcons_ = OnChrome ? As_<readonly [IconNS.BinaryPath, IconNS.BinaryPath, IconNS.BinaryPath]>([
+  "icons/enabled.bin", "icons/partial.bin", "icons/disabled.bin"
+]) : As_<readonly [IconNS.ImagePath, IconNS.ImagePath, IconNS.ImagePath]>([
+  { 19: "/icons/enabled_19.png", 38: "/icons/enabled_38.png" },
+  { 19: "/icons/partial_19.png", 38: "/icons/partial_38.png" },
+  { 19: "/icons/disabled_19.png", 38: "/icons/disabled_38.png" }
+])
+
+export const browserAction_ = (browser_ as any).action as undefined || browser_.browserAction
+let tabIds_cr_: Map<Frames.ValidStatus, number[] | null> | null
+let mayShowIcons = true
+
+const onerror = (err: any): void => {
+  if (!mayShowIcons) { return }
+  mayShowIcons = false;
+  console.log("Can not access binary icon data:", err);
+  set_setIcon_(blank_)
+  browserAction_.setTitle({ title: trans_("name") + "\n\nFailed in showing dynamic icons." })
+}
+
+const loadBinaryImagesAndSetIcon_cr = (type: Frames.ValidStatus): void => {
+  const path = knownIcons_[type] as IconNS.BinaryPath;
+  const loadFromRawArray = (array: ArrayBuffer): void => {
+    const uint8Array = new Uint8ClampedArray(array), firstSize = array.byteLength / 5,
+    small = (Math.sqrt(firstSize / 4) | 0) as IconNS.ValidSizes, large = (small + small) as IconNS.ValidSizes,
+    cache = BgUtils_.safeObj_() as IconNS.IconBuffer;
+    cache[small] = new ImageData(uint8Array.subarray(0, firstSize), small, small);
+    cache[large] = new ImageData(uint8Array.subarray(firstSize), large, large);
+    iconData_![type] = cache;
+    const arr = tabIds_cr_!.get(type)!
+    tabIds_cr_!.delete(type)
+    for (let w = 0, h = arr.length; w < h; w++) {
+      framesForTab_.has(arr[w]) && setIcon_(arr[w], type, true)
+    }
+  };
+  if (Build.MinCVer >= BrowserVer.MinFetchExtensionFiles || CurCVer_ >= BrowserVer.MinFetchExtensionFiles) {
+    const p = fetch(path).then(r => r.arrayBuffer()).then(loadFromRawArray)
+    if (!Build.NDEBUG) { p.catch(onerror) }
+  } else {
+    const req = new XMLHttpRequest() as ArrayXHR
+    req.open("GET", path, true)
+    req.responseType = "arraybuffer"
+    req.onload = function (this: typeof req) { loadFromRawArray(this.response) }
+    if (!Build.NDEBUG) { req.onerror = onerror }
+    req.send()
+  }
+}
+
+export const toggleIconBuffer_ = (): void => {
+  const enabled = settings_.get_("showActionIcon")
+  if (enabled === !!iconData_) { return }
+  const iter = ({ cur_: { s: sender } }: Frames.Frames): void => {
+    if (sender.status_ !== Frames.Status.enabled) {
+      setIcon_(sender.tabId_, enabled ? sender.status_ : Frames.Status.enabled)
+    }
+  }
+  const cond = (): boolean => settings_.get_("showActionIcon") === enabled
+  if (!enabled) {
+    setTimeout((): void => {
+      if (settings_.get_("showActionIcon") || iconData_ == null) { return }
+      set_iconData_(null)
+      if (OnChrome) { tabIds_cr_ = null }
+      else {
+        asyncIterFrames_(iter, cond)
+      }
+    }, 200);
+    return;
+  }
+  if (!OnChrome) {
+    set_iconData_(1 as never)
+  } else {
+    set_iconData_([null, null, null])
+    tabIds_cr_ = new Map()
+  }
+  // only do partly updates: ignore "rare" cases like `sender.s` is enabled but the real icon isn't
+  asyncIterFrames_(iter, cond)
+}
+
+/** Firefox does not use ImageData as inner data format
+ * * https://dxr.mozilla.org/mozilla-central/source/toolkit/components/extensions/schemas/manifest.json#577
+ *   converts ImageData objects in parameters into data:image/png,... URLs
+ * * https://dxr.mozilla.org/mozilla-central/source/browser/components/extensions/parent/ext-browserAction.js#483
+ *   builds a css text of "--webextension-***: url(icon-url)",
+ *   and then set the style of an extension's toolbar button to it
+ */
+export const doSetIcon_: typeof setIcon_ = !OnChrome ? (tabId, type): void => {
+  tabId < 0 || browserAction_.setIcon({ tabId, path: knownIcons_[type]! })
+} : (tabId: number, type: Frames.ValidStatus, isLater?: true): void => {
+  let data: IconNS.IconBuffer | null | undefined;
+  if (tabId < 0) { /* empty */ }
+  else if (data = iconData_![type]) {
+    const f = browserAction_.setIcon
+    const args: Parameters<typeof f>[0] = { tabId, imageData: data }
+    isLater ? f(args, runtimeError_) : f(args);
+  } else if (tabIds_cr_!.has(type)) {
+    tabIds_cr_!.get(type)!.push(tabId)
+  } else {
+    setTimeout(loadBinaryImagesAndSetIcon_cr, 0, type);
+    tabIds_cr_!.set(type, [tabId])
+  }
+}