@anglefeint/astro-theme 0.1.37 → 0.1.39

package/README.md

@@ -54,7 +54,7 @@ This package reads site-specific config from alias imports:
 
 In the starter/site project, map these aliases to `src/config/*` and `src/i18n/*` in both Vite and TS config.
 
-Giscus comments are configured from site-side `theme.comments` (core IDs + behavior fields like `mapping`, `inputPosition`, `theme`, and `lang`). If required core fields are not set, comments are not rendered.
+Giscus comments are configured from site-side `theme.comments` (core IDs + behavior fields like `mapping`, `inputPosition`, `theme`, and `lang`). If required core fields are not set, comments are not rendered. When `mapping="specific"` set `term`; when `mapping="number"` set `number`.
 
 ## CLI
 

package/package.json

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

package/src/components/shared/CommonHeader.astro

@@ -6,242 +6,248 @@ import HeaderLink from '../HeaderLink.astro';
 import LangSwitcher from './LangSwitcher.astro';
 import SocialMenu from './SocialMenu.astro';
 import {
-	DEFAULT_LOCALE,
-	LOCALE_LABELS,
-	type Locale,
-	SUPPORTED_LOCALES,
-	alternatePathForLocale,
-	isLocale,
-	stripLocaleFromPath,
+  DEFAULT_LOCALE,
+  LOCALE_LABELS,
+  type Locale,
+  SUPPORTED_LOCALES,
+  alternatePathForLocale,
+  isLocale,
+  stripLocaleFromPath,
 } from '@anglefeint/site-i18n/config';
 
 interface Props {
-	locale?: Locale;
-	homeHref?: string;
-	/** Optional per-locale overrides (used for existence-aware language fallback on some routes). */
-	localeHrefs?: Partial<Record<Locale, string>>;
-	/** Show Blade Runner scanlines overlay on ai-page (header/footer only) */
-	scanlines?: boolean;
-	labels?: {
-		home: string;
-		blog: string;
-		about: string;
-		status: string;
-		language: string;
-	};
+  locale?: Locale;
+  homeHref?: string;
+  /** Optional per-locale overrides (used for existence-aware language fallback on some routes). */
+  localeHrefs?: Partial<Record<Locale, string>>;
+  /** Show Blade Runner scanlines overlay on ai-page (header/footer only) */
+  scanlines?: boolean;
+  labels?: {
+    home: string;
+    blog: string;
+    about: string;
+    status: string;
+    statusAria: string;
+    language: string;
+  };
 }
 
 const props = Astro.props as Props;
 const locale: Locale = props.locale && isLocale(props.locale) ? props.locale : DEFAULT_LOCALE;
 const labels = {
-	home: props.labels?.home ?? 'Home',
-	blog: props.labels?.blog ?? 'Blog',
-	about: props.labels?.about ?? 'About',
-	status: props.labels?.status ?? 'system: online',
-	language: props.labels?.language ?? 'Language',
+  home: props.labels?.home ?? 'Home',
+  blog: props.labels?.blog ?? 'Blog',
+  about: props.labels?.about ?? 'About',
+  status: props.labels?.status ?? 'system: online',
+  statusAria: props.labels?.statusAria ?? 'System status',
+  language: props.labels?.language ?? 'Language',
 };
 const showAbout = THEME.ENABLE_ABOUT_PAGE;
 const currentSubpath = stripLocaleFromPath(Astro.url.pathname, locale);
 const homeHref = props.homeHref ?? alternatePathForLocale(locale, '/');
 const buildLocaleHref = (targetLocale: Locale) => {
-	// Language switcher: preserve current route when switching locales.
-	// Only fall back for About when the feature is disabled.
-	const sectionSubpath =
-		currentSubpath.startsWith('/about') && !showAbout ? '/' : currentSubpath || '/';
-	return alternatePathForLocale(targetLocale, sectionSubpath);
+  // Language switcher: preserve current route when switching locales.
+  // Only fall back for About when the feature is disabled.
+  const sectionSubpath =
+    currentSubpath.startsWith('/about') && !showAbout ? '/' : currentSubpath || '/';
+  return alternatePathForLocale(targetLocale, sectionSubpath);
 };
 const localeOptions = SUPPORTED_LOCALES.map((targetLocale) => ({
-	locale: targetLocale,
-	label: LOCALE_LABELS[targetLocale],
-	href: props.localeHrefs?.[targetLocale] ?? buildLocaleHref(targetLocale),
+  locale: targetLocale,
+  label: LOCALE_LABELS[targetLocale],
+  href: props.localeHrefs?.[targetLocale] ?? buildLocaleHref(targetLocale),
 }));
 ---
 
 <header>
