npm - @beforesemicolon/builder - Versions diffs - 1.8.22 → 1.8.24 - Mend

@beforesemicolon/builder 1.8.22 → 1.8.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

package/README.md CHANGED Viewed

@@ -304,8 +304,10 @@ A template config exports an object:
 ```js
 export default {
     meta: {},
+    site: {},
     markedOptions: {},
     markdownLayouts: {},
+    headScripts: {},
     scripts: {},
     theme: {
         light: {},
@@ -319,8 +321,9 @@ Config from `docs/_template/template.config.js` is merged into the selected temp
 Merge behavior:
 - `markdownLayouts` are shallow-merged by layout name.
-- `scripts` are shallow-merged by script 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.
@@ -336,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,
     },
@@ -350,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:
@@ -602,6 +629,8 @@ export default {
 }
 ```
+Use `headScripts` for scripts that must render in `<head>`, such as analytics bootstrap tags. Use `scripts` for scripts that can render near `</body>`, such as interaction handlers.
 Script definitions:
 ```ts
@@ -632,12 +661,15 @@ Behavior:
 - A function matcher receives the rendered page HTML and returns a boolean.
 - A script can be disabled by setting its registry value to `false` in an extending config.
-Layouts receive scripts through `props.scripts` and must insert them where appropriate, usually before `</body>`.
+Layouts receive scripts through `props.headScripts` and `props.scripts`. Template layouts must insert them where appropriate.
 ```js
 export default (props) => `
 <!doctype html>
 <html>
+    <head>
+        ${props.headScripts?.join('') || ''}
+    </head>
     <body>
         ${props.content}
         ${props.scripts?.join('') || ''}
@@ -802,8 +834,12 @@ export default {
     markdownLayouts: {
         'pricing-cards': pricingCards,
     },
+    headScripts: {
+        analytics: () =>
+            `<script async src="https://example.com/analytics.js"></script>`,
+    },
     scripts: {
-        analytics: {
+        pageView: {
             match: '<main',
             render: () => `<script>console.log('page viewed')</script>`,
         },

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

	@@ -1 +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});
1	+ "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 CHANGED Viewed

	@@ -1 +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);
1	+ "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 CHANGED Viewed

@@ -1,4 +1,4 @@
-"use strict";var he=Object.create;var C=Object.defineProperty;var ge=Object.getOwnPropertyDescriptor;var ye=Object.getOwnPropertyNames;var we=Object.getPrototypeOf,ve=Object.prototype.hasOwnProperty;var m=(e,t)=>C(e,"name",{value:t,configurable:!0});var Se=(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 ye(t))!ve.call(e,n)&&n!==r&&C(e,n,{get:()=>t[n],enumerable:!(a=ge(t,n))||a.enumerable});return e};var v=(e,t,r)=>(r=e!=null?he(we(e)):{},Q(t||!e||!e.__esModule?C(r,"default",{value:e,enumerable:!0}):r,e)),De=e=>Q(C({},"__esModule",{value:!0}),e);var Ue={};Se(Ue,{buildDocs:()=>Ne});module.exports=De(Ue);const ze={};var se=require("marked"),c=require("fs/promises"),o=v(require("path"),1),re=v(require("front-matter"),1),oe=v(require("isomorphic-dompurify"),1),ae=require("marked-highlight"),_=v(require("highlight.js"),1),ne=v(require("./templates/default.template.js"),1),ie=v(require("./renderer/index.js"),1),le=require("./markdown-layout/index.js"),ce=v(require("clean-css"),1),me=v(require("html-minifier"),1),X=v(require("@putout/minify"),1),P=require("url"),p=v(require("fs"),1);let V,A="";const Y=new ce.default({inline:["none"]}),R=new Map;R.set("default",ne.default);let W;const Z=m((e,t)=>t===!1?!1:t===void 0?e:e===!1||e===void 0?t:{...e,...t},"mergeThemeMode"),be=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},scripts:{...e.scripts,...t.scripts},theme:be(e.theme,t.theme)}),"mergeTemplateConfig"),$e=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"),Pe=m((e,t)=>e?Object.values(e).filter(r=>r!==!1).filter(r=>$e(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) {
@@ -7,10 +7,10 @@ ${G("    :root",n)}
 .site-logo-dark { display: block; }`:"",r&&a?`.site-logo-light { display: block; }
 .site-logo-dark { display: none; }`:""].filter(Boolean).join(`
-`):""},"renderThemeStylesheet"),Te=m((e="")=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),"escapeXML"),Me=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"),ee=m((e,t)=>e?`${e.replace(/\/$/,"")}${t==="/"?"/":t}`:t,"canonicalUrl"),Ce=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"),Fe=m(async e=>{const t=o.default.resolve(e,"logo.svg");p.default.existsSync(t)&&await Promise.all(["logo.light.svg","logo.dark.svg"].map(async r=>{const a=o.default.resolve(e,r);p.default.existsSync(a)||await(0,c.cp)(t,a)}))},"ensureLogoModeAssets"),Ge=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"),Le=m((e,t)=>{if(!t)return"";const r=new Date().toISOString().slice(0,10);return`<?xml version="1.0" encoding="UTF-8"?>
+`):""},"renderThemeStylesheet"),Te=m((e="")=>String(e).replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/>/g,"&gt;").replace(/"/g,"&quot;").replace(/'/g,"&apos;"),"escapeXML"),Me=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"),te=m((e,t)=>e?`${e.replace(/\/$/,"")}${t==="/"?"/":t}`:t,"canonicalUrl"),Ce=m(async(e,t)=>f.default.existsSync(e)?(await(0,c.mkdir)(o.default.dirname(t),{recursive:!0}),await(0,c.cp)(e,t),!0):!1,"copyIfExists"),Fe=m(async e=>{const t=o.default.resolve(e,"logo.svg");f.default.existsSync(t)&&await Promise.all(["logo.light.svg","logo.dark.svg"].map(async r=>{const a=o.default.resolve(e,r);f.default.existsSync(a)||await(0,c.cp)(t,a)}))},"ensureLogoModeAssets"),Ge=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"),Le=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(n=>{const u=n.urlPath==="/"?"1.0":"0.8";return`    <url>
-        <loc>${Te(ee(t,n.urlPath))}</loc>
+        <loc>${Te(te(t,n.urlPath))}</loc>
         <lastmod>${r}</lastmod>
         <changefreq>weekly</changefreq>
         <priority>${u}</priority>
