@beforesemicolon/builder 1.8.23 → 1.8.24

package/README.md

@@ -304,6 +304,7 @@ A template config exports an object:
 ```js
 export default {
     meta: {},
+    site: {},
     markedOptions: {},
     markdownLayouts: {},
     headScripts: {},
@@ -322,6 +323,7 @@ Merge behavior:
 - `markdownLayouts` are shallow-merged by layout name.
 - `headScripts` and `scripts` are shallow-merged by script name.
 - `meta` is shallow-merged by metadata field.
+- `site` is shallow-merged by site field.
 - `theme.light` and `theme.dark` are shallow-merged by CSS variable name.
 - Other top-level config values use the docs source config value when provided.
 
@@ -337,6 +339,20 @@ export default {
         description: 'Documentation for Example.',
         image: '/assets/site-image.jpg',
     },
+    site: {
+        name: 'Example',
+        packageName: '@example/docs',
+        repositoryUrl: 'https://github.com/example/docs',
+        repositoryLabel: 'Example GitHub repository',
+        docsEditUrl: 'https://github.com/example/docs/tree/main/docs',
+        footerDescription: 'Documentation for Example.',
+        footerGroups: [
+            {
+                title: 'Learning Resources',
+                links: [{ label: 'Documentation', href: '/documentation' }],
+            },
+        ],
+    },
     markdownLayouts: {
         'pricing-cards': pricingCards,
     },
@@ -351,6 +367,16 @@ export default {
 }
 ```
 
+Common `site` fields:
+
+- `name`: display name used by shared layouts.
+- `packageName`: package name used by templates that render install commands.
+- `repositoryUrl` and `repositoryLabel`: repository link and accessible label.
+- `docsEditUrl`: base URL for edit links, usually a repository `docs` folder URL.
+- `navLinks` and `actionLinks`: landing header links.
+- `footerDescription`, `footerGroups`, `socialLinks`, and `copyright`: footer content.
+- `landingHeroVersionHref` and `landingHeroSecondaryLabel`: optional landing hero overrides.
+
 ## Markdown Layout Syntax
 
 The docs renderer extends `marked` with a custom block syntax:

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

@@ -1 +1 @@
-"use strict";var d=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var y=(o,r)=>d(o,"name",{value:r,configurable:!0});var m=(o,r)=>{for(var e in r)d(o,e,{get:r[e],enumerable:!0})},l=(o,r,e,t)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of w(r))!L.call(o,n)&&n!==e&&d(o,n,{get:()=>r[n],enumerable:!(t=M(r,n))||t.enumerable});return o};var c=o=>l(d({},"__esModule",{value:!0}),o);var x={};m(x,{createMarkdownLayoutExtension:()=>p});module.exports=c(x);var k=require("./parser.js"),u=require("./renderer.js");const p=y(({marked:o,handlers:r={},renderMarkdown:e})=>({extensions:[{name:"markdownLayout",level:"block",start(t){return t.match(/^::: layout /m)?.index},tokenizer(t){const n=(0,k.readLayoutBlock)(t);if(n)return{...(0,k.parseLayoutBlock)(n),type:"markdownLayout",raw:n}},renderer(t){const n=t,s={marked:o,renderMarkdown(a){return e?e(a):o.parse(a)},renderDefault(a){return(0,u.renderDefaultMarkdownLayout)(a,s)},renderParts(a){return a.items.map(i=>({...i,html:s.renderMarkdown(i.body)}))}};return(0,u.renderMarkdownLayout)(n,s,r)}}]}),"createMarkdownLayoutExtension");0&&(module.exports={createMarkdownLayoutExtension});
+"use strict";var k=Object.defineProperty;var M=Object.getOwnPropertyDescriptor;var L=Object.getOwnPropertyNames;var m=Object.prototype.hasOwnProperty;var w=(o,r)=>k(o,"name",{value:r,configurable:!0});var l=(o,r)=>{for(var t in r)k(o,t,{get:r[t],enumerable:!0})},c=(o,r,t,d)=>{if(r&&typeof r=="object"||typeof r=="function")for(let n of L(r))!m.call(o,n)&&n!==t&&k(o,n,{get:()=>r[n],enumerable:!(d=M(r,n))||d.enumerable});return o};var p=o=>c(k({},"__esModule",{value:!0}),o);var f={};l(f,{createMarkdownLayoutExtension:()=>x});module.exports=p(f);var u=require("./parser.js"),s=require("./renderer.js");const x=w(({marked:o,handlers:r={},renderMarkdown:t,templateConfig:d})=>({extensions:[{name:"markdownLayout",level:"block",start(n){return n.match(/^::: layout /m)?.index},tokenizer(n){const a=(0,u.readLayoutBlock)(n);if(a)return{...(0,u.parseLayoutBlock)(a),type:"markdownLayout",raw:a}},renderer(n){const a=n,i={marked:o,templateConfig:d,renderMarkdown(e){return t?t(e):o.parse(e)},renderDefault(e){return(0,s.renderDefaultMarkdownLayout)(e,i)},renderParts(e){return e.items.map(y=>({...y,html:i.renderMarkdown(y.body)}))}};return(0,s.renderMarkdownLayout)(a,i,r)}}]}),"createMarkdownLayoutExtension");0&&(module.exports={createMarkdownLayoutExtension});

