@hagicode/hagilight-core 0.1.0

package/dist/promoto-banner.d.ts

@@ -0,0 +1,8 @@
+import { type PromotionCard } from './promotions.js';
+export type PromotionVisibility = 'dismissed' | 'footer-hidden' | 'hidden' | 'ready';
+export declare function selectPromotionCards(remote: PromotionCard[], fallback?: PromotionCard | null): PromotionCard[];
+export declare function getPromotionSetSignature(cards: PromotionCard[]): string | null;
+export declare function getPromotionVisibility(cards: PromotionCard[], signature: string | null, dismissedSignature: string | null, footerVisible: boolean): PromotionVisibility;
+export declare function getNextPromotionIndex(index: number, count: number, direction: -1 | 1): number;
+export declare function shouldAutoRotate(count: number, paused: boolean, reducedMotion: boolean, documentVisible: boolean, visibility: PromotionVisibility): boolean;
+export declare function definePromotoBannerElement(): void;

package/dist/promoto-banner.js

@@ -0,0 +1,342 @@
+import { loadActivePromotions } from './promotions.js';
+const ELEMENT_NAME = 'hagilight-promoto-banner';
+const DISMISSED_SIGNATURE_KEY = 'hagilight:promoto-banner:dismissed-signature';
+const ROTATION_INTERVAL_MS = 8000;
+const REFRESH_INTERVAL_MS = 5 * 60 * 1000;
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function isSafeUrl(value) {
+    try {
+        return ['http:', 'https:'].includes(new URL(value, 'https://hagilight.invalid/').protocol);
+    }
+    catch {
+        return false;
+    }
+}
+function isUsableCard(value) {
+    if (!isRecord(value))
+        return false;
+    const image = value.image;
+    const imageIsValid = image === undefined || (isRecord(image) && typeof image.src === 'string' && isSafeUrl(image.src)
+        && typeof image.alt === 'string'
+        && (image.variant === undefined || typeof image.variant === 'string')
+        && (image.width === undefined || (typeof image.width === 'number' && Number.isFinite(image.width) && image.width > 0))
+        && (image.height === undefined || (typeof image.height === 'number' && Number.isFinite(image.height) && image.height > 0)));
+    return typeof value.id === 'string' && value.id.trim().length > 0
+        && typeof value.title === 'string' && value.title.trim().length > 0
+        && typeof value.description === 'string' && value.description.trim().length > 0
+        && typeof value.ctaLabel === 'string' && value.ctaLabel.trim().length > 0
+        && typeof value.link === 'string' && value.link.trim().length > 0 && isSafeUrl(value.link)
+        && imageIsValid;
+}
+export function selectPromotionCards(remote, fallback) {
+    const eligibleRemote = remote.filter(isUsableCard);
+    if (eligibleRemote.length)
+        return eligibleRemote;
+    return fallback && isUsableCard(fallback) ? [fallback] : [];
+}
+export function getPromotionSetSignature(cards) {
+    if (!cards.length)
+        return null;
+    return JSON.stringify(cards.map(({ id, title, description, ctaLabel, link, image }) => [
+        id, title, description, ctaLabel, link, image?.src ?? '', image?.alt ?? '',
+        image?.variant ?? '', image?.width ?? 0, image?.height ?? 0,
+    ]));
+}
+export function getPromotionVisibility(cards, signature, dismissedSignature, footerVisible) {
+    if (!cards.length)
+        return 'hidden';
+    if (signature && signature === dismissedSignature)
+        return 'dismissed';
+    return footerVisible ? 'footer-hidden' : 'ready';
+}
+export function getNextPromotionIndex(index, count, direction) {
+    return count > 0 ? (index + direction + count) % count : 0;
+}
+export function shouldAutoRotate(count, paused, reducedMotion, documentVisible, visibility) {
+    return count > 1 && !paused && !reducedMotion && documentVisible && visibility === 'ready';
+}
+function readDismissedSignature() {
+    try {
+        return window.localStorage.getItem(DISMISSED_SIGNATURE_KEY);
+    }
+    catch {
+        return null;
+    }
+}
+function saveDismissedSignature(signature) {
+    try {
+        window.localStorage.setItem(DISMISSED_SIGNATURE_KEY, signature);
+    }
+    catch (error) {
+        console.warn('Unable to save the dismissed promotion preference.', error);
+    }
+}
+export function definePromotoBannerElement() {
+    if (typeof customElements === 'undefined' || typeof HTMLElement === 'undefined'
+        || customElements.get(ELEMENT_NAME))
+        return;
+    class PromotoBannerElement extends HTMLElement {
+        cards = [];
+        currentIndex = 0;
+        dismissedSignature = readDismissedSignature();
+        paused = false;
+        reducedMotion = false;
+        rotationTimer;
+        refreshTimer;
+        motionQuery;
+        resizeObserver;
+        footer = null;
+        loadedLocale = null;
+        onPrevious = () => this.move(-1);
+        onNext = () => this.move(1);
+        onPause = () => {
+            if (this.reducedMotion)
+                return;
+            this.paused = !this.paused;
+            this.updateControls();
+            this.syncRotation();
+        };
+        onDismiss = () => {
+            const signature = getPromotionSetSignature(this.cards);
+            if (!signature)
+                return;
+            this.dismissedSignature = signature;
+            saveDismissedSignature(signature);
+            this.updateVisibility();
+            this.stopRotation();
+        };
+        onLayoutChange = () => {
+            const previousState = this.dataset.state;
+            this.updateVisibility();
+            if (previousState !== this.dataset.state)
+                this.syncRotation();
+        };
+        onVisibilityChange = () => {
+            if (document.visibilityState === 'hidden') {
+                this.stopRotation();
+                this.stopRefresh();
+            }
+            else {
+                this.syncRotation();
+                this.startRefresh();
+            }
+        };
+        onMotionChange = () => {
+            this.reducedMotion = this.motionQuery?.matches ?? false;
+            this.updateControls();
+            this.syncRotation();
+        };
+        onPageLoad = () => {
+            // Re-fetch in the current page locale after a Starlight view-transition
+            // navigation. The element may persist across a soft language switch, so
+            // its previously loaded locale can differ from the new page's data-locale.
+            if (this.dataset.locale !== this.loadedLocale)
+                void this.reload();
+        };
+        connectedCallback() {
+            this.footer = document.querySelector('footer');
+            this.motionQuery = window.matchMedia?.('(prefers-reduced-motion: reduce)');
+            this.reducedMotion = this.motionQuery?.matches ?? false;
+            this.querySelector('[data-promoto-previous]')?.addEventListener('click', this.onPrevious);
+            this.querySelector('[data-promoto-next]')?.addEventListener('click', this.onNext);
+            this.querySelector('[data-promoto-pause]')?.addEventListener('click', this.onPause);
+            this.querySelector('[data-promoto-dismiss]')?.addEventListener('click', this.onDismiss);
+            window.addEventListener('scroll', this.onLayoutChange, { passive: true });
+            window.addEventListener('resize', this.onLayoutChange);
+            document.addEventListener('visibilitychange', this.onVisibilityChange);
+            this.motionQuery?.addEventListener('change', this.onMotionChange);
+            document.addEventListener('astro:page-load', this.onPageLoad);
+            if (typeof ResizeObserver !== 'undefined') {
+                this.resizeObserver = new ResizeObserver(this.onLayoutChange);
+                if (this.footer)
+                    this.resizeObserver.observe(this.footer);
+                const shell = this.querySelector('[data-promoto-shell]');
+                if (shell)
+                    this.resizeObserver.observe(shell);
+            }
+            void this.reload();
+            this.startRefresh();
+        }
+        disconnectedCallback() {
+            this.querySelector('[data-promoto-previous]')?.removeEventListener('click', this.onPrevious);
+            this.querySelector('[data-promoto-next]')?.removeEventListener('click', this.onNext);
+            this.querySelector('[data-promoto-pause]')?.removeEventListener('click', this.onPause);
+            this.querySelector('[data-promoto-dismiss]')?.removeEventListener('click', this.onDismiss);
+            window.removeEventListener('scroll', this.onLayoutChange);
+            window.removeEventListener('resize', this.onLayoutChange);
+            document.removeEventListener('visibilitychange', this.onVisibilityChange);
+            this.motionQuery?.removeEventListener('change', this.onMotionChange);
+            document.removeEventListener('astro:page-load', this.onPageLoad);
+            this.resizeObserver?.disconnect();
+            this.stopRotation();
+            this.stopRefresh();
+        }
+        async reload() {
+            const previousId = this.cards[this.currentIndex]?.id;
+            this.loadedLocale = this.dataset.locale ?? null;
+            const remote = await loadActivePromotions({ locale: this.dataset.locale });
+            if (!this.isConnected)
+                return;
+            const fallback = this.readFallback();
+            this.cards = selectPromotionCards(remote, fallback);
+            const previousIndex = previousId ? this.cards.findIndex((card) => card.id === previousId) : -1;
+            this.currentIndex = previousIndex >= 0 ? previousIndex : 0;
+            this.renderCards();
+            this.updateVisibility();
+            this.updateControls();
+            this.syncRotation();
+        }
+        readFallback() {
+            const serialized = this.dataset.fallback;
+            if (!serialized)
+                return null;
+            try {
+                const value = JSON.parse(serialized);
+                return isUsableCard(value) ? value : null;
+            }
+            catch (error) {
+                console.warn('Unable to parse the site-provided promotion fallback.', error);
+                return null;
+            }
+        }
+        renderCards() {
+            const track = this.querySelector('[data-promoto-track]');
+            if (!track)
+                return;
+            const fragment = document.createDocumentFragment();
+            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', '');
+                const copy = document.createElement('div');
+                copy.className = 'hagilight-promoto__copy';
+                const title = document.createElement('h2');
+                title.className = 'hagilight-promoto__title';
+                title.textContent = card.title;
+                const description = document.createElement('p');
+                description.className = 'hagilight-promoto__description';
+                description.textContent = card.description;
+                copy.append(title, description);
+                const link = document.createElement('a');
+                link.className = 'hagilight-promoto__cta';
+                link.href = card.link;
+                link.target = '_blank';
+                link.rel = 'noopener noreferrer';
+                link.textContent = card.ctaLabel;
+                slide.append(copy);
+                if (card.image) {
+                    const media = document.createElement('span');
+                    media.className = 'hagilight-promoto__media';
+                    const image = document.createElement('img');
+                    image.className = 'hagilight-promoto__image';
+                    image.src = card.image.src;
+                    image.alt = card.image.alt || card.title;
+                    image.loading = index === this.currentIndex ? 'eager' : 'lazy';
+                    image.decoding = 'async';
+                    if (card.image.width)
+                        image.width = card.image.width;
+                    if (card.image.height)
+                        image.height = card.image.height;
+                    media.append(image);
+                    slide.append(media);
+                }
+                slide.append(link);
+                fragment.append(slide);
+            });
+            track.replaceChildren(fragment);
+            this.updateSlides();
+        }
+        updateSlides() {
+            const track = this.querySelector('[data-promoto-track]');
+            if (!track)
+                return;
+            Array.from(track.children).forEach((slide, index) => {
+                const active = index === this.currentIndex;
+                slide.setAttribute('aria-hidden', String(!active));
+                if (active)
+                    slide.removeAttribute('inert');
+                else
+                    slide.setAttribute('inert', '');
+            });
+            track.style.transform = `translateX(-${this.currentIndex * 100}%)`;
+            const current = this.cards[this.currentIndex];
+            const status = this.querySelector('[data-promoto-status]');
+            if (status)
+                status.textContent = current?.title ?? '';
+            const count = this.querySelector('[data-promoto-count]');
+            if (count)
+                count.textContent = `${this.currentIndex + 1} / ${this.cards.length}`;
+        }
+        updateControls() {
+            const multiple = this.cards.length > 1;
+            const controls = this.querySelector('[data-promoto-controls]');
+            if (controls)
+                controls.hidden = !multiple;
+            const pause = this.querySelector('[data-promoto-pause]');
+            if (pause) {
+                const paused = this.paused || this.reducedMotion;
+                pause.disabled = this.reducedMotion;
+                pause.setAttribute('aria-pressed', String(paused));
+                pause.setAttribute('aria-label', paused ? 'Resume automatic promotion rotation' : 'Pause automatic promotion rotation');
+                pause.textContent = paused ? 'Resume' : 'Pause';
+            }
+            this.updateSlides();
+        }
+        move(direction) {
+            if (this.cards.length < 2)
+                return;
+            this.currentIndex = getNextPromotionIndex(this.currentIndex, this.cards.length, direction);
+            this.updateSlides();
+            this.syncRotation();
+        }
+        updateVisibility() {
+            const signature = getPromotionSetSignature(this.cards);
+            const state = getPromotionVisibility(this.cards, signature, this.dismissedSignature, this.isFooterVisible());
+            const hidden = state === 'hidden' || state === 'dismissed';
+            const shell = this.querySelector('[data-promoto-shell]');
+            this.hidden = hidden;
+            if (shell) {
+                shell.hidden = hidden;
+                shell.inert = hidden || state === 'footer-hidden';
+            }
+            this.dataset.state = state;
+        }
+        isFooterVisible() {
+            if (!this.footer)
+                return false;
+            const bounds = this.footer.getBoundingClientRect();
+            return bounds.top < window.innerHeight && bounds.bottom > 0;
+        }
+        syncRotation() {
+            this.stopRotation();
+            const state = this.dataset.state;
+            if (state !== 'ready' && state !== 'footer-hidden' && state !== 'hidden' && state !== 'dismissed')
+                return;
+            if (!shouldAutoRotate(this.cards.length, this.paused, this.reducedMotion, document.visibilityState !== 'hidden', state))
+                return;
+            this.rotationTimer = window.setInterval(() => this.move(1), ROTATION_INTERVAL_MS);
+        }
+        stopRotation() {
+            if (this.rotationTimer !== undefined)
+                window.clearInterval(this.rotationTimer);
+            this.rotationTimer = undefined;
+        }
+        startRefresh() {
+            this.stopRefresh();
+            if (document.visibilityState !== 'hidden') {
+                this.refreshTimer = window.setInterval(() => void this.reload(), REFRESH_INTERVAL_MS);
+            }
+        }
+        stopRefresh() {
+            if (this.refreshTimer !== undefined)
+                window.clearInterval(this.refreshTimer);
+            this.refreshTimer = undefined;
+        }
+    }
+    customElements.define(ELEMENT_NAME, PromotoBannerElement);
+}

