diff --git a/eslint.config.js b/eslint.config.js
index 1924af9fa5a..4ca26296b16 100644
--- a/eslint.config.js
+++ b/eslint.config.js
@@ -1,4 +1,5 @@
 import tseslint from 'typescript-eslint'
+import jsdoc from 'eslint-plugin-jsdoc'
 import preferLet from 'eslint-plugin-prefer-let'
 
 /** @type {import('eslint').Linter.Config[]} */
@@ -7,6 +8,7 @@ export default [
     ignores: [
       '**/*.d.ts',
       '**/dist/**',
+      '**/docs/**',
       '**/coverage/**',
       '**/bench/**',
       '**/examples/**',
@@ -85,4 +87,88 @@ export default [
       'no-var': 'error',
     },
   },
+  {
+    files: ['packages/**/*.{ts,tsx}'],
+    ignores: ['packages/**/*.test.ts'],
+    plugins: { jsdoc },
+    settings: {
+      jsdoc: {
+        // Set our own contexts at the root to identify the types of things we care
+        // to enforce JSDoc rules on.  Mostly we care about:
+        // - exported public APIs
+        // - not private class methods
+        // - not private class properties
+        // - not anything marked `@private` (`ignorePrivate` setting)
+        contexts: [
+          // function foo() {}
+          'ClassDeclaration',
+          // function foo() {}
+          'FunctionDeclaration',
+          // let foo = function () {}
+          ':not(MethodDefinition) > FunctionExpression',
+          // Class{ foo() {} } but not Class{ #foo() {} } or Class { get foo() {} }
+          'MethodDefinition:not([kind=get]):not([key.type=PrivateIdentifier]) FunctionExpression',
+          // let foo = () => {}
+          ':not(PropertyDefinition) > ArrowFunctionExpression',
+          // Class{ foo = () => {} } but not Class{ #foo = () => {} }
+          'PropertyDefinition:not([key.type=PrivateIdentifier]) ArrowFunctionExpression',
+        ],
+        ignorePrivate: true,
+        tagNamePreference: {
+          // TODO: Temporarily allow both `@returns` and `@return`, but
+          // eventually we can find/replace to the standard `@returns` and
+          // remove this setting
+          return: 'return',
+        },
+      },
+    },
+    rules: {
+      // Using modified base rulesets from:
+      // https://github.com/gajus/eslint-plugin-jsdoc?tab=readme-ov-file#granular-flat-configs
+
+      // Modified version of jsdoc/flat/contents-typescript-error
+      'jsdoc/informative-docs': 'off',
+      'jsdoc/match-description': 'off',
+      'jsdoc/no-blank-block-descriptions': 'error',
+      'jsdoc/no-blank-blocks': 'error',
+      'jsdoc/text-escaping': 'off',
+
+      // Modified version of jsdoc/flat/logical-typescript-error
+      'jsdoc/check-access': 'error',
+      'jsdoc/check-param-names': 'error',
+      'jsdoc/check-property-names': 'error',
+      'jsdoc/check-syntax': 'error',
+      'jsdoc/check-tag-names': ['error'],
+      'jsdoc/check-template-names': 'error',
+      'jsdoc/check-types': 'error',
+      'jsdoc/check-values': 'error',
+      'jsdoc/empty-tags': 'error',
+      'jsdoc/escape-inline-tags': 'error',
+      'jsdoc/implements-on-classes': 'error',
+      'jsdoc/require-returns-check': 'error',
+      'jsdoc/require-yields-check': 'error',
+      'jsdoc/no-bad-blocks': 'error',
+      'jsdoc/no-defaults': 'error',
+      'jsdoc/no-types': 'error',
+      'jsdoc/no-undefined-types': 'error',
+      'jsdoc/valid-types': 'error',
+
+      // Modified version of jsdoc/flat/stylistic-typescript-error
+      'jsdoc/check-alignment': 'error',
+      'jsdoc/check-line-alignment': 'error',
+      'jsdoc/lines-before-block': 'off',
+      'jsdoc/multiline-blocks': 'error',
+      'jsdoc/no-multi-asterisks': 'error',
+      'jsdoc/require-asterisk-prefix': 'error',
+      'jsdoc/require-hyphen-before-param-description': ['error', 'never'],
+      'jsdoc/tag-lines': 'off',
+
+      // Additional rules we manually added
+      'jsdoc/require-param': 'error',
+      'jsdoc/require-param-description': 'error',
+      'jsdoc/require-param-name': 'error',
+      'jsdoc/require-returns': 'error',
+      'jsdoc/require-returns-description': 'error',
+    },
+  },
 ]
