@uniweb/kit 0.19.5 → 0.19.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/kit",
-  "version": "0.19.5",
+  "version": "0.19.6",
   "description": "Standard component library for Uniweb foundations",
   "type": "module",
   "exports": {
@@ -43,8 +43,8 @@
     "shiki": "^3.0.0",
     "tailwind-merge": "^3.6.0",
     "temml": "^0.13.2",
-    "@uniweb/core": "^0.30.0",
-    "@uniweb/projections": "^0.7.4",
+    "@uniweb/core": "^0.31.0",
+    "@uniweb/projections": "^0.7.5",
     "@uniweb/semantic-parser": "^1.4.1",
     "@uniweb/scene": "^0.1.3"
   },

package/src/hooks/useWholeRecord.js

@@ -1,13 +1,13 @@
 /**
  * useWholeRecord — the whole of a record whose query delivers less of it.
  *
- * When a query's list carries less than a record — a `deferred: [...]` query, a
- * host's records service answering briefs, an external query that declares
- * `record:` — the whole record lives at its own address. This hook fetches that
+ * A query's list carries briefs — a static site's compiled list, a host's records
+ * service — and an external query that declares `record:` has its own request for
+ * one. The whole record, as stored, lives at its own address. This hook fetches that
  * record on demand, from the source the query's declaration picks:
  *
- *   - a query over `records/{schema}/` with `deferred:` — the per-record file the
- *     build emits;
+ *   - a query over `records/{schema}/` — the per-record file the build emits for
+ *     every record (only for a query with `deferred:`, since retired, until 2026-09-27);
  *   - a host's records service — the query's question narrowed to the record,
  *     asked `whole`;
  *   - an external query — its `record:` request, `{slug}` substituted.
@@ -41,7 +41,7 @@
  * }
  */
 
-import { getUniweb, resolveFetchConfigs, buildDetailConfig, routeParamValue } from '@uniweb/core'
+import { getUniweb, resolveFetchConfigs, buildDetailConfig, routeParamValue, routeFieldOf } from '@uniweb/core'
 import { useFetched } from './useFetched.js'
 
 /**
@@ -63,13 +63,11 @@ export function useWholeRecord(record, options = {}) {
   const request = buildDetailRequest(record, query, { param: options?.param })
   const result = useFetched(request)
 
-  // No separate detail source for this collection — nothing was stripped from
-  // the cascade, so the record the caller already holds IS the whole record.
-  // Returning it beats both alternatives: `null` makes every caller null-check
-  // a case that cannot fail, and requesting the per-record file anyway is a
-  // guaranteed 404, because that file is only written for a `deferred:`
-  // collection. `useFetched` is still called above — unconditionally, as the
-  // rules of hooks require — and simply skips on a null request.
+  // No separate source for one record — an external query with no `record:` — so
+  // the record the caller already holds is all there is. Returning it beats `null`,
+  // which would make every caller null-check a case that cannot fail. `useFetched`
+  // is still called above — unconditionally, as the rules of hooks require — and
+  // simply skips on a null request.
   if (record && query && !request) {
     return { data: record, error: null, loading: false }
   }
@@ -82,7 +80,7 @@ export function useWholeRecord(record, options = {}) {
  * ⛔ THIS MUST NOT DECIDE THE ADDRESS ITSELF, and it used to. It read
  * `config.queries[name].detailUrl` (retired since) directly and otherwise composed
  * `/data/<name>/<slug>.json` by hand, which was wrong three ways: it 404'd on
- * any collection without `deferred:` (that file is only written for one), it
+ * any query without `deferred:` (that file was only written for one then), it
  * could not see a host's live record lane at all, and its hand-rolled `{slug}`
  * replace ignored a route whose param is named anything else.
  *
@@ -93,8 +91,8 @@ export function useWholeRecord(record, options = {}) {
  * per-record source is, then `buildDetailConfig` turns that plus a param into a
  * request. A fourth answer computed here is a fourth thing to drift.
  *
- * Returns null when the collection has no separate detail source — the common
- * case, and not a failure. The caller's record is already whole.
+ * Returns null when the query has no separate detail source — an external query
+ * with no `record:` — and the caller's record is all there is.
  *
  * Exported for tests only — not re-exported from the package index.
  *
@@ -116,7 +114,8 @@ export function buildDetailRequest(record, query, { param = null } = {}) {
   // `entity-store` matches on — else `slug`, the file lane's per-record key and the
   // documented default.
   const paramName = param || website?.recordPageFor?.(query)?.paramName || 'slug'
-  const paramValue = routeParamValue(record, paramName)
+  // The field the query binds its page's URL segment to, when it binds one — else `$name`.
+  const paramValue = routeParamValue(record, paramName, routeFieldOf(config?.queries?.[query]))
   if (paramValue === undefined || paramValue === null || paramValue === '') return null
 
   // One synthetic source, resolved by the shared rule — same inputs the