diff --git a/ACCESSIBILITY.md b/ACCESSIBILITY.md index 9aba4c5..ad65646 100644 --- a/ACCESSIBILITY.md +++ b/ACCESSIBILITY.md @@ -6,7 +6,7 @@ page zoomed, or with animation switched off. This file says what that means today: what the goal is, what has actually been tested, what is known not to work well yet, and how to tell us about a barrier. -**Last reviewed:** 2026-11-10, for version 1.2.1. +**Last reviewed:** 2026-11-18, for version 1.3.0. ## The goal @@ -34,8 +34,10 @@ The priorities, in order: |---|---| | Chrome 136 or later on Windows | Supported, and where the testing below was done | | Chrome 136 or later on macOS, Linux and ChromeOS | Supported; expected to work the same, not tested for accessibility | -| Edge, Brave, Vivaldi and Opera (the same build) | Best effort — the extension runs there, and accessibility is untested | +| Edge, Brave, Vivaldi and Opera (the same package as Chrome) | Best effort — the extension runs there, and accessibility is untested | +| Firefox 140 or later on the desktop (since 1.3.0, its own package) | Best effort — the extension runs there, and accessibility is untested | | Chrome on Android or iOS | Not applicable: Chrome there does not run extensions | +| Firefox for Android | Not applicable: it has no bookmarks API for extensions | ## What is in place @@ -132,8 +134,8 @@ limitations below). | What 1.2.1 changed: focus, Alt+↑/↓, button sizes | A scripted keyboard run in Chrome — no screen reader | November 2026, version 1.2.1 | | Colour contrast of the theme colours, reduced motion, the tree's key handling | Automated tests, on every change | Continuous | -**Not tested**, so we cannot tell you how well they work: anything on macOS, -Linux or ChromeOS; NVDA, JAWS, VoiceOver, ChromeVox and Orca; voice control +**Not tested**, so we cannot tell you how well they work: anything in Firefox +or Edge; anything on macOS, Linux or ChromeOS; NVDA, JAWS, VoiceOver, ChromeVox and Orca; voice control (Dragon, Voice Access, Voice Control); switch access; screen magnifiers; and zoom at 200 %. Narrator has not yet been run over what 1.2.1 added. If you use one of these, a report of what you found — good or bad — is @@ -158,6 +160,10 @@ These are known, and none of them is by design. - **Reordering with a pointer needs a drag.** There is a keyboard way (Alt+↑/↓) and Sort A→Z, but no click-only way to place one item before another. +- **Separators in Firefox are only drawn.** A line in a Firefox folder is + shown in the tree, but a screen reader is not told it is there, and the + "position n of m" counts bookmarks and folders only — so Alt+↑ or Alt+↓ past + a separator moves the row without changing the position you hear. - **Alt+↑/↓ may not reach the page on a Chromebook**, where the system can turn those keys into Page Up and Page Down. On a Mac there is no Menu key (use Shift+F10), and the laptop's delete key is Backspace, which the tree does @@ -203,7 +209,8 @@ accessibility report is treated as a defect, not a feature request. It helps to include: - what you were trying to do, and what happened instead; -- the BookmarkMagic version (About tab, or `chrome://extensions`); +- the BookmarkMagic version (About tab, `chrome://extensions`, or + `about:addons` in Firefox); - your browser and operating system; - the assistive technology you use and its version, if any — a screen reader, a contrast theme, zoom level, voice control; @@ -224,8 +231,8 @@ guarantees: - A report is acknowledged within about a week. - A **blocking** barrier is fixed ahead of other work and shipped in its own - patch release; Chrome then updates installed copies by itself, usually - within days of the store's review. + patch release; your browser then updates installed copies by itself, + usually within days of the store's review. - Anything else is scheduled, and added to the list above until it is fixed, so the next person can see it is known. - If a fix is not possible or not planned, you will be told why. diff --git a/BUILD.md b/BUILD.md new file mode 100644 index 0000000..2e2669b --- /dev/null +++ b/BUILD.md @@ -0,0 +1,63 @@ +# Building BookmarkMagic from source + +How to rebuild the packages attached to each +[GitHub Release](https://github.com/poli0981/bookmarkmagic/releases) — for +Firefox Add-ons reviewers, who must be able to reproduce the submitted package +from its sources, and for anyone who wants to check that a store build matches +this repository. + +## Requirements + +| Tool | Version | Where | +|---|---|---| +| Node.js | **26** (the version in `.nvmrc`; tested with 26.13) | | +| npm | the one bundled with Node.js 26 (11.x) | ships with Node.js | +| OS | any — Windows 11, macOS and Ubuntu all build the same files | | + +No other tool, account, network service or environment variable is needed +beyond what `npm ci` installs from `package-lock.json`. + +> **The Firefox sources archive omits dotfiles**, so `.nvmrc` and `.npmrc` are +> not in it. Use Node.js 26: an older Node may install but is not what the +> package was built with, and `package.json` says `"engines": { "node": ">=26" }`. + +## Steps + +```bash +npm ci # exactly the versions in package-lock.json +npm run zip:firefox # the Firefox package (and a sources archive) +npm run zip # the Chromium package (Chrome Web Store, Edge Add-ons) +``` + +`npm ci` runs one install script of this project's own, `wxt prepare`, which +generates the TypeScript configuration the build reads. (CI installs with +`--ignore-scripts` and runs `npx --no-install wxt prepare` itself; the result +is the same.) + +## Output + +| Command | Unpacked build | Package | +|---|---|---| +| `npm run zip:firefox` | `.output/firefox-mv3/` | `.output/bookmarkmagic--firefox.zip` | +| `npm run zip` | `.output/chrome-mv3/` | `.output/bookmarkmagic--chrome.zip` | + +Compare the **files inside** the package with the submitted one, not the +archives themselves: a zip records file times, so two builds of the same +commit hash differently while every entry is identical (`docs/09 §5`). + +## What the build does + +- [WXT](https://wxt.dev) bundles `src/` with Vite into plain JavaScript, CSS + and HTML. The code is **minified, not obfuscated**. +- The only third-party code compiled in is the Svelte runtime, its `clsx` + helper and WXT's one-line browser shim, all MIT + ([`legal/THIRD_PARTY_NOTICES.md`](legal/THIRD_PARTY_NOTICES.md)); the build + fails if anything else would ship. +- Nothing is downloaded at build time beyond `npm ci`, and the built extension + makes no network requests at all — its content security policy forbids them + ([`docs/08_MV3_COMPLIANCE.md`](docs/08_MV3_COMPLIANCE.md) §3). + +To check a build the way CI does: `npm run check:manifest` (Chromium) and +`npm run check:manifest -- --browser firefox` (Firefox) verify the manifest, +the permissions, the CSP, the file inventory and that no network API is in the +bundle. diff --git a/CHANGELOG.md b/CHANGELOG.md index 183b9b8..5339301 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -12,7 +12,53 @@ version bump). ## [Unreleased] -Nothing yet. +Firefox and Microsoft Edge, and maintenance mode. Permissions are unchanged +(`bookmarks` and `storage`), nothing is asked of you again, and on Chrome +there is nothing to do — your browser updates itself. This version also +carries everything listed under 1.2.1, which never reached the Chrome Web +Store on its own. + +### Added + +- **Firefox** (desktop, 140 or later), with a package of its own for Firefox + Add-ons — listing to come. The same features, the same two permissions and + the same no-network policy, which Firefox enforces just as Chrome does. + Firefox's **Bookmarks Menu** is a root like the others: Merge and Replace put + entries back where they came from, and the loose entries of a Firefox + export go into the menu, as Firefox itself does with them. +- **Microsoft Edge Add-ons** — the Chrome package, unchanged; listing to come. + Until then Edge installs from the Chrome Web Store. +- **Firefox separators** show in the Edit tab as lines. Nothing acts on them: + they are not focused, searched, counted, sorted across, or offered as + duplicates of each other. Sort A→Z sorts each run between two separators on + its own. +- Replace on Firefox says how many separators it will delete — no file + BookmarkMagic writes can keep one, so they do not come back with the backup. +- An import says how many separators the file held, and on Firefox skips — and + counts — any address longer than the 65,536 characters Firefox accepts, + before anything is written. + +### Changed + +- The About tab's store link is now **"Store listing"** and opens the store + your copy came from: the Chrome Web Store for the Chrome Web Store's copy, + Firefox Add-ons in Firefox, and otherwise the README's list of stores. +- Sentences that blamed Chrome for what every browser does now say "the + browser" — "The browser does not let an extension set a bookmark's original + date" — in all five languages; the note about skipped Firefox smart + bookmarks no longer calls them dead links. +- Copy diagnostics names the browser and its version (`"browser": "Firefox + 160"`) instead of only Chrome's. +- The project is in **maintenance mode** ([`MAINTENANCE.md`](MAINTENANCE.md)): + fixes, accessibility, translations, security and dependency updates, and + features that are already on the roadmap. + +### Packages + +Each GitHub Release now carries three files: `…-chrome.zip` (the Chrome Web +Store and Edge Add-ons), `…-firefox.zip` and `…-sources.zip` (what Firefox +Add-ons reviews), with `SHA256SUMS.txt` over all three. [`BUILD.md`](BUILD.md) +explains how to rebuild them. ## [1.2.1] — 2026-11-10 diff --git a/README.md b/README.md index deb590d..7a7325d 100644 --- a/README.md +++ b/README.md @@ -13,8 +13,9 @@ Move your bookmarks between browsers the simple way: with a file. No account, no cloud sync, 100% offline. -A Chrome (MV3) extension for importing, exporting and editing bookmarks and -folder trees. English · Tiếng Việt · 日本語 · 简体中文 · Română. +A browser extension (Manifest V3) for importing, exporting and editing +bookmarks and folder trees — for Chrome and the other Chromium browsers, and, +since 1.3.0, for Firefox. English · Tiếng Việt · 日本語 · 简体中文 · Română. ## Project status @@ -72,11 +73,11 @@ This is the whole point of the project, so it is worth being precise. - **No network access at all.** Not analytics, not telemetry, not update pings. There is no server, and the code makes no network calls. The browser backs - that up: the extension's content security policy makes Chrome refuse fetch, - XHR, WebSocket, EventSource and beacon requests, and remote images, fonts, - media and frames. On top of that, `npm run check:manifest` scans the shipped - bundle for network APIs (WebRTC included, which no CSP directive covers) and - `npm run guard` scans the source. + that up: the extension's content security policy — the same in Chrome, Edge + and Firefox — makes the browser refuse fetch, XHR, WebSocket, EventSource and + beacon requests, and remote images, fonts, media and frames. On top of that, + `npm run check:manifest` scans both shipped packages for network APIs (WebRTC + included, which no CSP directive covers) and `npm run guard` scans the source. - **Exactly two permissions**: `bookmarks` and `storage`. No host permissions, no content scripts, no background worker. Two gates enforce it: a unit test over `wxt.config.ts`, and `npm run check:manifest`, which CI runs against the @@ -98,28 +99,41 @@ Full policy: [`legal/PRIVACY.md`](legal/PRIVACY.md). ## Honest limitations - Favicons cannot be imported — the bookmarks API has no favicon field. -- Imported bookmarks get today's date. Chrome does not let an extension set a +- Imported bookmarks get today's date. Browsers do not let an extension set a bookmark's original creation date. Your **exported** files keep the real ones. +- **Firefox separators are not kept.** They show in the Edit tab as lines, but + no file BookmarkMagic writes can hold one: exports and backups leave them out, + imports skip the ones a file holds and say how many, and Replace — which + deletes them with everything else — tells you so before it starts. +- Firefox refuses bookmark addresses longer than 65,536 characters (they are + skipped, and counted) and shortens titles longer than 4,096. - CSV is a flattened view: empty folders and "which folder is the toolbar" are not preserved. Use HTML or JSON for a faithful backup. - Markdown is share-only — BookmarkMagic cannot read it back. ## Install -From the Chrome Web Store: [here](https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg) +| Browser | Where | Requires | +|---|---|---| +| Chrome, Brave, Vivaldi, Opera | [Chrome Web Store](https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg) | Chrome 136 or later (April 2025), or a Chromium browser of the same vintage | +| Microsoft Edge | Edge Add-ons — **not listed yet**; until it is, Edge installs from the Chrome Web Store link above | Edge 136 or later | +| Firefox (desktop) | Firefox Add-ons — **not listed yet**; the link will be here when it is | Firefox 140 or later. Firefox for Android has no bookmarks API for extensions | -Requires Chrome 136 or later (April 2025), or any Chromium browser of the same -vintage — Edge, Brave, Vivaldi, Opera. On an older browser the store keeps the -version you already have and simply stops updating it. +On an older browser the store keeps the version you already have and simply +stops updating it. -From source (Node.js 26): +Each [GitHub Release](https://github.com/poli0981/bookmarkmagic/releases) carries +the exact packages sent to the stores, with `SHA256SUMS.txt`. Firefox only +installs add-ons Mozilla has signed, so its `-firefox.zip` there is for +checking the store build, not for installing. + +From source (Node.js 26) — [`BUILD.md`](BUILD.md) has the details: ```bash -npm ci && npm run build +npm ci && npm run build # Chromium: load .output/chrome-mv3/ at chrome://extensions (Developer mode) +npm run build:firefox # Firefox: about:debugging → Load Temporary Add-on → .output/firefox-mv3/manifest.json ``` -Then load `.output/chrome-mv3/` at `chrome://extensions` with Developer mode on. - ## Development ```bash @@ -205,5 +219,5 @@ questions: copyright@poli0981.dev. The BookmarkMagic name and icon identify this project. The GPL lets anyone fork the code; it does not let a fork present itself as this project. -Not affiliated with or endorsed by Google, Chrome, Mozilla, Firefox or any -browser vendor. Browser names are trademarks of their respective owners. +Not affiliated with or endorsed by Google, Chrome, Mozilla, Firefox, +Microsoft, Edge or any browser vendor. Browser names are trademarks of their respective owners. diff --git a/SECURITY.md b/SECURITY.md index 74cb976..ed3ce12 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -4,13 +4,13 @@ | Version | Supported | |---|---| -| The latest version published on the Chrome Web Store | ✅ | +| The latest version published on the Chrome Web Store, Firefox Add-ons or Microsoft Edge Add-ons | ✅ | | Anything older | ❌ | There is no back-porting, and there is nothing for you to do to stay current: -Chrome auto-updates extensions once a new version passes store review. You can -see which version you are running in the extension's **About** tab, or on -`chrome://extensions`. +your browser updates extensions once a new version passes store review. You +can see which version you are running in the extension's **About** tab, on +`chrome://extensions`, or on `about:addons` in Firefox. ## Reporting a vulnerability diff --git a/store/listing.en.md b/store/listing.en.md index e8666e4..4935add 100644 --- a/store/listing.en.md +++ b/store/listing.en.md @@ -56,3 +56,33 @@ https://github.com/poli0981/bookmarkmagic `https://github.com/poli0981/bookmarkmagic/blob/main/legal/PRIVACY.md` **Distribution:** Public, all regions. + +## Firefox Add-ons and Microsoft Edge Add-ons (since v1.3.0) + +The description above, with the two bullets that name Chrome replaced by these — on Firefox and Edge they would not be true as written (Edge also refuses a listing that sells itself as a Chrome extension): + +``` +• Import bookmark files (HTML, JSON, CSV) — including the "Bookmarks" file + from the profile folder of a Chromium browser (Chrome, Edge, Brave…) and + Firefox JSON backups — with a full preview before anything is written: + counts, folders and duplicates first. +``` + +``` +• Imported bookmarks get today's date — browsers don't let extensions set a + bookmark's original creation date. Your exported files keep the real dates. +``` + +On Firefox Add-ons only, add to LIMITATIONS: + +``` +• Firefox separators are not kept: exports and backups leave them out, and + Replace deletes them (it tells you first). +``` + +**Firefox Add-ons:** summary = the summary above (AMO allows 250 characters) · +category *Bookmarks* · licence *GNU General Public License v3.0* · Firefox +(desktop) only — not Android · the same privacy-policy URL · support site: the +repository's issues. + +**Edge Add-ons:** category *Productivity* · the same privacy-policy URL. diff --git a/store/listing.ja.md b/store/listing.ja.md index c00b293..3f5024d 100644 --- a/store/listing.ja.md +++ b/store/listing.ja.md @@ -60,3 +60,33 @@ https://github.com/poli0981/bookmarkmagic 法的文書は英語のみです(`docs/14`)。プライバシーポリシーの URL は EN 版と 同じものを使います。 + +## Firefox Add-ons と Microsoft Edge Add-ons(v1.3.0 以降) + +上の説明文のうち、Chrome に触れている 2 項目を次のものに置き換えて使います(Firefox と Edge ではそのままでは正しくなく、Edge は Chrome 拡張機能として紹介するリスティングを受け付けません): + +``` +• ブックマークファイル(HTML、JSON、CSV)をインポートします。Chromium 系 + ブラウザ(Chrome、Edge、Brave など)のプロファイルフォルダにある + 「Bookmarks」ファイルや Firefox の JSON バックアップにも対応。書き込む前に + 必ずプレビューを表示し、件数・フォルダ・重複を先に確認できます。 +``` + +``` +• インポートしたブックマークの日付は本日になります。拡張機能がブックマーク + の元の作成日を設定することをブラウザが許可していないためです。エクスポート + したファイルには本来の日付が残ります。 +``` + +Firefox Add-ons のみ、「制限事項」に追加: + +``` +• Firefox の区切り線は保持されません。エクスポートとバックアップには含まれず、 + 置き換えでは削除されます(事前に表示されます)。 +``` + +**Firefox Add-ons:** 概要 = 上の概要 · カテゴリ *Bookmarks* · ライセンス +*GNU General Public License v3.0* · Firefox(デスクトップ)のみ · 同じ +プライバシーポリシー URL。 + +**Edge Add-ons:** カテゴリ *Productivity* · 同じプライバシーポリシー URL。 diff --git a/store/listing.ro.md b/store/listing.ro.md index 909d963..7c333b5 100644 --- a/store/listing.ro.md +++ b/store/listing.ro.md @@ -66,3 +66,34 @@ https://github.com/poli0981/bookmarkmagic Documentele juridice există doar în limba engleză (`docs/14`); URL-ul politicii de confidențialitate este același ca în versiunea în engleză. + +## Firefox Add-ons și Microsoft Edge Add-ons (din v1.3.0) + +Descrierea de mai sus, cu cele două puncte care numesc Chrome înlocuite de acestea — în Firefox și Edge n-ar fi adevărate așa cum sunt scrise (iar Edge refuză o pagină care se prezintă drept extensie Chrome): + +``` +• Importă fișiere de marcaje (HTML, JSON, CSV) — inclusiv fișierul „Bookmarks” + din dosarul profilului unui browser Chromium (Chrome, Edge, Brave…) și copiile + de rezervă JSON din Firefox — cu o previzualizare completă înainte de a scrie + ceva: numărul de marcaje, dosarele și duplicatele, de la început. +``` + +``` +• Marcajele importate primesc data de azi — browserele nu permit extensiilor să + seteze data originală de creare a unui marcaj. Fișierele exportate păstrează + datele reale. +``` + +Doar pentru Firefox Add-ons, adăugați la LIMITĂRI: + +``` +• Separatoarele din Firefox nu se păstrează: exporturile și copiile de rezervă le + omit, iar înlocuirea le șterge (vă anunță înainte). +``` + +**Firefox Add-ons:** rezumat = rezumatul de mai sus · categoria *Bookmarks* · +licența *GNU General Public License v3.0* · doar Firefox (desktop) · același +URL al politicii de confidențialitate. + +**Edge Add-ons:** categoria *Productivity* · același URL al politicii de +confidențialitate. diff --git a/store/listing.vi.md b/store/listing.vi.md index 0ff7eee..184357a 100644 --- a/store/listing.vi.md +++ b/store/listing.vi.md @@ -55,3 +55,32 @@ https://github.com/poli0981/bookmarkmagic Lưu ý: các tài liệu pháp lý chỉ có bản tiếng Anh (`docs/14`), nên URL chính sách riêng tư giống hệt bản EN. + +## Firefox Add-ons và Microsoft Edge Add-ons (từ v1.3.0) + +Dùng phần mô tả ở trên, thay hai gạch đầu dòng có nhắc Chrome bằng hai dòng sau — trên Firefox và Edge, viết như cũ sẽ không đúng (Edge cũng từ chối listing tự giới thiệu là tiện ích Chrome): + +``` +• Nhập tệp bookmark (HTML, JSON, CSV) — kể cả tệp "Bookmarks" trong thư mục + hồ sơ của trình duyệt Chromium (Chrome, Edge, Brave…) và bản sao lưu JSON + của Firefox — và xem trước đầy đủ trước khi ghi bất cứ thứ gì: số lượng, + thư mục và mục trùng lặp. +``` + +``` +• Bookmark được nhập vào sẽ mang ngày hôm nay — trình duyệt không cho phép tiện + ích đặt lại ngày tạo gốc của một bookmark. Các tệp bạn xuất ra vẫn giữ ngày thật. +``` + +Riêng Firefox Add-ons, thêm vào phần GIỚI HẠN: + +``` +• Đường phân cách của Firefox không được giữ: tệp xuất và bản sao lưu bỏ qua + chúng, và chế độ Thay thế sẽ xóa chúng (có báo trước). +``` + +**Firefox Add-ons:** tóm tắt = phần tóm tắt ở trên · danh mục *Bookmarks* · +giấy phép *GNU General Public License v3.0* · chỉ Firefox (máy tính) · cùng +URL chính sách quyền riêng tư. + +**Edge Add-ons:** danh mục *Productivity* · cùng URL chính sách quyền riêng tư. diff --git a/store/listing.zh_CN.md b/store/listing.zh_CN.md index e9cf906..cd26d70 100644 --- a/store/listing.zh_CN.md +++ b/store/listing.zh_CN.md @@ -54,3 +54,30 @@ https://github.com/poli0981/bookmarkmagic ``` 法律文件仅有英文版本(`docs/14`),隐私政策 URL 与英文版相同。 + +## Firefox Add-ons 与 Microsoft Edge Add-ons(v1.3.0 起) + +使用上面的描述,并把提到 Chrome 的两条换成下面两条——原文在 Firefox 和 Edge 上并不成立(Edge 也不接受把自己介绍为 Chrome 扩展程序的页面): + +``` +• 导入书签文件(HTML、JSON、CSV)——包括 Chromium 内核浏览器(Chrome、Edge、 + Brave 等)个人资料文件夹中的“Bookmarks”文件和 Firefox 的 JSON 备份。写入 + 任何内容之前都会先完整预览:数量、文件夹和重复项一目了然。 +``` + +``` +• 导入的书签日期为今天——浏览器不允许扩展程序设置书签的原始创建日期。 + 您导出的文件会保留真实日期。 +``` + +仅 Firefox Add-ons:在“限制”中添加: + +``` +• Firefox 的分隔线不会保留:导出和备份都不包含分隔线,替换模式会删除它们 + (事先会提示)。 +``` + +**Firefox Add-ons:** 摘要 = 上面的摘要 · 类别 *Bookmarks* · 许可证 +*GNU General Public License v3.0* · 仅限 Firefox(桌面版)· 相同的隐私政策 URL。 + +**Edge Add-ons:** 类别 *Productivity* · 相同的隐私政策 URL。