-	<nav>
-		<div class="nav-left">
-			<h2><a href={homeHref}>{SITE_TITLE}</a></h2>
-		</div>
-		<div class="internal-links">
-			<HeaderLink href={homeHref}>{labels.home}</HeaderLink>
-			<HeaderLink href={alternatePathForLocale(locale, '/blog/')}>{labels.blog}</HeaderLink>
-			{showAbout && <HeaderLink href={alternatePathForLocale(locale, '/about/')}>{labels.about}</HeaderLink>}
-		</div>
-		<div class="nav-right">
-			<div class="social-links">
-				<LangSwitcher label={labels.language} currentLocale={locale} options={localeOptions} />
-				<div class="nav-status" aria-label="System status">
-					<span class="nav-status-dot" aria-hidden="true"></span>
-					<span class="nav-status-text">{labels.status}</span>
-				</div>
-				<SocialMenu links={SOCIAL_LINKS} />
-			</div>
-		</div>
-	</nav>
-	{props.scanlines && <div class="ai-scanlines" aria-hidden="true"></div>}
+  <nav>
+    <div class="nav-left">
+      <h2><a href={homeHref}>{SITE_TITLE}</a></h2>
+    </div>
+    <div class="internal-links">
+      <HeaderLink href={homeHref}>{labels.home}</HeaderLink>
+      <HeaderLink href={alternatePathForLocale(locale, '/blog/')}>{labels.blog}</HeaderLink>
+      {
+        showAbout && (
+          <HeaderLink href={alternatePathForLocale(locale, '/about/')}>{labels.about}</HeaderLink>
+        )
+      }
+    </div>
+    <div class="nav-right">
+      <div class="social-links">
+        <LangSwitcher label={labels.language} currentLocale={locale} options={localeOptions} />
+        <div class="nav-status" aria-label={labels.statusAria}>
+          <span class="nav-status-dot" aria-hidden="true"></span>
+          <span class="nav-status-text">{labels.status}</span>
+        </div>
+        <SocialMenu links={SOCIAL_LINKS} />
+      </div>
+    </div>
+  </nav>
+  {props.scanlines && <div class="ai-scanlines" aria-hidden="true" />}
 </header>
 <style>
-	header {
-		margin: 0;
-		padding: 0 1em;
-		background: var(--chrome-bg, var(--bg));
-		border-bottom: 1px solid var(--chrome-border, rgb(var(--border)));
-	}
-	h2 {
-		margin: 0;
-		font-size: 1em;
-	}
+  header {
+    margin: 0;
+    padding: 0 1em;
+    background: var(--chrome-bg, var(--bg));
+    border-bottom: 1px solid var(--chrome-border, rgb(var(--border)));
+  }
+  h2 {
+    margin: 0;
+    font-size: 1em;
+  }
 
