@uniweb/kit 0.9.0 → 0.9.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/kit",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Standard component library for Uniweb foundations",
   "type": "module",
   "exports": {
@@ -38,7 +38,7 @@
     "fuse.js": "^7.0.0",
     "shiki": "^3.0.0",
     "tailwind-merge": "^2.6.0",
-    "@uniweb/core": "0.7.0"
+    "@uniweb/core": "0.7.1"
   },
   "peerDependencies": {
     "react": "^18.0.0 || ^19.0.0",

package/src/hooks/useEntityDetail.js

@@ -3,11 +3,26 @@
  *
  * When a collection declares `deferred: [...]` in `site.yml`, the cascade
  * payload omits the deferred fields. The full record (with deferred
- * fields included) lives in a per-record file at
- * `/data/<collection>/<slug>.json`. On dynamic-route pages, the framework
- * routes the singular detail there automatically. Anywhere else (a card
- * grid that wants to show a hover-card preview, a modal that opens an
- * article body) — use this hook.
+ * fields included) lives somewhere — either at a per-record file the
+ * build emits, or at an author-declared API endpoint. This hook fetches
+ * that full record on demand.
+ *
+ * Two source patterns, picked automatically from the collection's
+ * declaration:
+ *
+ *   - Markdown-backed collections (declared with `path:` in site.yml).
+ *     The build emits `/data/<collection>/<slug>.json` per record. The
+ *     hook fetches that path.
+ *
+ *   - API-backed collections (declared with `url:` in site.yml plus a
+ *     `detailUrl:` pattern). The hook substitutes `{slug}` in the
+ *     pattern and fetches that URL.
+ *
+ * On dynamic-route pages the framework routes the singular detail to
+ * the same source automatically (entity-store auto-injection). This
+ * hook is for the elsewhere case — a hover-card preview, a modal that
+ * opens an article body, a related-items strip that wants summaries
+ * everywhere except the one being highlighted.
  *
  * Returns `{ data, error, loading }` like `useFetched`. Shares the same
  * cache. Pass null/undefined to skip without subscribing.
@@ -29,6 +44,7 @@
  * }
  */
 
+import { getUniweb } from '@uniweb/core'
 import { useFetched } from './useFetched.js'
 
 /**
@@ -36,16 +52,39 @@ import { useFetched } from './useFetched.js'
  *   Must have a `slug` field. Pass null/undefined to skip the fetch.
  * @param {Object} [options]
  * @param {string} options.collection - The collection name (e.g., 'articles').
- *   Required when record is non-null. Used to build the per-record file URL
+ *   Required when record is non-null. Used to look up the collection's
+ *   `detailUrl:` (if declared) or fall back to the static-file default
  *   `/data/<collection>/<slug>.json`.
  * @returns {{ data: any, error: string|null, loading: boolean }}
  */
 export function useEntityDetail(record, options = {}) {
   const collection = options?.collection
-  const request = (record && record.slug && collection)
-    ? { path: `/data/${collection}/${record.slug}.json`, schema: collection }
-    : null
+  const request = buildDetailRequest(record, collection)
   return useFetched(request)
 }
 
+function buildDetailRequest(record, collection) {
+  const slug = record?.slug
+  if (!slug || !collection) return null
+
+  // Look up the collection's per-record source pattern. Authors with
+  // API-backed collections declare `detailUrl:` in site.yml; markdown
+  // collections leave it null and use the static-file default.
+  const website = getUniweb()?.activeWebsite
+  const collConfig = website?.config?.collections?.[collection]
+  const detailUrl = (collConfig && typeof collConfig.detailUrl === 'string')
+    ? collConfig.detailUrl
+    : null
+
+  if (detailUrl) {
+    // Substitute {slug} into the author-declared pattern and use url:
+    // (the source is remote).
+    const url = detailUrl.replace(/\{slug\}/g, encodeURIComponent(slug))
+    return { url, schema: collection }
+  }
+
+  // Static-file default — the build emitted per-record JSON files.
+  return { path: `/data/${collection}/${slug}.json`, schema: collection }
+}
+
 export default useEntityDetail