search-web-api 1.0.13

package/src/registry/search-engine-descriptions.ts

@@ -0,0 +1,121 @@
+/**
+ * Search Engine Descriptions — Human-readable descriptions for every search
+ * engine adapter in this package, sourced from SearXNG's engine_descriptions.json
+ * and extended with engines specific to this implementation. Used for API
+ * documentation, UI tooltips, and README generation.
+ */
+
+export const engineDescriptions: { [key: string]: string } = {
+  "1337x":
+    "1337x is a website that provides a directory of torrent files and magnet links used for peer-to-peer file sharing through the BitTorrent protocol. It is primarily used to facilitate online piracy.",
+  annas_archive:
+    'Anna\'s Archive is an open source search engine for shadow libraries that was launched by the pseudonymous Anna shortly after law enforcement efforts to shut down Z-Library in 2022. The site aggregates records from Z-Library, Sci-Hub, and Library Genesis (LibGen), among other sources. It calls itself "the largest truly open library in human history", and has said it aims to "catalog all the books in existence" and "track humanity\'s progress toward making all these books easily available i...',
+  apple_maps:
+    'Apple Maps is a web mapping service developed by Apple. As the default map system of iOS, iPadOS, macOS, tvOS, visionOS, and watchOS, it provides directions and estimated times of arrival for driving, walking, cycling, and public transportation navigation. A "Flyover" mode shows certain urban centers and other places of interest in a 3D landscape composed of models of buildings and structures.',
+  arxiv:
+    "arXiv is an open-access repository of electronic preprints and postprints approved for posting after moderation, but not peer reviewed. It consists of scientific papers in the fields of mathematics, physics, astronomy, electrical engineering, computer science, quantitative biology, statistics, mathematical finance, and economics, which can be accessed online. In many fields of mathematics and physics, almost all scientific papers are self-archived on the arXiv repository before publication in...",
+  baidu:
+    "Baidu, Inc. is a Chinese multinational technology company specializing in Internet services and artificial intelligence. It holds a dominant position in China's search engine market, and provides a wide variety of other internet services such as Baidu App, Baidu Baike, iQIYI, and Baidu Tieba.",
+  bing: "Microsoft Bing is a search engine owned and operated by Microsoft, it is developed by Microsoft AI. The service traces its roots back to Microsoft's earlier search engines, including MSN Search, Windows Live Search, and Live Search. Bing offers a broad spectrum of search services, encompassing web, video, image, and map search products, all developed using ASP.NET.",
+  bing_images: "bing:en",
+  bing_news: "bing:en",
+  brave:
+    "Brave is a free and open-source web browser which was first released in 2016. It is developed by US-based Brave Software, Inc. and based on the Chromium web browser. The browser is marketed as a privacy-focused web browser and includes features such as built-in advertisement blocking, protections against browser fingerprinting and a private browsing mode that integrates the Tor anonymity network. Brave also incorporates its own advertising through a rewards system based on cryptocurrency, whi...",
+  crates: "crates.io: Rust Package Registry",
+  crossref:
+    "Crossref is a nonprofit open digital infrastructure organization for the global scholarly research community. It is the largest digital object identifier (DOI) Registration Agency of the International DOI Foundation. It has 19,000 members from 150 countries representing publishers, libraries, research institutions, and funders and was launched in early 2000 as a cooperative effort among publishers to enable persistent cross-platform citation linking in online academic journals. As of July 202...",
+  dailymotion:
+    "Dailymotion is a French online video sharing platform owned by Canal+. Prior to 2024, it was owned by Vivendi. North American launch partners included Vice Media, Bloomberg, and Hearst Digital Media. Dailymotion was among the first platforms to support HD (720p) resolution video. It is available worldwide in 183 languages and 43 localised versions featuring local home pages and content. It has more than 300 million monthly users.",
+  deviantart:
+    "DeviantArt is an American online community that features artwork, videography, photography, and literature, launched on August 7, 2000, by Mathew Stephens, Scott Jarkoff and Angelo Sotira, among others.",
+  dockerhub: "hosting service for Docker repository",
+  flickr:
+    "Flickr is an image and video hosting service, as well as an online community, founded in Canada and headquartered in the United States. It was created by Ludicorp in 2004 and was for a time a common way for amateur and professional photographers to host high-resolution photos. Flickr was owned by Yahoo! from 2005 and has been owned by SmugMug since 2018.",
+  genius:
+    "Genius is an American digital media company founded on August 27, 2009, by Tom Lehman, Ilan Zechory, and Mahbod Moghadam. The company's eponymous website serves as a database for song lyrics, news stories, sources, poetry, and documents, in which users can provide annotations and interpretations for.",
+  github:
+    "GitHub is a proprietary developer platform that allows developers to create, store, manage, and share their code. It uses Git to provide distributed version control and GitHub itself provides access control, bug tracking, software feature requests, task management, continuous integration, and wikis for every project. GitHub has been a subsidiary of Microsoft since 2018 and its headquarters are located in San Francisco.",
+  goodreads:
+    "Goodreads is an American social cataloging website operated by Goodreads, Inc., a subsidiary of Amazon. Users can search its database of books, annotations, quotes, and reviews and expand the database by registering books to generate library catalogs and reading lists. They can also create their own groups of book suggestions, surveys, polls, blogs, and discussions. The website's offices are located in San Francisco.",
+  google:
+    "Google Search is a search engine operated by Google. It allows users to search for information on the Web by entering keywords or phrases. Google Search uses algorithms to analyze and rank websites based on their relevance to the search query. Google Search is the most-visited website in the world. As of 2025, Google Search has a 90% share of the global search engine market. Approximately 24.1% of Google's monthly global traffic comes from the United States, 5.6% from India, 5.5% from Japan, ...",
+  google_images:
+    "Google Images is a search engine owned by Google that allows users to search the World Wide Web for images. It was introduced on July 12, 2001, due to a demand for pictures of the green Versace dress of Jennifer Lopez worn in February 2000. In 2011, image search functionality was added.",
+  google_news:
+    "Google News is a news aggregator service developed by Google. It presents a continuous flow of links to articles organized from thousands of publishers and magazines.",
+  google_scholar:
+    "Google Scholar is a freely accessible web search engine that indexes the full text or metadata of scholarly literature across an array of publishing formats and disciplines. Released in beta in November 2004, the Google Scholar index includes peer-reviewed online academic journals and books, conference papers, theses and dissertations, preprints, abstracts, technical reports, and other scholarly literature, including court opinions and patents.",
+  hackernews:
+    'Hacker News (HN) is an American social news website focusing on computer science and entrepreneurship. It is run by the investment fund and startup incubator Y Combinator. In general, content that can be submitted is defined as "anything that gratifies one\'s intellectual curiosity."',
+  imdb: "IMDb, historically known as the Internet Movie Database, is an online database of information related to films, television series, podcasts, video games, and streaming content online – including cast, production crew and biographies, plot summaries, trivia, ratings, and fan and critical reviews. As of September 2025, IMDb ranks as the 40th most visited website in the world and the 35th in the United States.",
+  imgur:
+    "Imgur is an American online image sharing community and image host founded by Alan Schaaf in 2009. The service has hosted viral images and memes, particularly those posted on Reddit.",
+  kickass:
+    "KickassTorrents was a website that provided a directory for torrent files and magnet links to facilitate peer-to-peer file sharing using the BitTorrent protocol. It was founded in 2008 and by November 2014, KAT became the most visited BitTorrent directory in the world, overtaking The Pirate Bay, according to the site's Alexa ranking. KAT went offline on 20 July 2016 when the domain was seized by the U.S. government. The site's proxy servers were shut down by its staff at the same time.",
+  mojeek:
+    "Mojeek is a UK-based search engine known for its focus on privacy and independence from other major search indexes. Established with a commitment to user privacy, Mojeek operates its own crawler-based index, setting it apart from search engines that rely on third-party search results, such as those from Google or Bing.",
+  npm: "npm is a package manager for the JavaScript programming language maintained by npm, Inc., a subsidiary of GitHub. npm is the default package manager for the JavaScript runtime environment Node.js and is included as a recommended feature in the Node.js installer.",
+  nyaa: "A BitTorrent community focused on Eastern Asian media including anime, manga, music, and more",
+  openlibrary:
+    'Open Library is an online project intended to create "one web page for every book ever published". Created by Aaron Swartz, Brewster Kahle, Alexis Rossi, Anand Chitipothu, and Rebecca Hargrave Malamud, Open Library is a project of the Internet Archive, a nonprofit organization. It has been funded in part by grants from the California State Library and the Kahle/Austin Foundation. Open Library provides online digital copies in multiple formats, created from images of many public domain, out-...',
+  openstreetmap:
+    "OpenStreetMap (OSM) is a map database maintained by a community of volunteers via open collaboration. Contributors collect data from surveys, trace from aerial photo imagery or satellite imagery, and import from other freely licensed geodata sources. OpenStreetMap is freely licensed under the Open Database License and is commonly used to make electronic maps, inform turn-by-turn navigation, and assist in humanitarian aid and data visualisation. OpenStreetMap uses its own data model to store g...",
+  packagist:
+    "The main Composer repository, aggregating public PHP packages installable with Composer",
+  peertube:
+    "PeerTube is a free and open-source, decentralized, ActivityPub federated video platform. It can use peer-to-peer technology to reduce load on individual servers when videos get popular.",
+  photon: "Photon, search-as-you-type with OpenStreetMap",
+  pixabay:
+    "Pixabay.com is a free stock photography and royalty-free stock media website. It is used for sharing photos, illustrations, vector graphics, film footage, stock music and sound effects, exclusively under the custom Pixabay Content License, which generally allows the free use of the material with some restrictions. The site's images are allowed to be used for free without attribution, and allowed to be modified and adapted into new works. Pixabay does not allow users to sell or distribute the ...",
+  pubmed:
+    "MEDLINE is a bibliographic database of life sciences and biomedical information. It includes bibliographic information for articles from academic journals covering medicine, nursing, pharmacy, dentistry, veterinary medicine, and health care. MEDLINE also covers much of the literature in biology and biochemistry, as well as fields such as molecular evolution.",
+  pypi: "The Python Package Index, abbreviated as PyPI and also known as the Cheese Shop, is the official third-party software repository for Python. It is analogous to the CPAN repository for Perl and to the CRAN repository for R. PyPI is run by the Python Software Foundation, a charity. Some package managers, including pip, use PyPI as the default source for packages and their dependencies.",
+  qwant:
+    "Qwant is a French search engine, launched in February 2013. Qwant says that it is focused on privacy, does not track users, resell personal data, or bias the display of search results. Its results are similar to the Microsoft Bing search engine however it is used only in case Qwant lacks information of certain website and for image searches. Qwant is currently only available in around 30 countries.",
+  reddit:
+    'Reddit is an American proprietary social news aggregation and forum social media platform. Registered users submit content to the site such as links, text posts, images, and videos, which are then voted up or down by other members. Posts are organized by subject into user-created boards called "subreddits". Submissions with more upvotes appear towards the top of their subreddit and, if they receive enough upvotes, ultimately on the site\'s front page. Reddit administrators moderate the commu...',
+  rubygems:
+    "RubyGems is a package manager for the Ruby programming language that provides a standard format for distributing Ruby programs and libraries, a tool designed to easily manage the installation of gems, and a server for distributing them. It was created by Chad Fowler, Jim Weirich, David Alan Black, Paul Brannan and Richard Kilmer in 2004.",
+  semantic_scholar:
+    "Semantic Scholar is a research tool for scientific literature. It is developed at the Allen Institute for AI and was publicly released in November 2015. Semantic Scholar uses modern techniques in natural language processing to support the research process, for example by providing automatically generated summaries of scholarly papers. The Semantic Scholar team is actively researching the use of artificial intelligence in natural language processing, machine learning, human–computer interactio...",
+  soundcloud:
+    "SoundCloud is a German audio streaming service owned and operated by SoundCloud Global Limited & Co. KG. The service allows its users to upload, promote, and share audio. Founded in 2007 by Alexander Ljung and Eric Wahlforss, SoundCloud is one of the largest music streaming services in the world and is available in 190 countries and territories. The service has upwards of 76 million active monthly users and over 200 million audio tracks as of November 2021. SoundCloud offers both free and pai...",
+  stackoverflow:
+    "Stack Exchange is a network of question-and-answer (Q&A) websites on topics in diverse fields, each site covering a specific topic, where questions, answers, and users are subject to a reputation award process. The reputation system allows the sites to be self-moderating. Currently, Stack Exchange is composed of 173 communities bringing in over 100 million unique visitors each month. As of February 2025 the three most active sites in the network were Stack Overflow, Mathematics, and Ask Ubuntu.",
+  startpage:
+    "Startpage.com is a Dutch search engine website that highlights privacy as its distinguishing feature. The website advertises that it allows users to obtain Bing Search and Google Search results while protecting users' privacy by not storing personal information or search data and removing all trackers. Startpage.com also includes an Anonymous View browsing feature that allows users the option to open search results via proxy for increased anonymity. Startpage is owned and operated by Surfboar...",
+  thepiratebay:
+    "The Pirate Bay, commonly abbreviated as TPB, is a free searchable online index of movies, music, video games, pornography and software. Founded in 2003 by Swedish think tank Piratbyrån, The Pirate Bay facilitates the connection among users of the peer-to-peer torrent protocol, which are able to contribute to the site through the addition of magnet links. The Pirate Bay has consistently ranked as one of the most visited torrent websites in the world.",
+  unsplash:
+    "Unsplash is a website dedicated to proprietary stock photography. Since 2021, it has been owned by Getty Images. The website claims over 330,000 contributing photographers and generates more than 13 billion photo impressions per month on their growing library of over 5 million photos. Unsplash has been cited as one of the world's leading photography websites by Forbes, Design Hub, CNET, Medium and The Next Web.",
+  vimeo:
+    "Vimeo is an American video hosting, sharing, and services provider founded in 2004 and headquartered in New York City. Vimeo focuses on the delivery of high-definition video across a range of devices and operates on a software as a service (SaaS) business model. The platform provides tools for video creation, editing, and broadcasting along with enterprise software solutions and the means for video professionals to connect with clients and other professionals. As of December 2021, the site ha...",
+  wallhaven: "Your source for the best high quality wallpapers on the Net!",
+  wikidata:
+    "Wikidata is a collaboratively edited multilingual knowledge graph hosted by the Wikimedia Foundation. It is a common source of open data that Wikimedia projects such as Wikipedia, and anyone else, are able to use under the CC0 public domain license. Wikidata is a wiki powered by the software MediaWiki, including its extension for semi-structured data, the Wikibase. As of early 2025, Wikidata had 1.65 billion item statements.",
+  wikipedia:
+    "Wikipedia is a free online encyclopedia written and maintained by a community of volunteers, usually known as Wikipedians, through open collaboration and the wiki software MediaWiki. Founded by Jimmy Wales and Larry Sanger in 2001, Wikipedia has been hosted since 2003 by the Wikimedia Foundation, an American nonprofit organization funded mainly by donations from readers. Wikipedia is the largest and most-read reference work in history.",
+  wttr: "weather forecast service",
+  yahoo:
+    "The search engine that helps you find exactly what you're looking for. Find the most relevant information, video, images, and answers from all across the Web.",
+  yahoo_news:
+    "Yahoo News is a news website that originated as an internet-based news aggregator by Yahoo.",
+  yandex:
+    "Yandex LLC is a Russian technology company that provides Internet-related products and services including a web browser, search engine, cloud computing, web mapping, online food ordering, streaming media, online shopping, and a ridesharing company.",
+  youtube:
+    "YouTube is an American social media and online video sharing platform owned by Google. YouTube was founded on February 14, 2005, by Chad Hurley, Jawed Karim, and Steve Chen, who were former employees of PayPal. Headquartered in San Bruno, California, it is the second-most-visited website in the world, after Google. In January 2024, YouTube had more than 2.7 billion monthly active users, who collectively watched more than one billion hours of videos every day. As of May 2019, videos were being...",
+};
+
+/**
+ * Get the description for a named engine. Returns `undefined` if not found.
+ */
+export function getEngineDescription(engineName: string): string | undefined {
+  return engineDescriptions[engineName];
+}
+
+/**
+ * Get the list of engine names that have a description entry.
+ */
+export function getEnginesWithDescriptions(): string[] {
+  return Object.keys(engineDescriptions);
+}

