docs: document the new version features

Author: serhalp

docs/content/2.guide/1.features.md

@@ -7,6 +7,25 @@ navigation:
 
 npmx.dev provides a comprehensive set of features for browsing npm packages.
 
+## Search
+
+### Find packages
+
+Type a package name in the search bar to find it. Press `Enter` to navigate directly to an exact match.
+
+### Jump to a specific version
+
+Type `package@version` in the search bar and press `Enter` to go directly to that version:
+
+| Input                | Navigates to                                               |
+| -------------------- | ---------------------------------------------------------- |
+| `vue@3.4.0`          | Version page for vue 3.4.0                                 |
+| `@nuxt/kit@^3.0.0`   | Package page with versions matching `^3.0.0` pre-filtered  |
+| `react@^18 \|\| ^19` | Package page with versions matching the union pre-filtered |
+| `nuxt@latest`        | Package page with `latest` dist-tag filter                 |
+
+When the version is an exact version number (e.g. `3.4.0`), you'll land on that version's page. When it's a [semver range](/guide/semver-ranges) (e.g. `^3.0.0`), you'll land on the package page with the version filter pre-populated.
+
 ## Browse packages
 
 ### View package details

docs/content/2.guide/2.keyboard-shortcuts.md

@@ -27,6 +27,10 @@ These shortcuts work anywhere on the site. Press `/` from any page to quickly se
 | `Arrow Up` / `Arrow Down` | Move through results  |
 | `Enter`                   | Open selected package |
 
+::tip
+Type `package@version` (e.g. `vue@3.4.0` or `react@^18`) and press `Enter` to jump directly to that version or filter matching versions.
+::
+
 ## Package page
 
 | Key | Action           |

docs/content/2.guide/3.url-structure.md

@@ -36,6 +36,18 @@ npmx.dev also supports shorter, cleaner URLs:
 | `/@org`                | [`/@nuxt`](https://npmx.dev/@nuxt)                 |
 | `/~username`           | [`/~sindresorhus`](https://npmx.dev/~sindresorhus) |
 
+## Filter versions via URL
+
+Append `?semver=<range>#versions` to any package URL to pre-populate the version filter:
+
+| URL                                           | Effect                                        |
+| --------------------------------------------- | --------------------------------------------- |
+| `/package/vue?semver=^3.0.0#versions`         | Shows vue versions matching `^3.0.0`          |
+| `/package/react?semver=^18 \|\| ^19#versions` | Shows react versions matching `^18 \|\| ^19`  |
+| `/package/nuxt?semver=latest#versions`        | Shows nuxt versions matching the `latest` tag |
+
+This is the same filter used on the [semver ranges](/guide/semver-ranges) page. Dependency links with version ranges (e.g. `^18.0.0 || ^19.0.0`) automatically link to the package page with this filter applied.
+
 ## Understand URL limitations
 
 Some npm URLs are not yet supported:

docs/content/2.guide/5.semver-ranges.md

@@ -53,6 +53,15 @@ Type the exact version number, like `5.3.1`, to check if it exists.
 
 Type `>=3.0.0-alpha.0` to find alpha, beta, and release candidate versions for a major release.
 
+## Use semver ranges across npmx
+
+Semver ranges appear in several places on npmx:
+
+- **Version filter** - Type a range into the filter on any package page to find matching versions
+- **Dependency links** - Dependencies with version ranges (like `^18.0.0 || ^19.0.0`) link to the package page with the filter pre-populated
+- **Search bar** - Type `package@range` (e.g. `react@^18`) and press `Enter` to jump to the package with versions pre-filtered
+- **URL query param** - Add `?semver=^3.0.0#versions` to any package URL to share a filtered view
+
 ## Learn more
 
 The full semver range specification is documented at [node-semver](https://github.com/npm/node-semver#ranges).