@hagicode/hagilight-starlight 0.18.0 → 0.19.1-dev.185.1.a85e2a8

package/ArticlePromotion.astro

@@ -1,6 +1,6 @@
 ---
 import { gaEventAttributes } from '@hagicode/hagilight-core/analytics-events';
-import { resolveSiteLinks } from '@hagicode/hagilight-core/links';
+import { resolveSiteLinks, withCampaignUtm } from '@hagicode/hagilight-core/links';
 import { getArticlePromotionCopy } from './dist/article-promotion.js';
 import { randomPoolAttribute, randomPoolFromManifest } from '@hagicode/hagilight-core/random-image';
 import {
@@ -19,16 +19,26 @@ interface Props {
   lang?: string;
   /** Deal the illustration as a fan of random cat heads, like the footer avatar. Defaults to `true`. */
   randomAvatar?: boolean;
+  /** Identifies the hosting site in campaign tags; without it the call-to-action links stay untagged. */
+  siteId?: string;
 }
 
-const { lang, randomAvatar = true } = Astro.props;
+const { lang, randomAvatar = true, siteId } = Astro.props;
 if (typeof randomAvatar !== 'boolean') throw new TypeError('Hagilight hagicodePromotion randomAvatar option must be a boolean.');
 const copy = getArticlePromotionCopy(lang);
 const siteLinks = resolveSiteLinks(lang);
 const linkHref = (id: string, fallback: string) =>
   [...siteLinks.header, ...siteLinks.quick].find((link) => link.id === id)?.href ?? fallback;
-const homeHref = linkHref('home', 'https://www.hagicode.com/');
-const docsHref = linkHref('productDocs', 'https://docs.hagicode.com/');
+// The campaign is the link's stable id; the Store badge is third-party and is not tagged.
+const taggedHref = (id: string, fallback: string) => withCampaignUtm(linkHref(id, fallback), {
+  siteId,
+  medium: 'article',
+  campaign: id,
+  content: 'article_promotion',
+  origin: Astro.site?.origin,
+});
+const homeHref = taggedHref('home', 'https://www.hagicode.com/');
+const docsHref = taggedHref('productDocs', 'https://docs.hagicode.com/');
 const storeHref = linkHref('microsoftStore', 'https://apps.microsoft.com/detail/9N3PM0N3SVDW');
 const downloadsHref = linkHref('downloadClient', 'https://www.hagicode.com/');
 const storeProductId = resolveMicrosoftStoreProductId(storeHref);

package/ContentLayoutToggle.astro

@@ -19,12 +19,14 @@ const labels = getContentWidthLabels(lang);
     setContentWidth,
     synchronizeContentWidthFromStorage,
   } from './dist/content-width.js';
+  import { capturePostHogEvent } from '@hagicode/hagilight-core/posthog-events';
 
   const root = document.documentElement;
   restoreContentWidth(root);
   document.querySelectorAll('[data-hagilight-content-width-choice]').forEach((button) => {
     button.addEventListener('click', () => {
       setContentWidth(button.dataset.hagilightContentWidthChoice, root);
+      capturePostHogEvent('content_width_changed', { choice: button.dataset.hagilightContentWidthChoice });
     });
   });
   window.addEventListener('storage', (event) => synchronizeContentWidthFromStorage(event, root));

package/Footer.astro

@@ -5,6 +5,7 @@ import DefaultFooter from '@astrojs/starlight/components/Footer.astro';
 import { siteLinkGaAttributes } from '@hagicode/hagilight-core/analytics-events';
 import { resolveSiteLinks, type SiteLinksOptions } from '@hagicode/hagilight-core/links';
 import { buildInfoItems, type BuildInfo } from '@hagicode/hagilight-core/build-info';
