@rathnasgala/theme 0.0.20 → 2.0.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rathnasgala/theme",
-  "version": "0.0.20",
+  "version": "2.0.2",
   "description": "Managed Gala static-site theme payload",
   "license": "MIT",
   "repository": {

package/payload/.gala/managed-files.json

@@ -2,9 +2,11 @@
   "schemaVersion": 1,
   "themePackage": {
     "name": "@rathnasgala/theme",
-    "version": "0.0.20",
+    "version": "2.0.2",
     "availableDesignThemes": [
-      "editorial"
+      "editorial",
+      "modern",
+      "technical"
     ],
     "securityAdvisories": []
   },
@@ -15,55 +17,58 @@
   "files": {
     ".gala/publish.yml.template": "73080241d89bd09964b797a8bcc8e18471412e11bc873efad76305b60f497d08",
     ".gitignore": "b5fa24e10155097a0d372926fd2e59e6072e7cc2cb6399bbfb4beb8b33ea315b",
-    "eleventy.config.js": "efe587447e3dc374a220c7fa037fdf2fffc02d09ba43a4d2b96d6c6aae0e3325",
+    "eleventy.config.js": "0b72076f2f884a3a4a5b2ea4a124e0c1308c735526275bb847a3d6ebd082a186",
+    "lib/accent.js": "e6c921e0a3afe094b18709e3e40baa06692017fa6576d84b1ec6b7d788da8dd0",
     "lib/build-manifest.js": "88949f0112d683ca809bb67ca969e15634792423559a67bc79a534cd807e5535",
     "lib/engagement-snapshot.js": "298c11b1ab135a3a98a4e31b6320ab60dfd7fda6a9d9053df37d86282a5a6687",
     "lib/performance-budget.js": "c279622dfde237cd6e3c64775c91d770a0e1f54f5f94257ccc95d9a44de2c4c9",
     "lib/provider-fixtures/embeds.v1.json": "5f26909fb433135321ddf7fdd14e45aeb702805c88f5676941166c5735143ee2",
     "lib/provider-fixtures/share-intents.v1.json": "66a8eedfcff711253ee45ceb94b53f7d5a6be3ddbbb3d1f0d4e31a114326cc0a",
     "lib/publication-state.js": "1b59c29a18bbb1193bddea898dac3a4fb832c7bc4751263be086f3d64392dea0",
-    "lib/render-markdown.js": "40e6d6743b76de6c16d138475f188a4263967530c370d8b26a363f4df58c2caf",
-    "lib/seo.js": "107de8804931945b8e73894877fc394d6b535a9d0d969a4ba5b68f2e136e0a17",
+    "lib/render-markdown.js": "275b7da721aef1f68cda515673153471c0d597061e8fdf867c5f2b32c98b91db",
+    "lib/seo.js": "19cf1d67d5b711b8d3a533f207f267e770ee46fd4a4e6561c5f7fd4e9c1989ff",
     "lib/share-targets.js": "458aff86fab2b62a364442cd8c612565c6e0b53eef2f20cb6237cc562b1e0731",
-    "lib/site-config.js": "3ed45daef0b7f79d94bf0c648c4fe7d8bf517534e4645a4b43d952dfc434ddc4",
-    "package-lock.json": "c97a6a2f794aef083a39a8d2628eccc4a3c484e1c6225899b77ec1fb7c466d9e",
-    "package.json": "4c60bea06f39aec755ac68caf8d8841c1d59d0f6121fad7f4396231ce14712dc",
-    "src/404.njk": "be0d44370ac5402156aaf3d32ea581057bc61ec94c1a5f92bb809733af7a8a20",
+    "lib/site-config.js": "679c0eaea066bbe7569bf0211696868106dd1d3bf6118fcfb7aeb75962055384",
+    "package-lock.json": "dc11470b1ad897c58d91745f23ff25711c593e62972ec9fb83f4e10fd77e1ecd",
+    "package.json": "1b3b70f6e94391d309625cb8cef503ee92ecd282bec587643b535ae7a14c24c0",
+    "scripts/build-reader.js": "743194c8dc9cfb9b6631db1732b5f36a92e3a4f905a2965c71d56e1ef50c2e45",
+    "scripts/lint.js": "c4bb3c961686043fa8c79bed546758ef09d44441421d8209fec9d69f74171025",
     "src/_data/buildManifest.js": "628163305984e0d3537e27b0d4050f5ba5ead12a834878266d2ce8004ffe1b1e",
     "src/_data/engagementSnapshot.js": "9217dacebfaf008f7a0ad67ff4e8d1fa8fba609a9dc7e3430c78c5b32024da0e",
     "src/_data/feedLinks.js": "06c93352ebd888acb431a1c9a8be6ecff757895468e9f2d336761038751c2d5e",
     "src/_data/languages.js": "1358748f7fa2f74406d3295a030827d6229a53e94da72cf712e719d7a356aeac",
-    "src/_data/site.js": "6f9b754876ab7cfa93f02a38be2962edce8245423c354426a1465513caec7911",
-    "src/_includes/components/ui.njk": "23eb647d8658868449ec6bb809e965a85302124a97639f94d5d28af72df56e4c",
-    "src/_includes/layouts/base.njk": "638457f6c10f3ba866e8c70715678298096a668568e99456bef4167ebf1111e7",
-    "src/_includes/layouts/post.njk": "1accd2832064ad19ee7bf18daf5fa1e60569f32c9b7a547934a6361f747d7eb7",
+    "src/_data/site.js": "432be73b49c20f088c304a2f7d7cd85906a747e0f3b381a4b395c5c44d68bb57",
+    "src/_includes/components/ui.njk": "0634c206c2db0507f77686635e3b406e1d8878011fd7eac64563df8499fe8f60",
+    "src/_includes/layouts/base.njk": "28043f394af8e2e3b09b6218ed3de2a506535fd5d59e67225c0fbd4431f967ff",
+    "src/_includes/layouts/post.njk": "579421054d8b547cb974a87114a96bb90cc2792b1436eb90c1f620589b2bfbfa",
+    "src/404.njk": "be0d44370ac5402156aaf3d32ea581057bc61ec94c1a5f92bb809733af7a8a20",
+    "src/accent.11ty.js": "52e7d3eb731c5f4649c14c4745f65da026c25b58cf462d075b8ef363f0e487dc",
     "src/assets/embed-codepen.svg": "e9def697f38c466fb2b6652535c4c814e8cbbbefc6e052a69f335aeb27e8356b",
     "src/assets/embed-gist.svg": "fcd9bc2bf29a5c118492b853c0a01390b7539c38ddb985da3c2a6e2f246a39f7",
     "src/assets/embed-x.svg": "0ae74edc6790ec7e933067fe5392bce756e93fa7ad71caacf1c1ca99fa4ec9b6",
     "src/assets/embed-youtube.svg": "10d192f2b14b67664fea88c8cf246321d20190def51d59fad5762e552219b067",
-    "src/assets/engagement-comments.js": "b20d9268c9d908b4453a42188eaca25349f25534fb04a9293c9e688a982cd8f8",
-    "src/assets/engagement-transport.js": "4f9ca0cd669bf8abc25f2909104e3e4b231657ef97d36a17d06e53454d711786",
+    "src/assets/engagement-comments.js": "eda0fee471c7e42ee01a25b8aa14ed6ae9690d52b3fbb34027d97534ab62998b",
+    "src/assets/engagement-transport.js": "d4108cded823f859e7a8d6e36716162422ceaf5e4b94a57ed9bd7941d5096216",
     "src/assets/favicon.svg": "8615e3d96fe37ae9ed14afb1886e7c0e690eef5b10be66ca91cccfd085a74bb6",
-    "src/assets/interactions.js": "4b65dcfcc23682616b15071d746da053bcc3a6bc5df36e11dc5698dd3348f314",
+    "src/assets/interactions.js": "d7ac42be1c3453fb5a7bc1b7de52bca2bc7322e60ef235ce4953f5382a3550c5",
     "src/assets/preferences.js": "789127bee013ed6a1bbf8cefd7b9109291c16220e7a6e09314e3c93c54731d1d",
+    "src/assets/reader.js": "96018c305177c5cbea77b4958ccba7800be82ace513f47fc811bdd41fb8eee63",
     "src/assets/search.js": "df425f0239277792ad39f2138bc89cb66cc4ecda5ed59042d46abc2f05372088",
     "src/assets/theme-mode.js": "944b29db11a577961a60ddcfa52f07ef2411f3f3631bea85bd79be16428c08be",
-    "src/assets/theme.css": "300f6c2ffd7e63a948cfdb46b2d0f4abdbce5f5c4da7ee2cca5633d9795277c4",
-    "src/assets/vendor/hooks.js": "ae6ec58592683ca64fa4d65b20d40b103df62a673bcc4712515cf165950b07f3",
-    "src/assets/vendor/htm.js": "e4dac9bc40a6f2ec590413d787ae30bbcfdfcde4f28971ee65d9578271b7aad4",
-    "src/assets/vendor/preact.js": "712517dd2a42c3c22b5ab0264ad7e9a2b1e8be6cf97fa00dbedd98203617e616",
-    "src/assets/vendor/signals-core.js": "1e10560fec5118c9e35eb312c869fe51f4870424766ef2ec0f7cd069bd898c8b",
-    "src/assets/vendor/signals.js": "717a88151bacf4f8b79b528a96d71be20a133fb3345230c1146929903cecfd19",
+    "src/assets/theme.css": "43adf073599bf660534b26c7096c0fe5c25b12589d6dcb760d2d06fe2a477be4",
+    "src/client/reader.js": "5a61d629517c5315b3cb14dbae6cee226ba828e95132100f2ad36e614c57470a",
     "src/cname.11ty.js": "206fc224df91c569e18312158e7f69803061f2952513f501ada54bd06c4f8006",
     "src/contact.njk": "f4d74d038781e15af0acef571901c91e7753a2e21b6bef617429585698839a34",
     "src/feed.11ty.js": "009bd2384e08e02a9405683bab1653bab3aeaec16accb0fd01ba69b24c777da9",
     "src/index.njk": "5c313f0fcdad3ddbfb79376bc9671b3f37539ef70c14bdbbd26d6e2e6de250e8",
     "src/languages.11ty.js": "399559199c65570d7d5efd88e20254838e316f81c06d7b28ec34990e963db915",
-    "src/posts.11ty.js": "89c0e4742a67cd03f9fd13c8c8d4ca56375d97628b3cb439af7f9c92c240104a",
+    "src/posts.11ty.js": "c0bdc81183f5849670d100ceb97ecad0d1eb05f0de3eea34a0ce7427fd2e7e2a",
     "src/redirects.11ty.js": "3c163246a59f5364861db6a6f05ae88afc938a5379d86cf42776d8d49b0031f3",
     "src/search-index.11ty.js": "700dc2a2be0ef20de3a828a4612fcf7a082691eade29c6e1d75f09c24b6c6024",
     "src/search.njk": "63f2e8aeebb63c90da2e375eece639ce096cad1eff7f28628cafc46faf7ceee6",
     "src/sitemap.11ty.js": "4f233e94fb4a913ad5659116518432ed264984a7b622eba3558c77b4ec6435dc",
+    "src/styles/theme.css": "14496b8c692ea81427386125dc92822e1f06eadab30844380f77ca710c2ff7ef",
+    "static/favicon.ico": "ad3cb0b02f0164f3af6280d0bfe712879d55cec0e9a7a567f658aaddca5a55a2",
     "static/robots.txt": "16ceb5ee3e0dc13aa9adf31a3ebbe45a1d965b8c2b9f72eaf84e5911e140ed95"
   },
   "artifactSources": {

package/payload/eleventy.config.js

@@ -4,6 +4,9 @@ import { loadSiteConfiguration } from './lib/site-config.js';
 import { enforcePerformanceBudgets } from './lib/performance-budget.js';
 import { lstat, realpath } from 'node:fs/promises';
 import path from 'node:path';
+import { createHash } from 'node:crypto';
+
+const themeBootstrap = "(function(){try{var m=localStorage.getItem('gala-color-mode');if(m==='light'||m==='dark'||m==='system')document.documentElement.dataset.mode=m}catch(e){}})();";
 
 async function verifiedMediaSource(postSource, mediaSource) {
   const metadata = await lstat(mediaSource);
@@ -25,9 +28,20 @@ export default async function (eleventyConfig) {
   const [manifest, site] = await Promise.all([readBuildManifest(), loadSiteConfiguration()]);
   const attributionTier = process.env.GALA_ATTRIBUTION_TIER === 'PAID' ? 'PAID' : 'FREE';
   eleventyConfig.addGlobalData('attributionTier', attributionTier);
+  eleventyConfig.addGlobalData('themeBootstrap', themeBootstrap);
+  eleventyConfig.addFilter('sha256Csp', (value) =>
+    createHash('sha256').update(String(value)).digest('base64'));
   eleventyConfig.setLibrary('md', markdownLibrary);
   eleventyConfig.addPassthroughCopy({ static: '/' });
-  eleventyConfig.addPassthroughCopy({ 'src/assets': 'assets' });
+  eleventyConfig.addPassthroughCopy({
+    'src/assets/theme.css': 'assets/theme.css',
+    'src/assets/reader.js': 'assets/reader.js',
+    'src/assets/favicon.svg': 'assets/favicon.svg',
+    'src/assets/embed-codepen.svg': 'assets/embed-codepen.svg',
+    'src/assets/embed-gist.svg': 'assets/embed-gist.svg',
+    'src/assets/embed-x.svg': 'assets/embed-x.svg',
+    'src/assets/embed-youtube.svg': 'assets/embed-youtube.svg'
+  });
   eleventyConfig.addPassthroughCopy('custom.css');
   for (const post of manifest.posts) {
     for (const copy of post.media ?? []) {

package/payload/lib/accent.js

@@ -0,0 +1,105 @@
+/**
+ * A writer picks one colour; this makes it work in both modes.
+ *
+ * Offering a handful of named presets was not picking a colour, and an unconstrained colour picker
+ * is worse: most colours a person likes fail contrast against one ground or the other, and a
+ * writer cannot see that until the site is deployed. So the seed is treated as a *hue* the writer
+ * chose, and the lightness is moved — as little as possible — until the result is readable on the
+ * background it will actually sit on.
+ *
+ * The maths is OKLab, so a hue keeps its identity while its lightness changes. Doing this in sRGB
+ * shifts the colour itself, and a writer who picked a warm red gets back a different red.
+ */
+
+const LIGHT_GROUND = '#fdfcfb';
+const DARK_GROUND = '#131211';
+/** WCAG AA for body-sized text, which is what a link is. */
+const REQUIRED = 4.5;
+
+export function parseHex(value) {
+  if (typeof value !== 'string') return null;
+  const hex = value.trim().replace(/^#/, '');
+  const full = hex.length === 3 ? [...hex].map((digit) => digit + digit).join('') : hex;
+  if (!/^[0-9a-f]{6}$/i.test(full)) return null;
+  return [0, 2, 4].map((offset) => Number.parseInt(full.slice(offset, offset + 2), 16));
+}
+
+const toLinear = (channel) => {
+  const value = channel / 255;
+  return value <= 0.04045 ? value / 12.92 : ((value + 0.055) / 1.055) ** 2.4;
+};
+
+const toSrgb = (value) => {
+  const channel = value <= 0.0031308 ? value * 12.92 : 1.055 * value ** (1 / 2.4) - 0.055;
+  return Math.min(255, Math.max(0, Math.round(channel * 255)));
+};
+
+export function relativeLuminance([red, green, blue]) {
+  return 0.2126 * toLinear(red) + 0.7152 * toLinear(green) + 0.0722 * toLinear(blue);
+}
+
+export function contrast(a, b) {
+  const [high, low] = [relativeLuminance(a), relativeLuminance(b)].sort((x, y) => y - x);
+  return (high + 0.05) / (low + 0.05);
+}
+
+function rgbToOklab([red, green, blue]) {
+  const [r, g, b] = [red, green, blue].map(toLinear);
+  const l = Math.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b);
+  const m = Math.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b);
+  const s = Math.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b);
+  return [
+    0.2104542553 * l + 0.7936177850 * m - 0.0040720468 * s,
+    1.9779984951 * l - 2.4285922050 * m + 0.4505937099 * s,
+    0.0259040371 * l + 0.7827717662 * m - 0.8086757660 * s,
+  ];
+}
+
+function oklabToRgb([lightness, a, b]) {
+  const l = (lightness + 0.3963377774 * a + 0.2158037573 * b) ** 3;
+  const m = (lightness - 0.1055613458 * a - 0.0638541728 * b) ** 3;
+  const s = (lightness - 0.0894841775 * a - 1.2914855480 * b) ** 3;
+  return [
+    4.0767416621 * l - 3.3077115913 * m + 0.2309699292 * s,
+    -1.2684380046 * l + 2.6097574011 * m - 0.3413193965 * s,
+    -0.0041960863 * l - 0.7034186147 * m + 1.7076147010 * s,
+  ].map(toSrgb);
+}
+
+const hex = ([red, green, blue]) =>
+  `#${[red, green, blue].map((c) => c.toString(16).padStart(2, '0')).join('')}`;
+
+/**
+ * The writer's colour, moved along its own lightness until it is readable on `ground`.
+ *
+ * Searched from the seed outwards in both directions so the answer is the nearest readable
+ * version of what they chose, rather than always darker or always lighter.
+ */
+function readableOn(seed, ground) {
+  const groundRgb = parseHex(ground);
+  if (contrast(seed, groundRgb) >= REQUIRED) return hex(seed);
+
+  const [lightness, a, b] = rgbToOklab(seed);
+  let nearest = null;
+  for (let step = 0.01; step <= 1; step += 0.01) {
+    for (const direction of [-1, 1]) {
+      const candidate = lightness + direction * step;
+      if (candidate < 0 || candidate > 1) continue;
+      const rgb = oklabToRgb([candidate, a, b]);
+      if (contrast(rgb, groundRgb) >= REQUIRED) { nearest = rgb; break; }
+    }
+    if (nearest) break;
+  }
+  // Only reachable for a ground no colour can meet, which neither of ours is.
+  return hex(nearest ?? seed);
+}
+
+/**
+ * The two values the page needs: one readable on the light ground, one on the dark.
+ * Returns null for anything that is not a colour, so the caller falls back to the look's own.
+ */
+export function accentPair(seed) {
+  const rgb = parseHex(seed);
+  if (!rgb) return null;
+  return { light: readableOn(rgb, LIGHT_GROUND), dark: readableOn(rgb, DARK_GROUND) };
+}

package/payload/lib/render-markdown.js

@@ -195,7 +195,7 @@ markdown.renderer.rules.fence = (tokens, index, options, environment, self) => {
     lang: language,
     themes: SHIKI_THEMES,
     defaultColor: false
-  }));
+  }).replaceAll(/ style="[^"]*"/g, ''));
   const tokensByIndex = environment.galaHighlightTokens ??= [];
   tokensByIndex.push(token);
   return `<div class="gala-highlight-placeholder" data-highlight-token="${token}"></div>`;