-	h2 a,
-	h2 a.active {
-		text-decoration: none;
-		color: var(--chrome-link, rgb(var(--text)));
-		border-bottom: none;
-	}
-	nav {
-		display: grid;
-		grid-template-columns: 1fr auto 1fr;
-		align-items: center;
-		gap: 0.6rem;
-		min-height: 56px;
-		width: 100%;
-	}
-	.nav-left {
-		justify-self: start;
-	}
-	.internal-links {
-		justify-self: center;
-		display: flex;
-		align-items: center;
-		gap: 0.1rem;
-	}
-	.nav-right {
-		justify-self: end;
-		display: flex;
-		align-items: center;
-		gap: 0.35rem;
-		min-width: max-content;
-	}
-	.internal-links :global(a) {
-		padding: 1em 0.5em;
-		color: var(--chrome-link, rgb(var(--text)));
-		border-bottom: 4px solid transparent;
-		text-decoration: none;
-	}
-	.internal-links :global(a.active) {
-		text-decoration: none;
-		border-bottom-color: var(--chrome-active, var(--accent));
-	}
-	.social-links a {
-		color: var(--chrome-link, rgb(var(--text)));
-		align-items: center;
-		justify-content: center;
-		padding: 0.6rem 0.35rem;
-		border-bottom: none;
-	}
-	.social-links a:hover {
-		color: var(--chrome-link-hover, var(--chrome-link, rgb(var(--text))));
-	}
-	.social-links,
-	.social-links a {
-		display: flex;
-	}
-	.social-links {
-		align-items: center;
-		gap: 0.4rem;
-		position: relative;
-		flex-wrap: nowrap;
-		--lang-switcher-border: rgba(132, 214, 255, 0.2);
-		--lang-switcher-bg: rgba(6, 16, 30, 0.35);
-		--lang-label-color: rgba(190, 226, 248, 0.78);
-		--lang-select-arrow: rgba(204, 236, 252, 0.82);
-		--lang-select-bg: rgba(9, 22, 40, 0.68);
-		--lang-select-border: rgba(132, 214, 255, 0.2);
-		--lang-select-text: rgba(204, 236, 252, 0.86);
-		--lang-select-focus-border: rgba(132, 214, 255, 0.5);
-		--lang-select-focus-ring: rgba(98, 180, 228, 0.18);
-		--lang-select-option-text: #ccecfb;
-		--lang-select-option-bg: #0b1c32;
-	}
-	.nav-status {
-		display: none;
-		align-items: center;
-		gap: 0.45rem;
-		padding: 0.24rem 0.5rem;
-		border-radius: 999px;
-		font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
-		font-size: 0.62rem;
-		letter-spacing: 0.12em;
-		text-transform: uppercase;
-		color: rgba(186, 232, 252, 0.86);
-		background: rgba(6, 16, 30, 0.52);
-		border: 1px solid rgba(132, 214, 255, 0.22);
-		box-shadow:
-			0 0 0 1px rgba(132, 214, 255, 0.08),
-			0 0 16px rgba(90, 180, 255, 0.16);
-		white-space: nowrap;
-		position: absolute;
-		right: calc(100% + 0.5rem);
-		top: 50%;
-		transform: translateY(-50%);
-		pointer-events: none;
-	}
-	.nav-status-dot {
-		width: 0.44rem;
-		height: 0.44rem;
-		border-radius: 50%;
-		background: rgba(150, 226, 255, 0.96);
-		box-shadow: 0 0 10px rgba(122, 210, 255, 0.72);
-		animation: nav-status-pulse 1.8s steps(1, end) infinite;
-	}
-	@keyframes nav-status-pulse {
-		0%,
-		78%,
-		100% {
-			opacity: 1;
-			transform: scale(1);
-		}
-		82% {
-			opacity: 0.2;
-			transform: scale(0.7);
-		}
-		86% {
-			opacity: 1;
-			transform: scale(1.05);
-		}
-		90% {
-			opacity: 0.28;
-			transform: scale(0.78);
-		}
-	}
-	body.ai-page .nav-status {
-		display: inline-flex;
-	}
-	body.about-page .nav-status {
-		display: none;
-	}
-	@media (max-width: 720px) {
-		nav {
-			grid-template-columns: 1fr;
-			gap: 0;
-		}
-		.nav-left {
-			display: none;
-		}
-		.internal-links {
-			justify-self: start;
-		}
-		.nav-right {
-			justify-self: end;
-		}
-		.nav-status {
-			display: none !important;
-		}
-		.social-links {
-			display: none;
-		}
-		.lang-switcher {
-			margin-right: 0;
-		}
-	}
+  h2 a,
+  h2 a.active {
+    text-decoration: none;
+    color: var(--chrome-link, rgb(var(--text)));
+    border-bottom: none;
+  }
+  nav {
+    display: grid;
+    grid-template-columns: 1fr auto 1fr;
+    align-items: center;
+    gap: 0.6rem;
+    min-height: 56px;
+    width: 100%;
+  }
+  .nav-left {
+    justify-self: start;
+  }
+  .internal-links {
+    justify-self: center;
+    display: flex;
+    align-items: center;
+    gap: 0.1rem;
+  }
+  .nav-right {
+    justify-self: end;
+    display: flex;
+    align-items: center;
+    gap: 0.35rem;
+    min-width: max-content;
+  }
+  .internal-links :global(a) {
+    padding: 1em 0.5em;
+    color: var(--chrome-link, rgb(var(--text)));
+    border-bottom: 4px solid transparent;
+    text-decoration: none;
+  }
+  .internal-links :global(a.active) {
+    text-decoration: none;
+    border-bottom-color: var(--chrome-active, var(--accent));
+  }
+  .social-links a {
+    color: var(--chrome-link, rgb(var(--text)));
+    align-items: center;
+    justify-content: center;
+    padding: 0.6rem 0.35rem;
+    border-bottom: none;
+  }
+  .social-links a:hover {
+    color: var(--chrome-link-hover, var(--chrome-link, rgb(var(--text))));
+  }
+  .social-links,
+  .social-links a {
+    display: flex;
+  }
+  .social-links {
+    align-items: center;
+    gap: 0.4rem;
+    position: relative;
+    flex-wrap: nowrap;
+    --lang-switcher-border: rgba(132, 214, 255, 0.2);
+    --lang-switcher-bg: rgba(6, 16, 30, 0.35);
+    --lang-label-color: rgba(190, 226, 248, 0.78);
+    --lang-select-arrow: rgba(204, 236, 252, 0.82);
+    --lang-select-bg: rgba(9, 22, 40, 0.68);
+    --lang-select-border: rgba(132, 214, 255, 0.2);
+    --lang-select-text: rgba(204, 236, 252, 0.86);
+    --lang-select-focus-border: rgba(132, 214, 255, 0.5);
+    --lang-select-focus-ring: rgba(98, 180, 228, 0.18);
+    --lang-select-option-text: #ccecfb;
+    --lang-select-option-bg: #0b1c32;
+  }
+  .nav-status {
+    display: none;
+    align-items: center;
+    gap: 0.45rem;
+    padding: 0.24rem 0.5rem;
+    border-radius: 999px;
+    font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+    font-size: 0.62rem;
+    letter-spacing: 0.12em;
+    text-transform: uppercase;
+    color: rgba(186, 232, 252, 0.86);
+    background: rgba(6, 16, 30, 0.52);
+    border: 1px solid rgba(132, 214, 255, 0.22);
+    box-shadow:
+      0 0 0 1px rgba(132, 214, 255, 0.08),
+      0 0 16px rgba(90, 180, 255, 0.16);
+    white-space: nowrap;
+    position: absolute;
+    right: calc(100% + 0.5rem);
+    top: 50%;
+    transform: translateY(-50%);
+    pointer-events: none;
+  }
+  .nav-status-dot {
+    width: 0.44rem;
+    height: 0.44rem;
+    border-radius: 50%;
+    background: rgba(150, 226, 255, 0.96);
+    box-shadow: 0 0 10px rgba(122, 210, 255, 0.72);
+    animation: nav-status-pulse 1.8s steps(1, end) infinite;
+  }
+  @keyframes nav-status-pulse {
+    0%,
+    78%,
+    100% {
+      opacity: 1;
+      transform: scale(1);
+    }
+    82% {
+      opacity: 0.2;
+      transform: scale(0.7);
+    }
+    86% {
+      opacity: 1;
+      transform: scale(1.05);
+    }
+    90% {
+      opacity: 0.28;
+      transform: scale(0.78);
+    }
+  }
+  body.ai-page .nav-status {
+    display: inline-flex;
+  }
+  body.about-page .nav-status {
+    display: none;
+  }
+  @media (max-width: 720px) {
+    nav {
+      grid-template-columns: 1fr;
+      gap: 0;
+    }
+    .nav-left {
+      display: none;
+    }
+    .internal-links {
+      justify-self: start;
+    }
+    .nav-right {
+      justify-self: end;
+    }
+    .nav-status {
+      display: none !important;
+    }
+    .social-links {
+      display: none;
+    }
+    .lang-switcher {
+      margin-right: 0;
+    }
+  }
 </style>