+import { resolveConsentCopy } from '@hagicode/hagilight-core/consent-copy';
 import manifest from './package.json';
 
 interface Props {
@@ -15,6 +16,8 @@ interface Props {
   buildInfo?: BuildInfo;
   avatar?: boolean;
   randomAvatar?: boolean;
+  /** Adds the "Cookie settings" entry. Set only when the site mounts the consent popup. Defaults to `false`. */
+  consent?: boolean;
 }
 
 const {
@@ -25,7 +28,9 @@ const {
   buildInfo,
   avatar,
   randomAvatar,
+  consent = false,
 } = Astro.props;
+const consentCopy = resolveConsentCopy(locale);
 const buildItems = buildInfoItems(buildInfo);
 if (typeof manifest.version !== 'string' || manifest.version.trim().length === 0) {
   throw new Error('@hagicode/hagilight-starlight requires a nonempty string version in its package.json.');
@@ -50,7 +55,7 @@ const resolvedLinks = resolveSiteLinks(currentLanguage ?? locale, {
 
 <DefaultFooter />
 <div class="hagilight-brand-host">
-  <FooterBrand locale={resolvedLinks.locale} links={resolvedLinks.quick} avatar={avatar} randomAvatar={randomAvatar} />
+  <FooterBrand locale={resolvedLinks.locale} links={resolvedLinks.quick} avatar={avatar} randomAvatar={randomAvatar} siteId={links?.siteId} siteUrl={links?.siteUrl ?? Astro.site?.href} />
 </div>
 <div class="hagilight-site-links">
   {resolvedLinks.relatedSites.length > 0 && (
@@ -112,6 +117,9 @@ const resolvedLinks = resolveSiteLinks(currentLanguage ?? locale, {
         aria-label={link.ariaLabel}
       >{link.label}</a>
     ))}
+    {consent && (
+      <button type="button" class="hagilight-consent-entry" data-consent-preferences>{consentCopy.footerEntry}</button>
+    )}
   </nav>
 </div>
 <p class="hagilight-copyright">
@@ -144,6 +152,8 @@ const resolvedLinks = resolveSiteLinks(currentLanguage ?? locale, {
     margin: 0 auto 1rem;
     max-width: 72rem;
     padding-inline: 1rem;
+    /* Keeps the last links scrollable clear of the consent popup; 0 when no popup is visible. */
+    padding-block-end: var(--hagilight-consent-clearance, 0px);
   }
 
   .hagilight-site-links section {
@@ -174,6 +184,17 @@ const resolvedLinks = resolveSiteLinks(currentLanguage ?? locale, {
     color: var(--sl-color-white);
   }
 
+  .hagilight-consent-entry {
+    margin: 0;
+    padding: 0;
+    border: 0;
+    background: none;
+    color: inherit;
+    font: inherit;
+    text-decoration: underline;
+    cursor: pointer;
+  }
+
   .hagilight-filings {
     grid-column: 1 / -1;
     display: flex;

package/LanguageChooser.astro

@@ -119,6 +119,7 @@ const navigationOptions = options.map((option) => ({
     getKeyboardTargetIndex,
     persistStarlightLocaleSelection,
   } from './dist/language-routing.js';
+  import { capturePostHogEvent } from '@hagicode/hagilight-core/posthog-events';
 
   class HagilightLanguageChooser extends HTMLElement {
     connectedCallback() {
@@ -176,6 +177,8 @@ const navigationOptions = options.map((option) => ({
           if (!locale || !href) return;
           closeDialog();
           if (option.getAttribute('aria-selected') === 'true') return;
+          // Sent before navigation: the capture uses sendBeacon, so it survives the page unloading.
+          capturePostHogEvent('locale_changed', { from: document.documentElement.lang, to: locale });
           persistStarlightLocaleSelection(locale);
           const target = new URL(href, window.location.origin);
           target.search = window.location.search;

package/MarkdownContent.astro

@@ -14,6 +14,7 @@ const {
   aiDisclosures = { isAITranslation: false, isAIAuthor: false, sourceLocale: 'root' },
   hagicodePromotionEnabled = true,
   hagicodePromotionRandomAvatar = true,
+  siteId,
 } = Astro.props;
 const route = Astro.locals.starlightRoute;
 const isDocsEntry = route.entry.id !== '404' && !route.entry.id.endsWith('/404');
@@ -42,4 +43,4 @@ if (showTranslation) {
 {flags.isAIAuthor && <AIDisclosureNotice kind="author" lang={route.lang} />}
 <DefaultMarkdownContent><slot /></DefaultMarkdownContent>
 {showTranslation && <AIDisclosureNotice kind="translation" lang={route.lang} sourceHref={sourceHref} />}
-{showHagicodePromotion && <ArticlePromotion lang={route.lang} randomAvatar={hagicodePromotionRandomAvatar} />}
+{showHagicodePromotion && <ArticlePromotion lang={route.lang} randomAvatar={hagicodePromotionRandomAvatar} siteId={siteId} />}

package/NotFoundHero.astro

@@ -19,7 +19,7 @@ const homeLabel = getNotFoundHomeLabel(route.lang);
 
 {
   isNotFound ? (
-    <div class="not-found-hero">
+    <div class="not-found-hero" data-hagilight-not-found>
       <DefaultHero />
       <div class="recovery-action">
         <a class="sl-link-button primary" href={homeHref}>{homeLabel}</a>
@@ -30,6 +30,18 @@ const homeLabel = getNotFoundHomeLabel(route.lang);
   )
 }
 
+<script>
+  import { capturePostHogEvent, referrerDomain } from '@hagicode/hagilight-core/posthog-events';
+
+  // Once per page view: the script runs once per load and only the not-found hero carries the marker.
+  if (document.querySelector('[data-hagilight-not-found]')) {
+    capturePostHogEvent('not_found_viewed', {
+      path: window.location.pathname,
+      referrer_domain: referrerDomain(document.referrer),
+    });
+  }
+</script>
+
 <style>
   .not-found-hero {
     display: flex;

package/PromotoFooter.astro

@@ -1,7 +1,14 @@
 ---
 import PromotoBanner from '@hagicode/hagilight-core/PromotoBanner';
 import Footer from './Footer.astro';
+
+interface Props {
+  /** Identifies the hosting site in campaign tags for the banner's call to action. */
+  siteId?: string;
+}
+
+const { siteId } = Astro.props;
 ---
 
 <Footer />
-<PromotoBanner />
+<PromotoBanner siteId={siteId} />

package/README.md

@@ -31,7 +31,7 @@ The plugin also exposes `@hagicode/hagilight-starlight/schema` for optional SEO
 
 ### Analytics
 
-`hagilight()` enables PostHog without analytics configuration, an enabled flag, or a consumer project key. It uses `phc_qiVVihsL925ovhPYNdLJWz4k7aoKVMwYCevgZPE6PER5`, API host `https://us.i.posthog.com`, and SDK defaults `2026-05-30`. Google Analytics and PostHog render together in the generated global Head; 51LA stays in the Footer. PostHog covers all production pages, including localized and 404 pages, independently of Google's existing 404 exclusion. Development pages emit no PostHog loader.
+`hagilight()` enables PostHog without analytics configuration, an enabled flag, or a consumer project key. It uses `phc_qiVVihsL925ovhPYNdLJWz4k7aoKVMwYCevgZPE6PER5`, API host `https://t.hagicode.com` (managed proxy), UI host `https://us.posthog.com`, person profiles `identified_only`, and SDK defaults `2026-05-30`. Sites with a strict script or connect policy must allow `t.hagicode.com`. Google Analytics and PostHog render together in the generated global Head; 51LA stays in the Footer. PostHog covers all production pages, including localized and 404 pages, independently of Google's existing 404 exclusion. Development pages emit no PostHog loader.
 
 PostHog options follow the Google Analytics provider convention:
 
@@ -43,6 +43,8 @@ PostHog options follow the Google Analytics provider convention:
 | `posthog: { enabled: true, apiKey: 'phc_Custom123' }` | Enabled with the custom key |
 | `posthog: { enabled: true }` | Configuration error: `apiKey` required |
 | `posthog: { enabled: false }` | Disabled independently of Google Analytics and 51LA |
+| `posthog: { searchQuery: 'zero-results' }` | Enabled with the default key; search text is sent only for searches with no results |
+| `posthog: { searchQuery: 'off' }` | Enabled with the default key; no search text in any event (the default) |
 
 Keys must match `^phc_[A-Za-z0-9]+$`; enabled providers reject missing or malformed keys. Provider options must be objects and `enabled` must be boolean.
 
@@ -64,8 +66,14 @@ hagilight({
 });
 ```
 
+`searchQuery` accepts `off` (default) or `zero-results`; any other value fails configuration with an error naming `analytics.posthog.searchQuery`. It never changes whether PostHog is enabled: an object that holds only `searchQuery` counts as omitted, so the default key stays on, while `{}` still disables it. Under `zero-results`, `search_used` carries `query` only when the search returned nothing and the text passes the secret and path filter; see the core README for the exact rules.
+
+The Starlight plugin emits every core event: `not_found_viewed` (404 page), `search_used`, `search_result_clicked` (Pagefind search), `code_copied`, `article_promotion_impression` (end-of-article card), `locale_changed` (language chooser), `locale_redirected` (root transit), and the optional `theme_changed` and `content_width_changed` (theme picker and content width toggle). Docusaurus has no Pagefind search, so it sends no search events, and it has no article promotion impression or theme and width events.
+
 The shared component initializes once per document; SDK defaults own PostHog navigation behavior. Choose one initialization owner and disable this provider when the site already initializes PostHog. Google Analytics and 51LA keep their configured behavior when PostHog is disabled.
 
+Each page registers its site context: `site_framework` `starlight`, the plugin version, `site_id` from `links.siteId` or the site URL's hostname, and a per-page `page_type` (splash pages are `home`, the not-found page is `404`, and other routes are derived from the path, defaulting to `other`). Marked links are captured as `cta_click` on every page that initializes PostHog, including the not-found page, whether or not Google Analytics is enabled.
+
 ### Theme picker
 
 By default the plugin replaces Starlight's light/dark toggle with a theme picker offering nine choices: the default theme plus the Ocean, Sakura, and Forest themes in light and dark, and a "Default" choice that follows the visitor's system color scheme and renders the Forest theme. First-time visitors, and visitors with an invalid saved choice, therefore see Forest; the other themes appear only after an explicit selection, which is remembered in `localStorage`.
@@ -171,8 +179,14 @@ The copy and assets mirror `repos/web` and `repos/docs` in the HagiCode monorepo
 - **Options:** `hagicodePromotion: { randomAvatar: false }` keeps the default illustration and loads no picker; `footer: { avatar: false }` removes the footer avatar, and `footer: { randomAvatar: false }` keeps its default. A site whose `img-src` policy blocks `https://img-gen.hagicode.com` keeps the defaults.
 - **Badge:** the product id is parsed from the Store URL and the badge language map lives in `src/windows-download.ts`. Re-check both against `repos/docs/src/components/MicrosoftStoreBadge.tsx` and the official site when the Store listing or the supported languages change.
 
+Direct `/PromotoFooter` takes an optional `siteId` prop and passes it to its banner, so the banner's call to action carries campaign tags. The plugin footer does this automatically from `links.siteId`.
+
 The plugin footer and direct `/Footer` and `/PromotoFooter` components append
 the literal `Powered By hagilight-starlight@<version>`. The version comes from
 this package's own manifest at build time, not from Astro or Starlight.
 
 See the [repository documentation](https://github.com/HagiCode-org/hagilight#readme) for schema setup and feature options.
+
+### Consent
+
+`analytics.consent` (`enabled`, `privacyUrl`, `policyVersion`) is on by default whenever a provider is enabled. The plugin mounts the popup through its generated Footer and Head, on every page including 404, and passes `consent` to the Google Analytics, 51LA and PostHog components. `enabled: false` restores immediate loading; invalid `privacyUrl` or `policyVersion` values fail with the option named. See the core README, "Analytics consent", for the storage names and rules.

package/ThemeSelect.astro

@@ -78,6 +78,7 @@ const groupOptionLabel = (prefix: string, choice: ThemeChoice): string =>
 
 <script>
   import { applyThemeChoice, parseThemeChoice, readStoredThemeChoice, type ThemeChoice } from './dist/themes.js';
+  import { capturePostHogEvent } from '@hagicode/hagilight-core/posthog-events';
 
   const modeClass = (choice: ThemeChoice): string =>
     choice.endsWith('-light') ? 'mode-light' : choice.endsWith('-dark') ? 'mode-dark' : 'mode-auto';
@@ -102,6 +103,7 @@ const groupOptionLabel = (prefix: string, choice: ThemeChoice): string =>
       select.addEventListener('change', () => {
         const choice = parseThemeChoice(select.value);
         applyThemeChoice(choice);
+        capturePostHogEvent('theme_changed', { theme: choice });
         sync(choice);
       });
 

package/dist/index.d.ts

@@ -31,12 +31,25 @@ export interface HagilightAnalyticsOptions {
     googleAnalytics?: HagilightGoogleAnalyticsOptions;
     fiftyOneLa?: HagilightFiftyOneLaOptions;
     posthog?: HagilightPostHogOptions;
+    consent?: HagilightConsentOptions;
+}
+export interface HagilightConsentOptions {
+    /** Defaults to on when any analytics provider is enabled. `false` restores immediate loading. */
+    enabled?: boolean;
+    /** An absolute HTTP(S) URL or a site-relative path. Omitted means the details have no privacy link. */
+    privacyUrl?: string;
+    /** Defaults to `1`. Changing it asks every visitor again. 1 to 32 letters, digits, dots, underscores or hyphens. */
+    policyVersion?: string;
 }
 export interface HagilightPostHogOptions {
     /** Defaults to true when the provider options are omitted, otherwise to whether apiKey is set. */
     enabled?: boolean;
     apiKey?: string;
+    /** `zero-results` sends the search text only for searches with no results. Defaults to `off`; never changes enablement. */
+    searchQuery?: PostHogSearchQueryOption;
 }
+declare const POSTHOG_SEARCH_QUERY_OPTIONS: readonly ["off", "zero-results"];
+export type PostHogSearchQueryOption = (typeof POSTHOG_SEARCH_QUERY_OPTIONS)[number];
 export interface HagilightSeoOptions {
     /** Replace Starlight's Head with Hagilight SEO metadata. Defaults to `true`; requires Astro `site`. */
     enabled?: boolean;
@@ -103,3 +116,4 @@ export interface HagilightStarlightOptions {
 }
 /** Starlight plugin that applies HagiCode header, footer, content, SEO, RSS, and analytics customizations. */
 export default function hagilight(options?: HagilightStarlightOptions): StarlightPlugin;
+export {};

package/dist/index.js

@@ -1,10 +1,12 @@
 import { randomUUID } from 'node:crypto';
+import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { resolveFaviconHeadEntry } from '@hagicode/hagilight-core/favicon';
 import { resolveBuildInfo } from '@hagicode/hagilight-core/build-info-resolver';
 import { resolveFooterAvatarOptions } from '@hagicode/hagilight-core/footer-avatar';
 import { checkContentImageRegistration, registerContentImages } from '@hagicode/hagilight-core/content-images';
 import { DEFAULT_POSTHOG_API_KEY, POSTHOG_API_KEY_PATTERN } from '@hagicode/hagilight-core/posthog';
+import { validatePolicyVersion, validatePrivacyUrl, } from '@hagicode/hagilight-core/consent-markup';
 import { resolveRssLocales } from '@hagicode/hagilight-core/rss';
 import { RSS_OWNER, registerStarlightRssOwner, } from '@hagicode/hagilight-core/rss-ownership';
 import { isValidSeoImageReference, resolveSeoImageUrl } from '@hagicode/hagilight-core/seo';
@@ -14,7 +16,9 @@ import { resolveRssOptions } from './rss-utils.js';
 import { resolveSeoLocales } from './seo-utils.js';
 import { createStarlightMetadataFinalizer } from './site-metadata.js';
 import { THEME_BOOTSTRAP } from './themes.js';
+const POSTHOG_SEARCH_QUERY_OPTIONS = ['off', 'zero-results'];
 const packageRoot = new URL('../', import.meta.url);
+const PACKAGE_VERSION = JSON.parse(readFileSync(new URL('package.json', packageRoot), 'utf8')).version;
 const packageFile = (name) => fileURLToPath(new URL(name, packageRoot));
 const coreExport = (name) => fileURLToPath(import.meta.resolve(`@hagicode/hagilight-core/${name}`));
 function isRecord(value) {
@@ -53,6 +57,37 @@ const contentWidthHeadScript = `(() => {
   }
   document.documentElement.dataset.hagilightContentWidth = mode;
 })();`;
+/**
+ * Consent is on by default whenever a provider is enabled, and `enabled: false` restores immediate loading. Invalid
+ * values throw from the core validators, which name the option.
+ */
+function resolveConsentOptions(config, providers) {
+    const record = optionalRecord(config, 'analytics consent');
+    const requested = optionalBoolean(record, 'enabled', 'analytics consent enabled');
+    return {
+        enabled: providers.length > 0 && (requested ?? true),
+        privacyUrl: validatePrivacyUrl(record?.privacyUrl),
+        policyVersion: validatePolicyVersion(record?.policyVersion),
+        providers,
+    };
+}
+function resolvePostHogSearchQuery(value) {
+    if (value === undefined)
+        return 'off';
+    if (POSTHOG_SEARCH_QUERY_OPTIONS.includes(value))
+        return value;
+    throw new TypeError('Hagilight analytics.posthog.searchQuery must be one of: off, zero-results.');
+}
+/**
+ * Removes `searchQuery` before provider resolution, because it never changes whether PostHog is enabled.
+ * An object that held only `searchQuery` therefore counts as omitted, so the default key stays on.
+ */
+function providerOptionsWithoutSearchQuery(config) {
+    if (!isRecord(config) || !Object.hasOwn(config, 'searchQuery'))
+        return config;
+    const { searchQuery: _searchQuery, ...rest } = config;
+    return Object.keys(rest).length === 0 ? undefined : rest;
+}
 function resolveProvider(config, { name, idKey, pattern, defaultId }) {
     if (config !== undefined && !isRecord(config)) {
         throw new TypeError(`Hagilight ${name} analytics options must be an object.`);
@@ -240,13 +275,22 @@ import options from '${optionsId}';
     const analyticsImport = serializedOptions.fiftyOneLaId
         ? `import Analytics51LA from ${JSON.stringify(coreExport('Analytics51LA'))};`
         : '';
+    // Consent-off sites keep their generated markup unchanged; the attribute appears only when the popup is mounted.
+    const consentAttribute = serializedOptions.consentEnabled ? ' consent={true}' : '';
     const analyticsRender = serializedOptions.fiftyOneLaId
-        ? '<Analytics51LA siteId={options.fiftyOneLaId} />'
+        ? `<Analytics51LA siteId={options.fiftyOneLaId}${consentAttribute} />`
+        : '';
+    const consentImport = serializedOptions.consentEnabled
+        ? `import CookieConsent from ${JSON.stringify(coreExport('CookieConsent'))};`
+        : '';
+    const consentRender = serializedOptions.consentEnabled
+        ? '<CookieConsent providers={options.consentProviders} privacyUrl={options.consentPrivacyUrl} policyVersion={options.consentPolicyVersion} locale={Astro.locals?.starlightRoute?.locale} />'
         : '';
     const footerSource = `---
 import Footer from ${JSON.stringify(footerPath)};
 ${promotionImport}
 ${analyticsImport}
+${consentImport}
 import options from '${optionsId}';
 ---
 
@@ -258,9 +302,11 @@ import options from '${optionsId}';
   buildInfo={options.buildInfo}
   avatar={options.footerAvatar.avatar}
   randomAvatar={options.footerAvatar.randomAvatar}
-/>
+${consentAttribute ? `  consent={true}
+` : ''}/>
 ${promotionRender}
 ${analyticsRender}
+${consentRender}
 `;
     const pageTitleSource = `---
 import PageTitle from ${JSON.stringify(pageTitlePath)};
@@ -277,6 +323,7 @@ import options from '${optionsId}';
   aiDisclosures={options.aiDisclosures}
   hagicodePromotionEnabled={options.hagicodePromotionEnabled}
   hagicodePromotionRandomAvatar={options.hagicodePromotionRandomAvatar}
+  siteId={options.links?.siteId}
 ><slot /></MarkdownContent>
 `;
     const headSource = `---
@@ -284,14 +331,22 @@ import DefaultHead from '@astrojs/starlight/components/Head.astro';
 import SEOHead from ${JSON.stringify(seoHeadPath)};
 import GoogleAnalytics from ${JSON.stringify(coreExport('GoogleAnalytics'))};
 ${serializedOptions.posthogApiKey ? `import PostHog from ${JSON.stringify(coreExport('PostHog'))};` : ''}
+import { classifyPagePath } from ${JSON.stringify(coreExport('posthog-events'))};
 import options from '${optionsId}';
 const isNotFound = /(?:^|\\/)404(?:\\.html)?\\/?$/u.test(Astro.url.pathname);
+const route = Astro.locals.starlightRoute;
+const pageType = isNotFound
+  ? '404'
+  : route?.entry?.data?.template === 'splash'
+    ? 'home'
+    : classifyPagePath(Astro.url.pathname, { base: import.meta.env.BASE_URL, locales: route?.locale ? [route.locale] : [] });
 ---
 
 {options.seoEnabled ? <SEOHead options={options} /> : <DefaultHead />}
-${serializedOptions.posthogApiKey ? '<PostHog apiKey={options.posthogApiKey} />' : ''}
+${serializedOptions.posthogApiKey ? `<PostHog apiKey={options.posthogApiKey} framework="starlight" version={${JSON.stringify(PACKAGE_VERSION)}} siteId={options.links?.siteId} pageType={pageType}${serializedOptions.consentEnabled ? ' consent={true}' : ''} searchQuery={options.posthogSearchQuery} />` : ''}
+
 {!isNotFound && options.googleAnalyticsMeasurementId && (
-  <GoogleAnalytics measurementId={options.googleAnalyticsMeasurementId} />
+  <GoogleAnalytics measurementId={options.googleAnalyticsMeasurementId}${serializedOptions.consentEnabled ? ' consent={true}' : ''} />
 )}
 `;
     const modules = new Map([
@@ -403,14 +458,22 @@ export default function hagilight(options = {}) {
         pattern: FIFTY_ONE_LA_ID_PATTERN,
         defaultId: DEFAULT_51LA_ID,
     });
-    const posthog = optionalRecord(analytics.posthog, 'PostHog analytics');
+    const posthogSearchQuery = resolvePostHogSearchQuery(optionalRecord(analytics.posthog, 'PostHog analytics')?.searchQuery);
+    const posthogProviderOptions = providerOptionsWithoutSearchQuery(analytics.posthog);
+    const posthog = optionalRecord(posthogProviderOptions, 'PostHog analytics');
     optionalBoolean(posthog, 'enabled', 'PostHog analytics enabled');
-    const posthogApiKey = resolveProvider(analytics.posthog, {
+    const posthogApiKey = resolveProvider(posthogProviderOptions, {
         name: 'PostHog',
         idKey: 'apiKey',
         pattern: POSTHOG_API_KEY_PATTERN,
         defaultId: DEFAULT_POSTHOG_API_KEY,
     });
+    const consentProviders = [
+        ...(googleAnalyticsMeasurementId ? ['googleAnalytics'] : []),
+        ...(fiftyOneLaId ? ['fiftyOneLa'] : []),
+        ...(posthogApiKey ? ['posthog'] : []),
+    ];
+    const consent = resolveConsentOptions(analytics.consent, consentProviders);
     const promoto = optionalRecord(input.promoto, 'promoto');
     const promotoEnabled = optionalBoolean(promoto, 'enabled', 'promoto enabled') !== false;
     const contentImages = optionalRecord(input.contentImages, 'contentImages');
@@ -442,6 +505,11 @@ export default function hagilight(options = {}) {
         googleAnalyticsMeasurementId,
         fiftyOneLaId,
         posthogApiKey,
+        consentEnabled: consent.enabled,
+        consentProviders: consent.providers,
+        consentPrivacyUrl: consent.privacyUrl,
+        consentPolicyVersion: consent.policyVersion,
+        posthogSearchQuery,
         aiDisclosures,
         seoEnabled: seo.enabled,
         seo,
@@ -544,7 +612,7 @@ export default function hagilight(options = {}) {
                         fiftyOneLa: serializedOptions.fiftyOneLaId !== undefined,
                         posthog: serializedOptions.posthogApiKey !== undefined,
                     },
-                    features: { seo: seo.enabled, promoto: promotoEnabled },
+                    features: { seo: seo.enabled, promoto: promotoEnabled, consent: consent.enabled },
                 }, unregisterSiteMetadataOwner));
                 updateConfig({
                     ...(config.logo === undefined ? { logo: { src: defaultLogo, alt: 'HagiCode' } } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight-starlight",
-  "version": "0.18.0",
+  "version": "0.19.1-dev.185.1.a85e2a8",
   "type": "module",
   "description": "Starlight plugin and components for HagiCode documentation",
   "repository": {
@@ -53,7 +53,7 @@
     "assets/showcase/*"
   ],
   "dependencies": {
-    "@hagicode/hagilight-core": "0.18.0"
+    "@hagicode/hagilight-core": "0.19.1-dev.185.1.a85e2a8"
   },
   "peerDependencies": {
     "@astrojs/starlight": "^0.42.4",