@hagicode/hagilight-starlight 0.1.0-dev.148.1.e0c630e

package/dist/article-promotion-copy/zh-CN.js

@@ -0,0 +1,43 @@
+const workbenchAlt = 'HagiCode 工作台截图，会话看板分为待处理、进行中与已归档三列。';
+export default {
+    title: 'HagiCode',
+    lead: 'HagiCode 是面向项目开发的 AI 编码工作台：丰富、便捷的界面交互让规划、Agent 执行与项目工作更容易上手和跟进，带来更投入的开发体验。',
+    subheadline: '丰富、便捷的界面交互，让规划、Agent 执行与项目工作更容易上手和跟进。',
+    imageAlt: workbenchAlt,
+    features: [
+        { id: 'smart', label: '智能', description: 'OpenSpec 工作流把意图转化为从提案、设计、任务到交付的可执行路径。' },
+        { id: 'efficient', label: '高效', description: '多 Agent 并行推进调研、实现与审阅，并支持多仓库变更和你熟悉的 Agent CLI。' },
+        { id: 'fun', label: '有趣', description: '丰富、便捷的界面交互让规划、Agent 执行与项目工作更容易上手和跟进，带来更投入的开发体验。' },
+    ],
+    visitLabel: '访问 HagiCode',
+    docsLabel: '阅读文档',
+    galleryHeading: '一览 HagiCode',
+    gallery: [
+        {
+            id: 'workbench',
+            caption: '工作台：所有会话汇集在同一块看板上。',
+            alt: workbenchAlt,
+        },
+        {
+            id: 'proposal-workflow',
+            caption: '提案从创建、起草、审阅一路推进到执行与归档。',
+            alt: 'HagiCode 提案阶段条截图，从已创建到已归档，当前高亮“执行完成”阶段并带有归档计划按钮。',
+        },
+        {
+            id: 'heroes',
+            caption: 'Hero Scenario：英雄推进工作，你随时查看进度、等级与剧情。',
+            alt: 'HagiCode Hero Scenario 面板截图，名为 Ember Keep，列出三位运行中的英雄及其等级、进度与剧情文字。',
+        },
+        {
+            id: 'hero-avatar',
+            caption: '插图：HagiCode 英雄头像，是同一套头像中的一幅，每次访问会换一幅。',
+            alt: 'HagiCode 英雄头像插图，风格化的角色肖像。',
+        },
+    ],
+    windowsLabel: '下载 Windows 版',
+    windowsStoreLabel: '从 Microsoft Store 获取',
+    windowsStoreAriaLabel: '在 Microsoft Store 中打开 HagiCode',
+    allDownloadsLabel: '全部下载',
+    shareLabel: '分享 HagiCode',
+    shareText: 'HagiCode 通过丰富、便捷的界面交互，让规划、Agent 执行与项目工作更容易上手和跟进：https://www.hagicode.com/',
+};

package/dist/article-promotion-copy/zh-Hant.d.ts

@@ -0,0 +1,34 @@
+declare const _default: {
+    title: string;
+    lead: string;
+    subheadline: string;
+    imageAlt: string;
+    features: ({
+        id: "smart";
+        label: string;
+        description: string;
+    } | {
+        id: "efficient";
+        label: string;
+        description: string;
+    } | {
+        id: "fun";
+        label: string;
+        description: string;
+    })[];
+    visitLabel: string;
+    docsLabel: string;
+    galleryHeading: string;
+    gallery: {
+        id: string;
+        caption: string;
+        alt: string;
+    }[];
+    windowsLabel: string;
+    windowsStoreLabel: string;
+    windowsStoreAriaLabel: string;
+    allDownloadsLabel: string;
+    shareLabel: string;
+    shareText: string;
+};
+export default _default;

package/dist/article-promotion-copy/zh-Hant.js

@@ -0,0 +1,43 @@
+const workbenchAlt = 'HagiCode 工作台畫面，工作階段看板分為待處理、進行中與已封存三欄。';
+export default {
+    title: 'HagiCode',
+    lead: 'HagiCode 是面向專案開發的 AI 編碼工作台：豐富、便利的介面互動讓規劃、Agent 執行與專案工作更容易上手和跟進，帶來更投入的開發體驗。',
+    subheadline: '透過豐富、便利的介面互動，讓規劃、Agent 執行與專案工作更容易上手和跟進。',
+    imageAlt: workbenchAlt,
+    features: [
+        { id: 'smart', label: '智慧', description: 'OpenSpec 工作流程將意圖轉化為從提案、設計、任務到交付的可執行路徑。' },
+        { id: 'efficient', label: '高效', description: '多 Agent 並行推進研究、實作與審查，並支援多儲存庫變更與你熟悉的 Agent CLI。' },
+        { id: 'fun', label: '有趣', description: '豐富、便利的介面互動讓規劃、Agent 執行與專案工作更容易上手和跟進，帶來更投入的開發體驗。' },
+    ],
+    visitLabel: '造訪 HagiCode',
+    docsLabel: '閱讀文件',
+    galleryHeading: '一覽 HagiCode',
+    gallery: [
+        {
+            id: 'workbench',
+            caption: '工作台：所有工作階段集中在同一塊看板上。',
+            alt: workbenchAlt,
+        },
+        {
+            id: 'proposal-workflow',
+            caption: '提案從建立、起草、審查一路推進到執行與封存。',
+            alt: 'HagiCode 提案階段列畫面，從已建立到已封存，目前標示「執行完成」階段並附有封存計畫按鈕。',
+        },
+        {
+            id: 'heroes',
+            caption: 'Hero Scenario：英雄推進工作，你隨時查看進度、等級與劇情。',
+            alt: 'HagiCode Hero Scenario 面板畫面，名為 Ember Keep，列出三位執行中的英雄及其等級、進度與劇情文字。',
+        },
+        {
+            id: 'hero-avatar',
+            caption: '插圖：HagiCode 英雄頭像，是同一套頭像中的一幅，每次造訪會換一幅。',
+            alt: 'HagiCode 英雄頭像插圖，風格化的角色肖像。',
+        },
+    ],
+    windowsLabel: '下載 Windows 版',
+    windowsStoreLabel: '從 Microsoft Store 取得',
+    windowsStoreAriaLabel: '在 Microsoft Store 開啟 HagiCode',
+    allDownloadsLabel: '所有下載',
+    shareLabel: '分享 HagiCode',
+    shareText: 'HagiCode 透過豐富、便利的介面互動，讓規劃、Agent 執行與專案工作更容易上手和跟進：https://www.hagicode.com/',
+};