package/src/components/shared/SocialMenu.astro

@@ -3,46 +3,46 @@ import { SOCIAL_LINKS, type SocialLink } from '@anglefeint/site-config/social';
 import Icon from './Icon.astro';
 
 interface Props {
-	links?: SocialLink[];
-	iconSize?: number;
-	showPlaceholdersWhenEmpty?: boolean;
+  links?: SocialLink[];
+  iconSize?: number;
+  showPlaceholdersWhenEmpty?: boolean;
 }
 
 const {
-	links = SOCIAL_LINKS,
-	iconSize = 32,
-	showPlaceholdersWhenEmpty = true,
+  links = SOCIAL_LINKS,
+  iconSize = 32,
+  showPlaceholdersWhenEmpty = true,
 } = Astro.props as Props;
 const placeholderLinks: SocialLink[] = [
-	{ href: '', label: 'Mastodon', icon: 'mastodon' },
-	{ href: '', label: 'Twitter', icon: 'twitter' },
-	{ href: '', label: 'GitHub', icon: 'github' },
+  { href: '', label: 'Mastodon', icon: 'mastodon' },
+  { href: '', label: 'Twitter', icon: 'twitter' },
+  { href: '', label: 'GitHub', icon: 'github' },
 ];
 const resolvedLinks = links.length > 0 || !showPlaceholdersWhenEmpty ? links : placeholderLinks;
 ---
 
 {
-	resolvedLinks.map((link) => (
-		links.length > 0 ? (
-			<a href={link.href} target="_blank" rel="noopener noreferrer">
-				<span class="sr-only">{link.label}</span>
-				{link.icon ? <Icon name={link.icon} size={iconSize} /> : <span>{link.label}</span>}
-			</a>
-		) : (
-			<span class="social-placeholder" aria-hidden="true" title="Configure social links in src/site.config.ts">
-				{link.icon ? <Icon name={link.icon} size={iconSize} /> : <span>{link.label}</span>}
-			</span>
-		)
-	))
+  resolvedLinks.map((link) =>
+    links.length > 0 ? (
+      <a href={link.href} target="_blank" rel="noopener noreferrer">
+        <span class="sr-only">{link.label}</span>
+        {link.icon ? <Icon name={link.icon} size={iconSize} /> : <span>{link.label}</span>}
+      </a>
+    ) : (
+      <span class="social-placeholder" aria-hidden="true">
+        {link.icon ? <Icon name={link.icon} size={iconSize} /> : <span>{link.label}</span>}
+      </span>
+    )
+  )
 }
 
 <style>
-	.social-placeholder {
-		display: inline-flex;
-		align-items: center;
-		justify-content: center;
-		opacity: 0.45;
-		filter: saturate(0.7);
-		cursor: default;
-	}
+  .social-placeholder {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    opacity: 0.45;
+    filter: saturate(0.7);
+    cursor: default;
+  }
 </style>

package/src/components/shared/ThemeFrame.astro

@@ -7,79 +7,80 @@ import { getMessages } from '@anglefeint/site-i18n/messages';
 import type { ImageMetadata } from 'astro';
 
 interface Props {
-	locale?: Locale;
-	title: string;
-	description: string;
-	image?: ImageMetadata;
-	pageType?: 'website' | 'article';
-	publishedTime?: Date;
-	modifiedTime?: Date;
-	author?: string;
-	tags?: string[];
-	schema?: Record<string, unknown> | Record<string, unknown>[];
-	noindex?: boolean;
-	bodyClass: string;
-	mainClass?: string;
-	scanlines?: boolean;
-	localeHrefs?: Partial<Record<Locale, string>>;
+  locale?: Locale;
+  title: string;
+  description: string;
+  image?: ImageMetadata;
+  pageType?: 'website' | 'article';
+  publishedTime?: Date;
+  modifiedTime?: Date;
+  author?: string;
+  tags?: string[];
+  schema?: Record<string, unknown> | Record<string, unknown>[];
+  noindex?: boolean;
+  bodyClass: string;
+  mainClass?: string;
+  scanlines?: boolean;
+  localeHrefs?: Partial<Record<Locale, string>>;
 }
 
 const rawLocale = Astro.props.locale ?? DEFAULT_LOCALE;
 const locale: Locale = isLocale(rawLocale) ? rawLocale : DEFAULT_LOCALE;
 const {
-	title,
-	description,
-	image,
-	pageType,
-	publishedTime,
-	modifiedTime,
-	author,
-	tags,
-	schema,
-	noindex,
-	bodyClass,
-	mainClass = 'page-main',
-	scanlines = false,
-	localeHrefs,
+  title,
+  description,
+  image,
+  pageType,
+  publishedTime,
+  modifiedTime,
+  author,
+  tags,
+  schema,
+  noindex,
+  bodyClass,
+  mainClass = 'page-main',
+  scanlines = false,
+  localeHrefs,
 } = Astro.props as Props;
 const messages = getMessages(locale);
 ---
 
 <!doctype html>
 <html lang={locale}>
