@hagicode/hagilight-starlight 0.3.1 → 0.3.2-dev.57.1.ee1f17e

package/AIDisclosureNotice.astro

@@ -1,5 +1,5 @@
 ---
-import { getAIDisclosureCopy } from './ai-disclosures.mjs';
+import { getAIDisclosureCopy } from './dist/ai-disclosures.js';
 const { kind, lang, sourceHref } = Astro.props;
 const copy = getAIDisclosureCopy(lang);
 ---

package/ArticlePromotion.astro

@@ -1,6 +1,6 @@
 ---
 import heroImage from './assets/light-main.png';
-import { getArticlePromotionCopy } from './article-promotion.mjs';
+import { getArticlePromotionCopy } from './dist/article-promotion.js';
 
 const { lang } = Astro.props;
 const copy = getArticlePromotionCopy(lang);

package/ContentLayoutToggle.astro

@@ -1,5 +1,5 @@
 ---
-import { getContentWidthLabels } from './content-width-i18n.mjs';
+import { getContentWidthLabels } from './dist/content-width-i18n.js';
 const { lang } = Astro.locals.starlightRoute;
 const labels = getContentWidthLabels(lang);
 ---
@@ -18,7 +18,7 @@ const labels = getContentWidthLabels(lang);
     restoreContentWidth,
     setContentWidth,
     synchronizeContentWidthFromStorage,
-  } from './content-width.mjs';
+  } from './dist/content-width.js';
 
   const root = document.documentElement;
   restoreContentWidth(root);

package/Footer.astro

@@ -1,7 +1,7 @@
 ---
-import Copyright from '@hagicode/hagilight/Copyright';
+import Copyright from '@hagicode/hagilight-core/Copyright';
 import DefaultFooter from '@astrojs/starlight/components/Footer.astro';
