uniweb 0.79.1 → 0.79.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.79.1",
+  "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/kit": "^0.19.11",
-    "@uniweb/schemas": "^0.9.2",
+    "@uniweb/content-writer": "^0.3.4",
     "@uniweb/core": "^0.35.0",
     "@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.3",
     "@uniweb/content-reader": "^1.2.7",
-    "@uniweb/semantic-parser": "^1.4.1",
-    "@uniweb/build": "^0.73.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.
 
@@ -1041,9 +1043,17 @@ function MyComponent({ content, params, block }) {
 }
 ```
 
-Frontmatter becomes `params`, minus the keys the framework takes for itself: `type`, `id`, `hidden`, `query`, `fetch` (a `data:` key is refused — it was `query:`'s old name; `preset:` and `input:` are ignored with a warning). `props:` is the one that isn't dropped but merged *into* params.
+**Frontmatter becomes `params` — except the names framework keeps for itself.** Every section can be given these, whatever its type, and none of them reaches your component as a param. So **never declare one in `meta.js` `params:`** — a component that does never receives what an author writes.
 
-**The section's own settings are not params either.** `theme`, `background`, `grid` and `vars` are framework's: it applies them — the color context and the background around your component, the section's theme and your component's CSS variables in the page stylesheet, the child layout through `ChildGrid` — so your component never receives them in `params`, and the build warns on a param declared with one of those names. When a component needs one for its own logic, it reads it from `block`: `useColorContext(block)` for the context (a light vs. dark logo, say), `<SectionBackground block={block} />` to draw the background itself, `<ChildGrid from={block} />` for the grid. Every other key is a param, declared or not; components ignore the ones they don't use.
+| in a section's frontmatter | what it is | a component reads it from |
+|---|---|---|
+| `type`, `id`, `hidden` | the section itself — its section type, its id, and a draft (`hidden: true`: left out of a published build, kept by `uniweb dev`) | — |
+| `query`, `fetch` | the section's data | `content.data`, under the keys its `meta.js` `data:` declares |
+| `theme`, `background`, `grid`, `vars` | the section's settings, which framework applies — the color context and the background around your component, the section's theme and your component's CSS variables in the page stylesheet, the child layout | `block`, when the component needs one for its own logic: `useColorContext(block)` for the context (a light vs. dark logo, say), `<SectionBackground block={block} />` to draw the background itself, `<ChildGrid from={block} />` for the grid |
+| `props` | params written as one map | `params` — its keys are merged in, one by one |
+| `data`, `preset`, `input` | nothing: `data:` is refused (it was `query:`'s old name); `preset:` and `input:` are ignored with a warning | — |
+
+The build warns when `params:` declares any of them. A preset may still set `theme` or `background` — a preset's params are written into the section's frontmatter when an author starts a section from it, so `dark: { label: 'Dark', params: { theme: 'dark' } }` is a dark section. Every other key is a param, declared or not; components ignore the ones they don't use.
 
 ### Rendering content with Kit
 
@@ -1090,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 })`
@@ -2415,7 +2425,7 @@ For cases the factory doesn't cover, write handlers directly using `Loom`, `inst
 
 > **`instantiateContent` resolves `{placeholders}` in text nodes only** — not in link `href`s or other node/mark attributes. So `[{email}](mailto:{email})` fills the visible label but leaves the `mailto:` URL literal. For dynamic URLs, emit the value as plain text and let the component linkify it, or build the href in the handler yourself.
 
-**Reserved frontmatter:** `source` and `where` are convention-level reserved fields — they flow to both `block.properties` (for handler access) and `params` (visible to components), consistent with `background` and `theme`. Components can ignore them. List them in `meta.js` params with descriptions so the editor and schema recognize them.
+**`source` and `where` are ordinary params** that the Loom handler reads — they reach both `block.properties` (for handler access) and `params` (visible to components). Components can ignore them. List them in `meta.js` params with descriptions so the editor and schema recognize them. (Unlike `theme` and `background`, which are the section's own settings and never reach `params` — see the table under *Frontmatter becomes `params`*.)
 <!-- /template:loom -->
 
 ---

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-28T21:05:39.664Z",
+  "generatedAt": "2026-09-29T17:52:46.126Z",
   "packages": {
     "@uniweb/api": {
       "version": "0.6.8",
@@ -10,7 +10,7 @@
       ]
     },
     "@uniweb/build": {
-      "version": "0.73.1",
+      "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.2",
+      "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": []
     },

package/templates/foundation/package.json.hbs

@@ -14,7 +14,16 @@
     "#components/*": "./components/*",
     "#utils/*": "./utils/*"
   },
-  "files": ["dist", "sections", "components", "layouts", "utils", "main.js", "styles.css", "_entry.generated.js"],
+  "files": [
+    "dist",
+    "sections",
+    "components",
+    "layouts",
+    "utils",
+    "main.js",
+    "styles.css",
+    "_entry.generated.js"
+  ],
   "scripts": {
     "dev": "vite",
     "build": "uniweb build",