@beforesemicolon/builder 1.8.23 → 1.8.24

package/dist/cjs/docs/templates/fading-citrus/template.config.js

@@ -15,12 +15,34 @@ import landingCta from './layouts/landing-cta.js'
 
 export default {
     meta: {
-        siteName: 'Before Semicolon',
-        title: 'Before Semicolon Documentation',
-        description:
-            'Documentation for Before Semicolon projects, libraries, and developer tools.',
+        siteName: 'Documentation',
+        title: 'Project Documentation',
+        description: 'Documentation, guides, and references for this project.',
         image: '/assets/site-image.jpg',
     },
+    site: {
+        name: 'Documentation',
+        navLinks: [
+            { label: 'Features', href: '/#features' },
+            { label: 'Code', href: '/#code' },
+            { label: 'Install', href: '/#install' },
+        ],
+        actionLinks: [
+            {
+                label: 'Documentation',
+                href: '/documentation',
+                className: 'btn-primary',
+            },
+        ],
+        footerDescription:
+            'Documentation, guides, and references for this project.',
+        footerGroups: [
+            {
+                title: 'Documentation',
+                links: [{ label: 'Docs', href: '/documentation' }],
+            },
+        ],
+    },
     markdownLayouts: {
         'landing-hero': landingHero,
         'landing-ecosystem': landingEcosystem,

package/dist/cjs/docs/types.js

@@ -1 +1 @@
-"use strict";var i=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var p=(e,t,s,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let r of a(t))!g.call(e,r)&&r!==s&&i(e,r,{get:()=>t[r],enumerable:!(n=o(t,r))||n.enumerable});return e};var c=e=>p(i({},"__esModule",{value:!0}),e);var m={};module.exports=c(m);
+"use strict";var n=Object.defineProperty;var o=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var c=(e,t,s,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of a(t))!g.call(e,i)&&i!==s&&n(e,i,{get:()=>t[i],enumerable:!(r=o(t,i))||r.enumerable});return e};var p=e=>c(n({},"__esModule",{value:!0}),e);var l={};module.exports=p(l);

package/dist/esm/docs/markdown-layout/marked-extension.js

@@ -1 +1 @@
-var s=Object.defineProperty;var u=(t,e)=>s(t,"name",{value:e,configurable:!0});import{parseLayoutBlock as i,readLayoutBlock as y}from"./parser.js";import{renderDefaultMarkdownLayout as M,renderMarkdownLayout as w}from"./renderer.js";const N=u(({marked:t,handlers:e={},renderMarkdown:d})=>({extensions:[{name:"markdownLayout",level:"block",start(o){return o.match(/^::: layout /m)?.index},tokenizer(o){const n=y(o);if(n)return{...i(n),type:"markdownLayout",raw:n}},renderer(o){const n=o,a={marked:t,renderMarkdown(r){return d?d(r):t.parse(r)},renderDefault(r){return M(r,a)},renderParts(r){return r.items.map(k=>({...k,html:a.renderMarkdown(k.body)}))}};return w(n,a,e)}}]}),"createMarkdownLayoutExtension");export{N as createMarkdownLayoutExtension};
+var i=Object.defineProperty;var u=(t,e)=>i(t,"name",{value:e,configurable:!0});import{parseLayoutBlock as y,readLayoutBlock as w}from"./parser.js";import{renderDefaultMarkdownLayout as M,renderMarkdownLayout as L}from"./renderer.js";const C=u(({marked:t,handlers:e={},renderMarkdown:d,templateConfig:s})=>({extensions:[{name:"markdownLayout",level:"block",start(o){return o.match(/^::: layout /m)?.index},tokenizer(o){const n=w(o);if(n)return{...y(n),type:"markdownLayout",raw:n}},renderer(o){const n=o,a={marked:t,templateConfig:s,renderMarkdown(r){return d?d(r):t.parse(r)},renderDefault(r){return M(r,a)},renderParts(r){return r.items.map(k=>({...k,html:a.renderMarkdown(k.body)}))}};return L(n,a,e)}}]}),"createMarkdownLayoutExtension");export{C as createMarkdownLayoutExtension};

package/dist/esm/docs/run.js

