@anglefeint/astro-theme 0.1.40 → 0.2.1

package/README.md

@@ -42,6 +42,8 @@ For content schema:
 export { collections } from '@anglefeint/astro-theme/content-schema';
 ```
 
+`sourceLinks` in blog frontmatter accepts standard `http(s)` URLs and bare domains such as `github.com/anglefeint/astro-theme-anglefeint`. Bare domains are normalized to `https://...` during schema parsing.
+
 ## Site Config Injection
 
 This package reads site-specific config from alias imports:
@@ -68,10 +70,10 @@ Examples:
 anglefeint-new-post my-first-post
 
 # create post only for selected locales
-anglefeint-new-post my-first-post --locales en,ja
+anglefeint-new-post my-first-post --locales en,fr
 
 # or via environment variable
-ANGLEFEINT_LOCALES=en,ja anglefeint-new-post my-first-post
+ANGLEFEINT_LOCALES=en,fr anglefeint-new-post my-first-post
 
 # create a custom page with theme variant
 anglefeint-new-page projects --theme base

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anglefeint/astro-theme",
-  "version": "0.1.40",
+  "version": "0.2.1",
   "type": "module",
   "description": "Anglefeint core theme package for Astro",
   "keywords": [

package/src/cli-new-post.mjs

@@ -1,113 +1,350 @@
 import { mkdir, writeFile, access } from 'node:fs/promises';
 import { constants } from 'node:fs';
+import { execFile as execFileCallback } from 'node:child_process';
 import { readFile } from 'node:fs/promises';
 import path from 'node:path';
-import { SUPPORTED_LOCALES } from './i18n/locales.mjs';
+import { promisify } from 'node:util';
 import {
-	buildNewPostTemplate,
-	loadDefaultCovers,
-	parseNewPostArgs,
-	pickDefaultCoverBySlug,
-	resolveLocales,
-	usageNewPost,
-	validatePostSlug,
+  buildNewPostTemplate,
+  loadDefaultCovers,
+  parseNewPostArgs,
+  pickDefaultCoverBySlug,
+  resolveLocales,
+  usageNewPost,
+  validatePostSlug,
 } from './scaffold/new-post.mjs';
 
 const CONTENT_ROOT = path.resolve(process.cwd(), 'src/content/blog');
 const DEFAULT_COVERS_ROOT = path.resolve(process.cwd(), 'src/assets/blog/default-covers');
 const SITE_CONFIG_PATH = path.resolve(process.cwd(), 'src/site.config.ts');
+const FALLBACK_LOCALES = ['en'];
+const execFile = promisify(execFileCallback);
 
 async function exists(filePath) {
-	try {
-		await access(filePath, constants.F_OK);
-		return true;
-	} catch {
-		return false;
-	}
+  try {
+    await access(filePath, constants.F_OK);
+    return true;
+  } catch {
+    return false;
+  }
 }
 
-function parseSupportedLocalesFromConfig(configSource) {
-	const localeArrayPattern = /supportedLocales\s*:\s*\[([\s\S]*?)\]/g;
-	let match = null;
-	let picked = '';
-
-	while (true) {
-		const next = localeArrayPattern.exec(configSource);
-		if (!next) break;
-		const body = next[1] ?? '';
-		if (body.includes("'") || body.includes('"')) {
-			match = next;
-			picked = body;
-		}
-	}
-
-	if (!match || !picked) return [];
-	const localeMatches = picked.match(/['"]([a-z]{2,3}(?:-[a-z0-9]+)?)['"]/gi) || [];
-	return localeMatches.map((token) => token.slice(1, -1).toLowerCase());
+function extractObjectLiteral(source, marker) {
+  const markerIndex = source.indexOf(marker);
+  if (markerIndex === -1) return '';
+
+  const start = source.indexOf('{', markerIndex);
+  return extractObjectLiteralFromIndex(source, start);
+}
+
+function extractObjectLiteralFromIndex(source, start) {
+  if (start === -1) return '';
+
+  let depth = 0;
+  let inString = false;
+  let quote = '';
+  let escaped = false;
+
+  for (let index = start; index < source.length; index += 1) {
+    const char = source[index];
+
+    if (inString) {
+      if (escaped) {
+        escaped = false;
+        continue;
+      }
+      if (char === '\\') {
+        escaped = true;
+        continue;
+      }
+      if (char === quote) {
+        inString = false;
+        quote = '';
+      }
+      continue;
+    }
+
+    if (char === '"' || char === "'" || char === '`') {
+      inString = true;
+      quote = char;
+      continue;
+    }
+
+    if (char === '{') depth += 1;
+    if (char === '}') {
+      depth -= 1;
+      if (depth === 0) return source.slice(start, index + 1);
+    }
+  }
+
+  return '';
+}
+
+function extractThemeConfigObject(configSource) {
+  const themeConfigMarkers = ['export const THEME_CONFIG', 'const THEME_CONFIG'];
+
+  for (const marker of themeConfigMarkers) {
+    const markerIndex = configSource.indexOf(marker);
+    if (markerIndex === -1) continue;
+
+    const assignmentIndex = configSource.indexOf('=', markerIndex);
+    if (assignmentIndex === -1) continue;
+
+    const objectStart = configSource.indexOf('{', assignmentIndex);
+    if (objectStart === -1) continue;
+
+    let depth = 0;
+    let inString = false;
+    let quote = '';
+    let escaped = false;
+
+    for (let index = objectStart; index < configSource.length; index += 1) {
+      const char = configSource[index];
+
+      if (inString) {
+        if (escaped) {
+          escaped = false;
+          continue;
+        }
+        if (char === '\\') {
+          escaped = true;
+          continue;
+        }
+        if (char === quote) {
+          inString = false;
+          quote = '';
+        }
+        continue;
+      }
+
+      if (char === '"' || char === "'" || char === '`') {
+        inString = true;
+        quote = char;
+        continue;
+      }
+
+      if (char === '{') depth += 1;
+      if (char === '}') {
+        depth -= 1;
+        if (depth === 0) return configSource.slice(objectStart, index + 1);
+      }
+    }
+  }
+
+  return '';
+}
+
+function localeKeyFromToken(key) {
+  return /^[a-z]{2,3}(?:-[a-z0-9]+)?$/i.test(key) ? key : '';
+}
+
+function localeObjectIsEnabled(localeObjectSource) {
+  const metaObject = extractObjectLiteral(localeObjectSource, 'meta');
+  if (!metaObject) return true;
+
+  return !/\benabled\s*:\s*false\b/.test(metaObject);
+}
+
+function parseLocaleRegistryKeys(configSource) {
+  const themeConfigObject = extractThemeConfigObject(configSource);
+  if (!themeConfigObject) return [];
+
+  const i18nObject = extractObjectLiteral(themeConfigObject, 'i18n');
+  if (!i18nObject) return [];
+
+  const localesObject = extractObjectLiteral(i18nObject, 'locales');
+  if (!localesObject) return [];
+
+  const keys = [];
+  let depth = 0;
+
+  for (let index = 0; index < localesObject.length; index += 1) {
+    const char = localesObject[index];
+
+    if (char === '{') {
+      depth += 1;
+      if (depth === 1) continue;
+    }
+    if (char === '}') {
+      depth -= 1;
+      continue;
+    }
+
+    if (depth !== 1) continue;
+
+    if (char === '"' || char === "'" || char === '`') {
+      let key = '';
+      let escaped = false;
+      const quote = char;
+      let cursor = index + 1;
+
+      for (; cursor < localesObject.length; cursor += 1) {
+        const next = localesObject[cursor];
+        if (escaped) {
+          key += next;
+          escaped = false;
+          continue;
+        }
+        if (next === '\\') {
+          escaped = true;
+          continue;
+        }
+        if (next === quote) break;
+        key += next;
+      }
+
+      let colonIndex = cursor + 1;
+      while (colonIndex < localesObject.length && /\s/.test(localesObject[colonIndex])) {
+        colonIndex += 1;
+      }
+
+      const normalizedKey = localeKeyFromToken(key);
+      if (localesObject[colonIndex] === ':' && normalizedKey) {
+        const localeObject = extractObjectLiteralFromIndex(
+          localesObject,
+          localesObject.indexOf('{', colonIndex)
+        );
+        if (!localeObject || localeObjectIsEnabled(localeObject)) {
+          keys.push(normalizedKey);
+        }
+      }
+
+      index = cursor;
+      continue;
+    }
+
+    if (/[A-Za-z_$]/.test(char)) {
+      let cursor = index + 1;
+      while (cursor < localesObject.length && /[A-Za-z0-9_$-]/.test(localesObject[cursor])) {
+        cursor += 1;
+      }
+      const key = localesObject.slice(index, cursor).trim();
+
+      let colonIndex = cursor;
+      while (colonIndex < localesObject.length && /\s/.test(localesObject[colonIndex])) {
+        colonIndex += 1;
+      }
+
+      const normalizedKey = localeKeyFromToken(key);
+      if (localesObject[colonIndex] === ':' && normalizedKey) {
+        const localeObject = extractObjectLiteralFromIndex(
+          localesObject,
+          localesObject.indexOf('{', colonIndex)
+        );
+        if (!localeObject || localeObjectIsEnabled(localeObject)) {
+          keys.push(normalizedKey);
+        }
+      }
+
+      index = cursor - 1;
+    }
+  }
+
+  return Array.from(new Set(keys));
+}
+
+async function loadNormalizedProjectI18n() {
+  const loaderSource = `
+    import { pathToFileURL } from 'node:url';
+
+    const mod = await import(pathToFileURL(process.argv[1]).href);
+    const config = mod.THEME_CONFIG?.i18n;
+
+    if (!config) process.exit(2);
+
+    const normalized =
+      typeof mod.normalizeI18nConfig === 'function' ? mod.normalizeI18nConfig(config) : config;
+
+    process.stdout.write(JSON.stringify(normalized));
+  `;
+
+  const { stdout } = await execFile(
+    process.execPath,
+    ['--experimental-strip-types', '--input-type=module', '--eval', loaderSource, SITE_CONFIG_PATH],
+    {
+      cwd: process.cwd(),
+      encoding: 'utf8',
+    }
+  );
+
+  return JSON.parse(stdout);
 }
 
 async function resolveProjectLocales() {
-	try {
-		const configSource = await readFile(SITE_CONFIG_PATH, 'utf8');
-		const locales = parseSupportedLocalesFromConfig(configSource);
-		if (locales.length === 0) return [];
-		return Array.from(new Set(locales));
-	} catch {
-		return [];
-	}
+  try {
+    const normalized = await loadNormalizedProjectI18n();
+    const locales = Object.values(normalized.locales ?? {})
+      .filter((locale) => locale?.meta?.enabled)
+      .map((locale) => locale.code)
+      .filter((locale) => typeof locale === 'string');
+    if (locales.length > 0) {
+      return Array.from(new Set(locales));
+    }
+  } catch {
+    // Fall through to the source parser fallback for environments without TS loading support.
+  }
+
+  try {
+    const configSource = await readFile(SITE_CONFIG_PATH, 'utf8');
+    const locales = parseLocaleRegistryKeys(configSource);
+    if (locales.length === 0) return [];
+    return Array.from(new Set(locales));
+  } catch {
+    return [];
+  }
 }
 
 async function main() {
-	const { slug, locales: cliLocales } = parseNewPostArgs(process.argv);
-	if (!slug) {
-		console.error(usageNewPost());
-		process.exit(1);
-	}
-
-	if (!validatePostSlug(slug)) {
-		console.error('Invalid slug. Use lowercase letters, numbers, and hyphens only.');
-		process.exit(1);
-	}
-
-	const pubDate = new Date().toISOString().slice(0, 10);
-	const defaultCovers = await loadDefaultCovers(DEFAULT_COVERS_ROOT);
-	const projectLocales = await resolveProjectLocales();
-	const locales = resolveLocales({
-		cliLocales,
-		envLocales: process.env.ANGLEFEINT_LOCALES ?? '',
-		defaultLocales: projectLocales.length > 0 ? projectLocales : SUPPORTED_LOCALES,
-	});
-	const created = [];
-	const skipped = [];
-
-	for (const locale of locales) {
-		const localeDir = path.join(CONTENT_ROOT, locale);
-		const filePath = path.join(localeDir, `${slug}.md`);
-		await mkdir(localeDir, { recursive: true });
-
-		if (await exists(filePath)) {
-			skipped.push(filePath);
-			continue;
-		}
-
-		const heroImage = pickDefaultCoverBySlug(slug, localeDir, defaultCovers);
-
-		await writeFile(filePath, buildNewPostTemplate(locale, slug, pubDate, heroImage), 'utf8');
-		created.push(filePath);
-	}
-
-	if (created.length > 0) {
-		console.log('Created files:');
-		for (const filePath of created) console.log(`- ${filePath}`);
-	}
-
-	if (skipped.length > 0) {
-		console.log('Skipped existing files:');
-		for (const filePath of skipped) console.log(`- ${filePath}`);
-	}
+  const { slug, locales: cliLocales } = parseNewPostArgs(process.argv);
+  if (!slug) {
+    console.error(usageNewPost());
+    process.exit(1);
+  }
+
+  if (!validatePostSlug(slug)) {
+    console.error('Invalid slug. Use lowercase letters, numbers, and hyphens only.');
+    process.exit(1);
+  }
+
+  const pubDate = new Date().toISOString().slice(0, 10);
+  const defaultCovers = await loadDefaultCovers(DEFAULT_COVERS_ROOT);
+  const projectLocales = await resolveProjectLocales();
+  const locales = resolveLocales({
+    cliLocales,
+    envLocales: process.env.ANGLEFEINT_LOCALES ?? '',
+    defaultLocales: projectLocales.length > 0 ? projectLocales : FALLBACK_LOCALES,
+  });
+  const created = [];
+  const skipped = [];
+
+  for (const locale of locales) {
+    const localeDir = path.join(CONTENT_ROOT, locale);
+    const filePath = path.join(localeDir, `${slug}.md`);
+    await mkdir(localeDir, { recursive: true });
+
+    if (await exists(filePath)) {
+      skipped.push(filePath);
+      continue;
+    }
+
+    const heroImage = pickDefaultCoverBySlug(slug, localeDir, defaultCovers);
+
+    await writeFile(filePath, buildNewPostTemplate(locale, slug, pubDate, heroImage), 'utf8');
+    created.push(filePath);
+  }
+
+  if (created.length > 0) {
+    console.log('Created files:');
+    for (const filePath of created) console.log(`- ${filePath}`);
+  }
+
+  if (skipped.length > 0) {
+    console.log('Skipped existing files:');
+    for (const filePath of skipped) console.log(`- ${filePath}`);
+  }
 }
 
 main().catch((error) => {
-	console.error(error);
-	process.exit(1);
+  console.error(error);
+  process.exit(1);
 });

package/src/components/BaseHead.astro

@@ -9,6 +9,8 @@ import {
   DEFAULT_LOCALE,
   SUPPORTED_LOCALES,
   alternatePathForLocale,
+  getLocaleHreflang,
+  getLocaleOgLocale,
   isLocale,
   stripLocaleFromPath,
 } from '@anglefeint/site-i18n/config';
@@ -52,21 +54,14 @@ const rssURL = new URL(`/${currentLocale}/rss.xml`, siteURL);
 const localeSubpath = stripLocaleFromPath(Astro.url.pathname, currentLocale);
 const alternatePaths = SUPPORTED_LOCALES.map((locale) => ({
   locale,
+  hreflang: getLocaleHreflang(locale),
   href: new URL(alternatePathForLocale(locale, localeSubpath), siteURL).toString(),
 }));
 const xDefaultHref = new URL(alternatePathForLocale(DEFAULT_LOCALE, localeSubpath), siteURL);
-
-const OG_LOCALE: Record<string, string> = {
-  en: 'en_US',
-  ja: 'ja_JP',
-  ko: 'ko_KR',
-  es: 'es_ES',
-  zh: 'zh_CN',
-};
-const ogLocale = OG_LOCALE[currentLocale] ?? 'en_US';
-const ogLocaleAlternates = SUPPORTED_LOCALES.filter((l) => l !== currentLocale).map(
-  (l) => OG_LOCALE[l]
-);
+const ogLocale = getLocaleOgLocale(currentLocale);
+const ogLocaleAlternates = SUPPORTED_LOCALES.filter((locale) => locale !== currentLocale)
+  .map((locale) => getLocaleOgLocale(locale))
+  .filter(Boolean);
 const articleModifiedISO = (modifiedTime ?? publishedTime)?.toISOString();
 
 const websiteSchema = {
@@ -112,6 +107,7 @@ const articleSchema = isArticle
 
 const extraSchemas = schema ? (Array.isArray(schema) ? schema : [schema]) : [];
 const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchemas].filter(Boolean);
+const serializeJsonLd = (value: unknown) => JSON.stringify(value).replace(/</g, '\\u003c');
 ---
 
 <!-- Global Metadata -->
@@ -133,7 +129,7 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 <link rel="canonical" href={canonicalURL} />
 {
   alternatePaths.map((alternate) => (
-    <link rel="alternate" hreflang={alternate.locale} href={alternate.href} />
+    <link rel="alternate" hreflang={alternate.hreflang} href={alternate.href} />
   ))
 }
 <link rel="alternate" hreflang="x-default" href={xDefaultHref} />
@@ -160,7 +156,7 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
     <meta property="og:image:height" content={String(image.height)} />
   )
 }
-<meta property="og:locale" content={ogLocale} />
+{ogLocale && <meta property="og:locale" content={ogLocale} />}
 {ogLocaleAlternates.map((loc) => <meta property="og:locale:alternate" content={loc} />)}
 {
   isArticle && publishedTime && (
@@ -183,6 +179,6 @@ const jsonLdSchemas = [websiteSchema, personSchema, articleSchema, ...extraSchem
 
 {
   jsonLdSchemas.map((schemaItem) => (
-    <script is:inline type="application/ld+json" set:html={JSON.stringify(schemaItem)} />
+    <script is:inline type="application/ld+json" set:html={serializeJsonLd(schemaItem)} />
   ))
 }

package/src/components/Giscus.astro

@@ -25,6 +25,10 @@ type Props = {
 const { comments, resolvedLocale } = Astro.props;
 const normalizedCommentTerm = comments.TERM.trim();
 const normalizedCommentNumber = comments.NUMBER.trim();
+const GISCUS_LOCALE_MAP: Record<string, string> = {
+  zh: 'zh-CN',
+};
+const giscusLocale = comments.LANG || GISCUS_LOCALE_MAP[resolvedLocale] || resolvedLocale;
 ---
 
 <script
@@ -42,7 +46,7 @@ const normalizedCommentNumber = comments.NUMBER.trim();
   data-emit-metadata={comments.EMIT_METADATA}
   data-input-position={comments.INPUT_POSITION}
   data-theme={comments.THEME}
-  data-lang={comments.LANG || resolvedLocale}
+  data-lang={giscusLocale}
   data-loading={comments.LOADING}
   crossorigin={comments.CROSSORIGIN}
   async></script>

package/src/components/shared/CommonHeader.astro

@@ -80,7 +80,9 @@ const localeOptions = SUPPORTED_LOCALES.map((targetLocale) => ({
           <span class="nav-status-dot" aria-hidden="true"></span>
           <span class="nav-status-text">{labels.status}</span>
         </div>
-        <SocialMenu links={SOCIAL_LINKS} />
+        <div class="social-menu-wrap">
+          <SocialMenu links={SOCIAL_LINKS} />
+        </div>
       </div>
     </div>
   </nav>
@@ -244,6 +246,9 @@ const localeOptions = SUPPORTED_LOCALES.map((targetLocale) => ({
       display: none !important;
     }
     .social-links {
+      display: flex;
+    }
+    .social-menu-wrap {
       display: none;
     }
     .lang-switcher {

package/src/i18n/config.ts

@@ -1,50 +1,51 @@
 import {
-	SUPPORTED_LOCALES as SUPPORTED_LOCALES_RUNTIME,
-	DEFAULT_LOCALE as DEFAULT_LOCALE_RUNTIME,
+  SUPPORTED_LOCALES as SUPPORTED_LOCALES_RUNTIME,
+  DEFAULT_LOCALE as DEFAULT_LOCALE_RUNTIME,
 } from './locales.mjs';
 
-export type Locale = 'en' | 'ja' | 'ko' | 'es' | 'zh';
-export const SUPPORTED_LOCALES = SUPPORTED_LOCALES_RUNTIME as readonly Locale[];
-export const DEFAULT_LOCALE: Locale = DEFAULT_LOCALE_RUNTIME as Locale;
+export type Locale = string;
+export const SUPPORTED_LOCALES = SUPPORTED_LOCALES_RUNTIME as readonly string[];
+export const DEFAULT_LOCALE: Locale = DEFAULT_LOCALE_RUNTIME;
 
-export const LOCALE_LABELS: Record<Locale, string> = {
-	en: 'English',
-	ja: '日本語',
-	ko: '한국어',
-	es: 'Español',
-	zh: '中文',
+export const LOCALE_LABELS: Record<string, string> = {
+  en: 'English',
+  ja: '日本語',
+  ko: '한국어',
+  es: 'Español',
+  zh: '中文',
 };
 
 export function isLocale(value: string): value is Locale {
-	return (SUPPORTED_LOCALES as readonly string[]).includes(value);
+  return (SUPPORTED_LOCALES as readonly string[]).includes(value);
 }
 
 export function withLeadingSlash(path: string): string {
-	if (!path) return '/';
-	return path.startsWith('/') ? path : `/${path}`;
+  if (!path) return '/';
+  return path.startsWith('/') ? path : `/${path}`;
 }
 
-export function localePath(locale: Locale, path = '/'): string {
-	const normalized = withLeadingSlash(path);
-	if (normalized === '/') return `/${locale}/`;
-	return `/${locale}${normalized.endsWith('/') ? normalized : `${normalized}/`}`;
+export function localePath(locale: string, path = '/'): string {
+  const normalized = withLeadingSlash(path);
+  if (normalized === '/') return `/${locale}/`;
+  return `/${locale}${normalized.endsWith('/') ? normalized : `${normalized}/`}`;
 }
 
-export function stripLocaleFromPath(pathname: string, locale: Locale): string {
-	const prefix = `/${locale}`;
-	if (!pathname.startsWith(prefix)) return pathname;
-	const withoutLocale = pathname.slice(prefix.length);
-	return withoutLocale || '/';
+export function stripLocaleFromPath(pathname: string, locale: string): string {
+  const prefix = `/${locale}`;
+  if (pathname === prefix) return '/';
+  if (!pathname.startsWith(`${prefix}/`)) return pathname;
+  const withoutLocale = pathname.slice(prefix.length);
+  return withoutLocale || '/';
 }
 
 export function blogIdToSlugAnyLocale(id: string): string {
-	const parts = id.split('/');
-	if (parts.length > 1 && isLocale(parts[0])) return parts.slice(1).join('/');
-	return id;
+  const parts = id.split('/');
+  if (parts.length > 1 && isLocale(parts[0])) return parts.slice(1).join('/');
+  return id;
 }
 
 /** URL path for a locale's version of a page. For default locale home, returns / instead of /en/. */
-export function alternatePathForLocale(locale: Locale, subpath: string): string {
-	if (locale === DEFAULT_LOCALE && (subpath === '/' || subpath === '')) return '/';
-	return localePath(locale, subpath);
+export function alternatePathForLocale(locale: string, subpath: string): string {
+  if (locale === DEFAULT_LOCALE && (subpath === '/' || subpath === '')) return '/';
+  return localePath(locale, subpath);
 }

package/src/i18n/locales.mjs

@@ -1,3 +1,3 @@
+// Fallback locale defaults for direct package consumers without a starter-level i18n registry.
 export const SUPPORTED_LOCALES = ['en', 'ja', 'ko', 'es', 'zh'];
 export const DEFAULT_LOCALE = 'en';
-

package/src/i18n/messages.ts

@@ -1,4 +1,4 @@
-import type { Locale } from './config';
+import { DEFAULT_LOCALE, type Locale } from './config';
 
 export type Messages = {
   siteTitle: string;
@@ -70,7 +70,7 @@ export type Messages = {
   };
 };
 
-export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
+export const DEFAULT_MESSAGES: Record<string, Messages> = {
   en: {
     siteTitle: 'Angle Feint',
     siteDescription: 'Cinematic web interfaces and AI-era engineering essays.',
@@ -96,7 +96,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       ethos: 'Hacker Ethos',
       now: 'Now',
       contact: 'Contact',
-      regenerate: 'Regenerate',
+      regenerate: 'Replay scan',
     },
     blog: {
       title: 'Blog',
@@ -130,7 +130,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       heroMonitor: 'neural monitor',
       heroSignalSync: 'signal sync active',
       heroModelOnline: 'model online',
-      regenerate: 'Regenerate',
+      regenerate: 'Replay scan',
       relatedAria: 'Related posts',
       backToBlogAria: 'Back to blog',
       paginationAria: 'Pagination',
@@ -165,7 +165,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       ethos: 'ハッカー精神',
       now: '現在',
       contact: '連絡先',
-      regenerate: '再生成',
+      regenerate: 'スキャン再生',
     },
     blog: {
       title: 'ブログ',
@@ -199,7 +199,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       heroMonitor: 'ニューラルモニター',
       heroSignalSync: 'シグナル同期中',
       heroModelOnline: 'モデルオンライン',
-      regenerate: '再生成',
+      regenerate: 'スキャン再生',
       relatedAria: '関連記事',
       backToBlogAria: 'ブログへ戻る',
       paginationAria: 'ページネーション',
@@ -234,7 +234,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       ethos: '해커 정신',
       now: '지금',
       contact: '연락처',
-      regenerate: '재생성',
+      regenerate: '스캔 재생',
     },
     blog: {
       title: '블로그',
@@ -268,7 +268,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       heroMonitor: '뉴럴 모니터',
       heroSignalSync: '신호 동기화 활성',
       heroModelOnline: '모델 온라인',
-      regenerate: '재생성',
+      regenerate: '스캔 재생',
       relatedAria: '관련 글',
       backToBlogAria: '블로그로 돌아가기',
       paginationAria: '페이지네이션',
@@ -303,7 +303,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       ethos: 'Ethos hacker',
       now: 'Ahora',
       contact: 'Contacto',
-      regenerate: 'Regenerar',
+      regenerate: 'Repetir escaneo',
     },
     blog: {
       title: 'Blog',
@@ -338,7 +338,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       heroMonitor: 'monitor neural',
       heroSignalSync: 'sincronización de señal activa',
       heroModelOnline: 'modelo en línea',
-      regenerate: 'Regenerar',
+      regenerate: 'Repetir escaneo',
       relatedAria: 'Publicaciones relacionadas',
       backToBlogAria: 'Volver al blog',
       paginationAria: 'Paginación',
@@ -373,7 +373,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       ethos: '黑客精神',
       now: '现在',
       contact: '联系',
-      regenerate: '重新生成',
+      regenerate: '重播扫描',
     },
     blog: {
       title: '博客',
@@ -407,7 +407,7 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       heroMonitor: '神经监视器',
       heroSignalSync: '信号同步中',
       heroModelOnline: '模型在线',
-      regenerate: '重新生成',
+      regenerate: '重播扫描',
       relatedAria: '相关文章',
       backToBlogAria: '返回博客',
       paginationAria: '分页导航',
@@ -420,5 +420,5 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
 };
 
 export function getMessages(locale: Locale): Messages {
-  return DEFAULT_MESSAGES[locale];
+  return DEFAULT_MESSAGES[locale] ?? DEFAULT_MESSAGES[DEFAULT_LOCALE];
 }

package/src/layouts/BlogPost.astro

@@ -22,6 +22,8 @@ type Props = CollectionEntry<'blog'>['data'] & {
   locale?: string;
   related?: CollectionEntry<'blog'>[];
   localeHrefs?: Partial<Record<Locale, string>>;
+  aiLatencyEstimated?: boolean;
+  aiConfidenceEstimated?: boolean;
 };
 
 const {
@@ -37,7 +39,9 @@ const {
   aiMode,
   aiState,
   aiLatencyMs,
+  aiLatencyEstimated = false,
   aiConfidence,
+  aiConfidenceEstimated = false,
   wordCount,
   tokenCount,
   author,
@@ -169,7 +173,7 @@ const hasCommentsConfig = Boolean(
                   <Image
                     class="hero-base-image"
                     src={heroImage}
-                    alt={title}
+                    alt=""
                     loading="eager"
                     decoding="async"
                     fetchpriority="high"
@@ -257,12 +261,14 @@ const hasCommentsConfig = Boolean(
               <div class="ai-response-meta">
                 {aiLatencyMs !== undefined && (
                   <span>
-                    {messages.blog.latencyLabel} <strong>{aiLatencyMs}</strong> ms
+                    {messages.blog.latencyLabel}{' '}
+                    <strong>{aiLatencyEstimated ? `~${aiLatencyMs}` : aiLatencyMs}</strong> ms
                   </span>
                 )}
                 {confidenceText !== undefined && (
                   <span>
-                    {messages.blog.confidenceLabel} <strong>{confidenceText}</strong>
+                    {messages.blog.confidenceLabel}{' '}
+                    <strong>{aiConfidenceEstimated ? `~${confidenceText}` : confidenceText}</strong>
                   </span>
                 )}
               </div>
@@ -293,8 +299,11 @@ const hasCommentsConfig = Boolean(
           </div>
         )
       }
-      <button type="button" class="ai-regenerate" aria-label={messages.blog.regenerate}
-        >{messages.blog.regenerate}</button
+      <button
+        type="button"
+        class="ai-regenerate"
+        aria-label={messages.blog.regenerate}
+        title={messages.blog.regenerate}>{messages.blog.regenerate}</button
       >
     </div>
   </article>
@@ -310,7 +319,7 @@ const hasCommentsConfig = Boolean(
             >
               {p.data.heroImage ? (
                 <div class="ai-related-img">
-                  <Image width={320} height={180} src={p.data.heroImage} alt={p.data.title} />
+                  <Image width={320} height={180} src={p.data.heroImage} alt="" />
                 </div>
               ) : (
                 <div class="ai-related-placeholder">

package/src/scaffold/new-post.mjs

@@ -1,102 +1,111 @@
 import path from 'node:path';
 import { readdir } from 'node:fs/promises';
-import { hashString, normalizePathForFrontmatter, toTitleFromSlug, validatePostSlug } from './shared.mjs';
+import {
+  hashString,
+  normalizePathForFrontmatter,
+  toTitleFromSlug,
+  validatePostSlug,
+} from './shared.mjs';
 
 export function usageNewPost() {
-	return 'Usage: npm run new-post -- <slug> [--locales en,ja,ko,es,zh]';
+  return 'Usage: npm run new-post -- <slug> [--locales en,fr,...]';
 }
 
 export function parseNewPostArgs(argv) {
-	const args = argv.slice(2);
-	const positional = [];
-	let locales = '';
+  const args = argv.slice(2);
+  const positional = [];
+  let locales = '';
 
-	for (let i = 0; i < args.length; i += 1) {
-		const token = args[i];
-		if (token === '--locales') {
-			locales = args[i + 1] ?? '';
-			i += 1;
-			continue;
-		}
-		positional.push(token);
-	}
+  for (let i = 0; i < args.length; i += 1) {
+    const token = args[i];
+    if (token === '--locales') {
+      locales = args[i + 1] ?? '';
+      i += 1;
+      continue;
+    }
+    positional.push(token);
+  }
 
-	return { slug: positional[0], locales };
+  return { slug: positional[0], locales };
 }
 
 export function resolveLocales({ cliLocales, envLocales, defaultLocales }) {
-	const raw = cliLocales || envLocales || '';
-	if (!raw) return [...defaultLocales];
+  const raw = cliLocales || envLocales || '';
+  if (!raw) return [...defaultLocales];
 
-	const parsed = raw
-		.split(',')
-		.map((locale) => locale.trim())
-		.filter(Boolean)
-		.map((locale) => locale.toLowerCase());
+  const parsed = raw
+    .split(',')
+    .map((locale) => locale.trim())
+    .filter(Boolean)
+    .map((locale) => locale.toLowerCase());
 
-	if (parsed.length === 0) {
-		throw new Error('Locales list is empty. Example: --locales en,ja,ko');
-	}
+  if (parsed.length === 0) {
+    throw new Error('Locales list is empty. Example: --locales en,fr');
+  }
 
-	const localePattern = /^[a-z]{2,3}(?:-[a-z0-9]+)?$/;
-	const invalid = parsed.find((locale) => !localePattern.test(locale));
-	if (invalid) {
-		throw new Error(`Invalid locale "${invalid}".`);
-	}
+  const localePattern = /^[a-z]{2,3}(?:-[a-z0-9]+)?$/;
+  const invalid = parsed.find((locale) => !localePattern.test(locale));
+  if (invalid) {
+    throw new Error(`Invalid locale "${invalid}".`);
+  }
 
-	return Array.from(new Set(parsed));
+  return Array.from(new Set(parsed));
 }
 
 export function buildNewPostTemplate(locale, slug, pubDate, heroImage) {
-	const titleByLocale = {
-		en: toTitleFromSlug(slug),
-		ja: '新しい記事タイトル',
-		ko: '새 글 제목',
-		es: 'Título del nuevo artículo',
-		zh: '新文章标题',
-	};
-	const descriptionByLocale = {
-		en: `A short EN post scaffold for "${slug}".`,
-		ja: `「${slug}」用の短い日本語記事テンプレートです。`,
-		ko: `"${slug}"용 한국어 글 템플릿입니다.`,
-		es: `Plantilla breve en español para "${slug}".`,
-		zh: `“${slug}”的中文文章模板。`,
-	};
-	const bodyByLocale = {
-		en: `Write your EN content for "${slug}" here.`,
-		ja: `ここに「${slug}」の日本語本文を書いてください。`,
-		ko: `여기에 "${slug}" 한국어 본문을 작성하세요.`,
-		es: `Escribe aquí el contenido en español para "${slug}".`,
-		zh: `请在这里填写“${slug}”的中文正文。`,
-	};
-	return `---
-title: '${titleByLocale[locale]}'
+  const titleByLocale = {
+    en: toTitleFromSlug(slug),
+    ja: '新しい記事タイトル',
+    ko: '새 글 제목',
+    es: 'Título del nuevo artículo',
+    zh: '新文章标题',
+  };
+  const descriptionByLocale = {
+    en: `A short EN post scaffold for "${slug}".`,
+    ja: `「${slug}」用の短い日本語記事テンプレートです。`,
+    ko: `"${slug}"용 한국어 글 템플릿입니다.`,
+    es: `Plantilla breve en español para "${slug}".`,
+    zh: `“${slug}”的中文文章模板。`,
+  };
+  const bodyByLocale = {
+    en: `Write your EN content for "${slug}" here.`,
+    ja: `ここに「${slug}」の日本語本文を書いてください。`,
+    ko: `여기에 "${slug}" 한국어 본문을 작성하세요.`,
+    es: `Escribe aquí el contenido en español para "${slug}".`,
+    zh: `请在这里填写“${slug}”的中文正文。`,
+  };
+  const resolvedTitle = titleByLocale[locale] ?? toTitleFromSlug(slug);
+  const resolvedDescription =
+    descriptionByLocale[locale] ?? `Localized post scaffold for "${slug}" (${locale}).`;
+  const resolvedBody = bodyByLocale[locale] ?? `Write your ${locale} content for "${slug}" here.`;
+  return `---
+title: '${resolvedTitle}'
 subtitle: ''
-description: '${descriptionByLocale[locale]}'
+description: '${resolvedDescription}'
 pubDate: '${pubDate}'
 ${heroImage ? `heroImage: '${heroImage}'` : ''}
 ---
 
-${bodyByLocale[locale]}
+${resolvedBody}
 `;
 }
 
 export async function loadDefaultCovers(defaultCoversRoot) {
-	try {
-		const entries = await readdir(defaultCoversRoot, { withFileTypes: true });
-		return entries
-			.filter((entry) => entry.isFile() && /\.(webp|png|jpe?g)$/i.test(entry.name))
-			.map((entry) => path.join(defaultCoversRoot, entry.name))
-			.sort((a, b) => a.localeCompare(b));
-	} catch {
-		return [];
-	}
+  try {
+    const entries = await readdir(defaultCoversRoot, { withFileTypes: true });
+    return entries
+      .filter((entry) => entry.isFile() && /\.(webp|png|jpe?g)$/i.test(entry.name))
+      .map((entry) => path.join(defaultCoversRoot, entry.name))
+      .sort((a, b) => a.localeCompare(b));
+  } catch {
+    return [];
+  }
 }
 
 export function pickDefaultCoverBySlug(slug, localeDir, defaultCovers) {
-	if (defaultCovers.length === 0) return '';
-	const coverPath = defaultCovers[hashString(slug) % defaultCovers.length];
-	return normalizePathForFrontmatter(path.relative(localeDir, coverPath));
+  if (defaultCovers.length === 0) return '';
+  const coverPath = defaultCovers[hashString(slug) % defaultCovers.length];
+  return normalizePathForFrontmatter(path.relative(localeDir, coverPath));
 }
 
 export { validatePostSlug };

package/src/scripts/about/modals.js

@@ -10,7 +10,19 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
   const modalOverlay = document.getElementById('hacker-modal');
   const modalBody = document.getElementById('hacker-modal-body');
   const modalTitle = document.querySelector('.hacker-modal-title');
+  const closeButton = document.querySelector('.hacker-modal-close');
   if (!modalOverlay || !modalBody || !modalTitle) return;
+  let lastFocusedElement = null;
+
+  function getFocusableElements() {
+    return Array.from(
+      modalOverlay.querySelectorAll(
+        'button:not([disabled]), [href], input:not([disabled]), select:not([disabled]), textarea:not([disabled]), [tabindex]:not([tabindex="-1"])'
+      )
+    ).filter(
+      (element) => !element.hasAttribute('hidden') && element.getAttribute('aria-hidden') !== 'true'
+    );
+  }
 
   const decryptorKeysLabel =
     typeof runtimeConfig.decryptorKeysLabel === 'string' ? runtimeConfig.decryptorKeysLabel : '';
@@ -36,10 +48,15 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
     if (modalEl) modalEl.classList.remove('hacker-modal-wide');
     modalOverlay.classList.remove('open');
     modalOverlay.setAttribute('aria-hidden', 'true');
+    if (lastFocusedElement && typeof lastFocusedElement.focus === 'function') {
+      lastFocusedElement.focus();
+    }
   };
 
   const openModal = (data) => {
     if (!data) return;
+    lastFocusedElement =
+      document.activeElement instanceof HTMLElement ? document.activeElement : null;
 
     decryptor.stop();
     if (cleanupKeyboard) {
@@ -84,6 +101,13 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
 
     modalOverlay.classList.add('open');
     modalOverlay.setAttribute('aria-hidden', 'false');
+    window.requestAnimationFrame(() => {
+      const focusables = getFocusableElements();
+      const nextFocus = focusables[0] || closeButton || modalOverlay;
+      if (nextFocus && typeof nextFocus.focus === 'function') {
+        nextFocus.focus();
+      }
+    });
   };
 
   const folderButtons = Array.from(document.querySelectorAll('.hacker-folder[data-modal]'));
@@ -97,7 +121,6 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
     return [button, onClick];
   });
 
-  const closeButton = document.querySelector('.hacker-modal-close');
   if (closeButton) closeButton.addEventListener('click', closeModal);
 
   const onOverlayClick = (event) => {
@@ -106,7 +129,38 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
   modalOverlay.addEventListener('click', onOverlayClick);
 
   const onDocumentKeydown = (event) => {
-    if (event.key === 'Escape' && modalOverlay.classList.contains('open')) closeModal();
+    if (!modalOverlay.classList.contains('open')) return;
+    if (event.key === 'Escape') {
+      closeModal();
+      return;
+    }
+    if (event.key !== 'Tab') return;
+
+    const focusables = getFocusableElements();
+    if (focusables.length === 0) {
+      event.preventDefault();
+      if (closeButton && typeof closeButton.focus === 'function') {
+        closeButton.focus();
+      }
+      return;
+    }
+
+    const currentIndex = focusables.indexOf(document.activeElement);
+    const first = focusables[0];
+    const last = focusables[focusables.length - 1];
+
+    if (event.shiftKey) {
+      if (document.activeElement === first || currentIndex === -1) {
+        event.preventDefault();
+        last.focus();
+      }
+      return;
+    }
+
+    if (document.activeElement === last) {
+      event.preventDefault();
+      first.focus();
+    }
   };
   document.addEventListener('keydown', onDocumentKeydown);
 

package/src/scripts/about/reading-ui.js

@@ -6,9 +6,10 @@ export function initAboutReadingUi(runtimeConfig, prefersReducedMotion) {
     p60: 'inference stable',
     p90: 'output finalized',
   };
-  var toastMessages = runtimeConfig.effects && runtimeConfig.effects.scrollToasts
-    ? runtimeConfig.effects.scrollToasts
-    : fallbackToasts;
+  var toastMessages =
+    runtimeConfig.effects && runtimeConfig.effects.scrollToasts
+      ? runtimeConfig.effects.scrollToasts
+      : fallbackToasts;
   var stageSeen = { p30: false, p60: false, p90: false };
   var toastTimer = 0;
   var hasScrolled = false;
@@ -18,9 +19,9 @@ export function initAboutReadingUi(runtimeConfig, prefersReducedMotion) {
     toast.textContent = '> ' + msg;
     toast.classList.add('visible');
     clearTimeout(toastTimer);
-    toastTimer = setTimeout(function() {
+    toastTimer = setTimeout(function () {
       toast.classList.remove('visible');
-    }, 900);
+    }, 1800);
   }
 
   if (progress) {
@@ -53,7 +54,7 @@ export function initAboutReadingUi(runtimeConfig, prefersReducedMotion) {
 
   var backTop = document.querySelector('.hacker-back-to-top');
   if (backTop) {
-    backTop.addEventListener('click', function() {
+    backTop.addEventListener('click', function () {
       window.scrollTo({ top: 0, behavior: prefersReducedMotion ? 'auto' : 'smooth' });
     });
   }

package/src/scripts/blogpost/read-progress.js

@@ -23,9 +23,9 @@ export function initReadProgressAndBackToTop(prefersReducedMotion) {
     toast.textContent = msg;
     toast.classList.add('visible');
     clearTimeout(toastTimer);
-    toastTimer = setTimeout(function() {
+    toastTimer = setTimeout(function () {
       toast.classList.remove('visible');
-    }, 900);
+    }, 1800);
   }
 
   if (progress) {
@@ -62,7 +62,7 @@ export function initReadProgressAndBackToTop(prefersReducedMotion) {
 
   var backTop = document.querySelector('.ai-back-to-top');
   if (backTop) {
-    backTop.addEventListener('click', function() {
+    backTop.addEventListener('click', function () {
       window.scrollTo({ top: 0, behavior: prefersReducedMotion ? 'auto' : 'smooth' });
     });
   }