-import { resolveSiteLinks, type SiteLinksOptions } from '@hagicode/hagilight/site-links';
+import { resolveSiteLinks, type SiteLinksOptions } from '@hagicode/hagilight-core/links';
 
 interface Props {
   locale?: string;
@@ -17,8 +17,16 @@ const {
   rssLocaleFeedUrls,
 } = Astro.props;
 const currentLanguage = Astro.locals?.starlightRoute?.lang;
+const sitemapOverride = links?.overrides?.sitemap;
 const resolvedLinks = resolveSiteLinks(currentLanguage ?? locale, {
   ...links,
+  overrides: {
+    ...links?.overrides,
+    sitemap: {
+      ...sitemapOverride,
+      href: sitemapOverride?.href ?? `${import.meta.env.BASE_URL}sitemap-index.xml`,
+    },
+  },
   ...(rssFeedUrl === undefined ? {} : { rssFeedUrl }),
   ...(currentLanguage && rssLocaleFeedUrls?.[currentLanguage]
     ? { rssLocaleFeedUrl: rssLocaleFeedUrls[currentLanguage] }

package/Header.astro

@@ -4,7 +4,7 @@ import Search from 'virtual:starlight/components/Search';
 import SiteTitle from 'virtual:starlight/components/SiteTitle';
 import SocialIcons from 'virtual:starlight/components/SocialIcons';
 import ThemeSelect from 'virtual:starlight/components/ThemeSelect';
-import { resolveSiteLinks, type SiteLinksOptions } from '@hagicode/hagilight/site-links';
+import { resolveSiteLinks, type SiteLinksOptions } from '@hagicode/hagilight-core/links';
 import LanguageChooser from './LanguageChooser.astro';
 
 interface Props {

package/LanguageChooser.astro

@@ -4,7 +4,7 @@ import context from 'virtual:starlight/project-context';
 import {
   buildLocaleNavigationTarget,
   getConfiguredLanguageOptions,
-} from './language-routing.mjs';
+} from './dist/language-routing.js';
 
 const currentLocale = Astro.locals.starlightRoute.locale ?? config.defaultLocale?.locale ?? 'root';
 const options = getConfiguredLanguageOptions(config.locales, currentLocale);
@@ -101,7 +101,7 @@ const navigationOptions = options.map((option) => ({
   import {
     getKeyboardTargetIndex,
     persistStarlightLocaleSelection,
-  } from './language-routing.mjs';
+  } from './dist/language-routing.js';
 
   class HagilightLanguageChooser extends HTMLElement {
     connectedCallback() {

package/MarkdownContent.astro

@@ -7,8 +7,8 @@ import {
   getSourcePath,
   isTranslationLocale,
   resolveAIDisclosureFlags,
-} from './ai-disclosures.mjs';
-import { resolveArticlePromotion } from './article-promotion.mjs';
+} from './dist/ai-disclosures.js';
+import { resolveArticlePromotion } from './dist/article-promotion.js';
 
 const {
   aiDisclosures = { isAITranslation: false, isAIAuthor: false, sourceLocale: 'root' },

package/NotFoundHero.astro

@@ -5,7 +5,7 @@ import {
   getNotFoundHomeHref,
   getNotFoundHomeLabel,
   isNotFoundEntry,
-} from './not-found.mjs';
+} from './dist/not-found.js';
 
 const route = Astro.locals.starlightRoute;
 const isNotFound = isNotFoundEntry(route.entry.id);

package/PromotoFooter.astro

@@ -1,5 +1,5 @@
 ---
-import PromotoBanner from '@hagicode/hagilight/PromotoBanner';
+import PromotoBanner from '@hagicode/hagilight-core/PromotoBanner';
 import Footer from './Footer.astro';
 ---
 

package/SEOHead.astro

@@ -1,14 +1,12 @@
 ---
 import { getCollection } from 'astro:content';
+import { composeSeoHead, resolveSeoMetadata, serializeJsonLd } from '@hagicode/hagilight-core/seo';
 import {
   buildStructuredData,
-  composeSeoHead,
   createPublishedDocsLookup,
   filterPublishedLocaleAlternates,
-  resolveSeoMetadata,
   resolveSeoPage,
-  serializeJsonLd,
-} from './seo-utils.mjs';
+} from './dist/seo-utils.js';
 
 const { options } = Astro.props;
 const route = Astro.locals.starlightRoute;

package/dist/ai-disclosures.d.ts

@@ -0,0 +1,31 @@
+export interface AIDisclosureCopy {
+    author: string;
+    translation: string;
+    source: string;
+}
+export interface AIDisclosureFlags {
+    isAITranslation: boolean;
+    isAIAuthor: boolean;
+}
+export interface AIDisclosureDefaults extends AIDisclosureFlags {
+    /** Locale route key of the original-language content, `root` by default. */
+    sourceLocale: string;
+}
+export declare const COPY: Readonly<Record<string, AIDisclosureCopy>>;
+export declare function resolveAIDisclosureFlags(frontmatter: Partial<Record<keyof AIDisclosureFlags, unknown>>, defaults: AIDisclosureFlags): AIDisclosureFlags;
+export declare function getAIDisclosureCopy(lang: string | undefined): AIDisclosureCopy;
+export declare function getSourceEntryId(routeId: string, currentLocale: string | undefined, sourceLocale: string): string;
+export declare function normalizeDocsEntryId(id: string): string;
+export interface SourcePathOptions {
+    docs: readonly {
+        id: string;
+    }[];
+    routeId: string;
+    currentLocale: string | undefined;
+    sourceLocale: string;
+    pathname: string;
+    baseUrl: string;
+}
+export declare function getSourcePath({ docs, routeId, currentLocale, sourceLocale, pathname, baseUrl, }: SourcePathOptions): string | undefined;
+export declare function isTranslationLocale(locale: string | undefined, sourceLocale: string): boolean;
+export declare function buildSourcePathname(pathname: string, baseUrl: string, currentLocale: string | undefined, sourceLocale: string): string;

package/dist/ai-disclosures.js

@@ -0,0 +1,105 @@
+export const COPY = {
+    'de-DE': {
+        author: 'Dieser Inhalt wurde mit KI-Unterstützung erstellt. Bitte prüfen Sie wichtige Angaben.',
+        translation: 'Dieser Beitrag wurde mit KI übersetzt.',
+        source: 'Original ansehen',
+    },
+    'en-US': {
+        author: 'This content was created with AI assistance. Please verify important details.',
+        translation: 'This post was translated with AI.',
+        source: 'View source',
+    },
+    'es-ES': {
+        author: 'Este contenido se creó con ayuda de IA. Verifica los detalles importantes.',
+        translation: 'Esta publicación se tradujo con IA.',
+        source: 'Ver original',
+    },
+    'fr-FR': {
+        author: 'Ce contenu a été créé avec l’aide de l’IA. Vérifiez les informations importantes.',
+        translation: 'Cet article a été traduit avec l’IA.',
+        source: 'Voir la source',
+    },
+    'ja-JP': {
+        author: 'この記事は AI の支援を受けて作成されました。重要な情報はご確認ください。',
+        translation: 'この記事は AI によって翻訳されました。',
+        source: '原文を見る',
+    },
+    'ko-KR': {
+        author: '이 콘텐츠는 AI의 도움을 받아 작성되었습니다. 중요한 세부 정보는 확인해 주세요.',
+        translation: '이 게시물은 AI로 번역되었습니다.',
+        source: '원문 보기',
+    },
+    'pt-BR': {
+        author: 'Este conteúdo foi criado com auxílio de IA. Confira os detalhes importantes.',
+        translation: 'Esta publicação foi traduzida com IA.',
+        source: 'Ver original',
+    },
+    'ru-RU': {
+        author: 'Этот материал создан с помощью ИИ. Проверьте важные сведения.',
+        translation: 'Эта публикация переведена с помощью ИИ.',
+        source: 'Открыть оригинал',
+    },
+    'zh-CN': {
+        author: '本文内容由 AI 辅助创作。请核实重要信息。',
+        translation: '本文由 AI 翻译。',
+        source: '查看原文',
+    },
+    'zh-Hant': {
+        author: '本文內容由 AI 輔助創作。請核實重要資訊。',
+        translation: '本文由 AI 翻譯。',
+        source: '查看原文',
+    },
+};
+export function resolveAIDisclosureFlags(frontmatter, defaults) {
+    for (const key of ['isAITranslation', 'isAIAuthor']) {
+        if (frontmatter[key] !== undefined && typeof frontmatter[key] !== 'boolean') {
+            throw new TypeError(`Hagilight frontmatter ${key} must be a boolean.`);
+        }
+        if (typeof defaults[key] !== 'boolean') {
+            throw new TypeError(`Hagilight aiDisclosures ${key} default must be a boolean.`);
+        }
+    }
+    return {
+        isAITranslation: frontmatter.isAITranslation ?? defaults.isAITranslation,
+        isAIAuthor: frontmatter.isAIAuthor ?? defaults.isAIAuthor,
+    };
+}
+export function getAIDisclosureCopy(lang) {
+    const exact = lang === undefined ? undefined : COPY[lang];
+    if (exact)
+        return exact;
+    const language = lang?.split('-')[0];
+    return (language === undefined ? undefined : COPY[language]) ?? COPY['en-US'];
+}
+export function getSourceEntryId(routeId, currentLocale, sourceLocale) {
+    const prefix = currentLocale && currentLocale !== 'root' ? `${currentLocale}/` : '';
+    const routeSlug = prefix && routeId.startsWith(prefix) ? routeId.slice(prefix.length) : routeId;
+    if (sourceLocale === 'root')
+        return routeSlug === 'index' ? '' : routeSlug;
+    return `${sourceLocale}/${routeSlug || 'index'}`;
+}
+export function normalizeDocsEntryId(id) {
+    return id === 'index' ? '' : id;
+}
+export function getSourcePath({ docs, routeId, currentLocale, sourceLocale, pathname, baseUrl, }) {
+    const sourceId = getSourceEntryId(routeId, currentLocale, sourceLocale);
+    if (!docs.some((entry) => normalizeDocsEntryId(entry.id) === sourceId))
+        return undefined;
+    return buildSourcePathname(pathname, baseUrl, currentLocale, sourceLocale);
+}
+export function isTranslationLocale(locale, sourceLocale) {
+    return (locale ?? 'root') !== sourceLocale;
+}
+export function buildSourcePathname(pathname, baseUrl, currentLocale, sourceLocale) {
+    const basePath = new URL(baseUrl, 'https://hagilight.invalid').pathname;
+    const normalizedBase = basePath.endsWith('/') ? basePath : `${basePath}/`;
+    const relativePath = pathname.startsWith(normalizedBase)
+        ? pathname.slice(normalizedBase.length)
+        : pathname.startsWith('/') ? pathname.slice(1) : pathname;
+    const segments = relativePath.split('/');
+    if (currentLocale && currentLocale !== 'root' && segments[0] === currentLocale)
+        segments.shift();
+    if (sourceLocale !== 'root')
+        segments.unshift(sourceLocale);
+    return `${normalizedBase}${segments.join('/')}`;
+}

package/dist/article-promotion.d.ts

@@ -0,0 +1,15 @@
+export interface ArticlePromotionFeature {
+    label: string;
+    description: string;
+}
+export interface ArticlePromotionCopy {
+    title: string;
+    lead: string;
+    subheadline: string;
+    imageAlt: string;
+    features: readonly ArticlePromotionFeature[];
+    visitLabel: string;
+}
+export declare const COPY: Readonly<Record<string, ArticlePromotionCopy>>;
+export declare function resolveArticlePromotion(frontmatterValue: unknown, siteDefault?: boolean): boolean;
+export declare function getArticlePromotionCopy(lang: string | undefined): ArticlePromotionCopy;

package/dist/article-promotion.js

@@ -0,0 +1,134 @@
+export const COPY = {
+    'zh-CN': {
+        title: 'HagiCode',
+        lead: 'HagiCode 是一套智能体编码工作台：结构化工作流、多 Agent 并行执行与 Hero Dungeon 视图，把想法变成真正交付的软件。',
+        subheadline: '让想法更快变成好用的软件，让智能编码更聪明、更高效，也更有趣。',
+        imageAlt: 'HagiCode 浅色主题主界面截图',
+        features: [
+            { label: 'Smart', description: '结构化工作流将意图转化为从想法到交付的可执行路径。' },
+            { label: 'Efficient', description: '多 Agent 工作流让调研、实现与审阅并行推进。' },
+            { label: 'Fun', description: 'Hero Dungeon 让长时间编码协作更直观、更有参与感。' },
+        ],
+        visitLabel: '访问 HagiCode',
+    },
+    'en-US': {
+        title: 'HagiCode',
+        lead: 'HagiCode is an agentic coding workspace: structured workflows, multi-agent execution, and Hero Dungeon views turn ideas into shipped software.',
+        subheadline: 'Turn ideas into polished, usable software with a smarter, faster, and more enjoyable agentic coding workflow.',
+        imageAlt: 'HagiCode light theme main interface screenshot',
+        features: [
+            { label: 'Smart', description: 'Structured workflows turn intent into an executable path from idea to shipped change.' },
+            { label: 'Efficient', description: 'Multi-agent workflows keep research, implementation, and review moving in parallel.' },
+            { label: 'Fun', description: 'Hero Dungeon interfaces make long coding sessions visual, collaborative, and rewarding.' },
+        ],
+        visitLabel: 'Visit HagiCode',
+    },
+    'zh-Hant': {
+        title: 'HagiCode',
+        lead: 'HagiCode 是智慧代理程式開發工作台，結合結構化工作流程、多代理程式執行與 Hero Dungeon 介面，將想法化為交付成果。',
+        subheadline: '以更聰明、更快速且更有趣的智慧代理程式工作流程，打造實用的軟體。',
+        imageAlt: 'HagiCode 淺色主題介面畫面',
+        features: [
+            { label: 'Smart', description: '結構化流程將意圖轉化為從構想到交付的可執行步驟。' },
+            { label: 'Efficient', description: '多代理程式工作流程讓研究、實作與審查並行進行。' },
+            { label: 'Fun', description: 'Hero Dungeon 讓長時間的程式協作更直覺、更有參與感。' },
+        ],
+        visitLabel: '造訪 HagiCode',
+    },
+    'ja-JP': {
+        title: 'HagiCode',
+        lead: 'HagiCode は構造化ワークフロー、マルチエージェント実行、Hero Dungeon ビューを備えたエージェント型コーディングワークスペースです。',
+        subheadline: 'よりスマートで速く、楽しいエージェント型ワークフローで、使いやすいソフトウェアを形にします。',
+        imageAlt: 'HagiCode ライトテーマのメイン画面',
+        features: [
+            { label: 'Smart', description: '構造化ワークフローは意図をアイデアから変更のリリースまで実行可能な道筋にします。' },
+            { label: 'Efficient', description: 'マルチエージェントのワークフローで調査、実装、レビューを並行して進めます。' },
+            { label: 'Fun', description: 'Hero Dungeon により長時間のコーディングを視覚的で協力的な体験にします。' },
+        ],
+        visitLabel: 'HagiCode を見る',
+    },
+    'ko-KR': {
+        title: 'HagiCode',
+        lead: 'HagiCode는 구조화된 워크플로, 다중 에이전트 실행, Hero Dungeon 뷰를 갖춘 에이전트 코딩 작업 공간입니다.',
+        subheadline: '더 스마트하고 빠르며 즐거운 에이전트 워크플로로 유용한 소프트웨어를 만드세요.',
+        imageAlt: 'HagiCode 라이트 테마 메인 화면',
+        features: [
+            { label: 'Smart', description: '구조화된 워크플로는 의도를 아이디어부터 배포까지 실행 가능한 경로로 바꿉니다.' },
+            { label: 'Efficient', description: '다중 에이전트 워크플로로 조사, 구현, 검토를 병렬로 진행합니다.' },
+            { label: 'Fun', description: 'Hero Dungeon은 긴 코딩 세션을 시각적이고 협업적인 경험으로 만듭니다.' },
+        ],
+        visitLabel: 'HagiCode 방문',
+    },
+    'de-DE': {
+        title: 'HagiCode',
+        lead: 'HagiCode ist ein agentischer Coding-Arbeitsplatz mit strukturierten Workflows, Multi-Agent-Ausführung und Hero-Dungeon-Ansichten.',
+        subheadline: 'Mit einem intelligenteren, schnelleren und unterhaltsameren agentischen Workflow wird aus Ideen nutzbare Software.',
+        imageAlt: 'HagiCode-Hauptoberfläche im hellen Design',
+        features: [
+            { label: 'Smart', description: 'Strukturierte Workflows machen aus Absichten einen umsetzbaren Weg von der Idee bis zur Auslieferung.' },
+            { label: 'Efficient', description: 'Multi-Agent-Workflows führen Recherche, Umsetzung und Prüfung parallel aus.' },
+            { label: 'Fun', description: 'Hero Dungeon macht lange Coding-Sitzungen anschaulich und gemeinschaftlich.' },
+        ],
+        visitLabel: 'HagiCode besuchen',
+    },
+    'fr-FR': {
+        title: 'HagiCode',
+        lead: 'HagiCode est un espace de développement agentique qui associe workflows structurés, exécution multi-agent et vues Hero Dungeon.',
+        subheadline: 'Transformez vos idées en logiciels utiles grâce à un workflow agentique plus intelligent, rapide et agréable.',
+        imageAlt: 'Interface principale de HagiCode en thème clair',
+        features: [
+            { label: 'Smart', description: 'Des workflows structurés transforment une intention en parcours exécutable, de l’idée à la livraison.' },
+            { label: 'Efficient', description: 'Les workflows multi-agents font avancer recherche, réalisation et revue en parallèle.' },
+            { label: 'Fun', description: 'Hero Dungeon rend les longues sessions de code plus visuelles et collaboratives.' },
+        ],
+        visitLabel: 'Visiter HagiCode',
+    },
+    'es-ES': {
+        title: 'HagiCode',
+        lead: 'HagiCode es un espacio de trabajo de programación con agentes, flujos estructurados, ejecución multiagente y vistas de Hero Dungeon.',
+        subheadline: 'Convierte ideas en software útil con un flujo de trabajo con agentes más inteligente, rápido y ameno.',
+        imageAlt: 'Interfaz principal de HagiCode con tema claro',
+        features: [
+            { label: 'Smart', description: 'Los flujos estructurados convierten la intención en un itinerario ejecutable desde la idea hasta la entrega.' },
+            { label: 'Efficient', description: 'Los flujos multiagente permiten avanzar en paralelo con la investigación, implementación y revisión.' },
+            { label: 'Fun', description: 'Hero Dungeon hace que las largas sesiones de programación sean visuales y colaborativas.' },
+        ],
+        visitLabel: 'Visitar HagiCode',
+    },
+    'pt-BR': {
+        title: 'HagiCode',
+        lead: 'HagiCode é um ambiente de programação com agentes, fluxos estruturados, execução multiagente e visualizações Hero Dungeon.',
+        subheadline: 'Transforme ideias em software útil com um fluxo de trabalho com agentes mais inteligente, rápido e agradável.',
+        imageAlt: 'Interface principal do HagiCode no tema claro',
+        features: [
+            { label: 'Smart', description: 'Fluxos estruturados transformam intenções em um caminho executável da ideia à entrega.' },
+            { label: 'Efficient', description: 'Fluxos multiagente mantêm pesquisa, implementação e revisão em andamento simultaneamente.' },
+            { label: 'Fun', description: 'O Hero Dungeon torna longas sessões de programação mais visuais e colaborativas.' },
+        ],
+        visitLabel: 'Acessar HagiCode',
+    },
+    'ru-RU': {
+        title: 'HagiCode',
+        lead: 'HagiCode — агентная среда разработки со структурированными процессами, параллельным выполнением несколькими агентами и интерфейсами Hero Dungeon.',
+        subheadline: 'Превращайте идеи в полезное ПО с более умным, быстрым и увлекательным агентным рабочим процессом.',
+        imageAlt: 'Главный экран HagiCode в светлой теме',
+        features: [
+            { label: 'Smart', description: 'Структурированные процессы превращают намерение в исполнимый путь от идеи до готового изменения.' },
+            { label: 'Efficient', description: 'Мультиагентные процессы параллельно продвигают исследование, реализацию и проверку.' },
+            { label: 'Fun', description: 'Hero Dungeon делает длительную совместную разработку наглядной и увлекательной.' },
+        ],
+        visitLabel: 'Перейти на HagiCode',
+    },
+};
+export function resolveArticlePromotion(frontmatterValue, siteDefault = true) {
+    if (typeof siteDefault !== 'boolean') {
+        throw new TypeError('Hagilight hagicodePromotion enabled default must be a boolean.');
+    }
+    if (frontmatterValue !== undefined && typeof frontmatterValue !== 'boolean') {
+        throw new TypeError('Hagilight frontmatter hagicodePromotion must be a boolean.');
+    }
+    return frontmatterValue ?? siteDefault;
+}
+export function getArticlePromotionCopy(lang) {
+    return (lang === undefined ? undefined : COPY[lang]) ?? COPY['en-US'];
+}

package/dist/content-width-i18n.d.ts

@@ -0,0 +1,6 @@
+export interface ContentWidthLabels {
+    group: string;
+    wide: string;
+    narrow: string;
+}
+export declare function getContentWidthLabels(lang: string | undefined): ContentWidthLabels;

package/dist/content-width-i18n.js

@@ -0,0 +1,15 @@
+const labels = {
+    'de-DE': { group: 'Inhaltsbreite', wide: 'Breit', narrow: 'Schmal' },
+    'en-US': { group: 'Content width', wide: 'Wide', narrow: 'Narrow' },
+    'es-ES': { group: 'Ancho del contenido', wide: 'Ancho', narrow: 'Estrecho' },
+    'fr-FR': { group: 'Largeur du contenu', wide: 'Large', narrow: 'Étroit' },
+    'ja-JP': { group: 'コンテンツ幅', wide: '広い', narrow: '狭い' },
+    'ko-KR': { group: '콘텐츠 너비', wide: '넓게', narrow: '좁게' },
+    'pt-BR': { group: 'Largura do conteúdo', wide: 'Ampla', narrow: 'Estreita' },
+    'ru-RU': { group: 'Ширина содержимого', wide: 'Широкая', narrow: 'Узкая' },
+    'zh-CN': { group: '内容宽度', wide: '宽', narrow: '窄' },
+    'zh-Hant': { group: '內容寬度', wide: '寬', narrow: '窄' },
+};
+export function getContentWidthLabels(lang) {
+    return (lang === undefined ? undefined : labels[lang]) ?? labels['en-US'];
+}

package/dist/content-width.d.ts

@@ -0,0 +1,5 @@
+export type ContentWidthMode = 'wide' | 'narrow';
+export declare const STORAGE_KEY = "hagilight-content-width";
+export declare function restoreContentWidth(root?: HTMLElement): ContentWidthMode;
+export declare function setContentWidth(mode: ContentWidthMode, root?: HTMLElement): void;
+export declare function synchronizeContentWidthFromStorage(event: Pick<StorageEvent, 'key' | 'newValue'>, root?: HTMLElement): void;

package/dist/content-width.js

@@ -0,0 +1,42 @@
+export const STORAGE_KEY = 'hagilight-content-width';
+const VALID_MODES = new Set(['wide', 'narrow']);
+function normalizeMode(value) {
+    return VALID_MODES.has(value) ? value : 'wide';
+}
+function synchronizeButtons(root, mode) {
+    root.querySelectorAll('[data-hagilight-content-width-choice]').forEach((button) => {
+        button.setAttribute('aria-pressed', String(button.dataset.hagilightContentWidthChoice === mode));
+    });
+}
+export function restoreContentWidth(root = document.documentElement) {
+    let mode = 'wide';
+    try {
+        mode = normalizeMode(globalThis.localStorage.getItem(STORAGE_KEY));
+    }
+    catch {
+        mode = 'wide';
+    }
+    root.dataset.hagilightContentWidth = mode;
+    synchronizeButtons(root, mode);
+    return mode;
+}
+export function setContentWidth(mode, root = document.documentElement) {
+    if (!VALID_MODES.has(mode)) {
+        throw new TypeError('Hagilight content width must be "wide" or "narrow".');
+    }
+    root.dataset.hagilightContentWidth = mode;
+    synchronizeButtons(root, mode);
+    try {
+        globalThis.localStorage.setItem(STORAGE_KEY, mode);
+    }
+    catch {
+        return;
+    }
+}
+export function synchronizeContentWidthFromStorage(event, root = document.documentElement) {
+    if (event.key !== STORAGE_KEY && event.key !== null)
+        return;
+    const mode = normalizeMode(event.newValue);
+    root.dataset.hagilightContentWidth = mode;
+    synchronizeButtons(root, mode);
+}

package/dist/index.d.ts

@@ -0,0 +1,58 @@
+import type { StarlightPlugin } from '@astrojs/starlight/types';
+import type { SiteLinksOptions } from '@hagicode/hagilight-core/links';
+import type { AIDisclosureDefaults } from './ai-disclosures.js';
+import { type RssContentOptions } from './rss-utils.js';
+import { type SeoOrganization } from './seo-utils.js';
+export interface HagilightToggleOptions {
+    enabled?: boolean;
+}
+export interface HagilightGoogleAnalyticsOptions {
+    /** Defaults to `true` when the provider options are omitted, otherwise to whether `measurementId` is set. */
+    enabled?: boolean;
+    /** Google Analytics 4 measurement ID such as `G-ABC123`. */
+    measurementId?: `G-${string}`;
+}
+export interface HagilightFiftyOneLaOptions {
+    /** Defaults to `true` when the provider options are omitted, otherwise to whether `siteId` is set. */
+    enabled?: boolean;
+    siteId?: string;
+}
+export interface HagilightAnalyticsOptions {
+    googleAnalytics?: HagilightGoogleAnalyticsOptions;
+    fiftyOneLa?: HagilightFiftyOneLaOptions;
+}
+export interface HagilightSeoOptions {
+    /** Replace Starlight's Head with Hagilight SEO metadata. Defaults to `true`; requires Astro `site`. */
+    enabled?: boolean;
+    title?: string;
+    description?: string;
+    /** Absolute HTTP(S) URL or site-root path of the default sharing image. */
+    image?: string;
+    organization?: SeoOrganization;
+}
+export interface HagilightRssOptions extends RssContentOptions {
+    /** Generate `/rss.xml` and localized feeds. Defaults to `true`; requires Astro `site`. */
+    enabled?: boolean;
+}
+export interface HagilightContentComponentsOptions {
+    pageTitle?: boolean;
+    markdownContent?: boolean;
+}
+export type HagilightAIDisclosureOptions = Partial<AIDisclosureDefaults>;
+export interface HagilightStarlightOptions {
+    header?: HagilightToggleOptions;
+    notFoundPage?: HagilightToggleOptions;
+    rss?: HagilightRssOptions;
+    analytics?: HagilightAnalyticsOptions;
+    seo?: HagilightSeoOptions;
+    contentComponents?: HagilightContentComponentsOptions;
+    aiDisclosures?: HagilightAIDisclosureOptions;
+    /** End-of-article HagiCode introduction. */
+    hagicodePromotion?: HagilightToggleOptions;
+    /** Floating promotion banner rendered after the footer. */
+    promoto?: HagilightToggleOptions;
+    /** Header and footer link customization passed to `resolveSiteLinks`. */
+    links?: SiteLinksOptions;
+}
+/** Starlight plugin that applies HagiCode header, footer, content, SEO, RSS, and analytics customizations. */
+export default function hagilight(options?: HagilightStarlightOptions): StarlightPlugin;