@hagicode/hagilight-docusaurus 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,91 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { fiftyOneLaHeadTags, googleAnalyticsHeadTags } from './analytics.js';
+import { collectFeedItems, feedHeadTags, writeDiscoveryOutputs } from './discovery.js';
+import { PLUGIN_NAME } from './global-data.js';
+import { resolveOptions } from './options.js';
+import { seoHeadTags } from './seo.js';
+import { findConfigurationWarnings } from './warnings.js';
+export { PLUGIN_NAME };
+const PACKAGE_VERSION = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+function packageFile(relativePath) {
+    return fileURLToPath(new URL(relativePath, import.meta.url));
+}
+function analyticsHeadTags(options) {
+    if (process.env.NODE_ENV !== 'production')
+        return [];
+    return [
+        ...(options.googleAnalyticsId === undefined ? [] : googleAnalyticsHeadTags(options.googleAnalyticsId)),
+        ...(options.fiftyOneLaId === undefined ? [] : fiftyOneLaHeadTags(options.fiftyOneLaId)),
+    ];
+}
+function clientModules(options) {
+    const analyticsEnabled = options.googleAnalyticsId !== undefined || options.fiftyOneLaId !== undefined;
+    return [
+        ...(analyticsEnabled ? [packageFile('./client/analytics.js')] : []),
+        ...(options.promoto ? [packageFile('./client/promoto.js'), packageFile('../promoto.css')] : []),
+        ...(options.footer ? [packageFile('../styles.css')] : []),
+    ];
+}
+function createPlugin(context, options) {
+    for (const warning of findConfigurationWarnings(context, options)) {
+        console.warn(`[${PLUGIN_NAME}] ${warning}`);
+    }
+    const globalData = {
+        version: PACKAGE_VERSION,
+        options,
+        i18n: context.i18n,
+    };
+    const themeEnabled = options.footer || options.seo.enabled;
+    const site = {
+        title: context.siteConfig.title,
+        tagline: context.siteConfig.tagline,
+        url: context.siteConfig.url,
+        baseUrl: context.siteConfig.baseUrl,
+        siteDir: context.siteDir,
+        i18n: context.i18n,
+    };
+    const report = {
+        warn: (message) => console.warn(`[${PLUGIN_NAME}] ${message}`),
+        info: (message) => console.info(`[${PLUGIN_NAME}] ${message}`),
+    };
+    let feedItems = [];
+    return {
+        name: PLUGIN_NAME,
+        ...(themeEnabled ? { getThemePath: () => packageFile('./theme') } : {}),
+        getClientModules: () => clientModules(options),
+        contentLoaded({ actions }) {
+            actions.setGlobalData(globalData);
+        },
+        allContentLoaded({ allContent }) {
+            feedItems = collectFeedItems(allContent, site, options.rss, report);
+        },
+        async postBuild(props) {
+            await writeDiscoveryOutputs({
+                options,
+                site,
+                outDir: props.outDir,
+                production: process.env.NODE_ENV === 'production',
+                plugins: props.plugins,
+                routesPaths: props.routesPaths,
+                routesBuildMetadata: props.routesBuildMetadata,
+                feedItems,
+                report,
+            });
+        },
+        injectHtmlTags() {
+            return {
+                headTags: [
+                    ...analyticsHeadTags(options),
+                    ...seoHeadTags(options.seo, site),
+                    ...feedHeadTags(site, options.rss, feedItems.length),
+                ],
+            };
+        },
+    };
+}
+export function hagilightDocusaurus(options) {
+    const resolved = resolveOptions(options);
+    return (context) => createPlugin(context, resolved);
+}
+export default hagilightDocusaurus;

package/dist/locales.d.ts

@@ -0,0 +1,5 @@
+import type { I18nConfig } from '@docusaurus/types';
+export declare const defaultLocale = "en-US";
+export declare const localeConfigs: NonNullable<I18nConfig['localeConfigs']>;
+export declare const locales: [string, ...string[]];
+export declare const i18n: I18nConfig;

package/dist/locales.js

