@uniweb/build 0.8.0 → 0.8.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -50,9 +50,9 @@
     "sharp": "^0.33.2"
   },
   "optionalDependencies": {
-    "@uniweb/content-reader": "1.1.2",
-    "@uniweb/schemas": "0.2.1",
-    "@uniweb/runtime": "0.6.1"
+    "@uniweb/content-reader": "1.1.3",
+    "@uniweb/runtime": "0.6.1",
+    "@uniweb/schemas": "0.2.1"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -61,7 +61,7 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/core": "0.5.1"
+    "@uniweb/core": "0.5.2"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/runtime-schema.js

@@ -190,6 +190,11 @@ export function extractRuntimeSchema(fullMeta) {
 
   const runtime = {}
 
+  // Embed flag: signals this component is designed for inline embedding via @ refs
+  if (fullMeta.embed) {
+    runtime.embed = true
+  }
+
   // Background opt-out: 'self' means the component renders its own background
   // layer (solid colors, insets, effects), so the runtime skips its Background.
   if (fullMeta.background) {

package/src/site/content-collector.js

@@ -178,6 +178,45 @@ async function readYamlFile(filePath) {
   }
 }
 
+/**
+ * Extract inline child references from a ProseMirror document.
+ *
+ * Walks top-level nodes for `inline_child_ref` (produced by content-reader
+ * for `![alt](@ComponentName){params}` syntax). Each ref is removed from the
+ * document and replaced with an `inline_child_placeholder` node carrying a
+ * unique refId. The extracted refs are returned as an array.
+ *
+ * @param {Object} doc - ProseMirror document (mutated in place)
+ * @returns {Array} Array of { refId, type, params, alt }
+ */
+function extractInlineChildren(doc) {
+  if (!doc?.content || !Array.isArray(doc.content)) return []
+
+  const inlineChildren = []
+  let refIndex = 0
+
+  for (let i = 0; i < doc.content.length; i++) {
+    const node = doc.content[i]
+    if (node.type === 'inline_child_ref') {
+      const { component, alt, ...params } = node.attrs || {}
+      const refId = `inline_${refIndex++}`
+      inlineChildren.push({
+        refId,
+        type: component,
+        params: Object.keys(params).length > 0 ? params : {},
+        alt: alt || null,
+      })
+      // Replace in-place with placeholder
+      doc.content[i] = {
+        type: 'inline_child_placeholder',
+        attrs: { refId },
+      }
+    }
+  }
+
+  return inlineChildren
+}
+
 /**
  * Check if a file is a markdown file that should be processed.
  * Excludes:
@@ -579,6 +618,9 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
   // Convert markdown to ProseMirror
   const proseMirrorContent = markdownToProseMirror(markdown)
 
+  // Extract @ component references → inline children (mutates doc)
+  const inlineChildren = extractInlineChildren(proseMirrorContent)
+
   // Support 'data:' shorthand for collection fetch
   // data: team → fetch: { collection: team }
   // data: [team, articles] → fetch: { collection: team } (first item, others via inheritData)
@@ -601,6 +643,7 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
     params: { ...params, ...props },
     content: proseMirrorContent,
     fetch: parseFetchConfig(resolvedFetch),
+    ...(inlineChildren.length > 0 ? { inlineChildren } : {}),
     subsections: []
   }
 
@@ -1822,7 +1865,8 @@ export {
   extractItemName,
   parseWildcardArray,
   applyWildcardOrder,
-  getDirectChildName
+  getDirectChildName,
+  extractInlineChildren
 }
 
 export default collectSiteContent