uniweb 0.79.2 → 0.79.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.79.2",
+  "version": "0.79.3",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,17 +41,17 @@
     "js-yaml": "^4.1.0",
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
+    "@uniweb/content-writer": "^0.3.4",
     "@uniweb/core": "^0.35.0",
-    "@uniweb/schemas": "^0.9.3",
-    "@uniweb/kit": "^0.19.11",
     "@uniweb/runtime": "^0.28.3",
-    "@uniweb/content-writer": "^0.3.4",
-    "@uniweb/semantic-parser": "^1.4.1"
+    "@uniweb/kit": "^0.19.12",
+    "@uniweb/schemas": "^0.9.4",
+    "@uniweb/semantic-parser": "^1.5.0"
   },
   "peerDependencies": {
-    "@uniweb/build": "^0.73.2",
+    "@uniweb/build": "^0.73.3",
     "@uniweb/content-reader": "^1.2.7",
-    "@uniweb/semantic-parser": "^1.4.1"
+    "@uniweb/semantic-parser": "^1.5.0"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/partials/agents.md

@@ -366,6 +366,7 @@ content = {
   images: [],       // { src, alt, role, href }
   icons: [],        // { library, name, role }
   videos: [],       // { src, alt, role, poster, href }
+  documents: [],    // { url, alt, caption, role: 'pdf', preview?, author?, description? } — from {role=pdf}
   insets: [],       // Inline @Component references — { refId }
   lists: [],        // [[{ paragraphs, links, lists, … }]] — each item is an object, not a string
   quotes: [],       // Blockquotes
@@ -524,12 +525,13 @@ Optional attributes: `{size=20}`, `{color=red}`. Custom SVGs: `![Logo](./logo.sv
 ```markdown
 [text](url){target=_blank}              <!-- Open in new tab -->
 [text](./file.pdf){download}            <!-- Download -->
-![alt](./img.jpg){role=banner}          <!-- Role determines array: images, icons, or videos -->
+![alt](./img.jpg){role=banner}          <!-- Role determines array: images, icons, videos or documents -->
 ![alt](./demo.mp4){role=video}          <!-- → content.videos[], not content.images[] -->
+![alt](./report.pdf){role=pdf}          <!-- → content.documents[] — a file, drawn as a link -->
 ![alt](./img.jpg){href=/products}       <!-- Clickable media: href + target ride along -->
 ```
 
-Sizing and loading ride on the image: `{width=800 height=600 loading=lazy fit=cover position=center}`. A video adds `{poster=./thumb.jpg autoplay muted loop controls}`; a `{role=pdf}` document adds `{preview=./cover.jpg author=… description=…}`.
+Sizing and loading ride on the image: `{width=800 height=600 loading=lazy fit=cover position=center}`. A video adds `{poster=./thumb.jpg autoplay muted loop controls}`; a `{role=pdf}` document adds `{preview=./cover.jpg author=… description=…}` and arrives in `content.documents` — declare it in `content:` as `documents`.
 
 **Quote values containing spaces:** `{note="Ready to go"}`, not `{note=Ready to go}` — unquoted values end at the first space.
 
@@ -1098,7 +1100,7 @@ Names only — for signatures and props, read the package: it's on disk at `node
 @import "@uniweb/kit/prose-tokens.css";   /* the plugin, wired to theme.yml */
 ```
 
-Nothing to install — the import brings the plugin with it. **Skip the import and prose is completely unstyled**, silently: the class is there and no rules are behind it. `uniweb doctor` flags that. Use **one** `prose` container per subtree — the `--tw-prose-*` variables are inherited, so a nested one silently resets them and the outer container goes on looking correct. The section that renders the document is usually the better owner; a layout should supply column width and padding.
+Nothing to install — the import brings the plugin with it. **Skip the import and prose is completely unstyled** — lists lose their bullets and numbers, and text its typography — while the markup looks right. The foundation build warns about it, and `uniweb doctor` flags it. Use **one** `prose` container per subtree — the `--tw-prose-*` variables are inherited, so a nested one silently resets them and the outer container goes on looking correct. The section that renders the document is usually the better owner; a layout should supply column width and padding.
 
 **Documentation shells:** `useHeadings()` (the page's headings + the one being read, derived from content so it prerenders), `website.getBranchHierarchy({ route, for })` (the page tree for one branch). Kit ships no ready-made layout — a layout is your foundation's design; write it in `src/layouts/` and use these for the behaviour.
 **Layout helpers:** `useGridLayout(columns, { gap })`, `useAccordion({ multiple, defaultOpen })`

package/src/commands/doctor.js

@@ -189,6 +189,24 @@ function loadSiteYml(dir) {
  * `node_modules` — this answers "did the developer write this", so a match
  * inside a dependency is the wrong answer.
  */
+/**
+ * Does this foundation render kit's <Prose> or <Article> — under its own name or an alias?
+ *
+ * The JSX tag alone missed `import { Article as ArticleBody } from '@uniweb/kit'`, which
+ * renders `<ArticleBody>`: two official templates shipped that way with no prose styles
+ * until 2026-09-29. So the import counts too. (The foundation build checks the same thing
+ * from its module graph, which no alias can hide from.)
+ *
+ * @param {string} dir - the foundation's source directory
+ * @returns {boolean}
+ */
+export function rendersKitProse(dir) {
+  return (
+    sourceMatches(dir, /<(Prose|Article)\b/) ||
+    sourceMatches(dir, /import\s*\{[^}]*\b(Prose|Article)\b[^}]*\}\s*from\s*['"]@uniweb\/kit['"]/)
+  )
+}
+
 function sourceMatches(dir, pattern) {
   let found = false
   forEachSourceFile(dir, (text) => {
@@ -1217,8 +1235,8 @@ export async function doctor(args = []) {
 
     // Does anything here actually ask for prose? Either the class in the
     // stylesheet, or kit's components, which render it.
+    const usesProseComponent = rendersKitProse(f.path)
     const usesProseClass = /(^|[\s"'`])prose(\s|["'`]|$)/m.test(styles)
-    const usesProseComponent = sourceMatches(f.path, /<(Prose|Article)\b/)
 
     if (!usesProseClass && !usesProseComponent) continue
 

package/src/framework-index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-09-28T23:00:27.056Z",
+  "generatedAt": "2026-09-29T17:52:46.126Z",
   "packages": {
     "@uniweb/api": {
       "version": "0.6.8",
@@ -10,7 +10,7 @@
       ]
     },
     "@uniweb/build": {
-      "version": "0.73.2",
+      "version": "0.73.3",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -55,7 +55,7 @@
       ]
     },
     "@uniweb/kit": {
-      "version": "0.19.11",
+      "version": "0.19.12",
       "path": "framework/kit",
       "deps": [
         "@uniweb/core",
@@ -71,7 +71,7 @@
       "deps": []
     },
     "@uniweb/press": {
-      "version": "0.4.17",
+      "version": "0.4.18",
       "path": "framework/press",
       "deps": []
     },
@@ -97,7 +97,7 @@
       "deps": []
     },
     "@uniweb/schemas": {
-      "version": "0.9.3",
+      "version": "0.9.4",
       "path": "framework/schemas",
       "deps": []
     },
@@ -107,7 +107,7 @@
       "deps": []
     },
     "@uniweb/semantic-parser": {
-      "version": "1.4.1",
+      "version": "1.5.0",
       "path": "framework/semantic-parser",
       "deps": []
     },
@@ -117,7 +117,7 @@
       "deps": []
     },
     "@uniweb/templates": {
-      "version": "0.17.7",
+      "version": "0.17.8",
       "path": "framework/templates",
       "deps": []
     },