yamlover 0.3.52 → 0.3.54

package/dist/server.js

@@ -39804,7 +39804,7 @@ var require_builder = __commonJS({
           }
           render = /* @__PURE__ */ function(_this) {
             return function(element, obj) {
-              var attr, child, entry, index, key, value;
+              var attr2, child, entry, index, key, value;
               if (typeof obj !== "object") {
                 if (_this.options.cdata && requiresCDATA(obj)) {
                   element.raw(wrapCDATA(obj));
@@ -39826,9 +39826,9 @@ var require_builder = __commonJS({
                   child = obj[key];
                   if (key === attrkey) {
                     if (typeof child === "object") {
-                      for (attr in child) {
-                        value = child[attr];
-                        element = element.att(attr, value);
+                      for (attr2 in child) {
+                        value = child[attr2];
+                        element = element.att(attr2, value);
                       }
                     }
                   } else if (key === charkey) {
@@ -69277,6 +69277,90 @@ function allowedInReadOnly(method, pathname) {
 }
 var READ_ONLY_ERROR = { error: "server is read-only", readOnly: true };
 
+// src/server/seo.ts
+function isChapter(format) {
+  return format === "x-yamlover-chapter" || format === "x-yamlover-task";
+}
+function slashOfStorePath(p2) {
+  return segsOfPath(p2).map((s2) => encodeURIComponent(segToken(s2))).join("/");
+}
+var SITEMAP_MAX_URLS = 5e4;
+function collectPages(s2, meta, max = SITEMAP_MAX_URLS) {
+  const pages = [];
+  const page = (path12) => ({
+    path: path12,
+    slash: slashOfStorePath(path12),
+    title: meta.title(path12),
+    description: meta.description(path12)
+  });
+  pages.push(page(":"));
+  let truncated = false;
+  const walk = (rows, inBook) => {
+    for (const r2 of rows) {
+      if (pages.length >= max) {
+        truncated = true;
+        return;
+      }
+      const chapter = isChapter(r2.format);
+      if (chapter) pages.push(page(r2.path));
+      if (chapter || !inBook) walk(r2.children, inBook || chapter);
+    }
+  };
+  walk(s2.toc(":"), isChapter(meta.format(":")));
+  return { pages, truncated };
+}
+var XML_ESC = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" };
+var xml = (t3) => t3.replace(/[&<>"']/g, (c3) => XML_ESC[c3]);
+function pageUrl(origin, basePath, slash) {
+  return `${origin}${basePath}/${slash}`.replace(/\/+$/, "/");
+}
+function sitemapXml(origin, basePath, pages, truncated = false) {
+  const urls = pages.map((p2) => `  <url><loc>${xml(pageUrl(origin, basePath, p2.slash))}</loc></url>`).join("\n");
+  const note = truncated ? `
+  <!-- truncated at ${SITEMAP_MAX_URLS} URLs, the sitemap protocol's per-file limit -->` : "";
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+${urls}${note}
+</urlset>
+`;
+}
+function robotsTxt(sitemapUrl) {
+  return [
+    "# Do NOT disallow /api/ \u2014 this is a single-page app and its text is fetched from",
+    "# /api/content at render time. A crawler denied that endpoint indexes blank pages.",
+    "User-agent: *",
+    "Allow: /",
+    "",
+    `Sitemap: ${sitemapUrl}`,
+    ""
+  ].join("\n");
+}
+var HTML_ESC = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" };
+var attr = (t3) => t3.replace(/[&<>"]/g, (c3) => HTML_ESC[c3]);
+var DESC_MAX = 300;
+function pageTitle(title, tokens, siteName) {
+  const own = title?.trim() || tokens[tokens.length - 1] || siteName;
+  if (tokens.length === 0) return own;
+  return `${own} - ${siteName}${tokens.slice(0, -1).map((t3) => `: ${t3}`).join("")}`;
+}
+function headTags(opts) {
+  const full = opts.title;
+  const desc = opts.description?.trim().replace(/\s+/g, " ").slice(0, DESC_MAX);
+  const tags = [
+    `<title>${attr(full)}</title>`,
+    `<link rel="canonical" href="${attr(opts.canonical)}">`,
+    `<meta property="og:title" content="${attr(full)}">`,
+    `<meta property="og:url" content="${attr(opts.canonical)}">`,
+    `<meta property="og:type" content="article">`,
+    `<meta property="og:site_name" content="${attr(opts.siteName)}">`
+  ];
+  if (desc) {
+    tags.splice(1, 0, `<meta name="description" content="${attr(desc)}">`);
+    tags.push(`<meta property="og:description" content="${attr(desc)}">`);
+  }
+  return tags.join("");
+}
+
 // src/server/engine-api.ts
 var LINK_KEY = "$yamloverLink";
 var REF_KEY = "$yamloverRef";
@@ -70073,8 +70157,41 @@ function createHandlers(dataRoot, opts = {}) {
       sendJson(res, 400, { error: exc.message || String(exc) });
     }
   };
+  const pageMeta = {
+    title: (p2) => titleOf(store0, p2),
+    description: (p2) => descriptionOf(store0, p2),
+    format: (p2) => store0.node(p2)?.format ?? null
+  };
+  const seo = {
+    robots: (sitemapUrl) => robotsTxt(sitemapUrl),
+    sitemap: (origin, basePath) => {
+      const { pages, truncated } = collectPages(store0, pageMeta);
+      return sitemapXml(origin, basePath, pages, truncated);
+    },
+    /** The `<head>` tags for ONE client route (a slash URL path, base already stripped), or ""
+     *  when the path names no node — the common case, and not an error: the shell answers every
+     *  path, `/.browser/settings.yo` included, which has no node by design. */
+    head: (pathname, canonical) => {
+      try {
+        const segs = canonSegs(store0, slashToSegs(pathname), false);
+        const p2 = storePath(segs);
+        if (!store0.node(p2)) return "";
+        const siteName = titleOf(store0, ":") || rootName;
+        return headTags({
+          // the same tokens the client's own title effect walks — segToken, not the raw segment
+          title: pageTitle(titleOf(store0, p2), segs.map((g) => segToken(g)), siteName),
+          description: descriptionOf(store0, p2),
+          canonical,
+          siteName
+        });
+      } catch {
+        return "";
+      }
+    }
+  };
   return Object.assign(handler, {
     ready,
+    seo,
     close: () => {
       if (closed) return;
       closed = true;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yamlover",
-  "version": "0.3.52",
+  "version": "0.3.54",
   "description": "A local-first, editable knowledge graph for humans and LLMs: npx yamlover <root> serves a browser UI over a plain-text directory, with an editor, live queries, pointers, and an LLM-agent API.",
   "type": "module",
   "license": "MIT",