@@ -0,0 +1,20 @@
+export const defaultLocale = 'en-US';
+export const localeConfigs = {
+    'en-US': { label: 'English', htmlLang: 'en-US', direction: 'ltr' },
+    'zh-CN': { label: '简体中文', htmlLang: 'zh-CN', direction: 'ltr' },
+    'zh-Hant': { label: '繁體中文', htmlLang: 'zh-Hant', direction: 'ltr' },
+    'fr-FR': { label: 'Français', htmlLang: 'fr-FR', direction: 'ltr' },
+    'de-DE': { label: 'Deutsch', htmlLang: 'de-DE', direction: 'ltr' },
+    'es-ES': { label: 'Español (España)', htmlLang: 'es-ES', direction: 'ltr' },
+    'ja-JP': { label: '日本語', htmlLang: 'ja-JP', direction: 'ltr' },
+    'ko-KR': { label: '한국어', htmlLang: 'ko-KR', direction: 'ltr' },
+    'pt-BR': { label: 'Português (Brasil)', htmlLang: 'pt-BR', direction: 'ltr' },
+    'ru-RU': { label: 'Русский', htmlLang: 'ru-RU', direction: 'ltr' },
+};
+export const locales = [defaultLocale, ...Object.keys(localeConfigs).filter((locale) => locale !== defaultLocale)];
+export const i18n = {
+    defaultLocale,
+    locales,
+    path: 'i18n',
+    localeConfigs,
+};

package/dist/options.d.ts

@@ -0,0 +1,63 @@
+import type { SiteLinksOptions } from '@hagicode/hagilight-core/links';
+export interface FeatureToggle {
+    enabled?: boolean;
+}
+export interface GoogleAnalyticsOptions extends FeatureToggle {
+    measurementId?: string;
+}
+export interface FiftyOneLaOptions extends FeatureToggle {
+    siteId?: string;
+}
+export interface AnalyticsOptions {
+    googleAnalytics?: GoogleAnalyticsOptions;
+    fiftyOneLa?: FiftyOneLaOptions;
+}
+export interface SeoOrganizationOptions {
+    name?: string;
+    url?: string;
+    logo?: string;
+}
+export interface SeoOptions extends FeatureToggle {
+    image?: string;
+    organization?: SeoOrganizationOptions;
+}
+export interface RssOptions extends FeatureToggle {
+    includeDocs?: boolean;
+    includeBlog?: boolean;
+}
+export interface HagilightDocusaurusOptions {
+    footer?: FeatureToggle;
+    links?: SiteLinksOptions;
+    analytics?: AnalyticsOptions;
+    promoto?: FeatureToggle;
+    languageSelector?: FeatureToggle;
+    seo?: SeoOptions;
+    sitemap?: FeatureToggle;
+    robots?: FeatureToggle;
+    rss?: RssOptions;
+    noIndex?: boolean;
+}
+export interface ResolvedSeoOptions {
+    enabled: boolean;
+    image: string | undefined;
+    organization: SeoOrganizationOptions;
+}
+export interface ResolvedRssOptions {
+    enabled: boolean;
+    includeDocs: boolean;
+    includeBlog: boolean;
+}
+export interface ResolvedHagilightOptions {
+    footer: boolean;
+    links: SiteLinksOptions;
+    googleAnalyticsId: string | undefined;
+    fiftyOneLaId: string | undefined;
+    promoto: boolean;
+    languageSelector: boolean;
+    seo: ResolvedSeoOptions;
+    sitemap: boolean;
+    robots: boolean;
+    rss: ResolvedRssOptions;
+    noIndex: boolean;
+}
+export declare function resolveOptions(input: HagilightDocusaurusOptions | undefined): ResolvedHagilightOptions;

package/dist/options.js

