@uniweb/build 0.6.15 → 0.6.17

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uniweb/build",
-  "version": "0.6.15",
+  "version": "0.6.17",
   "description": "Build tooling for the Uniweb Component Web Platform",
   "type": "module",
   "exports": {
@@ -51,8 +51,8 @@
   },
   "optionalDependencies": {
     "@uniweb/schemas": "0.2.1",
-    "@uniweb/runtime": "0.5.21",
-    "@uniweb/content-reader": "1.1.2"
+    "@uniweb/content-reader": "1.1.2",
+    "@uniweb/runtime": "0.5.21"
   },
   "peerDependencies": {
     "vite": "^5.0.0 || ^6.0.0 || ^7.0.0",

package/src/i18n/index.js

@@ -176,7 +176,8 @@ export async function extractManifest(siteRoot, options = {}) {
   const {
     localesDir = DEFAULTS.localesDir,
     siteContentPath = join(siteRoot, 'dist', 'site-content.json'),
-    verbose = false
+    verbose = false,
+    dryRun = false
   } = options
 
   // Load site content
@@ -203,8 +204,10 @@ export async function extractManifest(siteRoot, options = {}) {
   // Generate sync report
   const report = syncManifests(previousManifest, manifest)
 
-  // Write new manifest
-  await writeFile(manifestPath, JSON.stringify(manifest, null, 2))
+  // Write new manifest (skip in dry-run mode)
+  if (!dryRun) {
+    await writeFile(manifestPath, JSON.stringify(manifest, null, 2))
+  }
 
   if (verbose) {
     console.log(formatSyncReport(report))
@@ -222,7 +225,7 @@ export async function extractManifest(siteRoot, options = {}) {
  * @returns {Promise<Object>} { manifest, report }
  */
 export async function extractCollectionManifest(siteRoot, options = {}) {
-  const { localesDir = DEFAULTS.localesDir } = options
+  const { localesDir = DEFAULTS.localesDir, dryRun = false } = options
 
   // Extract translatable content from collections
   const manifest = await extractCollectionContent(siteRoot)
@@ -249,8 +252,10 @@ export async function extractCollectionManifest(siteRoot, options = {}) {
   // Generate sync report
   const report = syncManifests(previousManifest, manifest)
 
-  // Write new manifest
-  await writeFile(manifestPath, JSON.stringify(manifest, null, 2))
+  // Write new manifest (skip in dry-run mode)
+  if (!dryRun) {
+    await writeFile(manifestPath, JSON.stringify(manifest, null, 2))
+  }
 
   return { manifest, report }
 }

package/src/i18n/sync.js

@@ -143,6 +143,15 @@ export function formatSyncReport(report) {
 
   if (report.moved.length > 0) {
     lines.push(`  ↻ ${report.moved.length} strings moved (contexts updated)`)
+    for (const item of report.moved.slice(0, 5)) {
+      const preview = truncate(item.source, 40)
+      const oldCtx = formatContext(item.previousContexts?.[0])
+      const newCtx = formatContext(item.currentContexts?.[0])
+      lines.push(`    - "${preview}" ${oldCtx} → ${newCtx}`)
+    }
+    if (report.moved.length > 5) {
+      lines.push(`    ... and ${report.moved.length - 5} more`)
+    }
   }
 
   if (report.changed.length > 0) {
@@ -150,7 +159,7 @@ export function formatSyncReport(report) {
     for (const item of report.changed.slice(0, 5)) {
       const prevPreview = truncate(item.previousSource, 30)
       const currPreview = truncate(item.source, 30)
-      lines.push(`    - ${item.previousHash}: "${prevPreview}" → "${currPreview}"`)
+      lines.push(`    - "${prevPreview}" → "${currPreview}"`)
     }
     if (report.changed.length > 5) {
       lines.push(`    ... and ${report.changed.length - 5} more`)
@@ -159,15 +168,42 @@ export function formatSyncReport(report) {
 
   if (report.added.length > 0) {
     lines.push(`  + ${report.added.length} new strings`)
+    for (const item of report.added.slice(0, 5)) {
+      const preview = truncate(item.source, 40)
+      const ctx = formatContext(item.contexts?.[0])
+      lines.push(`    - "${preview}" ${ctx}`)
+    }
+    if (report.added.length > 5) {
+      lines.push(`    ... and ${report.added.length - 5} more`)
+    }
   }
 
   if (report.removed.length > 0) {
     lines.push(`  - ${report.removed.length} strings removed`)
+    for (const item of report.removed.slice(0, 5)) {
+      const preview = truncate(item.source, 40)
+      const ctx = formatContext(item.contexts?.[0])
+      lines.push(`    - "${preview}" ${ctx}`)
+    }
+    if (report.removed.length > 5) {
+      lines.push(`    ... and ${report.removed.length - 5} more`)
+    }
   }
 
   return lines.join('\n')
 }
 
+/**
+ * Format a context object for display
+ */
+function formatContext(context) {
+  if (!context) return ''
+  const location = context.page || context.collection || ''
+  const section = context.section || context.item || ''
+  if (!location && !section) return ''
+  return `(${location}:${section})`
+}
+
 /**
  * Truncate string for display
  */

package/src/site/content-collector.js

@@ -179,19 +179,36 @@ async function readYamlFile(filePath) {
 }
 
 /**
- * Check if a file is a markdown file
+ * Check if a file is a markdown file that should be processed.
+ * Excludes:
+ * - Files not ending in .md
+ * - Files starting with _ (drafts/private)
+ * - README.md (repo documentation, not site content)
  */
 function isMarkdownFile(filename) {
-  return filename.endsWith('.md') && !filename.startsWith('_')
+  if (!filename.endsWith('.md')) return false
+  if (filename.startsWith('_')) return false
+  if (filename.toLowerCase() === 'readme.md') return false
+  return true
+}
+
+/**
+ * Check if a folder should be ignored.
+ * Excludes folders starting with _ (drafts/private).
+ */
+function isIgnoredFolder(name) {
+  return name.startsWith('_')
 }
 
 /**
  * Read folder configuration, determining content mode from config file presence.
  *
- * - folder.yml present → pages mode (md files are child pages)
- * - page.yml present → sections mode (md files are sections of this page)
+ * - folder.yml present → folder mode (md files are child pages)
+ * - page.yml present → page mode (md files are sections of this page)
  * - Neither → inherit mode from parent
  *
+ * Internal mode values: 'pages' (folder mode), 'sections' (page mode)
+ *
  * @param {string} dirPath - Directory path
  * @param {string} inheritedMode - Mode inherited from parent ('sections' or 'pages')
  * @returns {Promise<{config: Object, mode: string, source: string}>}
@@ -205,7 +222,7 @@ async function readFolderConfig(dirPath, inheritedMode) {
   if (Object.keys(pageYml).length > 0) {
     return { config: pageYml, mode: 'sections', source: 'page.yml' }
   }
-  // Check for empty folder.yml (presence signals pages mode even if empty)
+  // Check for empty folder.yml (presence signals folder mode even if empty)
   if (existsSync(join(dirPath, 'folder.yml'))) {
     return { config: {}, mode: 'pages', source: 'folder.yml' }
   }
@@ -274,7 +291,7 @@ function applyNonStrictOrder(items, orderArray) {
 }
 
 /**
- * Process a markdown file as a standalone page (pages mode).
+ * Process a markdown file as a standalone page (folder mode).
  * Creates a page with a single section from the markdown content.
  *
  * @param {string} filePath - Path to markdown file
@@ -763,6 +780,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
   // First pass: discover all page folders and read their config
   const pageFolders = []
   for (const entry of entries) {
+    if (isIgnoredFolder(entry)) continue // Skip _prefixed folders
     const entryPath = join(dirPath, entry)
     const stats = await stat(entryPath)
     if (!stats.isDirectory()) continue
@@ -802,7 +820,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
   const folderNames = orderedFolders.map(f => f.name)
   const detectedVersions = detectVersions(folderNames)
 
-  // If versioned section, handle version folders specially (always sections mode)
+  // If versioned section, handle version folders specially (always page mode)
   if (detectedVersions && !versionContext) {
     const parentConfig = await readYamlFile(join(dirPath, 'page.yml'))
     const versionMeta = buildVersionMetadata(detectedVersions, parentConfig)
@@ -864,7 +882,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
     // Apply non-strict order to md-file-pages
     const orderedMdPages = applyNonStrictOrder(mdPageItems, orderConfig?.order)
 
-    // In pages mode, only promote an index if explicitly set via index: in folder.yml
+    // In folder mode, only promote an index if explicitly set via index: in folder.yml
     // The container page itself owns the parent route — don't auto-promote children
     const indexName = orderConfig?.index || null
 
@@ -890,7 +908,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
       const isIndex = entry === indexName
 
       if (dirMode === 'sections') {
-        // Subdirectory overrides to sections mode — process normally
+        // Subdirectory overrides to page mode — process normally
         const result = await processPage(entryPath, entry, siteRoot, {
           isIndex, parentRoute, parentFetch, versionContext
         })
@@ -901,7 +919,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
           iconCollection = mergeIconCollections(iconCollection, pageIcons)
           pages.push(page)
 
-          // Recurse into subdirectories (sections mode)
+          // Recurse into subdirectories (page mode)
           const childParentRoute = isIndex ? parentRoute : page.route
           const childFetch = page.fetch || parentFetch
           const subResult = await collectPagesRecursive(entryPath, childParentRoute, siteRoot, childOrderConfig, childFetch, versionContext, 'sections')
@@ -913,7 +931,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
           }
         }
       } else {
-        // Container directory in pages mode — create minimal page, recurse
+        // Container directory in folder mode — create minimal page, recurse
         const containerRoute = isIndex
           ? parentRoute
           : parentRoute === '/' ? `/${entry}` : `${parentRoute}/${entry}`
@@ -955,7 +973,7 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
 
         pages.push(containerPage)
 
-        // Recurse in pages mode
+        // Recurse in folder mode
         const subResult = await collectPagesRecursive(entryPath, containerRoute, siteRoot, childOrderConfig, parentFetch, versionContext, 'pages')
         pages.push(...subResult.pages)
         assetCollection = mergeAssetCollections(assetCollection, subResult.assetCollection)
@@ -984,8 +1002,8 @@ async function collectPagesRecursive(dirPath, parentRoute, siteRoot, orderConfig
     const isIndex = entry === indexPageName
 
     if (dirMode === 'pages') {
-      // Child directory switches to pages mode (has folder.yml) —
-      // create container page with empty sections, recurse in pages mode
+      // Child directory switches to folder mode (has folder.yml) —
+      // create container page with empty sections, recurse in folder mode
       const containerRoute = isIndex
         ? parentRoute
         : parentRoute === '/' ? `/${entry}` : `${parentRoute}/${entry}`