@@ -35,7 +35,7 @@ This file is generated at build time from the Markdown documentation. Use it to
 ${e.map(r=>`## ${r.title}
-URL: ${ee(t,r.urlPath)}
+URL: ${te(t,r.urlPath)}
 Source: docs/${r.sourcePath}
 Description: ${r.description}
@@ -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"),te=m((e={},t,r)=>{const a=new se.Marked((0,ae.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:ie.default}),a.use((0,le.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=te(e,t),n=m(h=>a.parse(h),"renderMarkdown"),u=te(e,t,n);return u.use({hooks:{postprocess(h){const{layout:w="default",...k}=W.attributes,T=Pe(e.scripts,h);h=oe.default.sanitize(h);const M=[...h.matchAll(/<h([0-6])\sid="[^"]+".*?>.*?<a\s+href="([^"]+)".*?>([\s\S]*?)<\/a><\/h\1>/gm)].map(D=>({path:D[2],label:D[3].replace(/<[^>]+>/g,"").replace(/\s+/g," ").trim(),level:D[1]}));return R.get(w)?.({...k,content:h,siteMap:W.siteMap,tableOfContent:M,projectMeta:V,renderMarkdown:n,scripts:T,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");p.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 D={};if(w)try{let s=o.default.resolve(w,"template.config.js");if(p.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href);D=i.default||i}}catch(s){console.error(`Failed to load template config for ${a}`,s)}const d=e??o.default.resolve(process.cwd(),"docs"),f=t??o.default.resolve(process.cwd(),"website"),ue=Ge(u),b=o.default.resolve(d,"_template"),B=o.default.resolve(b,"assets"),N=o.default.resolve(b,"stylesheets"),U=o.default.resolve(b,"scripts"),z=o.default.resolve(b,"layouts"),q=o.default.resolve(d,"_layouts"),F=o.default.resolve(d,"assets"),H=o.default.resolve(d,"stylesheets"),L=o.default.resolve(d,"scripts");try{let s=o.default.resolve(b,"template.config.js");if(p.default.existsSync(s)||(s=s.replace(/\.js$/,".ts")),p.default.existsSync(s)){const i=await import((0,P.pathToFileURL)(s).href),l=i.default||i;D=xe(D,l)}}catch(s){console.error("Failed to load docs _template config",s)}const pe=Be(D,r,n);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(B))try{await(0,c.cp)(B,o.default.resolve(f,"assets"),{recursive:!0})}catch(s){console.warn(s)}await Fe(o.default.resolve(f,"assets"));try{const s=new Set;if(T&&p.default.existsSync(T)&&(await S(T)).forEach(l=>s.add(l)),p.default.existsSync(H)&&(await S(H)).forEach(l=>s.add(l)),p.default.existsSync(N)&&(await S(N)).forEach(l=>s.add(l)),s.size){await(0,c.mkdir)(o.default.join(f,"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(b)?l.replace(b,f):l.startsWith(d)?l.replace(d,f):o.default.join(f,"stylesheets",o.default.basename(l));await(0,c.writeFile)(j,y.styles??g)}}const i=ke(D.theme);if(i){const l=Y.minify(i);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??i)}}catch(s){console.error(s)}if(p.default.existsSync(L))try{const s=await S(L);s.length&&await(0,c.mkdir)(L.replace(d,f),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(d,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}if(p.default.existsSync(U))try{const s=await S(U);s.length&&await(0,c.mkdir)(o.default.join(f,"scripts"),{recursive:!0});for(const i of s)try{const l=await(0,c.readFile)(i,"utf-8");await(0,c.writeFile)(i.replace(b,f),X.minify(l))}catch(l){console.error(l)}}catch(s){console.warn(s)}try{const s=new Map;M&&p.default.existsSync(M)&&(await S(M)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),p.default.existsSync(q)&&(await S(q)).forEach(i=>{/\.(j|t)s$/.test(i)&&s.set(o.default.basename(i).replace(/\.(j|t)s$/,""),i)}),p.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 fe=await S(d),I=new Map,J=(await Promise.all(fe.filter(s=>s.endsWith(".md")).map(async s=>{const i=await(0,c.readFile)(s,"utf-8");return{filePath:s,...(0,re.default)(i)}}))).sort((s,i)=>(s.attributes.order??0)-(i.attributes.order??0)).map(({attributes:s,body:i,filePath:l})=>{const g=l.replace(d,"").replace(/\.md/,".html"),y=l.replace(d,f).replace(".md",".html"),j=y.replace(o.default.basename(y),""),E=o.default.basename(g)||"/",de=g.replace(E,"").replace(/\/$/,"");let x=I;de.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(d,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 pe.parse(i);await(0,c.mkdir)(l,{recursive:!0}),await(0,c.writeFile)(g,me.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:d,docsSiteDir:f,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:f,generatedFiles:ue})},"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 CHANGED Viewed

@@ -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 &copy; ${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
@@ -637,7 +674,7 @@ The landing and documentation stylesheets import or rely on the shared styles as
 ## Scripts
-Template scripts are registered by marker:
+Template scripts are registered by marker. The template renders `headScripts` inside `<head>` and `scripts` before `</body>`.
 ```js
 scripts: {
@@ -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 CHANGED Viewed

@@ -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 CHANGED Viewed

@@ -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/_head-meta.js CHANGED Viewed

@@ -1,6 +1,3 @@
-/* global process */
-const isDev = process.env.NODE_ENV === 'development'
 const fallbackSiteUrl = 'https://beforesemicolon.com'
 const fallbackSiteName = 'Before Semicolon'
 const fallbackTitle = 'Before Semicolon Documentation'
@@ -234,18 +231,5 @@ export default (props = {}) => {
 <link rel="stylesheet" href="/stylesheets/github-dark.hightlighter.css${cacheKey}">
 ${jsonScript(pageJson({ ...props, siteUrl, siteName, defaultImage, title, description }))}
 ${jsonScript(breadcrumbJson({ siteUrl, title, path: props.path }))}
-${
-    isDev
-        ? ''
-        : `<!-- Google tag (gtag.js) -->
-<script async src="https://www.googletagmanager.com/gtag/js?id=G-N3MXGDP5PS"></script>
-<script>
-  window.dataLayer = window.dataLayer || [];
-  function gtag(){dataLayer.push(arguments);}
-  gtag('js', new Date());
-  gtag('config', 'G-N3MXGDP5PS');
-</script>`
-}
 `
 }

package/dist/cjs/docs/templates/fading-citrus/layouts/_header.js CHANGED Viewed

@@ -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>
         `
         }