package/dist/article-promotion.d.ts

@@ -0,0 +1,40 @@
+import { COPY } from './article-promotion-copy/index.js';
+export interface ArticlePromotionFeature {
+    id: 'smart' | 'efficient' | 'fun';
+    /** Localized pillar word. */
+    label: string;
+    description: string;
+}
+export interface ArticlePromotionGalleryItem {
+    /** Matches an entry in `assets/showcase/manifest.json`. */
+    id: string;
+    caption: string;
+    alt: string;
+}
+export interface ArticlePromotionCopy {
+    title: string;
+    lead: string;
+    subheadline: string;
+    /** Text alternative of the lead gallery image. */
+    imageAlt: string;
+    features: readonly ArticlePromotionFeature[];
+    visitLabel: string;
+    /** Secondary call to action. */
+    docsLabel: string;
+    galleryHeading: string;
+    gallery: readonly ArticlePromotionGalleryItem[];
+    /** Visible caption beside the Windows download button. */
+    windowsLabel: string;
+    /** Text of the static fallback link to the Microsoft Store listing. */
+    windowsStoreLabel: string;
+    /** Accessible name and tooltip for the Microsoft Store badge and its fallback link. */
+    windowsStoreAriaLabel: string;
+    /** Link to the all-platforms downloads page. */
+    allDownloadsLabel: string;
+    shareLabel: string;
+    /** One sentence ending with the website address. */
+    shareText: string;
+}
+export { COPY };
+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,14 @@
+import { COPY } from './article-promotion-copy/index.js';
+export { COPY };
+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,105 @@
+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 HagilightPromotionOptions extends HagilightToggleOptions {
+    /** Swap the showcase illustration for one random pool entry per page view. Defaults to `true`. */
+    randomAvatar?: boolean;
+}
+export interface HagilightFooterOptions {
+    /** Show the decorative avatar in the footer brand block. Defaults to `true`. */
+    avatar?: boolean;
+    /** Swap the footer avatar for one random pool entry per page view. Defaults to `true`. */
+    randomAvatar?: 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;
+    posthog?: HagilightPostHogOptions;
+}
+export interface HagilightPostHogOptions {
+    /** Defaults to true when the provider options are omitted, otherwise to whether apiKey is set. */
+    enabled?: boolean;
+    apiKey?: string;
+}
+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 HagilightThemesOptions {
+    /**
+     * Replace Starlight's light/dark picker with the Hagilight theme picker: four themes
+     * (the default plus Ocean, Sakura, and Forest) in light and dark, plus a "default"
+     * choice that follows the system color scheme and renders the Forest theme, so
+     * first-visit users see Forest until they pick another theme.
+     * Defaults to `true`.
+     */
+    enabled?: boolean;
+}
+export interface HagilightContentComponentsOptions {
+    pageTitle?: boolean;
+    markdownContent?: boolean;
+}
+export type HagilightAIDisclosureOptions = Partial<AIDisclosureDefaults>;
+export interface HagilightMetadataOptions {
+    /** Defaults to `true`. */
+    enabled?: boolean;
+    /** Site name. Defaults to the Starlight `title` for the default locale, then the site hostname. */
+    name?: string;
+    /** Site description. Defaults to the Starlight `description` when the site sets one. */
+    description?: string;
+}
+export interface HagilightStarlightOptions {
+    /**
+     * Generate `/.well-known/hagilight.metadata.json` after the build. Defaults to `true`; `false`
+     * opts out, and an options object may set `name` and `description`. A site-provided file is
+     * never overwritten. When a plain-Astro `hagilight()` is also registered, this plugin writes
+     * the file and the plain-Astro integration defers to it.
+     */
+    metadata?: boolean | HagilightMetadataOptions;
+    header?: HagilightToggleOptions;
+    notFoundPage?: HagilightToggleOptions;
+    rss?: HagilightRssOptions;
+    analytics?: HagilightAnalyticsOptions;
+    seo?: HagilightSeoOptions;
+    contentComponents?: HagilightContentComponentsOptions;
+    aiDisclosures?: HagilightAIDisclosureOptions;
+    /** Theme picker with three extra light/dark themes and a Forest first-visit default. */
+    themes?: HagilightThemesOptions;
+    /** Footer brand block options: the decorative avatar and its random pool. */
+    footer?: HagilightFooterOptions;
+    /** End-of-article HagiCode introduction. */
+    hagicodePromotion?: HagilightPromotionOptions;
+    /** Floating promotion banner rendered after the footer. */
+    promoto?: HagilightToggleOptions;
+    /** Body-image baseline (`loading`, `decoding`, marker class) for Markdown and MDX. Defaults to enabled. */
+    contentImages?: 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;