package/payload/lib/seo.js

@@ -134,9 +134,12 @@ export function postSeo({ post, site, renderedHtml }) {
     ? fallbackDescription(renderedHtml)
     : authoredDescription;
   const siteName = requiredText(site.site?.name, 'site name');
-  const author = [post.frontmatter?.author, site.site?.author, siteName]
+  const configuredAuthor = site.site?.authorProfile?.displayName || site.site?.author;
+  const author = [post.frontmatter?.author, configuredAuthor, siteName]
     .find((value) => typeof value === 'string' && value.trim() !== '')
     .trim();
+  const authorProfile = author === configuredAuthor ? site.site?.authorProfile : null;
+  const publisherProfile = site.site?.publisher;
   const pageUrl = absoluteHttpsUrl(post.pageUrl, 'page URL').toString();
   const selectedCanonical = canonicalUrl({ pageUrl, canonicalOverride: post.canonicalUrl });
   const language = Intl.getCanonicalLocales(requiredText(post.language, 'post language'))[0];
@@ -168,8 +171,19 @@ export function postSeo({ post, site, renderedHtml }) {
     datePublished,
     dateModified,
     inLanguage: language,
-    author: { '@type': 'Person', name: author },
-    publisher: { '@type': 'Organization', name: siteName },
+    author: {
+      '@type': 'Person',
+      name: author,
+      ...(authorProfile?.profileUrl ? { url: authorProfile.profileUrl } : {}),
+      ...(authorProfile?.avatarUrl ? { image: authorProfile.avatarUrl } : {})
+    },
+    publisher: {
+      '@type': 'Organization',
+      name: publisherProfile?.name || siteName,
+      ...(publisherProfile?.url ? { url: publisherProfile.url } : {}),
+      ...(publisherProfile?.logoUrl
+        ? { logo: { '@type': 'ImageObject', url: publisherProfile.logoUrl } } : {})
+    },
     ...(imageUrl == null ? {} : { image: imageUrl })
   };
   const breadcrumbList = {

package/payload/lib/site-config.js

@@ -12,14 +12,20 @@ const BUDGET_KEYS = Object.freeze([
  * a publication looks; anything the CSS does not answer to has no business being offered.
  */
 const DESIGN_VALUES = Object.freeze({
-  layout: Object.freeze(['article-first', 'portfolio']),
-  palette: Object.freeze(['default', 'ocean', 'forest', 'plum']),
   theme: Object.freeze(['editorial', 'modern', 'technical']),
   colorMode: Object.freeze(['system', 'light', 'dark'])
 });
+// Accepted only so repositories created before v2 keep building. New author surfaces never offer
+// these independent knobs; v2's look owns its layout and palette as one reviewed composition.
+const LEGACY_DESIGN_VALUES = Object.freeze({
+  layout: Object.freeze(['article-first', 'portfolio']),
+  palette: Object.freeze(['default', 'ocean', 'forest', 'plum'])
+});
 const CONTACT_KEYS = Object.freeze([
   'enabled', 'websiteEnabled', 'phoneEnabled'
 ]);
+const PROFILE_KEYS = Object.freeze(['displayName', 'bio', 'avatarUrl', 'profileUrl']);
+const PUBLISHER_KEYS = Object.freeze(['name', 'url', 'logoUrl']);
 
 /*
  * `layout` and `palette` have always been required. The rest were added later and are optional:
@@ -27,8 +33,6 @@ const CONTACT_KEYS = Object.freeze([
  * back to its own defaults for anything absent. Present-but-unknown is still an error, because
  * that is a writer expecting something the CSS will not do.
  */
-const REQUIRED_DESIGN = Object.freeze(['layout', 'palette']);
-
 /** A free colour, not a menu — but still a colour. */
 const ACCENT = /^#(?:[0-9a-f]{3}|[0-9a-f]{6})$/i;
 
@@ -40,11 +44,17 @@ function validateImplementedDesign(config) {
   if (config?.design == null) return;
   for (const [field, allowed] of Object.entries(DESIGN_VALUES)) {
     const value = config.design[field];
-    if (value === undefined && !REQUIRED_DESIGN.includes(field)) continue;
+    if (value === undefined) continue;
     if (!allowed.includes(value)) {
       throw new TypeError(`Unsupported design.${field}: ${value}`);
     }
   }
+  for (const [field, allowed] of Object.entries(LEGACY_DESIGN_VALUES)) {
+    const value = config.design[field];
+    if (value !== undefined && !allowed.includes(value)) {
+      throw new TypeError(`Unsupported legacy design.${field}: ${value}`);
+    }
+  }
 }
 
 export function validatePerformanceBudgets(value) {
@@ -96,6 +106,60 @@ export function validateContact(value) {
   });
 }
 
+function profileText(value, field, maximum) {
+  if (value == null || value === 'unavailable') return '';
+  if (typeof value !== 'string') throw new TypeError(`${field} must be a string`);
+  const normalized = value.trim();
+  if ([...normalized].length > maximum) {
+    throw new TypeError(`${field} must contain at most ${maximum} characters`);
+  }
+  return normalized;
+}
+
+function profileUrl(value, field) {
+  const normalized = profileText(value, field, 2048);
+  if (normalized === '') return '';
+  let parsed;
+  try { parsed = new URL(normalized); } catch { throw new TypeError(`${field} must be an HTTPS URL`); }
+  if (parsed.protocol !== 'https:' || parsed.username !== '' || parsed.password !== '') {
+    throw new TypeError(`${field} must be a credential-free HTTPS URL`);
+  }
+  return normalized;
+}
+
+export function validateProfile(site) {
+  const legacyAuthor = profileText(site?.author, 'site.author', 120);
+  const author = site?.authorProfile;
+  const publisher = site?.publisher;
+  if (author != null && (Array.isArray(author) || typeof author !== 'object')) {
+    throw new TypeError('site.authorProfile must be a mapping');
+  }
+  if (publisher != null && (Array.isArray(publisher) || typeof publisher !== 'object')) {
+    throw new TypeError('site.publisher must be a mapping');
+  }
+  const unknownAuthor = Object.keys(author ?? {}).filter((key) => !PROFILE_KEYS.includes(key));
+  const unknownPublisher = Object.keys(publisher ?? {}).filter((key) => !PUBLISHER_KEYS.includes(key));
+  if (unknownAuthor.length) throw new TypeError(`Unsupported author profile field: ${unknownAuthor.join(', ')}`);
+  if (unknownPublisher.length) throw new TypeError(`Unsupported publisher field: ${unknownPublisher.join(', ')}`);
+  const normalized = Object.freeze({
+    author: Object.freeze({
+      displayName: profileText(author?.displayName, 'site.authorProfile.displayName', 120) || legacyAuthor,
+      bio: profileText(author?.bio, 'site.authorProfile.bio', 500),
+      avatarUrl: profileUrl(author?.avatarUrl, 'site.authorProfile.avatarUrl'),
+      profileUrl: profileUrl(author?.profileUrl, 'site.authorProfile.profileUrl')
+    }),
+    publisher: Object.freeze({
+      name: profileText(publisher?.name, 'site.publisher.name', 120),
+      url: profileUrl(publisher?.url, 'site.publisher.url'),
+      logoUrl: profileUrl(publisher?.logoUrl, 'site.publisher.logoUrl')
+    })
+  });
+  if (!normalized.publisher.name && (normalized.publisher.url || normalized.publisher.logoUrl)) {
+    throw new TypeError('site.publisher.name is required when publisher URLs are set');
+  }
+  return normalized;
+}
+
 export async function loadSiteConfiguration({
   root = process.cwd(),
   configPath = process.env.GALA_CONFIG_PATH ?? 'site.config.yml'
@@ -118,5 +182,11 @@ export async function loadSiteConfiguration({
   validatePerformanceBudgets(config?.performance?.budgets);
   config.statistics = validateStatistics(config.statistics);
   config.contact = validateContact(config.contact);
+  const profile = validateProfile(config.site);
+  config.site = {
+    ...(config.site ?? {}),
+    authorProfile: profile.author,
+    publisher: profile.publisher
+  };
   return config;
 }