release: EQ Toolkit 2.0.0

.github/workflows/test.yml

@@ -0,0 +1,27 @@
+name: Tests
+
+on:
+  push:
+    branches:
+      - main
+  pull_request: {}
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 24
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test

.gitignore

@@ -133,4 +133,7 @@ dist
 .yarn/unplugged
 .yarn/build-state.yml
 .yarn/install-state.gz
-.pnp.*
+.pnp.*
+**/docs
+**/.worktrees
+**/.superpowers

AGENTS.md

@@ -0,0 +1,69 @@
+# Repository Guidelines
+
+## Project Structure & Module Organization
+
+- Core browser extension manifest lives in `manifest.json`; popup markup is in `popup.html` and pulls styles from `resources/styles/popup.css` plus icons/images in `resources/icons` and `resources/images`.
+
+- All runtime logic is TypeScript modules in `src/`.
+
+- Localized strings sit in `_locales/<lang>/messages.json`; keep keys consistent across languages and match `__MSG_*__` tokens in markup and scripts.
+
+## Build, Test, and Development Commands
+
+- `npm ci` (or `npm install`): installs dev dependencies; there is no bundler or transpile step.
+
+- `npm build`: runs build using vite with custom script (`tools/buildExtension.mjs`)
+
+- `lint:locales`: validates length of strings and lines count for some buttons
+
+- `npm test`: runs unit tests using vitest
+
+- Packaging: zip `dist/` for store uploads after build; avoid including `node_modules/`.
+
+## Do not patch symptoms
+
+- When fixing bugs, do not add quick workarounds whose only purpose is to make the current case pass.
+
+- Treat such changes as a temporary stub, not a real solution.
+
+- Your goal is to find and fix the actual root cause of the error. Before changing code, investigate why the failure happens, where the incorrect assumption is, and what part of the system is responsible.
+
+Avoid fixes like:
+
+- swallowing errors without understanding them
+
+- adding special cases just to satisfy one scenario
+
+- forcing values into a valid shape without knowing why they are invalid
+
+- retrying, ignoring, or bypassing failing logic
+
+- making the code “just work” while leaving the underlying issue unresolved
+
+A correct fix should explain and address the real cause of the bug, not merely hide its effects.
+
+## Avoid redundant validation layers
+
+- Normalize and validate external input once at the boundary where it enters the system, then pass the resolved value through internal functions.
+
+- Do not call the same fallback/validation helper repeatedly through nested helper chains unless the value can be modified or become invalid between calls.
+
+## Coding Style & Naming Conventions
+
+- Use 2-space indentation, semicolons, and `const`/`let` over `var`; prefer arrow functions and early returns to mirror existing files.
+
+- File names are camel case (`drawSpectrum.ts` style); functions and variables use `camelCase`. Keep DOM ids/classes in `kebab-case` as seen in `popup.html`.
+
+- Favor double quotes in TS/JS/JSON to stay consistent with current code and locale files.
+
+## Testing Guidelines
+
+- No automated test suite yet; run manual checks after changes: reload the unpacked extension, open the popup, tweak bands, toggle mute/reset, and confirm spectrum drawing updates without console errors.
+
+- Verify localization by switching the browser language and checking visible strings against `_locales` entries; default locale is `en`.
+
+- When touching audio logic, test across multiple tabs and sites to confirm content scripts register via `background.js` and settings persist in `chrome.storage`.
+
+## Localization
+
+- When adding UI text, create English copy first at the end of `_locales/en/messages.json`, then mirror keys across other locales and translate values; avoid hardcoded strings in markup or scripts.

PRIVACY.md

@@ -12,9 +12,6 @@ All user settings are stored locally in your browser. No data is stored on exter
 ## Cookies
 We may use cookies to enhance user experience, store preferences, and improve functionality. You can disable cookies in your browser settings.
 
-## Analytics
-We use Google Analytics to analyze usage trends and improve our services.
-
 ## Security
 We take strong security measures to protect user data from unauthorized access and ensure data integrity.
 

README.md

