Added support for more SamacSys websites

JoeShade · JoeShade · commit 727d9c774c48 · 2026-05-10T19:24:44.000+01:00
diff --git a/README.md b/README.md
@@ -26,7 +26,7 @@
 
 Easy ECAD Downloader is a browser extension for exporting KiCad-compatible CAD assets from supported distributor product pages.
 
-It works on supported JLCPCB, LCSC, Mouser, and Farnell part pages, and can download the available KiCad files for you: symbols, footprints, 3D models, and datasheets.
+It works on supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark part pages, and can download the available KiCad files for you: symbols, footprints, 3D models, and datasheets.
 
 <p>
   <img src="docs/assets/readme/important-bar.svg" alt="" width="4" height="58" align="left" hspace="12">
@@ -52,12 +52,12 @@ It works on supported JLCPCB, LCSC, Mouser, and Farnell part pages, and can down
 
 | 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 downloads. |
-| Firefox | [Firefox Add-ons](https://addons.mozilla.org/en-GB/firefox/addon/easyeda-downloader/) | Works for EasyEDA-backed pages. SamacSys-backed Mouser/Farnell downloads need the optional Firefox relay setup. |
+| 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. |
 
 ## <img src="docs/assets/readme/icon-quick-start.svg" alt="" width="20" height="20" align="middle" style="vertical-align: -0.1em;"> Quick start
 
-1. Open a supported JLCPCB, LCSC, Mouser, or Farnell component page.
+1. Open a supported JLCPCB, LCSC, Mouser, Farnell, element14, or Newark component page.
 2. Click the Easy ECAD Downloader extension icon.
 3. Review the detected manufacturer and source part details.
 4. Choose which assets to export.
@@ -68,7 +68,7 @@ It works on supported JLCPCB, LCSC, Mouser, and Farnell part pages, and can down
 
 ### 1. Open a supported component page
 
-The content script detects supported part contexts from EasyEDA-backed JLCPCB/LCSC pages or SamacSys-backed Mouser/Farnell pages.
+The content script detects supported part contexts from EasyEDA-backed JLCPCB/LCSC pages or SamacSys-backed Mouser/Farnell/element14/Newark pages.
 
 <p align="center">
   <img src="docs/assets/readme/SupportedPage.png" alt="Supported component page" width="760">
@@ -123,7 +123,7 @@ Downloads/
 | 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 | Yes | Yes | When available | No | Downloads the upstream KiCad ZIP and repackages selected assets. |
+| SamacSys-backed | Mouser, Farnell, element14, Newark | Yes | Yes | When available | No | Downloads the upstream KiCad ZIP and repackages selected assets. |
 
 ## <img src="docs/assets/readme/icon-settings.svg" alt="" width="20" height="20" align="middle" style="vertical-align: -0.1em;"> Settings
 
@@ -135,7 +135,7 @@ Downloads/
 |---|---|
 | `Save each file separately` | Switches between loose downloads and grouped KiCad library output. |
 | `KiCad library folder` | Sets the Downloads-relative folder used for library mode, such as `easyECADDownloader` or `KiCad/easyECAD`. |
-| `SamacSys username` and `SamacSys password` | Optional upstream sign-in details for Mouser/Farnell CAD ZIP downloads. |
+| `SamacSys username` and `SamacSys password` | Optional upstream sign-in details for Mouser/Farnell/element14/Newark CAD ZIP downloads. |
 | `Advanced Firefox settings` | Configures the user-managed Firefox relay URL and helper-service auth when SamacSys export is needed in Firefox. |
 
 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.
@@ -153,38 +153,137 @@ For authenticated SamacSys ZIP downloads, upstream auth precedence is:
 <br>
 
 <details>
-<summary><strong>Do I still need to check generated files?</strong></summary>
+<summary><strong>What does Easy ECAD Downloader do?</strong></summary>
 
 <br>
 
-Yes. Treat generated CAD files as a starting point, not as manufacturing-approved data. Always verify footprint dimensions, pin mapping, 3D model placement, and datasheet references.
+Easy ECAD Downloader is a browser extension for downloading KiCad-compatible ECAD assets from supported distributor pages. It helps export available symbols, footprints, 3D models, and datasheets from JLCPCB, LCSC, Mouser, Farnell, element14, and Newark product pages.
 
 </details>
 
 <details>
-<summary><strong>Why is a symbol, footprint, 3D model, or datasheet missing?</strong></summary>
+<summary><strong>Which websites does Easy ECAD Downloader support?</strong></summary>
 
 <br>
 
-The extension can only export data that is available from the source page or linked component metadata. Some parts may have incomplete or inconsistent source data.
+Easy ECAD Downloader supports JLCPCB, LCSC, Mouser, Farnell, element14, and Newark product pages. JLCPCB and LCSC use EasyEDA-backed component data, while Mouser, Farnell, element14, and Newark use SamacSys-backed CAD downloads.
 
 </details>
 
 <details>
-<summary><strong>Does SamacSys export work in Firefox?</strong></summary>
+<summary><strong>What KiCad files can Easy ECAD Downloader create?</strong></summary>
 
 <br>
 
-Yes, but Firefox needs an advanced user-managed relay URL for SamacSys distributor export. Chrome can request SamacSys ZIP assets directly through the normal browser session.
+Depending on the part and source data, Easy ECAD Downloader can create KiCad symbol libraries, footprint files, 3D model files, and datasheet PDFs. Common output files include `.kicad_sym`, `.kicad_mod`, `.pretty`, `.step`, `.wrl`, and PDF datasheets.
 
 </details>
 
 <details>
-<summary><strong>Where are files downloaded?</strong></summary>
+<summary><strong>Where are the downloaded KiCad files saved?</strong></summary>
 
 <br>
 
-By default, library-mode files are saved under `Downloads/easyECADDownloader/`. If `Save each file separately` is enabled, selected files are saved directly into the browser downloads folder.
+In library mode, Easy ECAD Downloader saves files into a KiCad-style library folder under your browser Downloads directory. By default, this is `Downloads/easyECADDownloader/`. The output is grouped into a symbol library, a `.pretty` footprint folder, a 3D models folder, and a datasheets folder when applicable. If `Save each file separately` is enabled, selected files are saved directly into the browser downloads folder.
+
+</details>
+
+<details>
+<summary><strong>Do I still need to check the downloaded symbol or footprint?</strong></summary>
+
+<br>
+
+Yes. Generated CAD assets should always be reviewed before manufacturing. Check pin mapping, pad numbering, footprint dimensions, polarity, orientation, courtyard and clearance assumptions, 3D model placement, and datasheet accuracy before ordering boards.
+
+</details>
+
+<details>
+<summary><strong>How do I import JLCPCB or EasyEDA footprints and symbols into KiCad easily?</strong></summary>
+
+<br>
+
+Open a supported JLCPCB or LCSC component page, click the Easy ECAD Downloader extension icon, preview the available assets, and download the KiCad output. The extension converts the available EasyEDA-backed component data into KiCad-compatible symbol, footprint, and 3D model files where those assets exist.
+
+</details>
+
+<details>
+<summary><strong>Can I download EasyEDA footprints for KiCad?</strong></summary>
+
+<br>
+
+Yes. For supported JLCPCB and LCSC pages, Easy ECAD Downloader downloads EasyEDA-backed component data and exports KiCad-compatible footprint files. When available, it can also export the matching symbol, 3D model, and datasheet.
+
+</details>
+
+<details>
+<summary><strong>How do I download JLCPCB footprints for KiCad?</strong></summary>
+
+<br>
+
+Find the supported JLCPCB or LCSC component page, open Easy ECAD Downloader, and download the available KiCad footprint. This avoids manually redrawing the land pattern when source CAD data is already available.
+
+</details>
+
+<details>
+<summary><strong>Can I convert an LCSC part number into a KiCad symbol, footprint, and 3D model?</strong></summary>
+
+<br>
+
+Yes, for supported LCSC or JLCPCB parts with available EasyEDA-backed data. Easy ECAD Downloader detects the part from the browser page and exports the available KiCad assets without requiring a command-line workflow.
+
+</details>
+
+<details>
+<summary><strong>Is Easy ECAD Downloader an EasyEDA to KiCad converter?</strong></summary>
+
+<br>
+
+Yes, for component-level library assets. Easy ECAD Downloader converts supported EasyEDA-backed component data into KiCad-compatible symbols, footprints, and 3D models. It is not a full EasyEDA project, schematic, or PCB-layout migration tool.
+
+</details>
+
+<details>
+<summary><strong>Can I download KiCad footprints from Mouser?</strong></summary>
+
+<br>
+
+Yes, when the Mouser product page provides supported ECAD data. Easy ECAD Downloader uses the Mouser and SamacSys CAD flow to download the available KiCad files and organize the selected symbol, footprint, and 3D model assets.
+
+</details>
+
+<details>
+<summary><strong>Can I download KiCad footprints from Farnell, element14, or Newark?</strong></summary>
+
+<br>
+
+Yes, when the Farnell, element14, or Newark product page links to supported SamacSys ECAD data. Easy ECAD Downloader can export the available KiCad symbol, footprint, and 3D model files from the supported download flow.
+
+</details>
+
+<details>
+<summary><strong>Is Easy ECAD Downloader a Library Loader alternative for KiCad?</strong></summary>
+
+<br>
+
+For supported JLCPCB, LCSC, Mouser, Farnell, element14, and Newark pages, yes. Easy ECAD Downloader can reduce the need for a separate Library Loader workflow by detecting the part page, downloading the available CAD assets, and organizing KiCad-compatible output. Library Loader may still be useful for unsupported distributors, unsupported parts, or non-KiCad workflows.
+
+</details>
+
+<details>
+<summary><strong>How do I add downloaded symbols and footprints to KiCad?</strong></summary>
+
+<br>
+
+Add the generated `.kicad_sym` file through KiCad's symbol library manager and add the generated `.pretty` folder through KiCad's footprint library manager. KiCad tracks symbol and footprint libraries separately, so add both if you downloaded both asset types.
+
+</details>
+
+<details>
+<summary><strong>Why is a KiCad symbol, footprint, 3D model, or datasheet missing?</strong></summary>
+
+<br>
+
+Easy ECAD Downloader can only export files that are available from the source page or linked component metadata. Some components have a footprint but no symbol, no 3D model, no datasheet, or incomplete upstream CAD data.
 
 </details>
 
diff --git a/docs/architecture-notes.md b/docs/architecture-notes.md
@@ -11,7 +11,7 @@ This file records short implementation notes that supplement, but do not replace
 - `src/service_worker_runtime.js`: provider routing, runtime gating, response shaping, and composition of worker dependencies
 - `src/core/*.js`: shared worker business logic for settings, downloads, storage-backed symbol-library handling, shared export artifact writing, and common normalization
 - `src/sources/*.js`: source adapters plus source-specific fetch/parse/export helpers
-  - `src/sources/samacsys_distributor_adapter.js` is the shared backend adapter for Mouser and Farnell
+  - `src/sources/samacsys_distributor_adapter.js` is the shared backend adapter for Mouser, Farnell, element14, and Newark
 - `src/sources/samacsys_common.js` holds the shared SamacSys preview, ZIP, relay-cookie, relay-auth, upstream-auth, direct-request ZIP-auth fallback, and asset-rewrite helpers
 - `src/kicad_converter.js`: stable public converter facade
 - `src/kicad/*.js`: EasyEDA parsing, KiCad text generation, shared conversion math, and OBJ-to-WRL conversion
@@ -29,7 +29,7 @@ This file records short implementation notes that supplement, but do not replace
 
 - The popup does not fetch, extract, or convert CAD assets directly; it only requests that work.
 - The runtime/router owns provider branching, while source adapters own source-specific preview and export behavior.
-- Farnell does not have its own backend adapter file because it intentionally reuses the shared SamacSys distributor backend.
+- Farnell, element14, and Newark do not have their own backend adapter files because they intentionally reuse the shared SamacSys distributor backend.
 - Symbol library append behavior depends on `chrome.storage.local`, not on local filesystem reads.
 - Library-mode download paths remain relative to Downloads and are resolved from extension settings, not absolute filesystem paths.
 - SamacSys distributor support is still Chrome-first, but Firefox can opt into a user-managed relay through the advanced Firefox settings menu.
diff --git a/docs/firefox-samacsys-proxy.md b/docs/firefox-samacsys-proxy.md
@@ -258,7 +258,7 @@ export default {
 
    For the Worker code above, this should match the value stored in `PROXY_BEARER_TOKEN`.
 10. Leave `Remember helper password/token on this device` unticked unless you accept the local-storage risk.
-11. Reload the target Mouser or Farnell page.
+11. Reload the target Mouser, Farnell, element14, or Newark page.
 12. Test previews in Firefox first.
 13. If previews work, try ZIP export.
 
@@ -267,4 +267,4 @@ export default {
 - This Porxy is intentionally restricted to `*.componentsearchengine.com` targets so it does not become a generic open proxy.
 - The current extension relay contract expects the proxy to expose the final upstream URL through `x-upstream-url`.
 - The extension sends porxy auth separately in the proxy request `Authorization` header.
-- The extension also forwards an explicit upstream SamacSys `Authorization` header in `headers.Authorization`, sourced from locally generated Basic auth.
+- The extension also forwards an explicit upstream SamacSys `Authorization` header in `headers.Authorization`, sourced from locally generated Basic auth.
diff --git a/manifest.json b/manifest.json
@@ -45,7 +45,9 @@
         "*://*.mouser.com/*",
         "*://*.mouser.co.uk/*",
         "*://uk.farnell.com/*",
-        "*://*.farnell.com/*"
+        "*://*.farnell.com/*",
+        "*://*.element14.com/*",
+        "*://*.newark.com/*"
       ],
       "js": ["src/content_script.js"]
     }
diff --git a/src/content_script.js b/src/content_script.js
@@ -13,11 +13,13 @@ const DISTRIBUTORS = {
   mouser: {
     provider: MOUSER_PROVIDER,
     sourcePartLabel: "Mouser part",
+    partnerName: "mouser",
     baseUrl: "https://ms.componentsearchengine.com"
   },
   farnell: {
     provider: FARNELL_PROVIDER,
     sourcePartLabel: "Farnell part",
+    partnerName: "farnell",
     baseUrl: "https://farnell.componentsearchengine.com"
   }
 };
@@ -33,6 +35,14 @@ function isEasyedaHost() {
   return /(^|\.)((lcsc|jlcpcb)\.com)$/i.test(window.location.hostname);
 }
 
+function isElement14Host() {
+  return /(^|\.)element14\.com$/i.test(window.location.hostname);
+}
+
+function isNewarkHost() {
+  return /(^|\.)newark\.com$/i.test(window.location.hostname);
+}
+
 // Normalize a label so we can compare it reliably.
 function normalizeLabel(text) {
   return text.replace(/\s+/g, " ").trim().toLowerCase();
@@ -223,6 +233,7 @@ function findFarnellProductData() {
   const descriptionData = parseFarnellDescriptionProductData();
   const imageAltData = parseFarnellImageAltProductData();
   const pathData = parseFarnellPathProductData();
+  const newarkHost = isNewarkHost();
 
   return {
     manufacturerName:
@@ -238,7 +249,12 @@ function findFarnellProductData() {
       pathData?.manufacturerPartNumber ||
       null,
     sourcePartNumber:
-      findLabeledText(["Order Code", "Farnell Part No", "Farnell No"], true) ||
+      findLabeledText(
+        newarkHost
+          ? ["Newark Part No", "Newark No", "Order Code"]
+          : ["Order Code", "Farnell Part No", "Farnell No"],
+        true
+      ) ||
       pathData?.sourcePartNumber ||
       getQueryParamValue("partNumber", "productId")
   };
@@ -297,17 +313,20 @@ function buildSamacsysPartContext({
   sourcePartNumber,
   manufacturerPartNumber,
   manufacturerName,
+  sourcePartLabel,
+  partnerName,
   baseUrl,
   authRefreshUrl,
   logo,
   lang
 }) {
   const config = DISTRIBUTORS[distributor];
+  const resolvedPartnerName = partnerName || config.partnerName || distributor;
   const entryUrl = buildSamacsysEntryUrl({
     baseUrl: baseUrl || config.baseUrl,
     manufacturerName,
     manufacturerPartNumber,
-    partnerName: distributor,
+    partnerName: resolvedPartnerName,
     logo,
     lang
   });
@@ -317,14 +336,14 @@ function buildSamacsysPartContext({
 
   return {
     provider: config.provider,
-    sourcePartLabel: config.sourcePartLabel,
+    sourcePartLabel: sourcePartLabel || config.sourcePartLabel,
     sourcePartNumber,
     manufacturerPartNumber,
     lookup: {
       manufacturerName,
       entryUrl,
       ...(authRefreshUrl ? { authRefreshUrl } : {}),
-      partnerName: distributor,
+      partnerName: resolvedPartnerName,
       samacsysBaseUrl: baseUrl || config.baseUrl
     }
   };
@@ -419,18 +438,37 @@ function findMouserPartContext() {
 }
 
 function findFarnellPartContext() {
+  const element14Host = isElement14Host();
+  const newarkHost = isNewarkHost();
+  const brandPartnerName = newarkHost
+    ? "newark"
+    : element14Host
+      ? "element14"
+      : "farnell";
+  const brandSourcePartLabel = newarkHost
+    ? "Newark part"
+    : element14Host
+      ? "element14 part"
+      : "Farnell part";
+  const brandBaseUrl = newarkHost
+    ? "https://newark.componentsearchengine.com"
+    : element14Host
+      ? "https://element14.componentsearchengine.com"
+      : DISTRIBUTORS.farnell.baseUrl;
   const samacsysLink = findSamacsysLinkElement();
-  const linkMetadata = parseSamacsysLinkUrl(samacsysLink?.href, "farnell");
+  const linkMetadata = parseSamacsysLinkUrl(samacsysLink?.href, brandPartnerName);
   const farnellProductData = findFarnellProductData();
   const manufacturerName = linkMetadata?.manufacturerName || farnellProductData.manufacturerName;
   const manufacturerPartNumber =
     linkMetadata?.manufacturerPartNumber || farnellProductData.manufacturerPartNumber;
   return buildSamacsysPartContext({
     distributor: "farnell",
+    sourcePartLabel: brandSourcePartLabel,
     sourcePartNumber: farnellProductData.sourcePartNumber,
     manufacturerPartNumber,
     manufacturerName,
-    baseUrl: linkMetadata?.baseUrl || DISTRIBUTORS.farnell.baseUrl,
+    partnerName: linkMetadata?.partnerName || brandPartnerName,
+    baseUrl: linkMetadata?.baseUrl || brandBaseUrl,
     authRefreshUrl: linkMetadata ? samacsysLink.href : null,
     logo: linkMetadata?.logo,
     lang: linkMetadata?.lang
diff --git a/src/settings.html b/src/settings.html
@@ -48,7 +48,7 @@ <h2 id="downloadSettingsTitle">Downloads</h2>
         <section class="settings-section" aria-labelledby="authSettingsTitle">
           <h2 id="authSettingsTitle">SamacSys sign-in</h2>
           <p class="settings-hint">
-            Leave blank unless Mouser or Farnell asks you to sign in before
+            Leave blank unless Mouser, Farnell, element14, or Newark asks you to sign in before
             downloading CAD files.
           </p>
           <label class="settings-field" for="samacsysFirefoxUsername">
diff --git a/systemDesign.md b/systemDesign.md
diff --git a/tests/test_content_script.test.js b/tests/test_content_script.test.js
