@uniweb/kit 0.14.0 → 0.15.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/kit",
-  "version": "0.14.0",
+  "version": "0.15.1",
   "description": "Standard component library for Uniweb foundations",
   "type": "module",
   "exports": {
@@ -44,8 +44,8 @@
     "shiki": "^3.0.0",
     "tailwind-merge": "^3.6.0",
     "temml": "^0.13.2",
-    "@uniweb/core": "^0.13.0",
-    "@uniweb/semantic-parser": "^1.3.1",
+    "@uniweb/semantic-parser": "^1.4.0",
+    "@uniweb/core": "^0.15.0",
     "@uniweb/scene": "^0.1.3"
   },
   "peerDependencies": {

package/src/hooks/index.js

@@ -2,7 +2,7 @@ export { useWebsite, default } from './useWebsite.js'
 export { useFetched } from './useFetched.js'
 export { useCacheEntry } from './useCacheEntry.js'
 export { useEntityDetail } from './useEntityDetail.js'
-export { useCollectionQueryable } from './useCollectionQueryable.js'
+export { useQueryable } from './useQueryable.js'
 export { useRouting } from './useRouting.js'
 export { useActiveRoute } from './useActiveRoute.js'
 export { useVersion } from './useVersion.js'

package/src/hooks/useEntityDetail.js

@@ -1,20 +1,20 @@
 /**
- * useEntityDetail — fetch the full record for a deferred-field collection.
+ * useEntityDetail — fetch the full record for a query with deferred fields.
  *
- * When a collection declares `deferred: [...]` in `site.yml`, the cascade
+ * When a query declares `deferred: [...]`, the cascade
  * payload omits the deferred fields. The full record (with deferred
  * 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
+ * Two source patterns, picked automatically from the query's
  * declaration:
  *
- *   - Markdown-backed collections (declared with `path:` in site.yml).
- *     The build emits `/data/<collection>/<slug>.json` per record. The
+ *   - File-backed records (a query over `entities/{schema}/`).
+ *     The build emits `/data/<query>/<slug>.json` per record. The
  *     hook fetches that path.
  *
- *   - API-backed collections (declared with `url:` in site.yml plus a
+ *   - Remote sources (a query declaring `url:` plus a
  *     `detailUrl:` pattern). The hook substitutes `{slug}` in the
  *     pattern and fetches that URL.
  *
@@ -31,7 +31,7 @@
  * function ArticleCard({ article }) {
  *   const [open, setOpen] = useState(false)
  *   const { data: full, loading } = useEntityDetail(open ? article : null, {
- *     collection: 'articles',
+ *     query: 'articles',
  *   })
  *   return (
  *     <div>
@@ -48,18 +48,18 @@ import { getUniweb, resolveFetchConfigs, buildDetailConfig } from '@uniweb/core'
 import { useFetched } from './useFetched.js'
 
 /**
- * @param {Object|null} record - A record from a cascade-delivered collection.
+ * @param {Object|null} record - A record from a cascade-delivered query.
  *   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 look up the collection's
+ * @param {string} options.query - The query name (e.g., 'articles').
+ *   Required when record is non-null. Used to look up the query'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 = buildDetailRequest(record, collection)
+  const query = options?.query
+  const request = buildDetailRequest(record, query)
   const result = useFetched(request)
 
   // No separate detail source for this collection — nothing was stripped from
@@ -69,7 +69,7 @@ export function useEntityDetail(record, options = {}) {
   // 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.
-  if (record && collection && !request) {
+  if (record && query && !request) {
     return { data: record, error: null, loading: false }
   }
   return result
@@ -79,7 +79,7 @@ export function useEntityDetail(record, options = {}) {
  * Build the fetch request for one record's full payload.
  *
  * ⛔ THIS MUST NOT DECIDE THE ADDRESS ITSELF, and it used to. It read
- * `config.collections[name].detailUrl` directly and otherwise composed
+ * `config.queries[name].detailUrl` 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
  * could not see a host's live record lane at all, and its hand-rolled `{slug}`
@@ -98,24 +98,24 @@ export function useEntityDetail(record, options = {}) {
  * Exported for tests only — not re-exported from the package index.
  *
  * @param {Object|null} record
- * @param {string} collection
+ * @param {string} query
  * @returns {{path?: string, url?: string, endpoint?: string, schema: string}|null}
  */
-export function buildDetailRequest(record, collection) {
+export function buildDetailRequest(record, query) {
   const slug = record?.slug
-  if (!slug || !collection) return null
+  if (!slug || !query) return null
 
   const website = getUniweb()?.activeWebsite
   const config = website?.config
 
   // One synthetic source, resolved by the shared rule — same inputs the
   // EntityStore passes, so the hook cannot disagree with the page it sits on.
-  const resolved = resolveFetchConfigs([{ collection, schema: collection }], {
-    collections: config?.collections ?? null,
+  const resolved = resolveFetchConfigs([{ query, schema: query }], {
+    queries: config?.queries ?? null,
     records: config?.records ?? null,
     locale: website?.getActiveLocale?.() ?? null,
     defaultLocale: website?.getDefaultLocale?.() ?? null,
-  }).get(collection)
+  }).get(query)
 
   if (!resolved) return null
 

package/src/hooks/useFormValues.js

@@ -14,7 +14,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react'
  *
  * What it deliberately does NOT own is the rendering. Which control a `type`
  * maps to, how it looks, how an error reads — that is the foundation's design
- * and its whole reason for existing. Same split as `useCollectionQueryable`:
+ * and its whole reason for existing. Same split as `useQueryable`:
  * the kit hands over the metadata and the state, the foundation builds the
  * controls against them.
  *

package/src/hooks/{useCollectionQueryable.js → useQueryable.js}

@@ -1,25 +1,29 @@
 /**
- * useCollectionQueryable — read the queryable-surface metadata for a
- * collection.
+ * useQueryable — read the queryable-surface metadata for a named query.
  *
- * Authors declare the queryable surface of an entity in `site.yml`:
+ * ⛔ RENAMED FROM `useQueryable`. An earlier pass kept the old name to
+ * avoid breaking foundations — but nothing is published yet, and the word was
+ * hiding the conflation this whole change removes: `queryable:` is declared on a
+ * QUERY, and a query is not a set of files.
  *
- *   collections:
- *     members:
- *       path: collections/members
- *       queryable:
- *         department:
- *           type: enum
- *           label: Department
- *           options: [biology, physics, chemistry, geology]
- *         tenured:
- *           type: boolean
- *           label: Tenured
- *         start_year:
- *           type: range
- *           label: Start year
- *           min: 1800
- *           max: 2025
+ * Authors declare the queryable surface on a named QUERY, in `queries.yml`
+ * (or under `queries:` in `site.yml`):
+ *
+ *   members:
+ *     schema: '@std/person'
+ *     queryable:
+ *       department:
+ *         type: enum
+ *         label: Department
+ *         options: [biology, physics, chemistry, geology]
+ *       tenured:
+ *         type: boolean
+ *         label: Tenured
+ *       start_year:
+ *         type: range
+ *         label: Start year
+ *         min: 1800
+ *         max: 2025
  *
  * Foundations consume this hook to render filter UIs and compose
  * where-objects from user interactions. The kit doesn't ship UI
@@ -29,7 +33,7 @@
  *
  * @example
  * function MemberFilters({ onChange }) {
- *   const queryable = useCollectionQueryable('members')
+ *   const queryable = useQueryable('members')
  *   const [values, setValues] = useState({})
  *   if (!queryable) return null
  *   return (
@@ -53,22 +57,22 @@
  *
  * Returns null when the collection has no `queryable:` declared.
  *
- * @param {string} collectionName - Name of the collection to read queryable
+ * @param {string} queryName - Name of the collection to read queryable
  *   metadata for. Pass null/undefined to skip (returns null).
  * @returns {Object|null} The queryable metadata object, or null.
  */
 
 import { getUniweb } from '@uniweb/core'
 
-export function useCollectionQueryable(collectionName) {
-  if (!collectionName) return null
+export function useQueryable(queryName) {
+  if (!queryName) return null
   const website = getUniweb()?.activeWebsite
   if (!website) return null
-  const config = website.config?.collections?.[collectionName]
+  const config = website.config?.queries?.[queryName]
   if (!config || typeof config !== 'object') return null
   const queryable = config.queryable
   if (!queryable || typeof queryable !== 'object') return null
   return queryable
 }
 
-export default useCollectionQueryable
+export default useQueryable

package/src/index.js

@@ -58,7 +58,7 @@ export {
   useFetched,
   useCacheEntry,
   useEntityDetail,
-  useCollectionQueryable,
+  useQueryable,
   useRouting,
   useActiveRoute,
   useVersion,

package/src/styled/Render/index.jsx

@@ -93,7 +93,7 @@ export const NOT_RENDERED = {
     'carry a component NAME and no refId, so there is nothing here to look up — ' +
     'and kit answering for the name is the shadowing the inset_block case ' +
     'refuses. Consequence worth knowing: a document rendered straight from ' +
-    'markdown without that build step (a collection record body, say) loses its ' +
+    'markdown without that build step (a record body, say) loses its ' +
     'inline component references.',
   form: 'an editor node; its data reaches components as content.data[schemaId]',
   'card-group': 'an editor node, deprecated — maps to content.data[cardType]',