remix 3.0.0-beta.4 → 3.0.0-beta.5

package/dist/ui/accordion/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/accordion/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/accordion/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/accordion/primitives.ts"],"names":[],"mappings":"AACA,cAAc,oCAAoC,CAAA"}

package/dist/ui/accordion/primitives.js

@@ -0,0 +1,2 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/accordion/primitives';

package/dist/ui/button.d.ts

@@ -1,2 +1,3 @@
 export * from '@remix-run/ui/button';
+export { default } from '@remix-run/ui/button';
 //# sourceMappingURL=button.d.ts.map

package/dist/ui/button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/ui/button.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"button.d.ts","sourceRoot":"","sources":["../../src/ui/button.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/ui/button.js

@@ -1,2 +1,3 @@
 // IMPORTANT: This file is auto-generated, please do not edit manually.
 export * from '@remix-run/ui/button';
+export { default } from '@remix-run/ui/button';

package/dist/ui/checkbox.d.ts

@@ -0,0 +1,3 @@
+export * from '@remix-run/ui/checkbox';
+export { default } from '@remix-run/ui/checkbox';
+//# sourceMappingURL=checkbox.d.ts.map

package/dist/ui/checkbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkbox.d.ts","sourceRoot":"","sources":["../../src/ui/checkbox.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAA;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA"}

package/dist/ui/checkbox.js

@@ -0,0 +1,3 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/checkbox';
+export { default } from '@remix-run/ui/checkbox';

package/dist/ui/combobox/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/combobox/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/combobox/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/combobox/primitives.ts"],"names":[],"mappings":"AACA,cAAc,mCAAmC,CAAA"}

package/dist/ui/combobox/primitives.js

@@ -0,0 +1,2 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/combobox/primitives';

package/dist/ui/input.d.ts

@@ -0,0 +1,3 @@
+export * from '@remix-run/ui/input';
+export { default } from '@remix-run/ui/input';
+//# sourceMappingURL=input.d.ts.map

package/dist/ui/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../../src/ui/input.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/ui/input.js

@@ -0,0 +1,3 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/input';
+export { default } from '@remix-run/ui/input';

package/dist/ui/menu/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/menu/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/menu/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/menu/primitives.ts"],"names":[],"mappings":"AACA,cAAc,+BAA+B,CAAA"}

package/dist/ui/{glyph.js → menu/primitives.js}

@@ -1,2 +1,2 @@
 // IMPORTANT: This file is auto-generated, please do not edit manually.
-export * from '@remix-run/ui/glyph';
+export * from '@remix-run/ui/menu/primitives';

package/dist/ui/radio.d.ts

@@ -0,0 +1,3 @@
+export * from '@remix-run/ui/radio';
+export { default } from '@remix-run/ui/radio';
+//# sourceMappingURL=radio.d.ts.map

package/dist/ui/radio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radio.d.ts","sourceRoot":"","sources":["../../src/ui/radio.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/ui/radio.js

@@ -0,0 +1,3 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/radio';
+export { default } from '@remix-run/ui/radio';

package/dist/ui/select/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/select/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/select/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/select/primitives.ts"],"names":[],"mappings":"AACA,cAAc,iCAAiC,CAAA"}

package/dist/ui/select/primitives.js

@@ -0,0 +1,2 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/select/primitives';

package/dist/ui/tabs/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/tabs/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/tabs/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/tabs/primitives.ts"],"names":[],"mappings":"AACA,cAAc,+BAA+B,CAAA"}

package/dist/ui/{theme.js → tabs/primitives.js}

@@ -1,2 +1,2 @@
 // IMPORTANT: This file is auto-generated, please do not edit manually.
-export * from '@remix-run/ui/theme';
+export * from '@remix-run/ui/tabs/primitives';

package/dist/ui/tabs.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/tabs';
+//# sourceMappingURL=tabs.d.ts.map

package/dist/ui/tabs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tabs.d.ts","sourceRoot":"","sources":["../../src/ui/tabs.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAA"}

package/{src/ui/glyph.ts → dist/ui/tabs.js}

@@ -1,2 +1,2 @@
 // IMPORTANT: This file is auto-generated, please do not edit manually.
-export * from '@remix-run/ui/glyph'
+export * from '@remix-run/ui/tabs';

package/dist/ui/toggle/primitives.d.ts

@@ -0,0 +1,2 @@
+export * from '@remix-run/ui/toggle/primitives';
+//# sourceMappingURL=primitives.d.ts.map

package/dist/ui/toggle/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../../src/ui/toggle/primitives.ts"],"names":[],"mappings":"AACA,cAAc,iCAAiC,CAAA"}

package/dist/ui/toggle/primitives.js

@@ -0,0 +1,2 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/toggle/primitives';

package/dist/ui/toggle.d.ts

@@ -0,0 +1,3 @@
+export * from '@remix-run/ui/toggle';
+export { default } from '@remix-run/ui/toggle';
+//# sourceMappingURL=toggle.d.ts.map

package/dist/ui/toggle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toggle.d.ts","sourceRoot":"","sources":["../../src/ui/toggle.ts"],"names":[],"mappings":"AACA,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/ui/toggle.js

@@ -0,0 +1,3 @@
+// IMPORTANT: This file is auto-generated, please do not edit manually.
+export * from '@remix-run/ui/toggle';
+export { default } from '@remix-run/ui/toggle';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "remix",
-  "version": "3.0.0-beta.4",
+  "version": "3.0.0-beta.5",
   "description": "The Remix web framework",
   "author": "Michael Jackson <mjijackson@gmail.com>",
   "license": "MIT",
@@ -453,6 +453,10 @@
       "types": "./dist/ui/accordion.d.ts",
       "default": "./dist/ui/accordion.js"
     },
