Compare commits
7
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
8659d4b069 | ||
|
|
28c27154ac | ||
|
|
ce97979706 | ||
|
|
1657646b01 | ||
|
|
bcc4c81a8c | ||
|
|
46093b7bd1 | ||
|
|
938ad5d8ab |
No files matched your search
+5
-1
@@ -12,7 +12,11 @@ version bump).
|
||||
|
||||
## [Unreleased]
|
||||
|
||||
Nothing yet.
|
||||
### Changed
|
||||
|
||||
- **About → Store listing** on a copy installed from Microsoft Edge Add-ons now
|
||||
opens BookmarkMagic's Edge Add-ons page, live since 2026-11-19. Until now it
|
||||
opened the install section of the project's README.
|
||||
|
||||
## [1.3.0] — 2026-11-18
|
||||
|
||||
|
||||
@@ -1,6 +1,7 @@
|
||||
# CLAUDE.md — Build Instructions (BookmarkMagic)
|
||||
|
||||
A Chrome MV3 extension: offline bookmark import/export/edit.
|
||||
A Chrome MV3 extension — and since v1.3.0 a Firefox one, and on Edge Add-ons —
|
||||
for offline bookmark import/export/edit.
|
||||
This file is the entry point; the `docs/` suite is the specification.
|
||||
**When code and docs disagree, docs win — or stop and ask.**
|
||||
|
||||
@@ -10,7 +11,10 @@ This file is the entry point; the `docs/` suite is the specification.
|
||||
> (v1.0.0 live by 2026-08-03; v1.0.1 live, confirmed on the listing
|
||||
> 2026-10-28; v1.1.0 live, confirmed on the listing 2026-11-06; v1.2.0 live,
|
||||
> confirmed on the listing 2026-11-10; v1.2.1 released on GitHub 2026-11-10,
|
||||
> ⚠️ not yet submitted).
|
||||
> never submitted on its own; v1.3.0 — Firefox and Edge, 1.2.1 included —
|
||||
> released on GitHub and submitted to all three stores 2026-11-18, **live on
|
||||
> Edge Add-ons and the Chrome Web Store 2026-11-19**, ⚠️ in review on Firefox
|
||||
> Add-ons).
|
||||
> Phases 0–9 are complete; since 2026-11-18 the project is in **maintenance
|
||||
> mode** — `/MAINTENANCE.md` is the policy (Phase 10 below).
|
||||
> That changes the rules of the game:
|
||||
@@ -41,7 +45,7 @@ This file is the entry point; the `docs/` suite is the specification.
|
||||
| docs/05_ALGORITHMS.md | Parser walk, normalize, dedupe, diff, write queue |
|
||||
| docs/06_UI.md | Tokens, layouts per tab, component inventory, a11y (§5 is the spec behind `/ACCESSIBILITY.md`) |
|
||||
| docs/07_I18N.md | chrome.i18n vs runtime store split, EN/VI/JA rules |
|
||||
| docs/08_MV3_COMPLIANCE.md | Manifest, permissions (bookmarks+storage ONLY), CWS rules |
|
||||
| docs/08_MV3_COMPLIANCE.md | Manifest, permissions (bookmarks+storage ONLY), CWS rules; Firefox §9, Edge §10 |
|
||||
| docs/09_SECURITY_PRIVACY.md | Threat model T1–T8, secure-coding bans |
|
||||
| docs/10_CODING_STANDARDS.md | Size limits, tsconfig, biome.json, knip.json, conventions |
|
||||
| docs/11_TESTING.md | Coverage gates, fixtures, suites, manual QA |
|
||||
@@ -222,6 +226,27 @@ with a write token, for pull requests from forks.** It checks out the base
|
||||
branch and only compares event text with constants. Never add a checkout of
|
||||
the pull request's head, a step that runs its code, or a `${{ }}` of a title
|
||||
or body inside a `run:` line to that file.
|
||||
Two more, from the port. **There is no Firefox in CI**: the fake's Firefox
|
||||
flavour (`11 §4`) is a reading of Firefox's source, not evidence, so a change
|
||||
to roots, separators or move indices needs a real Firefox before an AMO
|
||||
upload. And **every change now ships in two packages**: `verify:full` builds
|
||||
and checks both (`build:firefox`, `check:manifest -- --browser firefox`), and a
|
||||
string that names Chrome is false in one of them.
|
||||
**Exit:** ✔ v1.3.0 tagged and released 2026-11-18 (signed tag on `80c7190`,
|
||||
three checksum-verified packages; PR #44 merged at the reviewed head).
|
||||
Human-only ⚠️ (`00 §10` items 19–26): the `11 §5` passes — Chrome with the
|
||||
**1.2.0 → 1.3.0 upgrade over an existing profile**, a real Firefox 140+, Edge
|
||||
signed in with sync on — then the Chrome Web Store upload of 1.3.0 in place
|
||||
of 1.2.1, the first Firefox Add-ons version and the first Edge submission by
|
||||
hand, the store environments if automation is wanted, and native review.
|
||||
The three uploads went up 2026-11-18; Edge and the Chrome Web Store approved
|
||||
2026-11-19, Firefox Add-ons is in review. **An Edge copy's About link is chosen
|
||||
by its CRX ID** (`links.ts`), so the listing ids in `00 §9` are code, not
|
||||
trivia. And **since 2026-11-19 a pushed `v*` tag is a store submission**:
|
||||
every `*_AUTOPUBLISH` variable is `true`, and no store environment has a
|
||||
required reviewer yet (`00 §10` item 23 has the state). Treat a tag as an
|
||||
upload to users' browsers, and have the owner's go for that release before
|
||||
pushing one.
|
||||
|
||||
## Working style
|
||||
|
||||
|
||||
@@ -8,6 +8,7 @@
|
||||
[](https://sonarcloud.io/summary/new_code?id=poli0981_bookmarkmagic)
|
||||
[](https://sonarcloud.io/summary/new_code?id=poli0981_bookmarkmagic)
|
||||
[](https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg)
|
||||
[](https://microsoftedge.microsoft.com/addons/detail/nchfchjnlihbifggooggpmmacighmdjg)
|
||||
[](#privacy)
|
||||
|
||||
Move your bookmarks between browsers the simple way: with a file. No account,
|
||||
@@ -120,7 +121,7 @@ Full policy: [`legal/PRIVACY.md`](legal/PRIVACY.md).
|
||||
| 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 |
|
||||
| Microsoft Edge | [Edge Add-ons](https://microsoftedge.microsoft.com/addons/detail/nchfchjnlihbifggooggpmmacighmdjg) | 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 |
|
||||
|
||||
On an older browser the store keeps the version you already have and simply
|
||||
|
||||
+55
-19
@@ -1,7 +1,9 @@
|
||||
# 00 — Project Overview
|
||||
|
||||
> **Project:** BookmarkMagic
|
||||
> **Type:** Chrome/Chromium MV3 browser extension (open source, Chrome Web Store)
|
||||
> **Type:** MV3 browser extension for Chromium browsers and, since v1.3.0,
|
||||
> Firefox (open source; Chrome Web Store and, since 2026-11-19, Microsoft Edge
|
||||
> Add-ons — Firefox Add-ons pending its first review)
|
||||
> **Owner:** poli0981 (GitHub) / SkullMute
|
||||
> **Repo:** `poli0981/bookmarkmagic` ✔
|
||||
> **License:** GPL-3.0-or-later
|
||||
@@ -24,14 +26,25 @@
|
||||
>
|
||||
> **v1.2.0 is PUBLISHED.** Tagged and released 2026-11-06 (signed tag on
|
||||
> `e2f36bc`); the listing was observed showing **version 1.2.0** (`Updated:
|
||||
> November 7, 2026`, 5 languages) on 2026-11-10. Installed users are on 1.2.0.
|
||||
> November 7, 2026`, 5 languages) on 2026-11-10. It was the store's version
|
||||
> until 1.3.0 replaced it on 2026-11-19.
|
||||
>
|
||||
> **v1.2.1 — accessibility — is RELEASED on GitHub, not yet on the store.**
|
||||
> Tagged and released 2026-11-10 (signed tag on `d61318a`, checksum-verified
|
||||
> zip): an accessibility statement (`/ACCESSIBILITY.md`) and the fixes an
|
||||
> audit found (`06 §5`). ⚠️ It still needs the owner's manual pass, including
|
||||
> the 1.2.0 → 1.2.1 upgrade over an existing profile, and a hand upload to
|
||||
> the store (`13 §1b`); until it clears review, installed users stay on 1.2.0.
|
||||
> **v1.2.1 — accessibility — is RELEASED on GitHub, never on a store on its
|
||||
> own.** Tagged and released 2026-11-10 (signed tag on `d61318a`,
|
||||
> checksum-verified zip): an accessibility statement (`/ACCESSIBILITY.md`) and
|
||||
> the fixes an audit found (`06 §5`). 1.3.0 carries all of it and went to the
|
||||
> Chrome Web Store in its place (submitted 2026-11-18, live 2026-11-19).
|
||||
>
|
||||
> **v1.3.0 — Firefox and Edge — is RELEASED, and LIVE on the Chrome Web
|
||||
> Store and Edge Add-ons.** Tagged and released 2026-11-18 (signed tag on
|
||||
> `80c7190`, three checksum-verified packages): a Firefox package (desktop,
|
||||
> 140 or later), and the Chrome package for Edge Add-ons as well, with 1.2.1
|
||||
> inside. The owner submitted it to all three stores on 2026-11-18. **Edge
|
||||
> Add-ons approved it on 2026-11-19** — the first Edge version, live in five
|
||||
> languages (§9 has the listing). **The Chrome Web Store approved it the same
|
||||
> day**: the listing shows version 1.3.0 (`Updated: November 19, 2026`, 4
|
||||
> users), so installed Chrome users move from 1.2.0 to 1.3.0 by themselves.
|
||||
> ⚠️ The first Firefox Add-ons version is still in review (§10 item 21).
|
||||
>
|
||||
> The project is now in **maintenance**, not construction: every change from
|
||||
> here reaches installed users through a store review, so it needs a version
|
||||
@@ -43,7 +56,7 @@
|
||||
> upgrades, bug/UI/UX/accessibility/translation fixes, and features only when
|
||||
> they are on `15`'s roadmap or genuinely needed; requests for anything else
|
||||
> are closed by `triage.yml` (`12 §2.6`).
|
||||
> **Doc suite version:** 1.12 (2026-11-18 — maintenance mode)
|
||||
> **Doc suite version:** 1.13 (2026-11-18 — Firefox and Edge, v1.3.0)
|
||||
|
||||
---
|
||||
|
||||
@@ -183,6 +196,9 @@ Derived identifiers (canonical across docs and code):
|
||||
| Safety-backup filename | `bookmarkmagic-backup-YYYYMMDD-HHmm.json` |
|
||||
| Chrome Web Store item id | `eghnciphhegekmnofffpgbdfefckdhmg` (also the value `CHROME_EXTENSION_ID` needs — `12 §3`) |
|
||||
| Store listing URL | `https://chromewebstore.google.com/detail/bookmarkmagic/eghnciphhegekmnofffpgbdfefckdhmg` |
|
||||
| Edge Add-ons item id ("CRX ID") | `nchfchjnlihbifggooggpmmacighmdjg` — the `runtime.id` of an install from Edge Add-ons, mapped in `links.ts` (`06 §3.5`) |
|
||||
| Edge Add-ons Product ID | `3bf2e086-99ee-4f8b-a8db-e13827f04ca1` (the value `EDGE_PRODUCT_ID` needs — `12 §3`) · Store ID `0RDCKC9LZ41P` |
|
||||
| Edge Add-ons listing URL | `https://microsoftedge.microsoft.com/addons/detail/nchfchjnlihbifggooggpmmacighmdjg` (live 2026-11-19) |
|
||||
|
||||
## 10. Manual action items (human-only) ⚠️
|
||||
|
||||
@@ -291,26 +307,46 @@ Derived identifiers (canonical across docs and code):
|
||||
### v1.3.0 — maintenance mode, Firefox and Edge (added 2026-11-18)
|
||||
|
||||
19. ⚠️ **Pin the maintenance announcement** (Discussions #43) — the API cannot.
|
||||
20. ⚠️ **v1.3.0 to the Chrome Web Store** instead of 1.2.1, which never went
|
||||
up: the `11 §5` pass with the **1.2.0 → 1.3.0 upgrade over an existing
|
||||
profile**, then the Chrome package from the Release (`13 §1b`). The CWS
|
||||
listing text may keep its Chrome wording; it is the Chrome store.
|
||||
21. ⚠️ **The first Firefox Add-ons version, by hand** (`13 §8`): the `11 §5`
|
||||
Firefox section on a real Firefox 140+, then the Developer Hub upload of
|
||||
20. ✔ **v1.3.0 to the Chrome Web Store** instead of 1.2.1, which never went
|
||||
up — submitted 2026-11-18, **live 2026-11-19** (the listing shows version
|
||||
1.3.0). The CWS listing text may keep its Chrome wording; it is the
|
||||
Chrome store. ⚠️ Still open: the `11 §5` pass with the **1.2.0 → 1.3.0
|
||||
upgrade over an existing profile** has no recorded result — installed
|
||||
users are taking that upgrade now — and neither has `13 §1b` step 10, the
|
||||
published build on a clean profile.
|
||||
21. ⚠️ **The first Firefox Add-ons version, by hand** (`13 §8`) — **submitted
|
||||
2026-11-18, in review**. The `11 §5` Firefox section on a real Firefox
|
||||
140+, then the Developer Hub upload of
|
||||
the Firefox package **and** the sources archive, desktop only, with
|
||||
`BUILD.md` in the notes to reviewers. AMO's upload validator report is the
|
||||
first outside check of the package.
|
||||
22. ⚠️ **The first Edge Add-ons submission, by hand** (`13 §9`): a Partner
|
||||
Center account, the `11 §5` Edge items — above all a profile **signed in
|
||||
with sync on** (`08 §10`, unverified) — then the Chrome package.
|
||||
22. ✔ **The first Edge Add-ons submission, by hand** (`13 §9`) — submitted
|
||||
2026-11-18, **approved and live 2026-11-19** (§9). Partner Center flagged
|
||||
the first description for naming another browser; the Edge copy now names
|
||||
none (PR #47, `08 §10`). ⚠️ Still open: the `11 §5` Edge items have no
|
||||
recorded result — above all a profile **signed in with sync on**
|
||||
(`08 §10`, unverified). An Edge user who meets `NO_WRITABLE_ROOTS` would be
|
||||
the first sign.
|
||||
23. ⚠️ **Store automation, when wanted** (`12 §3`): the three environments,
|
||||
each with a required reviewer, deployments limited to `v*` tags, and its
|
||||
secrets (Chrome: API v2 service
|
||||
account; AMO: JWT pair; Edge: API key + Client ID, renewed every 72 days),
|
||||
then the `*_AUTOPUBLISH` variables.
|
||||
**State on 2026-11-19:** all three `*_AUTOPUBLISH` variables are `true`,
|
||||
so **a pushed `v*` tag is now a store submission**.
|
||||
- `chrome-web-store` and `edge-add-ons` exist, with their secrets and the
|
||||
`v*` tag rule, but ⚠️ with **no required reviewer**. A tag therefore
|
||||
uploads to both stores with no approval step.
|
||||
- ⚠️ `firefox-add-ons` does not exist and has no secrets. The next tag's
|
||||
`store-firefox` job would fail, and GitHub would create the environment
|
||||
with no rules. Until the JWT pair is in place, either create the
|
||||
environment with its secrets or set `AMO_AUTOPUBLISH` to `false`.
|
||||
24. ⚠️ **After the listings go live**: their URLs for the README and the
|
||||
About link (`06 §3.5` — Edge's needs its listing id), and the AMO/Edge
|
||||
badges.
|
||||
badges. **Edge ✔ 2026-11-19**: README install table and badge, and the
|
||||
About link's mapping (ships with the next release — CHANGELOG
|
||||
`[Unreleased]`). AMO still to come: its About link is already the gecko-id
|
||||
URL, so only the README row and a badge remain.
|
||||
25. ⚠️ **Evidence for the Firefox fake** (`11 §4`): a sanitized `getTree()`
|
||||
dump from a real Firefox 140+ profile, committed as a fixture the fake is
|
||||
checked against; and a Firefox column in `11 §6`'s parse timing.
|
||||
|
||||
@@ -30,7 +30,7 @@
|
||||
| svelte-check | ^4.7.8 | Type/template authority for `.svelte` files. Runs on the TS 6 API (see TypeScript above). |
|
||||
| **@types/node** | **^26** (matches the Node major) | Types for `node:fs`, `node:path`, `node:child_process` and `process`, which the test suite and `scripts/*.mjs` genuinely use. **Declared explicitly since 2026-08-03** — it used to arrive transitively, and WXT 0.21 stopped providing it. Types only: erased at build, so hard rule 2 (zero *runtime* dependencies) is untouched. |
|
||||
| jsdom | **^31.0** (was ^30 through v1.2.1, ^29 through v1.0.0) | Test DOM. Not interchangeable — `02 §3` picks jsdom over happy-dom because the Netscape walk depends on parse5's implied-end-tag behaviour. A major bump runs `tests/unit/dom-environment.test.ts` first; if that canary fails, pin rather than loosen the test. |
|
||||
| **Knip** | **^6** (6.44.2 as of 2026-11-18) | Dead code: unused files, exports, dependencies. Requires Node ≥ 20.19. v6 swapped the TypeScript backend for oxc-parser — confirm `compilers.svelte` is still the supported `.svelte` hook before scaffold (`10 §4`). |
|
||||
| **Knip** | **^6** (6.45.1 as of 2026-11-18) | Dead code: unused files, exports, dependencies. Requires Node ≥ 20.19. v6 swapped the TypeScript backend for oxc-parser — confirm `compilers.svelte` is still the supported `.svelte` hook before scaffold (`10 §4`). |
|
||||
| **Vitest** | **^5.1.0** (was ^4 through v1.0.1) | Unit tests. 5.0 changed `clearMocks` to default `true`, requires `vi.mock` at top level and fails unawaited async assertions; the suite needed no changes. Requires Node ≥ 22.12. |
|
||||
| @vitest/coverage-v8 | match Vitest | Coverage reporting (`text` + `lcov` for SonarCloud, `12 §2.5`). |
|
||||
|
||||
|
||||
+6
-4
@@ -398,10 +398,12 @@ only route a user has from inside the product to rate or review it, which
|
||||
`13 §6` depends on. Since v1.3.0 one package serves the Chrome Web Store and
|
||||
Edge Add-ons, so the link is chosen at run time (`links.ts` `storeUrlFor`):
|
||||
the Firefox build → the AMO listing, addressed by the gecko id; a Chromium
|
||||
copy whose `runtime.id` is the Chrome Web Store item id (`00 §9`) → that
|
||||
listing; anything else — an Edge Add-ons install, an unpacked build → the
|
||||
README's install section, which lists every store. The label was "Chrome Web
|
||||
Store" until then.
|
||||
copy whose `runtime.id` is a store's item id (`00 §9`) → that store's
|
||||
listing — the Chrome Web Store's, or Edge Add-ons' (mapped after the listing
|
||||
went live on 2026-11-19, so from the release after 1.3.0); anything else — an
|
||||
unpacked build → the README's install section, which lists every store. 1.3.0
|
||||
itself sends an Edge Add-ons install to that section, which links the Edge
|
||||
listing too. The label was "Chrome Web Store" until v1.3.0.
|
||||
|
||||
**No email address appears anywhere in the product.** Since v1.1.0 the
|
||||
project's addresses are per purpose (`security@` in `SECURITY.md`, `privacy@` in
|
||||
|
||||
@@ -281,9 +281,18 @@ browser_specific_settings: {
|
||||
`minimum_chrome_version` included (Edge versions follow Chromium's, so
|
||||
136 means Edge 136). The zip uploaded to Edge is the same Release asset as
|
||||
the Chrome one, with the same checksum.
|
||||
- Partner Center rejects a listing whose name or description sells it as a
|
||||
Chrome extension; the Edge listing copy (`13 §3`) is reworded to name
|
||||
Chromium-based browsers where it has to mention Chrome's file format.
|
||||
- **The listing names no other browser.** Edge's developer policy (1.1.2)
|
||||
says an extension "must not reference other browsers", and Partner Center
|
||||
warns on any browser name in a description — on 2026-11-18 it flagged
|
||||
"Firefox" in the first Edge copy, which was the Chrome Web Store
|
||||
description with two bullets swapped and still listed seven browsers. The
|
||||
Edge copy in `store/listing.*.md` is now a complete description of its own:
|
||||
the profile `Bookmarks` file is the one "Edge and similar browsers keep",
|
||||
HTML export is the file "every major browser can import", and
|
||||
`tests/unit/store-listing.test.ts` fails on a name pasted back in. The same
|
||||
policy (1.5.2) asks that the privacy policy refer "primarily" to Edge;
|
||||
`legal/PRIVACY.md` names all three stores. That is a *should*, so it is left
|
||||
as it is unless review raises it.
|
||||
- Edge's bookmarks API is Chromium's: the same roots ("Favorites bar", "Other
|
||||
favorites"), `folderType` included. Whether Edge marks the roots of a
|
||||
signed-in, syncing profile with `syncing: true` — which would leave no
|
||||
|
||||
@@ -278,6 +278,11 @@ them is tested where it lives:
|
||||
and the issue chooser; every key `tree-keyboard.ts` switches on has a row;
|
||||
it states a goal and an untested list, and it is dated. It cannot tell
|
||||
whether a sentence is *true* — that is `§5`'s last item.
|
||||
- **`store-listing.test.ts`** (2026-11-18, after v1.3.0) — the Edge Add-ons
|
||||
copy in every `store/listing.*.md`: one complete description under the Edge
|
||||
heading, 250 to 5,000 characters (Partner Center's range), naming no browser
|
||||
but Edge (`08 §10`, `13 §9`). The same pattern has to find the browsers the
|
||||
Chrome Web Store copy lists, so it cannot pass by matching nothing.
|
||||
- **`tests/unit/scripts/`** — the repo's own gates, tested like code. New in
|
||||
v1.1.0: `guard.test.ts` (`08 §3`), `check-manifest.test.ts` (a correct build
|
||||
passes, one without the CSP fails) and `sanitize-formats.test.ts` (the
|
||||
|
||||
@@ -333,13 +333,18 @@ Still ship the fix forward.
|
||||
Edge marks syncing roots).
|
||||
3. Partner Center → Edge → **Create new extension** → upload the Release's
|
||||
`bookmarkmagic-X.Y.Z-chrome.zip` — the Chrome package, unchanged.
|
||||
4. Listing from `store/listing.<lang>.md`'s **Edge** block (it avoids selling
|
||||
the extension as a Chrome one, `08 §10`); category *Productivity*; privacy
|
||||
answers as `08 §5`; privacy policy URL as above; screenshots from
|
||||
`store/screenshots/`.
|
||||
4. Listing from `store/listing.<lang>.md`'s **Microsoft Edge Add-ons**
|
||||
section: a complete description of its own, pasted whole, that names no
|
||||
browser but Edge (Edge's policy 1.1.2 — Partner Center warns on any other
|
||||
browser's name, `08 §10`); category *Productivity*; privacy answers as
|
||||
`08 §5`; privacy policy URL as above; screenshots from `store/screenshots/`.
|
||||
5. Submit; record the outcome in `15`. Note the **Product ID** on the
|
||||
extension's overview page — `EDGE_PRODUCT_ID` — and the listing URL, which
|
||||
the About link and the README can then use (`06 §3.5`).
|
||||
the About link and the README can then use (`06 §3.5`). The About link
|
||||
matches the **CRX ID** (the `runtime.id` an install reports), not the
|
||||
Product ID.
|
||||
Done for 1.3.0: submitted 2026-11-18, live 2026-11-19 — ids and listing
|
||||
in `00 §9`.
|
||||
|
||||
**Later versions:** by hand (*Update* → upload the new package), or from
|
||||
`release.yml`'s `store-edge` job once `edge-add-ons` has its secrets and
|
||||
|
||||
+6
-1
@@ -40,8 +40,13 @@ Build-phase breakdown lives in `CLAUDE.md` (single source for sequencing).
|
||||
| **v1.2.0 published** | ✔ observed 2026-11-10 | the listing shows version 1.2.0 (`Updated: November 7, 2026`), 3 users, "5 languages" — English, Tiếng Việt, română, 中文(中国), 日本語. ⚠️ As for 1.0.1 and 1.1.0, `13 §1b` step 10 (clean-profile install of the published build + upgrade re-check) has no recorded result |
|
||||
| 9 — v1.2.1 accessibility | ✔ 2026-11-10 | `ACCESSIBILITY.md` and its intake (issue form, PR checklist, `accessibility@`); the defects an audit of `src/` found that a keyboard-and-Narrator pass had not — an invisible focus ring on the theme control, no forced-colours support, drag-only reordering (Alt+↑/↓), focus dropped on `<body>` in three places, targets under 24 px; dependency sync after Dependabot #31/#32/#35/#36 (`06 §5`) |
|
||||
| **v1.2.1 released** | ✔ 2026-11-10 | PR #37, merged at the head that was reviewed. Signed tag on `d61318a`, GitHub Release with a `sha256sum -c`-verified zip (`4975b5df…ca13254`, 106 290 bytes). Its manifest differs from 1.2.0's only in `version`, and the file inventory is the same. SonarCloud's new-code gate failed the first push at 73.6 % — the live-sync wiring moved out of `EditTab` had no test — and passed once it had one. `announce` and store publish skipped (variables unset) |
|
||||
| **v1.2.1 submitted** | ⚠️ pending — or skipped | owner: the `11 §5` pass incl. the **1.2.0 → 1.2.1 upgrade over an existing profile**, a Windows contrast theme and a screen-reader pass over Alt+↑/↓, then the zip upload (`13 §1b`). 1.3.0 contains all of 1.2.1, so uploading 1.3.0 instead is the shorter path (`00 §10` item 20) |
|
||||
| **v1.2.1 submitted** | skipped — 1.3.0 went up in its place on 2026-11-18 | owner: the `11 §5` pass incl. the **1.2.0 → 1.2.1 upgrade over an existing profile**, a Windows contrast theme and a screen-reader pass over Alt+↑/↓, then the zip upload (`13 §1b`). 1.3.0 contains all of 1.2.1, so uploading 1.3.0 instead is the shorter path (`00 §10` item 20) |
|
||||
| 10 — maintenance mode, Firefox + Edge | ✔ 2026-11-18 | PR #42: Dependabot #39–#41 and their hand sync, the unfixable `picomatch` advisory recorded, a lockfile licence gate, `MAINTENANCE.md` with a feature form that classifies and `triage.yml` that closes out-of-policy requests, Qodana (`qodana-js`) beside SonarCloud — 27 first-run findings, none a defect. PR #44: Firefox and Edge Add-ons — Firefox's roots by GUID and the Bookmarks Menu as a fourth root, separators recognised by type, each browser's move index, Firefox's address limit, a second (Firefox) package with its own manifest gate, three store jobs in their own environments (CWS API v2), `BUILD.md` (the sources archive rebuilt the package byte for byte) |
|
||||
| **v1.3.0 released** | ✔ 2026-11-18 | PR #44, merged at the head that was reviewed (`42c78ec`; `main`'s tree identical). Signed tag on `80c7190`, GitHub Release with three packages and `SHA256SUMS.txt`, each `sha256sum -c`-verified after download — chrome `89c01451…fb921561` (107 946 bytes), firefox `45db6de9…8c09ef71` (108 100 bytes), sources `76799878…5fd6a4a4` (413 081 bytes). The Chrome manifest differs from 1.2.1's in `version` alone; the Firefox one adds `browser_specific_settings.gecko` and has no `minimum_chrome_version`. The store jobs and `announce` skipped (variables unset) |
|
||||
| **v1.3.0 submitted** | ✔ 2026-11-18 | by the owner, to all three stores: the Chrome Web Store (in place of 1.2.1), the first Firefox Add-ons version and the first Edge Add-ons submission. Partner Center flagged the first Edge description for naming another browser — the Edge copy now names none (PR #47). ⚠️ The `11 §5` passes (`00 §10` items 20–22) have no recorded result |
|
||||
| **v1.3.0 on Edge Add-ons** | ✔ live 2026-11-19 | approved on the first submission: listing `microsoftedge.microsoft.com/addons/detail/nchfchjnlihbifggooggpmmacighmdjg`, category Productivity, public, five languages. Policy 1.5.2 (a privacy policy that refers "primarily" to Edge, `08 §10`) did not block it. README install row and badge, and the About link's mapping for the next release, followed the same day (`00 §10` item 24) |
|
||||
| **v1.3.0 on the Chrome Web Store** | ✔ live 2026-11-19 | approved; the listing shows version 1.3.0 (`Updated: November 19, 2026`), 4 users — the first update since 1.2.0, and it carries 1.2.1 too. ⚠️ As for every version since 1.0.1, the `11 §5` upgrade pass and `13 §1b` step 10 have no recorded result |
|
||||
| **v1.3.0 on Firefox Add-ons** | ⚠️ in review | the first version (`00 §10` item 21) |
|
||||
|
||||
**Verified on real browsers 2026-07-25:** Chrome and Brave, unpacked build.
|
||||
Until that point every phase had been tested only against a hand-rolled
|
||||
|
||||
Generated
+10
-21
@@ -17,7 +17,7 @@
|
||||
"@vitest/coverage-v8": "^5.1.0",
|
||||
"@wxt-dev/module-svelte": "^2.0.5",
|
||||
"jsdom": "^31.0.0",
|
||||
"knip": "^6.44.2",
|
||||
"knip": "^6.45.1",
|
||||
"svelte": "^5.57.3",
|
||||
"svelte-check": "^4.7.8",
|
||||
"typescript": "npm:@typescript/typescript6@~6.0.2",
|
||||
@@ -3109,9 +3109,9 @@
|
||||
}
|
||||
},
|
||||
"node_modules/knip": {
|
||||
"version": "6.44.2",
|
||||
"resolved": "https://registry.npmjs.org/knip/-/knip-6.44.2.tgz",
|
||||
"integrity": "sha512-6URO7pnqtOnyvSsXfW6+8C9j1lfcicxUCysXO0RgMtHTZ96HqCXh29op8iabeQW5JeIc8dJWwzSdJVWDokeScQ==",
|
||||
"version": "6.45.1",
|
||||
"resolved": "https://registry.npmjs.org/knip/-/knip-6.45.1.tgz",
|
||||
"integrity": "sha512-zp3zXKy2cZWiIttdlWU5fisKxVQaLSU6471ej0KGz1GdHdaHxpzTAO/LIyFNc3gU3v1W7LJaqvYumoO3l/u+6A==",
|
||||
"dev": true,
|
||||
"funding": [
|
||||
{
|
||||
@@ -3131,12 +3131,11 @@
|
||||
"oxc-parser": "^0.156.0",
|
||||
"oxc-resolver": "11.24.2",
|
||||
"picomatch": "^4.0.7",
|
||||
"smol-toml": "^1.9.0",
|
||||
"smol-toml": "^1.9.1",
|
||||
"strip-json-comments": "5.0.3",
|
||||
"tinyglobby": "^0.2.17",
|
||||
"unbash": "^6.0.1",
|
||||
"yaml": "^2.9.1",
|
||||
"zod": "^4.6.5"
|
||||
"unbash": "^6.0.4",
|
||||
"yaml": "^2.9.1"
|
||||
},
|
||||
"bin": {
|
||||
"knip": "bin/knip.js",
|
||||
@@ -4347,9 +4346,9 @@
|
||||
"license": "ISC"
|
||||
},
|
||||
"node_modules/unbash": {
|
||||
"version": "6.0.1",
|
||||
"resolved": "https://registry.npmjs.org/unbash/-/unbash-6.0.1.tgz",
|
||||
"integrity": "sha512-0db9eS5iqybux41zLkX69nk90KTci7F7eZ+gXzEG/Q7E0tAqEBhRh5fkZvk1N7jT7QkGWqq34i8SFGPFEe1V8A==",
|
||||
"version": "6.0.4",
|
||||
"resolved": "https://registry.npmjs.org/unbash/-/unbash-6.0.4.tgz",
|
||||
"integrity": "sha512-t3OptUArewg9OpYGDskTSlxhyLDahfmZ4d36hE44Efb1y3HRLLpzsVqwH+AwBVymP4t7pP71xN+nnduudn2awA==",
|
||||
"dev": true,
|
||||
"license": "ISC",
|
||||
"engines": {
|
||||
@@ -4952,16 +4951,6 @@
|
||||
"integrity": "sha512-msJxIvYDYcoNL+PJsu+7qmpDWsYmAxTY+2TNYXXF0hzBzBk0BMecOqDOG/EckUoKCuKwObfbugIl8QpqHDXeFA==",
|
||||
"dev": true,
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/zod": {
|
||||
"version": "4.6.7",
|
||||
"resolved": "https://registry.npmjs.org/zod/-/zod-4.6.7.tgz",
|
||||
"integrity": "sha512-g8W2D2kU6a8untc053fX1uVBKzM7yqAxW/3zwk83+6RyF2+SKOuV+c0wBDhUwzV1PaGapmZH+rmcUzPf+3CGwg==",
|
||||
"dev": true,
|
||||
"license": "MIT",
|
||||
"funding": {
|
||||
"url": "https://github.com/sponsors/colinhacks"
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
+1
-1
@@ -47,7 +47,7 @@
|
||||
"@vitest/coverage-v8": "^5.1.0",
|
||||
"@wxt-dev/module-svelte": "^2.0.5",
|
||||
"jsdom": "^31.0.0",
|
||||
"knip": "^6.44.2",
|
||||
"knip": "^6.45.1",
|
||||
"svelte": "^5.57.3",
|
||||
"svelte-check": "^4.7.8",
|
||||
"typescript": "npm:@typescript/typescript6@~6.0.2",
|
||||
|
||||
+20
-3
@@ -33,6 +33,22 @@ const CWS_ITEM_ID = 'eghnciphhegekmnofffpgbdfefckdhmg';
|
||||
/** The published Chrome Web Store listing. */
|
||||
const CWS_URL = `https://chromewebstore.google.com/detail/bookmarkmagic/${CWS_ITEM_ID}`;
|
||||
|
||||
/**
|
||||
* The Edge Add-ons item id — Partner Center's "CRX ID", and the `runtime.id`
|
||||
* of every copy installed from Edge Add-ons (docs/00 §9). Not the Product ID,
|
||||
* which is what the `EDGE_PRODUCT_ID` secret needs.
|
||||
*/
|
||||
const EDGE_ITEM_ID = 'nchfchjnlihbifggooggpmmacighmdjg';
|
||||
|
||||
/** The published Edge Add-ons listing (live since 2026-11-19). */
|
||||
const EDGE_URL = `https://microsoftedge.microsoft.com/addons/detail/${EDGE_ITEM_ID}`;
|
||||
|
||||
/** Each Chromium store's item id → its listing. */
|
||||
const CHROMIUM_LISTINGS: ReadonlyMap<string, string> = new Map([
|
||||
[CWS_ITEM_ID, CWS_URL],
|
||||
[EDGE_ITEM_ID, EDGE_URL],
|
||||
]);
|
||||
|
||||
/**
|
||||
* The Firefox Add-ons listing, addressed by the gecko id, which AMO resolves
|
||||
* (docs/13 §8). The "@" is percent-encoded on purpose: AMO decodes it, and the
|
||||
@@ -49,8 +65,9 @@ const INSTALL_URL = `${REPO_URL}#install`;
|
||||
* The only route from inside the product to rating or reviewing it, which
|
||||
* docs/13 §6 lists as a post-launch channel. One Chromium package serves the
|
||||
* Chrome Web Store and Edge Add-ons, so the Chromium choice is made at run
|
||||
* time, by extension id: the Chrome Web Store's own id gets its listing, any
|
||||
* other (an Edge Add-ons install, an unpacked build) the install section.
|
||||
* time, by extension id: each store's own id gets its listing (an Edge user
|
||||
* who installed from the Chrome Web Store has that store's id, and gets that
|
||||
* listing), any other id (an unpacked build) the install section.
|
||||
*
|
||||
* There is deliberately **no support email here.** Putting an address on an
|
||||
* in-product surface invites users to mail their real bookmarks file, which is
|
||||
@@ -61,7 +78,7 @@ const INSTALL_URL = `${REPO_URL}#install`;
|
||||
*/
|
||||
export function storeUrlFor(install: { firefox: boolean; extensionId: string }): string {
|
||||
if (install.firefox) return AMO_URL;
|
||||
return install.extensionId === CWS_ITEM_ID ? CWS_URL : INSTALL_URL;
|
||||
return CHROMIUM_LISTINGS.get(install.extensionId) ?? INSTALL_URL;
|
||||
}
|
||||
|
||||
export interface LabelledLink {
|
||||
|
||||
@@ -23,6 +23,12 @@ same spelling as `src/public/_locales/`. Adding a language: `docs/07 §6` and
|
||||
`docs/13 §4` — the `LANGUAGES` paragraph inside *every* description lists the
|
||||
languages, so all of them are re-pasted when one is added.
|
||||
|
||||
Since v1.3.0 each file also carries the **Firefox Add-ons** and **Microsoft
|
||||
Edge Add-ons** copy, under headings of their own. The Edge description is
|
||||
complete and is pasted whole: Edge's policy forbids naming other browsers, so
|
||||
it is the one description that never says Chrome or Firefox (`docs/13 §9`,
|
||||
checked by `tests/unit/store-listing.test.ts`).
|
||||
|
||||
The summary field is capped at **132 characters** by the dashboard. Each file
|
||||
records its own count; re-check after any edit, because the limit is enforced at
|
||||
submission time and a rejection there costs a round trip.
|
||||
|
||||
+50
-2
@@ -57,9 +57,9 @@ https://github.com/poli0981/bookmarkmagic
|
||||
|
||||
**Distribution:** Public, all regions.
|
||||
|
||||
## Firefox Add-ons and Microsoft Edge Add-ons (since v1.3.0)
|
||||
## Firefox 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):
|
||||
The description above, with the two bullets that name Chrome replaced by these — on Firefox they would not be true as written:
|
||||
|
||||
```
|
||||
• Import bookmark files (HTML, JSON, CSV) — including the "Bookmarks" file
|
||||
@@ -85,4 +85,52 @@ 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.
|
||||
|
||||
## Microsoft Edge Add-ons (since v1.3.0)
|
||||
|
||||
A description of its own, pasted whole. Edge's developer policy (1.1.2) says a
|
||||
listing "must not reference other browsers", and Partner Center flags any
|
||||
browser name in the description — it did on 2026-11-18, for "Firefox". So this
|
||||
copy names no browser but Edge: the import bullet describes the files by what
|
||||
they are, and the export bullet says "every major browser" instead of listing
|
||||
seven. `tests/unit/store-listing.test.ts` fails if a name comes back.
|
||||
|
||||
```
|
||||
Move your bookmarks between browsers the simple way: with a file. No account.
|
||||
No cloud sync. 100% offline.
|
||||
|
||||
WHAT IT DOES
|
||||
• Import bookmark files (HTML, JSON, CSV) — including the "Bookmarks" file
|
||||
that Edge and similar browsers keep in their profile folder, and JSON
|
||||
bookmark backups — with a full preview before anything is written: counts,
|
||||
folders and duplicates first.
|
||||
• Choose how to import: into a new dated folder (safe default), merge into
|
||||
the folders you already have, or replace everything (it shows exactly what
|
||||
will be deleted and saves a safety backup first).
|
||||
• Can skip links you already have.
|
||||
• Export everything — or just the folders you pick — to HTML (the standard
|
||||
bookmark file every major browser can import), JSON, CSV, or Markdown.
|
||||
• Edit your bookmark tree: search, rename, drag to move or reorder, sort a
|
||||
folder A→Z, create folders, delete, and find duplicate links.
|
||||
|
||||
PRIVACY BY DESIGN
|
||||
• Works entirely on your device. No servers, no analytics, no tracking.
|
||||
• Only two permissions: "bookmarks" (the whole point) and "storage" (your
|
||||
settings). Nothing else.
|
||||
• Free & open source (GPL-3.0) — read the code on GitHub.
|
||||
|
||||
LANGUAGES
|
||||
English · Tiếng Việt · 日本語 · 简体中文 · Română
|
||||
|
||||
LIMITATIONS (HONESTY CORNER)
|
||||
• Favicons can't be imported — the extensions API for bookmarks has no
|
||||
favicon field.
|
||||
• 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.
|
||||
• CSV is a flattened view: empty folders and "which folder is the toolbar"
|
||||
aren't preserved. Use HTML or JSON for a faithful backup.
|
||||
|
||||
Source code, issue tracker & privacy policy:
|
||||
https://github.com/poli0981/bookmarkmagic
|
||||
```
|
||||
|
||||
**Edge Add-ons:** category *Productivity* · the same privacy-policy URL.
|
||||
+51
-2
@@ -61,9 +61,9 @@ https://github.com/poli0981/bookmarkmagic
|
||||
法的文書は英語のみです(`docs/14`)。プライバシーポリシーの URL は EN 版と
|
||||
同じものを使います。
|
||||
|
||||
## Firefox Add-ons と Microsoft Edge Add-ons(v1.3.0 以降)
|
||||
## Firefox Add-ons(v1.3.0 以降)
|
||||
|
||||
上の説明文のうち、Chrome に触れている 2 項目を次のものに置き換えて使います(Firefox と Edge ではそのままでは正しくなく、Edge は Chrome 拡張機能として紹介するリスティングを受け付けません):
|
||||
上の説明文のうち、Chrome に触れている 2 項目を次のものに置き換えて使います(Firefox ではそのままでは正しくないため):
|
||||
|
||||
```
|
||||
• ブックマークファイル(HTML、JSON、CSV)をインポートします。Chromium 系
|
||||
@@ -89,4 +89,53 @@ Firefox Add-ons のみ、「制限事項」に追加:
|
||||
*GNU General Public License v3.0* · Firefox(デスクトップ)のみ · 同じ
|
||||
プライバシーポリシー URL。
|
||||
|
||||
## Microsoft Edge Add-ons(v1.3.0 以降)
|
||||
|
||||
専用の説明文を、そのまま丸ごと貼り付けます。Edge の開発者ポリシー(1.1.2)は
|
||||
リスティングが他のブラウザに言及することを認めておらず、Partner Center は説明文
|
||||
にブラウザ名があると警告します(2026-11-18 に「Firefox」で警告が出ました)。
|
||||
そのため、この説明文は Edge 以外のブラウザ名を含みません。名前が戻ると
|
||||
`tests/unit/store-listing.test.ts` が失敗します。
|
||||
|
||||
```
|
||||
ブックマークをブラウザ間で移すいちばん簡単な方法は、ファイルを使うことです。
|
||||
アカウント不要、クラウド同期なし、完全オフラインで動作します。
|
||||
|
||||
できること
|
||||
• ブックマークファイル(HTML、JSON、CSV)をインポートします。Edge などの
|
||||
ブラウザがプロファイルフォルダに保存している「Bookmarks」ファイルや、
|
||||
JSON 形式のブックマークのバックアップにも対応。書き込む前に必ずプレビュー
|
||||
を表示し、件数・フォルダ・重複を先に確認できます。
|
||||
• インポート方法を選べます。日付付きの新しいフォルダに入れる(安全な既定
|
||||
値)、既存のフォルダに統合する、またはすべて置き換える(削除される内容を
|
||||
正確に示し、安全のためのバックアップを先に保存します)。
|
||||
• すでにあるリンクはスキップできます。
|
||||
• すべて、または選んだフォルダだけを HTML(主要なブラウザならどれでも
|
||||
インポートできる標準のブックマークファイル)、JSON、CSV、Markdown に
|
||||
エクスポートできます。
|
||||
• ブックマークツリーを編集できます。検索、名前の変更、ドラッグでの移動と
|
||||
並べ替え、フォルダの A→Z 並べ替え、フォルダの作成、削除、重複リンクの検出。
|
||||
|
||||
設計としてのプライバシー
|
||||
• すべて端末上で動作します。サーバーも、分析も、トラッキングもありません。
|
||||
• 権限は 2 つだけです。「bookmarks」(本来の目的)と「storage」(設定の
|
||||
保存)。それ以外は要求しません。
|
||||
• 無料・オープンソース(GPL-3.0)です。コードは GitHub で確認できます。
|
||||
|
||||
対応言語
|
||||
English · Tiếng Việt · 日本語 · 简体中文 · Română
|
||||
|
||||
制限事項(正直に)
|
||||
• ファビコンはインポートできません。ブラウザのブックマーク API に
|
||||
ファビコンの項目がないためです。
|
||||
• インポートしたブックマークの日付は本日になります。拡張機能がブックマーク
|
||||
の元の作成日を設定することをブラウザが許可していないためです。エクスポート
|
||||
したファイルには本来の日付が残ります。
|
||||
• CSV はフラットな形式です。空のフォルダや「どれがブックマークバーか」は
|
||||
保持されません。忠実なバックアップには HTML か JSON をお使いください。
|
||||
|
||||
ソースコード、問題の報告、プライバシーポリシー:
|
||||
https://github.com/poli0981/bookmarkmagic
|
||||
```
|
||||
|
||||
**Edge Add-ons:** カテゴリ *Productivity* · 同じプライバシーポリシー URL。
|
||||
+56
-2
@@ -67,9 +67,9 @@ 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)
|
||||
## Firefox 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):
|
||||
Descrierea de mai sus, cu cele două puncte care numesc Chrome înlocuite de acestea — în Firefox n-ar fi adevărate așa cum sunt scrise:
|
||||
|
||||
```
|
||||
• Importă fișiere de marcaje (HTML, JSON, CSV) — inclusiv fișierul „Bookmarks”
|
||||
@@ -95,5 +95,59 @@ Doar pentru Firefox Add-ons, adăugați la LIMITĂRI:
|
||||
licența *GNU General Public License v3.0* · doar Firefox (desktop) · același
|
||||
URL al politicii de confidențialitate.
|
||||
|
||||
## Microsoft Edge Add-ons (din v1.3.0)
|
||||
|
||||
O descriere proprie, lipită întreagă. Politica pentru dezvoltatori a Edge (1.1.2)
|
||||
nu permite ca o listare să menționeze alte browsere, iar Partner Center
|
||||
avertizează la orice nume de browser din descriere (a făcut-o pe 2026-11-18,
|
||||
pentru „Firefox”). Așadar textul acesta nu numește niciun browser în afară de
|
||||
Edge; `tests/unit/store-listing.test.ts` eșuează dacă un nume revine.
|
||||
|
||||
```
|
||||
Mutați marcajele între browsere în cel mai simplu mod: cu un fișier. Fără cont.
|
||||
Fără sincronizare în cloud. 100% offline.
|
||||
|
||||
CE FACE
|
||||
• Importă fișiere de marcaje (HTML, JSON, CSV) — inclusiv fișierul „Bookmarks”
|
||||
pe care Edge și browserele similare îl păstrează în dosarul profilului, precum
|
||||
și copiile de rezervă JSON ale marcajelor — cu o previzualizare completă
|
||||
înainte de a scrie ceva: numărul de marcaje, dosarele și duplicatele, de la
|
||||
început.
|
||||
• Alegeți cum se face importul: într-un dosar nou cu dată (varianta sigură,
|
||||
implicită), prin îmbinare cu dosarele pe care le aveți deja sau prin
|
||||
înlocuirea completă (arată exact ce se va șterge și salvează mai întâi o
|
||||
copie de rezervă de siguranță).
|
||||
• Poate omite linkurile pe care le aveți deja.
|
||||
• Exportă tot — sau doar dosarele alese — în HTML (fișierul standard de
|
||||
marcaje, pe care îl importă toate browserele principale), JSON, CSV sau
|
||||
Markdown.
|
||||
• Editează arborele de marcaje: căutare, redenumire, mutare și reordonare
|
||||
prin tragere, sortarea unui dosar A→Z, dosare noi, ștergere și găsirea
|
||||
linkurilor duplicate.
|
||||
|
||||
CONFIDENȚIALITATE PRIN DESIGN
|
||||
• Funcționează în întregime pe dispozitivul dumneavoastră. Fără servere, fără
|
||||
statistici, fără urmărire.
|
||||
• Doar două permisiuni: „bookmarks” (rostul extensiei) și „storage” (setările
|
||||
dumneavoastră). Nimic altceva.
|
||||
• Gratuit și open source (GPL-3.0) — puteți citi codul pe GitHub.
|
||||
|
||||
LIMBI
|
||||
English · Tiếng Việt · 日本語 · 简体中文 · Română
|
||||
|
||||
LIMITĂRI (CU SINCERITATE)
|
||||
• Pictogramele site-urilor nu pot fi importate — API-ul pentru marcaje al
|
||||
extensiilor nu are un câmp pentru ele.
|
||||
• 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.
|
||||
• CSV este o vedere aplatizată: dosarele goale și „care dosar este bara de
|
||||
marcaje” nu se păstrează. Pentru o copie de rezervă fidelă, folosiți HTML sau
|
||||
JSON.
|
||||
|
||||
Cod sursă, raportarea problemelor și politica de confidențialitate:
|
||||
https://github.com/poli0981/bookmarkmagic
|
||||
```
|
||||
|
||||
**Edge Add-ons:** categoria *Productivity* · același URL al politicii de
|
||||
confidențialitate.
|
||||
+52
-2
@@ -56,9 +56,9 @@ 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)
|
||||
## Firefox 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):
|
||||
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, viết như cũ sẽ không đúng:
|
||||
|
||||
```
|
||||
• Nhập tệp bookmark (HTML, JSON, CSV) — kể cả tệp "Bookmarks" trong thư mục
|
||||
@@ -83,4 +83,54 @@ Riêng Firefox Add-ons, thêm vào phần GIỚI HẠN:
|
||||
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ư.
|
||||
|
||||
## Microsoft Edge Add-ons (từ v1.3.0)
|
||||
|
||||
Một bản mô tả riêng, dán nguyên khối. Chính sách nhà phát triển của Edge (1.1.2)
|
||||
không cho listing nhắc đến trình duyệt khác, và Partner Center cảnh báo khi mô
|
||||
tả có tên trình duyệt nào — ngày 2026-11-18 nó đã báo vì chữ "Firefox". Vì vậy
|
||||
bản này không nêu tên trình duyệt nào ngoài Edge: gạch về nhập tệp mô tả tệp
|
||||
theo đúng bản chất của nó, gạch về xuất tệp ghi "mọi trình duyệt phổ biến" thay
|
||||
cho danh sách bảy cái tên. `tests/unit/store-listing.test.ts` báo lỗi nếu một
|
||||
cái tên quay lại.
|
||||
|
||||
```
|
||||
Chuyển bookmark giữa các trình duyệt theo cách đơn giản nhất: bằng một tệp.
|
||||
Không tài khoản. Không đồng bộ đám mây. Hoàn toàn offline.
|
||||
|
||||
TIỆN ÍCH NÀY LÀM GÌ
|
||||
• Nhập tệp bookmark (HTML, JSON, CSV) — kể cả tệp "Bookmarks" mà Edge và các
|
||||
trình duyệt tương tự lưu trong thư mục hồ sơ, cùng bản sao lưu bookmark dạng
|
||||
JSON — 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.
|
||||
• Chọn cách nhập: vào một thư mục mới theo ngày (mặc định an toàn), gộp vào
|
||||
các thư mục bạn đã có, hoặc thay thế toàn bộ (cho biết chính xác những gì
|
||||
sẽ bị xóa và lưu bản sao lưu an toàn trước).
|
||||
• Có thể bỏ qua các liên kết bạn đã có.
|
||||
• Xuất toàn bộ — hoặc chỉ những thư mục bạn chọn — ra HTML (tệp bookmark
|
||||
chuẩn mà mọi trình duyệt phổ biến đều nhập được), JSON, CSV hoặc Markdown.
|
||||
• Chỉnh sửa cây bookmark: tìm kiếm, đổi tên, kéo thả để di chuyển hoặc đổi
|
||||
thứ tự, sắp xếp thư mục A→Z, tạo thư mục, xoá và tìm liên kết trùng lặp.
|
||||
|
||||
RIÊNG TƯ NGAY TỪ THIẾT KẾ
|
||||
• Chạy hoàn toàn trên máy bạn. Không máy chủ, không phân tích, không theo dõi.
|
||||
• Chỉ hai quyền: "bookmarks" (chính là mục đích của tiện ích) và "storage"
|
||||
(thiết lập của bạn). Không gì khác.
|
||||
• Miễn phí & mã nguồn mở (GPL-3.0) — bạn có thể đọc mã trên GitHub.
|
||||
|
||||
NGÔN NGỮ
|
||||
English · Tiếng Việt · 日本語 · 简体中文 · Română
|
||||
|
||||
GIỚI HẠN (NÓI THẲNG)
|
||||
• Không thể nhập favicon — API bookmark của trình duyệt không có trường
|
||||
favicon.
|
||||
• 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.
|
||||
• CSV là dạng phẳng: thư mục rỗng và thông tin "thư mục nào là thanh bookmark"
|
||||
sẽ không được giữ lại. Hãy dùng HTML hoặc JSON nếu muốn sao lưu trung thực.
|
||||
|
||||
Mã nguồn, nơi báo lỗi & chính sách riêng tư:
|
||||
https://github.com/poli0981/bookmarkmagic
|
||||
```
|
||||
|
||||
**Edge Add-ons:** danh mục *Productivity* · cùng URL chính sách quyền riêng tư.
|
||||
+45
-2
@@ -55,9 +55,9 @@ https://github.com/poli0981/bookmarkmagic
|
||||
|
||||
法律文件仅有英文版本(`docs/14`),隐私政策 URL 与英文版相同。
|
||||
|
||||
## Firefox Add-ons 与 Microsoft Edge Add-ons(v1.3.0 起)
|
||||
## Firefox Add-ons(v1.3.0 起)
|
||||
|
||||
使用上面的描述,并把提到 Chrome 的两条换成下面两条——原文在 Firefox 和 Edge 上并不成立(Edge 也不接受把自己介绍为 Chrome 扩展程序的页面):
|
||||
使用上面的描述,并把提到 Chrome 的两条换成下面两条——原文在 Firefox 上并不成立:
|
||||
|
||||
```
|
||||
• 导入书签文件(HTML、JSON、CSV)——包括 Chromium 内核浏览器(Chrome、Edge、
|
||||
@@ -80,4 +80,47 @@ https://github.com/poli0981/bookmarkmagic
|
||||
**Firefox Add-ons:** 摘要 = 上面的摘要 · 类别 *Bookmarks* · 许可证
|
||||
*GNU General Public License v3.0* · 仅限 Firefox(桌面版)· 相同的隐私政策 URL。
|
||||
|
||||
## Microsoft Edge Add-ons(v1.3.0 起)
|
||||
|
||||
使用一份单独的完整描述,整段粘贴。Edge 的开发者政策(1.1.2)规定商品页面不得提及
|
||||
其他浏览器,描述中出现浏览器名称时 Partner Center 也会发出警告(2026-11-18 曾因
|
||||
“Firefox”而警告)。因此这份描述除 Edge 外不提任何浏览器;若有名称被加回,
|
||||
`tests/unit/store-listing.test.ts` 会失败。
|
||||
|
||||
```
|
||||
在浏览器之间转移书签,最简单的方式就是用一个文件。无需账户,没有云同步,
|
||||
100% 离线运行。
|
||||
|
||||
功能
|
||||
• 导入书签文件(HTML、JSON、CSV)——包括 Edge 等浏览器保存在个人资料文件夹中的
|
||||
“Bookmarks”文件,以及 JSON 格式的书签备份。写入任何内容之前都会先完整预览:
|
||||
数量、文件夹和重复项一目了然。
|
||||
• 自选导入方式:放入一个带日期的新文件夹(安全的默认选项)、合并到您已有的
|
||||
文件夹,或全部替换(会准确显示将删除的内容,并先保存一份安全备份)。
|
||||
• 可以跳过您已有的链接。
|
||||
• 导出全部书签,或只导出您选择的文件夹,格式可选 HTML(各主流浏览器都能导入的
|
||||
标准书签文件)、JSON、CSV 或 Markdown。
|
||||
• 编辑书签树:搜索、重命名、拖动以移动或重新排序、将文件夹按 A→Z 排序、
|
||||
新建文件夹、删除,以及查找重复的链接。
|
||||
|
||||
隐私至上的设计
|
||||
• 完全在您的设备上运行。没有服务器,没有分析,没有跟踪。
|
||||
• 只有两项权限:“bookmarks”(核心功能)和“storage”(保存您的设置)。
|
||||
仅此而已。
|
||||
• 免费且开源(GPL-3.0)——可在 GitHub 上查看代码。
|
||||
|
||||
语言
|
||||
English · Tiếng Việt · 日本語 · 简体中文 · Română
|
||||
|
||||
局限(坦诚说明)
|
||||
• 无法导入网站图标——扩展程序的书签 API 没有网站图标字段。
|
||||
• 导入的书签日期为今天——浏览器不允许扩展程序设置书签的原始创建日期。
|
||||
您导出的文件会保留真实日期。
|
||||
• CSV 是扁平化的视图:空文件夹以及“哪个文件夹是书签栏”都不会保留。
|
||||
如需完整备份,请使用 HTML 或 JSON。
|
||||
|
||||
源代码、问题跟踪和隐私政策:
|
||||
https://github.com/poli0981/bookmarkmagic
|
||||
```
|
||||
|
||||
**Edge Add-ons:** 类别 *Productivity* · 相同的隐私政策 URL。
|
||||
@@ -116,8 +116,13 @@ describe('store listing', () => {
|
||||
const amo = storeUrlFor({ firefox: true, extensionId: 'anything' });
|
||||
expect(amo).toBe('https://addons.mozilla.org/firefox/addon/bookmarkmagic%40poli0981.dev/');
|
||||
expect(decodeURIComponent(amo)).toContain('bookmarkmagic@poli0981.dev');
|
||||
// A Chromium copy with any other id — Edge Add-ons assigns its own, an
|
||||
// unpacked build gets a random one — goes to the list of every store.
|
||||
// Edge Add-ons assigns its own id — Partner Center's "CRX ID", not the
|
||||
// Product ID — and an install from there gets the Edge listing.
|
||||
expect(storeUrlFor({ firefox: false, extensionId: 'nchfchjnlihbifggooggpmmacighmdjg' })).toBe(
|
||||
'https://microsoftedge.microsoft.com/addons/detail/nchfchjnlihbifggooggpmmacighmdjg',
|
||||
);
|
||||
// A Chromium copy with any other id — an unpacked build gets a random
|
||||
// one — goes to the list of every store.
|
||||
expect(storeUrlFor({ firefox: false, extensionId: 'abcdefghijklmnopabcdefghijklmnop' })).toBe(
|
||||
`${REPO_URL}#install`,
|
||||
);
|
||||
|
||||
@@ -0,0 +1,62 @@
|
||||
import { readFileSync } from 'node:fs';
|
||||
import { join } from 'node:path';
|
||||
import { describe, expect, it } from 'vitest';
|
||||
import { LOCALES, type Locale } from '@/lib/i18n/resolve-locale';
|
||||
import { CHROME_LOCALE_DIRS } from '../helpers/locales';
|
||||
|
||||
/**
|
||||
* The Microsoft Edge Add-ons copy in `store/listing.*.md` — docs/13 §9.
|
||||
*
|
||||
* Edge's developer policy (1.1.2) says a listing must not reference other
|
||||
* browsers, and Partner Center flags a browser name in the description. It did
|
||||
* on 2026-11-18, for "Firefox", in a copy that was then "the Chrome Web Store
|
||||
* description with two bullets swapped" — the swap had left the export bullet's
|
||||
* list of seven browsers in place. So the Edge copy is a complete description
|
||||
* of its own, and nothing else would notice a name pasted back into it.
|
||||
*/
|
||||
|
||||
const ROOT = process.cwd();
|
||||
const read = (path: string): string => readFileSync(join(ROOT, path), 'utf8');
|
||||
const listing = (locale: Locale): string => read(`store/listing.${CHROME_LOCALE_DIRS[locale]}.md`);
|
||||
|
||||
/**
|
||||
* Every browser the listings name, Edge excepted. Bounded by ASCII letters
|
||||
* only, so a name that runs straight into CJK text ("Chrome的") still matches,
|
||||
* while a word that merely starts with one ("operare") does not.
|
||||
*/
|
||||
const OTHER_BROWSERS =
|
||||
/(?<![A-Za-z])(?:Chrome|Chromium|Firefox|Mozilla|Brave|Safari|Vivaldi|Opera|Netscape|Internet Explorer)(?![A-Za-z])/giu;
|
||||
|
||||
/** The fenced blocks between the Edge heading and the next `## ` heading. */
|
||||
function edgeDescriptions(text: string): string[] {
|
||||
const [, after = ''] = text.split(/^## Microsoft Edge Add-ons.*$/mu);
|
||||
const [section = ''] = after.split(/^## /mu);
|
||||
return [...section.matchAll(/^```\n([\s\S]*?)\n```$/gmu)].map((match) => match[1] ?? '');
|
||||
}
|
||||
|
||||
describe('the Microsoft Edge Add-ons listing', () => {
|
||||
it.each(LOCALES)('%s has one complete description, pasted whole', (locale) => {
|
||||
const descriptions = edgeDescriptions(listing(locale));
|
||||
// One block, not a recipe of bullets to swap: the recipe is how the Chrome
|
||||
// Web Store's list of browsers reached Partner Center.
|
||||
expect(descriptions).toHaveLength(1);
|
||||
// Partner Center accepts 250 to 5,000 characters.
|
||||
const length = descriptions[0]?.length ?? 0;
|
||||
expect(length).toBeGreaterThanOrEqual(250);
|
||||
expect(length).toBeLessThanOrEqual(5000);
|
||||
});
|
||||
|
||||
it.each(LOCALES)('%s names no browser but Edge', (locale) => {
|
||||
const [description = ''] = edgeDescriptions(listing(locale));
|
||||
expect(description.match(OTHER_BROWSERS) ?? []).toEqual([]);
|
||||
});
|
||||
|
||||
it.each(LOCALES)('%s still names them in the Chrome Web Store copy', (locale) => {
|
||||
// That copy lists the browsers on purpose. A pattern that found nothing
|
||||
// there would let the check above pass on any text at all.
|
||||
const [chromeWebStoreCopy = ''] = listing(locale).split(/^## /mu);
|
||||
expect(chromeWebStoreCopy.match(OTHER_BROWSERS)).toEqual(
|
||||
expect.arrayContaining(['Chrome', 'Brave', 'Firefox', 'Safari', 'Vivaldi', 'Opera']),
|
||||
);
|
||||
});
|
||||
});
|
||||
Reference in new issue
Block a user