@master/internal-site 0.1.3 → 0.2.0

package/src/scripts/static-social.ts

@@ -15,7 +15,7 @@ export interface StaticSocialOptions {
     locales?: readonly string[]
 }
 
-/** Replace dynamic card placeholders with static, content-addressed PNG files. */
+/** Share the canonical source artwork across locales; social text remains localized. */
 export async function generateStaticSocialImages({ siteDir, outDir, origin, logo, defaultLocale = 'en', locales = ['en'] }: StaticSocialOptions) {
     const authorImageFiles: Record<string, string> = { Aron: 'aron.jpg', Joy: 'joy.jpg', BenSeage: 'benseage.jpg', Miles: 'miles.jpg', Lola: 'lola.jpg' }
     await generate()
@@ -34,15 +34,29 @@ async function generate() {
 
     if (!filesWithMatches.length) return
 
+    const byPath = new Map(filesWithMatches.map(record => [path.relative(outDir, record.file).split(path.sep).join('/'), record]))
+    const sourceMatches = (file: string, matches: string[]) => {
+        const relative = path.relative(outDir, file).split(path.sep).join('/')
+        const [first, ...rest] = relative.split('/')
+        const locale = first.replace(/\.html$/, '')
+        if (!locales.includes(locale) || locale === defaultLocale) return matches
+        const source = byPath.get(rest.join('/') || 'index.html')
+        if (!source) throw new Error(`Missing canonical source social image for ${relative}`)
+        return source.matches
+    }
+
     await rm(path.join(outDir, 'og'), { recursive: true, force: true })
 
     const generated = new Map<string, string>()
 
     for (const { file, matches, content: originalContent } of filesWithMatches) {
         let content = originalContent
+        const canonical = sourceMatches(file, matches)
 
-        for (const rawUrl of matches) {
-            const normalizedUrl = normalizeOgImageUrl(rawUrl)
+        for (const [index, rawUrl] of matches.entries()) {
+            const sourceUrl = canonical[index] ?? (canonical.length === 1 ? canonical[0] : undefined)
+            if (!sourceUrl) throw new Error(`Cannot match canonical social artwork for ${path.relative(outDir, file)}`)
+            const normalizedUrl = normalizeOgImageUrl(sourceUrl)
             const cacheKey = getOgImageCacheKey(normalizedUrl)
             let staticPath = generated.get(cacheKey)
             if (!staticPath) {

package/src/scripts/style-delivery.mjs

@@ -4,6 +4,7 @@ import { resolve, relative, dirname } from 'node:path'
 import { pathToFileURL } from 'node:url'
 import { createHash } from 'node:crypto'
 import { gzipSync, brotliCompressSync } from 'node:zlib'
+import { locales as siteLocales, defaultLocale as siteDefaultLocale } from '../docs-shell/common/locales.js'
 
 export async function filesAt(root) {
   const files = []
@@ -56,6 +57,7 @@ export async function auditStyles(directory) {
     routes[route] = {
       links, assets: [...seen], files: seen.size, depth,
       ...Object.fromEntries(['bytes', 'gzip', 'brotli'].map(k => [k, totals.reduce((n, x) => n + x[k], 0)])),
+      inlineSHA256: hash(inline.join('\n')),
       inlineBytes: inline.reduce((n, s) => n + Buffer.byteLength(s), 0),
       families: Object.fromEntries(families.map(name => [name, new RegExp(`(?:^|[;{}])\\s*\\.ui-${name}\\s*\\{`).test(delivered)])),
       foundationCount: [...delivered.matchAll(/body,\s*:host\s*\{\s*font-family:\s*var\(--font-family-sans\)/g)].length,
@@ -66,12 +68,14 @@ export async function auditStyles(directory) {
   return { version: 1, routes, assets: Object.fromEntries(Object.entries(assets).map(([href, { css, ...item }]) => [href, item])) }
 }
 
-/** Exact per-route ceilings. New routes require an explicit reviewed budget. */
-export function assertStyleBudget(report, budget) {
+/** Exact per-page ceilings; localized editions share the ceiling only with identical CSS. */
+export function assertStyleBudget(report, budget, { locales = siteLocales, defaultLocale = siteDefaultLocale } = {}) {
   const failures = []
   if (!Object.keys(report.routes).length) throw new Error('Empty style delivery inventory')
   for (const [route, item] of Object.entries(report.routes)) {
-    const cap = budget.routes[route]
+    const segment = route.split('/')[1]
+    const canonical = segment !== defaultLocale && locales.includes(segment) ? route.slice(segment.length + 1) || '/' : route
+    const cap = budget.routes[route] ?? budget.routes[canonical]
     if (!cap) { failures.push(`${route}: missing reviewed budget`); continue }
     for (const key of ['files', 'depth', 'gzip', 'brotli', 'inlineBytes']) {
       if (item[key] > cap[key]) failures.push(`${route}: ${key} ${item[key]} > ${cap[key]}`)
@@ -79,7 +83,13 @@ export function assertStyleBudget(report, budget) {
     if (item.foundationCount !== 1) failures.push(`${route}: foundation count ${item.foundationCount}`)
     if (item.layerOrder.join(',') !== 'theme,base,defaults,components,utilities') failures.push(`${route}: layer order`)
     if (item.uncompiled) failures.push(`${route}: uncompiled directives`)
-    if (['/', '/404', '/tw', '/tw/404'].includes(route)) {
+    if (canonical !== route) {
+      const source = report.routes[canonical]
+      const assets = entry => entry.assets.map(href => report.assets[href].sha256).sort().join(',')
+      if (!source) failures.push(`${route}: missing canonical style route ${canonical}`)
+      else if (assets(item) !== assets(source) || item.inlineSHA256 !== source.inlineSHA256) failures.push(`${route}: CSS differs from ${canonical}`)
+    }
+    if (['/', '/404'].includes(canonical)) {
       for (const name of ['sidebar', 'toc', 'pager', 'switch', 'range']) if (item.families[name]) failures.push(`${route}: unrelated ${name}`)
     }
   }

package/src/sections/guide.astro

@@ -4,7 +4,9 @@ import DocHeader from '@master/internal-site/components/DocHeader.svelte'
 import DocSidebar from '@master/internal-site/components/DocSidebar.svelte'
 import DocWrapper from '@master/internal-site/components/DocWrapper.astro'
 import navigation from 'virtual:master-site/navigation'
-const pageCategories = navigation.guide ?? []
+import { resolveNavigation } from '../docs-shell/factories/create-page'
+import { siteOf } from '../astro/site-context'
+const pageCategories = resolveNavigation(siteOf(Astro).locale, navigation.guide ?? [])
 import type { MetadataTitle } from '@master/internal-site/types/Metadata'
 
 export const bodyClass = 'bg-surface-base'

package/src/virtual.d.ts

@@ -7,9 +7,13 @@ declare module 'virtual:master-site/app' {
   export default app
 }
 declare module 'virtual:master-site/translations' {
-  const translations: Record<string, () => Promise<import('@master/internal-site/factories/create-page').ContentModule>>
+  const translations: Record<string, Record<string, () => Promise<import('@master/internal-site/astro/propagated-assets').PropagatedModule<import('@master/internal-site/factories/create-page').ContentModule>>>>
   export default translations
 }
+declare module 'virtual:master-site/localized-metadata' {
+  const metadata: Record<string, Record<string, Record<string, any>>>
+  export default metadata
+}
 declare module 'virtual:master-site/highlight' {
   const highlight: typeof import('@master/internal-site/utils/highlight-code-core').default
   export default highlight

package/src/blog/article/language.ts

@@ -1,29 +0,0 @@
-interface Locales {
-  locale: string
-  defaultLocale: string
-  hreflangOfLocale?: Record<string, string>
-}
-
-interface Languages extends Locales {
-  translations: Record<string, string>
-}
-
-/**
- * Text a translated page shows in the post's own language (the title or body before it is translated) keeps that
- * language, so screen readers pronounce it correctly and type set for Han text leaves it alone.
- */
-export function sourceLanguageOf(text: string | undefined, { locale, defaultLocale, translations, hreflangOfLocale }: Languages) {
-  if (!text || locale === defaultLocale || translations[text]) return undefined
-  return hreflangOfLocale?.[defaultLocale] ?? defaultLocale
-}
-
-/**
- * The language of a post's body on a translated page: its source language while no `content.<locale>.mdx` sits beside
- * the source (the key format of docs-shell/factories/create-page), otherwise the page's own.
- */
-export function contentLanguageOf(sourcePath: string | undefined, translatedContent: Set<string>, { locale, defaultLocale, hreflangOfLocale }: Locales) {
-  if (locale === defaultLocale) return undefined
-  const directory = /^site\/content\/(.+)\/content\.mdx$/.exec(sourcePath ?? '')?.[1]
-  if (directory && translatedContent.has(`/content/${directory}/content.${locale}.mdx`)) return undefined
-  return hreflangOfLocale?.[defaultLocale] ?? defaultLocale
-}