[upd] web-client (simple): Bump the minor group across 1 directory with 7 updates (#5989)

Bumps the minor group with 7 updates in the /client/simple directory:

| Package | From | To |
| --- | --- | --- |
| [ol](https://github.com/openlayers/openlayers) | `10.8.0` | `10.9.0` |
| [@biomejs/biome](https://github.com/biomejs/biome/tree/HEAD/packages/@biomejs/biome) | `2.4.10` | `2.4.12` |
| [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) | `25.5.2` | `25.6.0` |
| [mathjs](https://github.com/josdejong/mathjs) | `15.1.1` | `15.2.0` |
| [stylelint](https://github.com/stylelint/stylelint) | `17.6.0` | `17.8.0` |
| [typescript](https://github.com/microsoft/TypeScript) | `6.0.2` | `6.0.3` |
| [vite](https://github.com/vitejs/vite/tree/HEAD/packages/vite) | `8.0.5` | `8.0.8` |

Updates `ol` from 10.8.0 to 10.9.0
- [Release notes](https://github.com/openlayers/openlayers/releases)
- [Commits](https://github.com/openlayers/openlayers/compare/v10.8.0...v10.9.0)

Updates `@biomejs/biome` from 2.4.10 to 2.4.12
- [Release notes](https://github.com/biomejs/biome/releases)
- [Changelog](https://github.com/biomejs/biome/blob/main/packages/@biomejs/biome/CHANGELOG.md)
- [Commits](https://github.com/biomejs/biome/commits/@biomejs/biome@2.4.12/packages/@biomejs/biome)

Updates `@types/node` from 25.5.2 to 25.6.0
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node)

Updates `mathjs` from 15.1.1 to 15.2.0
- [Changelog](https://github.com/josdejong/mathjs/blob/develop/HISTORY.md)
- [Commits](https://github.com/josdejong/mathjs/compare/v15.1.1...v15.2.0)

Updates `stylelint` from 17.6.0 to 17.8.0
- [Release notes](https://github.com/stylelint/stylelint/releases)
- [Changelog](https://github.com/stylelint/stylelint/blob/main/CHANGELOG.md)
- [Commits](https://github.com/stylelint/stylelint/compare/17.6.0...17.8.0)

Updates `typescript` from 6.0.2 to 6.0.3
- [Release notes](https://github.com/microsoft/TypeScript/releases)
- [Commits](https://github.com/microsoft/TypeScript/compare/v6.0.2...v6.0.3)

Updates `vite` from 8.0.5 to 8.0.8
- [Release notes](https://github.com/vitejs/vite/releases)
- [Changelog](https://github.com/vitejs/vite/blob/main/packages/vite/CHANGELOG.md)
- [Commits](https://github.com/vitejs/vite/commits/v8.0.8/packages/vite)

---
updated-dependencies:
- dependency-name: ol
  dependency-version: 10.9.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: minor
- dependency-name: "@biomejs/biome"
  dependency-version: 2.4.12
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: minor
- dependency-name: "@types/node"
  dependency-version: 25.6.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: minor
- dependency-name: mathjs
  dependency-version: 15.2.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: minor
- dependency-name: stylelint
  dependency-version: 17.8.0
  dependency-type: direct:development
  update-type: version-update:semver-minor
  dependency-group: minor
- dependency-name: typescript
  dependency-version: 6.0.3
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: minor
- dependency-name: vite
  dependency-version: 8.0.8
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>

.github/ISSUE_TEMPLATE/bug-report.md

@@ -1,39 +1,50 @@
 ---
-name: Bug report
-about: Report a bug in SearXNG
-title: ''
-labels: bug
-assignees: ''
-
+name: "Bug report"
+about: Report a bug in SearXNG"
+labels: ["bug"]
+type: "bug"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Version of SearXNG, commit number if you are using on master branch and stipulate if you forked SearXNG**
-<!-- If you are running on master branch using git execute this command
-in order to fetch the latest commit ID:
-```
-git log -1
-``` 
-If you are using searxng-docker then look at the bottom of the SearXNG page
-and check for the version after "Powered by SearXNG"
+_Replace this placeholder with a meaningful and precise description of the bug._
 
-Please also stipulate if you are using a forked version of SearXNG and
-include a link to the fork source code.
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
 -->
-**How did you install SearXNG?**
-<!-- Did you install SearXNG using the official wiki or using searxng-docker
-or manually by executing the searx/webapp.py file? -->
-**What happened?**
-<!-- A clear and concise description of what the bug is. -->
 
-**How To Reproduce**
-<!-- How can we reproduce this issue? (as minimally and as precisely as possible) -->
+### How To Reproduce?
+
+<!-- How can we reproduce this issue? (as minimally and as precisely as
+     possible) -->
+
+### Expected behavior
 
-**Expected behavior**
 <!-- A clear and concise description of what you expected to happen. -->
 
-**Screenshots & Logs**
+### Screenshots & Logs
+
 <!-- If applicable, add screenshots, logs to help explain your problem. -->
 
-**Additional context**
+### Version of SearXNG
+
+<!-- Commit number if you are using on master branch and stipulate if you forked
+     SearXNG -->
+
+<!-- Look at the bottom of the SearXNG page and check for the version after
+     "Powered by SearXNG" If you are using a forked version of SearXNG include a
+     link to the fork source code. -->
+
+### How did you install SearXNG?
+
+<!-- Did you install SearXNG using the official documentation or using
+     searxng-docker? -->
+
+### Additional context
+
 <!-- Add any other context about the problem here. -->
+
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/config.yml

@@ -1,4 +1,4 @@
-blank_issues_enabled: true
+blank_issues_enabled: false
 contact_links:
   - name: Questions & Answers (Q&A)
     url: https://github.com/searxng/searxng/discussions/categories/q-a

.github/ISSUE_TEMPLATE/engine-request.md

@@ -1,31 +1,46 @@
 ---
-name: Engine request
-about: Request a new engine in SearXNG
-title: ''
-labels: enhancement, engine request
-assignees: ''
-
+name: Engine request"
+about: Request a new engine in SearXNG"
+labels: ["engine request"]
+type: "feature"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Working URL to the engine**
-<!-- Please check if the engine is responding correctly before submitting it. -->
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
 
-**Why do you want to add this engine?**
-<!-- What's special about this engine? Is it open source or libre? -->
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
 
-**Features of this engine**
-<!-- Features of this engine: Doesn't track its users, fast, easy to integrate, ... -->
+### Working URL to the engine
 
-**How can SearXNG fetch the information from this engine?**
-<!-- List API URL, example code (using the correct markdown) and more
-that could be useful for the developers in order to implement this engine.
-If you don't know what to write, let this part blank. -->
+<!-- Please check if the engine is responding correctly before submitting -->
 
-**Applicable category of this engine**
-<!-- Where should this new engine fit in SearXNG? Current categories in SearXNG:
-general, files, images, it, map, music, news, science, social media and videos.
-You can add multiple categories at the same time. -->
+### Why do you want to add this engine?
 
-**Additional context**
-<!-- Add any other context about this engine here. -->
+<!-- What's special about this engine?  -->
+
+### Features of this engine
+
+<!-- Features of this engine: Serves special content, is fast, is easy to
+     integrate, ... ? -->
+
+### How can SearXNG fetch results from this engine?
+
+<!-- List API URL, example code and more that could be useful for the developers
+     in order to implement this engine.  If you don't know what to write, let
+     this part blank. -->
+
+### Applicable category of this engine
+
+<!-- Where should this new engine fit in SearXNG?  Current categories in
+     SearXNG: general, files, images, it, map, music, news, science, social
+     media and videos. -->
+
+### Additional context
+
+<!-- Add any other context about the problem here. -->
+
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/ISSUE_TEMPLATE/feature-request.md

@@ -1,21 +1,32 @@
 ---
-name: Feature request
-about: Request a new feature in SearXNG
-title: ''
-labels: enhancement
-assignees: ''
-
+name: "Feature request"
+about: "Request a new feature in SearXNG"
+labels: ["new feature"]
+type: "feature"
 ---
-<!-- PLEASE FILL THESE FIELDS, IT REALLY HELPS THE MAINTAINERS OF SearXNG -->
 
-**Is your feature request related to a problem? Please describe.**
-<!-- A clear and concise description of what the problem is. Ex. I'm always frustrated when [...] -->
+_Replace this placeholder with a concise description of the feature._
+
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
+
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
+
+### Is your feature request related to a problem?
+
+<!-- A clear and concise description of what the problem is. Ex. I'm always
+     frustrated when [...] -->
+
+### Describe the solution you'd like
 
-**Describe the solution you'd like**
 <!-- A clear and concise description of what you want to happen. -->
 
-**Describe alternatives you've considered**
+### Describe alternatives you've considered
+
 <!-- A clear and concise description of any alternative solutions or features you've considered. -->
 
-**Additional context**
-<!-- Add any other context or screenshots about the feature request here. -->
+### Code of Conduct
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] I read the [AI Policy] and hereby confirm that this issue conforms with the policy.

.github/workflows/checker.yml

@@ -1,47 +0,0 @@
----
-name: Checker
-
-# yamllint disable-line rule:truthy
-on:
-  workflow_dispatch:
-  schedule:
-    - cron: "0 4 * * 5"
-
-concurrency:
-  group: ${{ github.workflow }}
-  cancel-in-progress: false
-
-permissions:
-  contents: read
-
-env:
-  PYTHON_VERSION: "3.14"
-
-jobs:
-  search:
-    if: github.repository_owner == 'searxng' || github.event_name == 'workflow_dispatch'
-    name: Search
-    runs-on: ubuntu-24.04-arm
-    steps:
-      - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
-        with:
-          python-version: "${{ env.PYTHON_VERSION }}"
-
-      - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
-        with:
-          persist-credentials: "false"
-
-      - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
-        with:
-          key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
-          path: "./local"
-
-      - name: Setup venv
-        run: make V=1 install
-
-      - name: Search checker
-        run: make search.checker

.github/workflows/container.yml

@@ -56,13 +56,8 @@ jobs:
       # yamllint disable rule:line-length
       - name: Setup podman
         env:
-          PODMAN_VERSION: "v5.6.2"
+          PODMAN_VERSION: "v5.7.1"
         run: |
-          # dpkg man-db trigger is very slow on GHA runners
-          # https://github.com/actions/runner-images/issues/10977
-          # https://github.com/actions/runner/issues/4030
-          sudo rm -f /var/lib/man-db/auto-update
-
           sudo apt-get purge -y podman runc crun conmon
 
           curl -fsSLO "https://github.com/mgoltzsche/podman-static/releases/download/${{ env.PODMAN_VERSION }}/podman-linux-${{ matrix.march }}.tar.gz"
@@ -78,21 +73,22 @@ jobs:
       # yamllint enable rule:line-length
 
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Get date
@@ -100,20 +96,20 @@ jobs:
         run: echo "date=$(date +'%Y%m%d')" >>$GITHUB_OUTPUT
 
       - name: Setup cache container
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "container-${{ matrix.arch }}-${{ steps.date.outputs.date }}-${{ hashFiles('./requirements*.txt') }}"
           restore-keys: |
-            "container-${{ matrix.arch }}-${{ steps.date.outputs.date }}-"
-            "container-${{ matrix.arch }}-"
+            container-${{ matrix.arch }}-${{ steps.date.outputs.date }}-
+            container-${{ matrix.arch }}-
           path: "/var/tmp/buildah-cache-*/*"
 
       - if: ${{ matrix.emulation }}
         name: Setup QEMU
-        uses: docker/setup-qemu-action@29109295f81e9208d7d86ff1c6c12d2833863392  # v3.6.0
+        uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
 
       - name: Login to GHCR
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
@@ -145,16 +141,16 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - if: ${{ matrix.emulation }}
         name: Setup QEMU
-        uses: docker/setup-qemu-action@29109295f81e9208d7d86ff1c6c12d2833863392  # v3.6.0
+        uses: docker/setup-qemu-action@ce360397dd3f832beb865e1373c09c0e9f86d70a  # v4.0.0
 
       - name: Login to GHCR
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
@@ -179,23 +175,23 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Login to GHCR
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "ghcr.io"
           username: "${{ github.repository_owner }}"
           password: "${{ secrets.GITHUB_TOKEN }}"
 
       - name: Login to Docker Hub
-        uses: docker/login-action@5e57cd118135c172c3672efd75eb46360885c0ef  # v3.6.0
+        uses: docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121  # v4.1.0
         with:
           registry: "docker.io"
-          username: "${{ secrets.DOCKERHUB_USERNAME }}"
-          password: "${{ secrets.DOCKERHUB_TOKEN }}"
+          username: "${{ secrets.DOCKER_USER }}"
+          password: "${{ secrets.DOCKER_TOKEN }}"
 
       - name: Release
         env:

.github/workflows/data-update.yml

@@ -33,6 +33,7 @@ jobs:
           - update_engine_traits.py
           - update_wikidata_units.py
           - update_engine_descriptions.py
+          - update_gsa_useragents.py
 
     permissions:
       contents: write
@@ -40,20 +41,21 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -64,7 +66,7 @@ jobs:
 
       - name: Create PR
         id: cpr
-        uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e  # v7.0.8
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
         with:
           author: "searxng-bot <searxng-bot@users.noreply.github.com>"
           committer: "searxng-bot <searxng-bot@users.noreply.github.com>"

.github/workflows/documentation.yml

@@ -32,21 +32,22 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -57,7 +58,7 @@ jobs:
 
       - if: github.ref_name == 'master'
         name: Release
-        uses: JamesIves/github-pages-deploy-action@6c2d9db40f9296374acc17b90404b6e8864128c8  # v4.7.3
+        uses: JamesIves/github-pages-deploy-action@d92aa235d04922e8f08b40ce78cc5442fcfbfa2f  # v4.8.0
         with:
           folder: "dist/docs"
           branch: "gh-pages"

.github/workflows/integration.yml

@@ -27,7 +27,6 @@ jobs:
     strategy:
       matrix:
         python-version:
-          - "3.10"
           - "3.11"
           - "3.12"
           - "3.13"
@@ -35,20 +34,21 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ matrix.python-version }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ matrix.python-version }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ matrix.python-version }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ matrix.python-version }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -62,31 +62,32 @@ jobs:
     runs-on: ubuntu-24.04-arm
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Setup Node.js
-        uses: actions/setup-node@2028fbc5c25fe9cf00d9f06a71cc4710d4507903  # v6.0.0
+        uses: actions/setup-node@53b83947a5a98c8d113130e565377fae1a50d02f  # v6.3.0
         with:
           node-version-file: "./.nvmrc"
 
       - name: Setup cache Node.js
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "nodejs-${{ runner.arch }}-${{ hashFiles('./.nvmrc', './package.json') }}"
           path: "./client/simple/node_modules/"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv

.github/workflows/l10n.yml

@@ -35,21 +35,22 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -82,21 +83,22 @@ jobs:
 
     steps:
       - name: Setup Python
-        uses: actions/setup-python@e797f83bcb11b83ae66e0230d6156d7c80228e7c  # v6.0.0
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405  # v6.2.0
         with:
           python-version: "${{ env.PYTHON_VERSION }}"
 
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           token: "${{ secrets.WEBLATE_GITHUB_TOKEN }}"
           fetch-depth: "0"
 
       - name: Setup cache Python
-        uses: actions/cache@0057852bfaa89a56745cba8c7296529d2fc39830  # v4.3.0
+        uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae  # v5.0.5
         with:
           key: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-${{ hashFiles('./requirements*.txt') }}"
-          restore-keys: "python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-"
+          restore-keys: |
+            python-${{ env.PYTHON_VERSION }}-${{ runner.arch }}-
           path: "./local/"
 
       - name: Setup venv
@@ -117,7 +119,7 @@ jobs:
 
       - name: Create PR
         id: cpr
-        uses: peter-evans/create-pull-request@271a8d0340265f705b14b6d32b9829c1cb33d45e  # v7.0.8
+        uses: peter-evans/create-pull-request@5f6978faf089d4d20b00c7766989d076bb2fc7f1  # v8.1.1
         with:
           author: "searxng-bot <searxng-bot@users.noreply.github.com>"
           committer: "searxng-bot <searxng-bot@users.noreply.github.com>"
@@ -130,7 +132,7 @@ jobs:
           body: |
             [l10n] update translations from Weblate
           labels: |
-            translation
+            area:i18n
 
       - name: Display information
         run: |

.github/workflows/security.yml

@@ -24,16 +24,16 @@ jobs:
 
     steps:
       - name: Checkout
-        uses: actions/checkout@08c6903cd8c0fde910a37f88322edcfb5dd907a8  # v5.0.0
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd  # v6.0.2
         with:
           persist-credentials: "false"
 
       - name: Sync GHCS from Docker Scout
-        uses: docker/scout-action@f8c776824083494ab0d56b8105ba2ca85c86e4de  # v1.18.2
+        uses: docker/scout-action@bacf462e8d090c09660de30a6ccc718035f961e3  # v1.20.4
         with:
           organization: "searxng"
-          dockerhub-user: "${{ secrets.DOCKERHUB_USERNAME }}"
-          dockerhub-password: "${{ secrets.DOCKERHUB_TOKEN }}"
+          dockerhub-user: "${{ secrets.DOCKER_USER }}"
+          dockerhub-password: "${{ secrets.DOCKER_TOKEN }}"
           image: "registry://ghcr.io/searxng/searxng:latest"
           command: "cves"
           sarif-file: "./scout.sarif"
@@ -41,6 +41,6 @@ jobs:
           write-comment: "false"
 
       - name: Upload SARIFs
-        uses: github/codeql-action/upload-sarif@16140ae1a102900babc80a33c44059580f687047  # v4.30.9
+        uses: github/codeql-action/upload-sarif@95e58e9a2cdfd71adc6e0353d5c52f41a045d225  # v4.35.2
         with:
           sarif_file: "./scout.sarif"

.nvmrc

@@ -1 +1 @@
-24
+25

AI_POLICY.rst

@@ -0,0 +1,20 @@
+.. SPDX-License-Identifier: AGPL-3.0-or-later
+
+AI Policy
+=========
+
+Restrictions on Generative AI Usage
+-----------------------------------
+- **All AI usage in any form must be disclosed.** You must state the tool you used (e.g. Claude Code, Cursor, Amp) along with the extent that the work was AI-assisted.
+- **The human-in-the-loop must fully understand all code.** If you use generative AI tools as an aid in developing code or documentation changes, ensure that you fully understand the proposed changes and can explain why they are the correct approach.
+- **AI should never be the main author of the PR.** AI may be used as a tool to help with developing, but the human contribution to the code changes should always be reasonably larger than the part written by AI. For example, you should be the one that decides about the structure of the PR, not the LLM.
+- **Issues and PR descriptions must be fully human-written.** Do not post output from Large Language Models or similar generative AI as comments on any of our discussion forums (e.g. GitHub Issues, Matrix, ...), as such comments tend to be formulaic and low content. If you're a not a native English speaker, using AI for translating self-written issue texts to English is okay, but please keep the wording as close as possible to the original wording.
+- **Bad AI drivers will be denounced.** People who produce bad contributions that are clearly AI (slop) will be blocked for all future contributions.
+
+There are Humans Here
+---------------------
+Every discussion, issue, and pull request is read and reviewed by humans. It is a boundary point at which people interact with each other and the work done. It is rude and disrespectful to approach this boundary with low-effort, unqualified work, since it puts the burden of validation on the maintainer.
+
+It takes a lot of maintainer time and energy to review AI-generated contributions! Sending the output of an LLM to open source project maintainers extracts work from them in the form of design and code review, so we call this kind of contribution an "extractive contribution".
+
+The *golden rule* is that a contribution should be worth more to the project than the time it takes to review it, which is usually not the case if large parts of your PR were written by LLMs.

CONTRIBUTING.rst

@@ -2,6 +2,7 @@
 
 .. _Quickstart guide: https://docs.searxng.org/dev/quickstart.html
 .. _Commits guide: https://docs.searxng.org/dev/commits.html
+.. _AI Policy: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
 .. _Weblate: https://translate.codeberg.org/projects/searxng/searxng/
 .. _GitHub Codespaces: https://docs.github.com/en/codespaces/overview
 .. _120 hours per month: https://github.com/settings/billing
@@ -90,3 +91,8 @@ rules in this project are:
 - Prefer fewer arguments.
 - Do not add obvious comments to code.
 - Do not comment out code, delete lines instead.
+
+AI Policy
+~~~~~~~~~
+
+For our policy on the use of AI tools, please read `AI Policy`_.

Makefile

@@ -17,7 +17,6 @@ help:
 	@echo 'install        - developer install of SearxNG into virtualenv'
 	@echo 'uninstall      - uninstall developer installation'
 	@echo 'clean          - clean up working tree'
-	@echo 'search.checker - check search engines'
 	@echo 'test           - run shell & CI tests'
 	@echo 'test.shell     - test shell scripts'
 	@echo 'ci.test        - run CI tests'
@@ -39,12 +38,6 @@ clean: py.clean docs.clean node.clean nvm.clean go.clean test.clean
 	$(Q)find . -name '*~' -exec rm -f {} +
 	$(Q)find . -name '*.bak' -exec rm -f {} +
 
-PHONY += search.checker search.checker.%
-search.checker: install
-	$(Q)./manage pyenv.cmd searxng-checker -v
-
-search.checker.%: install
-	$(Q)./manage pyenv.cmd searxng-checker -v "$(subst _, ,$(patsubst search.checker.%,%,$@))"
 
 PHONY += test ci.test test.shell
 test:    test.yamllint test.black test.pyright_modified test.pylint test.unit test.robot test.rst test.shell test.shfmt
@@ -70,7 +63,7 @@ format: format.python format.shell
 # wrap ./manage script
 
 MANAGE += weblate.translations.commit weblate.push.translations
-MANAGE += data.all data.traits data.useragents data.locales data.currencies
+MANAGE += data.all data.traits data.useragents data.gsa_useragents data.locales data.currencies
 MANAGE += docs.html docs.live docs.gh-pages docs.prebuild docs.clean
 MANAGE += podman.build
 MANAGE += docker.build docker.buildx

PULL_REQUEST_TEMPLATE.md

@@ -1,25 +1,34 @@
-## What does this PR do?
+<!-- FILL IN THESE FIELDS .. and delete the comments after reading.
 
-<!-- MANDATORY -->
+     Use Markdown for formatting ->  https://www.markdowntools.io/cheat-sheet
+-->
 
-<!-- explain the changes in your PR, algorithms, design, architecture -->
+### What does this PR do?
 
-## Why is this change important?
+<!-- Explain the motivation and changes in your pull request.  -->
 
-<!-- MANDATORY -->
+### How to test this PR locally?
 
-<!-- explain the motivation behind your PR -->
+<!-- Commands to run the tests or instructions to test the changes.  Are there
+     any edge cases (environment, language, or other contexts) to take into
+     account?  -->
 
-## How to test this PR locally?
-
-<!-- commands to run the tests or instructions to test the changes -->
-
-## Author's checklist
-
-<!-- additional notes for reviewers -->
-
-## Related issues
+### Related issues
 
 <!--
-Closes #234
+Closes: #234
 -->
+
+### Code of Conduct
+
+<!-- ⚠️ Bad AI drivers will be denounced: People who produce bad contributions
+     that are clearly AI (slop) will be blocked for all future contributions.
+     -->
+
+[AI Policy]: https://github.com/searxng/searxng/blob/master/AI_POLICY.rst
+
+- [ ] **I hereby confirm that this PR conforms with the [AI Policy].**
+
+  If I have used AI tools for working on the changes in this PR, I will
+  attach a list of all AI tools I used and how I used them. I hereby confirm
+  that I haven't used any other tools than the ones I mention below.

README.rst

@@ -46,11 +46,9 @@ Further information on *how-to* can be found `here <https://docs.searxng.org/adm
 Connect
 =======
 
-If you have questions or want to connect with others in the community,
-we have two official channels:
+If you have questions or want to connect with others in the community:
 
 - `#searxng:matrix.org <https://matrix.to/#/#searxng:matrix.org>`_
-- `#searxng @ libera.chat <https://web.libera.chat/?channel=#searxng>`_ (bridged to Matrix)
 
 Contributing
 ============

client/simple/.stylelintrc.json

@@ -4,7 +4,9 @@
   "extends": ["stylelint-config-standard-less"],
   "rules": {
     "at-rule-no-vendor-prefix": null,
+    "at-rule-prelude-no-invalid": null,
     "declaration-empty-line-before": null,
+    "declaration-property-value-no-unknown": null,
     "no-invalid-position-at-import-rule": null,
     "prettier/prettier": true,
     "property-no-vendor-prefix": null,

client/simple/biome.json

@@ -1,8 +1,8 @@
 {
-  "$schema": "https://biomejs.dev/schemas/2.2.7/schema.json",
+  "$schema": "./node_modules/@biomejs/biome/configuration_schema.json",
   "files": {
     "ignoreUnknown": true,
-    "includes": ["**", "!dist", "!node_modules"]
+    "includes": ["**", "!node_modules"]
   },
   "assist": {
     "enabled": true,
@@ -15,9 +15,9 @@
     }
   },
   "formatter": {
+    "enabled": true,
     "bracketSameLine": false,
     "bracketSpacing": true,
-    "enabled": true,
     "formatWithErrors": false,
     "indentStyle": "space",
     "indentWidth": 2,
@@ -31,28 +31,37 @@
       "complexity": {
         "noForEach": "error",
         "noImplicitCoercions": "error",
+        "noUselessCatchBinding": "error",
+        "noUselessUndefined": "error",
         "useSimplifiedLogicExpression": "error"
       },
       "correctness": {
         "noGlobalDirnameFilename": "error",
-        "noUndeclaredVariables": {
-          "level": "error",
-          "options": {
-            "checkTypes": true
-          }
-        },
         "useImportExtensions": "error",
         "useJsonImportAttributes": "error",
         "useSingleJsDocAsterisk": "error"
       },
       "nursery": {
-        "noDeprecatedImports": "warn",
-        "noImportCycles": "warn",
+        "noContinue": "warn",
+        "noEqualsToNull": "warn",
+        "noFloatingPromises": "warn",
+        "noForIn": "warn",
+        "noIncrementDecrement": "warn",
         "noMisusedPromises": "warn",
-        "noUselessCatchBinding": "warn",
-        "noUselessUndefined": "warn",
+        "noMultiAssign": "warn",
+        "noMultiStr": "warn",
+        "noNestedPromises": "warn",
+        "noParametersOnlyUsedInRecursion": "warn",
+        "noRedundantDefaultExport": "warn",
+        "noReturnAssign": "warn",
+        "noUselessReturn": "off",
+        "useAwaitThenable": "off",
+        "useConsistentEnumValueType": "warn",
+        "useDestructuring": "warn",
         "useExhaustiveSwitchCases": "warn",
-        "useExplicitType": "warn"
+        "useExplicitType": "off",
+        "useFind": "warn",
+        "useRegexpExec": "warn"
       },
       "performance": {
         "noAwaitInLoops": "error",
@@ -65,6 +74,7 @@
       "style": {
         "noCommonJs": "error",
         "noEnum": "error",
+        "noImplicitBoolean": "error",
         "noInferrableTypes": "error",
         "noNamespace": "error",
         "noNegationElse": "error",
@@ -109,6 +119,12 @@
             "syntax": "explicit"
           }
         },
+        "useConsistentTypeDefinitions": {
+          "level": "error",
+          "options": {
+            "style": "type"
+          }
+        },
         "useDefaultSwitchClause": "error",
         "useExplicitLengthCheck": "error",
         "useForOf": "error",
@@ -117,6 +133,7 @@
         "useNumericSeparators": "error",
         "useObjectSpread": "error",
         "useReadonlyClassProperties": "error",
+        "useSelfClosingElements": "error",
         "useShorthandAssign": "error",
         "useSingleVarDeclarator": "error",
         "useThrowNewError": "error",
@@ -128,8 +145,10 @@
         "noAlert": "error",
         "noBitwiseOperators": "error",
         "noConstantBinaryExpressions": "error",
+        "noDeprecatedImports": "error",
         "noEmptyBlockStatements": "error",
         "noEvolvingTypes": "error",
+        "noImportCycles": "error",
         "noUnassignedVariables": "error",
         "noVar": "error",
         "useNumberToFixedDigitsArgument": "error",

client/simple/generated/pygments.less

@@ -2,7 +2,7 @@
 
 /*
    this file is generated automatically by searxng_extra/update/update_pygments.py
-   using pygments version 2.19.2:
+   using pygments version 2.20.0:
 
        ./manage templates.simple.pygments
 */

client/simple/package.json

@@ -19,33 +19,31 @@
     "lint:tsc": "tsc --noEmit"
   },
   "browserslist": [
-    "Chrome >= 93",
-    "Firefox >= 92",
-    "Safari >= 15.4",
+    "baseline 2022",
     "not dead"
   ],
   "dependencies": {
-    "ionicons": "~8.0.13",
+    "ionicons": "^8.0.13",
     "normalize.css": "8.0.1",
-    "ol": "~10.6.1",
+    "ol": "^10.9.0",
     "swiped-events": "1.2.0"
   },
   "devDependencies": {
-    "@biomejs/biome": "2.2.7",
-    "@types/node": "~24.9.1",
-    "browserslist": "~4.27.0",
-    "browserslist-to-esbuild": "~2.1.1",
-    "edge.js": "~6.3.0",
-    "less": "~4.4.2",
-    "lightningcss": "~1.30.2",
-    "sharp": "~0.34.4",
-    "sort-package-json": "~3.4.0",
-    "stylelint": "~16.25.0",
-    "stylelint-config-standard-less": "~3.0.1",
-    "stylelint-prettier": "~5.0.3",
-    "svgo": "~4.0.0",
-    "typescript": "~5.9.3",
-    "vite": "npm:rolldown-vite@7.1.19",
-    "vite-bundle-analyzer": "~1.2.3"
+    "@biomejs/biome": "2.4.12",
+    "@types/node": "^25.6.0",
+    "browserslist": "^4.28.2",
+    "browserslist-to-esbuild": "^2.1.1",
+    "edge.js": "^6.5.0",
+    "less": "^4.6.4",
+    "mathjs": "^15.2.0",
+    "sharp": "~0.34.5",
+    "sort-package-json": "^3.6.1",
+    "stylelint": "^17.8.0",
+    "stylelint-config-standard-less": "^4.1.0",
+    "stylelint-prettier": "^5.0.3",
+    "svgo": "^4.0.1",
+    "typescript": "~6.0.3",
+    "vite": "^8.0.8",
+    "vite-bundle-analyzer": "^1.3.7"
   }
 }

client/simple/src/js/Plugin.ts

@@ -0,0 +1,66 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+/**
+ * Base class for client-side plugins.
+ *
+ * @remarks
+ * Handle conditional loading of the plugin in:
+ *
+ *   - client/simple/src/js/router.ts
+ *
+ * @abstract
+ */
+export abstract class Plugin {
+  /**
+   * Plugin name.
+   */
+  protected readonly id: string;
+
+  /**
+   * @remarks
+   * Don't hold references of this instance outside the class.
+   */
+  protected constructor(id: string) {
+    this.id = id;
+
+    queueMicrotask(() => this.invoke());
+  }
+
+  private async invoke(): Promise<void> {
+    try {
+      console.debug(`[PLUGIN] ${this.id}: Running...`);
+      const result = await this.run();
+      if (!result) return;
+
+      console.debug(`[PLUGIN] ${this.id}: Running post-exec...`);
+      // @ts-expect-error
+      void (await this.post(result as NonNullable<Awaited<ReturnType<this["run"]>>>));
+    } catch (error) {
+      console.error(`[PLUGIN] ${this.id}:`, error);
+    } finally {
+      console.debug(`[PLUGIN] ${this.id}: Done.`);
+    }
+  }
+
+  /**
+   * Plugin goes here.
+   *
+   * @remarks
+   * The plugin is already loaded at this point. If you wish to execute
+   * conditions to exit early, consider moving the logic to:
+   *
+   *   - client/simple/src/js/router.ts
+   *
+   * ...to avoid unnecessarily loading this plugin on the client.
+   */
+  protected abstract run(): Promise<unknown>;
+
+  /**
+   * Post-execution hook.
+   *
+   * @remarks
+   * The hook is only executed if `#run()` returns a truthy value.
+   */
+  // @ts-expect-error
+  protected abstract post(result: NonNullable<Awaited<ReturnType<this["run"]>>>): Promise<void>;
+}

client/simple/src/js/core/index.ts

@@ -1,6 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import "./nojs.ts";
-import "./router.ts";
-import "./toolkit.ts";
-import "./listener.ts";

client/simple/src/js/core/listener.ts

@@ -1,7 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { listen } from "./toolkit.ts";
-
-listen("click", ".close", function (this: HTMLElement) {
-  (this.parentNode as HTMLElement)?.classList.add("invisible");
-});

client/simple/src/js/core/nojs.ts

@@ -1,8 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { ready } from "./toolkit.ts";
-
-ready(() => {
-  document.documentElement.classList.remove("no-js");
-  document.documentElement.classList.add("js");
-});

client/simple/src/js/core/router.ts

@@ -1,40 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { Endpoints, endpoint, ready, settings } from "./toolkit.ts";
-
-ready(
-  () => {
-    import("../main/keyboard.ts");
-    import("../main/search.ts");
-
-    if (settings.autocomplete) {
-      import("../main/autocomplete.ts");
-    }
-  },
-  { on: [endpoint === Endpoints.index] }
-);
-
-ready(
-  () => {
-    import("../main/keyboard.ts");
-    import("../main/mapresult.ts");
-    import("../main/results.ts");
-    import("../main/search.ts");
-
-    if (settings.infinite_scroll) {
-      import("../main/infinite_scroll.ts");
-    }
-
-    if (settings.autocomplete) {
-      import("../main/autocomplete.ts");
-    }
-  },
-  { on: [endpoint === Endpoints.results] }
-);
-
-ready(
-  () => {
-    import("../main/preferences.ts");
-  },
-  { on: [endpoint === Endpoints.preferences] }
-);

client/simple/src/js/index.ts

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+// core
+void import.meta.glob(["./*.ts", "./util/**/.ts"], { eager: true });

client/simple/src/js/loader.ts

@@ -0,0 +1,36 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import type { Plugin } from "./Plugin.ts";
+import { type EndpointsKeys, endpoint } from "./toolkit.ts";
+
+type Options =
+  | {
+      on: "global";
+    }
+  | {
+      on: "endpoint";
+      where: EndpointsKeys[];
+    };
+
+export const load = <T extends Plugin>(instance: () => Promise<T>, options: Options): void => {
+  if (!check(options)) return;
+
+  void instance();
+};
+
+const check = (options: Options): boolean => {
+  // biome-ignore lint/style/useDefaultSwitchClause: options is typed
+  switch (options.on) {
+    case "global": {
+      return true;
+    }
+    case "endpoint": {
+      if (!options.where.includes(endpoint)) {
+        // not on the expected endpoint
+        return false;
+      }
+
+      return true;
+    }
+  }
+};

client/simple/src/js/main/autocomplete.ts

@@ -1,6 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import { assertElement, http, listen, settings } from "../core/toolkit.ts";
+import { http, listen, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
 
 const fetchResults = async (qInput: HTMLInputElement, query: string): Promise<void> => {
   try {
@@ -43,8 +44,6 @@ const fetchResults = async (qInput: HTMLInputElement, query: string): Promise<vo
 
         const form = document.querySelector<HTMLFormElement>("#search");
         form?.submit();
-
-        autocomplete.classList.remove("open");
       });
 
       fragment.append(li);
@@ -79,6 +78,11 @@ listen("input", qInput, () => {
 const autocomplete: HTMLElement | null = document.querySelector<HTMLElement>(".autocomplete");
 const autocompleteList: HTMLUListElement | null = document.querySelector<HTMLUListElement>(".autocomplete ul");
 if (autocompleteList) {
+  listen("keydown", qInput, (event: KeyboardEvent) => {
+    if (event.key === "Escape") {
+      autocomplete?.classList.remove("open");
+    }
+  });
   listen("keyup", qInput, (event: KeyboardEvent) => {
     const listItems = [...autocompleteList.children] as HTMLElement[];
 
@@ -104,7 +108,6 @@ if (autocompleteList) {
         newCurrentIndex = (currentIndex + 1) % listItems.length;
         break;
       }
-      case "Tab":
       case "Enter":
         if (autocomplete) {
           autocomplete.classList.remove("open");
@@ -128,4 +131,12 @@ if (autocompleteList) {
       }
     }
   });
+
+  listen("blur", qInput, () => {
+    autocomplete?.classList.remove("open");
+  });
+
+  listen("focus", qInput, () => {
+    autocomplete?.classList.add("open");
+  });
 }

client/simple/src/js/main/infinite_scroll.ts

@@ -1,100 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { assertElement, http, settings } from "../core/toolkit.ts";
-
-const newLoadSpinner = (): HTMLDivElement => {
-  return Object.assign(document.createElement("div"), {
-    className: "loader"
-  });
-};
-
-const loadNextPage = async (onlyImages: boolean, callback: () => void): Promise<void> => {
-  const searchForm = document.querySelector<HTMLFormElement>("#search");
-  assertElement(searchForm);
-
-  const form = document.querySelector<HTMLFormElement>("#pagination form.next_page");
-  assertElement(form);
-
-  const action = searchForm.getAttribute("action");
-  if (!action) {
-    throw new Error("Form action not defined");
-  }
-
-  const paginationElement = document.querySelector<HTMLElement>("#pagination");
-  assertElement(paginationElement);
-
-  paginationElement.replaceChildren(newLoadSpinner());
-
-  try {
-    const res = await http("POST", action, { body: new FormData(form) });
-    const nextPage = await res.text();
-    if (!nextPage) return;
-
-    const nextPageDoc = new DOMParser().parseFromString(nextPage, "text/html");
-    const articleList = nextPageDoc.querySelectorAll<HTMLElement>("#urls article");
-    const nextPaginationElement = nextPageDoc.querySelector<HTMLElement>("#pagination");
-
-    document.querySelector("#pagination")?.remove();
-
-    const urlsElement = document.querySelector<HTMLElement>("#urls");
-    if (!urlsElement) {
-      throw new Error("URLs element not found");
-    }
-
-    if (articleList.length > 0 && !onlyImages) {
-      // do not add <hr> element when there are only images
-      urlsElement.appendChild(document.createElement("hr"));
-    }
-
-    urlsElement.append(...Array.from(articleList));
-
-    if (nextPaginationElement) {
-      const results = document.querySelector<HTMLElement>("#results");
-      results?.appendChild(nextPaginationElement);
-      callback();
-    }
-  } catch (error) {
-    console.error("Error loading next page:", error);
-
-    const errorElement = Object.assign(document.createElement("div"), {
-      textContent: settings.translations?.error_loading_next_page ?? "Error loading next page",
-      className: "dialog-error"
-    });
-    errorElement.setAttribute("role", "alert");
-    document.querySelector("#pagination")?.replaceChildren(errorElement);
-  }
-};
-
-const resultsElement: HTMLElement | null = document.getElementById("results");
-if (!resultsElement) {
-  throw new Error("Results element not found");
-}
-
-const onlyImages: boolean = resultsElement.classList.contains("only_template_images");
-const observedSelector = "article.result:last-child";
-
-const intersectionObserveOptions: IntersectionObserverInit = {
-  rootMargin: "320px"
-};
-
-const observer: IntersectionObserver = new IntersectionObserver((entries: IntersectionObserverEntry[]) => {
-  const [paginationEntry] = entries;
-
-  if (paginationEntry?.isIntersecting) {
-    observer.unobserve(paginationEntry.target);
-
-    loadNextPage(onlyImages, () => {
-      const nextObservedElement = document.querySelector<HTMLElement>(observedSelector);
-      if (nextObservedElement) {
-        observer.observe(nextObservedElement);
-      }
-    }).then(() => {
-      // wait until promise is resolved
-    });
-  }
-}, intersectionObserveOptions);
-
-const initialObservedElement: HTMLElement | null = document.querySelector<HTMLElement>(observedSelector);
-if (initialObservedElement) {
-  observer.observe(initialObservedElement);
-}

client/simple/src/js/main/keyboard.ts

@@ -1,6 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import { assertElement, listen, mutable, settings } from "../core/toolkit.ts";
+import { listen, mutable, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
 
 export type KeyBindingLayout = "default" | "vim";
 
@@ -189,9 +190,7 @@ const highlightResult =
 
     let next: HTMLElement | undefined;
 
-    if (typeof effectiveWhich !== "string") {
-      next = effectiveWhich;
-    } else {
+    if (typeof effectiveWhich === "string") {
       switch (effectiveWhich) {
         case "visible": {
           const top = document.documentElement.scrollTop || document.body.scrollTop;
@@ -219,8 +218,10 @@ const highlightResult =
         // biome-ignore lint/complexity/noUselessSwitchCase: fallthrough is intended
         case "top":
         default:
-          next = results[0];
+          [next] = results;
       }
+    } else {
+      next = effectiveWhich;
     }
 
     if (next) {
@@ -342,7 +343,7 @@ const initHelpContent = (divElement: HTMLElement, keyBindings: typeof baseKeyBin
   const categories: Record<string, KeyBinding[]> = {};
 
   for (const binding of Object.values(keyBindings)) {
-    const cat = binding.cat;
+    const { cat } = binding;
     categories[cat] ??= [];
     categories[cat].push(binding);
   }
@@ -399,7 +400,7 @@ const toggleHelp = (keyBindings: typeof baseKeyBinding): void => {
       className: "dialog-modal"
     });
     initHelpContent(helpPanel, keyBindings);
-    const body = document.getElementsByTagName("body")[0];
+    const [body] = document.getElementsByTagName("body");
     if (body) {
       body.appendChild(helpPanel);
     }

client/simple/src/js/main/mapresult.ts

@@ -1,86 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { listen } from "../core/toolkit.ts";
-
-listen("click", ".searxng_init_map", async function (this: HTMLElement, event: Event) {
-  event.preventDefault();
-  this.classList.remove("searxng_init_map");
-
-  const {
-    View,
-    OlMap,
-    TileLayer,
-    VectorLayer,
-    OSM,
-    VectorSource,
-    Style,
-    Stroke,
-    Fill,
-    Circle,
-    fromLonLat,
-    GeoJSON,
-    Feature,
-    Point
-  } = await import("../pkg/ol.ts");
-  import("ol/ol.css");
-
-  const { leafletTarget: target, mapLon, mapLat, mapGeojson } = this.dataset;
-
-  const lon = Number.parseFloat(mapLon || "0");
-  const lat = Number.parseFloat(mapLat || "0");
-  const view = new View({ maxZoom: 16, enableRotation: false });
-  const map = new OlMap({
-    target: target,
-    layers: [new TileLayer({ source: new OSM({ maxZoom: 16 }) })],
-    view: view
-  });
-
-  try {
-    const markerSource = new VectorSource({
-      features: [
-        new Feature({
-          geometry: new Point(fromLonLat([lon, lat]))
-        })
-      ]
-    });
-
-    const markerLayer = new VectorLayer({
-      source: markerSource,
-      style: new Style({
-        image: new Circle({
-          radius: 6,
-          fill: new Fill({ color: "#3050ff" })
-        })
-      })
-    });
-
-    map.addLayer(markerLayer);
-  } catch (error) {
-    console.error("Failed to create marker layer:", error);
-  }
-
-  if (mapGeojson) {
-    try {
-      const geoSource = new VectorSource({
-        features: new GeoJSON().readFeatures(JSON.parse(mapGeojson), {
-          dataProjection: "EPSG:4326",
-          featureProjection: "EPSG:3857"
-        })
-      });
-
-      const geoLayer = new VectorLayer({
-        source: geoSource,
-        style: new Style({
-          stroke: new Stroke({ color: "#3050ff", width: 2 }),
-          fill: new Fill({ color: "#3050ff33" })
-        })
-      });
-
-      map.addLayer(geoLayer);
-
-      view.fit(geoSource.getExtent(), { padding: [20, 20, 20, 20] });
-    } catch (error) {
-      console.error("Failed to create GeoJSON layer:", error);
-    }
-  }
-});

client/simple/src/js/main/preferences.ts

@@ -1,6 +1,7 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import { assertElement, http, listen, settings } from "../core/toolkit.ts";
+import { http, listen, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
 
 let engineDescriptions: Record<string, [string, string]> | undefined;
 
@@ -69,8 +70,7 @@ listen("click", "#copy-hash", async function (this: HTMLElement) {
     }
   }
 
-  const copiedText = this.dataset.copiedText;
-  if (copiedText) {
-    this.innerText = copiedText;
+  if (this.dataset.copiedText) {
+    this.innerText = this.dataset.copiedText;
   }
 });

client/simple/src/js/main/results.ts

@@ -1,7 +1,8 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
 import "../../../node_modules/swiped-events/src/swiped-events.js";
-import { assertElement, listen, mutable, settings } from "../core/toolkit.ts";
+import { listen, mutable, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
 
 let imgTimeoutID: number;
 
@@ -134,9 +135,8 @@ listen("click", "#copy_url", async function (this: HTMLElement) {
     }
   }
 
-  const copiedText = this.dataset.copiedText;
-  if (copiedText) {
-    this.innerText = copiedText;
+  if (this.dataset.copiedText) {
+    this.innerText = this.dataset.copiedText;
   }
 });
 

client/simple/src/js/main/search.ts

@@ -1,88 +1,51 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import { assertElement, listen, settings } from "../core/toolkit.ts";
+import { listen } from "../toolkit.ts";
+import { getElement } from "../util/getElement.ts";
 
-const submitIfQuery = (qInput: HTMLInputElement): void => {
-  if (qInput.value.length > 0) {
-    const search = document.getElementById("search") as HTMLFormElement | null;
-    search?.submit();
-  }
-};
-
-const updateClearButton = (qInput: HTMLInputElement, cs: HTMLElement): void => {
-  cs.classList.toggle("empty", qInput.value.length === 0);
-};
-
-const createClearButton = (qInput: HTMLInputElement): void => {
-  const cs = document.getElementById("clear_search");
-  assertElement(cs);
-
-  updateClearButton(qInput, cs);
-
-  listen("click", cs, (event: MouseEvent) => {
-    event.preventDefault();
-    qInput.value = "";
-    qInput.focus();
-    updateClearButton(qInput, cs);
-  });
-
-  listen("input", qInput, () => updateClearButton(qInput, cs), { passive: true });
-};
-
-const qInput = document.getElementById("q") as HTMLInputElement | null;
-assertElement(qInput);
+const searchForm: HTMLFormElement = getElement<HTMLFormElement>("search");
+const searchInput: HTMLInputElement = getElement<HTMLInputElement>("q");
+const searchReset: HTMLButtonElement = getElement<HTMLButtonElement>("clear_search");
 
 const isMobile: boolean = window.matchMedia("(max-width: 50em)").matches;
 const isResultsPage: boolean = document.querySelector("main")?.id === "main_results";
 
+const categoryButtons: HTMLButtonElement[] = Array.from(
+  document.querySelectorAll<HTMLButtonElement>("#categories_container button.category")
+);
+
+if (searchInput.value.length === 0) {
+  searchReset.classList.add("empty");
+}
+
 // focus search input on large screens
 if (!(isMobile || isResultsPage)) {
-  qInput.focus();
+  searchInput.focus();
 }
 
 // On mobile, move cursor to the end of the input on focus
 if (isMobile) {
-  listen("focus", qInput, () => {
+  listen("focus", searchInput, () => {
     // Defer cursor move until the next frame to prevent a visual jump
     requestAnimationFrame(() => {
-      const end = qInput.value.length;
-      qInput.setSelectionRange(end, end);
-      qInput.scrollLeft = qInput.scrollWidth;
+      const end = searchInput.value.length;
+      searchInput.setSelectionRange(end, end);
+      searchInput.scrollLeft = searchInput.scrollWidth;
     });
   });
 }
 
-createClearButton(qInput);
+listen("input", searchInput, () => {
+  searchReset.classList.toggle("empty", searchInput.value.length === 0);
+});
 
-// Additionally to searching when selecting a new category, we also
-// automatically start a new search request when the user changes a search
-// filter (safesearch, time range or language) (this requires JavaScript
-// though)
-if (
-  settings.search_on_category_select &&
-  // If .search_filters is undefined (invisible) we are on the homepage and
-  // hence don't have to set any listeners
-  document.querySelector(".search_filters")
-) {
-  const safesearchElement = document.getElementById("safesearch");
-  if (safesearchElement) {
-    listen("change", safesearchElement, () => submitIfQuery(qInput));
-  }
+listen("click", searchReset, (event: MouseEvent) => {
+  event.preventDefault();
+  searchInput.value = "";
+  searchInput.focus();
+  searchReset.classList.add("empty");
+});
 
-  const timeRangeElement = document.getElementById("time_range");
-  if (timeRangeElement) {
-    listen("change", timeRangeElement, () => submitIfQuery(qInput));
-  }
-
-  const languageElement = document.getElementById("language");
-  if (languageElement) {
-    listen("change", languageElement, () => submitIfQuery(qInput));
-  }
-}
-
-const categoryButtons: HTMLButtonElement[] = [
-  ...document.querySelectorAll<HTMLButtonElement>("button.category_button")
-];
 for (const button of categoryButtons) {
   listen("click", button, (event: MouseEvent) => {
     if (event.shiftKey) {
@@ -98,21 +61,34 @@ for (const button of categoryButtons) {
   });
 }
 
-const form: HTMLFormElement | null = document.querySelector<HTMLFormElement>("#search");
-assertElement(form);
-
-// override form submit action to update the actually selected categories
-listen("submit", form, (event: Event) => {
-  event.preventDefault();
-
-  const categoryValuesInput = document.querySelector<HTMLInputElement>("#selected-categories");
-  if (categoryValuesInput) {
-    const categoryValues = categoryButtons
-      .filter((button) => button.classList.contains("selected"))
-      .map((button) => button.name.replace("category_", ""));
-
-    categoryValuesInput.value = categoryValues.join(",");
+if (document.querySelector("div.search_filters")) {
+  const safesearchElement = document.getElementById("safesearch");
+  if (safesearchElement) {
+    listen("change", safesearchElement, () => searchForm.submit());
   }
 
-  form.submit();
+  const timeRangeElement = document.getElementById("time_range");
+  if (timeRangeElement) {
+    listen("change", timeRangeElement, () => searchForm.submit());
+  }
+
+  const languageElement = document.getElementById("language");
+  if (languageElement) {
+    listen("change", languageElement, () => searchForm.submit());
+  }
+}
+
+// override searchForm submit event
+listen("submit", searchForm, (event: Event) => {
+  event.preventDefault();
+
+  if (categoryButtons.length > 0) {
+    const searchCategories = getElement<HTMLInputElement>("selected-categories");
+    searchCategories.value = categoryButtons
+      .filter((button) => button.classList.contains("selected"))
+      .map((button) => button.name.replace("category_", ""))
+      .join(",");
+  }
+
+  searchForm.submit();
 });

client/simple/src/js/pkg/ol.ts

@@ -1,28 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-import { Feature, Map as OlMap, View } from "ol";
-import { createEmpty } from "ol/extent";
-import { GeoJSON } from "ol/format";
-import { Point } from "ol/geom";
-import { Tile as TileLayer, Vector as VectorLayer } from "ol/layer";
-import { fromLonLat } from "ol/proj";
-import { OSM, Vector as VectorSource } from "ol/source";
-import { Circle, Fill, Stroke, Style } from "ol/style";
-
-export {
-  View,
-  OlMap,
-  TileLayer,
-  VectorLayer,
-  OSM,
-  createEmpty,
-  VectorSource,
-  Style,
-  Stroke,
-  Fill,
-  Circle,
-  fromLonLat,
-  GeoJSON,
-  Feature,
-  Point
-};

client/simple/src/js/plugin/Calculator.ts

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import {
+  absDependencies,
+  addDependencies,
+  create,
+  divideDependencies,
+  eDependencies,
+  evaluateDependencies,
+  expDependencies,
+  factorialDependencies,
+  gcdDependencies,
+  lcmDependencies,
+  log1pDependencies,
+  log2Dependencies,
+  log10Dependencies,
+  logDependencies,
+  modDependencies,
+  multiplyDependencies,
+  nthRootDependencies,
+  piDependencies,
+  powDependencies,
+  roundDependencies,
+  signDependencies,
+  sqrtDependencies,
+  subtractDependencies
+} from "mathjs/number";
+import { Plugin } from "../Plugin.ts";
+import { appendAnswerElement } from "../util/appendAnswerElement.ts";
+import { getElement } from "../util/getElement.ts";
+
+/**
+ * Parses and solves mathematical expressions. Can do basic arithmetic and
+ * evaluate some functions.
+ *
+ * @example
+ * "(3 + 5) / 2" = "4"
+ * "e ^ 2 + pi" = "10.530648752520442"
+ * "gcd(48, 18) + lcm(4, 5)" = "26"
+ *
+ * @remarks
+ * Depends on `mathjs` library.
+ */
+export default class Calculator extends Plugin {
+  public constructor() {
+    super("calculator");
+  }
+
+  /**
+   * @remarks
+   * Compare bundle size after adding or removing features.
+   */
+  private static readonly math = create({
+    ...absDependencies,
+    ...addDependencies,
+    ...divideDependencies,
+    ...eDependencies,
+    ...evaluateDependencies,
+    ...expDependencies,
+    ...factorialDependencies,
+    ...gcdDependencies,
+    ...lcmDependencies,
+    ...log10Dependencies,
+    ...log1pDependencies,
+    ...log2Dependencies,
+    ...logDependencies,
+    ...modDependencies,
+    ...multiplyDependencies,
+    ...nthRootDependencies,
+    ...piDependencies,
+    ...powDependencies,
+    ...roundDependencies,
+    ...signDependencies,
+    ...sqrtDependencies,
+    ...subtractDependencies
+  });
+
+  protected async run(): Promise<string | undefined> {
+    const searchInput = getElement<HTMLInputElement>("q");
+    const node = Calculator.math.parse(searchInput.value);
+
+    try {
+      return `${node.toString()} = ${node.evaluate()}`;
+    } catch {
+      // not a compatible math expression
+      return;
+    }
+  }
+
+  protected async post(result: string): Promise<void> {
+    appendAnswerElement(result);
+  }
+}

client/simple/src/js/plugin/InfiniteScroll.ts

@@ -0,0 +1,110 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { Plugin } from "../Plugin.ts";
+import { http, settings } from "../toolkit.ts";
+import { assertElement } from "../util/assertElement.ts";
+import { getElement } from "../util/getElement.ts";
+
+/**
+ * Automatically loads the next page when scrolling to bottom of the current page.
+ */
+export default class InfiniteScroll extends Plugin {
+  public constructor() {
+    super("infiniteScroll");
+  }
+
+  protected async run(): Promise<void> {
+    const resultsElement = getElement<HTMLElement>("results");
+
+    const onlyImages: boolean = resultsElement.classList.contains("only_template_images");
+    const observedSelector = "article.result:last-child";
+
+    const spinnerElement = document.createElement("div");
+    spinnerElement.className = "loader";
+
+    const loadNextPage = async (callback: () => void): Promise<void> => {
+      const searchForm = document.querySelector<HTMLFormElement>("#search");
+      assertElement(searchForm);
+
+      const form = document.querySelector<HTMLFormElement>("#pagination form.next_page");
+      assertElement(form);
+
+      const action = searchForm.getAttribute("action");
+      if (!action) {
+        throw new Error("Form action not defined");
+      }
+
+      const paginationElement = document.querySelector<HTMLElement>("#pagination");
+      assertElement(paginationElement);
+
+      paginationElement.replaceChildren(spinnerElement);
+
+      try {
+        const res = await http("POST", action, { body: new FormData(form) });
+        const nextPage = await res.text();
+        if (!nextPage) return;
+
+        const nextPageDoc = new DOMParser().parseFromString(nextPage, "text/html");
+        const articleList = nextPageDoc.querySelectorAll<HTMLElement>("#urls article");
+        const nextPaginationElement = nextPageDoc.querySelector<HTMLElement>("#pagination");
+
+        document.querySelector("#pagination")?.remove();
+
+        const urlsElement = document.querySelector<HTMLElement>("#urls");
+        if (!urlsElement) {
+          throw new Error("URLs element not found");
+        }
+
+        if (articleList.length > 0 && !onlyImages) {
+          // do not add <hr> element when there are only images
+          urlsElement.appendChild(document.createElement("hr"));
+        }
+
+        urlsElement.append(...articleList);
+
+        if (nextPaginationElement) {
+          const results = document.querySelector<HTMLElement>("#results");
+          results?.appendChild(nextPaginationElement);
+          callback();
+        }
+      } catch (error) {
+        console.error("Error loading next page:", error);
+
+        const errorElement = Object.assign(document.createElement("div"), {
+          textContent: settings.translations?.error_loading_next_page ?? "Error loading next page",
+          className: "dialog-error"
+        });
+        errorElement.setAttribute("role", "alert");
+        document.querySelector("#pagination")?.replaceChildren(errorElement);
+      }
+    };
+
+    const intersectionObserveOptions: IntersectionObserverInit = {
+      rootMargin: "320px"
+    };
+
+    const observer: IntersectionObserver = new IntersectionObserver(async (entries: IntersectionObserverEntry[]) => {
+      const [paginationEntry] = entries;
+
+      if (paginationEntry?.isIntersecting) {
+        observer.unobserve(paginationEntry.target);
+
+        await loadNextPage(() => {
+          const nextObservedElement = document.querySelector<HTMLElement>(observedSelector);
+          if (nextObservedElement) {
+            observer.observe(nextObservedElement);
+          }
+        });
+      }
+    }, intersectionObserveOptions);
+
+    const initialObservedElement: HTMLElement | null = document.querySelector<HTMLElement>(observedSelector);
+    if (initialObservedElement) {
+      observer.observe(initialObservedElement);
+    }
+  }
+
+  protected async post(): Promise<void> {
+    // noop
+  }
+}

client/simple/src/js/plugin/MapView.ts

@@ -0,0 +1,93 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import "ol/ol.css";
+import { Feature, Map as OlMap, View } from "ol";
+import { GeoJSON } from "ol/format";
+import { Point } from "ol/geom";
+import { Tile as TileLayer, Vector as VectorLayer } from "ol/layer";
+import { fromLonLat } from "ol/proj";
+import { OSM, Vector as VectorSource } from "ol/source";
+import { Circle, Fill, Stroke, Style } from "ol/style";
+import { Plugin } from "../Plugin.ts";
+
+/**
+ * MapView
+ */
+export default class MapView extends Plugin {
+  private readonly map: HTMLElement;
+
+  public constructor(map: HTMLElement) {
+    super("mapView");
+
+    this.map = map;
+  }
+
+  protected async run(): Promise<void> {
+    const { leafletTarget: target, mapLon = "0", mapLat = "0", mapGeojson } = this.map.dataset;
+
+    const lon = Number.parseFloat(mapLon);
+    const lat = Number.parseFloat(mapLat);
+    const view = new View({ maxZoom: 16, enableRotation: false });
+    const map = new OlMap({
+      target: target,
+      layers: [new TileLayer({ source: new OSM({ maxZoom: 16 }) })],
+      view: view
+    });
+
+    try {
+      const markerSource = new VectorSource({
+        features: [
+          new Feature({
+            geometry: new Point(fromLonLat([lon, lat]))
+          })
+        ]
+      });
+
+      const markerLayer = new VectorLayer({
+        source: markerSource,
+        style: new Style({
+          image: new Circle({
+            radius: 6,
+            fill: new Fill({ color: "#3050ff" })
+          })
+        })
+      });
+
+      map.addLayer(markerLayer);
+    } catch (error) {
+      console.error("Failed to create marker layer:", error);
+    }
+
+    if (mapGeojson) {
+      try {
+        const geoSource = new VectorSource({
+          features: new GeoJSON().readFeatures(JSON.parse(mapGeojson), {
+            dataProjection: "EPSG:4326",
+            featureProjection: "EPSG:3857"
+          })
+        });
+
+        const geoLayer = new VectorLayer({
+          source: geoSource,
+          style: new Style({
+            stroke: new Stroke({ color: "#3050ff", width: 2 }),
+            fill: new Fill({ color: "#3050ff33" })
+          })
+        });
+
+        map.addLayer(geoLayer);
+
+        const geoSourceExtent = geoSource.getExtent();
+        if (geoSourceExtent) {
+          view.fit(geoSourceExtent, { padding: [20, 20, 20, 20] });
+        }
+      } catch (error) {
+        console.error("Failed to create GeoJSON layer:", error);
+      }
+    }
+  }
+
+  protected async post(): Promise<void> {
+    // noop
+  }
+}

client/simple/src/js/router.ts

@@ -0,0 +1,69 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { load } from "./loader.ts";
+import { Endpoints, endpoint, listen, ready, settings } from "./toolkit.ts";
+
+ready(() => {
+  document.documentElement.classList.remove("no-js");
+  document.documentElement.classList.add("js");
+
+  listen("click", ".close", function (this: HTMLElement) {
+    (this.parentNode as HTMLElement)?.classList.add("invisible");
+  });
+
+  listen("click", ".searxng_init_map", async function (this: HTMLElement, event: Event) {
+    event.preventDefault();
+    this.classList.remove("searxng_init_map");
+
+    load(() => import("./plugin/MapView.ts").then(({ default: Plugin }) => new Plugin(this)), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  });
+
+  if (settings.plugins?.includes("infiniteScroll")) {
+    load(() => import("./plugin/InfiniteScroll.ts").then(({ default: Plugin }) => new Plugin()), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  }
+
+  if (settings.plugins?.includes("calculator")) {
+    load(() => import("./plugin/Calculator.ts").then(({ default: Plugin }) => new Plugin()), {
+      on: "endpoint",
+      where: [Endpoints.results]
+    });
+  }
+});
+
+ready(
+  () => {
+    void import("./main/keyboard.ts");
+    void import("./main/search.ts");
+
+    if (settings.autocomplete) {
+      void import("./main/autocomplete.ts");
+    }
+  },
+  { on: [endpoint === Endpoints.index] }
+);
+
+ready(
+  () => {
+    void import("./main/keyboard.ts");
+    void import("./main/results.ts");
+    void import("./main/search.ts");
+
+    if (settings.autocomplete) {
+      void import("./main/autocomplete.ts");
+    }
+  },
+  { on: [endpoint === Endpoints.results] }
+);
+
+ready(
+  () => {
+    void import("./main/preferences.ts");
+  },
+  { on: [endpoint === Endpoints.preferences] }
+);

client/simple/src/js/toolkit.ts

@@ -1,16 +1,16 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-import type { KeyBindingLayout } from "../main/keyboard.ts";
+import type { KeyBindingLayout } from "./main/keyboard.ts";
 
 // synced with searx/webapp.py get_client_settings
 type Settings = {
+  plugins?: string[];
   advanced_search?: boolean;
   autocomplete?: string;
   autocomplete_min?: number;
   doi_resolver?: string;
   favicon_resolver?: string;
   hotkeys?: KeyBindingLayout;
-  infinite_scroll?: boolean;
   method?: "GET" | "POST";
   query_in_title?: boolean;
   results_on_new_tab?: boolean;
@@ -32,8 +32,6 @@ type ReadyOptions = {
   on?: (boolean | undefined)[];
 };
 
-type AssertElement = (element?: HTMLElement | null) => asserts element is HTMLElement;
-
 export type EndpointsKeys = keyof typeof Endpoints;
 
 export const Endpoints = {
@@ -73,12 +71,6 @@ const getSettings = (): Settings => {
   }
 };
 
-export const assertElement: AssertElement = (element?: HTMLElement | null): asserts element is HTMLElement => {
-  if (!element) {
-    throw new Error("Bad assertion: DOM element not found");
-  }
-};
-
 export const http = async (method: string, url: string | URL, options?: HTTPOptions): Promise<Response> => {
   const controller = new AbortController();
   const timeoutId = setTimeout(() => controller.abort(), options?.timeout ?? 30_000);
@@ -131,10 +123,10 @@ export const ready = (callback: () => void, options?: ReadyOptions): void => {
     }
   }
 
-  if (document.readyState !== "loading") {
-    callback();
-  } else {
+  if (document.readyState === "loading") {
     listen("DOMContentLoaded", document, callback, { once: true });
+  } else {
+    callback();
   }
 };
 

client/simple/src/js/util/appendAnswerElement.ts

@@ -0,0 +1,34 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { getElement } from "./getElement.ts";
+
+export const appendAnswerElement = (element: HTMLElement | string | number): void => {
+  const results = getElement<HTMLDivElement>("results");
+
+  // ./searx/templates/elements/answers.html
+  let answers = getElement<HTMLDivElement>("answers", { assert: false });
+  if (!answers) {
+    // what is this?
+    const answersTitle = document.createElement("h4");
+    answersTitle.setAttribute("class", "title");
+    answersTitle.setAttribute("id", "answers-title");
+    answersTitle.textContent = "Answers : ";
+
+    answers = document.createElement("div");
+    answers.setAttribute("id", "answers");
+    answers.setAttribute("role", "complementary");
+    answers.setAttribute("aria-labelledby", "answers-title");
+    answers.appendChild(answersTitle);
+  }
+
+  if (!(element instanceof HTMLElement)) {
+    const span = document.createElement("span");
+    span.innerHTML = element.toString();
+    // biome-ignore lint/style/noParameterAssign: TODO
+    element = span;
+  }
+
+  answers.appendChild(element);
+
+  results.insertAdjacentElement("afterbegin", answers);
+};

client/simple/src/js/util/assertElement.ts

@@ -0,0 +1,8 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+type AssertElement = <T>(element?: T | null) => asserts element is T;
+export const assertElement: AssertElement = <T>(element?: T | null): asserts element is T => {
+  if (!element) {
+    throw new Error("DOM element not found");
+  }
+};

client/simple/src/js/util/getElement.ts

@@ -0,0 +1,21 @@
+// SPDX-License-Identifier: AGPL-3.0-or-later
+
+import { assertElement } from "./assertElement.ts";
+
+type Options = {
+  assert?: boolean;
+};
+
+export function getElement<T>(id: string, options?: { assert: true }): T;
+export function getElement<T>(id: string, options?: { assert: false }): T | null;
+export function getElement<T>(id: string, options: Options = {}): T | null {
+  options.assert ??= true;
+
+  const element = document.getElementById(id) as T | null;
+
+  if (options.assert) {
+    assertElement(element);
+  }
+
+  return element;
+}

client/simple/src/less/embedded.less

@@ -1,19 +1,16 @@
 // SPDX-License-Identifier: AGPL-3.0-or-later
 
-iframe[src^="https://w.soundcloud.com"]
-{
+iframe[src^="https://w.soundcloud.com"] {
   height: 120px;
 }
 
-iframe[src^="https://www.deezer.com"]
-{
+iframe[src^="https://www.deezer.com"] {
   // The real size is 92px, but 94px are needed to avoid an inner scrollbar of
   // the embedded HTML.
   height: 94px;
 }
 
-iframe[src^="https://www.mixcloud.com"]
-{
+iframe[src^="https://www.mixcloud.com"] {
   // the embedded player from mixcloud has some quirks: initial there is an
   // issue with an image URL that is blocked since it is an a Cross-Origin
   // request. The alternative text (<img alt='Mixcloud Logo'> then cause an
@@ -23,19 +20,16 @@ iframe[src^="https://www.mixcloud.com"]
   height: 250px;
 }
 
-iframe[src^="https://bandcamp.com/EmbeddedPlayer"]
-{
+iframe[src^="https://bandcamp.com/EmbeddedPlayer"] {
   // show playlist
   height: 350px;
 }
 
-iframe[src^="https://bandcamp.com/EmbeddedPlayer/track"]
-{
+iframe[src^="https://bandcamp.com/EmbeddedPlayer/track"] {
   // hide playlist
   height: 120px;
 }
 
-iframe[src^="https://genius.com/songs"]
-{
+iframe[src^="https://genius.com/songs"] {
   height: 65px;
 }

client/simple/src/less/index.less

@@ -8,7 +8,7 @@
   text-align: center;
 
   .title {
-    background: url("../img/searxng.png") no-repeat;
+    background: url("./img/searxng.png") no-repeat;
     min-height: 4rem;
     margin: 4rem auto;
     background-position: center;

client/simple/src/less/new_issue.less

@@ -1,38 +0,0 @@
-// SPDX-License-Identifier: AGPL-3.0-or-later
-
-.stats_endpoint {
-  .github-issue-button {
-    display: block;
-    font-size: 16px;
-  }
-
-  .issue-hide {
-    display: none;
-  }
-
-  input[type="checked"] {
-    position: absolute;
-  }
-
-  label {
-    margin: 1rem 1rem 1rem 0;
-  }
-
-  .step_content {
-    margin: 1rem 1rem 1rem 2rem;
-  }
-
-  .step1,
-  .step2 {
-    visibility: hidden;
-  }
-
-  .step1_delay {
-    transition: visibility 0s linear 4s;
-  }
-
-  #step1:checked ~ .step1,
-  #step2:checked ~ .step2 {
-    visibility: visible;
-  }
-}

client/simple/src/less/result_types/keyvalue.less

@@ -17,7 +17,7 @@
   }
 
   table {
-    word-break: break-word;
+    word-break: break-all;
     table-layout: fixed;
     width: 100%;
     background-color: var(--color-result-keyvalue-table);

client/simple/src/less/result_types/paper.less

@@ -41,7 +41,7 @@
     font-size: 0.9rem;
     margin: 0.25rem 0 0 0;
     padding: 0;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     line-height: 1.24;
     font-style: italic;
   }

client/simple/src/less/style.less

@@ -11,7 +11,6 @@
 @import "animations.less";
 @import "embedded.less";
 @import "info.less";
-@import "new_issue.less";
 @import "stats.less";
 @import "result_templates.less";
 @import "weather.less";
@@ -188,7 +187,7 @@ article[data-vim-selected].category-social {
 
   h3 {
     font-size: 1.2rem;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     margin: 0.4rem 0 0.4rem 0;
     padding: 0;
 
@@ -222,7 +221,7 @@ article[data-vim-selected].category-social {
     margin: 0;
     padding: 0;
     max-width: 54em;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     line-height: 1.24;
 
     .highlight {
@@ -366,7 +365,7 @@ article[data-vim-selected].category-social {
     font-size: 0.9rem;
     margin: 0.25rem 0 0 0;
     padding: 0;
-    word-wrap: break-word;
+    overflow-wrap: break-word;
     line-height: 1.24;
     font-style: italic;
   }
@@ -571,13 +570,16 @@ article[data-vim-selected].category-social {
 
 #suggestions {
   .wrapper {
-    display: flex;
-    flex-flow: column;
-    justify-content: flex-end;
+    padding-left: 0;
+    margin: 0;
+    list-style-position: inside;
+
+    li::marker {
+      color: var(--color-result-link-font);
+    }
 
     form {
       display: inline-block;
-      flex: 1 1 50%;
     }
   }
 }
@@ -585,8 +587,8 @@ article[data-vim-selected].category-social {
 #suggestions,
 #infoboxes {
   input {
-    padding: 0;
-    margin: 3px;
+    padding: 3px;
+    margin: 0;
     font-size: 0.9em;
     display: inline-block;
     background: transparent;
@@ -688,7 +690,7 @@ summary.title {
 
 #sidebar {
   grid-area: sidebar;
-  word-wrap: break-word;
+  overflow-wrap: break-word;
   color: var(--color-sidebar-font);
 
   .infobox {
@@ -1029,10 +1031,6 @@ summary.title {
     / 100%;
   gap: 0;
 
-  #sidebar {
-    display: none;
-  }
-
   #urls {
     margin: 0;
     display: flex;

client/simple/src/less/toolkit.less

@@ -610,7 +610,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: var(--color-base-font);
-  border: 1px solid rgba(var(--color-base-font-rgb), 0.9);
+  border: 1px solid rgb(var(--color-base-font-rgb), 0.9);
   padding: 0.3rem 0;
 }
 
@@ -618,7 +618,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border: 1px solid rgba(var(--color-base-font-rgb), 0.3);
+  border: 1px solid rgb(var(--color-base-font-rgb), 0.3);
   padding: 0.3rem 0;
 }
 
@@ -626,7 +626,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-bottom: 1px dotted rgba(var(--color-base-font-rgb), 0.5);
+  border-bottom: 1px dotted rgb(var(--color-base-font-rgb), 0.5);
   padding: 0;
 }
 
@@ -634,7 +634,7 @@ td:hover .engine-tooltip,
   .stacked-bar-chart-base();
 
   background: transparent;
-  border-left: 1px solid rgba(var(--color-base-font-rgb), 0.9);
+  border-left: 1px solid rgb(var(--color-base-font-rgb), 0.9);
   padding: 0.4rem 0;
   width: 1px;
 }

client/simple/tools/img.ts

@@ -18,8 +18,10 @@ export type Src2Dest = {
  * Convert a list of SVG files to PNG.
  *
  * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
+ * @param width - (optional) width of the PNG pictures
+ * @param height - (optional) height of the PNG pictures.
  */
-export const svg2png = (items: Src2Dest[]): void => {
+export const svg2png = (items: Src2Dest[], width?: number, height?: number): void => {
   for (const item of items) {
     fs.mkdirSync(path.dirname(item.dest), { recursive: true });
 
@@ -29,6 +31,9 @@ export const svg2png = (items: Src2Dest[]): void => {
         compressionLevel: 9,
         palette: true
       })
+      .resize(width, height, {
+        fit: "contain"
+      })
       .toFile(item.dest)
       .then((info) => {
         console.log(`[svg2png] created ${item.dest} -- bytes: ${info.size}, w:${info.width}px,  h:${info.height}px`);

client/simple/tools/plg.ts

@@ -4,7 +4,7 @@
  * Custom vite plugins to build the web-client components of the simple theme.
  *
  * HINT:
- *   This is an inital implementation for the migration of the build process
+ *   This is an initial implementation for the migration of the build process
  *   from grunt to vite.  For fully support (vite: build & serve) more work is
  *   needed.
  */
@@ -17,13 +17,15 @@ import { type Src2Dest, svg2png, svg2svg } from "./img.ts";
  * Vite plugin to convert a list of SVG files to PNG.
  *
  * @param items - Array of SVG files (src: SVG, dest:PNG) to convert.
+ * @param width - (optional) width of the PNG picture
+ * @param height - (optional) height of the PNG picture
  */
-export const plg_svg2png = (items: Src2Dest[]): Plugin => {
+export const plg_svg2png = (items: Src2Dest[], width?: number, height?: number): Plugin => {
   return {
     name: "searxng-simple-svg2png",
     apply: "build",
     writeBundle: () => {
-      svg2png(items);
+      svg2png(items, width, height);
     }
   };
 };

client/simple/tsconfig.json

@@ -31,7 +31,6 @@
     "noUnusedParameters": true,
     "verbatimModuleSyntax": true,
 
-    "baseUrl": ".",
     "tsBuildInfoFile": "./node_modules/.tmp/tsconfig.tsbuildinfo",
     "types": ["vite/client"]
   },

client/simple/vite.config.ts

@@ -34,7 +34,7 @@ const svg2svg_favicon_opts: Config = {
 };
 
 export default {
-  base: "/static/themes/simple/",
+  base: "./",
   publicDir: "static/",
 
   build: {
@@ -46,39 +46,37 @@ export default {
     sourcemap: true,
     rolldownOptions: {
       input: {
-        // build CSS files
-        "searxng-ltr.css": `${PATH.src}/less/style-ltr.less`,
-        "searxng-rtl.css": `${PATH.src}/less/style-rtl.less`,
-        "rss.css": `${PATH.src}/less/rss.less`,
+        // entrypoint
+        core: `${PATH.src}/js/index.ts`,
 
-        // build script files
-        "searxng.core": `${PATH.src}/js/core/index.ts`,
-
-        // ol pkg
-        ol: `${PATH.src}/js/pkg/ol.ts`,
-        "ol.css": `${PATH.modules}/ol/ol.css`
+        // stylesheets
+        ltr: `${PATH.src}/less/style-ltr.less`,
+        rtl: `${PATH.src}/less/style-rtl.less`,
+        rss: `${PATH.src}/less/rss.less`
       },
 
       // file naming conventions / pathnames are relative to outDir (PATH.dist)
       output: {
-        entryFileNames: "js/[name].min.js",
-        chunkFileNames: "js/[name].min.js",
+        entryFileNames: "sxng-[name].min.js",
+        chunkFileNames: "chunk/[hash].min.js",
         assetFileNames: ({ names }: PreRenderedAsset): string => {
           const [name] = names;
 
-          const extension = name?.split(".").pop();
-          switch (extension) {
+          switch (name?.split(".").pop()) {
             case "css":
-              return "css/[name].min[extname]";
-            case "js":
-              return "js/[name].min[extname]";
-            case "png":
-            case "svg":
-              return "img/[name][extname]";
+              return "sxng-[name].min[extname]";
             default:
-              console.warn("Unknown asset:", name);
-              return "[name][extname]";
+              return "sxng-[name][extname]";
           }
+        },
+        sanitizeFileName: (name: string): string => {
+          return name
+            .normalize("NFD")
+            .replace(/[^a-zA-Z0-9.-]/g, "_")
+            .toLowerCase();
+        },
+        comments: {
+          legal: true
         }
       }
     }
@@ -134,6 +132,28 @@ export default {
       }
     ]),
 
+    // SearXNG PWA Icons (static)
+    plg_svg2png(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.dist}/img/512.png`
+        }
+      ],
+      512,
+      512
+    ),
+    plg_svg2png(
+      [
+        {
+          src: `${PATH.brand}/searxng-wordmark.svg`,
+          dest: `${PATH.dist}/img/192.png`
+        }
+      ],
+      192,
+      192
+    ),
+
     // -- svg
     plg_svg2svg(
       [

container/.env.example

@@ -0,0 +1,15 @@
+# Read the documentation before using the `docker-compose.yml` file:
+# https://docs.searxng.org/admin/installation-docker.html
+#
+# Additional ENVs:
+# https://docs.searxng.org/admin/settings/settings_general.html#settings-general
+# https://docs.searxng.org/admin/settings/settings_server.html#settings-server
+
+# Use a specific version tag. E.g. "latest" or "2026.3.25-541c6c3cb".
+#SEARXNG_VERSION=latest
+
+# Listen to a specific address.
+#SEARXNG_HOST=[::]
+
+# Listen to a specific port.
+#SEARXNG_PORT=8080

container/dist.dockerfile

@@ -15,17 +15,17 @@ ARG VCS_URL="unknown"
 ARG VCS_REVISION="unknown"
 
 LABEL org.opencontainers.image.created="$CREATED" \
-      org.opencontainers.image.description="SearXNG is a metasearch engine. Users are neither tracked nor profiled." \
-      org.opencontainers.image.documentation="https://docs.searxng.org/admin/installation-docker" \
-      org.opencontainers.image.licenses="AGPL-3.0-or-later" \
-      org.opencontainers.image.revision="$VCS_REVISION" \
-      org.opencontainers.image.source="$VCS_URL" \
-      org.opencontainers.image.title="SearXNG" \
-      org.opencontainers.image.url="https://searxng.org" \
-      org.opencontainers.image.version="$VERSION"
+    org.opencontainers.image.description="SearXNG is a metasearch engine. Users are neither tracked nor profiled." \
+    org.opencontainers.image.documentation="https://docs.searxng.org/admin/installation-docker" \
+    org.opencontainers.image.licenses="AGPL-3.0-or-later" \
+    org.opencontainers.image.revision="$VCS_REVISION" \
+    org.opencontainers.image.source="$VCS_URL" \
+    org.opencontainers.image.title="SearXNG" \
+    org.opencontainers.image.url="https://searxng.org" \
+    org.opencontainers.image.version="$VERSION"
 
-ENV SEARXNG_VERSION="$VERSION" \
-    SEARXNG_SETTINGS_PATH="$CONFIG_PATH/settings.yml" \
+ENV __SEARXNG_VERSION="$VERSION" \
+    __SEARXNG_SETTINGS_PATH="$__SEARXNG_CONFIG_PATH/settings.yml" \
     GRANIAN_PROCESS_NAME="searxng" \
     GRANIAN_INTERFACE="wsgi" \
     GRANIAN_HOST="::" \
@@ -36,8 +36,8 @@ ENV SEARXNG_VERSION="$VERSION" \
     GRANIAN_BLOCKING_THREADS_IDLE_TIMEOUT="5m"
 
 # "*_PATH" ENVs are defined in base images
-VOLUME $CONFIG_PATH
-VOLUME $DATA_PATH
+VOLUME $__SEARXNG_CONFIG_PATH
+VOLUME $__SEARXNG_DATA_PATH
 
 EXPOSE 8080
 

container/docker-compose.yml

@@ -0,0 +1,28 @@
+# Read the documentation before using the `docker-compose.yml` file:
+# https://docs.searxng.org/admin/installation-docker.html
+
+name: searxng
+
+services:
+  core:
+    container_name: searxng-core
+    image: docker.io/searxng/searxng:${SEARXNG_VERSION:-latest}
+    restart: always
+    ports:
+      - ${SEARXNG_HOST:+${SEARXNG_HOST}:}${SEARXNG_PORT:-8080}:${SEARXNG_PORT:-8080}
+    env_file: ./.env
+    volumes:
+      - ./core-config/:/etc/searxng/:Z
+      - core-data:/var/cache/searxng/
+
+  valkey:
+    container_name: searxng-valkey
+    image: docker.io/valkey/valkey:9-alpine
+    command: valkey-server --save 30 1 --loglevel warning
+    restart: always
+    volumes:
+      - valkey-data:/data/
+
+volumes:
+  core-data:
+  valkey-data:

container/entrypoint.sh

@@ -117,16 +117,22 @@ EOF
 }
 
 cat <<EOF
-SearXNG $SEARXNG_VERSION
+SearXNG $__SEARXNG_VERSION
 EOF
 
 # Check for volume mounts
-volume_handler "$CONFIG_PATH"
-volume_handler "$DATA_PATH"
+volume_handler "$__SEARXNG_CONFIG_PATH"
+volume_handler "$__SEARXNG_DATA_PATH"
 
 # Check for files
-config_handler "$SEARXNG_SETTINGS_PATH" "/usr/local/searxng/searx/settings.yml"
+config_handler "$__SEARXNG_SETTINGS_PATH" "/usr/local/searxng/searx/settings.yml"
 
-update-ca-certificates
+# root only features
+if [ "$(id -u)" -eq 0 ]; then
+    update-ca-certificates
+fi
+
+# ENVs aliases
+export GRANIAN_PORT="${SEARXNG_PORT:-$GRANIAN_PORT}"
 
 exec /usr/local/searxng/.venv/bin/granian searx.webapp:app

docs/admin/answer-captcha.rst

@@ -48,7 +48,7 @@ solve the CAPTCHA from `qwant.com <https://www.qwant.com/>`__.
 
   .. group-tab:: Firefox
 
-     .. kernel-figure:: answer-captcha/ffox-setting-proxy-socks.png
+     .. kernel-figure:: /assets/answer-captcha/ffox-setting-proxy-socks.png
         :alt: FFox proxy on SOCKS5, 127.0.0.1:8080
 
         Firefox's network settings
@@ -66,4 +66,3 @@ solve the CAPTCHA from `qwant.com <https://www.qwant.com/>`__.
 
    -N
       Do not execute a remote command.  This is useful for just forwarding ports.
-

docs/admin/installation-docker.rst

@@ -9,7 +9,6 @@ Installation container
 .. _Podman rootless containers: https://github.com/containers/podman/blob/main/docs/tutorials/rootless_tutorial.md
 .. _DockerHub mirror: https://hub.docker.com/r/searxng/searxng
 .. _GHCR mirror: https://ghcr.io/searxng/searxng
-.. _Docker compose: https://github.com/searxng/searxng-docker
 
 .. sidebar:: info
 
@@ -27,7 +26,7 @@ Installation container
    `Docker 101`_ before proceeding.
 
 Container images are the basis for deployments in containerized environments,
-`Docker compose`_, Kubernetes and more.
+Compose, Kubernetes and more.
 
 .. _Container installation:
 
@@ -55,10 +54,10 @@ In the case of Docker, you need to add the user running the container to the
 In the case of Podman, no additional steps are generally required, but there
 are some considerations when running `Podman rootless containers`_.
 
-.. _Container pulling images:
+.. _Container registries:
 
-Pulling images
---------------
+Registries
+----------
 
 .. note::
 
@@ -70,26 +69,115 @@ The official images are mirrored at:
 - `DockerHub mirror`_
 - `GHCR mirror`_ (GitHub Container Registry)
 
-Pull the latest image:
+.. _Container compose instancing:
+
+Compose instancing
+==================
+
+This is the recommended way to deploy SearXNG in a containerized environment.
+Compose templates allow you to define container configurations in a
+declarative manner.
+
+.. _Container compose instancing setup:
+
+Setup
+-----
+
+1. Create the environment:
 
 .. code:: sh
 
-   $ docker pull docker.io/searxng/searxng:latest
+   # Create the environment and configuration directories
+   $ mkdir -p ./searxng/core-config/
+   $ cd ./searxng/
 
-\.\. or if you want to lock in to a specific version:
+   # Fetch the latest compose template
+   $ curl -fsSL \
+       -O https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
+       -O https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
+
+2. Copy the ``.env.example`` file and edit the values as needed:
 
 .. code:: sh
 
-   $ docker pull docker.io/searxng/searxng:2025.8.1-3d96414
+   $ cp -i .env.example .env
 
-.. _Container instancing:
+   # nano or your preferred text editor...
+   $ nano .env
 
-Instancing
-==========
+3. Start & stop the services:
+
+.. code:: sh
+
+   $ docker compose up -d
+   $ docker compose down
+
+4. Setup your settings in ``core-config/settings.yml`` according to your preferences.
+
+.. _Container compose instancing maintenance:
+
+Management
+----------
+
+.. important::
+
+    Remember to review the new templates for any changes that may affect your
+    deployment, and update the ``.env`` file accordingly.
+
+To update the templates to their latest versions:
+
+.. code:: sh
+
+   $ docker compose down
+   $ curl -fsSLO \
+       https://raw.githubusercontent.com/searxng/searxng/master/container/docker-compose.yml \
+       https://raw.githubusercontent.com/searxng/searxng/master/container/.env.example
+   $ docker compose up -d
+
+To update the services to their latest versions:
+
+.. code:: sh
+
+   $ docker compose down
+   $ docker compose pull
+   $ docker compose up -d
+
+List running services:
+
+.. code:: sh
+
+   $ docker compose ps
+   NAME            IMAGE  ...  CREATED        STATUS        PORTS
+   searxng-core    ...    ...  3 minutes ago  Up 3 minutes  0.0.0.0:8080->8080/tcp
+   searxng-valkey  ...    ...  3 minutes ago  Up 3 minutes  6379/tcp
+
+Print a service container logs:
+
+.. code:: sh
+
+   $ docker compose logs -f core
+
+Access a service container shell (troubleshooting):
+
+.. code:: sh
+
+   $ docker compose exec -it --user root core /bin/sh -l
+   /usr/local/searxng #
+
+Stop and remove the services:
+
+.. code:: sh
+
+   $ docker compose down
+
+.. _Container manual instancing:
+
+Manual instancing
+=================
 
 This section is intended for advanced users who need custom deployments.  We
-recommend using `Docker compose`_, which provides a preconfigured environment
-with sensible defaults.
+recommend using `Container compose instancing`_, which provides a preconfigured
+environment with sensible defaults.
 
 Basic container instancing example:
 
@@ -121,12 +209,18 @@ List running containers:
    CONTAINER ID  IMAGE  ...  CREATED        PORTS                   NAMES
    1af574997e63  ...    ...  3 minutes ago  0.0.0.0:8888->8080/tcp  searxng
 
+Print the container logs:
+
+.. code:: sh
+
+   $ docker container logs -f searxng
+
 Access the container shell (troubleshooting):
 
 .. code:: sh
 
    $ docker container exec -it --user root searxng /bin/sh -l
-   1af574997e63:/usr/local/searxng#
+   /usr/local/searxng #
 
 Stop and remove the container:
 
@@ -153,18 +247,12 @@ Environment variables
 The following environment variables can be configured:
 
 - ``$SEARXNG_*``: Controls the SearXNG configuration options, look out for
-  environment ``$SEARXNG_*`` in :ref:`settings server` and :ref:`settings
-  general`.
+  environment ``$SEARXNG_*`` in :ref:`settings server`, :ref:`settings
+  general` and the :origin:`container/.env.example` template.
 - ``$GRANIAN_*``: Controls the :ref:`Granian server options <Granian configuration>`.
 - ``$FORCE_OWNERSHIP``: Ensures mounted volumes/files are owned by the
   ``searxng:searxng`` user (default: ``true``)
 
-Container internal paths (don't modify unless you know what you're doing):
-
-- ``$CONFIG_PATH``: Path to the SearXNG configuration directory (default: ``/etc/searxng``)
-- ``$SEARXNG_SETTINGS_PATH``: Path to the SearXNG settings file (default: ``$CONFIG_PATH/settings.yml``)
-- ``$DATA_PATH``: Path to the SearXNG data directory (default: ``/var/cache/searxng``)
-
 .. _Container custom certificates:
 
 Custom certificates
@@ -176,6 +264,8 @@ additional certificates as needed.
 They will be available on container (re)start or when running
 ``update-ca-certificates`` in the container shell.
 
+This requires the container to be running with ``root`` privileges.
+
 .. _Container custom images:
 
 Custom images
@@ -199,3 +289,61 @@ container images are not officially supported):
    localhost/searxng/searxng  builder             ...       About a minute ago  524 MB
    ghcr.io/searxng/base       searxng-builder     ...       2 days ago          378 MB
    ghcr.io/searxng/base       searxng             ...       2 days ago          42.2 MB
+
+Migrate from ``searxng-docker``
+===============================
+
+We expect the following source directory structure:
+
+.. code:: sh
+
+   .
+   └── searxng-docker
+       ├── searxng
+       │   ├── favicons.toml
+       │   ├── limiter.toml
+       │   ├── settings.yml
+       │   └── ...
+       ├── .env
+       ├── Caddyfile
+       ├── docker-compose.yml
+       └── ...
+
+Create a brand new environment outside ``searxng-docker`` directory, following
+`Container compose instancing setup`_.
+
+Once up and running, stop the services and move the configuration files from
+the old mount to the new one:
+
+.. code:: sh
+
+   $ mv ./searxng-docker/searxng/* ./searxng/core-config/
+
+If using Valkey features like bot protection (limiter), you will need to update
+the URL hostname in :origin:`searx/settings.yml` file to ``valkey`` or
+``searxng-valkey``.
+
+If you have any environment variables in the old ``.env`` file, make
+sure to add them to the new one.
+
+Consider setting up a reverse proxy if exposing the instance to the public.
+
+You should end with the following directory structure:
+
+.. code:: sh
+
+    .
+    ├── searxng
+    │   ├── core-config
+    │   │   ├── favicons.toml
+    │   │   ├── limiter.toml
+    │   │   ├── settings.yml
+    │   │   └── ...
+    │   ├── .env.example
+    │   ├── .env
+    │   └── docker-compose.yml
+    └── searxng-docker
+        └── ...
+
+If everything is working on the new environment, you can remove the old
+``searxng-docker`` directory and its contents.

docs/admin/settings/settings_engines.rst

@@ -124,14 +124,17 @@ engine is shown.  Most of the options have a default value or even are optional.
 
 ``api_key`` : optional
   In a few cases, using an API needs the use of a secret key.  How to obtain them
-  is described in the file.
+  is described in the file.  Engines that require an API key are set to
+  ``inactive: true`` by default.  To enable such an engine, provide the API key
+  and set ``inactive: false``.
 
 ``disabled`` : optional
   To disable by default the engine, but not deleting it.  It will allow the user
   to manually activate it in the settings.
 
 ``inactive``: optional
-  Remove the engine from the settings (*disabled & removed*).
+  Remove the engine from the settings (*disabled & removed*).  This defaults to ``true`` for engines
+  that require an API key, please see the ``api_key`` section if you want to enable such an engine.
 
 ``language`` : optional
   If you want to use another language for a specific engine, you can define it

docs/admin/settings/settings_plugins.rst

@@ -69,6 +69,9 @@ The built-in plugins are all located in the namespace `searx.plugins`.
       searx.plugins.calculator.SXNGPlugin:
         active: true
 
+      searx.plugins.infinite_scroll.SXNGPlugin:
+        active: false
+
       searx.plugins.hash_plugin.SXNGPlugin:
         active: true
 

docs/admin/settings/settings_search.rst

@@ -36,6 +36,7 @@
 
   - ``360search``
   - ``baidu``
+  - ``bing``
   - ``brave``
   - ``dbpedia``
   - ``duckduckgo``
@@ -47,7 +48,6 @@
   - ``seznam``
   - ``sogou``
   - ``startpage``
-  - ``stract``
   - ``swisscows``
   - ``wikipedia``
   - ``yandex``

docs/admin/settings/settings_ui.rst

@@ -12,7 +12,6 @@
    ui:
      default_locale: ""
      query_in_title: false
-     infinite_scroll: false
      center_alignment: false
      cache_url: https://web.archive.org/web/
      default_theme: simple
@@ -32,9 +31,6 @@
   When true, the result page's titles contains the query it decreases the
   privacy, since the browser can records the page titles.
 
-``infinite_scroll``:
-  When true, automatically loads the next page when scrolling to bottom of the current page.
-
 ``center_alignment`` : default ``false``
   When enabled, the results are centered instead of being in the left (or RTL)
   side of the screen.  This setting only affects the *desktop layout*

docs/assets/sponsors/tuta.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 1024 384"><path fill="#410002" d="M479.178 119.294c-.533-.016-.998.357-1.218 1.078l-24.438 78.364.005-.004c-8.59 27.537 4.516 46.485 34.268 46.485 4.336 0 10.006-.357 11.776-.797.885-.264 1.33-.71 1.594-1.506l5.134-17.177c.264-.973-.09-1.77-1.507-1.683-4.517.445-8.588.797-12.308.797-14.964 0-21.075-7.968-16.646-22.224l10.446-33.47h30.373c.797 0 1.506-.445 1.858-1.418l5.401-17.355c.264-.973-.264-1.681-1.417-1.681H492.66l3.895-12.662c.265-.885.089-1.418-.62-2.034l-15.761-14.255c-.332-.3-.676-.45-.996-.459zm173.64 0c-.532-.016-.996.357-1.218 1.078l-24.436 78.364.005-.004c-8.59 27.537 4.517 46.485 34.268 46.485 4.342 0 10.004-.357 11.778-.797.884-.264 1.324-.71 1.593-1.506l5.133-17.177c.26-.973 0-1.77-1.508-1.683-4.517.445-8.59.797-12.307.797-14.966 0-21.077-7.968-16.646-22.224l10.445-33.47H690.3c.795 0 1.504-.445 1.854-1.418l5.402-17.355c.265-.973-.26-1.681-1.414-1.681H666.3l3.896-12.662c.265-.885.087-1.418-.618-2.034l-15.765-14.255c-.332-.3-.676-.45-.996-.459zm-48.32 29.404c-.974 0-1.503.444-1.862 1.417L590.502 188.9c-7.525 23.998-19.478 37.721-31.965 37.721-12.487 0-17.797-9.83-13.105-24.883l16.028-51.178c.351-1.149-.088-1.857-1.328-1.857H539.94c-.97 0-1.505.444-1.86 1.417l-15.497 49.233.008-.005c-8.765 27.982 5.315 46.31 27.452 46.31 12.747 0 22.756-6.111 29.93-16.118l-.176 12.838c0 1.241.621 1.593 1.681 1.593h14.17c1.064 0 1.504-.445 1.859-1.418l28.512-91.997c.35-1.15-.09-1.858-1.33-1.858zm147.96.005c-43.653 0-60.654 37.719-60.654 62.157-.09 21.339 13.282 34.798 31.08 34.798v.004c11.868 0 21.693-5.314 29.133-16.117v12.836c0 1.061.62 1.596 1.594 1.596h14.166c.974 0 1.505-.446 1.86-1.42l28.777-92.086c.265-.973-.266-1.768-1.24-1.768zm-.616 20.54h17.265l-6.197 19.57c-7.35 23.289-18.684 37.896-32.585 37.896-10.094 0-15.585-6.907-15.585-18.15 0-17.976 13.722-39.315 37.102-39.315z"/><path fill="#850122" d="M226.561 106.964c-.558.007-1.043.428-1.043 1.095V251.59c0 1.594 2.04 1.594 2.48 0L261.38 143.3c.445-1.241.446-2.039-.62-3.1l-33.204-32.762c-.299-.332-.66-.478-.996-.474zm55.983 41.739c-1.241 0-1.594.444-2.039 1.417l-43.919 142.203c-.176.797.177 1.594 1.242 1.594h145.747c1.418 0 2.04-.62 2.48-1.858l44.098-141.499c.445-1.417-.18-1.857-1.417-1.857zm-40.022-58.62c-1.418 0-1.594 1.242-.797 2.04l35.065 35.24c.796.798 1.594 1.061 2.836 1.061h149.467c1.065 0 1.68-1.24.62-2.214l-34.63-34.885c-.796-.796-1.592-1.242-3.274-1.242z"/></svg>

docs/build-templates/searxng.rst

@@ -119,8 +119,12 @@ ${fedora_build}
        pip install -U pip
        pip install -U setuptools
        pip install -U wheel
+
+       # additional packages required for installation
        pip install -U pyyaml
        pip install -U msgspec
+       pip install -U typing-extensions
+       pip install -U pybind11
 
        # jump to SearXNG's working tree and install SearXNG into virtualenv
        (${SERVICE_USER})$ cd \"$SEARXNG_SRC\"

docs/dev/engines/online/aol.rst

@@ -0,0 +1,8 @@
+.. _aol engine:
+
+===
+AOL
+===
+
+.. automodule:: searx.engines.aol
+   :members:

docs/dev/engines/online/brave.rst

@@ -1,5 +1,3 @@
-.. _brave engine:
-
 =============
 Brave Engines
 =============
@@ -9,5 +7,26 @@ Brave Engines
    :local:
    :backlinks: entry
 
+Brave offers two different engines for SearXNG:
+
+1. The standard engine (``brave``) uses the web interface.
+2. The API engine (``braveapi``) uses the official REST API.
+
+.. _brave engine:
+
+Brave Standard Engine
+---------------------
+
 .. automodule:: searx.engines.brave
-  :members:
+   :members:
+
+.. _braveapi engine:
+
+Brave API Engine
+----------------
+
+.. automodule:: searx.engines.braveapi
+   :members:
+
+The API engine requires an API key from Brave. This can be obtained from the
+`API Dashboard <https://api-dashboard.search.brave.com/>`_.

docs/dev/engines/online/karmasearch.rst

@@ -0,0 +1,8 @@
+.. _karmasearch engine:
+
+===========
+Karmasearch
+===========
+
+.. automodule:: searx.engines.karmasearch
+   :members:

docs/dev/engines/online/mullvad_leta.rst

@@ -1,8 +0,0 @@
-.. _voidlinux mullvad_leta:
-
-============
-Mullvad-Leta
-============
-
-.. automodule:: searx.engines.mullvad_leta
-   :members:

docs/dev/engines/online/seekr.rst

@@ -1,13 +0,0 @@
-.. _seekr engine:
-
-=============
-Seekr Engines
-=============
-
-.. contents:: Contents
-   :depth: 2
-   :local:
-   :backlinks: entry
-
-.. automodule:: searx.engines.seekr
-  :members:

docs/dev/engines/online/sourcehut.rst

@@ -0,0 +1,8 @@
+.. _sourcehut engine:
+
+=========
+Sourcehut
+=========
+
+.. automodule:: searx.engines.sourcehut
+   :members:

docs/dev/makefile.rst

@@ -291,38 +291,6 @@ Pylint_ is known as one of the best source-code, bug and quality checker for the
 Python programming language.  The pylint profile used in the SearXNG project is
 found in project's root folder :origin:`.pylintrc`.
 
-.. _make search.checker:
-
-``make search.checker.{engine name}``
-=====================================
-
-To check all engines::
-
-    make search.checker
-
-To check a engine with whitespace in the name like *google news* replace space
-by underline::
-
-    make search.checker.google_news
-
-To see HTTP requests and more use SEARXNG_DEBUG::
-
-    make SEARXNG_DEBUG=1 search.checker.google_news
-
-.. _3xx: https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#3xx_redirection
-
-To filter out HTTP redirects (3xx_)::
-
-    make SEARXNG_DEBUG=1 search.checker.google_news | grep -A1 "HTTP/1.1\" 3[0-9][0-9]"
-    ...
-    Engine google news                   Checking
-    https://news.google.com:443 "GET /search?q=life&hl=en&lr=lang_en&ie=utf8&oe=utf8&ceid=US%3Aen&gl=US HTTP/1.1" 302 0
-    https://news.google.com:443 "GET /search?q=life&hl=en-US&lr=lang_en&ie=utf8&oe=utf8&ceid=US:en&gl=US HTTP/1.1" 200 None
-    --
-    https://news.google.com:443 "GET /search?q=computer&hl=en&lr=lang_en&ie=utf8&oe=utf8&ceid=US%3Aen&gl=US HTTP/1.1" 302 0
-    https://news.google.com:443 "GET /search?q=computer&hl=en-US&lr=lang_en&ie=utf8&oe=utf8&ceid=US:en&gl=US HTTP/1.1" 200 None
-    --
-
 .. _make themes:
 
 ``make themes.*``

docs/dev/plugins/builtins.rst

@@ -10,6 +10,7 @@ Built-in Plugins
    calculator
    hash_plugin
    hostnames
+   infinite_scroll
    self_info
    tor_check
    unit_converter

docs/dev/plugins/infinite_scroll.rst

@@ -0,0 +1,8 @@
+.. _plugins.infinite_scroll:
+
+===============
+Infinite scroll
+===============
+
+.. automodule:: searx.plugins.infinite_scroll
+   :members:

docs/dev/search_api.rst

@@ -4,15 +4,33 @@
 Search API
 ==========
 
-The search supports both ``GET`` and ``POST``.
+SearXNG supports querying via a simple HTTP API.
+Two endpoints, ``/`` and ``/search``, are supported for both GET and POST methods.
+The GET method expects parameters as URL query parameters, while the POST method expects parameters as form data.
 
-Furthermore, two endpoints ``/`` and ``/search`` are available for querying.
+If you want to consume the results as JSON, CSV, or RSS, you need to set the
+``format`` parameter accordingly. Supported formats are defined in ``settings.yml``, under the ``search`` section.
+Requesting an unset format will return a 403 Forbidden error. Be aware that many public instances have these formats disabled.
 
 
+Endpoints:
+
 ``GET /``
-
 ``GET /search``
 
+``POST /``
+``POST /search``
+
+example cURL calls:
+
+.. code-block:: bash
+
+   curl 'https://searx.example.org/search?q=searxng&format=json'
+
+   curl -X POST 'https://searx.example.org/search' -d 'q=searxng&format=csv'
+
+   curl -L -X POST -d 'q=searxng&format=json' 'https://searx.example.org/'
+
 Parameters
 ==========
 
@@ -69,7 +87,7 @@ Parameters
 
 ``autocomplete`` : default from :ref:`settings search`
   [ ``google``, ``dbpedia``, ``duckduckgo``, ``mwmbl``, ``startpage``,
-  ``wikipedia``, ``stract``, ``swisscows``, ``qwant`` ]
+  ``wikipedia``, ``swisscows``, ``qwant`` ]
 
   Service which completes words as you type.
 

docs/index.rst

@@ -56,4 +56,34 @@ If you don't trust anyone, you can set up your own, see :ref:`installation`.
    utils/index
    src/index
 
+
+----------------
+Acknowledgements
+----------------
+
+The following organizations have provided SearXNG access to their paid plans at
+no cost:
+
+.. flat-table::
+   :widths: 1 1
+
+   * - .. image:: /assets/sponsors/docker.svg
+          :target: https://docker.com
+          :alt: Docker
+          :align: center
+          :height: 100 px
+
+     - .. image:: /assets/sponsors/tuta.svg
+          :target: https://tuta.com
+          :alt: Tuta
+          :align: center
+          :height: 100 px
+
+   * - .. image:: /assets/sponsors/browserstack.svg
+          :target: https://browserstack.com
+          :alt: BrowserStack
+          :align: center
+          :height: 100 px
+
+
 .. _searx.space: https://searx.space

manage

@@ -117,7 +117,7 @@ EOF
 
 dev.env() {
     go.env.dev
-    nvm.env
+    nvm.ensure
     node.env.dev
 
     export GOENV

mise.toml

@@ -1,7 +1,7 @@
 [tools]
 # minimal version we support
-python = "3.10"
-node = "24.3.0"
+python = "3.11"
+node = "25"
 go = "1.24.5"
 shellcheck = "0.11.0"
 # python 3.10 uses 3.40.1 (on mac and win)

requirements-dev.txt

@@ -1,28 +1,26 @@
 mock==5.2.0
-nose2[coverage_plugin]==0.15.1
+nose2[coverage_plugin]==0.16.0
 cov-core==1.15.0
 black==25.9.0
-pylint==4.0.2
+pylint==4.0.5
 splinter==0.21.0
-selenium==4.37.0
-Pallets-Sphinx-Themes==2.3.0
-Sphinx==8.2.3 ; python_version >= '3.11'
-Sphinx==8.1.3 ; python_version < '3.11'
-sphinx-issues==5.0.1
+selenium==4.43.0
+Pallets-Sphinx-Themes==2.5.0
+Sphinx==8.2.3
+sphinx-issues==6.0.0
 sphinx-jinja==2.0.2
-sphinx-tabs==3.4.7
-sphinxcontrib-programoutput==0.18
-sphinx-autobuild==2025.8.25 ; python_version >= '3.11'
-sphinx-autobuild==2024.10.3 ; python_version < '3.11'
+sphinx-tabs==3.5.0
+sphinxcontrib-programoutput==0.19
+sphinx-autobuild==2025.8.25
 sphinx-notfound-page==1.1.0
-myst-parser==4.0.1
+myst-parser==5.0.0
 linuxdoc==20240924
 aiounittest==1.5.0
-yamllint==1.37.1
-wlc==1.16.1
+yamllint==1.38.0
+wlc==1.17.2
 coloredlogs==15.0.1
 docutils>=0.21.2
 parameterized==0.9.0
-granian[reload]==2.5.5
-basedpyright==1.32.1
-types-lxml==2025.8.25
+granian[reload]==2.7.3
+basedpyright==1.39.2
+types-lxml==2026.2.16

requirements-server.txt

@@ -1 +1,2 @@
-granian==2.5.5
+granian==2.7.3
+granian[pname]==2.7.3

requirements.txt

@@ -1,22 +1,19 @@
-certifi==2025.10.5
-babel==2.17.0
+certifi==2026.2.25
+babel==2.18.0
 flask-babel==4.0.0
-flask==3.1.2
+flask==3.1.3
 jinja2==3.1.6
-lxml==6.0.2
-pygments==2.19.2
+lxml==6.0.4
+pygments==2.20.0
 python-dateutil==2.9.0.post0
 pyyaml==6.0.3
 httpx[http2]==0.28.1
 httpx-socks[asyncio]==0.10.0
-Brotli==1.1.0
-setproctitle==1.3.7
+sniffio==1.3.1
 valkey==6.1.1
-markdown-it-py==3.0.0
-fasttext-predict==0.9.2.4
-tomli==2.3.0; python_version < '3.11'
-msgspec==0.19.0
-typer-slim==0.20.0
+markdown-it-py==4.0.0
+msgspec==0.21.1
+typer==0.24.1
 isodate==0.7.2
-whitenoise==6.11.0
+whitenoise==6.12.0
 typing-extensions==4.15.0

searx/__init__.py

@@ -10,7 +10,6 @@ from os.path import dirname, abspath
 import logging
 
 import msgspec
-import searx.unixthreadname  # pylint: disable=unused-import
 
 # Debug
 LOG_FORMAT_DEBUG: str = '%(levelname)-7s %(name)-30.30s: %(message)s'

searx/autocomplete.py

@@ -1,11 +1,13 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """This module implements functions needed for the autocompleter."""
+
 # pylint: disable=use-dict-literal
+import string
+import random
 
 import json
-import html
 import typing as t
-from urllib.parse import urlencode, quote_plus
+from urllib.parse import urlencode
 
 import lxml.etree
 import lxml.html
@@ -16,7 +18,7 @@ from searx.engines import (
     engines,
     google,
 )
-from searx.network import get as http_get, post as http_post  # pyright: ignore[reportUnknownVariableType]
+from searx.network import get as http_get, post as http_post
 from searx.exceptions import SearxEngineResponseException
 from searx.utils import extr, gen_useragent
 
@@ -54,6 +56,26 @@ def baidu(query: str, _sxng_locale: str) -> list[str]:
     return results
 
 
+def bing(query: str, _sxng_locale: str) -> list[str]:
+    # bing search autocompleter
+    base_url = "https://www.bing.com/AS/Suggestions?"
+    # cvid has to be a 32 character long string consisting of numbers and uppsercase characters
+    cvid = ''.join(random.choice(string.ascii_uppercase + string.digits) for _ in range(32))
+    response = get(base_url + urlencode({'qry': query, 'csr': 1, 'cvid': cvid}))
+    results: list[str] = []
+
+    if response.ok:
+        data: dict[str, t.Any] = response.json()
+        if 's' in data:
+            for item in data['s']:
+                completion: str = item['q']
+                # bing uses PUA unicode characters to highlight parts of the query
+                # we have to remove these manually (U+E000 and U+E001)
+                completion = completion.replace("\ue000", "").replace("\ue001", "")
+                results.append(completion)
+    return results
+
+
 def brave(query: str, _sxng_locale: str) -> list[str]:
     # brave search autocompleter
     url = 'https://search.brave.com/api/suggest?'
@@ -268,18 +290,6 @@ def startpage(query: str, sxng_locale: str) -> list[str]:
     return results
 
 
-def stract(query: str, _sxng_locale: str) -> list[str]:
-    # stract autocompleter (beta)
-    url = f"https://stract.com/beta/api/autosuggest?q={quote_plus(query)}"
-    resp = post(url)
-    results: list[str] = []
-
-    if resp.ok:
-        results = [html.unescape(suggestion['raw']) for suggestion in resp.json()]
-
-    return results
-
-
 def swisscows(query: str, _sxng_locale: str) -> list[str]:
     # swisscows autocompleter
     url = 'https://swisscows.ch/api/suggest?{query}&itemsCount=5'
@@ -344,6 +354,7 @@ def yandex(query: str, _sxng_locale: str) -> list[str]:
 backends: dict[str, t.Callable[[str, str], list[str]]] = {
     '360search': qihu360search,
     'baidu': baidu,
+    'bing': bing,
     'brave': brave,
     'dbpedia': dbpedia,
     'duckduckgo': duckduckgo,
@@ -355,7 +366,6 @@ backends: dict[str, t.Callable[[str, str], list[str]]] = {
     'seznam': seznam,
     'sogou': sogou,
     'startpage': startpage,
-    'stract': stract,
     'swisscows': swisscows,
     'wikipedia': wikipedia,
     'yandex': yandex,

searx/botdetection/config.py

@@ -13,7 +13,7 @@ import copy
 import logging
 import pathlib
 
-from ..compat import tomllib
+import tomllib
 
 __all__ = ['Config', 'UNSET', 'SchemaIssue', 'set_global_cfg', 'get_global_cfg']
 

searx/brand.py

@@ -18,6 +18,17 @@ class BrandCustom(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
     """Custom entries in the footer of the WEB page: ``[title]: [link]``"""
 
 
+class ThemeColors(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
+    """Custom settings for theme colors in the brand section."""
+
+    theme_color_light: str = "#3050ff"
+    background_color_light: str = "#fff"
+    theme_color_dark: str = "#58f"
+    background_color_dark: str = "#222428"
+    theme_color_black: str = "#3050ff"
+    background_color_black: str = "#000"
+
+
 class SettingsBrand(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
     """Options for configuring brand properties.
 
@@ -54,6 +65,9 @@ class SettingsBrand(msgspec.Struct, kw_only=True, forbid_unknown_fields=True):
        :members:
     """
 
+    pwa_colors: ThemeColors = msgspec.field(default_factory=ThemeColors)
+    """Custom settings for PWA colors."""
+
     # new_issue_url is a hackish solution tailored for only one hoster (GH).  As
     # long as we don't have a more general solution, we should support it in the
     # given function, but it should not be expanded further.

searx/cache.py

@@ -5,10 +5,6 @@
 ----
 """
 
-# Struct fields aren't discovered in Python 3.14
-# - https://github.com/searxng/searxng/issues/5284
-from __future__ import annotations
-
 __all__ = ["ExpireCacheCfg", "ExpireCacheStats", "ExpireCache", "ExpireCacheSQLite"]
 
 import abc

searx/compat.py

@@ -1,25 +1,9 @@
 # SPDX-License-Identifier: AGPL-3.0-or-later
 """Compatibility with older versions"""
 
-# pylint: disable=unused-import
-
-__all__ = [
-    "tomllib",
-]
-
-import sys
 import warnings
 
 
-# TOML (lib) compatibility
-# ------------------------
-
-if sys.version_info >= (3, 11):
-    import tomllib
-else:
-    import tomli as tomllib
-
-
 # limiter backward compatibility
 # ------------------------------
 

searx/data/__init__.py

@@ -6,7 +6,7 @@ make data.all
 """
 # pylint: disable=invalid-name
 
-__all__ = ["ahmia_blacklist_loader", "data_dir", "get_cache"]
+__all__ = ["ahmia_blacklist_loader", "gsa_useragents_loader", "data_dir", "get_cache"]
 
 import json
 import typing as t
@@ -63,6 +63,7 @@ lazy_globals = {
     "ENGINE_TRAITS": None,
     "LOCALES": None,
     "TRACKER_PATTERNS": TrackerPatternsDB(),
+    "GSA_USER_AGENTS": None,
 }
 
 data_json_files = {
@@ -105,3 +106,24 @@ def ahmia_blacklist_loader() -> list[str]:
     """
     with open(data_dir / 'ahmia_blacklist.txt', encoding='utf-8') as f:
         return f.read().split()
+
+
+def gsa_useragents_loader() -> list[str]:
+    """Load data from `gsa_useragents.txt` and return a list of user agents
+    suitable for Google.  The user agents are fetched by::
+
+      searxng_extra/update/update_gsa_useragents.py
+
+    This function is used by :py:mod:`searx.engines.google`.
+
+    """
+    data = lazy_globals["GSA_USER_AGENTS"]
+    if data is not None:
+        return data
+
+    log.debug("init searx.data.%s", "GSA_USER_AGENTS")
+
+    with open(data_dir / 'gsa_useragents.txt', encoding='utf-8') as f:
+        lazy_globals["GSA_USER_AGENTS"] = f.read().splitlines()
+
+    return lazy_globals["GSA_USER_AGENTS"]