@stacksjs/actions 0.70.87 → 0.70.90

package/dist/blog-admin.js

@@ -0,0 +1,156 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const CONTENT_DIR = join(process.cwd(), "content/blog"), FIELD_ORDER = ["title", "description", "date", "author", "authorBio", "poster", "featured", "draft"];
+
+export class BlogAdminError extends Error {
+  status;
+  constructor(message, status = 422) {
+    super(message);
+    this.status = status;
+    this.name = "BlogAdminError";
+  }
+}
+export function slugify(input) {
+  return String(input).normalize("NFKD").replace(/[\u0300-\u036F]/g, "").toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80);
+}
+function assertSafeSlug(slug) {
+  if (!slug)
+    throw new BlogAdminError("A slug is required.");
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(slug))
+    throw new BlogAdminError(`Invalid slug "${slug}". Use lowercase letters, numbers, and hyphens.`);
+  return slug;
+}
+function parseFrontmatter(md) {
+  const m = md.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!m)
+    return { data: {}, body: md };
+  const data = {};
+  for (const line of (m[1] ?? "").split(`
+`)) {
+    const i = line.indexOf(":");
+    if (i === -1)
+      continue;
+    const key = line.slice(0, i).trim();
+    let val = line.slice(i + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'"))
+      val = val.slice(1, -1);
+    data[key] = val;
+  }
+  return { data, body: m[2] ?? "" };
+}
+function serialiseValue(key, value) {
+  if (/[\r\n]/.test(value))
+    throw new BlogAdminError(`"${key}" cannot contain line breaks.`);
+  if (!(/^["']|["']$|^\s|\s$|:\s/.test(value) || value === ""))
+    return value;
+  if (value.includes('"'))
+    return `'${value}'`;
+  return `"${value}"`;
+}
+function toFileContents(post) {
+  const fm = [];
+  for (const key of FIELD_ORDER) {
+    const raw = post[key];
+    if (typeof raw === "boolean") {
+      if (raw)
+        fm.push(`${key}: true`);
+      continue;
+    }
+    const value = String(raw ?? "");
+    if (!value)
+      continue;
+    fm.push(`${key}: ${serialiseValue(key, value)}`);
+  }
+  const body = post.body.replace(/\s+$/, "");
+  return `---
+${fm.join(`
+`)}
+---
+
+${body}
+`;
+}
+function readingTimeFor(body) {
+  const wordCount = body.split(/\s+/).filter(Boolean).length;
+  return { wordCount, readingTime: Math.max(1, Math.round(wordCount / 200)) };
+}
+function hydrate(slug, raw, updatedAt) {
+  const { data, body } = parseFrontmatter(raw), { wordCount, readingTime } = readingTimeFor(body);
+  return {
+    slug,
+    title: data.title ?? "",
+    description: data.description ?? "",
+    date: data.date ?? "",
+    author: data.author ?? "",
+    authorBio: data.authorBio ?? "",
+    poster: data.poster ?? "",
+    featured: data.featured === "true",
+    draft: data.draft === "true",
+    body: body.trim(),
+    wordCount,
+    readingTime,
+    updatedAt
+  };
+}
+function fileFor(slug) {
+  return join(CONTENT_DIR, `${assertSafeSlug(slug)}.md`);
+}
+export function listBlogPosts() {
+  if (!existsSync(CONTENT_DIR))
+    return [];
+  return readdirSync(CONTENT_DIR).filter((f) => f.endsWith(".md") && !f.startsWith(".")).map((f) => {
+    const path = join(CONTENT_DIR, f);
+    return hydrate(f.replace(/\.md$/, ""), readFileSync(path, "utf-8"), statSync(path).mtime.toISOString());
+  }).filter((p) => !!p.title).sort((a, b) => {
+    if (a.featured !== b.featured)
+      return a.featured ? -1 : 1;
+    return (b.date || "").localeCompare(a.date || "");
+  });
+}
+export function getBlogPost(slug) {
+  const file = fileFor(slug);
+  if (!existsSync(file))
+    return null;
+  return hydrate(slug, readFileSync(file, "utf-8"), statSync(file).mtime.toISOString());
+}
+export function saveBlogPost(input) {
+  const title = String(input.title ?? "").trim();
+  if (!title)
+    throw new BlogAdminError("A title is required.");
+  const slug = assertSafeSlug(String(input.slug ?? "").trim() || slugify(title)), originalSlug = input.originalSlug ? assertSafeSlug(input.originalSlug) : "", isRename = !!originalSlug && originalSlug !== slug;
+  if (existsSync(fileFor(slug)) && (!originalSlug || isRename))
+    throw new BlogAdminError(`A post with the slug "${slug}" already exists.`, 409);
+  if (originalSlug && !existsSync(fileFor(originalSlug)))
+    throw new BlogAdminError(`No post found with the slug "${originalSlug}".`, 404);
+  const date = String(input.date ?? "").trim() || new Date().toISOString().slice(0, 10);
+  if (!/^\d{4}-\d{2}-\d{2}$/.test(date))
+    throw new BlogAdminError("Date must be in YYYY-MM-DD format.");
+  const body = String(input.body ?? "").trim(), { wordCount, readingTime } = readingTimeFor(body), post = {
+    slug,
+    title,
+    description: String(input.description ?? "").trim(),
+    date,
+    author: String(input.author ?? "").trim(),
+    authorBio: String(input.authorBio ?? "").trim(),
+    poster: String(input.poster ?? "").trim(),
+    featured: input.featured === !0,
+    draft: input.draft === !0,
+    body,
+    wordCount,
+    readingTime,
+    updatedAt: new Date().toISOString()
+  };
+  if (!existsSync(CONTENT_DIR))
+    mkdirSync(CONTENT_DIR, { recursive: !0 });
+  writeFileSync(fileFor(slug), toFileContents(post), "utf-8");
+  if (isRename)
+    unlinkSync(fileFor(originalSlug));
+  return post;
+}
+export function deleteBlogPost(slug) {
+  const file = fileFor(slug);
+  if (!existsSync(file))
+    return !1;
+  unlinkSync(file);
+  return !0;
+}

package/dist/blog.d.ts

@@ -1,3 +1,14 @@
+/**
+ * An origin safe to bake into absolute links, or '' when it is not usable.
+ *
+ * The deploy-time build takes its baseUrl from `APP_URL`, which is not always
+ * plaintext: a release that loads an env file it cannot decrypt leaves the
+ * literal ciphertext there, and prefixing it with `https://` produced feed and
+ * sitemap URLs like `https://encrypted:tLq7…==/blog/introducing-stacks` on the
+ * live site. Anything that is not a parseable http(s) origin with a dotted
+ * hostname is rejected here so callers fall back to the configured site url.
+ */
+export declare function usableOrigin(value?: string): string;
 /**
  * Render a blog request via BunPress, or return null to let the caller handle
  * non-blog paths. Handles the listing, posts, the RSS feed, and the sitemap.

package/dist/blog.js

@@ -1,30 +1,155 @@
-// @bun
-import"./chunk-h3d81wrg.js";import{existsSync as R,mkdirSync as C,readdirSync as b,readFileSync as X,writeFileSync as o}from"fs";import{homedir as i}from"os";import{join as B}from"path";var M=B(process.cwd(),"content/blog"),E=B(M,".theme.css"),y={title:"The Stacks Blog",description:"Notes from building a full-stack TypeScript framework whose only dependencies are TypeScript and Bun.",siteTitle:"Stacks Blog",author:"The Stacks Team",url:"https://stacksjs.com",nav:[{text:"Blog",link:"/blog"},{text:"Docs",link:"/docs"},{text:"GitHub",link:"https://github.com/stacksjs/stacks"}],themes:["colored","light","dark"],defaultTheme:"colored",colophon:'Built with Stacks \xB7 TypeScript &amp; Bun \xB7 <a href="/blog/feed.xml">RSS</a>',emptyTitle:"No posts yet",emptyText:"The first one is in the works. Leave your email and it will land in your inbox the moment it ships."},q=null;function w(){if(!q)q=(async()=>{try{let z=(await import(B(process.cwd(),"config/blog.ts"))).default??{},J={...y,...z};if(!z.siteTitle&&z.title)J.siteTitle=z.title;return J}catch{return y}})();return q}var O=null;async function U(){if(!O)O=(async()=>{let G=[B(i(),"Code/Tools/bunpress/packages/bunpress/dist/src/index.js"),B(process.cwd(),"pantry/@stacksjs/bunpress/dist/src/index.js"),"@stacksjs/bunpress"];for(let z of G)try{if(z.startsWith("@")||R(z))return await import(z)}catch{}return null})();return O}function $(G){return String(G).replace(/[&<>"]/g,(z)=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;"})[z])}function L(G){return String(G).replace(/[&<>"']/g,(z)=>({"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&apos;"})[z])}function S(G,z){return`${G.replace(/\/$/,"")}/blog/${z}`}function r(G){if(!G)return"";let z=new Date(G);return Number.isNaN(z.getTime())?G:z.toUTCString()}async function H(G){let z=await w(),J=G||z.url,W=x().slice(0,50).map((Z)=>{let V=S(J,Z.slug);return`    <item>
-      <title>${L(Z.fm.title||Z.slug)}</title>
-      <link>${L(V)}</link>
-      <guid>${L(V)}</guid>
-      <pubDate>${L(r(Z.fm.date))}</pubDate>
-      <description>${L(Z.fm.description||"")}</description>
-    </item>`}).join(`
-`);return`<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0">
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const CONTENT_DIR = join(process.cwd(), "content/blog"), THEME_FILE = join(CONTENT_DIR, ".theme.css"), STACKS_DEFAULTS = {
+  title: "The Stacks Blog",
+  description: "Notes from building a full-stack TypeScript framework whose only dependencies are TypeScript and Bun.",
+  siteTitle: "Stacks Blog",
+  author: "The Stacks Team",
+  url: "https://stacksjs.com",
+  nav: [
+    { text: "Blog", link: "/blog" },
+    { text: "Docs", link: "/docs" },
+    { text: "GitHub", link: "https://github.com/stacksjs/stacks" }
+  ],
+  themes: ["colored", "light", "dark"],
+  defaultTheme: "colored",
+  colophon: 'Built with Stacks \xB7 TypeScript &amp; Bun \xB7 <a href="/blog/feed.xml">RSS</a>',
+  emptyTitle: "No posts yet",
+  emptyText: "The first one is in the works. Leave your email and it will land in your inbox the moment it ships."
+};
+let sitePromise = null;
+function site() {
+  if (!sitePromise)
+    sitePromise = (async () => {
+      try {
+        const cfg = (await import(join(process.cwd(), "config/blog.ts"))).default ?? {}, merged = { ...STACKS_DEFAULTS, ...cfg };
+        if (!cfg.siteTitle && cfg.title)
+          merged.siteTitle = cfg.title;
+        return merged;
+      } catch {
+        return STACKS_DEFAULTS;
+      }
+    })();
+  return sitePromise;
+}
+let bunpressPromise = null;
+async function loadBunPress() {
+  if (!bunpressPromise)
+    bunpressPromise = (async () => {
+      const candidates = [
+        join(homedir(), "Code/Tools/bunpress/packages/bunpress/dist/src/index.js"),
+        join(process.cwd(), "pantry/@stacksjs/bunpress/dist/src/index.js"),
+        "@stacksjs/bunpress"
+      ];
+      for (const entry of candidates)
+        try {
+          if (entry.startsWith("@") || existsSync(entry))
+            return await import(entry);
+        } catch {}
+      return null;
+    })();
+  return bunpressPromise;
+}
+function escapeHtml(s) {
+  return String(s).replace(/[&<>"]/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" })[c]);
+}
+function escapeXml(s) {
+  return String(s).replace(/[&<>"']/g, (c) => ({ "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;", "'": "&apos;" })[c]);
+}
+export function usableOrigin(value) {
+  if (!value)
+    return "";
+  try {
+    const url = new URL(/^https?:\/\//.test(value) ? value : `https://${value}`);
+    if (url.protocol !== "http:" && url.protocol !== "https:")
+      return "";
+    if (!url.hostname.includes(".") || !/^[a-z0-9.-]+$/i.test(url.hostname))
+      return "";
+    return url.origin;
+  } catch {
+    return "";
+  }
+}
+function postUrl(baseUrl, slug) {
+  return `${baseUrl.replace(/\/$/, "")}/blog/${slug}`;
+}
+function rssDate(date) {
+  if (!date)
+    return "";
+  const parsed = new Date(date);
+  return Number.isNaN(parsed.getTime()) ? date : parsed.toUTCString();
+}
+async function fallbackFeedXml(baseUrl) {
+  const cfg = await site(), origin = usableOrigin(baseUrl) || usableOrigin(cfg.url) || cfg.url, items = listPosts().slice(0, 50).map((p) => {
+    const url = postUrl(origin, p.slug);
+    return `    <item>
+      <title>${escapeXml(p.fm.title || p.slug)}</title>
+      <link>${escapeXml(url)}</link>
+      <guid>${escapeXml(url)}</guid>
+      <pubDate>${escapeXml(rssDate(p.fm.date))}</pubDate>
+      <description>${escapeXml(p.fm.description || "")}</description>
+      <dc:creator>${escapeXml(p.fm.author || cfg.author)}</dc:creator>
+    </item>`;
+  }).join(`
+`);
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:dc="http://purl.org/dc/elements/1.1/">
   <channel>
-    <title>${L(z.title)}</title>
-    <link>${L(`${J}/blog`)}</link>
-    <description>${L(z.description)}</description>
-${W}
+    <title>${escapeXml(cfg.title)}</title>
+    <link>${escapeXml(`${origin}/blog`)}</link>
+    <description>${escapeXml(cfg.description)}</description>
+${items}
   </channel>
-</rss>`}async function h(G){let z=await w(),J=G||z.url;return`<?xml version="1.0" encoding="UTF-8"?>
+</rss>`;
+}
+async function fallbackSitemapXml(baseUrl) {
+  const cfg = await site(), origin = usableOrigin(baseUrl) || usableOrigin(cfg.url) || cfg.url;
+  return `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
-${[`${J}/blog`,...x().map((W)=>S(J,W.slug))].map((W)=>`  <url><loc>${L(W)}</loc></url>`).join(`
+${[`${origin}/blog`, ...listPosts().map((p) => postUrl(origin, p.slug))].map((url) => `  <url><loc>${escapeXml(url)}</loc></url>`).join(`
 `)}
-</urlset>`}function m(G){let z=G.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);if(!z)return{data:{},body:G};let J={},Y=z[1]??"";for(let W of Y.split(`
-`)){let Z=W.indexOf(":");if(Z===-1)continue;let V=W.slice(0,Z).trim(),Q=W.slice(Z+1).trim();if(Q.startsWith('"')&&Q.endsWith('"')||Q.startsWith("'")&&Q.endsWith("'"))Q=Q.slice(1,-1);J[V]=Q}return{data:J,body:z[2]??""}}function T(G){if(!G)return"";let z=new Date(G);if(Number.isNaN(z.getTime()))return G;return`${["January","February","March","April","May","June","July","August","September","October","November","December"][z.getUTCMonth()]} ${z.getUTCDate()}, ${z.getUTCFullYear()}`}var P={colored:{label:"Park theme",glyph:"\uD83C\uDF32"},light:{label:"Light theme",glyph:"\u2600"},dark:{label:"Dark theme",glyph:"\uD83C\uDF19"}};async function D(){let G=await w(),z=G.themes.length?G.themes:y.themes,J=z.includes(G.defaultTheme)?G.defaultTheme:z[0],Y=z.map((Z)=>`<button type="button" data-t="${Z}" title="${P[Z].label}" aria-label="${P[Z].label}" onclick="stxBlogTheme('${Z}')">${P[Z].glyph}</button>`).join(`
-      `),W=z.length>1?`<div class="blog-theme-toggle" role="group" aria-label="Theme">
-      ${Y}
-    </div>`:"";return`<script>
+</urlset>`;
+}
+function parseFrontmatter(md) {
+  const m = md.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+  if (!m)
+    return { data: {}, body: md };
+  const data = {}, frontmatter = m[1] ?? "";
+  for (const line of frontmatter.split(`
+`)) {
+    const i = line.indexOf(":");
+    if (i === -1)
+      continue;
+    const key = line.slice(0, i).trim();
+    let val = line.slice(i + 1).trim();
+    if (val.startsWith('"') && val.endsWith('"') || val.startsWith("'") && val.endsWith("'"))
+      val = val.slice(1, -1);
+    data[key] = val;
+  }
+  return { data, body: m[2] ?? "" };
+}
+function formatDate(d) {
+  if (!d)
+    return "";
+  const date = new Date(d);
+  if (Number.isNaN(date.getTime()))
+    return d;
+  return `${["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"][date.getUTCMonth()]} ${date.getUTCDate()}, ${date.getUTCFullYear()}`;
+}
+const THEME_BUTTONS = {
+  colored: { label: "Park theme", glyph: "\uD83C\uDF32" },
+  light: { label: "Light theme", glyph: "\u2600" },
+  dark: { label: "Dark theme", glyph: "\uD83C\uDF19" }
+};
+async function blogChrome() {
+  const cfg = await site(), modes = cfg.themes.length ? cfg.themes : STACKS_DEFAULTS.themes, fallback = modes.includes(cfg.defaultTheme) ? cfg.defaultTheme : modes[0], buttons = modes.map((m) => `<button type="button" data-t="${m}" title="${THEME_BUTTONS[m].label}" aria-label="${THEME_BUTTONS[m].label}" onclick="stxBlogTheme('${m}')">${THEME_BUTTONS[m].glyph}</button>`).join(`
+      `), toggle = modes.length > 1 ? `<div class="blog-theme-toggle" role="group" aria-label="Theme">
+      ${buttons}
+    </div>` : "";
+  return `<script>
     (function () {
-      var modes = ${JSON.stringify(z)}
+      var modes = ${JSON.stringify(modes)}
       function ok(theme) {
         return modes.indexOf(theme) !== -1
       }
@@ -35,68 +160,132 @@ ${[`${J}/blog`,...x().map((W)=>S(J,W.slug))].map((W)=>`  <url><loc>${L(W)}</loc>
       }
       catch {}
 
+      // 'stacks-theme' is the shared key; the marketing page writes it too, so a
+      // choice made on / carries to /blog. 'stacks-blog-theme' is the old
+      // blog-only key, read once so an existing choice is not thrown away.
       var savedTheme = ''
       try {
-        savedTheme = localStorage.getItem('stacks-blog-theme') || ''
+        savedTheme = localStorage.getItem('stacks-theme') || localStorage.getItem('stacks-blog-theme') || ''
+      }
+      catch {}
+
+      // A visitor who has never chosen gets their OS preference rather than a
+      // hard-coded default, which is what prefers-color-scheme is for. The
+      // configured default still answers for everyone who prefers light.
+      var prefersDark = false
+      try {
+        prefersDark = window.matchMedia('(prefers-color-scheme: dark)').matches
       }
       catch {}
 
-      var theme = ok(queryTheme) ? queryTheme : (ok(savedTheme) ? savedTheme : ${JSON.stringify(J)})
+      var systemTheme = (prefersDark && ok('dark')) ? 'dark' : ${JSON.stringify(fallback)}
+      var theme = ok(queryTheme) ? queryTheme : (ok(savedTheme) ? savedTheme : systemTheme)
       document.documentElement.setAttribute('data-theme', theme)
       window.stxBlogTheme = function (nextTheme) {
         try {
-          localStorage.setItem('stacks-blog-theme', nextTheme)
+          localStorage.setItem('stacks-theme', nextTheme)
         }
         catch {}
         document.documentElement.setAttribute('data-theme', nextTheme)
       }
     })()
   </script>
-    ${W}`}async function F(){return`<div class="blog-landscape" aria-hidden="true">
+    ${toggle}`;
+}
+async function blogFooter() {
+  return `<div class="blog-landscape" aria-hidden="true">
       <span class="ridge"></span>
       <span class="river"></span>
-      <p class="colophon">${(await w()).colophon}</p>
-    </div>`}async function v(G,z){let J=await w(),Y=R(E)?X(E,"utf-8"):"",W=G.defaultConfig.markdown?.css||"";return{...G.defaultConfig,title:z.title||J.title,description:z.description||J.description,docsDir:M,theme:"vitepress",markdown:{...G.defaultConfig.markdown,css:`${W}
-${Y}`},themeConfig:{siteTitle:J.siteTitle,nav:J.nav}}}function x(){if(!R(M))return[];return b(M).filter((G)=>G.endsWith(".md")).map((G)=>{let{data:z}=m(X(B(M,G),"utf-8"));return{slug:G.replace(/\.md$/,""),fm:z}}).filter((G)=>!!G.fm.title&&!!G.fm.date).sort((G,z)=>{let J=G.fm.featured==="true"?1:0,Y=z.fm.featured==="true"?1:0;if(J!==Y)return Y-J;return(z.fm.date||"").localeCompare(G.fm.date||"")})}async function l(G){return G.wrapInLayout(await D()+`
+      <p class="colophon">${(await site()).colophon}</p>
+    </div>`;
+}
+async function blogConfig(bp, fm) {
+  const cfg = await site(), themeCss = existsSync(THEME_FILE) ? readFileSync(THEME_FILE, "utf-8") : "", baseCss = bp.defaultConfig.markdown?.css || "";
+  return {
+    ...bp.defaultConfig,
+    title: fm.title || cfg.title,
+    description: fm.description || cfg.description,
+    docsDir: CONTENT_DIR,
+    theme: "vitepress",
+    markdown: { ...bp.defaultConfig.markdown, css: `${baseCss}
+${themeCss}` },
+    themeConfig: {
+      siteTitle: cfg.siteTitle,
+      nav: cfg.nav
+    }
+  };
+}
+function listPosts() {
+  if (!existsSync(CONTENT_DIR))
+    return [];
+  return readdirSync(CONTENT_DIR).filter((f) => f.endsWith(".md")).map((f) => {
+    const { data } = parseFrontmatter(readFileSync(join(CONTENT_DIR, f), "utf-8"));
+    return { slug: f.replace(/\.md$/, ""), fm: data };
+  }).filter((p) => !!p.fm.title && !!p.fm.date && p.fm.draft !== "true").sort((a, b) => {
+    const fa = a.fm.featured === "true" ? 1 : 0, fb = b.fm.featured === "true" ? 1 : 0;
+    if (fa !== fb)
+      return fb - fa;
+    return (b.fm.date || "").localeCompare(a.fm.date || "");
+  });
+}
+async function notFoundHtml(bp) {
+  const body = `
     <a class="blog-back" href="/blog">\u2190 All posts</a>
     <div class="blog-404">
       <span class="blog-404-art" aria-hidden="true"></span>
       <h1>Nothing here</h1>
       <p>This post doesn't exist (or it moved). Head back to <a href="/blog">all posts</a>.</p>
-    </div>`+await F(),await v(G,{title:"Not found"}),"/blog","page")}async function u(G,z,J){let Y=await w(),W=B(M,`${z}.md`);if(!R(W))return null;let Z=X(W,"utf-8"),{html:V,frontmatter:Q}=await G.markdownToHtml(Z,M);if(!Q.title||!Q.date)return null;let K=Q.author||Y.author,k=$(K.charAt(0).toUpperCase()),j=`
+    </div>`;
+  return bp.wrapInLayout(await blogChrome() + body + await blogFooter(), await blogConfig(bp, { title: "Not found" }), "/blog", "page");
+}
+async function postHtml(bp, slug, origin) {
+  const cfg = await site(), file = join(CONTENT_DIR, `${slug}.md`);
+  if (!existsSync(file))
+    return null;
+  const raw = readFileSync(file, "utf-8"), { html, frontmatter: fm } = await bp.markdownToHtml(raw, CONTENT_DIR);
+  if (!fm.title || !fm.date || fm.draft === !0 || fm.draft === "true")
+    return null;
+  const author = fm.author || cfg.author, initial = escapeHtml(author.charAt(0).toUpperCase()), header = `
     <a class="blog-back" href="/blog">\u2190 All posts</a>
     <div class="blog-post-head">
-      <h1>${$(Q.title||z)}</h1>
+      <h1>${escapeHtml(fm.title || slug)}</h1>
       <p class="blog-post-meta">
-        <span class="author">${$(K)}</span>
+        <span class="author">${escapeHtml(author)}</span>
         <span class="dot">\xB7</span>
-        <time>${$(T(Q.date))}</time>
+        <time>${escapeHtml(formatDate(fm.date))}</time>
       </p>
-      ${Q.poster?`<figure class="blog-post-poster"><img src="${$(Q.poster)}" alt="${$(Q.title||"")}"></figure>`:""}
-    </div>`,I=Q.authorBio?`<aside class="blog-author-card">
-        <div class="avatar">${k}</div>
-        <div><span class="name">${$(K)}</span><p class="bio">${$(Q.authorBio)}</p></div>
-      </aside>`:"",_=`${J}/blog/${z}`,n=`
+      ${fm.poster ? `<figure class="blog-post-poster"><img src="${escapeHtml(fm.poster)}" alt="${escapeHtml(fm.title || "")}"></figure>` : ""}
+    </div>`, authorCard = fm.authorBio ? `<aside class="blog-author-card">
+        <div class="avatar">${initial}</div>
+        <div><span class="name">${escapeHtml(author)}</span><p class="bio">${escapeHtml(fm.authorBio)}</p></div>
+      </aside>` : "", shareUrl = `${origin}/blog/${slug}`, share = `
     <div class="blog-share">
       <span class="blog-share-label">Share</span>
-      <a href="https://twitter.com/intent/tweet?url=${encodeURIComponent(_)}&text=${encodeURIComponent(Q.title||"")}" target="_blank" rel="noreferrer">X / Twitter</a>
-      <a href="https://www.linkedin.com/sharing/share-offsite/?url=${encodeURIComponent(_)}" target="_blank" rel="noreferrer">LinkedIn</a>
-    </div>`,N=x().filter((A)=>A.slug!==z).slice(0,3),c=N.length?`<nav class="blog-more">
+      <a href="https://twitter.com/intent/tweet?url=${encodeURIComponent(shareUrl)}&text=${encodeURIComponent(fm.title || "")}" target="_blank" rel="noreferrer">X / Twitter</a>
+      <a href="https://www.linkedin.com/sharing/share-offsite/?url=${encodeURIComponent(shareUrl)}" target="_blank" rel="noreferrer">LinkedIn</a>
+    </div>`, others = listPosts().filter((p) => p.slug !== slug).slice(0, 3), more = others.length ? `<nav class="blog-more">
         <h2>More from the blog</h2>
-        <ul>${N.map((A)=>`<li><a href="/blog/${$(A.slug)}">${$(A.fm.title||A.slug)}</a></li>`).join("")}</ul>
-      </nav>`:"";return G.wrapInLayout(await D()+j+V+I+n+c+await F(),await v(G,Q),`/blog/${z}`,"page")}async function d(G){let z=await w(),Y=x().map((V)=>{let Q=V.fm.featured==="true",K=V.fm.poster?`<div class="blog-card-media"><img src="${$(V.fm.poster)}" alt="" loading="lazy"></div>`:"";return`<a class="blog-card${Q?" is-featured":""}" href="/blog/${$(V.slug)}">
-      ${K}
+        <ul>${others.map((p) => `<li><a href="/blog/${escapeHtml(p.slug)}">${escapeHtml(p.fm.title || p.slug)}</a></li>`).join("")}</ul>
+      </nav>` : "";
+  return bp.wrapInLayout(await blogChrome() + header + html + authorCard + share + more + await blogFooter(), await blogConfig(bp, fm), `/blog/${slug}`, "page");
+}
+async function indexHtml(bp) {
+  const cfg = await site(), cards = listPosts().map((p) => {
+    const featured = p.fm.featured === "true", media = p.fm.poster ? `<div class="blog-card-media"><img src="${escapeHtml(p.fm.poster)}" alt="" loading="lazy"></div>` : "";
+    return `<a class="blog-card${featured ? " is-featured" : ""}" href="/blog/${escapeHtml(p.slug)}">
+      ${media}
       <div>
-        ${Q?'<span class="blog-card-flag">Featured</span>':""}
-        <h2 class="blog-card-title">${$(V.fm.title||V.slug)}</h2>
-        <p class="blog-card-excerpt">${$((V.fm.description||"").slice(0,180))}</p>
-        <div class="blog-card-meta">${$(V.fm.author||z.author)} \xB7 ${$(T(V.fm.date))}</div>
+        ${featured ? '<span class="blog-card-flag">Featured</span>' : ""}
+        <h2 class="blog-card-title">${escapeHtml(p.fm.title || p.slug)}</h2>
+        <p class="blog-card-excerpt">${escapeHtml((p.fm.description || "").slice(0, 180))}</p>
+        <div class="blog-card-meta">${escapeHtml(p.fm.author || cfg.author)} \xB7 ${escapeHtml(formatDate(p.fm.date))}</div>
       </div>
-    </a>`}).join(`
-`),W=`
+    </a>`;
+  }).join(`
+`), emptyState = `
     <div class="blog-empty">
-      <h2>${$(z.emptyTitle)}</h2>
-      <p>${$(z.emptyText)}</p>
+      <h2>${escapeHtml(cfg.emptyTitle)}</h2>
+      <p>${escapeHtml(cfg.emptyText)}</p>
       <form class="blog-subscribe" method="POST" action="/api/email/subscribe">
         <input type="email" name="email" placeholder="you@example.com" autocomplete="email" aria-label="Email address" required>
         <input type="hidden" name="source" value="blog-empty">
@@ -139,10 +328,71 @@ ${Y}`},themeConfig:{siteTitle:J.siteTitle,nav:J.nav}}}function x(){if(!R(M))retu
             .finally(function () { if (button) button.disabled = false })
         })
       })()
-    </script>`,Z=`
+    </script>`, body = `
     <div class="blog-listing-head">
       <span class="sign" aria-hidden="true"></span>
-      <h1>${$(z.title)}</h1>
-      <p>${$(z.description)}</p>
+      <h1>${escapeHtml(cfg.title)}</h1>
+      <p>${escapeHtml(cfg.description)}</p>
     </div>
-    <div class="blog-cards">${Y||W}</div>`;return G.wrapInLayout(await D()+Z+await F(),await v(G,{title:z.title,description:z.description}),"/blog","page")}async function g(G,z){let J=await w(),Y={...await v(G,{title:J.title}),sitemap:{enabled:!0,baseUrl:`${z}/blog`}};return typeof G.buildRssFeed==="function"?G.buildRssFeed(M,Y,{enabled:!0,title:J.title,description:J.description,maxItems:50}):H(z)}async function f(G,z){let J={...await v(G,{title:"Blog"}),sitemap:{enabled:!0,baseUrl:`${z}/blog`}};return typeof G.buildSitemap==="function"?G.buildSitemap(M,J):h(z)}async function s(G){if(G.method!=="GET"&&G.method!=="HEAD")return null;let z=new URL(G.url),{pathname:J}=z,Y=J==="/blog/feed.xml",W=J==="/blog/sitemap.xml",Z=J==="/blog"||J==="/blog/"||/^\/blog\/[^/.]+$/.test(J);if(!Y&&!W&&!Z)return null;let V=await U();if(!V)return null;let Q=(j,I=200)=>new Response(j,{status:I,headers:{"Content-Type":"text/html; charset=utf-8"}});if(Y)return new Response(await g(V,z.origin),{headers:{"Content-Type":"application/rss+xml; charset=utf-8"}});if(W)return new Response(await f(V,z.origin),{headers:{"Content-Type":"application/xml; charset=utf-8"}});if(J==="/blog"||J==="/blog/")return Q(await d(V));let K=J.replace(/^\/blog\//,"").replace(/\/$/,""),k=await u(V,K,z.origin);return k?Q(k):Q(await l(V),404)}async function e(G){if(G.method!=="GET"&&G.method!=="HEAD")return null;let{pathname:z}=new URL(G.url);if(z==="/blog/feed.xml")return new Response(await H(""),{headers:{"Content-Type":"application/rss+xml; charset=utf-8"}});if(z==="/blog/sitemap.xml")return new Response(await h(""),{headers:{"Content-Type":"application/xml; charset=utf-8"}});return null}async function zz(G={outDir:"dist/blog"}){let z=G.outDir||"dist/blog",J=(G.baseUrl||(await w()).url).replace(/\/$/,""),Y=await U();if(!Y)throw Error("[blog] BunPress not found \u2014 cannot build the blog.");C(z,{recursive:!0});let W=(V,Q)=>{let K=B(z,V);C(B(K,".."),{recursive:!0}),o(K,Q,"utf-8")};W("index.html",await d(Y));let Z=x();for(let V of Z){let Q=await u(Y,V.slug,J);if(Q)W(B(V.slug,"index.html"),Q)}W("feed.xml",await g(Y,J)),W("sitemap.xml",await f(Y,J)),console.log(`[blog] built ${Z.length} post(s) + listing, feed.xml, sitemap.xml \u2192 ${z}`)}export{e as renderBlogFeed,s as renderBlog,zz as buildBlog};
+    <div class="blog-cards">${cards || emptyState}</div>`;
+  return bp.wrapInLayout(await blogChrome() + body + await blogFooter(), await blogConfig(bp, { title: cfg.title, description: cfg.description }), "/blog", "page");
+}
+async function feedXml(baseUrl) {
+  return fallbackFeedXml(baseUrl);
+}
+async function sitemapXml(baseUrl) {
+  return fallbackSitemapXml(baseUrl);
+}
+export async function renderBlog(req) {
+  if (req.method !== "GET" && req.method !== "HEAD")
+    return null;
+  const url = new URL(req.url), { pathname } = url, isFeed = pathname === "/blog/feed.xml", isSitemap = pathname === "/blog/sitemap.xml", isPage = pathname === "/blog" || pathname === "/blog/" || /^\/blog\/[^/.]+$/.test(pathname);
+  if (!isFeed && !isSitemap && !isPage)
+    return null;
+  const bp = await loadBunPress();
+  if (!bp)
+    return null;
+  const html = (s, status = 200) => new Response(s, { status, headers: { "Content-Type": "text/html; charset=utf-8" } });
+  if (isFeed)
+    return new Response(await feedXml(url.origin), { headers: { "Content-Type": "application/rss+xml; charset=utf-8" } });
+  if (isSitemap)
+    return new Response(await sitemapXml(url.origin), { headers: { "Content-Type": "application/xml; charset=utf-8" } });
+  if (pathname === "/blog" || pathname === "/blog/")
+    return html(await indexHtml(bp));
+  const slug = pathname.replace(/^\/blog\//, "").replace(/\/$/, ""), post = await postHtml(bp, slug, url.origin);
+  return post ? html(post) : html(await notFoundHtml(bp), 404);
+}
+export async function renderBlogFeed(req) {
+  if (req.method !== "GET" && req.method !== "HEAD")
+    return null;
+  const { pathname } = new URL(req.url);
+  if (pathname === "/blog/feed.xml")
+    return new Response(await fallbackFeedXml(""), { headers: { "Content-Type": "application/rss+xml; charset=utf-8" } });
+  if (pathname === "/blog/sitemap.xml")
+    return new Response(await fallbackSitemapXml(""), { headers: { "Content-Type": "application/xml; charset=utf-8" } });
+  return null;
+}
+export async function buildBlog(options = { outDir: "dist/blog" }) {
+  const outDir = options.outDir || "dist/blog", siteUrl = (await site()).url, baseUrl = usableOrigin(options.baseUrl) || usableOrigin(siteUrl) || siteUrl.replace(/\/$/, "");
+  if (options.baseUrl && !usableOrigin(options.baseUrl))
+    console.warn(`[blog] ignoring unusable baseUrl ${JSON.stringify(options.baseUrl)} \u2014 falling back to ${baseUrl}`);
+  const bp = await loadBunPress();
+  if (!bp)
+    throw Error("[blog] BunPress not found \u2014 cannot build the blog.");
+  mkdirSync(outDir, { recursive: !0 });
+  const write = (rel, content) => {
+    const target = join(outDir, rel);
+    mkdirSync(join(target, ".."), { recursive: !0 });
+    writeFileSync(target, content, "utf-8");
+  };
+  write("index.html", await indexHtml(bp));
+  const posts = listPosts();
+  for (const p of posts) {
+    const html = await postHtml(bp, p.slug, baseUrl);
+    if (html)
+      write(join(p.slug, "index.html"), html);
+  }
+  write("feed.xml", await feedXml(baseUrl));
+  write("sitemap.xml", await sitemapXml(baseUrl));
+  console.log(`[blog] built ${posts.length} post(s) + listing, feed.xml, sitemap.xml \u2192 ${outDir}`);
+}

package/dist/build/cli.js

@@ -1,2 +1,6 @@
-// @bun
-var{$:i}=globalThis.Bun;import{log as m}from"@stacksjs/cli";import{buddyPath as o}from"@stacksjs/path";m.info("Building CLI...");i.cwd(o());await i`bun ${o("build.ts")}`;
+import { $ } from "bun";
+import { log } from "@stacksjs/cli";
+import { buddyPath } from "@stacksjs/path";
+log.info("Building CLI...");
+$.cwd(buddyPath());
+await $`bun ${buddyPath("build.ts")}`;

package/dist/build/component-libs.js

@@ -1,2 +1,7 @@
-// @bun
-import{runCommand as r}from"@stacksjs/cli";import{NpmScript as m}from"@stacksjs/enums";import{frameworkPath as o}from"@stacksjs/path";await r(m.BuildComponents,{cwd:o(),verbose:!0});
+import { runCommand } from "@stacksjs/cli";
+import { NpmScript } from "@stacksjs/enums";
+import { frameworkPath } from "@stacksjs/path";
+await runCommand(NpmScript.BuildComponents, {
+  cwd: frameworkPath(),
+  verbose: !0
+});