@uniweb/core 0.7.29 → 0.7.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/core",
-  "version": "0.7.29",
+  "version": "0.7.31",
   "description": "Core classes for the Uniweb platform - Uniweb, Website, Page, Block",
   "type": "module",
   "exports": {
@@ -31,8 +31,8 @@
     "vitest": "^4.1.7"
   },
   "dependencies": {
-    "@uniweb/semantic-parser": "1.1.18",
-    "@uniweb/theming": "0.1.14"
+    "@uniweb/theming": "0.1.14",
+    "@uniweb/semantic-parser": "1.1.20"
   },
   "scripts": {
     "test": "vitest run"

package/src/block.js

@@ -8,6 +8,70 @@
 import { parseContent as parseSemanticContent } from '@uniweb/semantic-parser'
 import { normalizeTokenValue } from '@uniweb/theming'
 
+/**
+ * Lift container fences out of a content document.
+ *
+ * A ` ```@Component{params} ` fence parses to an `inset_block` node carrying a
+ * body of real block content. This rewrites each one to the `inset_placeholder`
+ * a leaf inset leaves behind, so a container resolves through exactly the same
+ * path: `getInset(refId)` → a Block → the foundation's component. Kit and the
+ * SSR renderer already handle placeholders, so neither needs to know containers
+ * exist.
+ *
+ * PURE with respect to the input. `blockData.content` is shared with the sync /
+ * pull machinery, which must keep seeing `inset_block` — that is the canonical
+ * stored shape. Nodes on the path to a container are cloned; everything else is
+ * passed through by reference, so a document with no containers costs one array
+ * walk and allocates nothing.
+ *
+ * Containers are NOT recursed into here. A container's body becomes its child
+ * Block's content, and that Block's constructor lifts its own containers — so
+ * nesting resolves one level at a time, each at the level that owns it.
+ *
+ * @param {Object} content - ProseMirror document (never mutated)
+ * @returns {{ content: Object, refs: Array<{refId, type, params, content}> }}
+ */
+function liftContainers(content) {
+  if (!content || !Array.isArray(content.content)) return { content, refs: [] }
+
+  const refs = []
+
+  const visit = (nodes) => {
+    let changed = false
+    const out = nodes.map((node) => {
+      if (!node) return node
+
+      if (node.type === 'inset_block') {
+        const { component, ...params } = node.attrs || {}
+        const refId = `container_${refs.length}`
+        refs.push({
+          refId,
+          type: component,
+          params,
+          content: { type: 'doc', content: node.content || [] },
+        })
+        changed = true
+        return { type: 'inset_placeholder', attrs: { refId, embedKind: 'block' } }
+      }
+
+      if (Array.isArray(node.content)) {
+        const inner = visit(node.content)
+        if (inner !== node.content) {
+          changed = true
+          return { ...node, content: inner }
+        }
+      }
+      return node
+    })
+    return changed ? out : nodes
+  }
+
+  const next = visit(content.content)
+  return next === content.content
+    ? { content, refs }
+    : { content: { ...content, content: next }, refs }
+}
+
 export default class Block {
   constructor(blockData, id, page) {
     this.id = id
@@ -22,8 +86,17 @@ export default class Block {
     // 1. Raw ProseMirror content (from content collection)
     // 2. Pre-parsed content with main/items structure
     // For now, store raw and parse on demand
-    this.rawContent = blockData.content || {}
-    this.parsedContent = this.parseContent(blockData.content)
+    //
+    // Container fences (```@Component around a body) arrive as `inset_block`
+    // nodes and are lifted out HERE, into the same placeholder + refId shape
+    // the build gives leaf insets. Doing it at render-graph construction
+    // rather than at build time is deliberate: `inset_block` is the canonical
+    // STORED shape, so the content that syncs and round-trips must keep
+    // carrying it. `blockData.content` is left untouched — the lift produces a
+    // new tree and only this Block's view of it changes.
+    const lifted = liftContainers(blockData.content)
+    this.rawContent = lifted.content || {}
+    this.parsedContent = this.parseContent(lifted.content)
 
     // Merge fetched data from prerender (if present)
     // Prerender stores fetched data in blockData.parsedContent.data
@@ -114,6 +187,30 @@ export default class Block {
       }
     }
 
+    // Containers, appended AFTER the leaf insets so `block.insets[0]` keeps
+    // meaning what it meant to every foundation already using <Visual>.
+    // Unlike a leaf inset, a container's body becomes the child Block's
+    // content, so the foundation's component receives a fully parsed
+    // `content` — title, paragraphs, items, sequence — exactly as a section
+    // does. Nested containers resolve for free: the child Block runs this
+    // same constructor over its own body.
+    for (let i = 0; i < lifted.refs.length; i++) {
+      const ref = lifted.refs[i]
+      this.insets.push(
+        new Block(
+          {
+            type: ref.type,
+            params: ref.params || {},
+            content: ref.content,
+            stableId: ref.refId,
+            refId: ref.refId,
+          },
+          `${id}_container_${i}`,
+          this.page
+        )
+      )
+    }
+
     // Fetch configuration (from section frontmatter)
     // Supports local files (path) or remote URLs (url)
     this.fetch = blockData.fetch || null

package/src/website.js

@@ -1011,6 +1011,21 @@ export default class Website {
 
     return {
       enabled: this.isSearchEnabled(),
+      // Which provider serves results. `index` (the default) downloads a
+      // prebuilt index and queries it in the browser — free, and works on any
+      // host. `endpoint` queries a server-side search API, which is what makes
+      // dynamic/API-backed content searchable. Any other value names a
+      // foundation-supplied search transport.
+      //
+      // Kit resolves and loads the provider; core only passes the declaration
+      // through, so a site that never searches pays nothing for the vocabulary
+      // (see kit's search module for the resolution rules).
+      provider: config.provider || 'index',
+      // Base-RELATIVE path for the `endpoint` provider. Left raw here: kit
+      // resolves it against `basePath`, so one spelling works whether the site
+      // is served from the root, from a subdirectory, or from a backend
+      // subpath. Undefined unless declared.
+      endpoint: config.endpoint,
       indexUrl: this.getSearchIndexUrl(),
       locale: this.getActiveLocale(),
       include: {
@@ -1029,7 +1044,14 @@ export default class Website {
   }
 
   /**
-   * Get the URL for the search index file
+   * Get the URL for the search index file.
+   *
+   * Includes `basePath`, so the URL is correct on a site deployed under a
+   * subdirectory (`base: /docs/`) and on a backend-hosted site served from a
+   * subpath. Omitting it was a real bug: the returned path was fetched
+   * verbatim, so search 404'd on every non-root deployment while data fetching
+   * — which resolves the same base — worked.
+   *
    * @returns {string} URL to fetch the search index
    */
   getSearchIndexUrl() {
@@ -1037,7 +1059,10 @@ export default class Website {
     const isDefault = locale === this.getDefaultLocale()
 
     // Default locale uses root path, others use locale prefix
-    return isDefault ? '/search-index.json' : `/${locale}/search-index.json`
+    const path = isDefault ? '/search-index.json' : `/${locale}/search-index.json`
+
+    // `basePath` is already normalized without a trailing slash ('' at root).
+    return `${this.basePath || ''}${path}`
   }
 
   /**