-	<head>
-		<BaseHead
-			title={title}
-			description={description}
-			image={image}
-			pageType={pageType}
-			publishedTime={publishedTime}
-			modifiedTime={modifiedTime}
-			author={author}
-			tags={tags}
-			schema={schema}
-			noindex={noindex}
-		/>
-		<slot name="head" />
-	</head>
-	<body class={bodyClass}>
-		<slot name="body-start" />
-		<CommonHeader
-			locale={locale}
-			localeHrefs={localeHrefs}
-			scanlines={scanlines}
-			labels={{
-				home: messages.nav.home,
-				blog: messages.nav.blog,
-				about: messages.nav.about,
-				status: messages.nav.status,
-				language: messages.langLabel,
-			}}
-		/>
-		<main class={mainClass}>
-			<slot />
-		</main>
-		<CommonFooter scanlines={scanlines} />
-		<slot name="body-end" />
-	</body>
+  <head>
+    <BaseHead
+      title={title}
+      description={description}
+      image={image}
+      pageType={pageType}
+      publishedTime={publishedTime}
+      modifiedTime={modifiedTime}
+      author={author}
+      tags={tags}
+      schema={schema}
+      noindex={noindex}
+    />
+    <slot name="head" />
+  </head>
+  <body class={bodyClass}>
+    <slot name="body-start" />
+    <CommonHeader
+      locale={locale}
+      localeHrefs={localeHrefs}
+      scanlines={scanlines}
+      labels={{
+        home: messages.nav.home,
+        blog: messages.nav.blog,
+        about: messages.nav.about,
+        status: messages.nav.status,
+        statusAria: messages.nav.statusAria,
+        language: messages.langLabel,
+      }}
+    />
+    <main class={mainClass}>
+      <slot />
+    </main>
+    <CommonFooter scanlines={scanlines} />
+    <slot name="body-end" />
+  </body>
 </html>

package/src/config/theme.ts

