Restored Icons

Author: JoeShade

README.md

@@ -32,7 +32,7 @@ It works on supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark part
 </p>
 <br clear="left">
 
-## Contents
+## <img src="docs/assets/readme/icon-contents.svg" alt="" width="20" height="20" align="absmiddle"> Contents
 
 - [Installation](#installation)
 - [Quick start](#quick-start)
@@ -46,14 +46,14 @@ It works on supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark part
 - [Supporting docs](#supporting-docs)
 - [License and attribution](#license-and-attribution)
 
-## Installation
+## <img src="docs/assets/readme/icon-installation.svg" alt="" width="20" height="20" align="absmiddle"> Installation
 
 | Browser | Install from | Notes |
 |---|---|---|
 | Chrome, Edge, Brave, and other Chromium browsers | [Chrome Web Store](https://chromewebstore.google.com/detail/easyeda-downloader/egbkokdcahpjimldjjaobimnofbdnncb) | Full support for EasyEDA-backed pages and SamacSys-backed Mouser/Farnell/element14/Newark downloads. |
 | Firefox | [Firefox Add-ons](https://addons.mozilla.org/en-GB/firefox/addon/easyeda-downloader/) | Works for EasyEDA-backed pages. SamacSys-backed Mouser/Farnell/element14/Newark downloads need the optional Firefox relay setup. |
 
-## Quick start
+## <img src="docs/assets/readme/icon-quick-start.svg" alt="" width="20" height="20" align="absmiddle"> Quick start
 
 1. Open a supported JLCPCB, LCSC, Mouser, Farnell, element14, or Newark component page.
 2. Click the Easy ECAD Downloader extension icon.
@@ -62,7 +62,7 @@ It works on supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark part
 5. Click `Download`.
 6. Open the generated files from KiCad and review them before use.
 
-## Usage walkthrough
+## <img src="docs/assets/readme/icon-walkthrough.svg" alt="" width="20" height="20" align="absmiddle"> Usage walkthrough
 
 ### 1. Open a supported component page
 
@@ -88,7 +88,7 @@ Library mode creates a KiCad-style symbol library, footprint library, model fold
   <img src="docs/assets/readme/exportPreview.png" alt="KiCad 3D viewer export preview" width="760">
 </p>
 
-## Output structure
+## <img src="docs/assets/readme/icon-output.svg" alt="" width="20" height="20" align="absmiddle"> Output structure
 
 When `Save each file separately` is disabled, files are grouped under `Downloads/<library root>/`. The default library root is `easyECADDownloader`.
 
@@ -118,14 +118,14 @@ Downloads/
 
 When a footprint and matching 3D model are exported together, the footprint model reference is rewritten to the generated model path. If no 3D model is exported, stale model references are removed from the generated footprint.
 
-## Supported sources and outputs
+## <img src="docs/assets/readme/icon-support.svg" alt="" width="20" height="20" align="absmiddle"> Supported sources and outputs
 
 | Source flow | Pages | Symbol | Footprint | 3D model | Datasheet | Notes |
 |---|---|---:|---:|---:|---:|---|
 | EasyEDA-backed | JLCPCB, LCSC | Yes | Yes | When available | When available | Uses the detected LCSC id and upstream EasyEDA payload. |
 | SamacSys-backed | Mouser, Farnell, element14, Newark | Yes | Yes | When available | No | Downloads the upstream KiCad ZIP and repackages selected assets. |
 
-## Settings
+## <img src="docs/assets/readme/icon-settings.svg" alt="" width="20" height="20" align="absmiddle"> Settings
 
 <p align="center">
   <img src="docs/assets/readme/settingsPreview.png" alt="Easy ECAD Downloader settings page" width="760">
@@ -140,7 +140,7 @@ When a footprint and matching 3D model are exported together, the footprint mode
 
 Password and token fields are blank when the settings page opens, and each field has a local show/hide button for checking typed values. New values are kept for the current browser session by default. Tick the relevant `Remember ... on this device` box only if you accept the risk of storing that secret in the browser profile.
 
-## FAQ
+## <img src="docs/assets/readme/icon-faq.svg" alt="" width="20" height="20" align="absmiddle"> FAQ
 
 <details>
 <summary><strong>View frequently asked questions</strong></summary>
@@ -284,7 +284,7 @@ Easy ECAD Downloader can only export files that are available from the source pa
 
 </details>
 
-## Technical overview
+## <img src="docs/assets/readme/icon-technical.svg" alt="" width="20" height="20" align="absmiddle"> Technical overview
 
 <p align="center">
   <img src="docs/assets/readme/architectureDiagram.png" alt="Extension architecture overview" width="760">
@@ -302,21 +302,21 @@ Key implementation areas:
 - `src/kicad/`: EasyEDA parsing, KiCad emitters, shared conversion helpers, and OBJ-to-WRL conversion.
 - `tests/`: regression suite for behavior, conversion, browser runtime boundaries, and repository hygiene.
 
-## Contributing
+## <img src="docs/assets/readme/icon-contributing.svg" alt="" width="20" height="20" align="absmiddle"> Contributing
 
 Read [contributing.md](contributing.md) for development setup, local validation, contribution expectations, and manual extension-loading instructions. Read [AGENTS.md](AGENTS.md) for repository working rules.
 
 Good contributions include parser fixes for real component pages, regression tests for failed exports, output-format corrections, browser compatibility fixes, and documentation that makes the workflow clearer for KiCad users.
 
-## Supporting docs
+## <img src="docs/assets/readme/icon-docs.svg" alt="" width="20" height="20" align="absmiddle"> Supporting docs
 
 - [systemDesign.md](systemDesign.md): design source of truth.
 - [CHANGELOG.md](CHANGELOG.md): notable changes by release or branch delta.
 - [SECURITY.md](SECURITY.md): vulnerability reporting and credential-handling notes.
 - [docs/architecture-notes.md](docs/architecture-notes.md): short implementation notes.
 - [docs/firefox-samacsys-proxy.md](docs/firefox-samacsys-proxy.md): Cloudflare Worker relay example for Firefox SamacSys support.
 
-## License and attribution
+## <img src="docs/assets/readme/icon-license.svg" alt="" width="20" height="20" align="absmiddle"> License and attribution
 
 This project includes and is derived from:
 

tests/test_repo_hygiene.test.js

@@ -59,6 +59,13 @@ const githubSlugForPlainHeading = (heading) =>
     .replace(/[^a-z0-9 -]/g, "")
     .replace(/\s+/g, "-");
 
+const readmeHeadingText = (line) =>
+  line
+    .slice(3)
+    .trim()
+    .replace(/<img\s+[^>]*>\s*/g, "")
+    .trim();
+
 const CANONICAL_FOOTER = normalizeNewlines(
   [
     "/*",
@@ -298,7 +305,7 @@ describe("repository hygiene", () => {
       fs.readFileSync(path.join(REPO_ROOT, "README.md"), "utf8")
     );
     const contentsMatch = readmeText.match(
-      /^## Contents\n\n((?:- \[[^\]]+\]\(#[^)]+\)\n)+)/m
+      /^## (?:<img\s+[^>]*>\s*)?Contents\n\n((?:- \[[^\]]+\]\(#[^)]+\)\n)+)/m
     );
 
     expect(contentsMatch).not.toBeNull();
@@ -312,11 +319,8 @@ describe("repository hygiene", () => {
       readmeText
         .split("\n")
         .filter((line) => line.startsWith("## "))
-        .map((line) => line.slice(3).trim())
-        .map((heading) => {
-          expect(heading).not.toMatch(/<[^>]+>/);
-          return githubSlugForPlainHeading(heading);
-        })
+        .map(readmeHeadingText)
+        .map(githubSlugForPlainHeading)
     );
 
     expect(linkedFragments).toEqual([...new Set(linkedFragments)]);