mnfst-render 0.5.45 → 0.5.47

package/manifest.render.mjs

@@ -840,20 +840,43 @@ function discoverDataPaths(manifest, rootDir, wildcardBases = [], locales = [])
     return wildcardBases.some((base) => rest.startsWith(base + '/'));
   }
 
+  // A source mounts under the wildcard route named after it: `docs/*` for key
+  // `docs`, or a nested base ending in the key (`docs/framework/*` for key
+  // `framework`).
+  const mounts = new Map();
+  function mountFor(sourceKey) {
+    if (!sourceKey) return null;
+    if (mounts.has(sourceKey)) return mounts.get(sourceKey);
+    let mount = null;
+    if (wildcardBases.includes(sourceKey)) mount = sourceKey;
+    else {
+      const nested = wildcardBases.filter((b) => b.split('/').pop() === sourceKey);
+      if (nested.length === 1) {
+        mount = nested[0];
+        process.stderr.write(`prerender: data source "${sourceKey}" mounts under ${mount}/*\n`);
+      } else if (nested.length > 1) {
+        process.stderr.write(`prerender: data source "${sourceKey}" matches ${nested.map((b) => b + '/*').join(', ')}; not mounted (ambiguous)\n`);
+      }
+    }
+    mounts.set(sourceKey, mount);
+    return mount;
+  }
+
   function expandCandidates(rawPath, sourceKey) {
     const p = String(rawPath || '').replace(/^\/+|\/+$/g, '');
     if (!p) return [];
     const candidates = [p];
     if (wildcardBases.length === 0) return candidates;
-    if (!sourceKey || !wildcardBases.includes(sourceKey)) return candidates;
+    const mount = mountFor(sourceKey);
+    if (!mount) return candidates;
     const parts = p.split('/');
     const hasLocalePrefix = parts.length > 1 && localeSet.has(parts[0].toLowerCase());
     if (hasLocalePrefix) {
       const locale = parts[0];
       const rest = parts.slice(1).join('/');
-      if (rest && !rest.startsWith(sourceKey + '/')) candidates.push(`${locale}/${sourceKey}/${rest}`);
-    } else if (!p.startsWith(sourceKey + '/')) {
-      candidates.push(`${sourceKey}/${p}`);
+      if (rest && !rest.startsWith(mount + '/')) candidates.push(`${locale}/${mount}/${rest}`);
+    } else if (!p.startsWith(mount + '/')) {
+      candidates.push(`${mount}/${p}`);
     }
     return candidates;
   }
@@ -3091,6 +3114,75 @@ ${urlEntries.join('\n')}
   writeLlmsFiles(outputDir, pathList, base, ctx);
 }
 