+    "./ui/accordion/primitives": {
+      "types": "./dist/ui/accordion/primitives.d.ts",
+      "default": "./dist/ui/accordion/primitives.js"
+    },
     "./ui/anchor": {
       "types": "./dist/ui/anchor.d.ts",
       "default": "./dist/ui/anchor.js"
@@ -469,13 +473,21 @@
       "types": "./dist/ui/button.d.ts",
       "default": "./dist/ui/button.js"
     },
+    "./ui/checkbox": {
+      "types": "./dist/ui/checkbox.d.ts",
+      "default": "./dist/ui/checkbox.js"
+    },
     "./ui/combobox": {
       "types": "./dist/ui/combobox.d.ts",
       "default": "./dist/ui/combobox.js"
     },
-    "./ui/glyph": {
-      "types": "./dist/ui/glyph.d.ts",
-      "default": "./dist/ui/glyph.js"
+    "./ui/combobox/primitives": {
+      "types": "./dist/ui/combobox/primitives.d.ts",
+      "default": "./dist/ui/combobox/primitives.js"
+    },
+    "./ui/input": {
+      "types": "./dist/ui/input.d.ts",
+      "default": "./dist/ui/input.js"
     },
     "./ui/jsx-dev-runtime": {
       "types": "./dist/ui/jsx-dev-runtime.d.ts",
@@ -493,33 +505,49 @@
       "types": "./dist/ui/menu.d.ts",
       "default": "./dist/ui/menu.js"
     },
+    "./ui/menu/primitives": {
+      "types": "./dist/ui/menu/primitives.d.ts",
+      "default": "./dist/ui/menu/primitives.js"
+    },
     "./ui/popover": {
       "types": "./dist/ui/popover.d.ts",
       "default": "./dist/ui/popover.js"
     },
-    "./ui/scroll-lock": {
-      "types": "./dist/ui/scroll-lock.d.ts",
-      "default": "./dist/ui/scroll-lock.js"
+    "./ui/radio": {
+      "types": "./dist/ui/radio.d.ts",
+      "default": "./dist/ui/radio.js"
     },
     "./ui/select": {
       "types": "./dist/ui/select.d.ts",
       "default": "./dist/ui/select.js"
     },
-    "./ui/separator": {
-      "types": "./dist/ui/separator.d.ts",
-      "default": "./dist/ui/separator.js"
+    "./ui/select/primitives": {
+      "types": "./dist/ui/select/primitives.d.ts",
+      "default": "./dist/ui/select/primitives.js"
     },
     "./ui/server": {
       "types": "./dist/ui/server.d.ts",
       "default": "./dist/ui/server.js"
     },
+    "./ui/tabs": {
+      "types": "./dist/ui/tabs.d.ts",
+      "default": "./dist/ui/tabs.js"
+    },
+    "./ui/tabs/primitives": {
+      "types": "./dist/ui/tabs/primitives.d.ts",
+      "default": "./dist/ui/tabs/primitives.js"
+    },
     "./ui/test": {
       "types": "./dist/ui/test.d.ts",
       "default": "./dist/ui/test.js"
     },
-    "./ui/theme": {
-      "types": "./dist/ui/theme.d.ts",
-      "default": "./dist/ui/theme.js"
+    "./ui/toggle": {
+      "types": "./dist/ui/toggle.d.ts",
+      "default": "./dist/ui/toggle.js"
+    },
+    "./ui/toggle/primitives": {
+      "types": "./dist/ui/toggle/primitives.d.ts",
+      "default": "./dist/ui/toggle/primitives.js"
     },
     "./package.json": "./package.json"
   },
@@ -529,50 +557,50 @@
     "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@remix-run/assets": "^0.4.3",
-    "@remix-run/auth": "^0.2.5",
-    "@remix-run/async-context-middleware": "^0.3.3",
-    "@remix-run/ui": "^0.3.0",
-    "@remix-run/compression-middleware": "^0.1.11",
-    "@remix-run/auth-middleware": "^0.2.3",
-    "@remix-run/cop-middleware": "^0.1.6",
-    "@remix-run/csrf-middleware": "^0.1.6",
-    "@remix-run/cors-middleware": "^0.1.6",
+    "@remix-run/assets": "^0.4.4",
+    "@remix-run/auth": "^0.2.6",
+    "@remix-run/async-context-middleware": "^0.3.4",
+    "@remix-run/auth-middleware": "^0.2.4",
+    "@remix-run/ui": "^0.4.0",
+    "@remix-run/compression-middleware": "^0.1.12",
+    "@remix-run/cop-middleware": "^0.1.7",
+    "@remix-run/cors-middleware": "^0.1.7",
+    "@remix-run/csrf-middleware": "^0.1.7",
+    "@remix-run/cookie": "^0.5.4",
     "@remix-run/data-schema": "^0.3.0",
     "@remix-run/data-table": "^0.3.0",
-    "@remix-run/cookie": "^0.5.4",
-    "@remix-run/data-table-postgres": "^0.4.0",
     "@remix-run/data-table-mysql": "^0.4.0",
     "@remix-run/data-table-sqlite": "^0.5.1",
-    "@remix-run/fetch-proxy": "^0.8.3",
-    "@remix-run/fetch-router": "^0.20.0",
-    "@remix-run/file-storage": "^0.13.6",
-    "@remix-run/form-data-middleware": "^0.3.3",
-    "@remix-run/file-storage-s3": "^0.1.3",
-    "@remix-run/headers": "^0.21.1",
-    "@remix-run/fs": "^0.4.5",
-    "@remix-run/form-data-parser": "^0.17.3",
+    "@remix-run/data-table-postgres": "^0.4.0",
+    "@remix-run/fetch-proxy": "^0.8.4",
+    "@remix-run/file-storage": "^0.13.7",
+    "@remix-run/form-data-middleware": "^0.3.4",
+    "@remix-run/file-storage-s3": "^0.1.4",
+    "@remix-run/fs": "^0.4.6",
+    "@remix-run/form-data-parser": "^0.17.4",
     "@remix-run/html-template": "^0.3.1",
-    "@remix-run/method-override-middleware": "^0.1.11",
-    "@remix-run/logger-middleware": "^0.3.3",
-    "@remix-run/mime": "^0.4.1",
+    "@remix-run/lazy-file": "^5.0.6",
+    "@remix-run/logger-middleware": "^0.3.4",
+    "@remix-run/fetch-router": "^0.20.1",
+    "@remix-run/method-override-middleware": "^0.1.12",
+    "@remix-run/mime": "^0.4.2",
+    "@remix-run/headers": "^0.21.1",
     "@remix-run/multipart-parser": "^0.16.3",
-    "@remix-run/lazy-file": "^5.0.5",
-    "@remix-run/node-fetch-server": "^0.13.3",
     "@remix-run/node-tsx": "^0.1.1",
-    "@remix-run/route-pattern": "^0.22.1",
-    "@remix-run/response": "^0.3.6",
+    "@remix-run/node-fetch-server": "^0.14.0",
+    "@remix-run/route-pattern": "^0.23.0",
     "@remix-run/session": "^0.4.2",
+    "@remix-run/response": "^0.3.7",
+    "@remix-run/session-middleware": "^0.3.4",
     "@remix-run/session-storage-redis": "^0.1.1",
-    "@remix-run/session-middleware": "^0.3.3",
+    "@remix-run/tar-parser": "^0.7.1",
     "@remix-run/session-storage-memcache": "^0.1.2",
-    "@remix-run/static-middleware": "^0.4.12",
+    "@remix-run/static-middleware": "^0.4.13",
     "@remix-run/assert": "^0.3.0",
-    "@remix-run/tar-parser": "^0.7.1",
-    "@remix-run/cli": "^0.3.3",
-    "@remix-run/test": "^0.5.0",
+    "@remix-run/cli": "^0.3.4",
     "@remix-run/terminal": "^0.1.1",
-    "@remix-run/render-middleware": "^0.1.3"
+    "@remix-run/test": "^0.5.0",
+    "@remix-run/render-middleware": "^0.1.4"
   },
   "bin": {
     "remix": "./dist/cli-entry.js"

package/src/data-table-mysql/README.md

@@ -79,6 +79,31 @@ try {
 }
 ```
 
+## Running integration tests locally
+
+To start a local MySQL container matching CI:
+
+```sh
+podman run --name mysql \
+  -e MYSQL_ROOT_PASSWORD=root \
+  -e MYSQL_DATABASE=remix \
+  -p 3306:3306 \
+  -d mysql:8
+```
+
+Then run:
+
+```sh
+REMIX_DATA_TABLE_MYSQL_TEST_URL=mysql://root:root@127.0.0.1:3306/remix \
+pnpm test src/lib/adapter.integration.test.ts
+```
+
+Remove the container when you are done:
+
+```sh
+podman rm -f mysql
+```
+
 ## Related Packages
 
 - [`data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table) - Core query/relations API

package/src/data-table-postgres/README.md

@@ -60,6 +60,32 @@ await db.transaction(async (txDb) => txDb.exec('select 1'), {
 })
 ```
 
+## Running integration tests locally
+
+To start a local Postgres container matching CI:
+
+```sh
+podman run --name postgres \
+  -e POSTGRES_USER=postgres \
+  -e POSTGRES_PASSWORD=postgres \
+  -e POSTGRES_DB=remix \
+  -p 5432:5432 \
+  -d postgres:16
+```
+
+Then run:
+
+```sh
+REMIX_DATA_TABLE_POSTGRES_TEST_URL=postgres://postgres:postgres@127.0.0.1:5432/remix \
+pnpm test src/lib/adapter.integration.test.ts
+```
+
+Remove the container when you are done:
+
+```sh
+podman rm -f postgres
+```
+
 ## Related Packages
 
 - [`data-table`](https://github.com/remix-run/remix/tree/main/packages/data-table) - Core query/relations API

package/src/form-data-parser/README.md

@@ -7,7 +7,7 @@ A streaming `multipart/form-data` parser that solves memory issues with file upl
 - **Drop-in replacement** for `request.formData()` with streaming file upload support
 - **Minimal buffering** - processes file upload streams with minimal memory footprint
 - **Standards-based** - built on the [web Streams API](https://developer.mozilla.org/en-US/docs/Web/API/Streams_API) and [File API](https://developer.mozilla.org/en-US/docs/Web/API/File)
-- **Smart fallback** - automatically uses native `request.formData()` for non-`multipart/form-data` requests
+- **Smart fallback** - parses `application/x-www-form-urlencoded` requests with the same total size and field count limits, and uses native `request.formData()` for other form requests
 - **Storage agnostic** - works with any storage backend (local disk, S3, R2, etc.)
 
 ## Why You Need This
@@ -74,7 +74,7 @@ async function requestHandler(request: Request) {
 
 To validate the resulting `FormData` object with `remix/data-schema`, use the `remix/data-schema/form-data` helpers.
 
-To limit the overall shape of multipart requests, use the `maxHeaderSize`, `maxFileSize`, `maxFiles`, `maxParts`, and `maxTotalSize` options. By default, `parseFormData()` uses `maxFiles = 20`, `maxParts = 1000`, and `maxTotalSize = maxFiles * maxFileSize + 1 MiB`.
+To limit the overall shape of multipart requests, use the `maxHeaderSize`, `maxFileSize`, `maxFiles`, `maxParts`, and `maxTotalSize` options. For `application/x-www-form-urlencoded` requests, `maxParts` limits the number of form fields and `maxTotalSize` limits the raw request body size. By default, `parseFormData()` uses `maxFiles = 20`, `maxParts = 1000`, and `maxTotalSize = maxFiles * maxFileSize + 1 MiB`.
 
 Known limit errors are thrown directly so you can handle them with `instanceof` checks. Other failures while parsing the request body are wrapped in `FormDataParseError`, with the original error available as `error.cause`. Errors thrown or rejected by your `uploadHandler` are not wrapped.
 
@@ -106,9 +106,9 @@ try {
   } else if (error instanceof MaxFileSizeExceededError) {
     console.error(`Files may not be larger than 10 MiB`)
   } else if (error instanceof MaxPartsExceededError) {
-    console.error(`Request may not contain more than 25 multipart parts`)
+    console.error(`Request may not contain more than 25 form fields or multipart parts`)
   } else if (error instanceof MaxTotalSizeExceededError) {
-    console.error(`Multipart request may not exceed 12 MiB of total content`)
+    console.error(`Form data request may not exceed 12 MiB of total content`)
   } else if (error instanceof FormDataParseError) {
     console.error(`Could not parse form data:`, error.cause ?? error)
   } else {

package/src/mime/README.md

@@ -86,12 +86,19 @@ mimeTypeToContentType('image/png') // 'image/png'
 Registers or overrides a MIME type for one or more file extensions.
 
 ```ts
-import { defineMimeType } from 'remix/mime'
+import { defineMimeType, detectMimeType } from 'remix/mime'
 
 defineMimeType({
   extensions: ['myformat'],
   mimeType: 'application/x-myformat',
 })
+
+defineMimeType({
+  extensions: ['be.pit'],
+  mimeType: 'application/x-be-pit-document',
+})
+
+detectMimeType('filename.be.pit') // 'application/x-be-pit-document'
 ```
 
 You can also optionally configure the charset and whether the MIME type is compressible:

package/src/node-fetch-server/README.md

@@ -8,7 +8,8 @@ Build Node.js servers with web-standard Fetch API primitives. `node-fetch-server
 - **Node.js HTTP Integration** - Works directly with `node:http`, `node:https`, and `node:http2`
 - **Streaming Support** - Response support with `ReadableStream`
 - **Custom Hostname** - Configuration for deployment flexibility
-- **Client Info** - Access to client connection info (IP address, port)
+- **Proxy Header Support** - Opt in to trusted `Forwarded`, `X-Forwarded-Host`, `X-Forwarded-Proto`, and `X-Forwarded-For` headers
+- **Client Info** - Access to client connection info (IP address, port, and trusted proxy address)
 - **TypeScript** - Full TypeScript support with type definitions
 
 ## Installation
@@ -146,9 +147,34 @@ let server = http.createServer(createRequestListener(handler, { host: hostname }
 server.listen(3000)
 ```
 
+### Trusted Proxy Headers
+
+If your app runs behind a trusted reverse proxy, Node.js sees the proxy connection instead of the original client connection. Enable `trustProxy` to use trusted proxy headers when constructing `request.url` and client information:
+
+- `Forwarded: proto` and `X-Forwarded-Proto` can provide the original request protocol.
+- `Forwarded: host` and `X-Forwarded-Host` can provide the original request host.
+- `Forwarded: for` and `X-Forwarded-For` can provide the original client address.
+
+Only enable this option when your server is reachable exclusively through a trusted proxy that overwrites these headers. Otherwise, clients can spoof the host, protocol, and client address.
+
+```ts
+import * as http from 'node:http'
+import { createRequestListener } from 'remix/node-fetch-server'
+
+let server = http.createServer(
+  createRequestListener(handler, {
+    trustProxy: true,
+  }),
+)
+
+server.listen(3000)
+```
+
+When `host` or `protocol` are set, those fixed options take precedence over trusted proxy headers.
+
 ### Accessing Client Information
 
-Get client connection details (IP address, port) for logging or security:
+Get client connection details (IP address, port) for logging or security. When `trustProxy` is enabled, `client.address` uses trusted `Forwarded` or `X-Forwarded-For` values when present:
 
 ```ts
 import { type FetchHandler } from 'remix/node-fetch-server'

package/src/route-pattern/README.md

@@ -65,6 +65,8 @@ createHref('http(s)://:region.cdn.com/assets/*file.:ext', {
 
 For in-depth reference, visit the [`route-pattern` API docs](https://api.remix.run/api/remix/route-pattern)
 
+Examples in this README use `remix/route-pattern/*` imports. The same APIs are also available from the direct package entrypoints: `@remix-run/route-pattern`, `@remix-run/route-pattern/href`, `@remix-run/route-pattern/match`, `@remix-run/route-pattern/join`, and `@remix-run/route-pattern/specificity`.
+
 ## Pattern syntax
 
 ### Protocol
@@ -149,6 +151,8 @@ docsMatcher.match(url)?.params
 // Type safe params     ^? { tenant: string | undefined, path: string, ext: string } | undefined
 ```
 
+Matchers accept absolute URL strings or `URL` objects. Relative strings such as `/blog/v3` are not accepted because matching uses the platform `URL` parser; wrap relative paths with a known origin before matching them.
+
 ### Match against multiple patterns
 
 Use `createMultiMatcher` when you need to match many patterns and attach your own data to each match.
@@ -172,17 +176,38 @@ matcher.match('https://example.com/api/v2/users/profile')
 
 The matched pattern is only known at runtime, so matched `params` are not inferred when matching with `createMultiMatcher`.
 
+Each match returns:
+
+- `url`: the `URL` object that was matched
+- `pattern`: the matched `RoutePattern`
+- `data`: the data attached with `matcher.add(pattern, data)`
+- `params`: captured param values
+- `paramsMeta`: hostname and pathname param metadata
+
+`paramsMeta.hostname` and `paramsMeta.pathname` are arrays of `{ type, name, value, begin, end }` entries. The offsets are measured after URL normalization. A pattern with no hostname matches any hostname, represented in `paramsMeta.hostname` as an unnamed wildcard entry.
+
+Set `ignoreCase: true` to make pathname matching case-insensitive. Hostname matching is always case-insensitive, and search constraints are always case-sensitive.
+
+```ts
+let matcher = createMatcher('/Docs/:slug', { ignoreCase: true })
+
+matcher.match('https://example.com/docs/Intro')?.params
+// { slug: 'Intro' }
+```
+
 ### Ranking matches by specificity
 
 When multiple patterns match the same URL, `route-pattern` chooses the most specific match deterministically. Matches are ranked left-to-right, character-by-character:
 
+- Explicit protocol and port constraints are more specific than omitted constraints.
+- Static hostnames are more specific than dynamic hostnames, which are more specific than omitted hostnames.
 - Static characters are more specific than variables.
 - Variables are more specific than wildcards.
 - Earliest difference decides the winner.
 
 This is the same ranking used by `createMultiMatcher`.
 
-For advanced use cases, `/specificity` provides comparison utilities: `lessThan`, `greaterThan`, `equal`, `descending`, `ascending`, `compare`. For example:
+For advanced use cases, `/specificity` provides comparison utilities: `lessThan`, `greaterThan`, `equal`, `descending`, `ascending`, `compare`. `lessThan(a, b)` returns `true` when match `a` is less specific than match `b`. For example:
 
 ```ts
 import { createMultiMatcher } from 'remix/route-pattern/match'
@@ -226,6 +251,10 @@ createHref('blog/:slug?ref=docs', { slug: 'v3' }, { utm_source: 'newsletter' })
 // '/blog/v3?utm_source=newsletter&ref=docs'
 ```
 
+`createHref()` throws `CreateHrefError` when it cannot safely generate an href. The error exposes stable structured details on `error.details`; the string message is for humans.
+
+Common failures include missing required params, nameless wildcards, invalid hostname params, empty pathname variables, and origin patterns that specify a protocol or port without a concrete hostname.
+
 **Note:** optional groups without params are included in the generated href:
 
 ```ts
@@ -238,25 +267,41 @@ createHref('products(.json)')
 
 ## Parse & stringify patterns
 
-You can explicitly parse and stringify patterns:
+You can explicitly parse and stringify patterns. Create a `RoutePattern` with `RoutePattern.parse` and use the methods and helpers below instead of reading parsed token internals.
 
 ```ts
-import { RoutePattern } from 'remix/route-pattern'
+import { getRoutePatternCaptures, RoutePattern } from 'remix/route-pattern'
 
-let pattern = RoutePattern.parse('://example.com/blog/:slug')
+let pattern = RoutePattern.parse('://:tenant.example.com/blog/:slug(/*path)')
 //  ^? RoutePattern
 
 pattern.toString()
-// '://example.com/blog/:slug'
+// '://:tenant.example.com/blog/:slug(/*path)'
 
 pattern.toJSON()
-// { hostname: 'example.com', pathname: 'blog/:slug', ... }
+// { hostname: ':tenant.example.com', pathname: 'blog/:slug(/*path)', ... }
+
+getRoutePatternCaptures(pattern)
+// [
+//   { part: 'hostname', type: ':', name: 'tenant', optional: false },
+//   { part: 'pathname', type: ':', name: 'slug', optional: false },
+//   { part: 'pathname', type: '*', name: 'path', optional: true },
+// ]
 ```
 
 All APIs that take a `pattern` arg accept `string` or a parsed `RoutePattern`.
 
 **TIP:** For high-performance scenarios, you can parse patterns ahead of time to avoid reparsing them on every call.
 
+`RoutePattern.toJSON()` returns a `RoutePatternJSON` object with serialized `protocol`, `hostname`, `port`, `pathname`, and `search` fields. `RoutePattern.parse()` throws `ParseError` for malformed sources; the error exposes stable `type`, `source`, and `index` fields.
+
+The public support types are:
+
+- `RoutePatternCapture` from `remix/route-pattern`
+- `RoutePatternJSON` from `remix/route-pattern`
+- `CreateHrefErrorDetails` from `remix/route-pattern/href`
+- `MatchParamMeta` from `remix/route-pattern/match`
+
 ## Combine patterns
 
 `joinPatterns` builds a new pattern from a base pattern.