@@ -45,6 +45,13 @@ You can help translate EQ Toolkit on [Weblate](https://hosted.weblate.org/projec
 
 [![Translation status](https://hosted.weblate.org/widget/eq-toolkit-chrome-extension/svg-badge.svg)](https://hosted.weblate.org/engage/eq-toolkit-chrome-extension/)
 
+## Development
+1. Install dependencies with `npm ci`.
+2. Build the extension with `npm run build`.
+3. Load `dist/` as an unpacked extension from your browser extensions page.
+
+Run `npm run typecheck` and `npm test` before packaging changes.
+
 ## Support
 The extention are provided for free. If you like the project, I would appreciate your [support](https://www.donationalerts.com/r/maitrog).
 

_locales/bn/messages.json

@@ -3,7 +3,7 @@
     "message": "EQ Toolkit - অডিও ইকুয়ালাইজার"
   },
   "extDescription": {
-    "message": "EQ Toolkit অডিও নিয়ন্ত্রণের জন্য একটি বিনামূল্যের ও ওপেন-সোর্স এক্সটেনশন।"
+    "message": "যেকোনো ট্যাবের অডিও ইকুয়ালাইজার ও ভলিউম বুস্টার: বেস বাড়ান, সাউন্ড টিউন করুন, প্রিসেট সেভ করুন।"
   },
   "gain_slider_label": {
     "message": "পরিবর্ধন:"
@@ -23,21 +23,24 @@
   "save_preset_button_label": {
     "message": "প্রিসেট সংরক্ষণ করুন"
   },
-  "enter_preset_name": {
-    "message": "নাম লিখুন"
-  },
   "settings_title": {
     "message": "সেটিংস"
   },
   "presets_settings_title": {
     "message": "প্রিসেট"
   },
+  "hide_default_presets_label": {
+    "message": "ডিফল্ট প্রিসেট লুকান"
+  },
   "community_settings_title": {
     "message": "কমিউনিটি"
   },
   "help_with_translation_label": {
     "message": "অনুবাদে সাহায্য করুন:"
   },
+  "translators_label": {
+    "message": "অনুবাদকরা:"
+  },
   "source_code_label": {
     "message": "সোর্স কোড:"
   },
@@ -48,7 +51,7 @@
     "message": "প্রিসেট রপ্তানি করুন"
   },
   "enable_spectrum_setting_option": {
-    "message": "স্পেকট্রাম ভিজুয়ালাইজেশন সক্রিয় করুন, পৃষ্ঠা পুনরায় লোড করতে হবে (উচ্চ CPU ব্যবহার)"
+    "message": "স্পেকট্রাম ভিজুয়ালাইজেশন সক্রিয় করুন"
   },
   "points_count_setting_option": {
     "message": "EQ পয়েন্টের সংখ্যা"
@@ -78,7 +81,7 @@
     "message": "ইকুয়ালাইজার ইতিমধ্যে একটি উইন্ডোতে খোলা আছে"
   },
   "support_me": {
-    "message": "আমাকে সমর্থন করুন"
+    "message": "আমাকে সমর্থন করুন:"
   },
   "settings_button_tooltip": {
     "message": "সেটিংস"
@@ -142,5 +145,68 @@
   },
   "shortcut_duplicate_error": {
     "message": "এই শর্টকাটটি ইতিমধ্যে অন্য কমান্ডে ব্যবহৃত হচ্ছে।"
+  },
+  "global_controls_title": {
+    "message": "সামগ্রিক নিয়ন্ত্রণ"
+  },
+  "preset_controls_title": {
+    "message": "প্রিসেট নিয়ন্ত্রণ"
+  },
+  "save": {
+    "message": "সংরক্ষণ করুন"
+  },
+  "save_preset_modal_title": {
+    "message": "প্রিসেট সংরক্ষণ করুন"
+  },
+  "preset_name_label": {
+    "message": "প্রিসেটের নাম"
+  },
+  "preset_name_empty_error": {
+    "message": "প্রিসেটের নাম লিখুন।"
+  },
+  "preset_name_reserved_error": {
+    "message": "এই নামটি একটি অন্তর্নির্মিত প্রিসেটের জন্য সংরক্ষিত।"
+  },
+  "preset_name_duplicate_error": {
+    "message": "এই নামে একটি প্রিসেট ইতিমধ্যে বিদ্যমান।"
+  },
+  "guide_back": {
+    "message": "পিছনে"
+  },
+  "guide_next": {
+    "message": "পরবর্তী"
+  },
+  "guide_skip": {
+    "message": "এড়িয়ে যান"
+  },
+  "guide_finish": {
+    "message": "শেষ করুন"
+  },
+  "guide_theme_dark": {
+    "message": "গাঢ়"
+  },
+  "guide_theme_light": {
+    "message": "হালকা"
+  },
+  "guide_shortcuts_hint": {
+    "message": "সেটিংসে এই শর্টকাটগুলো পরিবর্তন করতে পারেন।"
+  },
+  "guide_canvas_hint": {
+    "message": "ইকুয়ালাইজার সাজাতে পয়েন্ট টানুন। সেটিংসে পয়েন্টের সংখ্যা পরিবর্তন করুন।"
+  },
+  "guide_volume_hint": {
+    "message": "সামগ্রিক ভলিউম সামঞ্জস্য করতে এই স্লাইডার ব্যবহার করুন।"
+  },
+  "guide_presets_hint": {
+    "message": "এখানে বর্তমান সেটআপ সংরক্ষণ করুন বা একটি প্রিসেট প্রয়োগ করুন।"
+  },
+  "donation_reminder_title": {
+    "message": "ডেভেলপারকে সহায়তা করুন"
+  },
+  "donation_reminder_message": {
+    "message": "এই এক্সটেনশনটি আপনার কাজে লাগলে, এর উন্নয়নে সহায়তা করতে পারেন।"
+  },
+  "donation_reminder_link": {
+    "message": "উন্নয়নে সহায়তা করুন"
   }
-}
+}

_locales/de/messages.json

@@ -3,7 +3,7 @@
     "message": "EQ Toolkit - Audio-Equalizer"
   },
   "extDescription": {
-    "message": "EQ Toolkit ist eine kostenlose Open-Source-Erweiterung zur Audiosteuerung."
+    "message": "Audio-Equalizer und Lautstärke-Booster für jeden Tab: Bass verstärken, Sound anpassen, Presets speichern."
   },
   "gain_slider_label": {
     "message": "Verstärkung:"
@@ -23,21 +23,24 @@
   "save_preset_button_label": {
     "message": "Preset speichern"
   },
-  "enter_preset_name": {
-    "message": "Name eingeben"
-  },
   "settings_title": {
     "message": "Einstellungen"
   },
   "presets_settings_title": {
     "message": "Voreinstellungen"
   },
+  "hide_default_presets_label": {
+    "message": "Standard-Presets ausblenden"
+  },
   "community_settings_title": {
     "message": "Community"
   },
   "help_with_translation_label": {
     "message": "Bei der Übersetzung helfen:"
   },
+  "translators_label": {
+    "message": "Übersetzer:"
+  },
   "source_code_label": {
     "message": "Quellcode:"
   },
@@ -48,7 +51,7 @@
     "message": "Voreinstellungen exportieren"
   },
   "enable_spectrum_setting_option": {
-    "message": "Spektrumvisualisierung aktivieren, Seite muss neu geladen werden (hohe CPU-Last)"
+    "message": "Spektrumvisualisierung aktivieren"
   },
   "points_count_setting_option": {
     "message": "Anzahl der EQ-Punkte"
@@ -78,7 +81,7 @@
     "message": "Der Equalizer ist bereits in einem Fenster geöffnet"
   },
   "support_me": {
-    "message": "Unterstütze mich"
+    "message": "Unterstütze mich:"
   },
   "settings_button_tooltip": {
     "message": "Einstellungen"
@@ -142,5 +145,68 @@
   },
   "shortcut_duplicate_error": {
     "message": "Dieses Tastenkürzel wird bereits von einem anderen Befehl verwendet."
+  },
+  "global_controls_title": {
+    "message": "Globale Steuerelemente"
+  },
+  "preset_controls_title": {
+    "message": "Voreinstellungen"
+  },
+  "save": {
+    "message": "Speichern"
+  },
+  "save_preset_modal_title": {
+    "message": "Voreinstellung speichern"
+  },
+  "preset_name_label": {
+    "message": "Name der Voreinstellung"
+  },
+  "preset_name_empty_error": {
+    "message": "Geben Sie einen Namen für die Voreinstellung ein."
+  },
+  "preset_name_reserved_error": {
+    "message": "Dieser Name ist für eine integrierte Voreinstellung reserviert."
+  },
+  "preset_name_duplicate_error": {
+    "message": "Eine Voreinstellung mit diesem Namen existiert bereits."
+  },
+  "guide_back": {
+    "message": "Zurück"
+  },
+  "guide_next": {
+    "message": "Weiter"
+  },
+  "guide_skip": {
+    "message": "Überspringen"
+  },
+  "guide_finish": {
+    "message": "Fertig"
+  },
+  "guide_theme_dark": {
+    "message": "Dunkel"
+  },
+  "guide_theme_light": {
+    "message": "Hell"
+  },
+  "guide_shortcuts_hint": {
+    "message": "Du kannst diese Tastenkürzel in den Einstellungen ändern."
+  },
+  "guide_canvas_hint": {
+    "message": "Ziehe die Punkte, um den Equalizer einzustellen. Die Anzahl kannst du in den Einstellungen ändern."
+  },
+  "guide_volume_hint": {
+    "message": "Mit diesem Regler passt du die Gesamtlautstärke an."
+  },
+  "guide_presets_hint": {
+    "message": "Hier kannst du die aktuelle Einstellung speichern oder ein Preset anwenden."
+  },
+  "donation_reminder_title": {
+    "message": "Unterstütze den Entwickler"
+  },
+  "donation_reminder_message": {
+    "message": "Wenn dir diese Erweiterung hilft, kannst du ihre Entwicklung unterstützen."
+  },
+  "donation_reminder_link": {
+    "message": "Entwicklung unterstützen"
   }
-}
+}