Merge branch 'main' into feat/migrating-to-v2-guide

Author: kodiakhq[bot]

src/routes/solid-router/reference/primitives/use-is-routing.mdx

@@ -9,21 +9,56 @@ tags:
   - pending
   - state
   - ui
-version: '1.0'
+version: "1.0"
 description: >-
   Track route transitions with useIsRouting - display loading states, pending
   UI, and transition feedback during navigation in SolidJS.
 ---
 
-Retrieves a signal that indicates whether the route is currently in a transition.
-This is useful for showing a stale or pending state when the route resolution is suspended state during concurrent rendering.
+The `useIsRouting` function is a utility for detecting when the router is processing a route transition.
 
-```js
-const isRouting = useIsRouting();
+## Import
 
-return (
-	<div classList={{ "grey-out": isRouting() }}>
-		<MyAwesomeContent />
-	</div>
-);
+```ts
+import { useIsRouting } from "@solidjs/router";
 ```
+
+## Type
+
+```ts
+const useIsRouting: () => () => boolean;
+```
+
+## Parameters
+
+None.
+
+## Return value
+
+**Type:** `() => boolean`
+
+An accessor function that returns `true` during route transitions and `false` otherwise.
+
+## Examples
+
+### Route transition indicator
+
+```tsx
+import { useIsRouting } from "@solidjs/router";
+
+function App() {
+	const isRouting = useIsRouting();
+
+	return (
+		<>
+			{isRouting() && <div class="loading-bar" />}
+			<MyContent />
+		</>
+	);
+}
+```
+
+## Related
+
+- [`<Router>`](/solid-router/reference/components/router)
+- [`useNavigate`](/solid-router/reference/primitives/use-navigate)

src/routes/solid-router/reference/primitives/use-preload-route.mdx

@@ -9,36 +9,76 @@ tags:
   - optimization
   - prefetch
   - manual
-version: '1.0'
+version: "1.0"
 description: >-
   Manually preload routes with usePreloadRoute - optimize performance by
   prefetching route data before navigation in your SolidJS app.
 ---
 
-`usePreloadRoute` returns a function that can be used to preload a route manually.
+The `usePreloadRoute` function is a utility for manually preloading a route.
+
+## Import
 
 ```ts
-const preload = usePreloadRoute();
+import { usePreloadRoute } from "@solidjs/router";
+```
+
+## Type
 
-preload(`/users/settings`, { preloadData: true });
+```ts
+const usePreloadRoute: () => (
+	url: string | URL,
+	options?: { preloadData?: boolean }
+) => void;
 ```
 
-## Usage
+## Parameters
+
+### `url`
+
+**Type:** `string | URL`
+**Required:** Yes
+
+The route path to preload.
+Accepts either a `string` path or a [URL](https://developer.mozilla.org/en-US/docs/Web/API/URL) object.
+
+### `options`
+
+- **Type:** `{ preloadData?: boolean }`
+- **Required:** No
 
-Routes are preloaded by default within Solid Router contexts.
-This helper is useful when you want to preload a route in response to some other event, such as a button click or a timer.
+A configuration object with the following properties:
 
-## Type Signature
+#### `preloadData`
 
-### Parameters
+- **Type:** `boolean`
+- **Default:** `false`
 
-| Parameter | Type     | Required | Description                          |
-| --------- | -------- | -------- | ------------------------------------ |
-| `to`      | `To`     | Yes      | The route path to preload            |
-| `options` | `object` | No       | Configuration options for preloading |
+When `true`, triggers the route's data loading in addition to preloading the route itself.
+
+## Return value
+
+None.
+
+## Examples
+
+### Basic usage
+
+```tsx
+import { usePreloadRoute } from "@solidjs/router";
+
+function SettingsButton() {
+	const preload = usePreloadRoute();
+
+	return (
+		<button onClick={() => preload("/users/settings", { preloadData: true })}>
+			Load settings
+		</button>
+	);
+}
+```
 
-### Options
+## Related
 
-| Option        | Type      | Default | Description                                                         |
-| ------------- | --------- | ------- | ------------------------------------------------------------------- |
-| `preloadData` | `boolean` | `false` | Whether to preload the route's data in addition to the route itself |
+- [`<A>`](/solid-router/reference/components/a)
+- [`preload`](/solid-router/reference/preload-functions/preload)