@beforesemicolon/builder 1.8.0 → 1.8.11

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

@@ -0,0 +1 @@
+"use strict";var a=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var t=(f,e,p,x)=>{if(e&&typeof e=="object"||typeof e=="function")for(let m of c(e))!d.call(f,m)&&m!==p&&a(f,m,{get:()=>e[m],enumerable:!(x=b(e,m))||x.enumerable});return f},r=(f,e,p)=>(t(f,e,"default"),p&&t(p,e,"default"));var g=f=>t(a({},"__esModule",{value:!0}),f);var o={};module.exports=g(o);r(o,require("./marked-extension.js"),module.exports);r(o,require("./parser.js"),module.exports);r(o,require("./renderer.js"),module.exports);r(o,require("./types.js"),module.exports);0&&(module.exports={...require("./marked-extension.js"),...require("./parser.js"),...require("./renderer.js"),...require("./types.js")});

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

@@ -0,0 +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});

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

@@ -0,0 +1,7 @@
+"use strict";var a=Object.defineProperty;var h=Object.getOwnPropertyDescriptor;var w=Object.getOwnPropertyNames;var L=Object.prototype.hasOwnProperty;var i=(e,t)=>a(e,"name",{value:t,configurable:!0});var g=(e,t)=>{for(var n in t)a(e,n,{get:t[n],enumerable:!0})},k=(e,t,n,r)=>{if(t&&typeof t=="object"||typeof t=="function")for(let o of w(t))!L.call(e,o)&&o!==n&&a(e,o,{get:()=>t[o],enumerable:!(r=h(t,o))||r.enumerable});return e};var x=e=>k(a({},"__esModule",{value:!0}),e);var j={};g(j,{parseItemHeader:()=>f,parseLayoutBlock:()=>$,parseLayoutHeader:()=>y,parseOptions:()=>d,readLayoutBlock:()=>N});module.exports=x(j);const l=/^::: layout(?:\s+.*)?$/,c=/^:::\s*$/,M=/^===(?:\s+.*)?$/,O=i(e=>{const t=e.replace(/^(['"])(.*)\1$/,"$2");return/^-?\d+(\.\d+)?$/.test(t)?Number(t):t==="true"?!0:t==="false"?!1:t},"coerceOptionValue"),p=i((e="")=>{const t=[],n=/\S+=("(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|\S*)|"[^"]*"|'[^']*'|\S+/g;let r;for(;r=n.exec(e);)t.push(r[0]);return t},"tokenizeOptions"),d=i((e="")=>p(e).reduce((t,n)=>{const r=n.indexOf("=");if(r===-1)return t[n]=!0,t;const o=n.slice(0,r).trim(),s=n.slice(r+1).trim();return o&&(t[o]=O(s)),t},{}),"parseOptions"),y=i(e=>{const t=e.replace(/^:::\s*layout\s*/,"").trim(),[n="",...r]=p(t);if(!n)throw new Error(`Invalid layout header: ${e}`);return{layoutType:n,options:d(r.join(" "))}},"parseLayoutHeader"),f=i(e=>{const t=e.replace(/^===\s*/,"").trim();if(!t)return{name:null,options:{}};const[n=null,...r]=p(t);return{name:n,options:d(r.join(" "))}},"parseItemHeader"),I=i(e=>{const t=e.split(`
+`),n=[];let r=0,o=null,s=[];const m=i(()=>{o&&(n.push({...o,body:s.join(`
+`).trim()}),s=[])},"pushCurrent");for(const u of t){if(l.test(u.trim())){o&&s.push(u),r+=1;continue}if(c.test(u.trim())&&r>0){r-=1,o&&s.push(u);continue}if(r===0&&M.test(u.trim())){m(),o=f(u.trim());continue}o&&s.push(u)}return m(),n.length?n:[{name:null,options:{},body:e.trim()}]},"splitLayoutItems"),$=i(e=>{const t=e.replace(/\s+$/,"").split(`
+`),n=t.shift();if(!n||!l.test(n.trim()))throw new Error("Layout block must start with `::: layout`.");return t.length&&c.test(t[t.length-1].trim())&&t.pop(),{...y(n.trim()),items:I(t.join(`
+`)),raw:e}},"parseLayoutBlock"),N=i(e=>{if(!e.startsWith("::: layout"))return null;const t=e.split(`
+`);let n=0;const r=[];for(const o of t){const s=o.trim();if(r.push(o),l.test(s))n+=1;else if(c.test(s)&&(n-=1,n===0))return r.join(`
+`)}return null},"readLayoutBlock");0&&(module.exports={parseItemHeader,parseLayoutBlock,parseLayoutHeader,parseOptions,readLayoutBlock});

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

@@ -0,0 +1 @@
+"use strict";var s=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var p=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var n=(t,o)=>s(t,"name",{value:o,configurable:!0});var i=(t,o)=>{for(var a in o)s(t,a,{get:o[a],enumerable:!0})},c=(t,o,a,r)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of p(o))!d.call(t,e)&&e!==a&&s(t,e,{get:()=>o[e],enumerable:!(r=l(o,e))||r.enumerable});return t};var w=t=>c(s({},"__esModule",{value:!0}),t);var $={};i($,{renderDefaultMarkdownLayout:()=>L,renderMarkdownLayout:()=>M});module.exports=w($);const y=n(t=>String(t).replace(/&/g,"&amp;").replace(/"/g,"&quot;").replace(/</g,"&lt;").replace(/>/g,"&gt;"),"escapeAttribute"),k=n(t=>`--${t.replace(/[A-Z]/g,o=>`-${o.toLowerCase()}`)}`,"optionToStyleName"),u=n(t=>{const o=Object.entries(t).filter(([,a])=>typeof a!="boolean").map(([a,r])=>`${k(a)}: ${r};`);return o.length?` style="${y(o.join(" "))}"`:""},"optionsToStyle"),L=n((t,o)=>{const a=y(t.layoutType),r=t.items.map(e=>`<section class="bfs-layout-item"${e.name?` data-name="${y(e.name)}"`:""}${u(e.options)}>${o.renderMarkdown(e.body)}</section>`).join("");return`<div class="bfs-layout bfs-layout-${a}" data-layout="${a}"${u(t.options)}>${r}</div>`},"renderDefaultMarkdownLayout"),M=n((t,o,a={})=>{const r=a[t.layoutType];return r?r({type:t.layoutType,options:t.options,parts:o.renderParts(t),raw:t.raw},o):o.renderDefault(t)},"renderMarkdownLayout");0&&(module.exports={renderDefaultMarkdownLayout,renderMarkdownLayout});

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

@@ -0,0 +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);

package/dist/cjs/docs/run.js

@@ -1 +1,76 @@
-"use strict";var V=Object.create;var S=Object.defineProperty;var X=Object.getOwnPropertyDescriptor;var Y=Object.getOwnPropertyNames;var Z=Object.getPrototypeOf,tt=Object.prototype.hasOwnProperty;var D=(s,a)=>S(s,"name",{value:a,configurable:!0});var et=(s,a)=>{for(var o in a)S(s,o,{get:a[o],enumerable:!0})},R=(s,a,o,c)=>{if(a&&typeof a=="object"||typeof a=="function")for(let l of Y(a))!tt.call(s,l)&&l!==o&&S(s,l,{get:()=>a[l],enumerable:!(c=X(a,l))||c.enumerable});return s};var f=(s,a,o)=>(o=s!=null?V(Z(s)):{},R(a||!s||!s.__esModule?S(o,"default",{value:s,enumerable:!0}):o,s)),st=s=>R(S({},"__esModule",{value:!0}),s);var it={};et(it,{buildDocs:()=>ot});module.exports=st(it);const nt={};var B=require("marked"),i=require("fs/promises"),r=f(require("path"),1),z=f(require("front-matter"),1),J=f(require("isomorphic-dompurify"),1),U=require("marked-highlight"),L=f(require("highlight.js"),1),G=f(require("./templates/default.template.js"),1),H=f(require("./renderer/index.js"),1),Q=f(require("clean-css"),1),q=f(require("html-minifier"),1),rt=f(require("@putout/minify"),1),b=require("url"),m=f(require("fs"),1);let _;const at=new Q.default({inline:["none"]}),E=new Map;E.set("default",G.default);let A;const v=new B.Marked((0,U.markedHighlight)({langPrefix:"hljs language-",highlight(s,a){const o=L.default.getLanguage(a)?a:"plaintext";return L.default.highlight(s,{language:o}).value}}));v.use({renderer:H.default});const g=D(async s=>{const a=await(0,i.readdir)(s),o=[];for(const c of a){const l=r.default.extname(c);/^[._]/.test(c)||(l?o.push(r.default.join(s,c)):/(stylesheets|assets|scripts)/.test(c)||o.push(...await g(r.default.join(s,c))))}return o},"traverseDirectory");v.use({hooks:{postprocess(s){const{layout:a="default",...o}=A.attributes;s=J.default.sanitize(s);const c=[...s.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([^<]+)<\/a>/gm)].map(l=>({path:l[2],label:l[3],level:l[1]}));return E.get(a)?.({...o,content:s,siteMap:A.siteMap,tableOfContent:c,projectMeta:_})||s}}});const ot=D(async({srcDir:s,publicDir:a,markedOptions:o,template:c}={})=>{try{const t=r.default.resolve(process.cwd(),"package.json");m.default.existsSync(t)&&(_=JSON.parse(await(0,i.readFile)(t,"utf-8")))}catch(t){console.warn("Failed to load project package.json metadata",t)}const l=D(()=>{try{return __dirname}catch{return r.default.dirname((0,b.fileURLToPath)(nt.url))}},"getDirname"),d=c?r.default.resolve(l(),"templates",c):null,j=d?r.default.resolve(d,"assets"):null,x=d?r.default.resolve(d,"stylesheets"):null,P=d?r.default.resolve(d,"layouts"):null;if(d)try{let t=r.default.resolve(d,"template.config.js");if(m.default.existsSync(t)||(t=t.replace(/\.js$/,".ts")),m.default.existsSync(t)){const e=await import((0,b.pathToFileURL)(t).href),n=e.default||e;n.markedOptions&&v.use(n.markedOptions)}}catch(t){console.error(`Failed to load template config for ${c}`,t)}o&&v.use(o);const p=s??r.default.resolve(process.cwd(),"docs"),h=a??r.default.resolve(process.cwd(),"website"),T=r.default.resolve(p,"_layouts"),M=r.default.resolve(p,"assets"),$=r.default.resolve(p,"stylesheets"),k=r.default.resolve(p,"scripts");if(await(0,i.mkdir)(h,{recursive:!0}),j&&m.default.existsSync(j))try{await(0,i.cp)(j,M.replace(p,h),{recursive:!0})}catch(t){console.warn(t)}if(m.default.existsSync(M))try{await(0,i.cp)(M,M.replace(p,h),{recursive:!0})}catch(t){console.warn(t)}try{const t=new Set;if(x&&m.default.existsSync(x)&&(await g(x)).forEach(e=>t.add(e)),m.default.existsSync($)&&(await g($)).forEach(e=>t.add(e)),t.size){await(0,i.mkdir)(r.default.join(h,"stylesheets"),{recursive:!0});for(const e of t){const n=await(0,i.readFile)(e,"utf-8"),u=at.minify(n);u.errors.length&&u.errors.forEach(console.error);const y=e.startsWith(p)?e.replace(p,h):r.default.join(h,"stylesheets",r.default.basename(e));await(0,i.writeFile)(y,u.styles??n)}}}catch(t){console.error(t)}if(m.default.existsSync(k))try{const t=await g(k);t.length&&await(0,i.mkdir)(k.replace(p,h),{recursive:!0});for(const e of t)try{const n=await(0,i.readFile)(e,"utf-8");await(0,i.writeFile)(e.replace(p,h),rt.minify(n))}catch(n){console.error(n)}}catch(t){console.warn(t)}try{const t=new Map;P&&m.default.existsSync(P)&&(await g(P)).forEach(e=>{/\.(j|t)s$/.test(e)&&t.set(r.default.basename(e).replace(/\.(j|t)s$/,""),e)}),m.default.existsSync(T)&&(await g(T)).forEach(e=>{/\.(j|t)s$/.test(e)&&t.set(r.default.basename(e).replace(/\.(j|t)s$/,""),e)});for(const[e,n]of t.entries()){const u=await import((0,b.pathToFileURL)(n).href);E.set(e,u.default)}}catch(t){console.error("Template import failed",t)}const I=await g(p),W=new Map;(await Promise.all(I.filter(t=>t.endsWith(".md")).map(async t=>{const e=await(0,i.readFile)(t,"utf-8");return{filePath:t,...(0,z.default)(e)}}))).sort((t,e)=>(t.attributes.order??0)-(e.attributes.order??0)).map(({attributes:t,body:e,filePath:n})=>{const u=n.replace(p,"").replace(/\.md/,".html"),y=n.replace(p,h).replace(".md",".html"),O=y.replace(r.default.basename(y),""),C=r.default.basename(u)||"/",K=u.replace(C,"").replace(/\/$/,"");let w=W;K.split("/").filter(Boolean).forEach(F=>{w.has(F)||w.set(F,new Map),w=w.get(F)});const N={...t,path:u};return w.has(C)||w.set(C,N),{attributes:N,fileWebsitePath:y,fileDirWebsitePath:O,body:e,siteMap:W}}).forEach(async({attributes:t,body:e,fileDirWebsitePath:n,fileWebsitePath:u,siteMap:y})=>{A={attributes:t,siteMap:y};const O=await v.parse(e);await(0,i.mkdir)(n,{recursive:!0}),await(0,i.writeFile)(u,q.default.minify(O,{includeAutoGeneratedTags:!0,removeAttributeQuotes:!0,removeComments:!0,removeRedundantAttributes:!0,removeScriptTypeAttributes:!0,removeStyleLinkTypeAttributes:!0,sortClassName:!0,useShortDoctype:!0,collapseWhitespace:!0,minifyJS:!0,minifyCSS:!0}))})},"buildDocs");0&&(module.exports={buildDocs});
+"use strict";var fe=Object.create;var C=Object.defineProperty;var de=Object.getOwnPropertyDescriptor;var he=Object.getOwnPropertyNames;var ge=Object.getPrototypeOf,ye=Object.prototype.hasOwnProperty;var m=(e,t)=>C(e,"name",{value:t,configurable:!0});var we=(e,t)=>{for(var r in t)C(e,r,{get:t[r],enumerable:!0})},Q=(e,t,r,n)=>{if(t&&typeof t=="object"||typeof t=="function")for(let i of he(t))!ye.call(e,i)&&i!==r&&C(e,i,{get:()=>t[i],enumerable:!(n=de(t,i))||n.enumerable});return e};var w=(e,t,r)=>(r=e!=null?fe(ge(e)):{},Q(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),ve=e=>Q(C({},"__esModule",{value:!0}),e);var _e={};we(_e,{buildDocs:()=>We});module.exports=ve(_e);const Be={};var ee=require("marked"),c=require("fs/promises"),o=w(require("path"),1),te=w(require("front-matter"),1),se=w(require("isomorphic-dompurify"),1),re=require("marked-highlight"),W=w(require("highlight.js"),1),oe=w(require("./templates/default.template.js"),1),ae=w(require("./renderer/index.js"),1),ne=require("./markdown-layout/index.js"),ie=w(require("clean-css"),1),le=w(require("html-minifier"),1),X=w(require("@putout/minify"),1),$=require("url"),p=w(require("fs"),1);let K;const V=new ie.default({inline:["none"]}),A=new Map;A.set("default",oe.default);let R;const xe=m((e,t)=>{if(!(!e&&!t))return{light:{...e?.light,...t?.light},dark:{...e?.dark,...t?.dark}}},"mergeTheme"),Se=m((e,t)=>({...e,...t,markdownLayouts:{...e.markdownLayouts,...t.markdownLayouts},scripts:{...e.scripts,...t.scripts},theme:xe(e.theme,t.theme)}),"mergeTemplateConfig"),be=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(n=>t.includes(n)):r instanceof RegExp?r.test(t):r(t):!0},"scriptMatches"),De=m((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>be(r,t)).map(r=>typeof r=="function"?r():r.render()):[],"renderPageScripts"),G=m((e,t)=>{const r=Object.entries(t).filter(([n])=>n.startsWith("--")).map(([n,i])=>`    ${n}: ${i};`).join(`
+`);return r?`${e} {
+${r}
+}`:""},"renderThemeBlock"),$e=m(e=>{if(!e)return"";const t=e.light??e.dark,r=e.dark??e.light;return!t&&!r?"":[t?G(":root",t):"",r?`@media (prefers-color-scheme: dark) {
+${G("    :root",r)}
+}`:"",t?G('[data-theme="light"]',t):"",r?G('[data-theme="dark"]',r):""].filter(Boolean).join(`
+
+`)},"renderThemeStylesheet"),Pe=m((e="")=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),"escapeXML"),ke=m((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"),je=m(e=>e==="/index.html"?"/":e.replace(/\/index\.html$/,"/").replace(/\.html$/,"").replace(/\/+/g,"/"),"pagePathToUrlPath"),Y=m((e,t)=>e?`${e.replace(/\/$/,"")}${t==="/"?"/":t}`:t,"canonicalUrl"),Te=m(async(e,t)=>p.default.existsSync(e)?(await(0,c.mkdir)(o.default.dirname(t),{recursive:!0}),await(0,c.cp)(e,t),!0):!1,"copyIfExists"),Me=m(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"),Ce=m((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 u=i.urlPath==="/"?"1.0":"0.8";return`    <url>
+        <loc>${Pe(Y(t,i.urlPath))}</loc>
+        <lastmod>${r}</lastmod>
+        <changefreq>weekly</changefreq>
+        <priority>${u}</priority>
+    </url>`}).join(`
+`)}
+</urlset>
+`},"generateSitemap"),Fe=m(e=>`User-agent: *
+Allow: /
+${e?`
+Sitemap: ${e.replace(/\/$/,"")}/sitemap.xml
+Host: ${e.replace(/\/$/,"")}
+`:""}
+`,"generateRobots"),Ge=m(e=>`# Documentation
+
+## Page index
+
+${e.map(t=>`- ${t.name}: ${t.urlPath} - ${t.description}`).join(`
+`)}
+`,"generateLlms"),Ee=m((e,t)=>`# Documentation for AI agents
+
+This file is generated at build time from the Markdown documentation. Use it to choose the most relevant page before reading the canonical HTML documentation.
+
+${e.map(r=>`## ${r.title}
+
+URL: ${Y(t,r.urlPath)}
+Source: docs/${r.sourcePath}
+Description: ${r.description}
+
+${r.summary||r.description}
+`).join(`
+`)}
+`,"generateLlmsFull"),Le=m((e,t)=>{const r=["# Generated by @beforesemicolon/builder"];return[t.llms?"llms.txt":"",t.llmsFull?"llms-full.txt":"",t.sitemap?"sitemap.xml":"",t.robots?"robots.txt":""].filter(Boolean).forEach(i=>r.push(`/${i} /${i} 200`)),e.forEach(i=>{if(i.urlPath==="/")return;const u=i.urlPath.endsWith("/")?`${i.urlPath}index.html`:`${i.urlPath}.html`;r.push(`${i.urlPath} ${u} 200`),i.urlPath.endsWith("/")&&r.push(`${i.urlPath.replace(/\/$/,"")} ${u} 200`)}),`${[...new Set(r)].join(`
+`)}
+`},"generateNetlifyRedirects"),Oe=m(e=>`[build]
+command = "node build-docs.js"
+publish = "${e||"website"}"
+
+[[headers]]
+for = "/llms.txt"
+
+[headers.values]
+Content-Type = "text/plain; charset=utf-8"
+Cache-Control = "public, max-age=0, must-revalidate"
+
+[[headers]]
+for = "/llms-full.txt"
+
+[headers.values]
+Content-Type = "text/plain; charset=utf-8"
+Cache-Control = "public, max-age=0, must-revalidate"
+
+[[headers]]
+for = "/sitemap.xml"
+
+[headers.values]
+Content-Type = "application/xml; charset=utf-8"
+Cache-Control = "public, max-age=0, must-revalidate"
+
+[[headers]]
+for = "/robots.txt"
+
+[headers.values]
+Content-Type = "text/plain; charset=utf-8"
+Cache-Control = "public, max-age=0, must-revalidate"
+`,"generateNetlifyToml"),D=m(async(e,t,r,n)=>{if(await Te(e,t))return;const i=r();if(!i){n&&console.warn(n);return}await(0,c.mkdir)(o.default.dirname(t),{recursive:!0}),await(0,c.writeFile)(t,i)},"writeGeneratedFile"),Ae=m(async({docsDir:e,docsSiteDir:t,pages:r,siteUrl:n,publicDir:i,generatedFiles:u})=>{u.sitemap&&await D(o.default.resolve(e,"sitemap.xml"),o.default.resolve(t,"sitemap.xml"),()=>Ce(r,n),"Skipping generated sitemap.xml because buildDocs({ siteUrl }) is not set."),u.robots&&await D(o.default.resolve(e,"robots.txt"),o.default.resolve(t,"robots.txt"),()=>Fe(n)),u.llms&&await D(o.default.resolve(e,"llms.txt"),o.default.resolve(t,"llms.txt"),()=>Ge(r)),u.llmsFull&&await D(o.default.resolve(e,"llms-full.txt"),o.default.resolve(t,"llms-full.txt"),()=>Ee(r,n)),u.netlify&&(await D(o.default.resolve(e,"_redirects"),o.default.resolve(t,"_redirects"),()=>Le(r,u)),await D(o.default.resolve(e,"netlify.toml"),o.default.resolve(t,"netlify.toml"),()=>Oe(i&&o.default.basename(i))))},"writeGeneratedDocsFiles"),Z=m((e={},t,r)=>{const n=new ee.Marked((0,re.markedHighlight)({langPrefix:"hljs language-",highlight(i,u){const P=W.default.getLanguage(u)?u:"plaintext";return W.default.highlight(i,{language:P}).value}}));return n.use({renderer:ae.default}),n.use((0,ne.createMarkdownLayoutExtension)({marked:n,handlers:e.markdownLayouts,renderMarkdown:r})),e.markedOptions&&n.use(e.markedOptions),t&&n.use(t),n},"createBaseMarked"),Re=m((e={},t)=>{const r=Z(e,t),n=m(u=>r.parse(u),"renderMarkdown"),i=Z(e,t,n);return i.use({hooks:{postprocess(u){const{layout:P="default",...y}=R.attributes,k=De(e.scripts,u);u=se.default.sanitize(u);const j=[...u.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([^<]+)<\/a>/gm)].map(S=>({path:S[2],label:S[3],level:S[1]}));return A.get(P)?.({...y,content:u,siteMap:R.siteMap,tableOfContent:j,projectMeta:K,renderMarkdown:n,scripts:k,themeStylesheet:e.theme?"/stylesheets/theme.css":void 0})||u}}}),i},"createMarked"),v=m(async e=>{const t=await(0,c.readdir)(e),r=[];for(const n of t){const i=o.default.extname(n);/^[._]/.test(n)||(i?r.push(o.default.join(e,n)):/(stylesheets|assets|scripts)/.test(n)||r.push(...await v(o.default.join(e,n))))}return r},"traverseDirectory"),We=m(async({srcDir:e,publicDir:t,markedOptions:r,template:n,siteUrl:i,generatedFiles:u}={})=>{try{const s=o.default.resolve(process.cwd(),"package.json");p.default.existsSync(s)&&(K=JSON.parse(await(0,c.readFile)(s,"utf-8")))}catch(s){console.warn("Failed to load project package.json metadata",s)}const P=m(()=>{try{return __dirname}catch{return o.default.dirname((0,$.fileURLToPath)(Be.url))}},"getDirname"),y=n?o.default.resolve(P(),"templates",n):null,k=y?o.default.resolve(y,"assets"):null,j=y?o.default.resolve(y,"stylesheets"):null,S=y?o.default.resolve(y,"layouts"):null;let T={};if(y)try{let s=o.default.resolve(y,"template.config.js");if(p.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.default.existsSync(s)){const a=await import((0,$.pathToFileURL)(s).href);T=a.default||a}}catch(s){console.error(`Failed to load template config for ${n}`,s)}const d=e??o.default.resolve(process.cwd(),"docs"),f=t??o.default.resolve(process.cwd(),"website"),ce=Me(u),x=o.default.resolve(d,"_template"),_=o.default.resolve(x,"assets"),B=o.default.resolve(x,"stylesheets"),N=o.default.resolve(x,"scripts"),U=o.default.resolve(x,"layouts"),z=o.default.resolve(d,"_layouts"),F=o.default.resolve(d,"assets"),q=o.default.resolve(d,"stylesheets"),E=o.default.resolve(d,"scripts");try{let s=o.default.resolve(x,"template.config.js");if(p.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.default.existsSync(s)){const a=await import((0,$.pathToFileURL)(s).href),l=a.default||a;T=Se(T,l)}}catch(s){console.error("Failed to load docs _template config",s)}const me=Re(T,r);if(await(0,c.mkdir)(f,{recursive:!0}),k&&p.default.existsSync(k))try{await(0,c.cp)(k,F.replace(d,f),{recursive:!0})}catch(s){console.warn(s)}if(p.default.existsSync(F))try{await(0,c.cp)(F,F.replace(d,f),{recursive:!0})}catch(s){console.warn(s)}if(p.default.existsSync(_))try{await(0,c.cp)(_,o.default.resolve(f,"assets"),{recursive:!0})}catch(s){console.warn(s)}try{const s=new Set;if(j&&p.default.existsSync(j)&&(await v(j)).forEach(l=>s.add(l)),p.default.existsSync(q)&&(await v(q)).forEach(l=>s.add(l)),p.default.existsSync(B)&&(await v(B)).forEach(l=>s.add(l)),s.size){await(0,c.mkdir)(o.default.join(f,"stylesheets"),{recursive:!0});for(const l of s){const h=await(0,c.readFile)(l,"utf-8"),g=V.minify(h);g.errors.length&&g.errors.forEach(console.error);const M=l.startsWith(x)?l.replace(x,f):l.startsWith(d)?l.replace(d,f):o.default.join(f,"stylesheets",o.default.basename(l));await(0,c.writeFile)(M,g.styles??h)}}const a=$e(T.theme);if(a){const l=V.minify(a);l.errors.length&&l.errors.forEach(console.error),await(0,c.mkdir)(o.default.join(f,"stylesheets"),{recursive:!0}),await(0,c.writeFile)(o.default.join(f,"stylesheets","theme.css"),l.styles??a)}}catch(s){console.error(s)}if(p.default.existsSync(E))try{const s=await v(E);s.length&&await(0,c.mkdir)(E.replace(d,f),{recursive:!0});for(const a of s)try{const l=await(0,c.readFile)(a,"utf-8");await(0,c.writeFile)(a.replace(d,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(p.default.existsSync(N))try{const s=await v(N);s.length&&await(0,c.mkdir)(o.default.join(f,"scripts"),{recursive:!0});for(const a of s)try{const l=await(0,c.readFile)(a,"utf-8");await(0,c.writeFile)(a.replace(x,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;S&&p.default.existsSync(S)&&(await v(S)).forEach(a=>{/\.(j|t)s$/.test(a)&&s.set(o.default.basename(a).replace(/\.(j|t)s$/,""),a)}),p.default.existsSync(z)&&(await v(z)).forEach(a=>{/\.(j|t)s$/.test(a)&&s.set(o.default.basename(a).replace(/\.(j|t)s$/,""),a)}),p.default.existsSync(U)&&(await v(U)).forEach(a=>{/\.(j|t)s$/.test(a)&&s.set(o.default.basename(a).replace(/\.(j|t)s$/,""),a)});for(const[a,l]of s.entries()){const h=await import((0,$.pathToFileURL)(l).href);A.set(a,h.default)}}catch(s){console.error("Template import failed",s)}const ue=await v(d),H=new Map,I=(await Promise.all(ue.filter(s=>s.endsWith(".md")).map(async s=>{const a=await(0,c.readFile)(s,"utf-8");return{filePath:s,...(0,te.default)(a)}}))).sort((s,a)=>(s.attributes.order??0)-(a.attributes.order??0)).map(({attributes:s,body:a,filePath:l})=>{const h=l.replace(d,"").replace(/\.md/,".html"),g=l.replace(d,f).replace(".md",".html"),M=g.replace(o.default.basename(g),""),L=o.default.basename(h)||"/",pe=h.replace(L,"").replace(/\/$/,"");let b=H;pe.split("/").filter(Boolean).forEach(O=>{b.has(O)||b.set(O,new Map),b=b.get(O)});const J={...s,path:h};return b.has(L)||b.set(L,J),{attributes:J,fileWebsitePath:g,fileDirWebsitePath:M,body:a,sourcePath:o.default.relative(d,l),siteMap:H}});for(const{attributes:s,body:a,fileDirWebsitePath:l,fileWebsitePath:h,siteMap:g}of I){R={attributes:s,siteMap:g};const M=await me.parse(a);await(0,c.mkdir)(l,{recursive:!0}),await(0,c.writeFile)(h,le.default.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 Ae({docsDir:d,docsSiteDir:f,pages:I.map(({attributes:s,body:a,sourcePath:l})=>{const h=je(String(s.path)),g=ke(a);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:ce})},"buildDocs");0&&(module.exports={buildDocs});

package/dist/cjs/docs/templates/fading-citrus/layouts/_code-snippet.js

@@ -44,6 +44,59 @@ export const highlightLine = (line) => {
     return tokens.join('')
 }
 
+export const renderCodeCopyScript = () => `
+<script type="application/javascript">
+    (() => {
+        if (window.__fadingCitrusCodeCopyReady) return
+        window.__fadingCitrusCodeCopyReady = true
+
+        const showCopyButton = (snippet) => {
+            const copyBtn = snippet.querySelector('.code-copy-btn')
+            const hasCode = snippet.dataset.code || snippet.querySelector('code') || snippet.querySelector('.content')
+            if (copyBtn && hasCode) copyBtn.style.visibility = 'visible'
+        }
+
+        document.querySelectorAll('.code-snippet').forEach(showCopyButton)
+
+        document.addEventListener('click', (event) => {
+            const copyBtn = event.target.closest('.code-copy-btn')
+            if (!copyBtn) return
+
+            const snippet = copyBtn.closest('.code-snippet')
+            if (!snippet) return
+
+            let code = snippet.dataset.code ?? ''
+
+            if (!code) {
+                const codeEl = snippet.querySelector('code')
+                if (codeEl) {
+                    const clone = codeEl.cloneNode(true)
+                    clone.querySelectorAll('.line-number').forEach((el) => el.remove())
+                    code = clone.textContent ?? ''
+                }
+            }
+
+            if (!code) {
+                code = snippet.querySelector('.content')?.textContent ?? ''
+            }
+
+            if (!code.trim().length) return
+
+            clearTimeout(copyBtn._timer)
+            navigator.clipboard.writeText(code.trim())
+            copyBtn.textContent = 'copied'
+            copyBtn.setAttribute('aria-label', 'Code copied')
+            copyBtn.classList.add('copied')
+            copyBtn._timer = setTimeout(() => {
+                copyBtn.textContent = 'copy'
+                copyBtn.setAttribute('aria-label', 'Copy code')
+                copyBtn.classList.remove('copied')
+            }, 1000)
+        })
+    })()
+</script>
+`
+
 export const renderCodeBlock = (filename, code, lang = 'javascript') => {
     const lines = code
         .replace(/\n$/, '')

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

@@ -0,0 +1,89 @@
+export const escapeHTML = (value = '') =>
+    String(value)
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;')
+
+export const partByName = (parts, name) =>
+    parts.find((part) => part.name === name)
+
+export const option = (value, fallback = '') =>
+    value === undefined || value === true ? fallback : String(value)
+
+export const optionText = (value, fallback = '') =>
+    option(value, fallback).replace(/&quot;/g, '"')
+
+export const codeFromPart = (part = {}) => {
+    const match = String(part.body || '').match(
+        /(?:```|~~~)([^\n]*)\n([\s\S]*?)\n(?:```|~~~)/
+    )
+
+    if (!match) return ''
+
+    return match[2]
+}
+
+export const withFirstParagraphClass = (html = '', className = '') =>
+    html.replace(/<p>/, `<p class="${className}">`)
+
+export const statContent = (html = '') => {
+    const value = html.match(/<h2[^>]*>([\s\S]*?)<\/h2>/)?.[1] || ''
+    const label = html.match(/<p[^>]*>([\s\S]*?)<\/p>/)?.[1] || ''
+
+    return `
+        <span class="stat-value text-gradient-primary">${value}</span>
+        <span class="stat-label">${label}</span>
+    `
+}
+
+export const stripHeadingLinks = (html = '') =>
+    html.replace(
+        /<h([1-6])([^>]*)><a href="[^"]*">([\s\S]*?)<\/a><\/h\1>/g,
+        '<h$1$2>$3</h$1>'
+    )
+
+export const sectionHeader = (html = '') =>
+    stripHeadingLinks(html).replace(
+        /<p><code>([\s\S]*?)<\/code><\/p>/,
+        '<span class="section-tag font-mono">$1</span>'
+    )
+
+export const groupedSectionHeader = (html = '') => {
+    const normalized = sectionHeader(html)
+    const match = normalized.match(
+        /^(\s*<span class="section-tag font-mono">[\s\S]*?<\/span>)(\s*<h2[^>]*>[\s\S]*?<\/h2>)([\s\S]*)$/
+    )
+
+    if (!match) return normalized
+
+    return `<div>${match[1]}${match[2]}</div>${match[3]}`
+}
+
+export const icon = (name) => {
+    const icons = {
+        arrowRight:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5 12h14"/><path d="m12 5 7 7-7 7"/></svg>',
+        arrowUpRight:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M7 17 17 7"/><path d="M7 7h10v10"/></svg>',
+        book: '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M2 3h6a4 4 0 0 1 4 4v14a3 3 0 0 0-3-3H2z"/><path d="M22 3h-6a4 4 0 0 0-4 4v14a3 3 0 0 1 3-3h7z"/></svg>',
+        terminal:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/></svg>',
+        sparkles:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" class="sparkles-icon"><path d="m12 3-1.912 5.813a2 2 0 0 1-1.275 1.275L3 12l5.813 1.912a2 2 0 0 1 1.275 1.275L12 21l1.912-5.813a2 2 0 0 1 1.275-1.275L21 12l-5.813-1.912a2 2 0 0 1-1.275-1.275Z"/><path d="m5 3 1 2.5L8.5 6 6 7 5 9.5 4 7 1.5 6 4 5Z"/><path d="m19 17 1 2.5 2.5.5-2.5 1-1 2.5-1-2.5-2.5-1 2.5-1Z"/></svg>',
+        webComponents:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M5.5 8.5 9 12l-3.5 3.5L2 12l3.5-3.5Z"/><path d="m12 2 3.5 3.5L12 9 8.5 5.5 12 2Z"/><path d="M18.5 8.5 22 12l-3.5 3.5L15 12l3.5-3.5Z"/><path d="m12 15 3.5 3.5-3.5 3.5-3.5-3.5 3.5-3.5Z"/></svg>',
+        router: '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="6" cy="19" r="3"/><circle cx="18" cy="5" r="3"/><path d="M9 19h8.5a3.5 3.5 0 0 0 3.5-3.5V8.5a3.5 3.5 0 0 0-3.5-3.5H9"/></svg>',
+        reactive:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M13 2L3 14h9l-1 8 10-12h-9l1-8z"/></svg>',
+        tiny: '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M20.24 12.24a6 6 0 0 0-8.49-8.49L5 10.5V19h8.5z"/><line x1="16" y1="8" x2="2" y2="22"/><line x1="17.5" y1="15" x2="9" y2="15"/></svg>',
+        standards:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M8.3 10a3.5 3.5 0 0 1 0-7h7.4a3.5 3.5 0 0 1 0 7H8.3Z"/><path d="M12 14a3 3 0 0 1 3-3h3.5a3 3 0 0 1 3 3v3.5a3 3 0 0 1-3 3H15a3 3 0 0 1-3-3V14Z"/><path d="M2 14.5a3.5 3.5 0 0 1 7 0v2.8a3.5 3.5 0 0 1-7 0v-2.8Z"/></svg>',
+        plug: '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 22v-5"/><path d="M9 8V2"/><path d="M15 8V2"/><path d="M18 8H6v5a4 4 0 0 0 4 4h4a4 4 0 0 0 4-4Z"/></svg>',
+        surgical:
+            '<svg aria-hidden="true" xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="m12 14 4-4"/><path d="M3.34 19a10 10 0 1 1 17.32 0"/></svg>',
+    }
+
+    return icons[name] || icons.reactive
+}

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

@@ -1,7 +1,6 @@
 import meta from './_head-meta.js'
 import header from './_header.js'
 import footer from './_footer.js'
-import copyCode from './_copy-code.js'
 
 const githubDocsPath =
     'https://github.com/beforesemicolon/markup/tree/main/docs'
@@ -47,6 +46,11 @@ export default (props) => {
     <head>
         ${meta(props)}
         <link rel="stylesheet" href="/stylesheets/documentation.css?v=20260621exact">
+        ${
+            props.themeStylesheet
+                ? `<link rel="stylesheet" href="${props.themeStylesheet}">`
+                : ''
+        }
     </head>
     <body>
         ${header(props)}
@@ -83,8 +87,7 @@ export default (props) => {
         </main>
         
         ${footer()}
-        
-        ${copyCode()}
+        ${props.scripts?.join('') || ''}
         
     </body>
 </html>

package/dist/cjs/docs/templates/fading-citrus/layouts/landing-cta.js

@@ -0,0 +1,30 @@
+import { icon, partByName } from './_layout-utils.js'
+
+export default ({ parts, options }) => {
+    const copy = partByName(parts, 'copy') || parts[0]
+    const title = options.title || ''
+    const title2 = options.title2 || ''
+
+    return `
+        <section class="cta-section wrapper">
+            <div class="cta-card">
+                <div class="cta-glow"></div>
+                <h2>
+                    <span class="text-gradient">${title}</span>
+                    <span class="text-gradient-primary">${title2}</span>
+                </h2>
+                ${copy?.html || ''}
+                <div class="cta-buttons">
+                    <a href="/documentation/get-started" class="btn-primary">
+                        <span>Get Started</span>
+                        ${icon('arrowRight')}
+                    </a>
+                    <a href="/documentation/index.html?v=20260621exact" class="btn-outline">
+                        ${icon('book')}
+                        <span>Read the Docs</span>
+                    </a>
+                </div>
+            </div>
+        </section>
+    `
+}

package/dist/cjs/docs/templates/fading-citrus/layouts/landing-ecosystem.js

@@ -0,0 +1,43 @@
+import {
+    groupedSectionHeader,
+    icon,
+    option,
+    partByName,
+} from './_layout-utils.js'
+
+export default ({ parts }) => {
+    const header = partByName(parts, 'header') || parts[0]
+    const cards = parts.filter((part) => part.name === 'product')
+
+    return `
+        <section class="products-section wrapper">
+            <div class="section-header">${groupedSectionHeader(header?.html || '')}</div>
+            <div class="products-grid">
+                ${cards
+                    .map(
+                        (card) => `
+                            <div class="product-card card-${option(card.options.color, 'orange')}">
+                                <div class="product-glow"></div>
+                                <a href="${option(card.options.href, '#')}" target="_blank" rel="noreferrer" class="product-head">
+                                    <div class="product-title-row">
+                                        <div class="icon-container">${icon(option(card.options.icon, 'webComponents'))}</div>
+                                        <div>
+                                            <h3>${option(card.options.title, card.name || '')}</h3>
+                                            <span class="package-name font-mono">${option(card.options.package, '')}</span>
+                                        </div>
+                                    </div>
+                                    <span class="product-arrow">${icon('arrowUpRight')}</span>
+                                </a>
+                                ${card.html}
+                                <a href="${option(card.options.href, '#')}" target="_blank" rel="noreferrer" class="product-link">
+                                    <span>Read the docs</span>
+                                    ${icon('arrowUpRight')}
+                                </a>
+                            </div>
+                        `
+                    )
+                    .join('')}
+            </div>
+        </section>
+    `
+}

package/dist/cjs/docs/templates/fading-citrus/layouts/landing-features.js

@@ -0,0 +1,25 @@
+import { icon, option, partByName, sectionHeader } from './_layout-utils.js'
+
+export default ({ parts }) => {
+    const header = partByName(parts, 'header') || parts[0]
+    const features = parts.filter((part) => part.name === 'feature')
+
+    return `
+        <section id="features" class="features-section wrapper">
+            <div class="section-header">${sectionHeader(header?.html || '')}</div>
+            <div class="features-grid">
+                ${features
+                    .map(
+                        (feature) => `
+                            <div class="feature-card">
+                                <div class="feature-border"></div>
+                                <div class="icon-box">${icon(option(feature.options.icon, 'reactive'))}</div>
+                                ${feature.html}
+                            </div>
+                        `
+                    )
+                    .join('')}
+            </div>
+        </section>
+    `
+}

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

@@ -0,0 +1,81 @@
+import { renderCodeBlock } from './_code-snippet.js'
+import {
+    codeFromPart,
+    icon,
+    option,
+    partByName,
+    statContent,
+    withFirstParagraphClass,
+} from './_layout-utils.js'
+
+export default ({ parts, options }) => {
+    const copy = partByName(parts, 'copy') || parts[0]
+    const code = partByName(parts, 'code') || parts[1]
+    const stats = parts.filter((part) => part.name === 'stat')
+    const version = option(options.version)
+    const title = option(options.title, '')
+    const title2 = option(options.title2, '')
+    const primaryHref = option(
+        options.primaryHref,
+        '/documentation/get-started'
+    )
+    const primaryLabel = option(options.primaryLabel, 'Get Started')
+    const secondaryLabel = option(
+        options.secondaryLabel,
+        'npm i @beforesemicolon/markup'
+    )
+
+    return `
+        <section class="hero-section relative overflow-hidden">
+            <div class="absolute inset-0 bg-grid pointer-events-none"></div>
+            <div class="absolute inset-0 hero-glow pointer-events-none animate-pulse-glow"></div>
+            <div class="wrapper hero-container animate-float-up">
+                <div class="hero-content">
+                    ${
+                        version
+                            ? `<a href="https://github.com/beforesemicolon/markup" target="_blank" rel="noopener" class="version-badge">
+                                ${icon('sparkles')}
+                                <span>${version}</span>
+                                ${icon('arrowRight')}
+                            </a>`
+                            : ''
+                    }
+                    <h1 class="hero-title">
+                        <span class="text-gradient">${title}</span><br/>
+                        <span class="text-gradient-primary">${title2}</span>
+                    </h1>
+                    ${withFirstParagraphClass(copy?.html || '', 'hero-subtitle')}
+                    <div class="hero-actions">
+                        <a href="${primaryHref}" class="btn-primary">
+                            <span>${primaryLabel}</span>
+                            ${icon('arrowRight')}
+                        </a>
+                        <a href="#install" class="btn-secondary font-mono">${secondaryLabel}</a>
+                    </div>
+                    ${
+                        stats.length
+                            ? `<div class="hero-stats">${stats
+                                  .map(
+                                      (stat, index) => `
+                                        ${index ? '<div class="stat-divider"></div>' : ''}
+                                        <div class="stat-item">${statContent(stat.html)}</div>
+                                    `
+                                  )
+                                  .join('')}</div>`
+                            : ''
+                    }
+                </div>
+                ${
+                    code
+                        ? `<div class="hero-code-panel">
+                            <div class="glow-container">
+                                <div class="absolute inset-0 bg-gradient-to-br from-primary/20 to-accent/20 blur-3xl rounded-full"></div>
+                            </div>
+                            ${renderCodeBlock(option(code.options.filename, ''), codeFromPart(code), option(code.options.lang, 'javascript'))}
+                        </div>`
+                        : ''
+                }
+            </div>
+        </section>
+    `
+}