diff --git a/package.json b/package.json
index 75697b8a958..f4e91ecd583 100644
--- a/package.json
+++ b/package.json
@@ -6,6 +6,7 @@
   "dependencies": {
     "@typescript/native-preview": "catalog:",
     "eslint": "^9.33.0",
+    "eslint-plugin-jsdoc": "^61.5.0",
     "eslint-plugin-prefer-let": "^4.0.0",
     "prettier": "^3.3.3",
     "tsx": "catalog:",
diff --git a/packages/async-context-middleware/src/lib/async-context.ts b/packages/async-context-middleware/src/lib/async-context.ts
index a1250d60922..cd1d1511c19 100644
--- a/packages/async-context-middleware/src/lib/async-context.ts
+++ b/packages/async-context-middleware/src/lib/async-context.ts
@@ -8,7 +8,7 @@ const storage = new AsyncLocalStorage<RequestContext>()
  * Middleware that stores the request context in `AsyncLocalStorage` so it is available
  * to all functions in the same async execution context.
  *
- * @return A middleware function that stores the request context in `AsyncLocalStorage`
+ * @returns A middleware function that stores the request context in `AsyncLocalStorage`
  */
 export function asyncContext(): Middleware {
   return (context, next) => storage.run(context, next)
@@ -17,7 +17,7 @@ export function asyncContext(): Middleware {
 /**
  * Get the request context from `AsyncLocalStorage`.
  *
- * @return The request context
+ * @returns The request context
  */
 export function getContext(): RequestContext {
   let context = storage.getStore()
diff --git a/packages/cookie/src/lib/cookie.ts b/packages/cookie/src/lib/cookie.ts
index 56ec6ee47b8..0c86ec82d02 100644
--- a/packages/cookie/src/lib/cookie.ts
+++ b/packages/cookie/src/lib/cookie.ts
@@ -154,7 +154,7 @@ export class Cookie implements CookieProperties {
    * Extracts the value of this cookie from a `Cookie` header value.
    *
    * @param headerValue The `Cookie` header to parse
-   * @return The value of this cookie, or `null` if it's not present
+   * @returns The value of this cookie, or `null` if it's not present
    */
   async parse(headerValue: string | null): Promise<string | null> {
     if (!headerValue) return null
@@ -218,7 +218,7 @@ export class Cookie implements CookieProperties {
    *
    * @param value The value to serialize
    * @param props Additional properties to use when serializing the cookie
-   * @return The `Set-Cookie` header value for this cookie
+   * @returns The `Set-Cookie` header value for this cookie
    */
   async serialize(value: string, props?: CookieProperties): Promise<string> {
     let header = new SetCookieHeader({
@@ -251,7 +251,7 @@ export class Cookie implements CookieProperties {
  *
  * @param name The name of the cookie
  * @param options Options for the cookie
- * @return A new `Cookie` object
+ * @returns A new `Cookie` object
  */
 export function createCookie(name: string, options?: CookieOptions): Cookie {
   return new Cookie(name, options)
diff --git a/packages/fetch-proxy/src/lib/fetch-proxy.ts b/packages/fetch-proxy/src/lib/fetch-proxy.ts
index 214345efc7f..0838f5278c3 100644
--- a/packages/fetch-proxy/src/lib/fetch-proxy.ts
+++ b/packages/fetch-proxy/src/lib/fetch-proxy.ts
@@ -38,7 +38,7 @@ export interface FetchProxyOptions {
  *
  * @param input The URL or request to forward
  * @param init Optional request init options
- * @return A promise that resolves to the proxied response
+ * @returns A promise that resolves to the proxied response
  */
 export interface FetchProxy {
   (input: URL | RequestInfo, init?: RequestInit): Promise<Response>
@@ -49,7 +49,7 @@ export interface FetchProxy {
  *
  * @param target The URL of the server to proxy requests to
  * @param options Options to customize the behavior of the proxy
- * @return A fetch function that forwards requests to the target server
+ * @returns A fetch function that forwards requests to the target server
  */
 export function createFetchProxy(target: string | URL, options?: FetchProxyOptions): FetchProxy {
   let localFetch = options?.fetch ?? globalThis.fetch
diff --git a/packages/fetch-router/src/lib/app-storage.ts b/packages/fetch-router/src/lib/app-storage.ts
index 2635fb7559f..7498844d55c 100644
--- a/packages/fetch-router/src/lib/app-storage.ts
+++ b/packages/fetch-router/src/lib/app-storage.ts
@@ -8,7 +8,7 @@ export class AppStorage {
    * Check if a value is stored for the given key.
    *
    * @param key The key to check
-   * @return `true` if a value is stored for the given key, `false` otherwise
+   * @returns `true` if a value is stored for the given key, `false` otherwise
    */
   has<key extends StorageKey<any>>(key: key): boolean {
     return this.#map.has(key)
@@ -18,7 +18,7 @@ export class AppStorage {
    * Get a value from storage.
    *
    * @param key The key to get
-   * @return The value for the given key
+   * @returns The value for the given key
    */
   get<key extends StorageKey<any>>(key: key): StorageValue<key> {
     if (!this.#map.has(key)) {
@@ -47,7 +47,7 @@ export class AppStorage {
  * Create a storage key with an optional default value.
  *
  * @param defaultValue The default value for the storage key
- * @return The new storage key
+ * @returns The new storage key
  */
 export function createStorageKey<T>(defaultValue?: T): StorageKey<T> {
   return { defaultValue }
diff --git a/packages/fetch-router/src/lib/controller.ts b/packages/fetch-router/src/lib/controller.ts
index be69a137b8b..4c2dc768735 100644
--- a/packages/fetch-router/src/lib/controller.ts
+++ b/packages/fetch-router/src/lib/controller.ts
@@ -63,7 +63,7 @@ export type BuildAction<method extends RequestMethod | 'ANY', route extends stri
  * A request handler function that returns some kind of response.
  *
  * @param context The request context
- * @return The response
+ * @returns The response
  */
 export interface RequestHandler<
   method extends RequestMethod | 'ANY' = RequestMethod | 'ANY',
diff --git a/packages/fetch-router/src/lib/middleware.ts b/packages/fetch-router/src/lib/middleware.ts
index 42615435f42..59a8328566d 100644
--- a/packages/fetch-router/src/lib/middleware.ts
+++ b/packages/fetch-router/src/lib/middleware.ts
@@ -9,7 +9,7 @@ import type { RequestMethod } from './request-methods.ts'
  *
  * @param context The request context
  * @param next A function that invokes the next middleware or handler in the chain
- * @return A response to short-circuit the chain, or `undefined`/`void` to continue
+ * @returns A response to short-circuit the chain, or `undefined`/`void` to continue
  */
 export interface Middleware<
   method extends RequestMethod | 'ANY' = RequestMethod | 'ANY',
@@ -24,7 +24,7 @@ export interface Middleware<
 /**
  * A function that invokes the next middleware or handler in the chain.
  *
- * @return The response from the downstream handler
+ * @returns The response from the downstream handler
  */
 export type NextFunction = () => Promise<Response>
 
diff --git a/packages/fetch-router/src/lib/route-helpers/form.ts b/packages/fetch-router/src/lib/route-helpers/form.ts
index 2d7719bc33f..c887f50c5c2 100644
--- a/packages/fetch-router/src/lib/route-helpers/form.ts
+++ b/packages/fetch-router/src/lib/route-helpers/form.ts
@@ -27,7 +27,7 @@ export interface FormOptions {
  *
  * @param pattern The route pattern to use for the form and its submit action
  * @param options Options to configure the form action routes
- * @return The route map with `index` and `action` routes
+ * @returns The route map with `index` and `action` routes
  */
 export function createFormRoutes<pattern extends string, const options extends FormOptions>(
   pattern: pattern | RoutePattern<pattern>,
diff --git a/packages/fetch-router/src/lib/route-helpers/resource.ts b/packages/fetch-router/src/lib/route-helpers/resource.ts
index 21499e68399..fb4683a269b 100644
--- a/packages/fetch-router/src/lib/route-helpers/resource.ts
+++ b/packages/fetch-router/src/lib/route-helpers/resource.ts
@@ -45,7 +45,7 @@ export type ResourceOptions = {
  *
  * @param base The base route pattern to use for the resource
  * @param options Options to configure the resource routes
- * @return The route map with CRUD routes
+ * @returns The route map with CRUD routes
  */
 export function createResourceRoutes<base extends string, const options extends ResourceOptions>(
   base: base | RoutePattern<base>,
diff --git a/packages/fetch-router/src/lib/route-helpers/resources.ts b/packages/fetch-router/src/lib/route-helpers/resources.ts
index c58ff06bcf4..2b72d00acdb 100644
--- a/packages/fetch-router/src/lib/route-helpers/resources.ts
+++ b/packages/fetch-router/src/lib/route-helpers/resources.ts
@@ -52,7 +52,7 @@ export type ResourcesOptions = {
  *
  * @param base The base route pattern to use for the resources
  * @param options Options to configure the resource routes
- * @return The route map with CRUD routes
+ * @returns The route map with CRUD routes
  */
 export function createResourcesRoutes<base extends string, const options extends ResourcesOptions>(
   base: base | RoutePattern<base>,
diff --git a/packages/fetch-router/src/lib/route-map.ts b/packages/fetch-router/src/lib/route-map.ts
index bca298d8d5a..fc9cf6546de 100644
--- a/packages/fetch-router/src/lib/route-map.ts
+++ b/packages/fetch-router/src/lib/route-map.ts
@@ -41,7 +41,7 @@ export class Route<
    * Build a URL href for this route using the given parameters.
    *
    * @param args The parameters to use for building the href
-   * @return The built URL href
+   * @returns The built URL href
    */
   href(...args: HrefBuilderArgs<pattern>): string {
     return this.pattern.href(...args)
@@ -51,7 +51,7 @@ export class Route<
    * Match a URL against this route's pattern.
    *
    * @param url The URL to match
-   * @return The match result, or `null` if the URL doesn't match
+   * @returns The match result, or `null` if the URL doesn't match
    */
   match(url: string | URL): RouteMatch<pattern> | null {
     return this.pattern.match(url)
@@ -71,7 +71,7 @@ export type BuildRoute<method extends RequestMethod | 'ANY', pattern extends str
  * Create a route map from a set of route definitions.
  *
  * @param defs The route definitions
- * @return The route map
+ * @returns The route map
  */
 export function createRoutes<const defs extends RouteDefs>(defs: defs): BuildRouteMap<'/', defs>
 /**
@@ -79,7 +79,7 @@ export function createRoutes<const defs extends RouteDefs>(defs: defs): BuildRou
  *
  * @param base The base pattern for all routes
  * @param defs The route definitions
- * @return The route map
+ * @returns The route map
  */
 export function createRoutes<base extends string, const defs extends RouteDefs>(
   base: base | RoutePattern<base>,
@@ -128,7 +128,7 @@ export type BuildRouteMap<base extends string, defs extends RouteDefs> = Simplif
 }>
 
 // prettier-ignore
-type BuildRouteWithBase<base extends string, def extends RouteDef> = 
+type BuildRouteWithBase<base extends string, def extends RouteDef> =
   def extends string ? Route<'ANY', Join<base, def>> :
   def extends RoutePattern<infer pattern extends string> ? Route<'ANY', Join<base, pattern>> :
   def extends { method: infer method extends RequestMethod | 'ANY', pattern: infer pattern } ? (
diff --git a/packages/fetch-router/src/lib/router.ts b/packages/fetch-router/src/lib/router.ts
index ccb5b50ddcc..a33f7a27825 100644
--- a/packages/fetch-router/src/lib/router.ts
+++ b/packages/fetch-router/src/lib/router.ts
@@ -71,7 +71,7 @@ export interface Router {
    *
    * @param input The request input to fetch
    * @param init The request init options
-   * @return The response from the route that matched the request
+   * @returns The response from the route that matched the request
    */
   fetch(input: string | URL | Request, init?: RequestInit): Promise<Response>
   /**
@@ -177,7 +177,7 @@ function noMatchHandler({ url }: RequestContext): Response {
  * Create a new router.
  *
  * @param options Options to configure the router
- * @return The new router
+ * @returns The new router
  */
 export function createRouter(options?: RouterOptions): Router {
   let defaultHandler = options?.defaultHandler ?? noMatchHandler
diff --git a/packages/file-storage/src/lib/file-storage.ts b/packages/file-storage/src/lib/file-storage.ts
index f0d0c549d1f..102eb4e1275 100644
--- a/packages/file-storage/src/lib/file-storage.ts
+++ b/packages/file-storage/src/lib/file-storage.ts
@@ -6,14 +6,14 @@ export interface FileStorage {
    * Get a [`File`](https://developer.mozilla.org/en-US/docs/Web/API/File) at the given key.
    *
    * @param key The key to look up
-   * @return The file with the given key, or `null` if no such key exists
+   * @returns The file with the given key, or `null` if no such key exists
    */
   get(key: string): File | null | Promise<File | null>
   /**
    * Check if a file with the given key exists.
    *
    * @param key The key to look up
-   * @return `true` if a file with the given key exists, `false` otherwise
+   * @returns `true` if a file with the given key exists, `false` otherwise
    */
   has(key: string): boolean | Promise<boolean>
   /**
@@ -73,7 +73,7 @@ export interface FileStorage {
    * Use the `limit` option to limit how many results you get back in the `files` array.
    *
    * @param options Options for the list operation
-   * @return An object with an array of `files` and an optional `cursor` property
+   * @returns An object with an array of `files` and an optional `cursor` property
    */
   list<T extends ListOptions>(options?: T): ListResult<T> | Promise<ListResult<T>>
   /**
@@ -82,7 +82,7 @@ export interface FileStorage {
    *
    * @param key The key to store the file under
    * @param file The file to store
-   * @return A new `File` object backed by this storage
+   * @returns A new `File` object backed by this storage
    */
   put(key: string, file: File): File | Promise<File>
   /**
diff --git a/packages/form-data-middleware/src/lib/form-data.ts b/packages/form-data-middleware/src/lib/form-data.ts
index c9eba79aa27..b8b5a506eb7 100644
--- a/packages/form-data-middleware/src/lib/form-data.ts
+++ b/packages/form-data-middleware/src/lib/form-data.ts
@@ -28,7 +28,7 @@ export interface FormDataOptions extends ParseFormDataOptions {
  * Middleware that parses `FormData` from the request body and populates `context.formData`.
  *
  * @param options Options for parsing form data
- * @return A middleware function that parses form data
+ * @returns A middleware function that parses form data
  */
 export function formData(options?: FormDataOptions): Middleware {
   let suppressErrors = options?.suppressErrors ?? false
diff --git a/packages/form-data-parser/src/lib/form-data.ts b/packages/form-data-parser/src/lib/form-data.ts
index 66bb22046fe..20828c62a43 100644
--- a/packages/form-data-parser/src/lib/form-data.ts
+++ b/packages/form-data-parser/src/lib/form-data.ts
@@ -30,7 +30,7 @@ export class MaxFilesExceededError extends FormDataParseError {
  */
 export class FileUpload extends File {
   /**
-   * The name of the <input> field used to upload the file.
+   * The name of the `<input>` field used to upload the file.
    */
   readonly fieldName: string
 
@@ -47,7 +47,7 @@ export class FileUpload extends File {
  * A function used for handling file uploads.
  *
  * @param file The uploaded file
- * @return A value to store in `FormData`, or `void`/`null` to skip
+ * @returns A value to store in `FormData`, or `void`/`null` to skip
  */
 export interface FileUploadHandler {
   (file: FileUpload): void | null | string | Blob | Promise<void | null | string | Blob>
@@ -84,7 +84,7 @@ export interface ParseFormDataOptions extends MultipartParserOptions {
  * @param request The `Request` object to parse
  * @param options Options for the parser
  * @param uploadHandler A function that handles file uploads. It receives a `File` object and may return any value that is valid in a `FormData` object
- * @return A `Promise` that resolves to a `FormData` object containing the parsed data
+ * @returns A `Promise` that resolves to a `FormData` object containing the parsed data
  */
 export async function parseFormData(
   request: Request,
diff --git a/packages/fs/src/lib/fs.ts b/packages/fs/src/lib/fs.ts
index e5ccb9f56f8..01a5228dbf8 100644
--- a/packages/fs/src/lib/fs.ts
+++ b/packages/fs/src/lib/fs.ts
@@ -38,7 +38,7 @@ export interface OpenFileOptions {
  * @alias getFile
  * @param filename The path to the file
  * @param options Options to override the file's metadata
- * @return A `File` object
+ * @returns A `File` object
  */
 export function openFile(filename: string, options?: OpenFileOptions): File {
   let stats = fs.statSync(filename)
@@ -90,7 +90,7 @@ export { type OpenFileOptions as GetFileOptions, openFile as getFile }
  *
  * @param to The path to write the file to, or an open file descriptor
  * @param file The file to write
- * @return A promise that resolves when the file is written
+ * @returns A promise that resolves when the file is written
  */
 export function writeFile(to: string | number | fs.promises.FileHandle, file: File): Promise<void> {
   return new Promise(async (resolve, reject) => {
diff --git a/packages/headers/src/lib/accept-encoding.ts b/packages/headers/src/lib/accept-encoding.ts
index 94dd67d3057..279a449f897 100644
--- a/packages/headers/src/lib/accept-encoding.ts
+++ b/packages/headers/src/lib/accept-encoding.ts
@@ -89,7 +89,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
    * Returns `true` if the header matches the given encoding (i.e. it is "acceptable").
    *
    * @param encoding The encoding to check
-   * @return `true` if the encoding is acceptable, `false` otherwise
+   * @returns `true` if the encoding is acceptable, `false` otherwise
    */
   accepts(encoding: string): boolean {
     return encoding.toLowerCase() === 'identity' || this.getWeight(encoding) > 0
@@ -99,7 +99,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
    * Gets the weight an encoding. Performs wildcard matching so `*` matches all encodings.
    *
    * @param encoding The encoding to get
-   * @return The weight of the encoding, or `0` if it is not in the header
+   * @returns The weight of the encoding, or `0` if it is not in the header
    */
   getWeight(encoding: string): number {
     let lower = encoding.toLowerCase()
@@ -117,7 +117,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
    * Returns the most preferred encoding from the given list of encodings.
    *
    * @param encodings The encodings to choose from
-   * @return The most preferred encoding or `null` if none match
+   * @returns The most preferred encoding or `null` if none match
    */
   getPreferred<encoding extends string>(encodings: readonly encoding[]): encoding | null {
     let sorted = encodings
@@ -133,7 +133,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
    * Gets the weight of an encoding. If it is not in the header verbatim, this returns `null`.
    *
    * @param encoding The encoding to get
-   * @return The weight of the encoding, or `null` if it is not in the header
+   * @returns The weight of the encoding, or `null` if it is not in the header
    */
   get(encoding: string): number | null {
     return this.#map.get(encoding.toLowerCase()) ?? null
@@ -163,7 +163,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
    * Checks if the header contains a given encoding.
    *
    * @param encoding The encoding to check
-   * @return `true` if the encoding is in the header, `false` otherwise
+   * @returns `true` if the encoding is in the header, `false` otherwise
    */
   has(encoding: string): boolean {
     return this.#map.has(encoding.toLowerCase())
@@ -179,7 +179,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns an iterator of all encoding and weight pairs.
    *
-   * @return An iterator of `[encoding, weight]` tuples
+   * @returns An iterator of `[encoding, weight]` tuples
    */
   entries(): IterableIterator<[string, number]> {
     return this.#map.entries()
@@ -207,7 +207,7 @@ export class AcceptEncoding implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     let pairs: string[] = []
diff --git a/packages/headers/src/lib/accept-language.ts b/packages/headers/src/lib/accept-language.ts
index 7cc9ff064fc..9e1b138f9ee 100644
--- a/packages/headers/src/lib/accept-language.ts
+++ b/packages/headers/src/lib/accept-language.ts
@@ -89,7 +89,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
    * Returns `true` if the header matches the given language (i.e. it is "acceptable").
    *
    * @param language The locale identifier of the language to check
-   * @return `true` if the language is acceptable, `false` otherwise
+   * @returns `true` if the language is acceptable, `false` otherwise
    */
   accepts(language: string): boolean {
     return this.getWeight(language) > 0
@@ -100,7 +100,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
    * matching, so `en` matches `en-US` and `en-GB`, and `*` matches all languages.
    *
    * @param language The locale identifier of the language to get
-   * @return The weight of the language, or `0` if it is not in the header
+   * @returns The weight of the language, or `0` if it is not in the header
    */
   getWeight(language: string): number {
     let [base, subtype] = language.toLowerCase().split('-')
@@ -122,7 +122,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
    * Returns the most preferred language from the given list of languages.
    *
    * @param languages The locale identifiers of the languages to choose from
-   * @return The most preferred language or `null` if none match
+   * @returns The most preferred language or `null` if none match
    */
   getPreferred<language extends string>(languages: readonly language[]): language | null {
     let sorted = languages
@@ -139,7 +139,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
    * verbatim, this returns `null`.
    *
    * @param language The locale identifier of the language to get
-   * @return The weight of the language, or `null` if it is not in the header
+   * @returns The weight of the language, or `null` if it is not in the header
    */
   get(language: string): number | null {
     return this.#map.get(language.toLowerCase()) ?? null
@@ -169,7 +169,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
    * Checks if the header contains a language with the given locale identifier.
    *
    * @param language The locale identifier of the language to check
-   * @return `true` if the language is in the header, `false` otherwise
+   * @returns `true` if the language is in the header, `false` otherwise
    */
   has(language: string): boolean {
     return this.#map.has(language.toLowerCase())
@@ -185,7 +185,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns an iterator of all language and weight pairs.
    *
-   * @return An iterator of `[language, weight]` tuples
+   * @returns An iterator of `[language, weight]` tuples
    */
   entries(): IterableIterator<[string, number]> {
     return this.#map.entries()
@@ -213,7 +213,7 @@ export class AcceptLanguage implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     let pairs: string[] = []
diff --git a/packages/headers/src/lib/accept.ts b/packages/headers/src/lib/accept.ts
index 65ff1904424..9a30722b67d 100644
--- a/packages/headers/src/lib/accept.ts
+++ b/packages/headers/src/lib/accept.ts
@@ -89,7 +89,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
    * Returns `true` if the header matches the given media type (i.e. it is "acceptable").
    *
    * @param mediaType The media type to check
-   * @return `true` if the media type is acceptable, `false` otherwise
+   * @returns `true` if the media type is acceptable, `false` otherwise
    */
   accepts(mediaType: string): boolean {
     return this.getWeight(mediaType) > 0
@@ -99,7 +99,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
    * Gets the weight of a given media type. Also supports wildcards, so e.g. `text/*` will match `text/html`.
    *
    * @param mediaType The media type to get the weight of
-   * @return The weight of the media type
+   * @returns The weight of the media type
    */
   getWeight(mediaType: string): number {
     let [type, subtype] = mediaType.toLowerCase().split('/')
@@ -121,7 +121,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
    * Returns the most preferred media type from the given list of media types.
    *
    * @param mediaTypes The list of media types to choose from
-   * @return The most preferred media type or `null` if none match
+   * @returns The most preferred media type or `null` if none match
    */
   getPreferred<mediaType extends string>(mediaTypes: readonly mediaType[]): mediaType | null {
     let sorted = mediaTypes
@@ -137,7 +137,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
    * Returns the weight of a media type. If it is not in the header verbatim, this returns `null`.
    *
    * @param mediaType The media type to get the weight of
-   * @return The weight of the media type, or `null` if it is not in the header
+   * @returns The weight of the media type, or `null` if it is not in the header
    */
   get(mediaType: string): number | null {
     return this.#map.get(mediaType.toLowerCase()) ?? null
@@ -167,7 +167,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
    * Checks if a media type is in the header.
    *
    * @param mediaType The media type to check
-   * @return `true` if the media type is in the header (verbatim), `false` otherwise
+   * @returns `true` if the media type is in the header (verbatim), `false` otherwise
    */
   has(mediaType: string): boolean {
     return this.#map.has(mediaType.toLowerCase())
@@ -183,7 +183,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns an iterator of all media type and weight pairs.
    *
-   * @return An iterator of `[mediaType, weight]` tuples
+   * @returns An iterator of `[mediaType, weight]` tuples
    */
   entries(): IterableIterator<[string, number]> {
     return this.#map.entries()
@@ -211,7 +211,7 @@ export class Accept implements HeaderValue, Iterable<[string, number]> {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     let pairs: string[] = []
diff --git a/packages/headers/src/lib/cache-control.ts b/packages/headers/src/lib/cache-control.ts
index 8a1268ba821..03fc120a654 100644
--- a/packages/headers/src/lib/cache-control.ts
+++ b/packages/headers/src/lib/cache-control.ts
@@ -264,7 +264,7 @@ export class CacheControl implements HeaderValue, CacheControlInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     let parts = []
diff --git a/packages/headers/src/lib/content-disposition.ts b/packages/headers/src/lib/content-disposition.ts
index ba7a7b45f55..b9c02298d42 100644
--- a/packages/headers/src/lib/content-disposition.ts
+++ b/packages/headers/src/lib/content-disposition.ts
@@ -88,7 +88,7 @@ export class ContentDisposition implements HeaderValue, ContentDispositionInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     if (!this.type) {
diff --git a/packages/headers/src/lib/content-range.ts b/packages/headers/src/lib/content-range.ts
index df1257b85aa..5ee97ea09c4 100644
--- a/packages/headers/src/lib/content-range.ts
+++ b/packages/headers/src/lib/content-range.ts
@@ -64,7 +64,7 @@ export class ContentRange implements HeaderValue, ContentRangeInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     if (!this.unit || this.size === undefined) return ''
diff --git a/packages/headers/src/lib/content-type.ts b/packages/headers/src/lib/content-type.ts
index d2c77b2c9dd..4feb3ce8f07 100644
--- a/packages/headers/src/lib/content-type.ts
+++ b/packages/headers/src/lib/content-type.ts
@@ -65,7 +65,7 @@ export class ContentType implements HeaderValue, ContentTypeInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     if (!this.mediaType) {
diff --git a/packages/headers/src/lib/cookie.ts b/packages/headers/src/lib/cookie.ts
index e55802e9f9f..f7391716038 100644
--- a/packages/headers/src/lib/cookie.ts
+++ b/packages/headers/src/lib/cookie.ts
@@ -65,7 +65,7 @@ export class Cookie implements HeaderValue, Iterable<[string, string]> {
    * Gets the value of a cookie with the given name from the header.
    *
    * @param name The name of the cookie
-   * @return The value of the cookie, or `null` if the cookie does not exist
+   * @returns The value of the cookie, or `null` if the cookie does not exist
    */
   get(name: string): string | null {
     return this.#map.get(name) ?? null
@@ -94,7 +94,7 @@ export class Cookie implements HeaderValue, Iterable<[string, string]> {
    * True if a cookie with the given name exists in the header.
    *
    * @param name The name of the cookie
-   * @return `true` if a cookie with the given name exists in the header
+   * @returns `true` if a cookie with the given name exists in the header
    */
   has(name: string): boolean {
     return this.#map.has(name)
@@ -110,7 +110,7 @@ export class Cookie implements HeaderValue, Iterable<[string, string]> {
   /**
    * Returns an iterator of all cookie name and value pairs.
    *
-   * @return An iterator of `[name, value]` tuples
+   * @returns An iterator of `[name, value]` tuples
    */
   entries(): IterableIterator<[string, string]> {
     return this.#map.entries()
@@ -135,7 +135,7 @@ export class Cookie implements HeaderValue, Iterable<[string, string]> {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     let pairs: string[] = []
diff --git a/packages/headers/src/lib/if-match.ts b/packages/headers/src/lib/if-match.ts
index 986a442d176..475dd7c7168 100644
--- a/packages/headers/src/lib/if-match.ts
+++ b/packages/headers/src/lib/if-match.ts
@@ -42,7 +42,7 @@ export class IfMatch implements HeaderValue, IfMatchInit {
    * Note: This method checks only for exact matches and does not consider wildcards.
    *
    * @param tag The entity tag to check for
-   * @return `true` if the tag is present in the header, `false` otherwise
+   * @returns `true` if the tag is present in the header, `false` otherwise
    */
   has(tag: string): boolean {
     return this.tags.includes(quoteEtag(tag))
@@ -58,7 +58,7 @@ export class IfMatch implements HeaderValue, IfMatchInit {
    * will never match.
    *
    * @param tag The entity tag to check against
-   * @return `true` if the precondition passes, `false` if it fails (should return 412)
+   * @returns `true` if the precondition passes, `false` if it fails (should return 412)
    */
   matches(tag: string): boolean {
     if (this.tags.length === 0) {
@@ -90,7 +90,7 @@ export class IfMatch implements HeaderValue, IfMatchInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString() {
     return this.tags.join(', ')
diff --git a/packages/headers/src/lib/if-none-match.ts b/packages/headers/src/lib/if-none-match.ts
index 172b7d6e594..04930515a6e 100644
--- a/packages/headers/src/lib/if-none-match.ts
+++ b/packages/headers/src/lib/if-none-match.ts
@@ -42,7 +42,7 @@ export class IfNoneMatch implements HeaderValue, IfNoneMatchInit {
    * Note: This method checks only for exact matches and does not consider wildcards.
    *
    * @param tag The entity tag to check for
-   * @return `true` if the tag is present in the header, `false` otherwise
+   * @returns `true` if the tag is present in the header, `false` otherwise
    */
   has(tag: string): boolean {
     return this.tags.includes(quoteEtag(tag))
@@ -52,7 +52,7 @@ export class IfNoneMatch implements HeaderValue, IfNoneMatchInit {
    * Checks if this header matches the given entity tag.
    *
    * @param tag The entity tag to check for
-   * @return `true` if the tag is present in the header (or the header contains a wildcard), `false` otherwise
+   * @returns `true` if the tag is present in the header (or the header contains a wildcard), `false` otherwise
    */
   matches(tag: string): boolean {
     return this.has(tag) || this.tags.includes('*')
@@ -61,7 +61,7 @@ export class IfNoneMatch implements HeaderValue, IfNoneMatchInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString() {
     return this.tags.join(', ')
diff --git a/packages/headers/src/lib/if-range.ts b/packages/headers/src/lib/if-range.ts
index 919171e91b8..4975eb4a4d0 100644
--- a/packages/headers/src/lib/if-range.ts
+++ b/packages/headers/src/lib/if-range.ts
@@ -41,7 +41,7 @@ export class IfRange implements HeaderValue {
    * Weak entity tags (prefixed with `W/`) are never considered a match.
    *
    * @param resource The current resource state to compare against
-   * @return `true` if the condition is satisfied, `false` otherwise
+   * @returns `true` if the condition is satisfied, `false` otherwise
    *
    * @example
    * ```ts
@@ -84,7 +84,7 @@ export class IfRange implements HeaderValue {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString() {
     return this.value
diff --git a/packages/headers/src/lib/range.ts b/packages/headers/src/lib/range.ts
index 1054b51b168..ed98f18dd7e 100644
--- a/packages/headers/src/lib/range.ts
+++ b/packages/headers/src/lib/range.ts
@@ -86,7 +86,7 @@ export class Range implements HeaderValue, RangeInit {
    * Checks if this range can be satisfied for a resource of the given size.
    *
    * @param resourceSize The size of the resource in bytes
-   * @return `false` if the range is malformed or all ranges are beyond the resource size
+   * @returns `false` if the range is malformed or all ranges are beyond the resource size
    */
   canSatisfy(resourceSize: number): boolean {
     // No unit or no ranges means header was malformed or empty
@@ -125,7 +125,7 @@ export class Range implements HeaderValue, RangeInit {
    * Returns an empty array if the range cannot be satisfied.
    *
    * @param resourceSize The size of the resource in bytes
-   * @return An array of ranges with resolved start and end values
+   * @returns An array of ranges with resolved start and end values
    */
   normalize(resourceSize: number): Array<{ start: number; end: number }> {
     if (!this.canSatisfy(resourceSize)) {
@@ -159,7 +159,7 @@ export class Range implements HeaderValue, RangeInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     if (!this.unit || this.ranges.length === 0) return ''
diff --git a/packages/headers/src/lib/set-cookie.ts b/packages/headers/src/lib/set-cookie.ts
index 82edca0083f..8a7cdbb0fe8 100644
--- a/packages/headers/src/lib/set-cookie.ts
+++ b/packages/headers/src/lib/set-cookie.ts
@@ -167,7 +167,7 @@ export class SetCookie implements HeaderValue, SetCookieInit {
   /**
    * Returns the string representation of the header value.
    *
-   * @return The header value as a string
+   * @returns The header value as a string
    */
   toString(): string {
     if (!this.name) {
diff --git a/packages/headers/src/lib/super-headers.ts b/packages/headers/src/lib/super-headers.ts
index 4e98ddca03e..bec67153f2a 100644
--- a/packages/headers/src/lib/super-headers.ts
+++ b/packages/headers/src/lib/super-headers.ts
@@ -272,7 +272,7 @@ export class SuperHeaders extends Headers {
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/get)
    *
    * @param name The name of the header to get
-   * @return The header value, or `null` if not found
+   * @returns The header value, or `null` if not found
    */
   override get(name: string): string | null {
     let key = name.toLowerCase()
@@ -298,7 +298,7 @@ export class SuperHeaders extends Headers {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/getSetCookie)
    *
-   * @return An array of `Set-Cookie` header values
+   * @returns An array of `Set-Cookie` header values
    */
   override getSetCookie(): string[] {
     return this.#setCookies.map((v) => (typeof v === 'string' ? v : v.toString()))
@@ -310,7 +310,7 @@ export class SuperHeaders extends Headers {
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/has)
    *
    * @param name The name of the header to check
-   * @return `true` if the header is present, `false` otherwise
+   * @returns `true` if the header is present, `false` otherwise
    */
   override has(name: string): boolean {
     let key = name.toLowerCase()
@@ -340,7 +340,7 @@ export class SuperHeaders extends Headers {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/keys)
    *
-   * @return An iterator of header keys
+   * @returns An iterator of header keys
    */
   override *keys(): HeadersIterator<string> {
     for (let [key] of this) yield key
@@ -351,7 +351,7 @@ export class SuperHeaders extends Headers {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/values)
    *
-   * @return An iterator of header values
+   * @returns An iterator of header values
    */
   override *values(): HeadersIterator<string> {
     for (let [, value] of this) yield value
@@ -362,7 +362,7 @@ export class SuperHeaders extends Headers {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Headers/entries)
    *
-   * @return An iterator of `[key, value]` tuples
+   * @returns An iterator of `[key, value]` tuples
    */
   override *entries(): HeadersIterator<[string, string]> {
     for (let [key] of this.#map) {
@@ -396,7 +396,7 @@ export class SuperHeaders extends Headers {
   /**
    * Returns a string representation of the headers suitable for use in a HTTP message.
    *
-   * @return The headers formatted for HTTP
+   * @returns The headers formatted for HTTP
    */
   override toString(): string {
     let lines: string[] = []
diff --git a/packages/html-template/src/lib/safe-html.ts b/packages/html-template/src/lib/safe-html.ts
index 8c087d139b8..8173d330e8e 100644
--- a/packages/html-template/src/lib/safe-html.ts
+++ b/packages/html-template/src/lib/safe-html.ts
@@ -16,7 +16,7 @@ function createSafeHtml(value: string): SafeHtml {
  * Checks if a value is a `SafeHtml` string.
  *
  * @param value The value to check
- * @return `true` if the value is a `SafeHtml` string
+ * @returns `true` if the value is a `SafeHtml` string
  */
 export function isSafeHtml(value: unknown): value is SafeHtml {
   return typeof value === 'object' && value != null && (value as any)[kSafeHtml] === true
@@ -85,7 +85,7 @@ type SafeHtmlHelper = {
    *
    * @param strings The template strings
    * @param values The values to interpolate
-   * @return A `SafeHtml` value
+   * @returns A `SafeHtml` value
    */
   (strings: TemplateStringsArray, ...values: Interpolation[]): SafeHtml
   /**
@@ -96,7 +96,7 @@ type SafeHtmlHelper = {
    *
    * @param strings The template strings
    * @param values The values to interpolate
-   * @return A `SafeHtml` value
+   * @returns A `SafeHtml` value
    */
   raw(strings: TemplateStringsArray, ...values: Interpolation[]): SafeHtml
 }
diff --git a/packages/interaction/src/lib/interaction.ts b/packages/interaction/src/lib/interaction.ts
index 1297396c709..6f81eae3579 100644
--- a/packages/interaction/src/lib/interaction.ts
+++ b/packages/interaction/src/lib/interaction.ts
@@ -107,7 +107,7 @@ export type InteractionSetup = (this: Interaction) => void
  *
  * @param type The unique string identifier for this interaction type
  * @param interaction The setup function that configures the interaction
- * @return The type string, for use as an event name
+ * @returns The type string, for use as an event name
  */
 export function defineInteraction<type extends string>(type: type, interaction: InteractionSetup) {
   interactions.set(type, interaction)
@@ -161,7 +161,7 @@ export type ContainerOptions = {
  *
  * @param target The event target to wrap (DOM element, window, document, or any EventTarget)
  * @param options Optional configuration for the container
- * @return An `EventsContainer` with `dispose()` and `set()` methods
+ * @returns An `EventsContainer` with `dispose()` and `set()` methods
  */
 export function createContainer<target extends EventTarget>(
   target: target,
@@ -272,7 +272,7 @@ export function createContainer<target extends EventTarget>(
  *
  * @param target The event target to add listeners to
  * @param listeners The event listeners to add
- * @return A function to dispose all listeners
+ * @returns A function to dispose all listeners
  */
 export function on<target extends EventTarget>(
   target: target,
diff --git a/packages/interaction/src/lib/interactions/popover.ts b/packages/interaction/src/lib/interactions/popover.ts
index 82b509b38b8..bd4443033c5 100644
--- a/packages/interaction/src/lib/interactions/popover.ts
+++ b/packages/interaction/src/lib/interactions/popover.ts
@@ -6,7 +6,7 @@ import { defineInteraction, type Interaction } from '../interaction'
  * Dispatches on the owner of a popover when the popover toggles.
  *
  * ### Example
-
+ *
  * ```html
  * <button popovertarget="my-popover">
  *   Toggle Popover
diff --git a/packages/lazy-file/src/lib/byte-range.ts b/packages/lazy-file/src/lib/byte-range.ts
index d27b0bd46fc..54e43954ea6 100644
--- a/packages/lazy-file/src/lib/byte-range.ts
+++ b/packages/lazy-file/src/lib/byte-range.ts
@@ -19,7 +19,7 @@ export interface ByteRange {
  *
  * @param range The byte range
  * @param size The total size of the buffer
- * @return The length of the byte range
+ * @returns The length of the byte range
  */
 export function getByteLength(range: ByteRange, size: number): number {
   let [start, end] = getIndexes(range, size)
@@ -31,7 +31,7 @@ export function getByteLength(range: ByteRange, size: number): number {
  *
  * @param range The byte range
  * @param size The total size of the buffer
- * @return A tuple of `[start, end]` indexes
+ * @returns A tuple of `[start, end]` indexes
  */
 export function getIndexes(range: ByteRange, size: number): [number, number] {
   let start = Math.min(Math.max(0, range.start < 0 ? size + range.start : range.start), size)
diff --git a/packages/lazy-file/src/lib/lazy-file.ts b/packages/lazy-file/src/lib/lazy-file.ts
index 0aaa7564d28..4e595ec0d02 100644
--- a/packages/lazy-file/src/lib/lazy-file.ts
+++ b/packages/lazy-file/src/lib/lazy-file.ts
@@ -15,7 +15,7 @@ export interface LazyContent {
    *
    * @param start The start index (inclusive)
    * @param end The end index (exclusive)
-   * @return A readable stream of the content
+   * @returns A readable stream of the content
    */
   stream(start?: number, end?: number): ReadableStream<Uint8Array<ArrayBuffer>>
 }
@@ -70,7 +70,7 @@ export class LazyBlob extends Blob {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/arrayBuffer)
    *
-   * @return A promise that resolves to an `ArrayBuffer`
+   * @returns A promise that resolves to an `ArrayBuffer`
    */
   arrayBuffer(): Promise<ArrayBuffer> {
     return this.#content.arrayBuffer()
@@ -81,7 +81,7 @@ export class LazyBlob extends Blob {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/bytes)
    *
-   * @return A promise that resolves to a `Uint8Array`
+   * @returns A promise that resolves to a `Uint8Array`
    */
   bytes(): Promise<Uint8Array<ArrayBuffer>> {
     return this.#content.bytes()
@@ -104,7 +104,7 @@ export class LazyBlob extends Blob {
    * @param start The start index (inclusive)
    * @param end The end index (exclusive)
    * @param contentType The content type of the new blob
-   * @return A new `Blob` containing the sliced data
+   * @returns A new `Blob` containing the sliced data
    */
   slice(start?: number, end?: number, contentType?: string): Blob {
     return this.#content.slice(start, end, contentType)
@@ -115,7 +115,7 @@ export class LazyBlob extends Blob {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/stream)
    *
-   * @return A readable stream of the blob's contents
+   * @returns A readable stream of the blob's contents
    */
   stream(): ReadableStream<Uint8Array<ArrayBuffer>> {
     return this.#content.stream()
@@ -126,7 +126,7 @@ export class LazyBlob extends Blob {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/text)
    *
-   * @return A promise that resolves to the blob's contents as a string
+   * @returns A promise that resolves to the blob's contents as a string
    */
   text(): Promise<string> {
     return this.#content.text()
@@ -180,7 +180,7 @@ export class LazyFile extends File {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/arrayBuffer)
    *
-   * @return A promise that resolves to an `ArrayBuffer`
+   * @returns A promise that resolves to an `ArrayBuffer`
    */
   arrayBuffer(): Promise<ArrayBuffer> {
     return this.#content.arrayBuffer()
@@ -191,7 +191,7 @@ export class LazyFile extends File {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/bytes)
    *
-   * @return A promise that resolves to a `Uint8Array`
+   * @returns A promise that resolves to a `Uint8Array`
    */
   bytes(): Promise<Uint8Array<ArrayBuffer>> {
     return this.#content.bytes()
@@ -214,7 +214,7 @@ export class LazyFile extends File {
    * @param start The start index (inclusive)
    * @param end The end index (exclusive)
    * @param contentType The content type of the new blob
-   * @return A new `Blob` containing the sliced data
+   * @returns A new `Blob` containing the sliced data
    */
   slice(start?: number, end?: number, contentType?: string): Blob {
     return this.#content.slice(start, end, contentType)
@@ -225,7 +225,7 @@ export class LazyFile extends File {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/stream)
    *
-   * @return A readable stream of the file's contents
+   * @returns A readable stream of the file's contents
    */
   stream(): ReadableStream<Uint8Array<ArrayBuffer>> {
     return this.#content.stream()
@@ -236,7 +236,7 @@ export class LazyFile extends File {
    *
    * [MDN Reference](https://developer.mozilla.org/en-US/docs/Web/API/Blob/text)
    *
-   * @return A promise that resolves to the file's contents as a string
+   * @returns A promise that resolves to the file's contents as a string
    */
   text(): Promise<string> {
     return this.#content.text()
diff --git a/packages/logger-middleware/src/lib/logger.ts b/packages/logger-middleware/src/lib/logger.ts
index 88572a24d64..058b529fff9 100644
--- a/packages/logger-middleware/src/lib/logger.ts
+++ b/packages/logger-middleware/src/lib/logger.ts
@@ -43,7 +43,7 @@ export interface LoggerOptions {
  * Creates a middleware handler that logs various request/response info.
  *
  * @param options Options for the logger
- * @return The logger middleware
+ * @returns The logger middleware
  */
 export function logger(options: LoggerOptions = {}): Middleware {
   let { format = '[%date] %method %path %status %contentLength', log = console.log } = options
diff --git a/packages/method-override-middleware/src/lib/method-override.ts b/packages/method-override-middleware/src/lib/method-override.ts
index a03d3515bb4..893cb93d4e7 100644
--- a/packages/method-override-middleware/src/lib/method-override.ts
+++ b/packages/method-override-middleware/src/lib/method-override.ts
@@ -20,7 +20,7 @@ export interface MethodOverrideOptions {
  * some other middleware that provides `context.formData`.
  *
  * @param options Options for the method override middleware
- * @return A middleware that overrides `context.method` with the value of the method override field
+ * @returns A middleware that overrides `context.method` with the value of the method override field
  */
 export function methodOverride(options?: MethodOverrideOptions): Middleware {
   let fieldName = options?.fieldName ?? '_method'
diff --git a/packages/mime/src/lib/detect-mime-type.ts b/packages/mime/src/lib/detect-mime-type.ts
index 44f858e490e..4c2d6ed3f56 100644
--- a/packages/mime/src/lib/detect-mime-type.ts
+++ b/packages/mime/src/lib/detect-mime-type.ts
@@ -3,7 +3,7 @@ import { mimeTypes } from '../generated/mime-types.ts'
 /**
  * Detects the MIME type for a given file extension or filename.
  *
- * @param extension - The file extension (e.g. "txt", ".txt") or filename (e.g. "file.txt")
+ * @param extension The file extension (e.g. "txt", ".txt") or filename (e.g. "file.txt")
  * @returns The MIME type string, or undefined if not found
  *
  * @example
diff --git a/packages/multipart-parser/src/lib/multipart-request.ts b/packages/multipart-parser/src/lib/multipart-request.ts
index d69ec38c754..4e5cf475140 100644
--- a/packages/multipart-parser/src/lib/multipart-request.ts
+++ b/packages/multipart-parser/src/lib/multipart-request.ts
@@ -5,7 +5,7 @@ import { MultipartParseError, parseMultipartStream } from './multipart.ts'
  * Extracts the boundary string from a `multipart/*` content type.
  *
  * @param contentType The `Content-Type` header value from the request
- * @return The boundary string if found, or null if not present
+ * @returns The boundary string if found, or null if not present
  */
 export function getMultipartBoundary(contentType: string): string | null {
   let match = /boundary=(?:"([^"]+)"|([^;]+))/i.exec(contentType)
@@ -16,7 +16,7 @@ export function getMultipartBoundary(contentType: string): string | null {
  * Returns true if the given request contains multipart data.
  *
  * @param request The `Request` object to check
- * @return `true` if the request is a multipart request, `false` otherwise
+ * @returns `true` if the request is a multipart request, `false` otherwise
  */
 export function isMultipartRequest(request: Request): boolean {
   let contentType = request.headers.get('Content-Type')
@@ -29,7 +29,7 @@ export function isMultipartRequest(request: Request): boolean {
  *
  * @param request The `Request` object containing multipart data
  * @param options Optional parser options, such as `maxHeaderSize` and `maxFileSize`
- * @return An async generator yielding `MultipartPart` objects
+ * @returns An async generator yielding `MultipartPart` objects
  */
 export async function* parseMultipartRequest(
   request: Request,
diff --git a/packages/multipart-parser/src/lib/multipart.node.ts b/packages/multipart-parser/src/lib/multipart.node.ts
index a90b6c65396..ef2528e1c55 100644
--- a/packages/multipart-parser/src/lib/multipart.node.ts
+++ b/packages/multipart-parser/src/lib/multipart.node.ts
@@ -17,7 +17,7 @@ import { getMultipartBoundary } from './multipart-request.ts'
  *
  * @param message The multipart message as a `Buffer` or an iterable of `Buffer` chunks
  * @param options Options for the parser
- * @return A generator yielding `MultipartPart` objects
+ * @returns A generator yielding `MultipartPart` objects
  */
 export function* parseMultipart(
   message: Buffer | Iterable<Buffer>,
@@ -34,7 +34,7 @@ export function* parseMultipart(
  *
  * @param stream A Node.js `Readable` stream containing multipart data
  * @param options Options for the parser
- * @return An async generator yielding `MultipartPart` objects
+ * @returns An async generator yielding `MultipartPart` objects
  */
 export async function* parseMultipartStream(
   stream: Readable,
@@ -47,7 +47,7 @@ export async function* parseMultipartStream(
  * Returns true if the given request is a multipart request.
  *
  * @param req The Node.js `http.IncomingMessage` object to check
- * @return `true` if the request is a multipart request, `false` otherwise
+ * @returns `true` if the request is a multipart request, `false` otherwise
  */
 export function isMultipartRequest(req: http.IncomingMessage): boolean {
   let contentType = req.headers['content-type']
@@ -59,7 +59,7 @@ export function isMultipartRequest(req: http.IncomingMessage): boolean {
  *
  * @param req The Node.js `http.IncomingMessage` object containing multipart data
  * @param options Options for the parser
- * @return An async generator yielding `MultipartPart` objects
+ * @returns An async generator yielding `MultipartPart` objects
  */
 export async function* parseMultipartRequest(
   req: http.IncomingMessage,
diff --git a/packages/multipart-parser/src/lib/multipart.ts b/packages/multipart-parser/src/lib/multipart.ts
index 84c09f038f1..ff92e8703df 100644
--- a/packages/multipart-parser/src/lib/multipart.ts
+++ b/packages/multipart-parser/src/lib/multipart.ts
@@ -80,7 +80,7 @@ export interface ParseMultipartOptions {
  *
  * @param message The multipart message as a `Uint8Array` or an iterable of `Uint8Array` chunks
  * @param options Options for the parser
- * @return A generator that yields `MultipartPart` objects
+ * @returns A generator that yields `MultipartPart` objects
  */
 export function* parseMultipart(
   message: Uint8Array | Iterable<Uint8Array>,
@@ -114,7 +114,7 @@ export function* parseMultipart(
  *
  * @param stream A stream containing multipart data as a `ReadableStream<Uint8Array>`
  * @param options Options for the parser
- * @return An async generator that yields `MultipartPart` objects
+ * @returns An async generator that yields `MultipartPart` objects
  */
 export async function* parseMultipartStream(
   stream: ReadableStream<Uint8Array>,
@@ -191,7 +191,7 @@ export class MultipartParser {
    * Write a chunk of data to the parser.
    *
    * @param chunk A chunk of data to write to the parser
-   * @return A generator yielding `MultipartPart` objects as they are parsed
+   * @returns A generator yielding `MultipartPart` objects as they are parsed
    */
   *write(chunk: Uint8Array): Generator<MultipartPart, void, unknown> {
     if (this.#state === MultipartParserStateDone) {
@@ -321,7 +321,7 @@ export class MultipartParser {
    * Note: This will throw if the multipart message is incomplete or
    * wasn't properly terminated.
    *
-   * @return void
+   * @returns void
    */
   finish(): void {
     if (this.#state !== MultipartParserStateDone) {
diff --git a/packages/node-fetch-server/src/lib/fetch-handler.ts b/packages/node-fetch-server/src/lib/fetch-handler.ts
index 7fb064f2804..7553d8d340f 100644
--- a/packages/node-fetch-server/src/lib/fetch-handler.ts
+++ b/packages/node-fetch-server/src/lib/fetch-handler.ts
@@ -29,7 +29,7 @@ export interface ClientAddress {
  * [MDN `Response` Reference](https://developer.mozilla.org/en-US/docs/Web/API/Response)
  *
  * @param error The error that was thrown
- * @return A response to send to the client, or `undefined` for the default error response
+ * @returns A response to send to the client, or `undefined` for the default error response
  */
 export interface ErrorHandler {
   (error: unknown): void | Response | Promise<void | Response>
@@ -44,7 +44,7 @@ export interface ErrorHandler {
  *
  * @param request The incoming request
  * @param client Information about the client that sent the request
- * @return A response to send to the client
+ * @returns A response to send to the client
  */
 export interface FetchHandler {
   (request: Request, client: ClientAddress): Response | Promise<Response>
diff --git a/packages/node-fetch-server/src/lib/request-listener.ts b/packages/node-fetch-server/src/lib/request-listener.ts
index 88df7f9731b..deb74f65533 100644
--- a/packages/node-fetch-server/src/lib/request-listener.ts
+++ b/packages/node-fetch-server/src/lib/request-listener.ts
@@ -60,7 +60,7 @@ export interface RequestListenerOptions {
  *
  * @param handler The fetch handler to use for processing incoming requests
  * @param options Request listener options
- * @return A Node.js request listener function
+ * @returns A Node.js request listener function
  */
 export function createRequestListener(
   handler: FetchHandler,
@@ -127,7 +127,7 @@ export type RequestOptions = Omit<RequestListenerOptions, 'onError'>
  * @param req The incoming request object
  * @param res The server response object
  * @param options Options for creating the request
- * @return A `Request` object
+ * @returns A `Request` object
  */
 export function createRequest(
   req: http.IncomingMessage | http2.Http2ServerRequest,
@@ -180,7 +180,7 @@ export function createRequest(
  * [`http.IncomingMessage`](https://nodejs.org/api/http.html#class-httpincomingmessage)/[`http2.Http2ServerRequest`](https://nodejs.org/api/http2.html#class-http2http2serverrequest).
  *
  * @param req The incoming request object
- * @return A `Headers` object
+ * @returns A `Headers` object
  */
 export function createHeaders(req: http.IncomingMessage | http2.Http2ServerRequest): Headers {
   let headers = new Headers()
diff --git a/packages/response/src/lib/file.ts b/packages/response/src/lib/file.ts
index 952090d6f32..d52c26d1842 100644
--- a/packages/response/src/lib/file.ts
+++ b/packages/response/src/lib/file.ts
@@ -5,7 +5,7 @@ import { isCompressibleMimeType } from '@remix-run/mime'
  * Custom function for computing file digests.
  *
  * @param file The file to hash
- * @return The computed digest as a string
+ * @returns The computed digest as a string
  *
  * @example
  * async (file) => {
@@ -81,7 +81,7 @@ export interface FileResponseOptions {
  * @param file The file to send
  * @param request The request object
  * @param options Configuration options
- * @return A `Response` object containing the file
+ * @returns A `Response` object containing the file
  *
  * @example
  * import { createFileResponse } from '@remix-run/response/file'
diff --git a/packages/response/src/lib/html.ts b/packages/response/src/lib/html.ts
index a8da68fd106..a697a711c61 100644
--- a/packages/response/src/lib/html.ts
+++ b/packages/response/src/lib/html.ts
@@ -10,7 +10,7 @@ type HtmlBody = string | SafeHtml | Blob | BufferSource | ReadableStream<Uint8Ar
  *
  * @param body The body of the response
  * @param init The `ResponseInit` object for the response
- * @return A `Response` object with a HTML body and the appropriate `Content-Type` header
+ * @returns A `Response` object with a HTML body and the appropriate `Content-Type` header
  */
 export function createHtmlResponse(body: HtmlBody, init?: ResponseInit): Response {
   let payload: BodyInit = ensureDoctype(body)
diff --git a/packages/route-pattern/src/lib/href.ts b/packages/route-pattern/src/lib/href.ts
index 250a6a0ff61..061388cb979 100644
--- a/packages/route-pattern/src/lib/href.ts
+++ b/packages/route-pattern/src/lib/href.ts
@@ -26,7 +26,7 @@ export class MissingParamError extends Error {
 /**
  * Create a reusable href builder function.
  *
- * @return A function that builds hrefs from patterns and parameters
+ * @returns A function that builds hrefs from patterns and parameters
  */
 export function createHrefBuilder<T extends string | RoutePattern = string>(): HrefBuilder<T> {
   return (pattern: string | RoutePattern, ...args: UnknownArgs) =>
@@ -123,7 +123,7 @@ export interface HrefBuilder<T extends string | RoutePattern = string> {
   /**
    * @param pattern The pattern to build an href for
    * @param args The parameters and optional search params
-   * @return The built href
+   * @returns The built href
    */
   <P extends string extends T ? string : SourceOf<T> | Variant<SourceOf<T>>>(
     pattern: P | RoutePattern<P>,
diff --git a/packages/route-pattern/src/lib/matcher.ts b/packages/route-pattern/src/lib/matcher.ts
index 999fdb043c7..8927480bf6d 100644
--- a/packages/route-pattern/src/lib/matcher.ts
+++ b/packages/route-pattern/src/lib/matcher.ts
@@ -15,14 +15,14 @@ export interface Matcher<data = unknown> {
    * Find the best match for a URL.
    *
    * @param url The URL to match
-   * @return The match result, or `null` if no match was found
+   * @returns The match result, or `null` if no match was found
    */
   match(url: string | URL): MatchResult<data> | null
   /**
    * Find all matches for a URL.
    *
    * @param url The URL to match
-   * @return A generator that yields all matches
+   * @returns A generator that yields all matches
    */
   matchAll(url: string | URL): Generator<MatchResult<data>>
   /**
diff --git a/packages/route-pattern/src/lib/matchers/array.ts b/packages/route-pattern/src/lib/matchers/array.ts
index 5c1fb6e5257..9d67a1794e9 100644
--- a/packages/route-pattern/src/lib/matchers/array.ts
+++ b/packages/route-pattern/src/lib/matchers/array.ts
@@ -26,7 +26,7 @@ export class ArrayMatcher<data = unknown> implements Matcher<data> {
 
   /**
    * @param url The URL to match
-   * @return The match result, or `null` if no match was found
+   * @returns The match result, or `null` if no match was found
    */
   match(url: string | URL): MatchResult<data> | null {
     if (typeof url === 'string') url = new URL(url)
@@ -43,7 +43,7 @@ export class ArrayMatcher<data = unknown> implements Matcher<data> {
 
   /**
    * @param url The URL to match
-   * @return A generator that yields all matches
+   * @returns A generator that yields all matches
    */
   *matchAll(url: string | URL): Generator<MatchResult<data>> {
     if (typeof url === 'string') url = new URL(url)
diff --git a/packages/route-pattern/src/lib/matchers/trie.ts b/packages/route-pattern/src/lib/matchers/trie.ts
index 6e3fd4ce1dc..bb7efba899d 100644
--- a/packages/route-pattern/src/lib/matchers/trie.ts
+++ b/packages/route-pattern/src/lib/matchers/trie.ts
@@ -297,7 +297,7 @@ export class TrieMatcher<data = unknown> implements Matcher<data> {
    * Find the best match for a URL.
    *
    * @param url The URL to match
-   * @return The match result, or `null` if no match was found
+   * @returns The match result, or `null` if no match was found
    */
   match(url: string | URL): MatchResult<data> | null {
     let urlObj = typeof url === 'string' ? new URL(url) : url
@@ -341,7 +341,7 @@ export class TrieMatcher<data = unknown> implements Matcher<data> {
    * Find all matches for a URL.
    *
    * @param url The URL to match
-   * @return A generator that yields all matches
+   * @returns A generator that yields all matches
    */
   *matchAll(url: string | URL): Generator<MatchResult<data>> {
     let urlObj = typeof url === 'string' ? new URL(url) : url
diff --git a/packages/route-pattern/src/lib/route-pattern.ts b/packages/route-pattern/src/lib/route-pattern.ts
index 408b5ce9883..8117879a933 100644
--- a/packages/route-pattern/src/lib/route-pattern.ts
+++ b/packages/route-pattern/src/lib/route-pattern.ts
@@ -41,7 +41,7 @@ export class RoutePattern<T extends string = string> {
    * Generate a href (URL) for this pattern.
    *
    * @param args The parameters and optional search params
-   * @return The href
+   * @returns The href
    */
   href(...args: HrefBuilderArgs<T>): string {
     return formatHref(this.#parsed, ...(args as any))
@@ -54,7 +54,7 @@ export class RoutePattern<T extends string = string> {
    * Note: The returned pattern will use the same options as this pattern.
    *
    * @param input The pattern to join with
-   * @return The joined pattern
+   * @returns The joined pattern
    */
   join<P extends string>(input: P | RoutePattern<P>): RoutePattern<Join<T, P>> {
     let parsedInput = parse(typeof input === 'string' ? input : input.source)
@@ -67,7 +67,7 @@ export class RoutePattern<T extends string = string> {
    * Match a URL against this pattern.
    *
    * @param url The URL to match
-   * @return The match result, or `null` if the URL doesn't match
+   * @returns The match result, or `null` if the URL doesn't match
    */
   match(url: URL | string): RouteMatch<T> | null {
     if (typeof url === 'string') url = new URL(url)
@@ -105,7 +105,7 @@ export class RoutePattern<T extends string = string> {
    * Test if a URL matches this pattern.
    *
    * @param url The URL to test
-   * @return `true` if the URL matches this pattern, `false` otherwise
+   * @returns `true` if the URL matches this pattern, `false` otherwise
    */
   test(url: URL | string): boolean {
     return this.match(url) !== null
diff --git a/packages/session-middleware/src/lib/session.ts b/packages/session-middleware/src/lib/session.ts
index 8b0fc0857e8..d1ee1b4c5df 100644
--- a/packages/session-middleware/src/lib/session.ts
+++ b/packages/session-middleware/src/lib/session.ts
@@ -7,7 +7,7 @@ import type { SessionStorage } from '@remix-run/session'
  *
  * @param sessionCookie The session cookie to use
  * @param sessionStorage The storage backend for session data
- * @return The session middleware
+ * @returns The session middleware
  */
 export function session(sessionCookie: Cookie, sessionStorage: SessionStorage): Middleware {
   if (!sessionCookie.signed) {
diff --git a/packages/session/src/lib/session-storage.ts b/packages/session/src/lib/session-storage.ts
index d2b81880d37..a227e6a29f2 100644
--- a/packages/session/src/lib/session-storage.ts
+++ b/packages/session/src/lib/session-storage.ts
@@ -8,7 +8,7 @@ export interface SessionStorage {
    * Retrieve a new session from storage based on the session cookie.
    *
    * @param cookie The session cookie value, or `null` if no session cookie is available
-   * @return The session
+   * @returns The session
    */
   read(cookie: string | null): Promise<Session>
   /**
@@ -17,7 +17,7 @@ export interface SessionStorage {
    * Note: If no session cookie should be set, this method returns `null`.
    *
    * @param session The session to save
-   * @return The session cookie value, or `null` if no session cookie should be set
+   * @returns The session cookie value, or `null` if no session cookie should be set
    */
   save(session: Session): Promise<string | null>
 }
diff --git a/packages/session/src/lib/session.ts b/packages/session/src/lib/session.ts
index 85ff2a7ccff..252d73658df 100644
--- a/packages/session/src/lib/session.ts
+++ b/packages/session/src/lib/session.ts
@@ -95,7 +95,7 @@ export class Session<valueData extends Data = Data, flashData extends Data = Dat
    * Get a value from the session.
    *
    * @param key The key of the value to get
-   * @return The value for the given key
+   * @returns The value for the given key
    */
   get<key extends keyof valueData>(key: key): valueData[key] | undefined
   get<key extends keyof flashData>(key: key): flashData[key] | undefined
@@ -109,7 +109,7 @@ export class Session<valueData extends Data = Data, flashData extends Data = Dat
    * Check if a value is stored for the given key.
    *
    * @param key The key to check
-   * @return `true` if a value is stored for the given key, `false` otherwise
+   * @returns `true` if a value is stored for the given key, `false` otherwise
    */
   has(key: keyof valueData | keyof flashData): boolean {
     if (this.#destroyed) return false
@@ -180,7 +180,7 @@ function toMap<data extends Data>(data?: data): Map<keyof data, data[keyof data]
  *
  * @param id The ID of the session
  * @param initialData The initial data for the session
- * @return The new session
+ * @returns The new session
  */
 export function createSession<valueData extends Data = Data, flashData extends Data = Data>(
   id = createSessionId(),
@@ -192,7 +192,7 @@ export function createSession<valueData extends Data = Data, flashData extends D
 /**
  * Create a new cryptographically secure session ID.
  *
- * @return A new session ID
+ * @returns A new session ID
  */
 export function createSessionId(): string {
   return crypto.randomUUID()
diff --git a/packages/static-middleware/src/lib/static.ts b/packages/static-middleware/src/lib/static.ts
index 58d3241c943..e3b49775be0 100644
--- a/packages/static-middleware/src/lib/static.ts
+++ b/packages/static-middleware/src/lib/static.ts
@@ -9,7 +9,7 @@ import { generateDirectoryListing } from './directory-listing.ts'
 /**
  * Function that determines if HTTP Range requests should be supported for a given file.
  *
- * @param file - The File object being served
+ * @param file The File object being served
  * @returns true if range requests should be supported
  */
 export type AcceptRangesFunction = (file: File) => boolean
@@ -22,7 +22,7 @@ export interface StaticFilesOptions extends Omit<FileResponseOptions, 'acceptRan
    * Filter function to determine which files should be served.
    *
    * @param path The relative path being requested
-   * @return Whether to serve the file
+   * @returns Whether to serve the file
    */
   filter?: (path: string) => boolean
 
@@ -78,7 +78,7 @@ export interface StaticFilesOptions extends Omit<FileResponseOptions, 'acceptRan
  *
  * @param root The root directory to serve files from (absolute or relative to cwd)
  * @param options Configuration for file responses
- * @return The static files middleware
+ * @returns The static files middleware
  */
 export function staticFiles(root: string, options: StaticFilesOptions = {}): Middleware {
   // Ensure root is an absolute path
diff --git a/packages/tar-parser/src/lib/tar.ts b/packages/tar-parser/src/lib/tar.ts
index 799995cbeec..380e860d7a4 100644
--- a/packages/tar-parser/src/lib/tar.ts
+++ b/packages/tar-parser/src/lib/tar.ts
@@ -91,7 +91,7 @@ export interface ParseTarHeaderOptions {
  *
  * @param block The tar header block
  * @param options Options that control how the header is parsed
- * @return The parsed tar header
+ * @returns The parsed tar header
  */
 export function parseTarHeader(block: Uint8Array, options?: ParseTarHeaderOptions): TarHeader {
   if (block.length !== TarBlockSize) {
@@ -187,7 +187,7 @@ export type ParseTarOptions = ParseTarHeaderOptions
  *
  * @param archive The tar archive source data
  * @param handler A function to call for each entry in the archive
- * @return A promise that resolves when the parse is finished
+ * @returns A promise that resolves when the parse is finished
  */
 export async function parseTar(archive: TarArchiveSource, handler: TarEntryHandler): Promise<void>
 export async function parseTar(
@@ -245,7 +245,7 @@ export class TarParser {
    *
    * @param archive The tar archive source data
    * @param handler A function to call for each entry in the archive
-   * @return A promise that resolves when the parse is finished
+   * @returns A promise that resolves when the parse is finished
    */
   async parse(archive: TarArchiveSource, handler: TarEntryHandler): Promise<void> {
     this.#reset()
@@ -468,7 +468,7 @@ export class TarEntry {
   /**
    * The content of this entry as an [`ArrayBuffer`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ArrayBuffer).
    *
-   * @return A promise that resolves to an `ArrayBuffer`
+   * @returns A promise that resolves to an `ArrayBuffer`
    */
   async arrayBuffer(): Promise<ArrayBuffer> {
     return (await this.bytes()).buffer as ArrayBuffer
@@ -491,7 +491,7 @@ export class TarEntry {
   /**
    * The content of this entry buffered into a single typed array.
    *
-   * @return A promise that resolves to a `Uint8Array`
+   * @returns A promise that resolves to a `Uint8Array`
    */
   async bytes(): Promise<Uint8Array> {
     if (this.#bodyUsed) {
@@ -536,7 +536,7 @@ export class TarEntry {
    *
    * Note: Do not use this for binary data, use `await entry.bytes()` or stream `entry.body` directly instead.
    *
-   * @return A promise that resolves to the entry's content as a string
+   * @returns A promise that resolves to the entry's content as a string
    */
   async text(): Promise<string> {
     return new TextDecoder().decode(await this.bytes())
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index e8c25a30cdb..8c7ad0efc97 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -29,6 +29,9 @@ importers:
       eslint:
         specifier: ^9.33.0
         version: 9.33.0
+      eslint-plugin-jsdoc:
+        specifier: ^61.5.0
+        version: 61.5.0(eslint@9.33.0)
       eslint-plugin-prefer-let:
         specifier: ^4.0.0
         version: 4.0.0
@@ -1043,6 +1046,14 @@ packages:
   '@emnapi/runtime@1.4.3':
     resolution: {integrity: sha512-pBPWdu6MLKROBX05wSNKcNb++m5Er+KQ9QkB+WVM+pW2Kx9hoSrVTnu3BdkI5eBLZoKu/J6mW/B6i6bJB2ytXQ==}
 
+  '@es-joy/jsdoccomment@0.76.0':
+    resolution: {integrity: sha512-g+RihtzFgGTx2WYCuTHbdOXJeAlGnROws0TeALx9ow/ZmOROOZkVg5wp/B44n0WJgI4SQFP1eWM2iRPlU2Y14w==}
+    engines: {node: '>=20.11.0'}
+
+  '@es-joy/resolve.exports@1.2.0':
+    resolution: {integrity: sha512-Q9hjxWI5xBM+qW2enxfe8wDKdFWMfd0Z29k5ZJnuBqD/CasY5Zryj09aCA6owbGATWz+39p5uIdaHXpopOcG8g==}
+    engines: {node: '>=10'}
+
   '@esbuild/aix-ppc64@0.25.10':
     resolution: {integrity: sha512-0NFWnA+7l41irNuaSVlLfgNT12caWJVLzp5eAVhZ0z1qpxbockccEt3s+149rE64VUI3Ml2zt8Nv5JVc4QXTsw==}
     engines: {node: '>=18'}
@@ -2037,6 +2048,10 @@ packages:
   '@shikijs/vscode-textmate@10.0.2':
     resolution: {integrity: sha512-83yeghZ2xxin3Nj8z1NMd/NCuca+gsYXswywDy5bHvwlWL8tpTQmzGeUuHd9FC3E/SBEMvzJRwWEOz5gGes9Qg==}
 
+  '@sindresorhus/base62@1.0.0':
+    resolution: {integrity: sha512-TeheYy0ILzBEI/CO55CP6zJCSdSWeRtGnHy8U8dWSUH4I68iqTsy7HkMktR4xakThc9jotkPQUXT4ITdbV7cHA==}
+    engines: {node: '>=18'}
+
   '@sindresorhus/is@7.1.1':
     resolution: {integrity: sha512-rO92VvpgMc3kfiTjGT52LEtJ8Yc5kCWhZjLQ3LwlA4pSgPpQO7bVpYXParOD8Jwf+cVQECJo3yP/4I8aZtUQTQ==}
     engines: {node: '>=18'}
@@ -2180,6 +2195,10 @@ packages:
     resolution: {integrity: sha512-ETdbFlgbAmXHyFPwqUIYrfc12ArvpBhEVgGAxVYSwli26dn8Ko+lIo4Su9vI9ykTZdJn+vJprs/0eZU0YMAEQg==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
 
+  '@typescript-eslint/types@8.49.0':
+    resolution: {integrity: sha512-e9k/fneezorUo6WShlQpMxXh8/8wfyc+biu6tnAqA81oWrEic0k21RHzP9uqqpyBBeBKu4T+Bsjy9/b8u7obXQ==}
+    engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
+
   '@typescript-eslint/typescript-estree@8.40.0':
     resolution: {integrity: sha512-k1z9+GJReVVOkc1WfVKs1vBrR5MIKKbdAjDTPvIK3L8De6KbFfPFt6BKpdkdk7rZS2GtC/m6yI5MYX+UsuvVYQ==}
     engines: {node: ^18.18.0 || ^20.9.0 || >=21.1.0}
@@ -2376,6 +2395,10 @@ packages:
   arch@2.2.0:
     resolution: {integrity: sha512-Of/R0wqp83cgHozfIYLbBMnej79U/SVGOOyuB3VVFv1NRM/PSFMK12x9KVtiYzJqmnU5WR2qp0Z5rHb7sWGnFQ==}
 
+  are-docs-informative@0.0.2:
+    resolution: {integrity: sha512-ixiS0nLNNG5jNQzgZJNoUpBKdo9yTYZMGJ+QgT2jmjR7G7+QHRCc4v6LQ3NgE7EBJq+o0ams3waJwkrlBom8Ig==}
+    engines: {node: '>=14'}
+
   arg@5.0.2:
     resolution: {integrity: sha512-PYjyFOLKQ9y57JvQ6QLo8dAgNqswh8M1RMJYdQduT6xbWSgK36P/Z/v+p888pM69jMMfS8Xd8F6I1kQ/I9HUGg==}
 
@@ -2525,6 +2548,10 @@ packages:
     resolution: {integrity: sha512-1rXeuUUiGGrykh+CeBdu5Ie7OJwinCgQY0bc7GCRxy5xVHy+moaqkpL/jqQq0MtQOeYcrqEz4abc5f0KtU7W4A==}
     engines: {node: '>=12.5.0'}
 
+  comment-parser@1.4.1:
+    resolution: {integrity: sha512-buhp5kePrmda3vhc5B9t7pUQXAb2Tnd0qgpkIhPhkHXxJpiPJ11H0ZEU0oBpJ2QztSbzG/ZxMj/CHsYJqRHmyg==}
+    engines: {node: '>= 12.0.0'}
+
   compressible@2.0.18:
     resolution: {integrity: sha512-AF3r7P5dWxL8MxyITRMlORQNaOA2IkAFaTr4k7BUumjPtRpGDTZpl0Pb1XCO6JeDCBdp126Cgs9sMxqSjgYyRg==}
     engines: {node: '>= 0.6'}
@@ -2599,6 +2626,15 @@ packages:
       supports-color:
         optional: true
 
+  debug@4.4.3:
+    resolution: {integrity: sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==}
+    engines: {node: '>=6.0'}
+    peerDependencies:
+      supports-color: '*'
+    peerDependenciesMeta:
+      supports-color:
+        optional: true
+
   deep-eql@5.0.2:
     resolution: {integrity: sha512-h5k/5U50IJJFpzfL6nO9jaaumfjO/f2NjK/oYB2Djzm4p9L+3T9qWpZqZ2hAbLPuuYq9wrU08WQyBTL5GbPk5Q==}
     engines: {node: '>=6'}
@@ -2707,6 +2743,12 @@ packages:
     resolution: {integrity: sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==}
     engines: {node: '>=10'}
 
+  eslint-plugin-jsdoc@61.5.0:
+    resolution: {integrity: sha512-PR81eOGq4S7diVnV9xzFSBE4CDENRQGP0Lckkek8AdHtbj+6Bm0cItwlFnxsLFriJHspiE3mpu8U20eODyToIg==}
+    engines: {node: '>=20.11.0'}
+    peerDependencies:
+      eslint: ^7.0.0 || ^8.0.0 || ^9.0.0
+
   eslint-plugin-prefer-let@4.0.0:
     resolution: {integrity: sha512-X4ep5PMO1320HKaNC9DM5+p6XvOhwv+RcqGjhv3aiw9iAtHhiFtdIUB5l0Zya0iM22ys2BGKzrNI9Xpw/ZHooQ==}
     engines: {node: '>=0.10.0'}
@@ -2943,6 +2985,9 @@ packages:
     resolution: {integrity: sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==}
     engines: {node: '>= 0.4'}
 
+  html-entities@2.6.0:
+    resolution: {integrity: sha512-kig+rMn/QOVRvr7c86gQ8lWXq+Hkv6CbAH1hLu+RG338StTpE8Z0b44SDVaqVu7HGKf27frdmUYEs9hTUX/cLQ==}
+
   http-errors@2.0.0:
     resolution: {integrity: sha512-FtwrG/euBzaEjYeRqOgly7G0qviiXoJWnvEH2Z1plBdXgbyjv34pHTSb9zoeHMyDy33+DWy5Wt9Wo+TURtOYSQ==}
     engines: {node: '>= 0.8'}
@@ -3047,6 +3092,10 @@ packages:
     resolution: {integrity: sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==}
     hasBin: true
 
+  jsdoc-type-pratt-parser@6.10.0:
+    resolution: {integrity: sha512-+LexoTRyYui5iOhJGn13N9ZazL23nAHGkXsa1p/C8yeq79WRfLBag6ZZ0FQG2aRoc9yfo59JT9EYCQonOkHKkQ==}
+    engines: {node: '>=20.0.0'}
+
   json-buffer@3.0.1:
     resolution: {integrity: sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==}
 
@@ -3250,6 +3299,9 @@ packages:
     resolution: {integrity: sha512-S48WzZW777zhNIrn7gxOlISNAqi9ZC/uQFnRdbeIHhZhCA6UqpkOT8T1G7BvfdgP4Er8gF4sUbaS0i7QvIfCWw==}
     engines: {node: '>=8'}
 
+  object-deep-merge@2.0.0:
+    resolution: {integrity: sha512-3DC3UMpeffLTHiuXSy/UG4NOIYTLlY9u3V82+djSCLYClWobZiS4ivYzpIUWrRY/nfsJ8cWsKyG3QfyLePmhvg==}
+
   object-inspect@1.13.2:
     resolution: {integrity: sha512-IRZSRuzJiynemAXPYtPe5BoI/RESNYR7TYm50MC5Mqbd3Jmw5y790sErYw3V6SryFJD64b74qQQs9wn5Bg/k3g==}
     engines: {node: '>= 0.4'}
@@ -3297,6 +3349,12 @@ packages:
     resolution: {integrity: sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==}
     engines: {node: '>=6'}
 
+  parse-imports-exports@0.2.4:
+    resolution: {integrity: sha512-4s6vd6dx1AotCx/RCI2m7t7GCh5bDRUtGNvRfHSP2wbBQdMi67pPe7mtzmgwcaQ8VKK/6IB7Glfyu3qdZJPybQ==}
+
+  parse-statements@1.0.11:
+    resolution: {integrity: sha512-HlsyYdMBnbPQ9Jr/VgJ1YF4scnldvJpJxCVx6KgqPL4dxppsWrJHCIIxQXMJrqGnsRkNPATbeMJ8Yxu7JMsYcA==}
+
   parseurl@1.3.3:
     resolution: {integrity: sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==}
     engines: {node: '>= 0.8'}
@@ -3460,6 +3518,10 @@ packages:
     resolution: {integrity: sha512-L9jEkOi3ASd9PYit2cwRfyppc9NoABujTP8/5gFcbERmo5jUoAKovIC3fsF17pkTnGsrByysqX+Kxd2OTNI1ww==}
     engines: {node: '>=0.10.5'}
 
+  reserved-identifiers@1.2.0:
+    resolution: {integrity: sha512-yE7KUfFvaBFzGPs5H3Ops1RevfUEsDc5Iz65rOwWg4lE8HJSYtle77uul3+573457oHvBKuHYDl/xqUkKpEEdw==}
+    engines: {node: '>=18'}
+
   resolve-from@4.0.0:
     resolution: {integrity: sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==}
     engines: {node: '>=4'}
@@ -3507,6 +3569,11 @@ packages:
     engines: {node: '>=10'}
     hasBin: true
 
+  semver@7.7.3:
+    resolution: {integrity: sha512-SdsKMrI9TdgjdweUSR9MweHA4EJ8YxHn8DFaDisvhVlUOe4BF1tLD7GAj0lIqWVl+dPb/rExr0Btby5loQm20Q==}
+    engines: {node: '>=10'}
+    hasBin: true
+
   send@0.18.0:
     resolution: {integrity: sha512-qqWzuOjSFOuqPjFe4NOsMLafToQQwBSOEpS+FwEt3A2V3vKubTquT3vmLTQpFgMXp8AlFWFuP1qKaJZOtPpVXg==}
     engines: {node: '>= 0.8.0'}
@@ -3575,6 +3642,15 @@ packages:
     resolution: {integrity: sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==}
     engines: {node: '>=0.10.0'}
 
+  spdx-exceptions@2.5.0:
+    resolution: {integrity: sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==}
+
+  spdx-expression-parse@4.0.0:
+    resolution: {integrity: sha512-Clya5JIij/7C6bRR22+tnGXbc4VKlibKSVj2iHvVeX5iMW7s1SIQlqu699JkODJJIhh/pUu8L0/VLh8xflD+LQ==}
+
+  spdx-license-ids@3.0.22:
+    resolution: {integrity: sha512-4PRT4nh1EImPbt2jASOKHX7PB7I+e4IWNLvkKFDxNhJlfjbYlleYQh285Z/3mPTHSAK/AvdMmw5BNNuYH8ShgQ==}
+
   split2@3.2.2:
     resolution: {integrity: sha512-9NThjpgZnifTkJpzTZ7Eue85S49QwpNhZTq6GRJwObb6jnLFNGB7Qm73V5HewTROPyxD0C29xqmaI68bQtV+hg==}
 
@@ -3708,6 +3784,10 @@ packages:
     resolution: {integrity: sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==}
     engines: {node: '>=8.0'}
 
+  to-valid-identifier@1.0.0:
+    resolution: {integrity: sha512-41wJyvKep3yT2tyPqX/4blcfybknGB4D+oETKLs7Q76UiPqRpUJK3hr1nxelyYO0PHKVzJwlu0aCeEAsGI6rpw==}
+    engines: {node: '>=20'}
+
   toidentifier@1.0.1:
     resolution: {integrity: sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==}
     engines: {node: '>=0.6'}
@@ -4148,6 +4228,16 @@ snapshots:
       tslib: 2.7.0
     optional: true
 
+  '@es-joy/jsdoccomment@0.76.0':
+    dependencies:
+      '@types/estree': 1.0.8
+      '@typescript-eslint/types': 8.49.0
+      comment-parser: 1.4.1
+      esquery: 1.6.0
+      jsdoc-type-pratt-parser: 6.10.0
+
+  '@es-joy/resolve.exports@1.2.0': {}
+
   '@esbuild/aix-ppc64@0.25.10':
     optional: true
 
@@ -4774,6 +4864,8 @@ snapshots:
 
   '@shikijs/vscode-textmate@10.0.2': {}
 
+  '@sindresorhus/base62@1.0.0': {}
+
   '@sindresorhus/is@7.1.1': {}
 
   '@speed-highlight/core@1.2.12': {}
@@ -4954,6 +5046,8 @@ snapshots:
 
   '@typescript-eslint/types@8.40.0': {}
 
+  '@typescript-eslint/types@8.49.0': {}
+
   '@typescript-eslint/typescript-estree@8.40.0(typescript@5.9.3)':
     dependencies:
       '@typescript-eslint/project-service': 8.40.0(typescript@5.9.3)
@@ -5184,6 +5278,8 @@ snapshots:
 
   arch@2.2.0: {}
 
+  are-docs-informative@0.0.2: {}
+
   arg@5.0.2: {}
 
   argparse@1.0.10:
@@ -5353,6 +5449,8 @@ snapshots:
       color-convert: 2.0.1
       color-string: 1.9.1
 
+  comment-parser@1.4.1: {}
+
   compressible@2.0.18:
     dependencies:
       mime-db: 1.54.0
@@ -5420,6 +5518,10 @@ snapshots:
     dependencies:
       ms: 2.1.3
 
+  debug@4.4.3:
+    dependencies:
+      ms: 2.1.3
+
   deep-eql@5.0.2: {}
 
   deep-extend@0.6.0: {}
@@ -5598,6 +5700,26 @@ snapshots:
 
   escape-string-regexp@4.0.0: {}
 
+  eslint-plugin-jsdoc@61.5.0(eslint@9.33.0):
+    dependencies:
+      '@es-joy/jsdoccomment': 0.76.0
+      '@es-joy/resolve.exports': 1.2.0
+      are-docs-informative: 0.0.2
+      comment-parser: 1.4.1
+      debug: 4.4.3
+      escape-string-regexp: 4.0.0
+      eslint: 9.33.0
+      espree: 10.4.0
+      esquery: 1.6.0
+      html-entities: 2.6.0
+      object-deep-merge: 2.0.0
+      parse-imports-exports: 0.2.4
+      semver: 7.7.3
+      spdx-expression-parse: 4.0.0
+      to-valid-identifier: 1.0.0
+    transitivePeerDependencies:
+      - supports-color
+
   eslint-plugin-prefer-let@4.0.0:
     dependencies:
       requireindex: 1.2.0
@@ -5893,6 +6015,8 @@ snapshots:
     dependencies:
       function-bind: 1.1.2
 
+  html-entities@2.6.0: {}
+
   http-errors@2.0.0:
     dependencies:
       depd: 2.0.0
@@ -5973,6 +6097,8 @@ snapshots:
     dependencies:
       argparse: 2.0.1
 
+  jsdoc-type-pratt-parser@6.10.0: {}
+
   json-buffer@3.0.1: {}
 
   json-schema-traverse@0.4.1: {}
@@ -6150,6 +6276,8 @@ snapshots:
     dependencies:
       path-key: 3.1.1
 
+  object-deep-merge@2.0.0: {}
+
   object-inspect@1.13.2: {}
 
   obug@2.1.1: {}
@@ -6195,6 +6323,12 @@ snapshots:
     dependencies:
       callsites: 3.1.0
 
+  parse-imports-exports@0.2.4:
+    dependencies:
+      parse-statements: 1.0.11
+
+  parse-statements@1.0.11: {}
+
   parseurl@1.3.3: {}
 
   path-exists@4.0.0: {}
@@ -6341,6 +6475,8 @@ snapshots:
 
   requireindex@1.2.0: {}
 
+  reserved-identifiers@1.2.0: {}
+
   resolve-from@4.0.0: {}
 
   resolve-pkg-maps@1.0.0: {}
@@ -6401,6 +6537,8 @@ snapshots:
 
   semver@7.6.3: {}
 
+  semver@7.7.3: {}
+
   send@0.18.0:
     dependencies:
       debug: 2.6.9
@@ -6526,6 +6664,15 @@ snapshots:
 
   source-map@0.6.1: {}
 
+  spdx-exceptions@2.5.0: {}
+
+  spdx-expression-parse@4.0.0:
+    dependencies:
+      spdx-exceptions: 2.5.0
+      spdx-license-ids: 3.0.22
+
+  spdx-license-ids@3.0.22: {}
+
   split2@3.2.2:
     dependencies:
       readable-stream: 3.6.2
@@ -6652,6 +6799,11 @@ snapshots:
     dependencies:
       is-number: 7.0.0
 
+  to-valid-identifier@1.0.0:
+    dependencies:
+      '@sindresorhus/base62': 1.0.0
+      reserved-identifiers: 1.2.0
+
   toidentifier@1.0.1: {}
 
   totalist@3.0.1: {}