@@ -1,4 +1,4 @@
-var ie=Object.defineProperty;var c=(e,t)=>ie(e,"name",{value:t,configurable:!0});import{Marked as le}from"marked";import{cp as j,mkdir as S,readdir as ce,readFile as C,writeFile as x}from"fs/promises";import o from"path";import me from"front-matter";import ue from"isomorphic-dompurify";import{markedHighlight as pe}from"marked-highlight";import Q from"highlight.js";import fe from"./templates/default.template.js";import de from"./renderer/index.js";import{createMarkdownLayoutExtension as he}from"./markdown-layout/index.js";import ge from"clean-css";import ye from"html-minifier";import*as X from"@putout/minify";import{fileURLToPath as we,pathToFileURL as A}from"url";import p from"fs";let V,R="";const Y=new ge({inline:["none"]}),W=new Map;W.set("default",fe);let _;const Z=c((e,t)=>t===!1?!1:t===void 0?e:e===!1||e===void 0?t:{...e,...t},"mergeThemeMode"),ve=c((e,t)=>{if(!(!e&&!t))return{light:Z(e?.light,t?.light),dark:Z(e?.dark,t?.dark)}},"mergeTheme"),Se=c((e,t)=>({...e,...t,markdownLayouts:{...e.markdownLayouts,...t.markdownLayouts},headScripts:{...e.headScripts,...t.headScripts},scripts:{...e.scripts,...t.scripts},theme:ve(e.theme,t.theme),meta:{...e.meta,...t.meta}}),"mergeTemplateConfig"),De=c((e,t)=>{if(typeof e=="function")return!0;const{match:r}=e;return r?typeof r=="string"?t.includes(r):Array.isArray(r)?r.some(a=>t.includes(a)):r instanceof RegExp?r.test(t):r(t):!0},"scriptMatches"),ee=c((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>De(r,t)).map(r=>typeof r=="function"?r():r.render()):[],"renderPageScripts"),G=c((e,t)=>{const r=Object.entries(t).filter(([a])=>a.startsWith("--")).map(([a,i])=>`    ${a}: ${i};`).join(`
+var ie=Object.defineProperty;var c=(e,t)=>ie(e,"name",{value:t,configurable:!0});import{Marked as le}from"marked";import{cp as j,mkdir as S,readdir as ce,readFile as C,writeFile as $}from"fs/promises";import o from"path";import me from"front-matter";import ue from"isomorphic-dompurify";import{markedHighlight as pe}from"marked-highlight";import Q from"highlight.js";import fe from"./templates/default.template.js";import de from"./renderer/index.js";import{createMarkdownLayoutExtension as he}from"./markdown-layout/index.js";import ge from"clean-css";import ye from"html-minifier";import*as X from"@putout/minify";import{fileURLToPath as we,pathToFileURL as A}from"url";import p from"fs";let V,R="";const Y=new ge({inline:["none"]}),W=new Map;W.set("default",fe);let _;const Z=c((e,t)=>t===!1?!1:t===void 0?e:e===!1||e===void 0?t:{...e,...t},"mergeThemeMode"),ve=c((e,t)=>{if(!(!e&&!t))return{light:Z(e?.light,t?.light),dark:Z(e?.dark,t?.dark)}},"mergeTheme"),Se=c((e,t)=>({...e,...t,markdownLayouts:{...e.markdownLayouts,...t.markdownLayouts},headScripts:{...e.headScripts,...t.headScripts},scripts:{...e.scripts,...t.scripts},theme:ve(e.theme,t.theme),meta:{...e.meta,...t.meta},site:{...e.site,...t.site}}),"mergeTemplateConfig"),De=c((e,t)=>{if(typeof e=="function")return!0;const{match:r}=e;return r?typeof r=="string"?t.includes(r):Array.isArray(r)?r.some(a=>t.includes(a)):r instanceof RegExp?r.test(t):r(t):!0},"scriptMatches"),ee=c((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>De(r,t)).map(r=>typeof r=="function"?r():r.render()):[],"renderPageScripts"),G=c((e,t)=>{const r=Object.entries(t).filter(([a])=>a.startsWith("--")).map(([a,i])=>`    ${a}: ${i};`).join(`
 `);return r?`${e} {
 ${r}
 }`:""},"renderThemeBlock"),be=c(e=>{if(!e)return"";const t=e.light===!1,r=e.dark===!1,a=e.light===!1?void 0:e.light,i=r?void 0:e.dark,m=a||i;return m?[G(":root",m),i&&!t?`@media (prefers-color-scheme: dark) {
@@ -7,10 +7,10 @@ ${G("    :root",i)}
 .site-logo-dark { display: block; }`:"",r&&a?`.site-logo-light { display: block; }
 .site-logo-dark { display: none; }`:""].filter(Boolean).join(`
 
-`):""},"renderThemeStylesheet"),xe=c((e="")=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),"escapeXML"),$e=c((e="")=>e.replace(/```[\s\S]*?```/g," ").replace(/`([^`]+)`/g,"$1").replace(/!\[[^\]]*]\([^)]*\)/g," ").replace(/\[([^\]]+)]\([^)]*\)/g,"$1").replace(/^#{1,6}\s+/gm,"").replace(/^---+$/gm," ").replace(/[>*_~]/g,"").replace(/\s+/g," ").trim(),"stripMarkdown"),Pe=c(e=>e==="/index.html"?"/":e.replace(/\/index\.html$/,"/").replace(/\.html$/,"").replace(/\/+/g,"/"),"pagePathToUrlPath"),te=c((e,t)=>e?`${e.replace(/\/$/,"")}${t==="/"?"/":t}`:t,"canonicalUrl"),ke=c(async(e,t)=>p.existsSync(e)?(await S(o.dirname(t),{recursive:!0}),await j(e,t),!0):!1,"copyIfExists"),Te=c(async e=>{const t=o.resolve(e,"logo.svg");p.existsSync(t)&&await Promise.all(["logo.light.svg","logo.dark.svg"].map(async r=>{const a=o.resolve(e,r);p.existsSync(a)||await j(t,a)}))},"ensureLogoModeAssets"),Me=c(e=>{const t={sitemap:!0,robots:!0,llms:!0,llmsFull:!0,netlify:!1};return e===!1?{sitemap:!1,robots:!1,llms:!1,llmsFull:!1,netlify:!1}:e===!0||e===void 0?t:{...t,...e}},"normalizeGeneratedFilesConfig"),je=c((e,t)=>{if(!t)return"";const r=new Date().toISOString().slice(0,10);return`<?xml version="1.0" encoding="UTF-8"?>
+`):""},"renderThemeStylesheet"),$e=c((e="")=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),"escapeXML"),xe=c((e="")=>e.replace(/```[\s\S]*?```/g," ").replace(/`([^`]+)`/g,"$1").replace(/!\[[^\]]*]\([^)]*\)/g," ").replace(/\[([^\]]+)]\([^)]*\)/g,"$1").replace(/^#{1,6}\s+/gm,"").replace(/^---+$/gm," ").replace(/[>*_~]/g,"").replace(/\s+/g," ").trim(),"stripMarkdown"),Pe=c(e=>e==="/index.html"?"/":e.replace(/\/index\.html$/,"/").replace(/\.html$/,"").replace(/\/+/g,"/"),"pagePathToUrlPath"),te=c((e,t)=>e?`${e.replace(/\/$/,"")}${t==="/"?"/":t}`:t,"canonicalUrl"),ke=c(async(e,t)=>p.existsSync(e)?(await S(o.dirname(t),{recursive:!0}),await j(e,t),!0):!1,"copyIfExists"),Te=c(async e=>{const t=o.resolve(e,"logo.svg");p.existsSync(t)&&await Promise.all(["logo.light.svg","logo.dark.svg"].map(async r=>{const a=o.resolve(e,r);p.existsSync(a)||await j(t,a)}))},"ensureLogoModeAssets"),Me=c(e=>{const t={sitemap:!0,robots:!0,llms:!0,llmsFull:!0,netlify:!1};return e===!1?{sitemap:!1,robots:!1,llms:!1,llmsFull:!1,netlify:!1}:e===!0||e===void 0?t:{...t,...e}},"normalizeGeneratedFilesConfig"),je=c((e,t)=>{if(!t)return"";const r=new Date().toISOString().slice(0,10);return`<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
 ${e.map(i=>{const m=i.urlPath==="/"?"1.0":"0.8";return`    <url>
-        <loc>${xe(te(t,i.urlPath))}</loc>
+        <loc>${$e(te(t,i.urlPath))}</loc>
         <lastmod>${r}</lastmod>
         <changefreq>weekly</changefreq>
         <priority>${m}</priority>
@@ -75,4 +75,4 @@ for = "/robots.txt"
 [headers.values]
 Content-Type = "text/plain; charset=utf-8"
 Cache-Control = "public, max-age=0, must-revalidate"
-`,"generateNetlifyToml"),$=c(async(e,t,r,a)=>{if(await ke(e,t))return;const i=r();if(!i){a&&console.warn(a);return}await S(o.dirname(t),{recursive:!0}),await x(t,i)},"writeGeneratedFile"),Oe=c(async({docsDir:e,docsSiteDir:t,pages:r,siteUrl:a,publicDir:i,generatedFiles:m})=>{m.sitemap&&await $(o.resolve(e,"sitemap.xml"),o.resolve(t,"sitemap.xml"),()=>je(r,a),"Skipping generated sitemap.xml because buildDocs({ siteUrl }) is not set."),m.robots&&await $(o.resolve(e,"robots.txt"),o.resolve(t,"robots.txt"),()=>Ce(a)),m.llms&&await $(o.resolve(e,"llms.txt"),o.resolve(t,"llms.txt"),()=>Fe(r)),m.llmsFull&&await $(o.resolve(e,"llms-full.txt"),o.resolve(t,"llms-full.txt"),()=>Ge(r,a)),m.netlify&&(await $(o.resolve(e,"_redirects"),o.resolve(t,"_redirects"),()=>Le(r,m)),await $(o.resolve(e,"netlify.toml"),o.resolve(t,"netlify.toml"),()=>Ee(i&&o.basename(i))))},"writeGeneratedDocsFiles"),se=c((e={},t,r)=>{const a=new le(pe({langPrefix:"hljs language-",highlight(i,m){const d=Q.getLanguage(m)?m:"plaintext";return Q.highlight(i,{language:d}).value}}));return a.use({renderer:de}),a.use(he({marked:a,handlers:e.markdownLayouts,renderMarkdown:r})),e.markedOptions&&a.use(e.markedOptions),t&&a.use(t),a},"createBaseMarked"),Ae=c((e={},t,r)=>{const a=se(e,t),i=c(d=>a.parse(d),"renderMarkdown"),m=se(e,t,i);return m.use({hooks:{postprocess(d){const{layout:y="default",...P}=_.attributes,k=ee(e.headScripts,d),T=ee(e.scripts,d);d=ue.sanitize(d);const D=[...d.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([\s\S]*?)<\/a><\/h\1>/gm)].map(u=>({path:u[2],label:u[3].replace(/<[^>]+>/g,"").replace(/\s+/g," ").trim(),level:u[1]}));return W.get(y)?.({...P,content:d,siteMap:_.siteMap,tableOfContent:D,projectMeta:V,renderMarkdown:i,headScripts:k,scripts:T,themeStylesheet:e.theme?`/stylesheets/theme.css?v=${R}`:void 0,cacheKey:R,siteUrl:r,templateConfig:e})||d}}}),m},"createMarked"),w=c(async e=>{const t=await ce(e),r=[];for(const a of t){const i=o.extname(a);/^[._]/.test(a)||(i?r.push(o.join(e,a)):/(stylesheets|assets|scripts)/.test(a)||r.push(...await w(o.join(e,a))))}return r},"traverseDirectory"),lt=c(async({srcDir:e,publicDir:t,markedOptions:r,template:a,siteUrl:i,generatedFiles:m}={})=>{R=Date.now().toString(36);try{const s=o.resolve(process.cwd(),"package.json");p.existsSync(s)&&(V=JSON.parse(await C(s,"utf-8")))}catch(s){console.warn("Failed to load project package.json metadata",s)}const d=c(()=>{try{return __dirname}catch{return o.dirname(we(import.meta.url))}},"getDirname"),y=a?o.resolve(d(),"templates",a):null,P=y?o.resolve(y,"assets"):null,k=y?o.resolve(y,"stylesheets"):null,T=y?o.resolve(y,"layouts"):null;let D={};if(y)try{let s=o.resolve(y,"template.config.js");if(p.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.existsSync(s)){const n=await import(A(s).href);D=n.default||n}}catch(s){console.error(`Failed to load template config for ${a}`,s)}const u=e??o.resolve(process.cwd(),"docs"),f=t??o.resolve(process.cwd(),"website"),re=Me(m),v=o.resolve(u,"_template"),B=o.resolve(v,"assets"),N=o.resolve(v,"stylesheets"),U=o.resolve(v,"scripts"),z=o.resolve(v,"layouts"),q=o.resolve(u,"_layouts"),F=o.resolve(u,"assets"),H=o.resolve(u,"stylesheets"),L=o.resolve(u,"scripts");try{let s=o.resolve(v,"template.config.js");if(p.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.existsSync(s)){const n=await import(A(s).href),l=n.default||n;D=Se(D,l)}}catch(s){console.error("Failed to load docs _template config",s)}const oe=Ae(D,r,i);if(await S(f,{recursive:!0}),P&&p.existsSync(P))try{await j(P,F.replace(u,f),{recursive:!0})}catch(s){console.warn(s)}if(p.existsSync(F))try{await j(F,F.replace(u,f),{recursive:!0})}catch(s){console.warn(s)}if(p.existsSync(B))try{await j(B,o.resolve(f,"assets"),{recursive:!0})}catch(s){console.warn(s)}await Te(o.resolve(f,"assets"));try{const s=new Set;if(k&&p.existsSync(k)&&(await w(k)).forEach(l=>s.add(l)),p.existsSync(H)&&(await w(H)).forEach(l=>s.add(l)),p.existsSync(N)&&(await w(N)).forEach(l=>s.add(l)),s.size){await S(o.join(f,"stylesheets"),{recursive:!0});for(const l of s){const h=await C(l,"utf-8"),g=Y.minify(h);g.errors.length&&g.errors.forEach(console.error);const M=l.startsWith(v)?l.replace(v,f):l.startsWith(u)?l.replace(u,f):o.join(f,"stylesheets",o.basename(l));await x(M,g.styles??h)}}const n=be(D.theme);if(n){const l=Y.minify(n);l.errors.length&&l.errors.forEach(console.error),await S(o.join(f,"stylesheets"),{recursive:!0}),await x(o.join(f,"stylesheets","theme.css"),l.styles??n)}}catch(s){console.error(s)}if(p.existsSync(L))try{const s=await w(L);s.length&&await S(L.replace(u,f),{recursive:!0});for(const n of s)try{const l=await C(n,"utf-8");await x(n.replace(u,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(p.existsSync(U))try{const s=await w(U);s.length&&await S(o.join(f,"scripts"),{recursive:!0});for(const n of s)try{const l=await C(n,"utf-8");await x(n.replace(v,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;T&&p.existsSync(T)&&(await w(T)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)}),p.existsSync(q)&&(await w(q)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)}),p.existsSync(z)&&(await w(z)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)});for(const[n,l]of s.entries()){const h=await import(A(l).href);W.set(n,h.default)}}catch(s){console.error("Template import failed",s)}const ae=await w(u),I=new Map,J=(await Promise.all(ae.filter(s=>s.endsWith(".md")).map(async s=>{const n=await C(s,"utf-8");return{filePath:s,...me(n)}}))).sort((s,n)=>(s.attributes.order??0)-(n.attributes.order??0)).map(({attributes:s,body:n,filePath:l})=>{const h=l.replace(u,"").replace(/\.md/,".html"),g=l.replace(u,f).replace(".md",".html"),M=g.replace(o.basename(g),""),E=o.basename(h)||"/",ne=h.replace(E,"").replace(/\/$/,"");let b=I;ne.split("/").filter(Boolean).forEach(O=>{b.has(O)||b.set(O,new Map),b=b.get(O)});const K={...s,path:h};return b.has(E)||b.set(E,K),{attributes:K,fileWebsitePath:g,fileDirWebsitePath:M,body:n,sourcePath:o.relative(u,l),siteMap:I}});for(const{attributes:s,body:n,fileDirWebsitePath:l,fileWebsitePath:h,siteMap:g}of J){_={attributes:s,siteMap:g};const M=await oe.parse(n);await S(l,{recursive:!0}),await x(h,ye.minify(M,{includeAutoGeneratedTags:!0,removeAttributeQuotes:!0,removeComments:!0,removeRedundantAttributes:!0,removeScriptTypeAttributes:!0,removeStyleLinkTypeAttributes:!0,sortClassName:!0,useShortDoctype:!0,collapseWhitespace:!0,minifyJS:!0,minifyCSS:!0}))}await Oe({docsDir:u,docsSiteDir:f,pages:J.map(({attributes:s,body:n,sourcePath:l})=>{const h=Pe(String(s.path)),g=$e(n);return{sourcePath:l,urlPath:h,title:String(s.title||s.name||"").trim()||"Documentation",name:String(s.name||s.title||"").trim()||"Documentation",description:String(s.description||"").trim()||g.slice(0,156)||"Documentation page.",order:Number(s.order??999),summary:g.slice(0,320)}}),siteUrl:i,publicDir:f,generatedFiles:re})},"buildDocs");export{lt as buildDocs};
+`,"generateNetlifyToml"),x=c(async(e,t,r,a)=>{if(await ke(e,t))return;const i=r();if(!i){a&&console.warn(a);return}await S(o.dirname(t),{recursive:!0}),await $(t,i)},"writeGeneratedFile"),Oe=c(async({docsDir:e,docsSiteDir:t,pages:r,siteUrl:a,publicDir:i,generatedFiles:m})=>{m.sitemap&&await x(o.resolve(e,"sitemap.xml"),o.resolve(t,"sitemap.xml"),()=>je(r,a),"Skipping generated sitemap.xml because buildDocs({ siteUrl }) is not set."),m.robots&&await x(o.resolve(e,"robots.txt"),o.resolve(t,"robots.txt"),()=>Ce(a)),m.llms&&await x(o.resolve(e,"llms.txt"),o.resolve(t,"llms.txt"),()=>Fe(r)),m.llmsFull&&await x(o.resolve(e,"llms-full.txt"),o.resolve(t,"llms-full.txt"),()=>Ge(r,a)),m.netlify&&(await x(o.resolve(e,"_redirects"),o.resolve(t,"_redirects"),()=>Le(r,m)),await x(o.resolve(e,"netlify.toml"),o.resolve(t,"netlify.toml"),()=>Ee(i&&o.basename(i))))},"writeGeneratedDocsFiles"),se=c((e={},t,r)=>{const a=new le(pe({langPrefix:"hljs language-",highlight(i,m){const d=Q.getLanguage(m)?m:"plaintext";return Q.highlight(i,{language:d}).value}}));return a.use({renderer:de}),a.use(he({marked:a,handlers:e.markdownLayouts,renderMarkdown:r,templateConfig:e})),e.markedOptions&&a.use(e.markedOptions),t&&a.use(t),a},"createBaseMarked"),Ae=c((e={},t,r)=>{const a=se(e,t),i=c(d=>a.parse(d),"renderMarkdown"),m=se(e,t,i);return m.use({hooks:{postprocess(d){const{layout:y="default",...P}=_.attributes,k=ee(e.headScripts,d),T=ee(e.scripts,d);d=ue.sanitize(d);const D=[...d.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([\s\S]*?)<\/a><\/h\1>/gm)].map(u=>({path:u[2],label:u[3].replace(/<[^>]+>/g,"").replace(/\s+/g," ").trim(),level:u[1]}));return W.get(y)?.({...P,content:d,siteMap:_.siteMap,tableOfContent:D,projectMeta:V,renderMarkdown:i,headScripts:k,scripts:T,themeStylesheet:e.theme?`/stylesheets/theme.css?v=${R}`:void 0,cacheKey:R,siteUrl:r,templateConfig:e})||d}}}),m},"createMarked"),w=c(async e=>{const t=await ce(e),r=[];for(const a of t){const i=o.extname(a);/^[._]/.test(a)||(i?r.push(o.join(e,a)):/(stylesheets|assets|scripts)/.test(a)||r.push(...await w(o.join(e,a))))}return r},"traverseDirectory"),lt=c(async({srcDir:e,publicDir:t,markedOptions:r,template:a,siteUrl:i,generatedFiles:m}={})=>{R=Date.now().toString(36);try{const s=o.resolve(process.cwd(),"package.json");p.existsSync(s)&&(V=JSON.parse(await C(s,"utf-8")))}catch(s){console.warn("Failed to load project package.json metadata",s)}const d=c(()=>{try{return __dirname}catch{return o.dirname(we(import.meta.url))}},"getDirname"),y=a?o.resolve(d(),"templates",a):null,P=y?o.resolve(y,"assets"):null,k=y?o.resolve(y,"stylesheets"):null,T=y?o.resolve(y,"layouts"):null;let D={};if(y)try{let s=o.resolve(y,"template.config.js");if(p.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.existsSync(s)){const n=await import(A(s).href);D=n.default||n}}catch(s){console.error(`Failed to load template config for ${a}`,s)}const u=e??o.resolve(process.cwd(),"docs"),f=t??o.resolve(process.cwd(),"website"),re=Me(m),v=o.resolve(u,"_template"),B=o.resolve(v,"assets"),N=o.resolve(v,"stylesheets"),U=o.resolve(v,"scripts"),z=o.resolve(v,"layouts"),q=o.resolve(u,"_layouts"),F=o.resolve(u,"assets"),H=o.resolve(u,"stylesheets"),L=o.resolve(u,"scripts");try{let s=o.resolve(v,"template.config.js");if(p.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.existsSync(s)){const n=await import(A(s).href),l=n.default||n;D=Se(D,l)}}catch(s){console.error("Failed to load docs _template config",s)}const oe=Ae(D,r,i);if(await S(f,{recursive:!0}),P&&p.existsSync(P))try{await j(P,F.replace(u,f),{recursive:!0})}catch(s){console.warn(s)}if(p.existsSync(F))try{await j(F,F.replace(u,f),{recursive:!0})}catch(s){console.warn(s)}if(p.existsSync(B))try{await j(B,o.resolve(f,"assets"),{recursive:!0})}catch(s){console.warn(s)}await Te(o.resolve(f,"assets"));try{const s=new Set;if(k&&p.existsSync(k)&&(await w(k)).forEach(l=>s.add(l)),p.existsSync(H)&&(await w(H)).forEach(l=>s.add(l)),p.existsSync(N)&&(await w(N)).forEach(l=>s.add(l)),s.size){await S(o.join(f,"stylesheets"),{recursive:!0});for(const l of s){const h=await C(l,"utf-8"),g=Y.minify(h);g.errors.length&&g.errors.forEach(console.error);const M=l.startsWith(v)?l.replace(v,f):l.startsWith(u)?l.replace(u,f):o.join(f,"stylesheets",o.basename(l));await $(M,g.styles??h)}}const n=be(D.theme);if(n){const l=Y.minify(n);l.errors.length&&l.errors.forEach(console.error),await S(o.join(f,"stylesheets"),{recursive:!0}),await $(o.join(f,"stylesheets","theme.css"),l.styles??n)}}catch(s){console.error(s)}if(p.existsSync(L))try{const s=await w(L);s.length&&await S(L.replace(u,f),{recursive:!0});for(const n of s)try{const l=await C(n,"utf-8");await $(n.replace(u,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(p.existsSync(U))try{const s=await w(U);s.length&&await S(o.join(f,"scripts"),{recursive:!0});for(const n of s)try{const l=await C(n,"utf-8");await $(n.replace(v,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;T&&p.existsSync(T)&&(await w(T)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)}),p.existsSync(q)&&(await w(q)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)}),p.existsSync(z)&&(await w(z)).forEach(n=>{/\.(j|t)s$/.test(n)&&s.set(o.basename(n).replace(/\.(j|t)s$/,""),n)});for(const[n,l]of s.entries()){const h=await import(A(l).href);W.set(n,h.default)}}catch(s){console.error("Template import failed",s)}const ae=await w(u),I=new Map,J=(await Promise.all(ae.filter(s=>s.endsWith(".md")).map(async s=>{const n=await C(s,"utf-8");return{filePath:s,...me(n)}}))).sort((s,n)=>(s.attributes.order??0)-(n.attributes.order??0)).map(({attributes:s,body:n,filePath:l})=>{const h=l.replace(u,"").replace(/\.md/,".html"),g=l.replace(u,f).replace(".md",".html"),M=g.replace(o.basename(g),""),E=o.basename(h)||"/",ne=h.replace(E,"").replace(/\/$/,"");let b=I;ne.split("/").filter(Boolean).forEach(O=>{b.has(O)||b.set(O,new Map),b=b.get(O)});const K={...s,path:h};return b.has(E)||b.set(E,K),{attributes:K,fileWebsitePath:g,fileDirWebsitePath:M,body:n,sourcePath:o.relative(u,l),siteMap:I}});for(const{attributes:s,body:n,fileDirWebsitePath:l,fileWebsitePath:h,siteMap:g}of J){_={attributes:s,siteMap:g};const M=await oe.parse(n);await S(l,{recursive:!0}),await $(h,ye.minify(M,{includeAutoGeneratedTags:!0,removeAttributeQuotes:!0,removeComments:!0,removeRedundantAttributes:!0,removeScriptTypeAttributes:!0,removeStyleLinkTypeAttributes:!0,sortClassName:!0,useShortDoctype:!0,collapseWhitespace:!0,minifyJS:!0,minifyCSS:!0}))}await Oe({docsDir:u,docsSiteDir:f,pages:J.map(({attributes:s,body:n,sourcePath:l})=>{const h=Pe(String(s.path)),g=xe(n);return{sourcePath:l,urlPath:h,title:String(s.title||s.name||"").trim()||"Documentation",name:String(s.name||s.title||"").trim()||"Documentation",description:String(s.description||"").trim()||g.slice(0,156)||"Documentation page.",order:Number(s.order??999),summary:g.slice(0,320)}}),siteUrl:i,publicDir:f,generatedFiles:re})},"buildDocs");export{lt as buildDocs};

package/dist/esm/docs/templates/fading-citrus/README.md

@@ -121,7 +121,7 @@ docs/_template/assets/logo.svg
 
 The footer also uses social icons from `/assets/*.svg`.
 
-The current header and footer still include Before Semicolon and Markup-oriented links and copy. If a site needs fully different navigation, footer link groups, or legal copy, override `_header.js`, `_footer.js`, or the full page layouts from `docs/_template/layouts`.
+Header and footer links are driven by `site` config. Override `_header.js`, `_footer.js`, or the full page layouts only when the HTML structure itself needs to change.
 
 ## Metadata
 
@@ -167,6 +167,57 @@ export default {
 
 Override `_head-meta.js` in `docs/_template/layouts` only when the generated metadata shape itself needs to change.
 
+## Site Identity And Links
+
+The template is generic. Product-specific labels, repository links, footer links, and edit links should live in `docs/_template/template.config.js` under `site`.
+
+```js
+// docs/_template/template.config.js
+export default {
+    site: {
+        name: 'Example',
+        packageName: '@example/project',
+        repositoryUrl: 'https://github.com/example/project',
+        repositoryLabel: 'Example GitHub repository',
+        docsEditUrl: 'https://github.com/example/project/tree/main/docs',
+        navLinks: [
+            { label: 'Features', href: '/#features' },
+            { label: 'Code', href: '/#code' },
+            { label: 'Install', href: '/#install' },
+        ],
+        actionLinks: [
+            {
+                label: 'Documentation',
+                href: '/documentation',
+                className: 'btn-primary',
+            },
+        ],
+        footerDescription: 'Documentation for Example.',
+        footerGroups: [
+            {
+                title: 'Learning Resources',
+                links: [{ label: 'Documentation', href: '/documentation' }],
+            },
+        ],
+        socialLinks: [
+            {
+                name: 'GitHub',
+                href: 'https://github.com/example',
+                icon: '/assets/github.svg',
+            },
+        ],
+        copyright: `Copyright © ${new Date().getFullYear()} Example.`,
+    },
+}
+```
+
+Relevant fields:
+
+- `repositoryUrl` powers the header GitHub links and the docs version badge.
+- `docsEditUrl` powers the “edit this doc” link. If omitted, that link is hidden.
+- `packageName` powers the default landing hero install command.
+- `navLinks`, `actionLinks`, `footerGroups`, and `socialLinks` replace the template defaults.
+
 ## Markdown Layout Handlers
 
 `template.config.js` registers these Markdown layout handlers:
@@ -227,7 +278,8 @@ Supported layout options:
 - `title2`: second headline line.
 - `primaryHref`: primary CTA URL. Defaults to `/documentation/get-started`.
 - `primaryLabel`: primary CTA label. Defaults to `Get Started`.
-- `secondaryLabel`: secondary CTA label. Defaults to `npm i @beforesemicolon/markup`.
+- `secondaryLabel`: secondary CTA label. Defaults to `site.landingHeroSecondaryLabel`, then `npm i ${site.packageName}`, then `Install`.
+- `versionHref`: version badge URL. Defaults to `site.landingHeroVersionHref`, then `site.repositoryUrl`.
 
 Supported parts:
 
@@ -238,7 +290,7 @@ Supported parts:
 Notes:
 
 - The secondary CTA currently points to `#install`.
-- The version badge currently links to the Markup GitHub repository. Override `landing-hero.js` if that needs to be generic.
+- The version badge links to `versionHref`, `site.landingHeroVersionHref`, or `site.repositoryUrl`.
 
 ## `landing-ecosystem`
 
@@ -579,9 +631,7 @@ docs/_template/template.config.js
 
 ## Assets
 
-The template includes a default asset set. Not all assets are generic; several exist because the template originally shipped with the Markup site.
-
-Generic or shared assets:
+The template includes only generic/shared assets. Product-specific logos, banners, screenshots, and icons should live in the docs source under `docs/_template/assets`.
 
 - `logo.svg`: compatibility fallback for the main site logo.
 - `logo.light.svg`: preferred logo on light backgrounds.
@@ -589,19 +639,6 @@ Generic or shared assets:
 - `favicon/*`: default favicons.
 - social icons: `medium2.svg`, `facebook.svg`, `instagram.svg`, `reddit.svg`, `twitter.svg`, `youtube.svg`.
 
-Markup-specific assets still present:
-
-- `markup-banner.jpg`
-- `markup-essentials-training.jpg`
-- `markup-favicon.*`
-- `markup-logo*`
-- `client-server.svg`
-- `fast.svg`
-- `independent.svg`
-- `reactive.svg`
-- `simple.svg`
-- `small.svg`
-
 Override assets from a docs project by adding files at the same target path:
 
 ```txt
@@ -732,18 +769,6 @@ export default {
 }
 ```
 
-## Known Template-Specific Assumptions
-
-Some template internals are still Markup or Before Semicolon oriented:
-
-- `_header.js` has Markup-oriented GitHub and documentation links.
-- `_footer.js` has Before Semicolon social links, footer copy, and learning links.
-- `document.js` builds edit links against the Markup GitHub docs path.
-- Some landing layout handlers contain default labels or links aimed at Markup docs.
-- Several assets are Markup-specific.
-
-These are template defaults, not builder requirements. Override them from `docs/_template` for another documentation site.
-
 ## Minimal Landing Page
 
 ````md

package/dist/esm/docs/templates/fading-citrus/assets/favicon/site.webmanifest

@@ -1,6 +1,6 @@
 {
-    "name": "Markup",
-    "short_name": "Markup",
+    "name": "Documentation",
+    "short_name": "Docs",
     "icons": [
         {
             "src": "/android-chrome-192x192.png",

package/dist/esm/docs/templates/fading-citrus/layouts/_footer.js

@@ -1,77 +1,70 @@
-const social = [
-    {
-        link: 'https://medium.com/before-semicolon',
-        icon: 'assets/medium2.svg',
-        name: 'Medium blog',
-    },
-    {
-        link: 'https://www.facebook.com/beforesemicolon/',
-        icon: 'assets/facebook.svg',
-        name: 'Facebook',
-    },
-    {
-        link: 'https://www.instagram.com/before_semicolon_/',
-        icon: 'assets/instagram.svg',
-        name: 'Instagram',
-    },
-    {
-        link: 'https://www.reddit.com/r/beforesemicolon/',
-        icon: 'assets/reddit.svg',
-        name: 'Reddit',
-    },
-    {
-        link: 'https://twitter.com/BeforeSemicolon',
-        icon: 'assets/twitter.svg',
-        name: 'Twitter',
-    },
+import {
+    escapeAttribute,
+    escapeHTML,
+    linkAttrs,
+    siteConfig,
+    siteName,
+} from './_layout-utils.js'
+
+const defaultFooterGroups = [
     {
-        link: 'https://www.youtube.com/channel/UCrU33aw1k9BqTIq2yKXrmBw',
-        icon: 'assets/youtube.svg',
-        name: 'YouTube',
+        title: 'Documentation',
+        links: [{ label: 'Docs', href: '/documentation' }],
     },
 ]
 
-export default (props = {}) => {
-    const siteName =
-        props.projectMeta?.name || props.name || props.title || 'Documentation'
-    const logo = `
+const renderLogo = (name) => `
             <span class="site-logo-pair">
-                <img class="site-logo site-logo-dark" src="/assets/logo.dark.svg" alt="${siteName} logo" width="100" height="30" />
+                <img class="site-logo site-logo-dark" src="/assets/logo.dark.svg" alt="${escapeAttribute(name)} logo" width="100" height="30" />
                 <img class="site-logo site-logo-light" src="/assets/logo.light.svg" alt="" width="100" height="30" aria-hidden="true" />
             </span>`
 
-    return `
-<footer class="site-footer">
-    <div class="footer-inner wrapper">
-        <div class="footer-brand">
-            ${logo}
-            <p>A reactive HTML templating system for building dynamic UIs with pure JavaScript. No build step. No virtual DOM.</p>
-        </div>
+const renderFooterGroup = (group) => `
         <ul class="footer-links">
-            <li><h4>Learning Resources</h4></li>
-            <li><a href="/documentation">Documentation</a></li>
-            <li><a target="_blank" rel="noopener" href="https://www.youtube.com/watch?v=mIr2XglV5nQ&list=PLpWvGP6yhJUgWNiz25vj__CArY9Z0O6ke&index=1">Essentials Training</a></li>
-        </ul>
-        <ul class="footer-links">
-            <li><h4>About <em>Before Semicolon</em></h4></li>
-            <li><a href="https://github.com/beforesemicolon" rel="noopener" target="_blank">Open Source</a></li>
-            <li><a href="https://beforesemicolon.com/" rel="noopener" target="_blank">Website</a></li>
-            <li><a href="https://medium.com/before-semicolon" rel="noopener" target="_blank">Blog</a></li>
-            <li><a href="https://www.youtube.com/channel/UCrU33aw1k9BqTIq2yKXrmBw" rel="noopener" target="_blank">YouTube Channel</a></li>
-        </ul>
-        <div class="footer-social" aria-label="social-media">
-            ${social
+            <li><h4>${escapeHTML(group.title)}</h4></li>
+            ${(group.links || [])
                 .map(
-                    (s) => `
-                    <a href="${s.link}" rel="noopener" target="_blank" aria-label="${s.name}">
-                        <span class="footer-social-icon" style="--icon: url('/${s.icon}')" aria-hidden="true"></span>
-                    </a>
-                `
+                    (link) =>
+                        `<li><a href="${escapeAttribute(link.href)}"${linkAttrs(link)}>${escapeHTML(link.label)}</a></li>`
                 )
                 .join('')}
+        </ul>`
+
+const renderSocialLink = (link) => `
+                    <a href="${escapeAttribute(link.href)}"${linkAttrs(link)} aria-label="${escapeAttribute(link.name)}">
+                        <span class="footer-social-icon" style="--icon: url('${escapeAttribute(link.icon)}')" aria-hidden="true"></span>
+                    </a>`
+
+export default (props = {}) => {
+    const site = siteConfig(props)
+    const name = siteName(props)
+    const description =
+        site.footerDescription ||
+        props.description ||
+        'Documentation, guides, and references for this project.'
+    const footerGroups = site.footerGroups || defaultFooterGroups
+    const socialLinks = site.socialLinks || []
+    const copyright =
+        site.copyright ||
+        `Copyright &copy; ${new Date().getFullYear()} ${escapeHTML(name)}. All rights reserved.`
+
+    return `
+<footer class="site-footer">
+    <div class="footer-inner wrapper">
+        <div class="footer-brand">
+            ${renderLogo(name)}
+            <p>${escapeHTML(description)}</p>
         </div>
+        ${footerGroups.map(renderFooterGroup).join('')}
+        ${
+            socialLinks.length
+                ? `<div class="footer-social" aria-label="social-media">
+            ${socialLinks.map(renderSocialLink).join('')}
+        </div>`
+                : ''
+        }
         <div class="footer-credit">
-            <span>Copyright &copy; ${new Date().getFullYear()} Before Semicolon. All rights reserved.</span>
+            <span>${copyright}</span>
         </div>
     </div>
 </footer>

package/dist/esm/docs/templates/fading-citrus/layouts/_header.js

@@ -1,42 +1,87 @@
-export default (props = {}) => {
-    const isDocs = props.path?.startsWith('/documentation')
-    const siteName =
-        props.projectMeta?.name || props.name || props.title || 'Documentation'
-    const logo = `
+import {
+    escapeAttribute,
+    escapeHTML,
+    linkAttrs,
+    siteConfig,
+    siteName,
+} from './_layout-utils.js'
+
+const githubIcon =
+    '<svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg>'
+
+const renderLogo = (name, width = 90, height = 27) => `
                 <span class="site-logo-pair">
-                    <img class="site-logo site-logo-dark" src="/assets/logo.dark.svg" alt="${siteName} logo" width="90" height="27" />
-                    <img class="site-logo site-logo-light" src="/assets/logo.light.svg" alt="" width="90" height="27" aria-hidden="true" />
+                    <img class="site-logo site-logo-dark" src="/assets/logo.dark.svg" alt="${escapeAttribute(name)} logo" width="${width}" height="${height}" />
+                    <img class="site-logo site-logo-light" src="/assets/logo.light.svg" alt="" width="${width}" height="${height}" aria-hidden="true" />
                 </span>`
 
+const defaultNavLinks = [
+    { label: 'Features', href: '/#features' },
+    { label: 'Code', href: '/#code' },
+    { label: 'Install', href: '/#install' },
+]
+
+const defaultActionLinks = [
+    {
+        label: 'Documentation',
+        href: '/documentation',
+        className: 'btn-primary',
+    },
+]
+
+const renderTextLink = (link) => `
+            <a href="${escapeAttribute(link.href)}"${linkAttrs(link)}${link.className ? ` class="${escapeAttribute(link.className)}"` : ''}${link.ariaLabel ? ` aria-label="${escapeAttribute(link.ariaLabel)}"` : ''}>${escapeHTML(link.label)}</a>`
+
+const renderRepositoryLink = (props, docs = false) => {
+    const site = siteConfig(props)
+
+    if (!site.repositoryUrl) return ''
+
+    const label = site.repositoryLabel || `${siteName(props)} repository`
+
+    if (docs) {
+        return `
+            <a href="${escapeAttribute(site.repositoryUrl)}" target="_blank" rel="noopener" aria-label="${escapeAttribute(label)}" class="github-link docs-github-link">
+                <span>v${escapeHTML(props.projectMeta?.version || '')}</span>
+                ${githubIcon}
+            </a>`
+    }
+
+    return `
+            <a href="${escapeAttribute(site.repositoryUrl)}" target="_blank" rel="noopener" aria-label="${escapeAttribute(label)}" class="github-link">
+                ${githubIcon}
+            </a>`
+}
+
+export default (props = {}) => {
+    const isDocs = props.path?.startsWith('/documentation')
+    const name = siteName(props)
+    const site = siteConfig(props)
+    const navLinks = site.navLinks || defaultNavLinks
+    const actionLinks = site.actionLinks || defaultActionLinks
+
     return `
 <header class="site-header">
     <div class="header-inner wrapper">
         <h1>
-            <a href="/" aria-label="${siteName} home">
-                ${logo}
+            <a href="/" aria-label="${escapeAttribute(name)} home">
+                ${renderLogo(name)}
             </a>
         </h1>
         ${
             isDocs
                 ? `
         <nav class="nav-actions docs-actions">
-            <a href="https://github.com/beforesemicolon/markup" target="_blank" rel="noopener" aria-label="Markup GitHub repository" class="github-link docs-github-link">
-                <span>v${props.projectMeta?.version || ''}</span>
-                <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg>
-            </a>
+            ${renderRepositoryLink(props, true)}
         </nav>
         `
                 : `
         <nav class="nav-links">
-            <a href="/#features">Features</a>
-            <a href="/#code">Code</a>
-            <a href="/#install">Install</a>
+            ${navLinks.map(renderTextLink).join('')}
         </nav>
         <nav class="nav-actions">
-            <a href="https://github.com/beforesemicolon/markup" target="_blank" rel="noopener" aria-label="GitHub" class="github-link">
-                <svg aria-hidden="true" viewBox="0 0 24 24" width="16" height="16" stroke="currentColor" stroke-width="2" fill="none" stroke-linecap="round" stroke-linejoin="round"><path d="M9 19c-5 1.5-5-2.5-7-3m14 6v-3.87a3.37 3.37 0 0 0-.94-2.61c3.14-.35 6.44-1.54 6.44-7A5.44 5.44 0 0 0 20 4.77 5.07 5.07 0 0 0 19.91 1S18.73.65 16 2.48a13.38 13.38 0 0 0-7 0C6.27.65 5.09 1 5.09 1A5.07 5.07 0 0 0 5 4.77a5.44 5.44 0 0 0-1.5 3.78c0 5.42 3.3 6.61 6.44 7A3.37 3.37 0 0 0 9 18.13V22"></path></svg>
-            </a>
-            <a href="/documentation" class="btn-primary">Documentation</a>
+            ${renderRepositoryLink(props)}
+            ${actionLinks.map(renderTextLink).join('')}
         </nav>
         `
         }

package/dist/esm/docs/templates/fading-citrus/layouts/_layout-utils.js

@@ -6,6 +6,26 @@ export const escapeHTML = (value = '') =>
         .replace(/"/g, '"')
         .replace(/'/g, ''')
 
+export const escapeAttribute = escapeHTML
+
+export const isExternalHref = (href = '') => /^(https?:)?\/\//.test(href)
+
+export const linkAttrs = (link = {}) => {
+    const href = link.href || '#'
+    const external = link.external ?? isExternalHref(href)
+
+    return external ? ' target="_blank" rel="noopener"' : ''
+}
+
+export const siteConfig = (props = {}) => props.templateConfig?.site || {}
+
+export const siteName = (props = {}) =>
+    siteConfig(props).name ||
+    props.projectMeta?.name ||
+    props.name ||
+    props.title ||
+    'Documentation'
+
 export const partByName = (parts, name) =>
     parts.find((part) => part.name === name)
 

package/dist/esm/docs/templates/fading-citrus/layouts/document.js

@@ -1,9 +1,7 @@
 import meta from './_head-meta.js'
 import header from './_header.js'
 import footer from './_footer.js'
-
-const githubDocsPath =
-    'https://github.com/beforesemicolon/markup/tree/main/docs'
+import { escapeAttribute, siteConfig } from './_layout-utils.js'
 
 const navCategoryToHTML = (docs, currentPath) =>
     Array.from(docs.entries())
@@ -27,6 +25,7 @@ export default (props) => {
     const docs = props.siteMap.get('documentation')
     const isDocsIndex = props.path === '/documentation/index.html'
     const cacheKey = props.cacheKey ? `?v=${props.cacheKey}` : ''
+    const docsEditUrl = siteConfig(props).docsEditUrl?.replace(/\/$/, '')
     const docsMenu = `<ul>${navCategoryToHTML(docs, props.path)}</ul>`
     const pages = [...docs.values()].flatMap((page) =>
         page instanceof Map ? [...page.values()] : [page]
@@ -74,7 +73,11 @@ export default (props) => {
                     ${nextPage ? `<a href="${nextPage.path.replace('.html', '')}" id="next-doc">${nextPage.name} <span aria-hidden="true">&gt;&gt;</span></a>` : ''}
                 </div>
                 
-                <a href="${`${githubDocsPath}${props.path.replace('.html', '')}.md`}" id="edit-doc">edit this doc</a>
+                ${
+                    docsEditUrl
+                        ? `<a href="${escapeAttribute(`${docsEditUrl}${props.path.replace('.html', '')}.md`)}" id="edit-doc" target="_blank" rel="noopener">edit this doc</a>`
+                        : ''
+                }
             </article>
             <aside id="table-of-content">
                 <h4>Content</h4>

package/dist/esm/docs/templates/fading-citrus/layouts/landing-hero.js

@@ -1,14 +1,17 @@
 import { renderCodeBlock } from './_code-snippet.js'
 import {
     codeFromPart,
+    escapeAttribute,
     icon,
     option,
     partByName,
+    siteConfig,
     statContent,
     withFirstParagraphClass,
 } from './_layout-utils.js'
 
-export default ({ parts, options }) => {
+export default ({ parts, options }, context = {}) => {
+    const site = siteConfig(context)
     const copy = partByName(parts, 'copy') || parts[0]
     const code = partByName(parts, 'code') || parts[1]
     const stats = parts.filter((part) => part.name === 'stat')
@@ -22,8 +25,13 @@ export default ({ parts, options }) => {
     const primaryLabel = option(options.primaryLabel, 'Get Started')
     const secondaryLabel = option(
         options.secondaryLabel,
-        'npm i @beforesemicolon/markup'
+        site.landingHeroSecondaryLabel ||
+            (site.packageName ? `npm i ${site.packageName}` : 'Install')
     )
+    const versionHref =
+        option(options.versionHref) ||
+        site.landingHeroVersionHref ||
+        site.repositoryUrl
 
     return `
         <section class="hero-section relative overflow-hidden">
@@ -33,7 +41,7 @@ export default ({ parts, options }) => {
                 <div class="hero-content">
                     ${
                         version
-                            ? `<a href="https://github.com/beforesemicolon/markup" target="_blank" rel="noopener" class="version-badge">
+                            ? `<a href="${escapeAttribute(versionHref || '#')}"${versionHref ? ' target="_blank" rel="noopener"' : ''} class="version-badge">
                                 ${icon('sparkles')}
                                 <span>${version}</span>
                                 ${icon('arrowRight')}