@hagicode/hagilight 0.1.2-dev.5.1.c41051d → 0.1.2-dev.7.1.c02207e

package/Analytics51LA.astro

@@ -0,0 +1,17 @@
+---
+interface Props {
+  siteId: string;
+}
+
+const { siteId } = Astro.props;
+if (!siteId?.trim()) throw new Error('Analytics51LA requires a siteId prop.');
+---
+
+{import.meta.env.PROD && (
+  <>
+    <script is:inline charset="UTF-8" id="LA_COLLECT" src="https://sdk.51.la/js-sdk-pro.min.js"></script>
+    <script is:inline define:vars={{ siteId }}>
+      LA.init({ id: siteId, ck: siteId, autoTrack: true, hashMode: true, screenRecord: true });
+    </script>
+  </>
+)}

package/GoogleAnalytics.astro

@@ -0,0 +1,21 @@
+---
+interface Props {
+  measurementId: string;
+}
+
+const { measurementId } = Astro.props;
+if (!measurementId?.trim()) throw new Error('GoogleAnalytics requires a measurementId prop.');
+const scriptUrl = `https://www.googletagmanager.com/gtag/js?id=${encodeURIComponent(measurementId)}`;
+---
+
+{import.meta.env.PROD && (
+  <>
+    <script async src={scriptUrl}></script>
+    <script is:inline define:vars={{ measurementId }}>
+      window.dataLayer = window.dataLayer || [];
+      function gtag(){dataLayer.push(arguments);}
+      gtag('js', new Date());
+      gtag('config', measurementId);
+    </script>
+  </>
+)}

package/PromotoBanner.astro