package/dist/related-sites.json

@@ -0,0 +1,306 @@
+[
+    {
+        "id": "hagitask",
+        "name": {
+            "zh-CN": "HagiTask",
+            "zh-Hant": "HagiTask",
+            "en-US": "HagiTask",
+            "ja-JP": "HagiTask",
+            "ko-KR": "HagiTask",
+            "de-DE": "HagiTask",
+            "fr-FR": "HagiTask",
+            "es-ES": "HagiTask",
+            "pt-BR": "HagiTask",
+            "ru-RU": "HagiTask"
+        },
+        "description": {
+            "zh-CN": "任务与工作流管理",
+            "zh-Hant": "任務與工作流程管理",
+            "en-US": "Task and workflow management.",
+            "ja-JP": "タスクとワークフローを管理します。",
+            "ko-KR": "작업과 워크플로를 관리합니다.",
+            "de-DE": "Aufgaben und Workflows verwalten.",
+            "fr-FR": "Gestion des tâches et des workflows.",
+            "es-ES": "Gestión de tareas y flujos de trabajo.",
+            "pt-BR": "Gerenciamento de tarefas e fluxos de trabalho.",
+            "ru-RU": "Управление задачами и рабочими процессами."
+        },
+        "url": "https://tasks.hagicode.com/"
+    },
+    {
+        "id": "costCalculator",
+        "name": {
+            "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": "Заменит ли меня ИИ?"
+        },
+        "url": "https://cost.hagicode.com"
+    },
+    {
+        "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/",
+        "supportsLocalePath": true
+    },
+    {
+        "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/",
+        "supportsLocalePath": true
+    },
+    {
+        "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/"
+    },
+    {
+        "id": "openspec-docs",
+        "name": {
+            "zh-CN": "OpenSpec 文档",
+            "zh-Hant": "OpenSpec 文件",
+            "en-US": "OpenSpec Docs",
+            "ja-JP": "OpenSpec ドキュメント",
+            "ko-KR": "OpenSpec 문서",
+            "de-DE": "OpenSpec-Dokumentation",
+            "fr-FR": "Documentation OpenSpec",
+            "es-ES": "Documentación de OpenSpec",
+            "pt-BR": "Documentação do OpenSpec",
+            "ru-RU": "Документация OpenSpec"
+        },
+        "url": "https://openspec.hagicode.com/",
+        "supportsLocalePath": true
+    },
+    {
+        "id": "omniroute-docs",
+        "name": {
+            "zh-CN": "OmniRoute 文档",
+            "zh-Hant": "OmniRoute 文件",
+            "en-US": "OmniRoute Docs",
+            "ja-JP": "OmniRoute ドキュメント",
+            "ko-KR": "OmniRoute 문서",
+            "de-DE": "OmniRoute-Dokumentation",
+            "fr-FR": "Documentation OmniRoute",
+            "es-ES": "Documentación de OmniRoute",
+            "pt-BR": "Documentação do OmniRoute",
+            "ru-RU": "Документация OmniRoute"
+        },
+        "url": "https://omniroute.hagicode.com/",
+        "supportsLocalePath": true
+    }
+]

package/dist/rss-footer-context.d.ts

@@ -0,0 +1,6 @@
+import type { SiteLinksOptions } from './links.js';
+/**
+ * Merge generated `hagilightRss()` feed URLs from request locals into Footer
+ * link options. Explicit `rssFeedUrl`/`rssLocaleFeedUrl` values win.
+ */
+export declare function resolveRssFooterLinks(locals: unknown, locale: string | undefined, links?: SiteLinksOptions): SiteLinksOptions;