uniweb 0.8.30 → 0.8.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.8.30",
+  "version": "0.8.32",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -42,11 +42,11 @@
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
     "@uniweb/core": "0.5.18",
-    "@uniweb/runtime": "0.6.25",
-    "@uniweb/kit": "0.7.19"
+    "@uniweb/kit": "0.7.21",
+    "@uniweb/runtime": "0.6.27"
   },
   "peerDependencies": {
-    "@uniweb/build": "0.8.29",
+    "@uniweb/build": "0.8.31",
     "@uniweb/content-reader": "1.1.4",
     "@uniweb/semantic-parser": "1.1.8"
   },

package/partials/agents.md

@@ -398,7 +398,7 @@ function Hello() {
 
 Access: `content.snippets[0]` → `{ language: 'jsx', code: 'function Hello() {...}' }`. The `language` attribute is a display hint for syntax highlighting, not a parsing format. Filter by language: `content.snippets.filter(s => s.language === 'css')`.
 
-Both appear in `content.sequence` for document-order rendering. The difference: tagged data blocks are parsed and extracted to `content.data`; code snippets are preserved and collected in `content.snippets`.
+Both appear in `content.sequence` for document-order rendering. The difference: tagged data blocks are parsed and extracted to `content.data`; code snippets are preserved and collected in `content.snippets`. `<Prose>` handles this automatically — it renders code snippets with syntax highlighting and skips tagged data blocks, which components access separately via `content.data`.
 
 ### Composition: Nesting and Embedding
 
@@ -502,6 +502,14 @@ export default function Grid({ block, params }) {
 }
 ```
 
+`ChildBlocks` renders each child as a bare component by default — no wrapper element, no context classes, no background. This is the right behavior for grid cells, tab panels, carousel slides, and inline children where the parent controls the container.
+
+For the rare case where children should be independent sections with their own theming and backgrounds, pass `wrapAs`:
+
+```jsx
+<ChildBlocks from={block} wrapAs="div" />
+```
+
 **Data and child blocks:** Page-level `data:` is available to all blocks on the page, including children. Each child block resolves data independently through the same page → site hierarchy. If a child component needs data, declare it in the child's `meta.js` or in the child section's frontmatter (`data: articles`).
 
 ### Section Backgrounds
@@ -867,12 +875,29 @@ Kit provides `H1` through `H6` — use the appropriate level for semantic hierar
 **Full content rendering** (article/docs sections where the author controls the flow):
 
 ```jsx
-import { Section, Article } from '@uniweb/kit'
+import { Section, Prose } from '@uniweb/kit'
 
 <Section block={block} width="lg" padding="md" />
-<Article block={block} />
+<Prose content={content} block={block} />
 ```
 
+`Prose` renders from the parsed content sequence — headings, paragraphs, images, code snippets, lists, etc. — with prose typography. Tagged data blocks are **skipped** (they're structured data, not prose). Access them via `content.data` for custom rendering:
+
+```jsx
+function Lesson({ content, block }) {
+  return (
+    <div>
+      <Prose content={content} block={block} />
+      {content.data.quiz && <Quiz data={content.data.quiz} />}
+    </div>
+  )
+}
+```
+
+Pass `content` (the parsed content object — has `.sequence`). Pass `block` too if the content uses insets. Also works as a pure typography wrapper: `<Prose>{children}</Prose>`.
+
+`Article` is an older alternative that renders from `block.rawContent` (raw ProseMirror nodes) — it renders everything including data blocks. Prefer `Prose` for new components.
+
 **Visuals:**
 
 ```jsx
@@ -885,7 +910,7 @@ import { Visual } from '@uniweb/kit'
 
 **Rendering text:** `H1`–`H6`, `P`, `Span`, `Div`, `Text` (with `as` prop)
 
-**Rendering content:** `Section` (full section with prose + layout), `Article` (prose content from `block.rawContent`), `Render` (ProseMirror nodes → React), `ChildBlocks` (render child sections)
+**Rendering content:** `Section` (full section with prose + layout), `Prose` (prose from parsed content sequence, skips data blocks), `Article` (raw ProseMirror rendering), `Render` (ProseMirror nodes → React), `ChildBlocks` (render child sections)
 
 **Rendering media:** `Visual` (first non-empty: inset/video/image), `Image`, `Media`, `Icon`