@uniweb/build 1.3.0 → 1.3.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -56,15 +56,15 @@
     "js-yaml": "^4.1.0",
     "sharp": "^0.35.3",
     "yaml": "^2.5.0",
-    "@uniweb/projections": "~1.1.1",
-    "@uniweb/content-writer": "~1.1.0",
     "@uniweb/theming": "~1.2.0",
-    "@uniweb/semantic-parser": "~1.6.0",
-    "@uniweb/schemas": "~1.2.0",
-    "@uniweb/content-reader": "~1.3.0"
+    "@uniweb/projections": "~1.1.1",
+    "@uniweb/content-reader": "~1.3.1",
+    "@uniweb/semantic-parser": "~1.7.0",
+    "@uniweb/schemas": "~1.2.1",
+    "@uniweb/content-writer": "~1.1.1"
   },
   "optionalDependencies": {
-    "@uniweb/runtime": "~1.1.1"
+    "@uniweb/runtime": "~1.1.2"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",
@@ -73,8 +73,8 @@
     "@tailwindcss/vite": "^4.0.0",
     "@vitejs/plugin-react": "^4.0.0 || ^5.0.0",
     "vite-plugin-svgr": "^4.0.0",
-    "@uniweb/runtime": "~1.1.1",
-    "@uniweb/core": "~1.2.0"
+    "@uniweb/core": "~1.2.1",
+    "@uniweb/runtime": "~1.1.2"
   },
   "peerDependenciesMeta": {
     "vite": {

package/src/site/content-collector.js

@@ -22,7 +22,7 @@
  */
 
 import { readFile, readdir, stat } from 'node:fs/promises'
-import { resolveQueriesConfig, toConfigQueries, dataKeyTyping } from './queries-config.js'
+import { resolveQueriesConfig, toConfigQueries, dataKeyTyping, foundationSections } from './queries-config.js'
 import { isSectionKey } from '@uniweb/schemas/section'
 import { parseNumericPrefix, compareByNumericPrefix } from '../utils/numeric-prefix.js'
 import { isMarkdownFile, isIgnoredFolder } from '../utils/content-files.js'
@@ -43,6 +43,7 @@ import { parseFrontmatter } from '../utils/frontmatter.js'
 import { parseGrid } from '@uniweb/schemas/grid'
 import { runtimeServicesConfig, refuseRetiredServiceKeys, refuseUnreadableServices } from '../uwx/services-request.js'
 import { warnOutsideVocabulary } from './vocabulary-warnings.js'
+import { warnPlacementsNotOffered } from './placement-warnings.js'
 
 // Try to import content-reader, fall back to simplified parser
 let markdownToProseMirror
@@ -428,6 +429,15 @@ function buildVersionMetadata(detectedVersions, pageConfig = {}) {
  */
 let yamlFailures = []
 
+/**
+ * The foundation's section types for the current collect — its schema, each
+ * type's entry by name (`foundationSections`) — so a section's file can be told
+ * when it asks for a placement its type does not honour
+ * (`./placement-warnings.js`). Null when the foundation is not at hand. Set once
+ * per collect, and module-scoped for the reason `yamlFailures` gives.
+ */
+let sectionTypes = null
+
 /**
  * Parse YAML, recording a failure against the file it came from.
  *
@@ -1075,6 +1085,7 @@ async function processMarkdownFile(filePath, id, siteRoot, defaultStableId = nul
   const warnHere = (message) => console.warn(`[content-collector] ${relative(siteRoot, filePath)}: ${message}`)
   const proseMirrorContent = markdownToProseMirror(markdown, { onWarning: warnHere })
   warnOutsideVocabulary(proseMirrorContent, warnHere)
+  warnPlacementsNotOffered(proseMirrorContent, type || null, sectionTypes, warnHere)
 
   // `query: team` → `fetch: { query: team }`; a list, one config per name, each under
   // its own `as` — the one helper every level uses. Unrelated to a section type's
@@ -2505,9 +2516,13 @@ export async function collectSiteContent(sitePath, options = {}) {
   // function again, so without the reset a typo fixed three saves ago would
   // still be counted.
   yamlFailures = []
+  sectionTypes = null
 
   // Read site config and raw theme config
   const siteConfig = await readYamlFile(join(sitePath, configFile))
+  // What each section type honours — read before any section is, so a file asking
+  // for a placement its type does not offer is told (`./placement-warnings.js`).
+  sectionTypes = await foundationSections(sitePath, siteConfig)
   refuseRetiredServiceKeys(siteConfig, configFile)
   refuseUnreadableServices(siteConfig, configFile)
 

package/src/site/placement-warnings.js

@@ -0,0 +1,43 @@
+/**
+ * Say, with the file in hand, where a section's content asks for a placement its
+ * section type does not honour.
+ *
+ * A section type declares the placements its flow honours — `sequence: {
+ * placement }` in its `meta.js`, lowered by `@uniweb/schemas/content` — and an
+ * editor offers an author only those. A file can still ask for any: the block
+ * then sits in the text column, as it would with none. ⭐ A warning, never a
+ * failure, since the page renders. ⛔ Section content only: a record's body is
+ * shown by whatever section a site gives it, so no foundation schema says what
+ * it may use [Diego, 2026-10-14].
+ */
+import { placementsNotOffered } from '@uniweb/schemas/content'
+
+const BLOCK = { image: 'an image', video: 'a video', table: 'a table', icon: 'an icon', document: 'a document' }
+
+/**
+ * Warn, for each block in `doc` that asks for a placement its section type does
+ * not offer, with the file it came from.
+ *
+ * @param {Object} doc - the section's content, a ProseMirror document
+ * @param {string|null} type - the section's `type:`; with none, the foundation's
+ *   `defaultSection`
+ * @param {Object|null} sectionTypes - the foundation's schema: each section
+ *   type's entry by name (`foundationSections`); null when it is not at hand
+ * @param {(message: string) => void} warn - prints one message, prefixed with the file
+ */
+export function warnPlacementsNotOffered(doc, type, sectionTypes, warn) {
+  const name = type || sectionTypes?._self?.defaultSection || null
+  const entry = name && !name.startsWith('_') ? sectionTypes?.[name] : null
+  if (!entry || typeof entry !== 'object') return
+
+  for (const finding of placementsNotOffered(doc, entry)) {
+    const block = BLOCK[finding.kind] || 'a block'
+    const asked = `\`placement=${finding.placement}\``
+    if (finding.kind === 'icon' || finding.kind === 'document') {
+      warn(`${block} takes no placement, so ${asked} does nothing`)
+      continue
+    }
+    const offers = finding.offered.length > 0 ? ` (it offers ${finding.offered.join(', ')})` : ''
+    warn(`${block} asks for ${asked}, which ${name} does not offer${offers} — it sits in the text column`)
+  }
+}