package/dist/cjs/docs/markdown-layout/types.js

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

package/dist/cjs/docs/run.js

@@ -1,4 +1,4 @@
-"use strict";var ge=Object.create;var C=Object.defineProperty;var ye=Object.getOwnPropertyDescriptor;var we=Object.getOwnPropertyNames;var ve=Object.getPrototypeOf,Se=Object.prototype.hasOwnProperty;var m=(e,t)=>C(e,"name",{value:t,configurable:!0});var De=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},Q=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of we(t))!Se.call(e,n)&&n!==r&&C(e,n,{get:()=>t[n],enumerable:!(a=ye(t,n))||a.enumerable});return e};var v=(e,t,r)=>(r=e!=null?ge(ve(e)):{},Q(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),be=e=>Q(C({},"__esModule",{value:!0}),e);var Ue={};De(Ue,{buildDocs:()=>Ne});module.exports=be(Ue);const ze={};var re=require("marked"),c=require("fs/promises"),o=v(require("path"),1),oe=v(require("front-matter"),1),ae=v(require("isomorphic-dompurify"),1),ne=require("marked-highlight"),_=v(require("highlight.js"),1),ie=v(require("./templates/default.template.js"),1),le=v(require("./renderer/index.js"),1),ce=require("./markdown-layout/index.js"),me=v(require("clean-css"),1),ue=v(require("html-minifier"),1),X=v(require("@putout/minify"),1),P=require("url"),f=v(require("fs"),1);let V,A="";const Y=new me.default({inline:["none"]}),R=new Map;R.set("default",ie.default);let W;const Z=m((e,t)=>t===!1?!1:t===void 0?e:e===!1||e===void 0?t:{...e,...t},"mergeThemeMode"),xe=m((e,t)=>{if(!(!e&&!t))return{light:Z(e?.light,t?.light),dark:Z(e?.dark,t?.dark)}},"mergeTheme"),$e=m((e,t)=>({...e,...t,markdownLayouts:{...e.markdownLayouts,...t.markdownLayouts},headScripts:{...e.headScripts,...t.headScripts},scripts:{...e.scripts,...t.scripts},theme:xe(e.theme,t.theme),meta:{...e.meta,...t.meta}}),"mergeTemplateConfig"),Pe=m((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=m((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>Pe(r,t)).map(r=>typeof r=="function"?r():r.render()):[],"renderPageScripts"),G=m((e,t)=>{const r=Object.entries(t).filter(([a])=>a.startsWith("--")).map(([a,n])=>`    ${a}: ${n};`).join(`
+"use strict";var ge=Object.create;var C=Object.defineProperty;var ye=Object.getOwnPropertyDescriptor;var we=Object.getOwnPropertyNames;var ve=Object.getPrototypeOf,Se=Object.prototype.hasOwnProperty;var m=(e,t)=>C(e,"name",{value:t,configurable:!0});var De=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},Q=(e,t,r,a)=>{if(t&&typeof t=="object"||typeof t=="function")for(let n of we(t))!Se.call(e,n)&&n!==r&&C(e,n,{get:()=>t[n],enumerable:!(a=ye(t,n))||a.enumerable});return e};var v=(e,t,r)=>(r=e!=null?ge(ve(e)):{},Q(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),be=e=>Q(C({},"__esModule",{value:!0}),e);var Ue={};De(Ue,{buildDocs:()=>Ne});module.exports=be(Ue);const ze={};var re=require("marked"),c=require("fs/promises"),o=v(require("path"),1),oe=v(require("front-matter"),1),ae=v(require("isomorphic-dompurify"),1),ne=require("marked-highlight"),_=v(require("highlight.js"),1),ie=v(require("./templates/default.template.js"),1),le=v(require("./renderer/index.js"),1),ce=require("./markdown-layout/index.js"),me=v(require("clean-css"),1),ue=v(require("html-minifier"),1),X=v(require("@putout/minify"),1),P=require("url"),f=v(require("fs"),1);let V,A="";const Y=new me.default({inline:["none"]}),R=new Map;R.set("default",ie.default);let W;const Z=m((e,t)=>t===!1?!1:t===void 0?e:e===!1||e===void 0?t:{...e,...t},"mergeThemeMode"),$e=m((e,t)=>{if(!(!e&&!t))return{light:Z(e?.light,t?.light),dark:Z(e?.dark,t?.dark)}},"mergeTheme"),xe=m((e,t)=>({...e,...t,markdownLayouts:{...e.markdownLayouts,...t.markdownLayouts},headScripts:{...e.headScripts,...t.headScripts},scripts:{...e.scripts,...t.scripts},theme:$e(e.theme,t.theme),meta:{...e.meta,...t.meta},site:{...e.site,...t.site}}),"mergeTemplateConfig"),Pe=m((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=m((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>Pe(r,t)).map(r=>typeof r=="function"?r():r.render()):[],"renderPageScripts"),G=m((e,t)=>{const r=Object.entries(t).filter(([a])=>a.startsWith("--")).map(([a,n])=>`    ${a}: ${n};`).join(`
 `);return r?`${e} {
 ${r}
 }`:""},"renderThemeBlock"),ke=m(e=>{if(!e)return"";const t=e.light===!1,r=e.dark===!1,a=e.light===!1?void 0:e.light,n=r?void 0:e.dark,u=a||n;return u?[G(":root",u),n&&!t?`@media (prefers-color-scheme: dark) {
@@ -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"),$=m(async(e,t,r,a)=>{if(await Ce(e,t))return;const n=r();if(!n){a&&console.warn(a);return}await(0,c.mkdir)(o.default.dirname(t),{recursive:!0}),await(0,c.writeFile)(t,n)},"writeGeneratedFile"),_e=m(async({docsDir:e,docsSiteDir:t,pages:r,siteUrl:a,publicDir:n,generatedFiles:u})=>{u.sitemap&&await $(o.default.resolve(e,"sitemap.xml"),o.default.resolve(t,"sitemap.xml"),()=>Le(r,a),"Skipping generated sitemap.xml because buildDocs({ siteUrl }) is not set."),u.robots&&await $(o.default.resolve(e,"robots.txt"),o.default.resolve(t,"robots.txt"),()=>Ee(a)),u.llms&&await $(o.default.resolve(e,"llms.txt"),o.default.resolve(t,"llms.txt"),()=>Oe(r)),u.llmsFull&&await $(o.default.resolve(e,"llms-full.txt"),o.default.resolve(t,"llms-full.txt"),()=>Ae(r,a)),u.netlify&&(await $(o.default.resolve(e,"_redirects"),o.default.resolve(t,"_redirects"),()=>Re(r,u)),await $(o.default.resolve(e,"netlify.toml"),o.default.resolve(t,"netlify.toml"),()=>We(n&&o.default.basename(n))))},"writeGeneratedDocsFiles"),se=m((e={},t,r)=>{const a=new re.Marked((0,ne.markedHighlight)({langPrefix:"hljs language-",highlight(n,u){const h=_.default.getLanguage(u)?u:"plaintext";return _.default.highlight(n,{language:h}).value}}));return a.use({renderer:le.default}),a.use((0,ce.createMarkdownLayoutExtension)({marked:a,handlers:e.markdownLayouts,renderMarkdown:r})),e.markedOptions&&a.use(e.markedOptions),t&&a.use(t),a},"createBaseMarked"),Be=m((e={},t,r)=>{const a=se(e,t),n=m(h=>a.parse(h),"renderMarkdown"),u=se(e,t,n);return u.use({hooks:{postprocess(h){const{layout:w="default",...k}=W.attributes,T=ee(e.headScripts,h),M=ee(e.scripts,h);h=ae.default.sanitize(h);const b=[...h.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([\s\S]*?)<\/a><\/h\1>/gm)].map(p=>({path:p[2],label:p[3].replace(/<[^>]+>/g,"").replace(/\s+/g," ").trim(),level:p[1]}));return R.get(w)?.({...k,content:h,siteMap:W.siteMap,tableOfContent:b,projectMeta:V,renderMarkdown:n,headScripts:T,scripts:M,themeStylesheet:e.theme?`/stylesheets/theme.css?v=${A}`:void 0,cacheKey:A,siteUrl:r,templateConfig:e})||h}}}),u},"createMarked"),S=m(async e=>{const t=await(0,c.readdir)(e),r=[];for(const a of t){const n=o.default.extname(a);/^[._]/.test(a)||(n?r.push(o.default.join(e,a)):/(stylesheets|assets|scripts)/.test(a)||r.push(...await S(o.default.join(e,a))))}return r},"traverseDirectory"),Ne=m(async({srcDir:e,publicDir:t,markedOptions:r,template:a,siteUrl:n,generatedFiles:u}={})=>{A=Date.now().toString(36);try{const s=o.default.resolve(process.cwd(),"package.json");f.default.existsSync(s)&&(V=JSON.parse(await(0,c.readFile)(s,"utf-8")))}catch(s){console.warn("Failed to load project package.json metadata",s)}const h=m(()=>{try{return __dirname}catch{return o.default.dirname((0,P.fileURLToPath)(ze.url))}},"getDirname"),w=a?o.default.resolve(h(),"templates",a):null,k=w?o.default.resolve(w,"assets"):null,T=w?o.default.resolve(w,"stylesheets"):null,M=w?o.default.resolve(w,"layouts"):null;let b={};if(w)try{let s=o.default.resolve(w,"template.config.js");if(f.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),f.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href);b=i.default||i}}catch(s){console.error(`Failed to load template config for ${a}`,s)}const p=e??o.default.resolve(process.cwd(),"docs"),d=t??o.default.resolve(process.cwd(),"website"),pe=Ge(u),D=o.default.resolve(p,"_template"),B=o.default.resolve(D,"assets"),N=o.default.resolve(D,"stylesheets"),U=o.default.resolve(D,"scripts"),z=o.default.resolve(D,"layouts"),q=o.default.resolve(p,"_layouts"),F=o.default.resolve(p,"assets"),H=o.default.resolve(p,"stylesheets"),L=o.default.resolve(p,"scripts");try{let s=o.default.resolve(D,"template.config.js");if(f.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),f.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href),l=i.default||i;b=$e(b,l)}}catch(s){console.error("Failed to load docs _template config",s)}const fe=Be(b,r,n);if(await(0,c.mkdir)(d,{recursive:!0}),k&&f.default.existsSync(k))try{await(0,c.cp)(k,F.replace(p,d),{recursive:!0})}catch(s){console.warn(s)}if(f.default.existsSync(F))try{await(0,c.cp)(F,F.replace(p,d),{recursive:!0})}catch(s){console.warn(s)}if(f.default.existsSync(B))try{await(0,c.cp)(B,o.default.resolve(d,"assets"),{recursive:!0})}catch(s){console.warn(s)}await Fe(o.default.resolve(d,"assets"));try{const s=new Set;if(T&&f.default.existsSync(T)&&(await S(T)).forEach(l=>s.add(l)),f.default.existsSync(H)&&(await S(H)).forEach(l=>s.add(l)),f.default.existsSync(N)&&(await S(N)).forEach(l=>s.add(l)),s.size){await(0,c.mkdir)(o.default.join(d,"stylesheets"),{recursive:!0});for(const l of s){const g=await(0,c.readFile)(l,"utf-8"),y=Y.minify(g);y.errors.length&&y.errors.forEach(console.error);const j=l.startsWith(D)?l.replace(D,d):l.startsWith(p)?l.replace(p,d):o.default.join(d,"stylesheets",o.default.basename(l));await(0,c.writeFile)(j,y.styles??g)}}const i=ke(b.theme);if(i){const l=Y.minify(i);l.errors.length&&l.errors.forEach(console.error),await(0,c.mkdir)(o.default.join(d,"stylesheets"),{recursive:!0}),await(0,c.writeFile)(o.default.join(d,"stylesheets","theme.css"),l.styles??i)}}catch(s){console.error(s)}if(f.default.existsSync(L))try{const s=await S(L);s.length&&await(0,c.mkdir)(L.replace(p,d),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(p,d),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(f.default.existsSync(U))try{const s=await S(U);s.length&&await(0,c.mkdir)(o.default.join(d,"scripts"),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(D,d),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;M&&f.default.existsSync(M)&&(await S(M)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),f.default.existsSync(q)&&(await S(q)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),f.default.existsSync(z)&&(await S(z)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)});for(const[i,l]of s.entries()){const g=await import((0,P.pathToFileURL)(l).href);R.set(i,g.default)}}catch(s){console.error("Template import failed",s)}const de=await S(p),I=new Map,J=(await Promise.all(de.filter(s=>s.endsWith(".md")).map(async s=>{const i=await(0,c.readFile)(s,"utf-8");return{filePath:s,...(0,oe.default)(i)}}))).sort((s,i)=>(s.attributes.order??0)-(i.attributes.order??0)).map(({attributes:s,body:i,filePath:l})=>{const g=l.replace(p,"").replace(/\.md/,".html"),y=l.replace(p,d).replace(".md",".html"),j=y.replace(o.default.basename(y),""),E=o.default.basename(g)||"/",he=g.replace(E,"").replace(/\/$/,"");let x=I;he.split("/").filter(Boolean).forEach(O=>{x.has(O)||x.set(O,new Map),x=x.get(O)});const K={...s,path:g};return x.has(E)||x.set(E,K),{attributes:K,fileWebsitePath:y,fileDirWebsitePath:j,body:i,sourcePath:o.default.relative(p,l),siteMap:I}});for(const{attributes:s,body:i,fileDirWebsitePath:l,fileWebsitePath:g,siteMap:y}of J){W={attributes:s,siteMap:y};const j=await fe.parse(i);await(0,c.mkdir)(l,{recursive:!0}),await(0,c.writeFile)(g,ue.default.minify(j,{includeAutoGeneratedTags:!0,removeAttributeQuotes:!0,removeComments:!0,removeRedundantAttributes:!0,removeScriptTypeAttributes:!0,removeStyleLinkTypeAttributes:!0,sortClassName:!0,useShortDoctype:!0,collapseWhitespace:!0,minifyJS:!0,minifyCSS:!0}))}await _e({docsDir:p,docsSiteDir:d,pages:J.map(({attributes:s,body:i,sourcePath:l})=>{const g=je(String(s.path)),y=Me(i);return{sourcePath:l,urlPath:g,title:String(s.title||s.name||"").trim()||"Documentation",name:String(s.name||s.title||"").trim()||"Documentation",description:String(s.description||"").trim()||y.slice(0,156)||"Documentation page.",order:Number(s.order??999),summary:y.slice(0,320)}}),siteUrl:n,publicDir:d,generatedFiles:pe})},"buildDocs");0&&(module.exports={buildDocs});
+`,"generateNetlifyToml"),x=m(async(e,t,r,a)=>{if(await Ce(e,t))return;const n=r();if(!n){a&&console.warn(a);return}await(0,c.mkdir)(o.default.dirname(t),{recursive:!0}),await(0,c.writeFile)(t,n)},"writeGeneratedFile"),_e=m(async({docsDir:e,docsSiteDir:t,pages:r,siteUrl:a,publicDir:n,generatedFiles:u})=>{u.sitemap&&await x(o.default.resolve(e,"sitemap.xml"),o.default.resolve(t,"sitemap.xml"),()=>Le(r,a),"Skipping generated sitemap.xml because buildDocs({ siteUrl }) is not set."),u.robots&&await x(o.default.resolve(e,"robots.txt"),o.default.resolve(t,"robots.txt"),()=>Ee(a)),u.llms&&await x(o.default.resolve(e,"llms.txt"),o.default.resolve(t,"llms.txt"),()=>Oe(r)),u.llmsFull&&await x(o.default.resolve(e,"llms-full.txt"),o.default.resolve(t,"llms-full.txt"),()=>Ae(r,a)),u.netlify&&(await x(o.default.resolve(e,"_redirects"),o.default.resolve(t,"_redirects"),()=>Re(r,u)),await x(o.default.resolve(e,"netlify.toml"),o.default.resolve(t,"netlify.toml"),()=>We(n&&o.default.basename(n))))},"writeGeneratedDocsFiles"),se=m((e={},t,r)=>{const a=new re.Marked((0,ne.markedHighlight)({langPrefix:"hljs language-",highlight(n,u){const h=_.default.getLanguage(u)?u:"plaintext";return _.default.highlight(n,{language:h}).value}}));return a.use({renderer:le.default}),a.use((0,ce.createMarkdownLayoutExtension)({marked:a,handlers:e.markdownLayouts,renderMarkdown:r,templateConfig:e})),e.markedOptions&&a.use(e.markedOptions),t&&a.use(t),a},"createBaseMarked"),Be=m((e={},t,r)=>{const a=se(e,t),n=m(h=>a.parse(h),"renderMarkdown"),u=se(e,t,n);return u.use({hooks:{postprocess(h){const{layout:w="default",...k}=W.attributes,T=ee(e.headScripts,h),M=ee(e.scripts,h);h=ae.default.sanitize(h);const b=[...h.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([\s\S]*?)<\/a><\/h\1>/gm)].map(p=>({path:p[2],label:p[3].replace(/<[^>]+>/g,"").replace(/\s+/g," ").trim(),level:p[1]}));return R.get(w)?.({...k,content:h,siteMap:W.siteMap,tableOfContent:b,projectMeta:V,renderMarkdown:n,headScripts:T,scripts:M,themeStylesheet:e.theme?`/stylesheets/theme.css?v=${A}`:void 0,cacheKey:A,siteUrl:r,templateConfig:e})||h}}}),u},"createMarked"),S=m(async e=>{const t=await(0,c.readdir)(e),r=[];for(const a of t){const n=o.default.extname(a);/^[._]/.test(a)||(n?r.push(o.default.join(e,a)):/(stylesheets|assets|scripts)/.test(a)||r.push(...await S(o.default.join(e,a))))}return r},"traverseDirectory"),Ne=m(async({srcDir:e,publicDir:t,markedOptions:r,template:a,siteUrl:n,generatedFiles:u}={})=>{A=Date.now().toString(36);try{const s=o.default.resolve(process.cwd(),"package.json");f.default.existsSync(s)&&(V=JSON.parse(await(0,c.readFile)(s,"utf-8")))}catch(s){console.warn("Failed to load project package.json metadata",s)}const h=m(()=>{try{return __dirname}catch{return o.default.dirname((0,P.fileURLToPath)(ze.url))}},"getDirname"),w=a?o.default.resolve(h(),"templates",a):null,k=w?o.default.resolve(w,"assets"):null,T=w?o.default.resolve(w,"stylesheets"):null,M=w?o.default.resolve(w,"layouts"):null;let b={};if(w)try{let s=o.default.resolve(w,"template.config.js");if(f.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),f.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href);b=i.default||i}}catch(s){console.error(`Failed to load template config for ${a}`,s)}const p=e??o.default.resolve(process.cwd(),"docs"),d=t??o.default.resolve(process.cwd(),"website"),pe=Ge(u),D=o.default.resolve(p,"_template"),B=o.default.resolve(D,"assets"),N=o.default.resolve(D,"stylesheets"),U=o.default.resolve(D,"scripts"),z=o.default.resolve(D,"layouts"),q=o.default.resolve(p,"_layouts"),F=o.default.resolve(p,"assets"),H=o.default.resolve(p,"stylesheets"),L=o.default.resolve(p,"scripts");try{let s=o.default.resolve(D,"template.config.js");if(f.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),f.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href),l=i.default||i;b=xe(b,l)}}catch(s){console.error("Failed to load docs _template config",s)}const fe=Be(b,r,n);if(await(0,c.mkdir)(d,{recursive:!0}),k&&f.default.existsSync(k))try{await(0,c.cp)(k,F.replace(p,d),{recursive:!0})}catch(s){console.warn(s)}if(f.default.existsSync(F))try{await(0,c.cp)(F,F.replace(p,d),{recursive:!0})}catch(s){console.warn(s)}if(f.default.existsSync(B))try{await(0,c.cp)(B,o.default.resolve(d,"assets"),{recursive:!0})}catch(s){console.warn(s)}await Fe(o.default.resolve(d,"assets"));try{const s=new Set;if(T&&f.default.existsSync(T)&&(await S(T)).forEach(l=>s.add(l)),f.default.existsSync(H)&&(await S(H)).forEach(l=>s.add(l)),f.default.existsSync(N)&&(await S(N)).forEach(l=>s.add(l)),s.size){await(0,c.mkdir)(o.default.join(d,"stylesheets"),{recursive:!0});for(const l of s){const g=await(0,c.readFile)(l,"utf-8"),y=Y.minify(g);y.errors.length&&y.errors.forEach(console.error);const j=l.startsWith(D)?l.replace(D,d):l.startsWith(p)?l.replace(p,d):o.default.join(d,"stylesheets",o.default.basename(l));await(0,c.writeFile)(j,y.styles??g)}}const i=ke(b.theme);if(i){const l=Y.minify(i);l.errors.length&&l.errors.forEach(console.error),await(0,c.mkdir)(o.default.join(d,"stylesheets"),{recursive:!0}),await(0,c.writeFile)(o.default.join(d,"stylesheets","theme.css"),l.styles??i)}}catch(s){console.error(s)}if(f.default.existsSync(L))try{const s=await S(L);s.length&&await(0,c.mkdir)(L.replace(p,d),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(p,d),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(f.default.existsSync(U))try{const s=await S(U);s.length&&await(0,c.mkdir)(o.default.join(d,"scripts"),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(D,d),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;M&&f.default.existsSync(M)&&(await S(M)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),f.default.existsSync(q)&&(await S(q)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),f.default.existsSync(z)&&(await S(z)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)});for(const[i,l]of s.entries()){const g=await import((0,P.pathToFileURL)(l).href);R.set(i,g.default)}}catch(s){console.error("Template import failed",s)}const de=await S(p),I=new Map,J=(await Promise.all(de.filter(s=>s.endsWith(".md")).map(async s=>{const i=await(0,c.readFile)(s,"utf-8");return{filePath:s,...(0,oe.default)(i)}}))).sort((s,i)=>(s.attributes.order??0)-(i.attributes.order??0)).map(({attributes:s,body:i,filePath:l})=>{const g=l.replace(p,"").replace(/\.md/,".html"),y=l.replace(p,d).replace(".md",".html"),j=y.replace(o.default.basename(y),""),E=o.default.basename(g)||"/",he=g.replace(E,"").replace(/\/$/,"");let $=I;he.split("/").filter(Boolean).forEach(O=>{$.has(O)||$.set(O,new Map),$=$.get(O)});const K={...s,path:g};return $.has(E)||$.set(E,K),{attributes:K,fileWebsitePath:y,fileDirWebsitePath:j,body:i,sourcePath:o.default.relative(p,l),siteMap:I}});for(const{attributes:s,body:i,fileDirWebsitePath:l,fileWebsitePath:g,siteMap:y}of J){W={attributes:s,siteMap:y};const j=await fe.parse(i);await(0,c.mkdir)(l,{recursive:!0}),await(0,c.writeFile)(g,ue.default.minify(j,{includeAutoGeneratedTags:!0,removeAttributeQuotes:!0,removeComments:!0,removeRedundantAttributes:!0,removeScriptTypeAttributes:!0,removeStyleLinkTypeAttributes:!0,sortClassName:!0,useShortDoctype:!0,collapseWhitespace:!0,minifyJS:!0,minifyCSS:!0}))}await _e({docsDir:p,docsSiteDir:d,pages:J.map(({attributes:s,body:i,sourcePath:l})=>{const g=je(String(s.path)),y=Me(i);return{sourcePath:l,urlPath:g,title:String(s.title||s.name||"").trim()||"Documentation",name:String(s.name||s.title||"").trim()||"Documentation",description:String(s.description||"").trim()||y.slice(0,156)||"Documentation page.",order:Number(s.order??999),summary:y.slice(0,320)}}),siteUrl:n,publicDir:d,generatedFiles:pe})},"buildDocs");0&&(module.exports={buildDocs});

package/dist/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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/cjs/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')}