package/src/registry/search-engine-status-tracker.ts

@@ -0,0 +1,240 @@
+/**
+ * Search Engine Status Tracker — Monitors the health of every search engine
+ * adapter at runtime. It records success and failure events, computes running
+ * failure rates, and automatically marks an engine as "failed" when more than
+ * 70 % of its recent requests have errored. Engines recover automatically once
+ * their success rate exceeds twice their failure count.
+ */
+
+import { EngineStatus, EngineLog } from "../types/search-result-types.js";
+
+export class EngineStatusTracker {
+  private statusMap: Map<string, EngineStatus> = new Map();
+  private logs: EngineLog[] = [];
+  private maxLogs: number = 1000;
+
+  /**
+   * Initialise tracking state for an engine (no-op if already initialised).
+   */
+  initEngine(name: string, categories: string[] = []): void {
+    if (!this.statusMap.has(name)) {
+      this.statusMap.set(name, {
+        name,
+        status: "active",
+        lastCheck: new Date(),
+        lastSuccess: null,
+        lastFailure: null,
+        failureCount: 0,
+        successCount: 0,
+        totalRequests: 0,
+        averageResponseTime: 0,
+        categories,
+      });
+    }
+  }
+
+  /**
+   * Record a successful engine execution and update rolling averages.
+   */
+  recordSuccess(
+    engineName: string,
+    responseTime: number,
+    query?: string,
+  ): void {
+    const status = this.statusMap.get(engineName);
+    if (!status) {
+      this.initEngine(engineName);
+      return this.recordSuccess(engineName, responseTime, query);
+    }
+
+    const now = new Date();
+    status.lastCheck = now;
+    status.lastSuccess = now;
+    status.successCount++;
+    status.totalRequests++;
+
+    const totalTime =
+      status.averageResponseTime * (status.successCount - 1) + responseTime;
+    status.averageResponseTime = totalTime / status.successCount;
+
+    if (status.failureCount > 0 && status.successCount > status.failureCount * 2) {
+      status.status = "active";
+    }
+
+    this.addLog({ timestamp: now, engineName, status: "success", responseTime, query });
+  }
+
+  /**
+   * Record a failed engine execution and escalate status if failure rate exceeds 70 %.
+   */
+  recordFailure(
+    engineName: string,
+    error: string,
+    responseTime: number = 0,
+    query?: string,
+  ): void {
+    const status = this.statusMap.get(engineName);
+    if (!status) {
+      this.initEngine(engineName);
+      return this.recordFailure(engineName, error, responseTime, query);
+    }
+
+    const now = new Date();
+    status.lastCheck = now;
+    status.lastFailure = now;
+    status.failureCount++;
+    status.totalRequests++;
+    status.lastError = error;
+
+    if (status.totalRequests >= 5) {
+      const failureRate = status.failureCount / status.totalRequests;
+      if (failureRate > 0.7) {
+        status.status = "failed";
+      }
+    }
+
+    this.addLog({
+      timestamp: now,
+      engineName,
+      status: "failure",
+      responseTime,
+      error,
+      query,
+    });
+  }
+
+  /**
+   * Get the current status record for a specific engine.
+   */
+  getStatus(engineName: string): EngineStatus | undefined {
+    return this.statusMap.get(engineName);
+  }
+
+  /**
+   * Get status records for all tracked engines.
+   */
+  getAllStatuses(): EngineStatus[] {
+    return Array.from(this.statusMap.values());
+  }
+
+  /**
+   * Get status records filtered to a specific category.
+   */
+  getStatusesByCategory(category: string): EngineStatus[] {
+    return Array.from(this.statusMap.values()).filter((status) =>
+      status.categories.includes(category),
+    );
+  }
+
+  /**
+   * Get the most recent log entries (default: last 100).
+   */
+  getRecentLogs(limit: number = 100): EngineLog[] {
+    return this.logs.slice(-limit);
+  }
+
+  /**
+   * Get log entries for a specific engine (default: last 50).
+   */
+  getEngineLogs(engineName: string, limit: number = 50): EngineLog[] {
+    return this.logs.filter((log) => log.engineName === engineName).slice(-limit);
+  }
+
+  /**
+   * Return the failure rate (0–1) for an engine. Returns 0 for unknown engines.
+   */
+  getFailureRate(engineName: string): number {
+    const status = this.statusMap.get(engineName);
+    if (!status || status.totalRequests === 0) return 0;
+    return status.failureCount / status.totalRequests;
+  }
+
+  /**
+   * Return true if the engine is active (not failed or disabled).
+   * Unknown engines are assumed healthy.
+   */
+  isEngineHealthy(engineName: string): boolean {
+    const status = this.statusMap.get(engineName);
+    if (!status) return true;
+    return status.status === "active";
+  }
+
+  /**
+   * Manually disable an engine so it is skipped during searches.
+   */
+  disableEngine(engineName: string): void {
+    const status = this.statusMap.get(engineName);
+    if (status) status.status = "disabled";
+  }
+
+  /**
+   * Manually re-enable an engine and reset its failure count.
+   */
+  enableEngine(engineName: string): void {
+    const status = this.statusMap.get(engineName);
+    if (status) {
+      status.status = "active";
+      status.failureCount = 0;
+    }
+  }
+
+  /**
+   * Reset all counters and status for an engine back to a clean active state.
+   */
+  resetEngine(engineName: string): void {
+    const status = this.statusMap.get(engineName);
+    if (status) {
+      status.failureCount = 0;
+      status.successCount = 0;
+      status.totalRequests = 0;
+      status.averageResponseTime = 0;
+      status.status = "active";
+      status.lastError = undefined;
+    }
+  }
+
+  /**
+   * Clear all stored log entries.
+   */
+  clearLogs(): void {
+    this.logs = [];
+  }
+
+  /**
+   * Get a high-level summary of engine health across all tracked engines.
+   */
+  getStatsSummary(): {
+    total: number;
+    active: number;
+    failed: number;
+    disabled: number;
+    averageFailureRate: number;
+  } {
+    const statuses = this.getAllStatuses();
+    const total = statuses.length;
+    const active = statuses.filter((s) => s.status === "active").length;
+    const failed = statuses.filter((s) => s.status === "failed").length;
+    const disabled = statuses.filter((s) => s.status === "disabled").length;
+
+    const failureRates = statuses
+      .filter((s) => s.totalRequests > 0)
+      .map((s) => s.failureCount / s.totalRequests);
+
+    const averageFailureRate =
+      failureRates.length > 0
+        ? failureRates.reduce((a, b) => a + b, 0) / failureRates.length
+        : 0;
+
+    return { total, active, failed, disabled, averageFailureRate };
+  }
+
+  private addLog(log: EngineLog): void {
+    this.logs.push(log);
+    if (this.logs.length > this.maxLogs) {
+      this.logs = this.logs.slice(-this.maxLogs);
+    }
+  }
+}
+
+/** Global singleton instance used throughout the application. */
+export const engineStatusTracker = new EngineStatusTracker();