@@ -0,0 +1,101 @@
+import { isValidSeoImageReference, resolveAbsoluteHttpUrl } from '@hagicode/hagilight-core/seo';
+import { DEFAULT_FIFTY_ONE_LA_ID, DEFAULT_GOOGLE_ANALYTICS_ID, FIFTY_ONE_LA_ID_PATTERN, GOOGLE_ANALYTICS_ID_PATTERN, } from './analytics.js';
+function invalid(path, reason) {
+    return new TypeError(`@hagicode/hagilight-docusaurus option "${path}" ${reason}.`);
+}
+function objectOption(value, path) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+        throw invalid(path, 'must be an object');
+    }
+    return value;
+}
+function booleanOption(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'boolean')
+        throw invalid(path, 'must be a boolean');
+    return value;
+}
+function nonEmptyStringOption(value, path) {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || !value.trim())
+        throw invalid(path, 'must be a non-empty string');
+    return value;
+}
+function featureEnabled(value, path) {
+    if (value === undefined)
+        return true;
+    return booleanOption(objectOption(value, path).enabled, `${path}.enabled`) ?? true;
+}
+function resolveProvider(value, path, idKey, pattern, defaultId) {
+    if (value === undefined)
+        return defaultId;
+    const group = objectOption(value, path);
+    const enabled = booleanOption(group.enabled, `${path}.enabled`) ?? Boolean(group[idKey]);
+    if (!enabled)
+        return undefined;
+    const id = group[idKey];
+    const idPath = `${path}.${idKey}`;
+    if (typeof id !== 'string' || !id.trim()) {
+        throw invalid(idPath, 'is required while the provider is enabled');
+    }
+    if (!pattern.test(id)) {
+        throw invalid(idPath, 'has an invalid format');
+    }
+    return id;
+}
+function absoluteHttpUrlOption(value, path) {
+    try {
+        return resolveAbsoluteHttpUrl(value, path).href;
+    }
+    catch {
+        throw invalid(path, 'must be an absolute HTTP(S) URL');
+    }
+}
+function resolveSeo(value) {
+    const group = value === undefined ? {} : objectOption(value, 'seo');
+    const enabled = booleanOption(group.enabled, 'seo.enabled') ?? true;
+    const image = nonEmptyStringOption(group.image, 'seo.image');
+    if (image !== undefined && !isValidSeoImageReference(image)) {
+        throw invalid('seo.image', 'must be an absolute HTTP(S) URL or a site-root path');
+    }
+    const organization = {};
+    if (group.organization !== undefined) {
+        const org = objectOption(group.organization, 'seo.organization');
+        const name = nonEmptyStringOption(org.name, 'seo.organization.name');
+        if (name !== undefined)
+            organization.name = name;
+        if (org.url !== undefined)
+            organization.url = absoluteHttpUrlOption(org.url, 'seo.organization.url');
+        const logo = nonEmptyStringOption(org.logo, 'seo.organization.logo');
+        if (logo !== undefined)
+            organization.logo = absoluteHttpUrlOption(logo, 'seo.organization.logo');
+    }
+    return { enabled, image, organization };
+}
+function resolveRss(value) {
+    const group = value === undefined ? {} : objectOption(value, 'rss');
+    return {
+        enabled: booleanOption(group.enabled, 'rss.enabled') ?? true,
+        includeDocs: booleanOption(group.includeDocs, 'rss.includeDocs') ?? true,
+        includeBlog: booleanOption(group.includeBlog, 'rss.includeBlog') ?? true,
+    };
+}
+export function resolveOptions(input) {
+    const options = input === undefined ? {} : objectOption(input, 'options');
+    const analytics = options.analytics === undefined ? {} : objectOption(options.analytics, 'analytics');
+    return {
+        footer: featureEnabled(options.footer, 'footer'),
+        links: options.links === undefined ? {} : objectOption(options.links, 'links'),
+        googleAnalyticsId: resolveProvider(analytics.googleAnalytics, 'analytics.googleAnalytics', 'measurementId', GOOGLE_ANALYTICS_ID_PATTERN, DEFAULT_GOOGLE_ANALYTICS_ID),
+        fiftyOneLaId: resolveProvider(analytics.fiftyOneLa, 'analytics.fiftyOneLa', 'siteId', FIFTY_ONE_LA_ID_PATTERN, DEFAULT_FIFTY_ONE_LA_ID),
+        promoto: featureEnabled(options.promoto, 'promoto'),
+        languageSelector: featureEnabled(options.languageSelector, 'languageSelector'),
+        seo: resolveSeo(options.seo),
+        sitemap: featureEnabled(options.sitemap, 'sitemap'),
+        robots: featureEnabled(options.robots, 'robots'),
+        rss: resolveRss(options.rss),
+        noIndex: booleanOption(options.noIndex, 'noIndex') ?? false,
+    };
+}

package/dist/seo.d.ts

@@ -0,0 +1,14 @@
+import type { HtmlTagObject } from '@docusaurus/types';
+import type { ResolvedSeoOptions } from './options.js';
+export interface SeoSite {
+    title: string;
+    url: string;
+    baseUrl: string;
+}
+export declare function resolveSharingImage(image: string | undefined, site: Pick<SeoSite, 'url' | 'baseUrl'>): string | undefined;
+export interface SharingMetadataValues {
+    siteName: string;
+    image: string | undefined;
+}
+export declare function sharingMetadataFor(seo: ResolvedSeoOptions, site: Pick<SeoSite, 'title' | 'url' | 'baseUrl'>, themeImage: string | undefined): SharingMetadataValues | undefined;
+export declare function seoHeadTags(seo: ResolvedSeoOptions, site: SeoSite): HtmlTagObject[];