@@ -35,6 +35,8 @@ export const THEME = {
     CATEGORY: '',
     CATEGORY_ID: '',
     MAPPING: 'pathname',
+    TERM: '',
+    NUMBER: '',
     STRICT: '0',
     REACTIONS_ENABLED: '1',
     EMIT_METADATA: '0',

package/src/i18n/messages.ts

@@ -9,6 +9,7 @@ export type Messages = {
     blog: string;
     about: string;
     status: string;
+    statusAria: string;
   };
   home: {
     hero: string;
@@ -41,10 +42,27 @@ export type Messages = {
     related: string;
     comments: string;
     responseOutput: string;
+    rqBadge: string;
+    rqReplayAria: string;
+    metaPublished: string;
+    metaUpdated: string;
+    metaReadMinutes: string;
+    systemStatusAria: string;
+    systemModelLabel: string;
+    systemModeLabel: string;
+    systemStateLabel: string;
+    promptContextLabel: string;
+    latencyLabel: string;
+    confidenceLabel: string;
+    statsWords: string;
+    statsTokens: string;
     heroMonitor: string;
     heroSignalSync: string;
     heroModelOnline: string;
     regenerate: string;
+    relatedAria: string;
+    backToBlogAria: string;
+    paginationAria: string;
     toastP10: string;
     toastP30: string;
     toastP60: string;
@@ -57,7 +75,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
     siteTitle: 'Angle Feint',
     siteDescription: 'Cinematic web interfaces and AI-era engineering essays.',
     langLabel: 'Language',
-    nav: { home: 'Home', blog: 'Blog', about: 'About', status: 'system: online' },
+    nav: {
+      home: 'Home',
+      blog: 'Blog',
+      about: 'About',
+      status: 'system: online',
+      statusAria: 'System status',
+    },
     home: {
       hero: 'Write a short introduction for your site and what readers can expect from your posts.',
       latest: 'Latest Posts',
@@ -89,10 +113,27 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       related: 'Related',
       comments: 'Comments',
       responseOutput: 'Output',
+      rqBadge: 'monitor feed',
+      rqReplayAria: 'Replay monitor feed',
+      metaPublished: 'published',
+      metaUpdated: 'updated',
+      metaReadMinutes: 'min read',
+      systemStatusAria: 'Model status',
+      systemModelLabel: 'model',
+      systemModeLabel: 'mode',
+      systemStateLabel: 'state',
+      promptContextLabel: 'Context',
+      latencyLabel: 'latency est',
+      confidenceLabel: 'confidence',
+      statsWords: 'words',
+      statsTokens: 'tokens',
       heroMonitor: 'neural monitor',
       heroSignalSync: 'signal sync active',
       heroModelOnline: 'model online',
       regenerate: 'Regenerate',
+      relatedAria: 'Related posts',
+      backToBlogAria: 'Back to blog',
+      paginationAria: 'Pagination',
       toastP10: 'context parsed 10%',
       toastP30: 'context parsed 30%',
       toastP60: 'inference stable 60%',
@@ -103,7 +144,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
     siteTitle: 'Angle Feint',
     siteDescription: '映画的なWebインターフェースとAI時代のエンジニアリング考察。',
     langLabel: '言語',
-    nav: { home: 'ホーム', blog: 'ブログ', about: 'プロフィール', status: 'system: online' },
+    nav: {
+      home: 'ホーム',
+      blog: 'ブログ',
+      about: 'プロフィール',
+      status: 'system: online',
+      statusAria: 'システム状態',
+    },
     home: {
       hero: 'このサイトの紹介文と、読者がどんな記事を期待できるかを書いてください。',
       latest: '最新記事',
@@ -135,10 +182,27 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       related: '関連記事',
       comments: 'コメント',
       responseOutput: '出力',
+      rqBadge: 'モニターフィード',
+      rqReplayAria: 'モニターフィードを再生',
+      metaPublished: '公開',
+      metaUpdated: '更新',
+      metaReadMinutes: '分で読了',
+      systemStatusAria: 'モデル状態',
+      systemModelLabel: 'モデル',
+      systemModeLabel: 'モード',
+      systemStateLabel: '状態',
+      promptContextLabel: 'コンテキスト',
+      latencyLabel: '推定レイテンシ',
+      confidenceLabel: '信頼度',
+      statsWords: '語',
+      statsTokens: 'トークン',
       heroMonitor: 'ニューラルモニター',
       heroSignalSync: 'シグナル同期中',
       heroModelOnline: 'モデルオンライン',
       regenerate: '再生成',
+      relatedAria: '関連記事',
+      backToBlogAria: 'ブログへ戻る',
+      paginationAria: 'ページネーション',
       toastP10: '文脈解析 10%',
       toastP30: '文脈解析 30%',
       toastP60: '推論安定 60%',
@@ -149,7 +213,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
     siteTitle: 'Angle Feint',
     siteDescription: '시네마틱 웹 인터페이스와 AI 시대 엔지니어링 에세이.',
     langLabel: '언어',
-    nav: { home: '홈', blog: '블로그', about: '소개', status: 'system: online' },
+    nav: {
+      home: '홈',
+      blog: '블로그',
+      about: '소개',
+      status: 'system: online',
+      statusAria: '시스템 상태',
+    },
     home: {
       hero: '사이트 소개와 방문자가 어떤 글을 기대할 수 있는지 간단히 작성하세요.',
       latest: '최신 글',
@@ -181,10 +251,27 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       related: '관련 글',
       comments: '댓글',
       responseOutput: '출력',
+      rqBadge: '모니터 피드',
+      rqReplayAria: '모니터 피드 다시 재생',
+      metaPublished: '게시',
+      metaUpdated: '수정',
+      metaReadMinutes: '분 읽기',
+      systemStatusAria: '모델 상태',
+      systemModelLabel: '모델',
+      systemModeLabel: '모드',
+      systemStateLabel: '상태',
+      promptContextLabel: '컨텍스트',
+      latencyLabel: '지연 추정',
+      confidenceLabel: '신뢰도',
+      statsWords: '단어',
+      statsTokens: '토큰',
       heroMonitor: '뉴럴 모니터',
       heroSignalSync: '신호 동기화 활성',
       heroModelOnline: '모델 온라인',
       regenerate: '재생성',
+      relatedAria: '관련 글',
+      backToBlogAria: '블로그로 돌아가기',
+      paginationAria: '페이지네이션',
       toastP10: '컨텍스트 파싱 10%',
       toastP30: '컨텍스트 파싱 30%',
       toastP60: '추론 안정화 60%',
@@ -195,7 +282,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
     siteTitle: 'Angle Feint',
     siteDescription: 'Interfaces web cinematográficas y ensayos de ingeniería en la era de IA.',
     langLabel: 'Idioma',
-    nav: { home: 'Inicio', blog: 'Blog', about: 'Sobre mí', status: 'system: online' },
+    nav: {
+      home: 'Inicio',
+      blog: 'Blog',
+      about: 'Sobre mí',
+      status: 'system: online',
+      statusAria: 'Estado del sistema',
+    },
     home: {
       hero: 'Escribe una breve presentación del sitio y qué tipo de contenido encontrarán tus lectores.',
       latest: 'Últimas publicaciones',
@@ -228,10 +321,27 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       related: 'Relacionados',
       comments: 'Comentarios',
       responseOutput: 'Salida',
+      rqBadge: 'monitor de señal',
+      rqReplayAria: 'Reproducir monitor de señal',
+      metaPublished: 'publicado',
+      metaUpdated: 'actualizado',
+      metaReadMinutes: 'min de lectura',
+      systemStatusAria: 'Estado del modelo',
+      systemModelLabel: 'modelo',
+      systemModeLabel: 'modo',
+      systemStateLabel: 'estado',
+      promptContextLabel: 'Contexto',
+      latencyLabel: 'latencia est',
+      confidenceLabel: 'confianza',
+      statsWords: 'palabras',
+      statsTokens: 'tokens',
       heroMonitor: 'monitor neural',
       heroSignalSync: 'sincronización de señal activa',
       heroModelOnline: 'modelo en línea',
       regenerate: 'Regenerar',
+      relatedAria: 'Publicaciones relacionadas',
+      backToBlogAria: 'Volver al blog',
+      paginationAria: 'Paginación',
       toastP10: 'contexto analizado 10%',
       toastP30: 'contexto analizado 30%',
       toastP60: 'inferencia estable 60%',
@@ -242,7 +352,13 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
     siteTitle: 'Angle Feint',
     siteDescription: '电影感网页界面与 AI 时代工程实践文章。',
     langLabel: '语言',
-    nav: { home: '首页', blog: '博客', about: '关于', status: 'system: online' },
+    nav: {
+      home: '首页',
+      blog: '博客',
+      about: '关于',
+      status: 'system: online',
+      statusAria: '系统状态',
+    },
     home: {
       hero: '在这里写一段站点简介，并告诉读者你将发布什么类型的内容。',
       latest: '最新文章',
@@ -274,10 +390,27 @@ export const DEFAULT_MESSAGES: Record<Locale, Messages> = {
       related: '相关文章',
       comments: '评论',
       responseOutput: '输出',
+      rqBadge: '监视器信号',
+      rqReplayAria: '重放监视器信号',
+      metaPublished: '发布',
+      metaUpdated: '更新',
+      metaReadMinutes: '分钟阅读',
+      systemStatusAria: '模型状态',
+      systemModelLabel: '模型',
+      systemModeLabel: '模式',
+      systemStateLabel: '状态',
+      promptContextLabel: '语境',
+      latencyLabel: '延迟估计',
+      confidenceLabel: '置信度',
+      statsWords: '词',
+      statsTokens: '令牌',
       heroMonitor: '神经监视器',
       heroSignalSync: '信号同步中',
       heroModelOnline: '模型在线',
       regenerate: '重新生成',
+      relatedAria: '相关文章',
+      backToBlogAria: '返回博客',
+      paginationAria: '分页导航',
       toastP10: '语境解析 10%',
       toastP30: '语境解析 30%',
       toastP60: '推理稳定 60%',

package/src/layouts/BlogPost.astro

@@ -58,8 +58,24 @@ const hasStats = aiModel || wordCount !== undefined || tokenCount !== undefined;
 const confidenceText = aiConfidence !== undefined ? aiConfidence.toFixed(2) : undefined;
 const enableRedQueen = THEME.EFFECTS.ENABLE_RED_QUEEN;
 const comments = THEME.COMMENTS;
+const normalizedCommentTerm = comments.TERM.trim();
+const normalizedCommentNumber = comments.NUMBER.trim();
+const hasValidCommentNumber =
+  /^[1-9]\d*$/.test(normalizedCommentNumber) &&
+  Number.isSafeInteger(Number(normalizedCommentNumber));
+const hasMappingParam =
+  comments.MAPPING === 'specific'
+    ? Boolean(normalizedCommentTerm)
+    : comments.MAPPING === 'number'
+      ? hasValidCommentNumber
+      : true;
 const hasCommentsConfig = Boolean(
-  comments.ENABLED && comments.REPO && comments.REPO_ID && comments.CATEGORY && comments.CATEGORY_ID
+  comments.ENABLED &&
+  comments.REPO &&
+  comments.REPO_ID &&
+  comments.CATEGORY &&
+  comments.CATEGORY_ID &&
+  hasMappingParam
 );
 ---
 
@@ -105,13 +121,13 @@ const hasCommentsConfig = Boolean(
             data-rq-src2={themeRedqueen2.src}
           />
           <div class="rq-tv-badge">
-            monitor feed
+            {messages.blog.rqBadge}
             <span class="rq-tv-dot" />
           </div>
           <button
             type="button"
             class="rq-tv-toggle"
-            aria-label="Replay monitor feed"
+            aria-label={messages.blog.rqReplayAria}
             aria-expanded="false"
           >
             ▶
@@ -178,23 +194,51 @@ const hasCommentsConfig = Boolean(
     <div class="prose">
       <div class="title ai-title">
         <div class="ai-meta-terminal">
-          $ published {fmt(pubDate)}
-          {updatedDate && <> | updated {fmt(updatedDate)}</>}
-          {readMinutes !== undefined && <> | ~{readMinutes} min read</>}
+          $ {messages.blog.metaPublished}
+          {fmt(pubDate)}
+          {
+            updatedDate && (
+              <>
+                {' '}
+                | {messages.blog.metaUpdated} {fmt(updatedDate)}
+              </>
+            )
+          }
+          {
+            readMinutes !== undefined && (
+              <>
+                {' '}
+                | ~{readMinutes} {messages.blog.metaReadMinutes}
+              </>
+            )
+          }
         </div>
         {
           hasSystemMeta && (
-            <div class="ai-system-row" aria-label="Model status">
-              {aiModel && <span class="ai-system-chip">model: {aiModel}</span>}
-              {aiMode && <span class="ai-system-chip">mode: {aiMode}</span>}
-              {aiState && <span class="ai-system-chip">state: {aiState}</span>}
+            <div class="ai-system-row" aria-label={messages.blog.systemStatusAria}>
+              {aiModel && (
+                <span class="ai-system-chip">
+                  {messages.blog.systemModelLabel}: {aiModel}
+                </span>
+              )}
+              {aiMode && (
+                <span class="ai-system-chip">
+                  {messages.blog.systemModeLabel}: {aiMode}
+                </span>
+              )}
+              {aiState && (
+                <span class="ai-system-chip">
+                  {messages.blog.systemStateLabel}: {aiState}
+                </span>
+              )}
             </div>
           )
         }
         {
           contextText && (
             <div class="ai-prompt-line">
-              Context: <span class="ai-prompt-topic">{contextText}</span> →
+              {messages.blog.promptContextLabel}: <span class="ai-prompt-topic">{contextText}</span>{' '}
+              →
             </div>
           )
         }
@@ -212,12 +256,12 @@ const hasCommentsConfig = Boolean(
               <div class="ai-response-meta">
                 {aiLatencyMs !== undefined && (
                   <span>
-                    latency est <strong>{aiLatencyMs}</strong> ms
+                    {messages.blog.latencyLabel} <strong>{aiLatencyMs}</strong> ms
                   </span>
                 )}
                 {confidenceText !== undefined && (
                   <span>
-                    confidence <strong>{confidenceText}</strong>
+                    {messages.blog.confidenceLabel} <strong>{confidenceText}</strong>
                   </span>
                 )}
               </div>
@@ -234,9 +278,17 @@ const hasCommentsConfig = Boolean(
           <div class="ai-stats-corner">
             {aiModel && <span class="ai-model-id">{aiModel}</span>}
             {aiModel && (wordCount !== undefined || tokenCount !== undefined) && ' · '}
-            {wordCount !== undefined && <span>{compact(wordCount)} words</span>}
+            {wordCount !== undefined && (
+              <span>
+                {compact(wordCount)} {messages.blog.statsWords}
+              </span>
+            )}
             {wordCount !== undefined && tokenCount !== undefined && ' · '}
-            {tokenCount !== undefined && <span>{compact(tokenCount)} tokens</span>}
+            {tokenCount !== undefined && (
+              <span>
+                {compact(tokenCount)} {messages.blog.statsTokens}
+              </span>
+            )}
           </div>
         )
       }
@@ -247,7 +299,7 @@ const hasCommentsConfig = Boolean(
   </article>
   {
     related.length > 0 && (
-      <section class="ai-related" aria-label="Related posts">
+      <section class="ai-related" aria-label={messages.blog.relatedAria}>
         <h2 class="ai-related-title">{messages.blog.related}</h2>
         <div class="ai-related-grid">
           {related.map((p) => (
@@ -274,7 +326,7 @@ const hasCommentsConfig = Boolean(
       </section>
     )
   }
-  <nav class="ai-back-to-blog" aria-label="Back to blog">
+  <nav class="ai-back-to-blog" aria-label={messages.blog.backToBlogAria}>
     <a href={localePath(resolvedLocale, '/blog/')}>
       <span class="ai-back-prompt">$</span>
       <span class="ai-back-text">← {messages.blog.backToBlog}</span>
@@ -290,6 +342,8 @@ const hasCommentsConfig = Boolean(
           data-category={comments.CATEGORY}
           data-category-id={comments.CATEGORY_ID}
           data-mapping={comments.MAPPING}
+          data-term={comments.MAPPING === 'specific' ? normalizedCommentTerm : undefined}
+          data-number={comments.MAPPING === 'number' ? normalizedCommentNumber : undefined}
           data-strict={comments.STRICT}
           data-reactions-enabled={comments.REACTIONS_ENABLED}
           data-emit-metadata={comments.EMIT_METADATA}

package/src/scripts/about/modals.js

@@ -25,7 +25,7 @@ export function initAboutModals(runtimeConfig, prefersReducedMotion) {
     },
     ai: {
       title: 'AI',
-      body: '<pre>~ $ ai --status --verbose\n\nmodel: anglefeint-core\nmode: reasoning + builder\ncontext window: 128k\ntools: codex / cursor / claude-code\nlatency: 120-220ms\nsafety: guardrails enabled\n\n&gt;&gt; system online\n&gt;&gt; ready for execution</pre>',
+      body: '<pre>~ $ ai --status --verbose\n\nmodel: runtime-default\nmode: standard\ncontext window: 32k\nlatency: 100-250ms\nsafety: enabled\n\n&gt;&gt; system online\n&gt;&gt; ready</pre>',
       type: 'plain',
     },
     decryptor: {