package/src/result-container.ts

@@ -0,0 +1,8 @@
+/**
+ * Result Container — Re-exports the ResultContainer class from its canonical
+ * location in the search module. ResultContainer aggregates results from multiple
+ * engines, deduplicates by URL hash, merges duplicate records, scores results
+ * using position-weighted per-engine and per-category multipliers, and groups
+ * the final list by result category.
+ */
+export * from "./search/search-result-container.js";

package/src/search/search-engines-registry-list.ts

@@ -0,0 +1,205 @@
+/**
+ * Search Engines Registry List — Defines the complete catalogue of all 75 search
+ * engine adapters available in this package, organised by category. Each entry
+ * maps an engine name to its async query function and one or more categories.
+ * Also sets the global grab-url default User-Agent header so every engine
+ * request appears as a standard browser request.
+ *
+ * Split from the main search module to keep the large import block and static
+ * data separate from the query-execution logic.
+ */
+
+import { EngineFunction } from "../types/search-engine-interface.js";
+import { EngineMetadata } from "../types/search-result-types.js";
+import { engineDescriptions } from "../registry/search-engine-descriptions.js";
+import grab from "grab-url";
+
+// Set default browser User-Agent for all outgoing requests
+grab("", {
+  setDefaults: true,
+  headers: {
+    "User-Agent":
+      "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+  },
+});
+
+// General search engines
+import { google } from "../sources/general/google.js";
+import { bing } from "../sources/general/bing.js";
+import { duckduckgo } from "../sources/general/duckduckgo.js";
+import { yahoo } from "../sources/general/yahoo.js";
+import { qwant } from "../sources/general/qwant.js";
+import { startpage } from "../sources/general/startpage.js";
+import { brave } from "../sources/general/brave.js";
+import { yandex } from "../sources/general/yandex.js";
+import { baidu } from "../sources/general/baidu.js";
+import { mojeek } from "../sources/general/mojeek.js";
+
+// IT / Developer engines
+import { github } from "../sources/it/github.js";
+import { stackoverflow } from "../sources/it/stackoverflow.js";
+import { npm } from "../sources/it/npm.js";
+import { crates } from "../sources/it/crates.js";
+import { dockerhub } from "../sources/it/dockerhub.js";
+import { pypi } from "../sources/it/pypi.js";
+import { packagist } from "../sources/it/packagist.js";
+import { rubygems } from "../sources/it/rubygems.js";
+import { gitlab } from "../sources/it/gitlab.js";
+
+// Image engines
+import { unsplash } from "../sources/images/unsplash.js";
+import { bing_images } from "../sources/images/bing_images.js";
+import { google_images } from "../sources/images/google_images.js";
+import { flickr } from "../sources/images/flickr.js";
+import { imgur } from "../sources/images/imgur.js";
+import { pixabay } from "../sources/images/pixabay.js";
+import { wallhaven } from "../sources/images/wallhaven.js";
+import { deviantart } from "../sources/images/deviantart.js";
+import { openclipart } from "../sources/images/openclipart.js";
+
+// Video engines
+import { youtube } from "../sources/videos/youtube.js";
+import { vimeo } from "../sources/videos/vimeo.js";
+import { dailymotion } from "../sources/videos/dailymotion.js";
+import { invidious } from "../sources/videos/invidious.js";
+import { peertube } from "../sources/videos/peertube.js";
+import { bing_videos } from "../sources/videos/bing_videos.js";
+
+// News engines
+import { hackernews } from "../sources/news/hackernews.js";
+import { yahoo_news } from "../sources/news/yahoo_news.js";
+import { bing_news } from "../sources/news/bing_news.js";
+import { google_news } from "../sources/news/google_news.js";
+
+// Academic engines
+import { google_scholar } from "../sources/academic/google_scholar.js";
+import { arxiv } from "../sources/academic/arxiv.js";
+import { wikidata } from "../sources/academic/wikidata.js";
+import { semantic_scholar } from "../sources/academic/semantic_scholar.js";
+import { crossref } from "../sources/academic/crossref.js";
+import { pubmed } from "../sources/academic/pubmed.js";
+import { openalex } from "../sources/academic/openalex.js";
+import { doaj } from "../sources/academic/doaj.js";
+import { core } from "../sources/academic/core.js";
+
+// Torrent engines
+import { torrent_1337x } from "../sources/torrents/1337x.js";
+import { thepiratebay } from "../sources/torrents/thepiratebay.js";
+import { nyaa } from "../sources/torrents/nyaa.js";
+import { yts } from "../sources/torrents/yts.js";
+import { eztv } from "../sources/torrents/eztv.js";
+import { solidtorrents } from "../sources/torrents/solidtorrents.js";
+import { kickass } from "../sources/torrents/kickass.js";
+
+// Social media engines
+import { twitter } from "../sources/social/twitter.js";
+import { reddit } from "../sources/social/reddit.js";
+import { medium } from "../sources/social/medium.js";
+import { soundcloud } from "../sources/social/soundcloud.js";
+import { mastodon } from "../sources/social/mastodon.js";
+
+// Map engines
+import { openstreetmap } from "../sources/maps/openstreetmap.js";
+import { photon } from "../sources/maps/photon.js";
+import { apple_maps } from "../sources/maps/apple_maps.js";
+
+// Shopping engines
+import { ebay } from "../sources/shopping/ebay.js";
+
+// Specialised engines
+import { wikipedia } from "../sources/specialized/wikipedia.js";
+import { imdb } from "../sources/specialized/imdb.js";
+import { genius } from "../sources/specialized/genius.js";
+import { archive } from "../sources/specialized/archive.js";
+import { openlibrary } from "../sources/specialized/openlibrary.js";
+import { wttr } from "../sources/specialized/wttr.js";
+import { annas_archive } from "../sources/specialized/annas_archive.js";
+import { goodreads } from "../sources/specialized/goodreads.js";
+
+export { engineDescriptions };
+
+/** Complete list of all 75 registered search engine adapters. */
+export const ALL_ENGINES: EngineMetadata[] = [
+  // General (10)
+  { name: "google",      fn: google,      categories: ["general"] },
+  { name: "bing",        fn: bing,        categories: ["general"] },
+  { name: "duckduckgo",  fn: duckduckgo,  categories: ["general"] },
+  { name: "yahoo",       fn: yahoo,       categories: ["general"] },
+  { name: "qwant",       fn: qwant,       categories: ["general"] },
+  { name: "startpage",   fn: startpage,   categories: ["general"] },
+  { name: "brave",       fn: brave,       categories: ["general"] },
+  { name: "yandex",      fn: yandex,      categories: ["general"] },
+  { name: "baidu",       fn: baidu,       categories: ["general"] },
+  { name: "mojeek",      fn: mojeek,      categories: ["general"] },
+  // IT / Developer (9)
+  { name: "github",      fn: github,      categories: ["it"] },
+  { name: "gitlab",      fn: gitlab,      categories: ["it"] },
+  { name: "stackoverflow", fn: stackoverflow, categories: ["it"] },
+  { name: "npm",         fn: npm,         categories: ["it"] },
+  { name: "crates",      fn: crates,      categories: ["it"] },
+  { name: "dockerhub",   fn: dockerhub,   categories: ["it"] },
+  { name: "pypi",        fn: pypi,        categories: ["it"] },
+  { name: "packagist",   fn: packagist,   categories: ["it"] },
+  { name: "rubygems",    fn: rubygems,    categories: ["it"] },
+  // Images (9)
+  { name: "unsplash",    fn: unsplash,    categories: ["images"] },
+  { name: "bing_images", fn: bing_images, categories: ["images"] },
+  { name: "google_images", fn: google_images, categories: ["images"] },
+  { name: "flickr",      fn: flickr,      categories: ["images"] },
+  { name: "imgur",       fn: imgur,       categories: ["images"] },
+  { name: "pixabay",     fn: pixabay,     categories: ["images"] },
+  { name: "wallhaven",   fn: wallhaven,   categories: ["images"] },
+  { name: "deviantart",  fn: deviantart,  categories: ["images"] },
+  { name: "openclipart", fn: openclipart, categories: ["images"] },
+  // Videos (6)
+  { name: "youtube",     fn: youtube,     categories: ["videos"] },
+  { name: "vimeo",       fn: vimeo,       categories: ["videos"] },
+  { name: "dailymotion", fn: dailymotion, categories: ["videos"] },
+  { name: "bing_videos", fn: bing_videos, categories: ["videos"] },
+  { name: "invidious",   fn: invidious,   categories: ["videos"] },
+  { name: "peertube",    fn: peertube,    categories: ["videos"] },
+  // News (4)
+  { name: "hackernews",  fn: hackernews,  categories: ["news"] },
+  { name: "yahoo_news",  fn: yahoo_news,  categories: ["news"] },
+  { name: "bing_news",   fn: bing_news,   categories: ["news"] },
+  { name: "google_news", fn: google_news, categories: ["news"] },
+  // Academic (9)
+  { name: "google_scholar",  fn: google_scholar,  categories: ["academic"] },
+  { name: "arxiv",           fn: arxiv,           categories: ["academic"] },
+  { name: "wikidata",        fn: wikidata,        categories: ["academic"] },
+  { name: "semantic_scholar", fn: semantic_scholar, categories: ["academic"] },
+  { name: "crossref",        fn: crossref,        categories: ["academic"] },
+  { name: "pubmed",          fn: pubmed,          categories: ["academic"] },
+  { name: "openalex",        fn: openalex,        categories: ["academic"] },
+  { name: "doaj",            fn: doaj,            categories: ["academic"] },
+  { name: "core",            fn: core,            categories: ["academic"] },
+  // Torrents (7)
+  { name: "1337x",        fn: torrent_1337x, categories: ["torrents"] },
+  { name: "thepiratebay", fn: thepiratebay,  categories: ["torrents"] },
+  { name: "nyaa",         fn: nyaa,          categories: ["torrents"] },
+  { name: "yts",          fn: yts,           categories: ["torrents"] },
+  { name: "eztv",         fn: eztv,          categories: ["torrents"] },
+  { name: "solidtorrents", fn: solidtorrents, categories: ["torrents"] },
+  { name: "kickass",      fn: kickass,       categories: ["torrents"] },
+  // Social (5)
+  { name: "twitter",    fn: twitter,    categories: ["social"] },
+  { name: "reddit",     fn: reddit,     categories: ["social"] },
+  { name: "medium",     fn: medium,     categories: ["social"] },
+  { name: "soundcloud", fn: soundcloud, categories: ["social"] },
+  { name: "mastodon",   fn: mastodon,   categories: ["social"] },
+  // Maps (3)
+  { name: "openstreetmap", fn: openstreetmap, categories: ["maps"] },
+  { name: "photon",        fn: photon,        categories: ["maps"] },
+  { name: "apple_maps",    fn: apple_maps,    categories: ["maps"] },
+  // Shopping (1)
+  { name: "ebay", fn: ebay, categories: ["shopping"] },
+  // Specialised (8)
+  { name: "wikipedia",    fn: wikipedia,    categories: ["specialized"] },
+  { name: "imdb",         fn: imdb,         categories: ["specialized"] },
+  { name: "genius",       fn: genius,       categories: ["specialized"] },
+  { name: "archive",      fn: archive,      categories: ["specialized"] },
+  { name: "openlibrary",  fn: openlibrary,  categories: ["specialized"] },
+  { name: "wttr",         fn: wttr,         categories: ["specialized"] },
+  { name: "annas_archive", fn: annas_archive, categories: ["specialized"] },
+  { name: "goodreads",    fn: goodreads,    categories: ["specialized"] },
+];