package/dist/seo.js

@@ -0,0 +1,32 @@
+import { buildOrganizationStructuredData, resolveSeoImageUrl, serializeJsonLd } from '@hagicode/hagilight-core/seo';
+export function resolveSharingImage(image, site) {
+    return image === undefined ? undefined : resolveSeoImageUrl(image, { site: site.url, basePath: site.baseUrl });
+}
+export function sharingMetadataFor(seo, site, themeImage) {
+    if (!seo.enabled)
+        return undefined;
+    return {
+        siteName: site.title,
+        image: themeImage === undefined ? resolveSharingImage(seo.image, site) : undefined,
+    };
+}
+export function seoHeadTags(seo, site) {
+    if (!seo.enabled)
+        return [];
+    const organization = buildOrganizationStructuredData({
+        name: seo.organization.name ?? site.title,
+        url: seo.organization.url ?? site.url,
+        ...(seo.organization.logo === undefined ? {} : { logo: seo.organization.logo }),
+    });
+    const website = {
+        '@context': 'https://schema.org',
+        '@type': 'WebSite',
+        name: site.title,
+        url: new URL(site.baseUrl, site.url).href,
+    };
+    return [organization, website].map((data) => ({
+        tagName: 'script',
+        attributes: { type: 'application/ld+json' },
+        innerHTML: serializeJsonLd(data),
+    }));
+}

package/dist/theme/Footer/FooterView.d.ts

@@ -0,0 +1,8 @@
+import type { ReactElement } from 'react';
+import type { FooterLinks } from '../../footer.js';
+export interface FooterViewProps {
+    links: FooterLinks;
+    version: string;
+    year: number;
+}
+export declare function FooterView({ links, version, year }: FooterViewProps): ReactElement;

package/dist/theme/Footer/FooterView.js

@@ -0,0 +1,9 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { siteLinkGaAttributes } from '@hagicode/hagilight-core/analytics-events';
+function LinkSection({ heading, navLabel, links, tagged }) {
+    return (_jsxs("section", { children: [_jsx("h2", { children: heading }), _jsx("nav", { "aria-label": navLabel, children: _jsx("ul", { children: links.map((link) => (_jsx("li", { children: _jsx("a", { href: link.href, target: link.target, rel: link.rel, "aria-label": link.ariaLabel, ...(tagged ? siteLinkGaAttributes(link, 'footer') : {}), children: link.label }) }, link.id))) }) })] }));
+}
+export function FooterView({ links, version, year }) {
+    const { labels } = links;
+    return (_jsxs("footer", { className: "hagilight-footer", children: [_jsxs("div", { className: "hagilight-footer__sections", children: [links.relatedSites.length > 0 && (_jsxs("section", { children: [_jsx("h2", { children: labels.relatedSites }), _jsx("nav", { "aria-label": labels.navigation.relatedSites, children: _jsx("ul", { children: links.relatedSites.map((site) => (_jsx("li", { children: _jsx("a", { href: site.href, target: site.target, rel: site.rel, children: site.name }) }, site.id))) }) })] })), _jsx(LinkSection, { heading: labels.quickLinks, navLabel: labels.navigation.quickLinks, links: links.quick, tagged: true }), _jsx(LinkSection, { heading: labels.community, navLabel: labels.navigation.community, links: links.community, tagged: true })] }), links.filings.length > 0 && (_jsx("nav", { className: "hagilight-footer__filings", "aria-label": labels.navigation.filings, children: links.filings.map((link) => (_jsx("a", { href: link.href, target: link.target, rel: link.rel, "aria-label": link.ariaLabel, children: link.label }, link.id))) })), _jsxs("p", { className: "hagilight-footer__copyright", children: [_jsxs("span", { children: ["\u00A9 ", year, " HagiCode"] }), ' | ', _jsxs("span", { className: "hagilight-footer__attribution", children: ["Powered By hagilight-docusaurus@", version] })] })] }));
+}

package/dist/theme/Footer/index.d.ts

@@ -0,0 +1,2 @@
+import type { ReactElement } from 'react';
+export default function Footer(): ReactElement;

package/dist/theme/Footer/index.js