+/**
+ * Group llms entries into sections by first URL segment ("Blog" for /blog/*),
+ * root page as "Overview", in first-encounter order.  Wherever a path holds two
+ * or more sub-areas that each have their own page and children, each sub-area
+ * becomes its own section labelled by its page title, recursively: /docs/ai/*
+ * and /docs/framework/* split into "AI Plugins" and "Framework", and groups
+ * inside them into "Framework / Core Plugins" and so on.  A lone sub-area
+ * (/fr/docs under /fr) is walked through when a split lies below it, and the
+ * first segment then leads the label ("Fr / AI Plugins").
+ */
+function groupLlmsSections(entries, siteName = '') {
+  const titleCase = (s) => s.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+  const paths = new Set(entries.map((e) => e.pathSeg));
+  const parents = new Set();
+  for (const p of paths) {
+    const segs = p.split('/');
+    for (let i = 1; i < segs.length; i++) parents.add(segs.slice(0, i).join('/'));
+  }
+  const childAreas = new Map();
+  for (const p of paths) {
+    if (!parents.has(p) || !p.includes('/')) continue;
+    const parent = p.slice(0, p.lastIndexOf('/'));
+    if (!childAreas.has(parent)) childAreas.set(parent, new Set());
+    childAreas.get(parent).add(p);
+  }
+  const splits = (prefix) => (childAreas.get(prefix)?.size || 0) >= 2;
+  const below = new Map();
+  const splitsBelow = (prefix) => {
+    if (!below.has(prefix)) {
+      const kids = childAreas.get(prefix);
+      below.set(prefix, splits(prefix) || (kids?.size === 1 && splitsBelow(kids.values().next().value)));
+    }
+    return below.get(prefix);
+  };
+  const suffix = siteName ? new RegExp(`\\s+[—–|-]\\s+${siteName.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}$`) : null;
+  const titles = new Map(entries.map((e) => [e.pathSeg, e.title || '']));
+  const labelCache = new Map();
+  const titleOf = (area) => {
+    if (labelCache.has(area)) return labelCache.get(area);
+    let t = titles.get(area) || '';
+    if (suffix) t = t.replace(suffix, '');
+    t = t.trim();
+    if (!t || t === siteName || t === area) t = titleCase(area.split('/').pop());
+    labelCache.set(area, t);
+    return t;
+  };
+  const sections = new Map();
+  for (const entry of entries) {
+    const segs = entry.pathSeg.split('/');
+    const first = segs[0] || '';
+    let key = first || 'Overview';
+    const parts = first && !splits(first) && splitsBelow(first) ? [titleCase(first)] : [];
+    let prefix = first;
+    for (let i = 1; first && i < segs.length && splitsBelow(prefix); i++) {
+      const child = segs.slice(0, i + 1).join('/');
+      if (!childAreas.get(prefix).has(child)) break;
+      if (splits(prefix)) {
+        key = child;
+        parts.push(titleOf(child));
+      }
+      prefix = child;
+    }
+    const label = parts.length > 1 || (parts.length && splits(first)) ? parts.join(' / ') : (first ? titleCase(first) : 'Overview');
+    if (!sections.has(key)) sections.set(key, { label, entries: [] });
+    sections.get(key).entries.push(entry);
+  }
+  return sections;
+}
+
 /**
  * Write llms.txt (curated index) and llms-full.txt (concatenated full content)
  * per the llmstxt.org convention.  Read each prerendered HTML file in pathList
@@ -3098,9 +3190,7 @@ ${urlEntries.join('\n')}
  * injectMetaInDom + smart defaults, so the output reflects the same layered
  * precedence (data-head → prerender.meta → smart defaults) without re-deriving.
  *
- * Pages are grouped into sections by their first URL segment ("Getting Started"
- * for /docs/getting-started/*, etc.) so the index is browseable.  The root /
- * page is treated as the site overview.
+ * Sections come from groupLlmsSections.
  */
 function writeLlmsFiles(outputDir, pathList, liveBase, ctx = {}) {
   const siteName = ctx.siteName || 'Site';
@@ -3121,18 +3211,7 @@ function writeLlmsFiles(outputDir, pathList, liveBase, ctx = {}) {
     });
   }
 
-  // Group entries by section.  For /a/b/c, the section is "a"; for the root,
-  // "Overview".  Sections are presented in first-encounter order to preserve
-  // whatever order the project's manifest.json or yaml index dictated.
-  const sections = new Map();
-  const titleCase = (s) => s.replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
-  for (const entry of entries) {
-    const first = entry.pathSeg.split('/')[0] || '';
-    const sectionKey = first || 'Overview';
-    const sectionLabel = first ? titleCase(first) : 'Overview';
-    if (!sections.has(sectionKey)) sections.set(sectionKey, { label: sectionLabel, entries: [] });
-    sections.get(sectionKey).entries.push(entry);
-  }
+  const sections = groupLlmsSections(entries, siteName);
 
   // --- llms.txt: short curated index ---
   let llms = `# ${siteName}\n`;
@@ -4485,7 +4564,7 @@ async function runPrerender(config) {
         // observer state at runtime and therefore need the live Alpine scope.
         const INTERACTIVE_DIRECTIVES = new Set([
           'x-color', 'x-dropdown', 'x-tooltip', 'x-tab', 'x-tabpanel',
-          'x-toast', 'x-carousel', 'x-resize', 'x-anchors', 'x-model',
+          'x-toast', 'x-carousel', 'x-anchors', 'x-model',
           'x-files', 'x-data-files',
         ]);
         // Runtime-only Alpine magics whose values change after the prerender
@@ -5462,6 +5541,8 @@ if (_isDirectEntry) {
 // Exports for the CLI bin script and for unit testing.
 export {
   main,
+  discoverRoutes,
+  groupLlmsSections,
   acquireOutputLock,
   outputLockPath,
   markPrerenderedManifestComponents,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mnfst-render",
-  "version": "0.5.45",
+  "version": "0.5.47",
   "description": "Render Manifest sites to static HTML for SEO",
   "type": "module",
   "bin": {