@@ -112,11 +112,15 @@ const { fallback, locale = Astro.currentLocale ?? 'en' } = Astro.props;
 
   .hagilight-promoto__title,
   .hagilight-promoto__description {
+    display: -webkit-box;
+    overflow: hidden;
     margin: 0;
     color: var(--sl-color-text-high, #111827);
     font-size: var(--sl-text-sm);
     font-weight: 600;
     line-height: 1.35;
+    -webkit-box-orient: vertical;
+    -webkit-line-clamp: 2;
   }
 
   .hagilight-promoto__description {
@@ -230,13 +234,14 @@ const { fallback, locale = Astro.currentLocale ?? 'en' } = Astro.props;
     }
 
     .hagilight-promoto__slide {
-      grid-template-columns: minmax(0, 1fr) 4rem;
-      gap: 0.7rem;
-      padding: 0.85rem 3.5rem 0.85rem 0.85rem;
+      grid-template-columns: minmax(0, 1fr) auto;
+      gap: 0.5rem;
+      padding: 0.65rem 3.25rem 0.65rem 0.75rem;
     }
 
     .hagilight-promoto__copy {
-      grid-column: 1 / -1;
+      grid-column: 1;
+      grid-row: 1 / 3;
     }
 
     .hagilight-promoto__title {
@@ -244,31 +249,50 @@ const { fallback, locale = Astro.currentLocale ?? 'en' } = Astro.props;
     }
 
     .hagilight-promoto__description {
-      display: -webkit-box;
-      overflow: hidden;
       font-size: var(--sl-text-xs);
       font-weight: 500;
-      -webkit-box-orient: vertical;
-      -webkit-line-clamp: 2;
     }
 
     .hagilight-promoto__image {
       grid-column: 2;
       grid-row: 1;
-      width: 4rem;
+      width: 3rem;
     }
 
     .hagilight-promoto__cta {
-      grid-column: 1 / -1;
-      width: 100%;
-      min-height: 2.3rem;
+      grid-column: 2;
+      grid-row: 2;
+      min-width: 4rem;
+      min-height: 1.9rem;
+      padding-inline: 0.5rem;
+      font-size: var(--sl-text-xs);
+      overflow-wrap: anywhere;
+    }
+
+    .hagilight-promoto__slide[data-has-image='false'] {
+      grid-template-rows: auto;
+    }
+
+    .hagilight-promoto__slide[data-has-image='false'] .hagilight-promoto__copy,
+    .hagilight-promoto__slide[data-has-image='false'] .hagilight-promoto__cta {
+      grid-row: 1;
+    }
+
+    .hagilight-promoto__slide[data-has-image='false'] .hagilight-promoto__cta {
+      min-width: 4.5rem;
     }
 
     .hagilight-promoto__controls {
       justify-content: flex-start;
       flex-wrap: wrap;
       gap: 0.35rem;
-      padding: 0 0.85rem 0.85rem;
+      padding: 0 0.75rem 0.6rem;
+    }
+
+    .hagilight-promoto__control {
+      min-width: 2rem;
+      min-height: 2rem;
+      padding-inline: 0.5rem;
     }
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight",
-  "version": "0.1.2-dev.5.1.c41051d",
+  "version": "0.1.2-dev.7.1.c02207e",
   "type": "module",
   "description": "Shared Astro components for HagiCode sites",
   "repository": {
@@ -14,11 +14,17 @@
   },
   "exports": {
     "./Copyright": "./Copyright.astro",
-    "./PromotoBanner": "./PromotoBanner.astro"
+    "./PromotoBanner": "./PromotoBanner.astro",
+    "./logo.png": "./logo.png",
+    "./site-links": "./site-links.ts",
+    "./GoogleAnalytics": "./GoogleAnalytics.astro",
+    "./Analytics51LA": "./Analytics51LA.astro"
   },
   "files": [
     "*.astro",
-    "*.ts"
+    "*.png",
+    "*.ts",
+    "*.json"
   ],
   "peerDependencies": {
     "astro": "^7.3.5"

package/promoto-banner.ts

@@ -216,6 +216,7 @@ export function definePromotoBannerElement(): void {
       this.cards.forEach((card, index) => {
         const slide = document.createElement('article');
         slide.className = 'hagilight-promoto__slide';
+        slide.dataset.hasImage = String(Boolean(card.image));
         slide.setAttribute('aria-hidden', index === this.currentIndex ? 'false' : 'true');
         if (index !== this.currentIndex) slide.setAttribute('inert', '');
 

package/related-sites.json

@@ -0,0 +1,226 @@
+[
+  {
+    "id": "hagicode-main",
+    "name": {
+      "zh-CN": "HagiCode 主站",
+      "zh-Hant": "HagiCode 主站",
+      "en-US": "HagiCode Main Site",
+      "ja-JP": "HagiCode 公式サイト",
+      "ko-KR": "HagiCode 메인 사이트",
+      "de-DE": "HagiCode Hauptseite",
+      "fr-FR": "Site principal HagiCode",
+      "es-ES": "Sitio principal de HagiCode",
+      "pt-BR": "Site principal da HagiCode",
+      "ru-RU": "Главный сайт HagiCode"
+    },
+    "description": {
+      "zh-CN": "产品入口",
+      "zh-Hant": "產品入口",
+      "en-US": "Primary product entry.",
+      "ja-JP": "製品全体の入口です。",
+      "ko-KR": "제품으로 들어가는 기본 진입점입니다.",
+      "de-DE": "Zentraler Einstieg zum Produkt.",
+      "fr-FR": "Point d'entrée principal du produit.",
+      "es-ES": "Entrada principal al producto.",
+      "pt-BR": "Entrada principal do produto.",
+      "ru-RU": "Основной вход в продукт."
+    },
+    "url": "https://www.hagicode.com/"
+  },
+  {
+    "id": "newbe-blog",
+    "name": {
+      "zh-CN": "newbe",
+      "zh-Hant": "newbe",
+      "en-US": "newbe",
+      "ja-JP": "newbe",
+      "ko-KR": "newbe",
+      "de-DE": "newbe",
+      "fr-FR": "newbe",
+      "es-ES": "newbe",
+      "pt-BR": "newbe",
+      "ru-RU": "newbe"
+    },
+    "description": {
+      "zh-CN": "作者博客",
+      "zh-Hant": "作者部落格",
+      "en-US": "Author blog.",
+      "ja-JP": "作者ブログです。",
+      "ko-KR": "작성자 블로그입니다.",
+      "de-DE": "Blog des Autors.",
+      "fr-FR": "Blog de l'auteur.",
+      "es-ES": "Blog del autor.",
+      "pt-BR": "Blog do autor.",
+      "ru-RU": "Блог автора."
+    },
+    "url": "https://newbe.hagicode.com/"
+  },
+  {
+    "id": "index-data",
+    "name": {
+      "zh-CN": "Index Data Mirror",
+      "zh-Hant": "Index Data Mirror",
+      "en-US": "Index Data Mirror",
+      "ja-JP": "Index Data Mirror",
+      "ko-KR": "Index Data Mirror",
+      "de-DE": "Index Data Mirror",
+      "fr-FR": "Index Data Mirror",
+      "es-ES": "Index Data Mirror",
+      "pt-BR": "Index Data Mirror",
+      "ru-RU": "Index Data Mirror"
+    },
+    "description": {
+      "zh-CN": "公开数据",
+      "zh-Hant": "公開資料",
+      "en-US": "Public data mirror.",
+      "ja-JP": "公開データミラーです。",
+      "ko-KR": "공개 데이터 미러입니다.",
+      "de-DE": "Öffentlicher Daten-Spiegel.",
+      "fr-FR": "Miroir de données public.",
+      "es-ES": "Espejo de datos público.",
+      "pt-BR": "Espelho público de dados.",
+      "ru-RU": "Публичное зеркало данных."
+    },
+    "url": "https://index.hagicode.com/data/"
+  },
+  {
+    "id": "compose-builder",
+    "name": {
+      "zh-CN": "Docker Compose Builder",
+      "zh-Hant": "Docker Compose Builder",
+      "en-US": "Docker Compose Builder",
+      "ja-JP": "Docker Compose Builder",
+      "ko-KR": "Docker Compose Builder",
+      "de-DE": "Docker Compose Builder",
+      "fr-FR": "Docker Compose Builder",
+      "es-ES": "Docker Compose Builder",
+      "pt-BR": "Docker Compose Builder",
+      "ru-RU": "Docker Compose Builder"
+    },
+    "description": {
+      "zh-CN": "Docker 部署 Hagicode",
+      "zh-Hant": "使用 Docker 部署 Hagicode",
+      "en-US": "Deploy HagiCode with Docker.",
+      "ja-JP": "Docker で HagiCode をデプロイします。",
+      "ko-KR": "Docker로 HagiCode를 배포합니다.",
+      "de-DE": "HagiCode mit Docker bereitstellen.",
+      "fr-FR": "Déployer HagiCode avec Docker.",
+      "es-ES": "Despliega HagiCode con Docker.",
+      "pt-BR": "Implante a HagiCode com Docker.",
+      "ru-RU": "Развёртывание HagiCode через Docker."
+    },
+    "url": "https://builder.hagicode.com/"
+  },
+  {
+    "id": "status-page",
+    "name": {
+      "zh-CN": "HagiCode Status",
+      "zh-Hant": "HagiCode Status",
+      "en-US": "HagiCode Status",
+      "ja-JP": "HagiCode Status",
+      "ko-KR": "HagiCode Status",
+      "de-DE": "HagiCode Status",
+      "fr-FR": "HagiCode Status",
+      "es-ES": "HagiCode Status",
+      "pt-BR": "HagiCode Status",
+      "ru-RU": "HagiCode Status"
+    },
+    "description": {
+      "zh-CN": "服务状态",
+      "zh-Hant": "服務狀態",
+      "en-US": "Service status.",
+      "ja-JP": "サービス状態の確認ページです。",
+      "ko-KR": "서비스 상태를 확인하는 페이지입니다.",
+      "de-DE": "Dienststatus.",
+      "fr-FR": "État des services.",
+      "es-ES": "Estado del servicio.",
+      "pt-BR": "Status do serviço.",
+      "ru-RU": "Статус сервисов."
+    },
+    "url": "https://status.hagicode.com/"
+  },
+  {
+    "id": "awesome-design-gallery",
+    "name": {
+      "zh-CN": "Awesome Design MD",
+      "zh-Hant": "Awesome Design MD",
+      "en-US": "Awesome Design MD",
+      "ja-JP": "Awesome Design MD",
+      "ko-KR": "Awesome Design MD",
+      "de-DE": "Awesome Design MD",
+      "fr-FR": "Awesome Design MD",
+      "es-ES": "Awesome Design MD",
+      "pt-BR": "Awesome Design MD",
+      "ru-RU": "Awesome Design MD"
+    },
+    "description": {
+      "zh-CN": "超酷的AI Web 设计",
+      "zh-Hant": "超酷的 AI Web 設計",
+      "en-US": "A gallery of standout AI web design work.",
+      "ja-JP": "印象的な AI Web デザインを集めたギャラリーです。",
+      "ko-KR": "인상적인 AI 웹 디자인을 모아 둔 갤러리입니다.",
+      "de-DE": "Galerie mit markanten AI-Webdesigns.",
+      "fr-FR": "Galerie de designs web IA remarquables.",
+      "es-ES": "Galería de diseños web de IA destacados.",
+      "pt-BR": "Galeria com designs web de IA de destaque.",
+      "ru-RU": "Галерея выразительных AI web-дизайнов."
+    },
+    "url": "https://design.hagicode.com/"
+  },
+  {
+    "id": "soul-builder",
+    "name": {
+      "zh-CN": "Soul Builder",
+      "zh-Hant": "Soul Builder",
+      "en-US": "Soul Builder",
+      "ja-JP": "Soul Builder",
+      "ko-KR": "Soul Builder",
+      "de-DE": "Soul Builder",
+      "fr-FR": "Soul Builder",
+      "es-ES": "Soul Builder",
+      "pt-BR": "Soul Builder",
+      "ru-RU": "Soul Builder"
+    },
+    "description": {
+      "zh-CN": "Agent之魂",
+      "zh-Hant": "Agent 之魂",
+      "en-US": "Define the soul of an agent.",
+      "ja-JP": "Agent の魂を形にする体験です。",
+      "ko-KR": "에이전트의 영혼을 설계하는 경험입니다.",
+      "de-DE": "Forme die Seele eines Agenten.",
+      "fr-FR": "Façonnez l'âme d'un agent.",
+      "es-ES": "Define el alma de un agente.",
+      "pt-BR": "Defina a alma de um agente.",
+      "ru-RU": "Определите душу агента."
+    },
+    "url": "https://soul.hagicode.com/"
+  },
+  {
+    "id": "trait-builder",
+    "name": {
+      "zh-CN": "Trait Builder",
+      "zh-Hant": "Trait Builder",
+      "en-US": "Trait Builder",
+      "ja-JP": "Trait Builder",
+      "ko-KR": "Trait Builder",
+      "de-DE": "Trait Builder",
+      "fr-FR": "Trait Builder",
+      "es-ES": "Trait Builder",
+      "pt-BR": "Trait Builder",
+      "ru-RU": "Trait Builder"
+    },
+    "description": {
+      "zh-CN": "Agent之能",
+      "zh-Hant": "Agent 之能",
+      "en-US": "Shape what an agent can do.",
+      "ja-JP": "Agent の能力を組み立てる体験です。",
+      "ko-KR": "에이전트의 능력을 설계하는 경험입니다.",
+      "de-DE": "Definiere, was ein Agent kann.",
+      "fr-FR": "Définissez ce qu'un agent peut faire.",
+      "es-ES": "Define lo que un agente puede hacer.",
+      "pt-BR": "Defina o que um agente pode fazer.",
+      "ru-RU": "Соберите способности агента."
+    },
+    "url": "https://trait.hagicode.com/"
+  }
+]

package/site-links.ts

@@ -0,0 +1,400 @@
+import docsRelatedSites from './related-sites.json' with { type: 'json' };
+
+export type SiteLinkKey =
+  | 'home'
+  | 'blog'
+  | 'support'
+  | 'downloadClient'
+  | 'about'
+  | 'dockerCompose'
+  | 'productDocs'
+  | 'blogPosts'
+  | 'rss'
+  | 'costCalculator'
+  | 'github'
+  | 'discord'
+  | 'issueFeedback'
+  | 'contactEmail'
+  | 'qqGroup'
+  | 'steam'
+  | 'icpFiling'
+  | 'publicSecurityFiling';
+
+export type LinkGroup = 'header' | 'quick' | 'community' | 'filings';
+type LocalizedText = string | Readonly<Record<string, string>>;
+
+export interface SiteLink {
+  id: SiteLinkKey | string;
+  label: string;
+  href: string;
+  ariaLabel?: string;
+  target?: '_blank';
+  rel?: 'noopener noreferrer';
+}
+
+export interface SiteLinkOverride {
+  href?: LocalizedText;
+  label?: LocalizedText;
+  external?: boolean;
+}
+
+export interface ExtraSiteLink extends SiteLinkOverride {
+  href: LocalizedText;
+  label: LocalizedText;
+}
+
+export interface RelatedSite {
+  id: string;
+  name: LocalizedText;
+  url: string;
+  description?: LocalizedText;
+}
+
+export interface SiteLinksOptions {
+  overrides?: Partial<Record<SiteLinkKey, SiteLinkOverride>>;
+  extraLinks?: Partial<Record<LinkGroup, readonly ExtraSiteLink[]>>;
+  relatedSites?: readonly RelatedSite[];
+  siteId?: string;
+  siteUrl?: string;
+}
+
+interface LinkDefinition {
+  label: LocalizedText;
+  href: string | ((locale: string) => string);
+  external?: boolean;
+  ariaLabel?: LocalizedText;
+}
+
+const translations = {
+  home: {
+    'zh-CN': '首页', 'zh-Hant': '首頁', 'en-US': 'Home', 'ja-JP': 'ホーム',
+    'ko-KR': '홈', 'de-DE': 'Startseite', 'fr-FR': 'Accueil', 'es-ES': 'Inicio',
+    'pt-BR': 'Início', 'ru-RU': 'Главная',
+  },
+  blog: {
+    'zh-CN': '博客', 'zh-Hant': '部落格', 'en-US': 'Blog', 'ja-JP': 'ブログ',
+    'ko-KR': '블로그', 'de-DE': 'Blog', 'fr-FR': 'Blog', 'es-ES': 'Blog',
+    'pt-BR': 'Blog', 'ru-RU': 'Блог',
+  },
+  support: {
+    'zh-CN': '获取技术支持', 'zh-Hant': '獲取技術支援', 'en-US': 'Get Support',
+    'ja-JP': 'サポート', 'ko-KR': '기술 지원', 'de-DE': 'Support',
+    'fr-FR': 'Assistance', 'es-ES': 'Soporte', 'pt-BR': 'Suporte', 'ru-RU': 'Поддержка',
+  },
+  downloadClient: {
+    'zh-CN': '下载客户端', 'zh-Hant': '下載客戶端', 'en-US': 'Download Client',
+    'ja-JP': 'クライアントをダウンロード', 'ko-KR': '클라이언트 다운로드',
+    'de-DE': 'Client herunterladen', 'fr-FR': 'Télécharger le client',
+    'es-ES': 'Descargar cliente', 'pt-BR': 'Baixar cliente', 'ru-RU': 'Скачать клиент',
+  },
+  about: {
+    'zh-CN': '关于 HagiCode', 'zh-Hant': '關於 HagiCode', 'en-US': 'About HagiCode',
+    'ja-JP': 'HagiCode について', 'ko-KR': 'HagiCode 소개', 'de-DE': 'Über HagiCode',
+    'fr-FR': 'À propos de HagiCode', 'es-ES': 'Acerca de HagiCode',
+    'pt-BR': 'Sobre a HagiCode', 'ru-RU': 'О HagiCode',
+  },
+  dockerCompose: {
+    'zh-CN': 'Docker Compose 安装', 'zh-Hant': 'Docker Compose 安裝',
+    'en-US': 'Docker Compose Installation', 'ja-JP': 'Docker Compose インストール',
+    'ko-KR': 'Docker Compose 설치', 'de-DE': 'Docker-Compose-Installation',
+    'fr-FR': 'Installation de Docker Compose', 'es-ES': 'Instalación de Docker Compose',
+    'pt-BR': 'Instalação do Docker Compose', 'ru-RU': 'Установка Docker Compose',
+  },
+  productDocs: {
+    'zh-CN': '产品文档', 'zh-Hant': '產品文件', 'en-US': 'Product Docs',
+    'ja-JP': '製品ドキュメント', 'ko-KR': '제품 문서', 'de-DE': 'Produktdokumentation',
+    'fr-FR': 'Documentation produit', 'es-ES': 'Documentación del producto',
+    'pt-BR': 'Documentação do produto', 'ru-RU': 'Документация продукта',
+  },
+  blogPosts: {
+    'zh-CN': '博客文章', 'zh-Hant': '部落格文章', 'en-US': 'Blog Posts',
+    'ja-JP': 'ブログ記事', 'ko-KR': '블로그 글', 'de-DE': 'Blogbeiträge',
+    'fr-FR': 'Articles du blog', 'es-ES': 'Artículos del blog',
+    'pt-BR': 'Posts do blog', 'ru-RU': 'Статьи блога',
+  },
+  rss: {
+    'zh-CN': 'RSS 订阅', 'zh-Hant': 'RSS 訂閱', 'en-US': 'RSS Feed',
+    'ja-JP': 'RSS 配信', 'ko-KR': 'RSS 구독', 'de-DE': 'RSS-Feed',
+    'fr-FR': 'Flux RSS', 'es-ES': 'RSS', 'pt-BR': 'Feed RSS', 'ru-RU': 'RSS-лента',
+  },
+  costCalculator: {
+    'zh-CN': '算一算，AI会不会淘汰我', 'zh-Hant': '算一算，AI 會不會淘汰我',
+    'en-US': 'Will AI Replace Me?', 'ja-JP': 'AI に置き換えられるか診断',
+    'ko-KR': 'AI가 나를 대체할까?', 'de-DE': 'Wird KI mich ersetzen?',
+    'fr-FR': "L'IA va-t-elle me remplacer ?", 'es-ES': 'Me reemplazará la IA?',
+    'pt-BR': 'A IA vai me substituir?', 'ru-RU': 'Заменит ли меня ИИ?',
+  },
+  github: {
+    'zh-CN': 'GitHub', 'zh-Hant': 'GitHub', 'en-US': 'GitHub', 'ja-JP': 'GitHub',
+    'ko-KR': 'GitHub', 'de-DE': 'GitHub', 'fr-FR': 'GitHub', 'es-ES': 'GitHub',
+    'pt-BR': 'GitHub', 'ru-RU': 'GitHub',
+  },
+  discord: {
+    'zh-CN': 'Discord', 'zh-Hant': 'Discord', 'en-US': 'Discord', 'ja-JP': 'Discord',
+    'ko-KR': 'Discord', 'de-DE': 'Discord', 'fr-FR': 'Discord', 'es-ES': 'Discord',
+    'pt-BR': 'Discord', 'ru-RU': 'Discord',
+  },
+  issueFeedback: {
+    'zh-CN': '问题反馈', 'zh-Hant': '問題回饋', 'en-US': 'Issue Feedback',
+    'ja-JP': '問題の報告', 'ko-KR': '문제 신고', 'de-DE': 'Probleme melden',
+    'fr-FR': 'Signaler un problème', 'es-ES': 'Reportar un problema',
+    'pt-BR': 'Relatar problema', 'ru-RU': 'Сообщить о проблеме',
+  },
+  contactEmail: {
+    'zh-CN': '联系邮箱', 'zh-Hant': '聯絡信箱', 'en-US': 'Contact Email',
+    'ja-JP': '連絡先メール', 'ko-KR': '문의 이메일', 'de-DE': 'Kontakt-E-Mail',
+    'fr-FR': 'E-mail de contact', 'es-ES': 'Correo de contacto',
+    'pt-BR': 'E-mail de contato', 'ru-RU': 'Контактный email',
+  },
+  qqGroup: {
+    'zh-CN': 'QQ 群 610394020', 'zh-Hant': 'QQ 群 610394020',
+    'en-US': 'QQ Group 610394020', 'ja-JP': 'QQ グループ 610394020',
+    'ko-KR': 'QQ 그룹 610394020', 'de-DE': 'QQ-Gruppe 610394020',
+    'fr-FR': 'Groupe QQ 610394020', 'es-ES': 'Grupo QQ 610394020',
+    'pt-BR': 'Grupo QQ 610394020', 'ru-RU': 'Группа QQ 610394020',
+  },
+  steam: {
+    'zh-CN': 'Steam', 'zh-Hant': 'Steam', 'en-US': 'Steam', 'ja-JP': 'Steam',
+    'ko-KR': 'Steam', 'de-DE': 'Steam', 'fr-FR': 'Steam', 'es-ES': 'Steam',
+    'pt-BR': 'Steam', 'ru-RU': 'Steam',
+  },
+  icpFiling: '闽ICP备2026004153号-1',
+  publicSecurityFiling: '闽公网安备35011102351148号',
+} satisfies Record<SiteLinkKey, LocalizedText>;
+
+const defaultLinks: Record<SiteLinkKey, LinkDefinition> = {
+  home: { label: translations.home, href: (locale) => marketingPath(locale, '/') },
+  blog: { label: translations.blog, href: (locale) => docsPath(locale, '/blog/') },
+  support: { label: translations.support, href: (locale) => marketingPath(locale, '/about/') },
+  downloadClient: { label: translations.downloadClient, href: (locale) => marketingPath(locale, '/desktop/') },
+  about: { label: translations.about, href: (locale) => marketingPath(locale, '/about/') },
+  dockerCompose: { label: translations.dockerCompose, href: (locale) => docsPath(locale, '/installation/docker-compose/') },
+  productDocs: { label: translations.productDocs, href: (locale) => docsPath(locale, '/product-overview/') },
+  blogPosts: { label: translations.blogPosts, href: (locale) => docsPath(locale, '/blog/') },
+  rss: { label: translations.rss, href: (locale) => `https://docs.hagicode.com/blog/rss.${locale}.xml` },
+  costCalculator: { label: translations.costCalculator, href: 'https://cost.hagicode.com', external: true },
+  github: { label: translations.github, href: 'https://github.com/HagiCode-org/site', external: true },
+  discord: { label: translations.discord, href: 'https://discord.gg/qY662sJK', external: true },
+  issueFeedback: { label: translations.issueFeedback, href: 'https://github.com/HagiCode-org/site/issues', external: true },
+  contactEmail: { label: translations.contactEmail, href: 'mailto:support@hagicode.com' },
+  qqGroup: { label: translations.qqGroup, href: 'https://qm.qq.com/q/Fwb0o094kw', external: true },
+  steam: { label: translations.steam, href: 'https://store.steampowered.com/app/4625540/Hagicode/', external: true },
+  icpFiling: {
+    label: translations.icpFiling,
+    href: 'https://beian.miit.gov.cn/',
+    external: true,
+    ariaLabel: {
+      'zh-CN': '查看 ICP 备案信息', 'zh-Hant': '查看 ICP 備案資訊',
+      'en-US': 'View ICP filing information', 'ja-JP': 'ICP 登録情報を表示',
+      'ko-KR': 'ICP 등록 정보 보기', 'de-DE': 'ICP-Registrierungsinformationen anzeigen',
+      'fr-FR': 'Voir les informations de dépôt ICP', 'es-ES': 'Ver la información de registro ICP',
+      'pt-BR': 'Ver informações de registro ICP', 'ru-RU': 'Показать информацию о регистрации ICP',
+    },
+  },
+  publicSecurityFiling: {
+    label: translations.publicSecurityFiling,
+    href: 'http://www.beian.gov.cn/portal/registerSystemInfo',
+    external: true,
+    ariaLabel: {
+      'zh-CN': '查看公安备案信息', 'zh-Hant': '查看公安備案資訊',
+      'en-US': 'View public security filing information', 'ja-JP': '公安登録情報を表示',
+      'ko-KR': '공안 등록 정보 보기', 'de-DE': 'Informationen zur Sicherheitsregistrierung anzeigen',
+      'fr-FR': 'Voir les informations de dépôt de sécurité publique',
+      'es-ES': 'Ver la información de registro de seguridad pública',
+      'pt-BR': 'Ver informações de registro de segurança pública',
+      'ru-RU': 'Показать информацию о регистрации в органах общественной безопасности',
+    },
+  },
+};
+
+const groups: Record<LinkGroup, readonly SiteLinkKey[]> = {
+  header: ['home', 'blog', 'support'],
+  quick: ['downloadClient', 'about', 'dockerCompose', 'productDocs', 'blogPosts', 'rss'],
+  community: ['github', 'discord', 'issueFeedback', 'contactEmail', 'qqGroup', 'costCalculator', 'steam'],
+  filings: ['icpFiling', 'publicSecurityFiling'],
+};
+
+function normalizeLocale(locale?: string | null): string {
+  const normalized = locale?.trim().replaceAll('_', '-').toLowerCase();
+  if (normalized === 'zh' || normalized === 'zh-cn' || normalized === 'zh-hans' || normalized === 'root') {
+    return 'zh-CN';
+  }
+  if (normalized === 'zh-hant' || normalized === 'zh-tw' || normalized === 'zh-hk') {
+    return 'zh-Hant';
+  }
+  if (normalized === 'en' || normalized === 'en-us' || !normalized) {
+    return 'en-US';
+  }
+  const canonical = ['ja-JP', 'ko-KR', 'de-DE', 'fr-FR', 'es-ES', 'pt-BR', 'ru-RU']
+    .find((candidate) => candidate.toLowerCase() === normalized);
+  if (canonical) return canonical;
+  return 'en-US';
+}
+
+function docsPath(locale: string, pathname: string): string {
+  const routePrefix = locale === 'zh-CN' ? '' : `/${locale}`;
+  return `https://docs.hagicode.com${routePrefix}${pathname}`;
+}
+
+function marketingPath(locale: string, pathname: string): string {
+  return `https://www.hagicode.com/${locale}${pathname}`;
+}
+
+function resolveLocalized(value: LocalizedText, locale: string, fallback: string): string {
+  if (typeof value === 'string') return value;
+  for (const candidate of [locale, ...(locale === 'zh-Hant' ? ['zh-CN', 'en-US'] : ['en-US'])]) {
+    const text = value[candidate];
+    if (typeof text === 'string' && text.trim()) return text;
+  }
+  const firstValue = Object.values(value).find((text) => typeof text === 'string' && text.trim());
+  return firstValue ?? fallback;
+}
+
+function normalizeUrl(value: string): string {
+  const input = value.trim();
+  if (!input) throw new TypeError('Link destinations must not be empty.');
+  const url = new URL(input, 'https://hagilight.invalid');
+  if (!['http:', 'https:', 'mailto:', 'tel:'].includes(url.protocol)) {
+    throw new TypeError(`Unsupported link protocol: ${url.protocol}`);
+  }
+  url.hash = '';
+  url.search = '';
+  url.pathname = url.pathname.replace(/\/+$/u, '') || '/';
+  return url.origin === 'https://hagilight.invalid' ? url.pathname : url.toString();
+}
+
+function resolveLink(
+  key: SiteLinkKey | string,
+  locale: string,
+  definition: LinkDefinition,
+  override?: SiteLinkOverride,
+): SiteLink {
+  const defaultHref = typeof definition.href === 'function' ? definition.href(locale) : definition.href;
+  const href = override?.href === undefined ? defaultHref : resolveLocalized(override.href, locale, defaultHref);
+  const label = override?.label === undefined
+    ? resolveLocalized(definition.label, locale, key)
+    : resolveLocalized(override.label, locale, resolveLocalized(definition.label, locale, key));
+  normalizeUrl(href);
+  const external = override?.external ?? definition.external ?? false;
+  return {
+    id: key,
+    label,
+    href,
+    ...(definition.ariaLabel
+      ? { ariaLabel: resolveLocalized(definition.ariaLabel, locale, label) }
+      : {}),
+    ...(external ? { target: '_blank', rel: 'noopener noreferrer' } : {}),
+  };
+}
+
+export function resolveSiteLinks(localeInput?: string | null, options: SiteLinksOptions = {}) {
+  const locale = normalizeLocale(localeInput);
+  const resolvedGroups = Object.fromEntries(
+    (Object.keys(groups) as LinkGroup[]).map((group) => {
+      const catalogLinks = groups[group].map((key) => {
+        const override = options.overrides?.[key]
+          ?? (key === 'blogPosts' ? options.overrides?.blog : undefined);
+        return resolveLink(key, locale, defaultLinks[key], override);
+      });
+      const extraLinks = (options.extraLinks?.[group] ?? []).map((entry, index) => {
+        const definition: LinkDefinition = {
+          label: entry.label,
+          href: resolveLocalized(entry.href, locale, ''),
+          external: entry.external,
+        };
+        return resolveLink(`${group}-custom-${index + 1}`, locale, definition);
+      });
+      return [group, [...catalogLinks, ...extraLinks]];
+    }),
+  ) as Record<LinkGroup, SiteLink[]>;
+
+  const renderedUrls = new Set(
+    [...resolvedGroups.quick, ...resolvedGroups.community, ...resolvedGroups.filings]
+      .map((link) => normalizeUrl(link.href)),
+  );
+  if (options.siteUrl) renderedUrls.add(normalizeUrl(options.siteUrl));
+
+  const relatedIds = new Set<string>();
+  const relatedUrls = new Set<string>();
+  const relatedSites = (options.relatedSites ?? docsRelatedSites).flatMap((site) => {
+    const href = site.id === 'hagicode-main' && !options.relatedSites
+      ? marketingPath(locale, '/')
+      : site.url;
+    const normalizedUrl = normalizeUrl(href);
+    if (site.id === options.siteId || renderedUrls.has(normalizedUrl)
+      || relatedIds.has(site.id) || relatedUrls.has(normalizedUrl)) {
+      return [];
+    }
+    relatedIds.add(site.id);
+    relatedUrls.add(normalizedUrl);
+    return [{
+      id: site.id,
+      name: resolveLocalized(site.name, locale, site.id),
+      description: site.description
+        ? resolveLocalized(site.description, locale, '')
+        : undefined,
+      href,
+      target: '_blank' as const,
+      rel: 'noopener noreferrer' as const,
+    }];
+  });
+
+  return {
+    locale,
+    labels: {
+      relatedSites: resolveLocalized({
+        'zh-CN': '生态站点', 'zh-Hant': '生態站點', 'en-US': 'Ecosystem Sites',
+        'ja-JP': 'エコシステムサイト', 'ko-KR': '에코시스템 사이트',
+        'de-DE': 'Ökosystem-Seiten', 'fr-FR': "Sites de l'écosystème",
+        'es-ES': 'Sitios del ecosistema', 'pt-BR': 'Sites do ecossistema',
+        'ru-RU': 'Сайты экосистемы',
+      }, locale, 'Ecosystem Sites'),
+      quickLinks: resolveLocalized({
+        'zh-CN': '快速链接', 'zh-Hant': '快速連結', 'en-US': 'Quick Links',
+        'ja-JP': 'クイックリンク', 'ko-KR': '빠른 링크', 'de-DE': 'Schnellzugriffe',
+        'fr-FR': 'Liens rapides', 'es-ES': 'Enlaces rápidos',
+        'pt-BR': 'Links rápidos', 'ru-RU': 'Быстрые ссылки',
+      }, locale, 'Quick Links'),
+      community: resolveLocalized({
+        'zh-CN': '社区', 'zh-Hant': '社群', 'en-US': 'Community',
+        'ja-JP': 'コミュニティ', 'ko-KR': '커뮤니티', 'de-DE': 'Community',
+        'fr-FR': 'Communauté', 'es-ES': 'Comunidad',
+        'pt-BR': 'Comunidade', 'ru-RU': 'Сообщество',
+      }, locale, 'Community'),
+      navigation: {
+        relatedSites: resolveLocalized({
+          'zh-CN': '生态站点链接', 'zh-Hant': '生態站點連結', 'en-US': 'Ecosystem site links',
+          'ja-JP': 'エコシステムサイトへのリンク', 'ko-KR': '에코시스템 사이트 링크',
+          'de-DE': 'Links zu Ökosystem-Seiten', 'fr-FR': "Liens vers les sites de l'écosystème",
+          'es-ES': 'Enlaces de sitios del ecosistema', 'pt-BR': 'Links dos sites do ecossistema',
+          'ru-RU': 'Ссылки на сайты экосистемы',
+        }, locale, 'Ecosystem site links'),
+        quickLinks: resolveLocalized({
+          'zh-CN': '快速链接', 'zh-Hant': '快速連結', 'en-US': 'Quick links',
+          'ja-JP': 'クイックリンク', 'ko-KR': '빠른 링크', 'de-DE': 'Schnellzugriffe',
+          'fr-FR': 'Liens rapides', 'es-ES': 'Enlaces rápidos',
+          'pt-BR': 'Links rápidos', 'ru-RU': 'Быстрые ссылки',
+        }, locale, 'Quick links'),
+        community: resolveLocalized({
+          'zh-CN': '社区链接', 'zh-Hant': '社群連結', 'en-US': 'Community links',
+          'ja-JP': 'コミュニティリンク', 'ko-KR': '커뮤니티 링크',
+          'de-DE': 'Community-Links', 'fr-FR': 'Liens communautaires',
+          'es-ES': 'Enlaces de la comunidad', 'pt-BR': 'Links da comunidade',
+          'ru-RU': 'Ссылки сообщества',
+        }, locale, 'Community links'),
+        filings: resolveLocalized({
+          'zh-CN': '查看备案信息', 'zh-Hant': '查看備案資訊',
+          'en-US': 'View filing information', 'ja-JP': '登録情報を表示',
+          'ko-KR': '등록 정보 보기', 'de-DE': 'Registrierungsinformationen anzeigen',
+          'fr-FR': 'Voir les informations de dépôt', 'es-ES': 'Ver información de registro',
+          'pt-BR': 'Ver informações de registro', 'ru-RU': 'Показать информацию о регистрации',
+        }, locale, 'View filing information'),
+      },
+    },
+    header: resolvedGroups.header,
+    quick: resolvedGroups.quick,
+    community: resolvedGroups.community,
+    filings: resolvedGroups.filings,
+    relatedSites,
+  };
+}