@@ -0,0 +1,20 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import FooterDefaults from '@theme-init/Footer';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import { usePluginData } from '@docusaurus/useGlobalData';
+import { resolveFooterLinks } from '../../footer.js';
+import { PLUGIN_NAME } from '../../global-data.js';
+import { FooterView } from './FooterView.js';
+export default function Footer() {
+    const { i18n, siteConfig } = useDocusaurusContext();
+    const { version, options } = usePluginData(PLUGIN_NAME);
+    if (!options.footer)
+        return _jsx(FooterDefaults, {});
+    const links = resolveFooterLinks({
+        locale: i18n.currentLocale,
+        baseUrl: siteConfig.baseUrl,
+        links: options.links,
+        rssEnabled: options.rss.enabled,
+    });
+    return _jsx(FooterView, { links: links, version: version, year: new Date().getFullYear() });
+}

package/dist/theme/SiteMetadata/SharingMetadata.d.ts

@@ -0,0 +1,8 @@
+import type { Props as HeadProps } from '@docusaurus/Head';
+import type { ReactElement, ReactNode } from 'react';
+export interface SharingMetadataProps {
+    Head: (props: HeadProps) => ReactNode;
+    siteName: string;
+    image: string | undefined;
+}
+export declare function SharingMetadata({ Head, siteName, image }: SharingMetadataProps): ReactElement;

package/dist/theme/SiteMetadata/SharingMetadata.js

@@ -0,0 +1,4 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+export function SharingMetadata({ Head, siteName, image }) {
+    return (_jsxs(Head, { children: [_jsx("meta", { property: "og:site_name", content: siteName }), image !== undefined && _jsx("meta", { property: "og:image", content: image }), image !== undefined && _jsx("meta", { name: "twitter:image", content: image })] }));
+}

package/dist/theme/SiteMetadata/index.d.ts

@@ -0,0 +1,2 @@
+import type { ReactElement } from 'react';
+export default function SiteMetadata(): ReactElement;

package/dist/theme/SiteMetadata/index.js

@@ -0,0 +1,15 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import Head from '@docusaurus/Head';
+import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
+import { usePluginData } from '@docusaurus/useGlobalData';
+import ClassicSiteMetadata from '@docusaurus/theme-classic/lib/theme/SiteMetadata/index.js';
+import { PLUGIN_NAME } from '../../global-data.js';
+import { sharingMetadataFor } from '../../seo.js';
+import { SharingMetadata } from './SharingMetadata.js';
+export default function SiteMetadata() {
+    const { siteConfig } = useDocusaurusContext();
+    const { options } = usePluginData(PLUGIN_NAME);
+    const themeImage = siteConfig.themeConfig?.image;
+    const sharing = sharingMetadataFor(options.seo, siteConfig, typeof themeImage === 'string' ? themeImage : undefined);
+    return (_jsxs(_Fragment, { children: [sharing !== undefined && _jsx(SharingMetadata, { Head: Head, ...sharing }), _jsx(ClassicSiteMetadata, {})] }));
+}

package/dist/warnings.d.ts

@@ -0,0 +1,4 @@
+import type { LoadContext } from '@docusaurus/types';
+import type { ResolvedHagilightOptions } from './options.js';
+export declare function siteOwnsThemeComponent(siteDir: string, name: string): boolean;
+export declare function findConfigurationWarnings(context: Pick<LoadContext, 'siteDir' | 'siteConfig' | 'i18n'>, options: ResolvedHagilightOptions): string[];

package/dist/warnings.js

