docs: Docs updates

Author: ntucker

docs/core/api/useQuery.md

@@ -16,7 +16,8 @@ import VoteDemo from '../shared/\_VoteDemo.mdx';
 Data rendering without the fetch.
 
 Access any [Queryable Schema](/rest/api/schema#queryable)'s store value; like [Entity](/rest/api/Entity), [All](/rest/api/All), [Collection](/rest/api/Collection), [Query](/rest/api/Query),
-and [Union](/rest/api/Union). If the value does not exist, returns `undefined`.
+and [Union](/rest/api/Union). [Lazy](/rest/api/Lazy) fields also work via their [`.query`](/rest/api/Lazy#query) accessor.
+If the value does not exist, returns `undefined`.
 
 `useQuery()` is reactive to data [mutations](../getting-started/mutations.md); rerendering only when necessary. Returns `undefined`
 when data is [Invalid](../concepts/expiry-policy#invalid).
@@ -59,7 +60,7 @@ function useQuery<S extends Queryable>(
 
 [Queryable](/rest/api/schema#queryable) schemas require an `queryKey()` method that returns something. These include
 [Entity](/rest/api/Entity), [All](/rest/api/All), [Collection](/rest/api/Collection), [Query](/rest/api/Query),
-and [Union](/rest/api/Union).
+and [Union](/rest/api/Union). [Lazy](/rest/api/Lazy) fields produce a Queryable via their [`.query`](/rest/api/Lazy#query) accessor.
 
 ```ts
 interface Queryable {

docs/core/shared/_schema_table.mdx

@@ -66,10 +66,16 @@
 <td align="center">🛑</td>
 </tr>
 <tr>
-<td>any</td>
+<td rowSpan={2}>any</td>
 <td align="center"></td>
 <td>[Query(Queryable)](/rest/api/Query)</td>
 <td>memoized custom transforms</td>
 <td align="center">✅</td>
 </tr>
+<tr>
+<td align="center"></td>
+<td>[Lazy(Schema)](/rest/api/Lazy)</td>
+<td>deferred denormalization</td>
+<td align="center">🛑</td>
+</tr>
 </tbody></table>

docs/rest/api/Entity.md

@@ -451,6 +451,9 @@ class Department extends Entity {
 Set this on entities that participate in deep or wide bidirectional relationships.
 Normal entity graphs (depth < 10) never approach the default limit.
 
+For relationships that don't need eager denormalization, [Lazy](/rest/api/Lazy)
+skips resolution entirely and lets you resolve on demand via [useQuery](/docs/api/useQuery).
+
 :::
 
 ## Lifecycle

docs/rest/api/Query.md

@@ -25,6 +25,7 @@ the same high performance and referential equality guarantees expected of Reacti
 [Schema](./schema.md) used to retrieve/denormalize data from the Reactive Data Client cache.
 This accepts any [Queryable](/rest/api/schema#queryable) schema: [Entity](./Entity.md), [All](./All.md), [Collection](./Collection.md), [Query](./Query.md),
 [Union](./Union.md), and [Object](./Object.md) schemas for joining multiple entities.
+[Lazy](./Lazy.md) fields produce a Queryable via their [`.query`](./Lazy.md#query) accessor.
 
 ### process(entries, ...args) {#process}
 

docs/rest/api/schema.md

@@ -244,7 +244,7 @@ This enables their use in these additional cases:
 - Improve performance of [useSuspense](/docs/api/useSuspense), [useDLE](/docs/api/useDLE) by rendering before endpoint resolution
 
 `Querables` include [Entity](./Entity.md), [All](./All.md), [Collection](./Collection.md), [Query](./Query.md),
-and [Union](./Union.md).
+and [Union](./Union.md). [Lazy](./Lazy.md) fields produce a Queryable via their [`.query`](./Lazy.md#query) accessor.
 
 ```ts
 interface Queryable {

docs/rest/guides/relational-data.md

@@ -600,6 +600,15 @@ export class User extends Entity {
 }
 ```
 
+:::tip
+
+For bidirectional relationships that don't need eager denormalization,
+[Lazy](../api/Lazy.md) defers resolution and lets you resolve on demand
+via [useQuery](/docs/api/useQuery), avoiding deep recursion and improving
+memoization isolation.
+
+:::
+
 [1]: ../api/Entity.md
 [2]: /docs/api/useCache
 [3]: ../api/Entity.md#schema

website/sidebars-endpoint.json

@@ -47,6 +47,10 @@
     "type": "doc",
     "id": "api/Invalidate"
   },
+  {
+    "type": "doc",
+    "id": "api/Lazy"
+  },
   {
     "type": "doc",
     "id": "api/validateRequired"