@@ -0,0 +1,70 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { locales as catalogLocales } from './locales.js';
+const THEME_EXTENSIONS = ['tsx', 'ts', 'jsx', 'js'];
+const GTAG_PLUGIN = '@docusaurus/plugin-google-gtag';
+const CLASSIC_PRESET = '@docusaurus/preset-classic';
+const CATALOG_LOCALES = new Set(catalogLocales);
+export function siteOwnsThemeComponent(siteDir, name) {
+    const themeDir = join(siteDir, 'src', 'theme');
+    return THEME_EXTENSIONS.some((ext) => existsSync(join(themeDir, name, `index.${ext}`)) || existsSync(join(themeDir, `${name}.${ext}`)));
+}
+function entryName(entry) {
+    if (typeof entry === 'string')
+        return entry;
+    if (Array.isArray(entry) && typeof entry[0] === 'string')
+        return entry[0];
+    return undefined;
+}
+function entryOptions(entry) {
+    if (!Array.isArray(entry))
+        return undefined;
+    const options = entry[1];
+    return typeof options === 'object' && options !== null ? options : undefined;
+}
+function hasPluginEntry(entries, name) {
+    return Array.isArray(entries) && entries.some((entry) => entryName(entry) === name);
+}
+function hasLocaleDropdown(themeConfig) {
+    const navbar = themeConfig.navbar;
+    if (typeof navbar !== 'object' || navbar === null)
+        return false;
+    const items = navbar.items;
+    return Array.isArray(items) && items.some((item) => item?.type === 'localeDropdown');
+}
+function officialGtagConfigured(siteConfig) {
+    const raw = siteConfig;
+    if (hasPluginEntry(raw.plugins, GTAG_PLUGIN))
+        return true;
+    return Array.isArray(raw.presets)
+        && raw.presets.some((preset) => entryName(preset) === CLASSIC_PRESET && entryOptions(preset)?.gtag !== undefined);
+}
+export function findConfigurationWarnings(context, options) {
+    const warnings = [];
+    const themeConfig = (context.siteConfig.themeConfig ?? {});
+    if (options.languageSelector && context.i18n.locales.length > 1) {
+        if (!hasLocaleDropdown(themeConfig)) {
+            warnings.push("Several locales are configured but themeConfig.navbar.items has no localeDropdown item, so visitors cannot switch language. Add { type: 'localeDropdown' } or set languageSelector: { enabled: false }.");
+        }
+        const nonCatalog = context.i18n.locales.filter((locale) => !CATALOG_LOCALES.has(locale));
+        if (nonCatalog.length > 0) {
+            warnings.push(`${nonCatalog.join(', ')} ${nonCatalog.length === 1 ? 'is' : 'are'} not in the Hagilight locale catalog, so its native label and lang value are not checked against the Starlight locales. Use catalog locales or set languageSelector: { enabled: false }.`);
+        }
+    }
+    if (options.footer && siteOwnsThemeComponent(context.siteDir, 'Footer')) {
+        warnings.push('src/theme/Footer replaces the Hagilight footer. Remove the site Footer component or set footer: { enabled: false } to keep one footer.');
+    }
+    if (options.seo.enabled && siteOwnsThemeComponent(context.siteDir, 'SiteMetadata')) {
+        warnings.push('src/theme/SiteMetadata replaces the Hagilight sharing-image fallback. Remove the site component or set seo: { enabled: false }; the Organization and WebSite JSON-LD are still emitted.');
+    }
+    if (options.seo.enabled && options.seo.image === undefined && themeConfig.image === undefined) {
+        warnings.push('Neither themeConfig.image nor seo.image is set, so pages without their own image get no default sharing image. Set one of them, or set seo: { enabled: false }.');
+    }
+    if (options.footer && themeConfig.footer !== undefined) {
+        warnings.push('themeConfig.footer is ignored by the Hagilight footer. Move its links into the links option or set footer: { enabled: false }.');
+    }
+    if (options.googleAnalyticsId !== undefined && (themeConfig.gtag !== undefined || officialGtagConfigured(context.siteConfig))) {
+        warnings.push('Google Analytics would load twice: the site already configures gtag. Remove themeConfig.gtag or the official gtag plugin, or set analytics.googleAnalytics: { enabled: false }.');
+    }
+    return warnings;
+}

package/package.json

@@ -1,6 +1,68 @@
 {
   "name": "@hagicode/hagilight-docusaurus",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Docusaurus plugin for HagiCode site features: footer, analytics, promote card, locales, SEO, sitemap, robots.txt, and RSS",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HagiCode-org/hagilight.git",
+    "directory": "packages/docusaurus"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "prepack": "tsc -b"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./locales": {
+      "types": "./dist/locales.d.ts",
+      "default": "./dist/locales.js"
+    }
+  },
+  "files": [
+    "README.md",
+    "styles.css",
+    "promoto.css",
+    "dist/**/*.js",
+    "dist/**/*.d.ts"
+  ],
+  "dependencies": {
+    "@docusaurus/types": "^3.9.2",
+    "@hagicode/hagilight-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/theme-classic": "^3.9.2",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@docusaurus/core": "^3.9.2",
+    "@docusaurus/module-type-aliases": "^3.9.2",
+    "@docusaurus/theme-classic": "^3.9.2",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-helmet-async": "^3.0.0"
+  },
+  "keywords": [
+    "docusaurus",
+    "docusaurus-plugin",
+    "multilingual-documentation",
+    "hreflang",
+    "structured-data",
+    "rss",
+    "sitemap"
+  ]
+}