@hagicode/hagilight-docusaurus 0.18.0 → 0.19.1-dev.184.1.830a4c6

package/README.md

@@ -74,7 +74,7 @@ The built-in analytics IDs (`G-EN03FMT2Q4`, 51LA `L6b88a5yK4h2Xnci`, and PostHog
 
 An analytics object enables its provider when it contains an ID. Set `enabled` explicitly to override that. `enabled: true` with no ID is a configuration error.
 
-PostHog needs no configuration or consumer project key when registering `hagilightDocusaurus()`. It uses `phc_qiVVihsL925ovhPYNdLJWz4k7aoKVMwYCevgZPE6PER5`, API host `https://us.i.posthog.com`, and SDK defaults `2026-05-30`. Its single inline initialization shares the global head with Google Analytics on every production HTML page, including localized docs, blogs and not-found pages. No PostHog loader is emitted outside production.
+PostHog needs no configuration or consumer project key when registering `hagilightDocusaurus()`. 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`. Its single inline initialization shares the global head with Google Analytics on every production HTML page, including localized docs, blogs and not-found pages. No PostHog loader is emitted outside production.
 
 | PostHog input | Behavior |
 | --- | --- |
@@ -84,6 +84,8 @@ PostHog needs no configuration or consumer project key when registering `hagilig
 | `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 (Docusaurus has no PostHog search events, so this has no effect here) |
+| `posthog: { searchQuery: 'off' }` | Enabled with the default key; no search text (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.
 
@@ -100,7 +102,12 @@ hagilightDocusaurus({
 }); // all analytics disabled
 ```
 
-Each provider is independent: disabling Google Analytics and 51LA alone leaves PostHog enabled. Choose one PostHog initialization owner and opt out here if the site already supplies it. The loader initializes once per document, and the supplied SDK defaults own navigation tracking; Hagilight adds no PostHog capture calls or route listeners. The existing analytics client module remains registered only for Google Analytics and 51LA, preserving their navigation behavior.
+`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, while `{}` still disables it.
+
+Docusaurus sends `not_found_viewed` from its 404 page, `code_copied` from its code blocks, and `locale_changed` from the locale dropdown. The interaction observers are installed whenever PostHog is enabled, even when Google Analytics and 51LA are disabled. Platform gaps: there is no `search_used` or `search_result_clicked`, because Docusaurus search is not Pagefind; `article_promotion_impression`, `theme_changed`, `content_width_changed` and `locale_redirected` are Starlight-only or root-transit-only and are not sent here.
+
+Each provider is independent: disabling Google Analytics and 51LA alone leaves PostHog enabled. Choose one PostHog initialization owner and opt out here if the site already supplies it. The loader initializes once per document, and the supplied SDK defaults own navigation tracking. The head registers the site context (`site_framework` `docusaurus`, the plugin version, and `site_id` from `links.siteId` or the site URL's hostname) once. On every route update, including the first page load, the plugin refreshes only `locale` and `page_type` through `posthog.register`, with `page_type` derived from the path, so the 404 page reports a path-derived type rather than `other`. The analytics client module is bundled whenever PostHog is enabled, even when Google Analytics and 51LA are disabled, so marked links are captured as `cta_click` without Google Analytics. Google Analytics and 51LA keep their navigation behavior.
+
 
 ### SEO
 
@@ -184,3 +191,7 @@ The sitemap check looks at every loaded plugin, so the position of `hagilightDoc
 ## Demo
 
 The demo site for this package lives in the monorepo at `examples/demo-docusaurus-web` and is published to https://docusaurus.hagicode.com/.
+
+### Consent
+
+`analytics.consent` (`enabled`, `privacyUrl`, `policyVersion`) mirrors the Starlight option. With consent on, providers leave inert descriptors in the head, the client module mounts the popup and gate, PostHog's click sink installs only after a grant, and the swizzled footer shows the localized "Cookie settings" entry. The popup styles ship in `consent.css`. `enabled: false` restores immediate loading.

package/consent.css

@@ -0,0 +1,383 @@
+/* Consent popup (hagilight). Same rules as packages/core/CookieConsent.astro; only the tokens differ. */
+/* Tokens follow Docusaurus --ifm-* variables and fall back to light values where a theme omits them. */
+.hagilight-consent {
+  --hc-accent: var(--ifm-color-primary, #2563eb);
+  --hc-bg: var(--ifm-background-surface-color, #ffffff);
+  --hc-text: var(--ifm-font-color-base, #1f2937);
+  --hc-muted: var(--ifm-color-emphasis-700, color-mix(in srgb, var(--hc-text) 72%, transparent));
+  --hc-border: var(--ifm-color-emphasis-300, #cbd5e1);
+  --hc-action-bg: var(--ifm-color-primary-dark, var(--ifm-color-primary, #2563eb));
+  --hc-action-fg: var(--ifm-color-white, #ffffff);
+  --hc-focus: var(--ifm-color-primary-darker, var(--ifm-color-primary, #2563eb));
+  /* Derived: a surface tinted toward the brand, hairlines from the theme border, motion curves. */
+  --hc-surface: color-mix(in srgb, var(--hc-accent) 5%, var(--hc-bg));
+  --hc-hairline: color-mix(in srgb, var(--hc-border) 70%, transparent);
+  --hc-ease: cubic-bezier(0.22, 1, 0.36, 1);
+  --hc-spring: cubic-bezier(0.22, 1, 0.36, 1);
+
+  position: fixed;
+  z-index: 45;
+  inset-block-end: max(1rem, env(safe-area-inset-bottom, 0px));
+  inset-inline-end: max(1rem, env(safe-area-inset-right, 0px));
+  box-sizing: border-box;
+  width: min(24rem, calc(100vw - 2rem - env(safe-area-inset-left, 0px) - env(safe-area-inset-right, 0px)));
+  max-height: calc(100dvh - 2rem);
+  overflow-y: auto;
+  overscroll-behavior: contain;
+  scrollbar-width: thin;
+  scrollbar-color: color-mix(in srgb, var(--hc-text) 28%, transparent) transparent;
+  padding: 1.25rem 1.25rem 0.5rem;
+  border: 0;
+  border-radius: 0.875rem;
+  background: var(--hc-surface);
+  color: var(--hc-text);
+  /* Elevation is declared once, as a shadow: a tight contact shadow under a long, soft one. */
+  box-shadow: 0 1px 2px rgb(0 0 0 / 0.08), 0 18px 44px -14px rgb(0 0 0 / 0.4);
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+
+/* A damped spring where linear() exists (the same curve as the promotion banner), a long ease-out elsewhere. */
+@supports (animation-timing-function: linear(0, 1)) {
+  .hagilight-consent {
+    --hc-spring: linear(0, 0.066, 0.22, 0.409, 0.597, 0.761, 0.89, 0.983, 1.042, 1.073, 1.083, 1.079, 1.067, 1.052, 1.036, 1.022, 1.011, 1.002, 0.997, 0.994, 0.993, 0.993, 1);
+  }
+}
+
+/* Below about 36rem the panel attaches to the bottom edge, full width, with its top corners rounded. */
+@media (max-width: 36rem) {
+  .hagilight-consent {
+    inset-inline: 0;
+    inset-block-end: 0;
+    width: auto;
+    max-width: none;
+    max-height: min(85dvh, calc(100dvh - 1rem));
+    border-radius: 0.875rem 0.875rem 0 0;
+    padding: 1.125rem 1rem max(0.25rem, env(safe-area-inset-bottom, 0px));
+    box-shadow: 0 -1px 2px rgb(0 0 0 / 0.06), 0 -14px 36px -14px rgb(0 0 0 / 0.4);
+  }
+}
+
+.hagilight-consent[hidden],
+.hagilight-consent [hidden] {
+  display: none;
+}
+
+/* While the panel fades out its buttons no longer take clicks. */
+.hagilight-consent[data-leaving] {
+  pointer-events: none;
+}
+
+.hagilight-consent ::selection {
+  background: color-mix(in srgb, var(--hc-accent) 28%, transparent);
+  color: inherit;
+}
+
+/* The one authored moment: the panel springs up, then its parts settle in order. */
+.hagilight-consent:not([hidden]) {
+  animation: hagilight-consent-rise 0.7s var(--hc-spring) backwards;
+}
+
+.hagilight-consent:not([hidden]) .hagilight-consent__title,
+.hagilight-consent:not([hidden]) .hagilight-consent__intro,
+.hagilight-consent:not([hidden]) .hagilight-consent__actions,
+.hagilight-consent:not([hidden]) .hagilight-consent__toggle {
+  animation: hagilight-consent-settle 0.55s var(--hc-ease) backwards;
+}
+
+.hagilight-consent:not([hidden]) .hagilight-consent__title { animation-delay: 0.1s; }
+.hagilight-consent:not([hidden]) .hagilight-consent__intro { animation-delay: 0.16s; }
+.hagilight-consent:not([hidden]) .hagilight-consent__actions { animation-delay: 0.22s; }
+.hagilight-consent:not([hidden]) .hagilight-consent__toggle { animation-delay: 0.28s; }
+
+@keyframes hagilight-consent-rise {
+  from { opacity: 0; transform: translateY(1.5rem) scale(0.97); }
+  to { opacity: 1; transform: none; }
+}
+
+@keyframes hagilight-consent-settle {
+  from { opacity: 0; transform: translateY(0.5rem); }
+  to { opacity: 1; transform: none; }
+}
+
+.hagilight-consent__title {
+  margin: 0;
+  color: var(--hc-text);
+  font-size: 1.0625rem;
+  font-weight: 600;
+  line-height: 1.3;
+  text-wrap: balance;
+}
+
+.hagilight-consent__intro {
+  margin: 0.375rem 0 0;
+  color: var(--hc-muted);
+  line-height: 1.55;
+  text-wrap: pretty;
+}
+
+/* The current choice only shows once there is one, as a small status chip beside the actions. */
+.hagilight-consent__choice {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.4375rem;
+  margin: 0.75rem 0 0;
+  padding: 0.1875rem 0.625rem 0.1875rem 0.5rem;
+  border-radius: 999px;
+  background: color-mix(in srgb, var(--hc-text) 7%, transparent);
+  color: var(--hc-text);
+  font-size: 0.75rem;
+  line-height: 1.4;
+}
+
+.hagilight-consent[data-state='undecided'] .hagilight-consent__choice {
+  display: none;
+}
+
+.hagilight-consent__choice::before {
+  content: '';
+  flex: none;
+  width: 0.4375rem;
+  height: 0.4375rem;
+  border-radius: 50%;
+  background: var(--hc-muted);
+}
+
+.hagilight-consent[data-state='granted'] .hagilight-consent__choice::before {
+  background: var(--hc-accent);
+}
+
+.hagilight-consent__actions {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(8.5rem, 1fr));
+  gap: 0.5rem;
+  margin-top: 1rem;
+}
+
+/* Accept and Reject share every property, so neither reads as the primary choice. Both rest as a tint and fill on hover. */
+.hagilight-consent__button {
+  min-height: 2.75rem;
+  margin: 0;
+  padding: 0.5rem 0.875rem;
+  border: 1px solid color-mix(in srgb, var(--hc-action-bg) 55%, transparent);
+  border-radius: 0.625rem;
+  background: color-mix(in srgb, var(--hc-action-bg) 10%, transparent);
+  color: var(--hc-text);
+  font: inherit;
+  font-size: 0.875rem;
+  font-weight: 600;
+  line-height: 1.25;
+  text-wrap: balance;
+  cursor: pointer;
+  transition: background-color 0.18s var(--hc-ease), border-color 0.18s var(--hc-ease), color 0.18s var(--hc-ease), transform 0.18s var(--hc-ease);
+}
+
+@media (hover: hover) {
+  .hagilight-consent__button:hover {
+    border-color: var(--hc-action-bg);
+    background: var(--hc-action-bg);
+    color: var(--hc-action-fg);
+  }
+}
+
+.hagilight-consent__button:active {
+  transform: scale(0.98);
+}
+
+/* A full-width disclosure row: the label on the left, a chevron that turns as the details open. */
+.hagilight-consent__toggle {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 0.75rem;
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 2.5rem;
+  margin: 0.75rem 0 0;
+  padding: 0.5rem 0;
+  border: 0;
+  border-top: 1px solid var(--hc-hairline);
+  border-radius: 0.25rem;
+  background: none;
+  color: var(--hc-muted);
+  font: inherit;
+  font-size: 0.8125rem;
+  font-weight: 500;
+  text-align: start;
+  cursor: pointer;
+  transition: color 0.18s var(--hc-ease);
+}
+
+.hagilight-consent__toggle::after {
+  content: '';
+  flex: none;
+  width: 0.4375rem;
+  height: 0.4375rem;
+  border: solid currentColor;
+  border-width: 0 1.5px 1.5px 0;
+  transform: translateY(-0.125rem) rotate(45deg);
+  transition: transform 0.3s var(--hc-ease);
+}
+
+.hagilight-consent__toggle[aria-expanded='true']::after {
+  transform: translateY(0.125rem) rotate(225deg);
+}
+
+@media (hover: hover) {
+  .hagilight-consent__toggle:hover {
+    color: var(--hc-text);
+  }
+}
+
+.hagilight-consent__button:focus-visible,
+.hagilight-consent__toggle:focus-visible,
+.hagilight-consent a:focus-visible {
+  outline: 2px solid var(--hc-focus);
+  outline-offset: 2px;
+}
+
+.hagilight-consent__details {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0 0 0.25rem;
+}
+
+/* Categories are open sections divided by hairlines, not boxes inside a box. */
+.hagilight-consent__category {
+  margin: 0;
+  padding: 0.875rem 0;
+  border-top: 1px solid var(--hc-hairline);
+}
+
+.hagilight-consent__category:first-child {
+  padding-top: 0.5rem;
+  border-top: 0;
+}
+
+.hagilight-consent__category h3 {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  margin: 0;
+  color: var(--hc-text);
+  font-size: 0.8125rem;
+  font-weight: 600;
+  line-height: 1.3;
+}
+
+/* A filled dot is on, a hollow one is off; the analytics dot follows the visitor's choice. */
+.hagilight-consent__category h3::before {
+  content: '';
+  flex: none;
+  box-sizing: border-box;
+  width: 0.5rem;
+  height: 0.5rem;
+  border: 1.5px solid var(--hc-muted);
+  border-radius: 50%;
+}
+
+.hagilight-consent__category--necessary h3::before,
+.hagilight-consent[data-state='granted'] .hagilight-consent__category--analytics h3::before {
+  border-color: var(--hc-accent);
+  background: var(--hc-accent);
+}
+
+.hagilight-consent__category p,
+.hagilight-consent__category ul {
+  margin: 0.375rem 0 0;
+  padding-inline-start: 1rem;
+}
+
+.hagilight-consent__category p,
+.hagilight-consent__withdraw {
+  color: var(--hc-muted);
+  font-size: 0.8125rem;
+  line-height: 1.5;
+  text-wrap: pretty;
+}
+
+.hagilight-consent ul {
+  list-style: none;
+}
+
+/* Storage names are code: monospace, with the kind pushed to the far edge. */
+.hagilight-consent li {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 0.75rem;
+  margin: 0;
+  padding: 0.1875rem 0;
+  color: var(--hc-muted);
+  font-size: 0.75rem;
+}
+
+.hagilight-consent li span {
+  flex: 0 1 auto;
+  text-align: end;
+}
+
+.hagilight-consent code {
+  color: var(--hc-text);
+  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
+  font-size: 0.75rem;
+  overflow-wrap: anywhere;
+}
+
+.hagilight-consent__withdraw {
+  margin: 0;
+  padding: 0.875rem 0 0;
+  border-top: 1px solid var(--hc-hairline);
+}
+
+.hagilight-consent a {
+  color: var(--hc-text);
+  font-weight: 600;
+  text-decoration-thickness: 1px;
+  text-underline-offset: 0.2em;
+}
+
+.hagilight-consent a:hover {
+  text-decoration-thickness: 2px;
+}
+
+.hagilight-consent__privacy {
+  margin: 0.5rem 0 0.5rem;
+  font-size: 0.8125rem;
+}
+
+/* Forced colors drop the shadow and the fills, so the panel and the dots get system-colored edges. */
+@media (forced-colors: active) {
+  .hagilight-consent {
+    border: 1px solid CanvasText;
+  }
+
+  .hagilight-consent__button {
+    border-color: ButtonText;
+  }
+
+  .hagilight-consent__category--necessary h3::before,
+  .hagilight-consent[data-state='granted'] .hagilight-consent__category--analytics h3::before {
+    border-color: CanvasText;
+    background: CanvasText;
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .hagilight-consent,
+  .hagilight-consent * {
+    animation: none !important;
+    transition: none !important;
+  }
+}
+
+.hagilight-footer__consent {
+  margin: 0;
+  padding: 0;
+  border: 0;
+  background: none;
+  color: inherit;
+  font: inherit;
+  text-decoration: underline;
+  cursor: pointer;
+}

package/dist/analytics.d.ts

@@ -1,5 +1,11 @@
 import type { HtmlTagObject } from '@docusaurus/types';
-export declare function posthogHeadTags(apiKey: string): HtmlTagObject[];
+import { type ConsentPopupOptions } from '@hagicode/hagilight-core/consent-markup';
+import { type PostHogInitOptions, type PostHogSiteContext } from '@hagicode/hagilight-core/posthog';
+export declare function posthogHeadTags(apiKey: string, context?: PostHogSiteContext, options?: PostHogInitOptions): HtmlTagObject[];
+/** Inert data for the consent gate: a JSON script that never executes, so no provider loads before a grant. */
+export declare function consentDescriptorTag(provider: string, payload: Record<string, string>): HtmlTagObject;
+/** The popup's config descriptor, read by the client module once. It holds no IDs. */
+export declare function consentConfigTag(config: ConsentPopupOptions): HtmlTagObject;
 export declare const DEFAULT_GOOGLE_ANALYTICS_ID = "G-EN03FMT2Q4";
 export declare const DEFAULT_FIFTY_ONE_LA_ID = "L6b88a5yK4h2Xnci";
 export declare const GOOGLE_ANALYTICS_ID_PATTERN: RegExp;

package/dist/analytics.js

@@ -1,6 +1,19 @@
+import { consentDescriptor, CONSENT_DESCRIPTOR_ID } from '@hagicode/hagilight-core/consent-markup';
 import { posthogInitScript } from '@hagicode/hagilight-core/posthog';
-export function posthogHeadTags(apiKey) {
-    return [{ tagName: 'script', innerHTML: posthogInitScript(apiKey) }];
+export function posthogHeadTags(apiKey, context, options) {
+    return [{ tagName: 'script', innerHTML: posthogInitScript(apiKey, context, options) }];
+}
+/** Inert data for the consent gate: a JSON script that never executes, so no provider loads before a grant. */
+export function consentDescriptorTag(provider, payload) {
+    return {
+        tagName: 'script',
+        attributes: { type: 'application/json', 'data-hagilight-analytics': provider },
+        innerHTML: JSON.stringify(payload).replace(/</gu, '\\u003c'),
+    };
+}
+/** The popup's config descriptor, read by the client module once. It holds no IDs. */
+export function consentConfigTag(config) {
+    return { tagName: 'script', attributes: { type: 'application/json', id: CONSENT_DESCRIPTOR_ID }, innerHTML: consentDescriptor(config) };
 }
 export const DEFAULT_GOOGLE_ANALYTICS_ID = 'G-EN03FMT2Q4';
 export const DEFAULT_FIFTY_ONE_LA_ID = 'L6b88a5yK4h2Xnci';
@@ -31,7 +44,7 @@ export function fiftyOneLaHeadTags(siteId) {
         },
         {
             tagName: 'script',
-            innerHTML: `LA.init(${JSON.stringify({ id: siteId, ck: siteId, autoTrack: true, hashMode: true, screenRecord: true })});`,
+            innerHTML: `LA.init(${JSON.stringify({ id: siteId, ck: siteId, autoTrack: true, hashMode: true })});`,
         },
     ];
 }

package/dist/client/analytics.d.ts

@@ -1,3 +1,4 @@
+import { type PostHogClient } from '@hagicode/hagilight-core/posthog-events';
 export interface RouteLocation {
     pathname: string;
     search: string;
@@ -18,6 +19,22 @@ export interface RouteReportDeps {
     schedule: (task: () => void) => void;
 }
 export declare function installClickTracking(target?: Pick<EventTarget, 'addEventListener'>): boolean;
+export interface PostHogPageContext {
+    /** The document language, sent as `locale` when non-empty. */
+    lang: string;
+    /** The site base path, for example `/docs/`. */
+    base: string;
+}
+/**
+ * Refreshes only `locale` and `page_type` as super properties. Route updates are the only time this
+ * module calls PostHog, and it never initializes the SDK or captures an event.
+ */
+export declare function refreshPostHogPageProperties(update: RouteDidUpdate, posthog: PostHogClient | undefined, page: PostHogPageContext): boolean;
 export declare function reportPageView(gtag: unknown, page: PageSnapshot): boolean;
 export declare function handleRouteDidUpdate(update: RouteDidUpdate, deps: RouteReportDeps): void;
+/**
+ * Navigation reports wait for the grant when consent is on: the page then carries the consent descriptor, and
+ * only a granted visitor may send a page_view. Without consent the page reports as before.
+ */
+export declare function navigationReportsAllowed(doc?: Pick<Document, 'getElementById'>): boolean;
 export declare function onRouteDidUpdate(update: RouteDidUpdate): void;

package/dist/client/analytics.js

@@ -1,6 +1,27 @@
 import { installGaEventTracking } from '@hagicode/hagilight-core/analytics-events';
+import { getConsent } from '@hagicode/hagilight-core/consent';
+import { CONSENT_DESCRIPTOR_ID } from '@hagicode/hagilight-core/consent-markup';
+import { classifyPagePath, installPostHogClickTracking, } from '@hagicode/hagilight-core/posthog-events';
 export function installClickTracking(target) {
-    return installGaEventTracking(target);
+    const installed = installGaEventTracking(target);
+    // The PostHog sink is installed only when the head script initialized PostHog, so a site that disables
+    // PostHog gets no PostHog listener even though this module is bundled for Google Analytics.
+    if (globalThis.__hagilightPosthogInitialized === true) {
+        installPostHogClickTracking(target);
+    }
+    return installed;
+}
+/**
+ * Refreshes only `locale` and `page_type` as super properties. Route updates are the only time this
+ * module calls PostHog, and it never initializes the SDK or captures an event.
+ */
+export function refreshPostHogPageProperties(update, posthog, page) {
+    if (typeof posthog?.register !== 'function')
+        return false;
+    const pageType = classifyPagePath(update.location.pathname, { base: page.base, locales: page.lang ? [page.lang] : [] });
+    const properties = page.lang ? { locale: page.lang, page_type: pageType } : { page_type: pageType };
+    posthog.register(properties);
+    return true;
 }
 export function reportPageView(gtag, page) {
     if (typeof gtag !== 'function')
@@ -15,8 +36,17 @@ export function handleRouteDidUpdate(update, deps) {
         reportPageView(deps.getGtag(), deps.readPage());
     });
 }
+/**
+ * Navigation reports wait for the grant when consent is on: the page then carries the consent descriptor, and
+ * only a granted visitor may send a page_view. Without consent the page reports as before.
+ */
+export function navigationReportsAllowed(doc = document) {
+    if (!doc.getElementById(CONSENT_DESCRIPTOR_ID))
+        return true;
+    return getConsent().analytics === 'granted';
+}
 const browserDeps = {
-    getGtag: () => globalThis.gtag,
+    getGtag: () => (navigationReportsAllowed() ? globalThis.gtag : undefined),
     readPage: () => ({
         title: document.title,
         location: window.location.href,
@@ -26,8 +56,20 @@ const browserDeps = {
         window.setTimeout(task, 0);
     },
 };
+function browserPageContext() {
+    return {
+        lang: document.documentElement.lang,
+        base: document.querySelector('meta[name="hagilight-base-path"]')?.getAttribute('content') || '/',
+    };
+}
 export function onRouteDidUpdate(update) {
     handleRouteDidUpdate(update, browserDeps);
+    try {
+        refreshPostHogPageProperties(update, globalThis.posthog, browserPageContext());
+    }
+    catch {
+        // Analytics must never break route handling.
+    }
 }
 if (typeof document !== 'undefined')
     installClickTracking(document);

package/dist/client/consent.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/client/consent.js

@@ -0,0 +1,4 @@
+import { mountConsent } from '@hagicode/hagilight-core/consent-mount';
+// The head's descriptors and the shared wiring do the work; this module only runs them in the browser.
+if (typeof document !== 'undefined')
+    mountConsent(document, window);

package/dist/client/posthog-interactions.d.ts

@@ -0,0 +1 @@
+export declare function installPostHogInteractionObservers(): boolean;

package/dist/client/posthog-interactions.js

@@ -0,0 +1,13 @@
+import { installPostHogInteractions } from '@hagicode/hagilight-core/posthog-interactions';
+/*
+ * Installs the shared PostHog interaction observers (search, result clicks, code copy, locale links).
+ * Runs only when the head script initialized PostHog. Observers are delegated on the document, so
+ * Docusaurus client navigation needs no rebinding and this module adds no route listener.
+ */
+export function installPostHogInteractionObservers() {
+    if (globalThis.__hagilightPosthogInitialized !== true)
+        return false;
+    return installPostHogInteractions(document);
+}
+if (typeof document !== 'undefined')
+    installPostHogInteractionObservers();

package/dist/discovery.js

@@ -221,7 +221,7 @@ async function writeSiteMetadataFile(outputs) {
             fiftyOneLa: production && options.fiftyOneLaId !== undefined,
             posthog: production && options.posthogApiKey !== undefined,
         },
-        features: { seo: options.seo.enabled, promoto: options.promoto },
+        features: { seo: options.seo.enabled, promoto: options.promoto, consent: options.consent.enabled },
     });
     writeSiteMetadata({
         outDir,

package/dist/index.js

@@ -3,7 +3,8 @@ import { fileURLToPath } from 'node:url';
 import { resolveBuildInfo } from '@hagicode/hagilight-core/build-info-resolver';
 import footerAvatarManifest from '@hagicode/hagilight-core/assets/footer/manifest.json' with { type: 'json' };
 import { randomPoolFromManifest } from '@hagicode/hagilight-core/random-image';
-import { fiftyOneLaHeadTags, googleAnalyticsHeadTags, posthogHeadTags } from './analytics.js';
+import { consentConfigTag, consentDescriptorTag, fiftyOneLaHeadTags, googleAnalyticsHeadTags, posthogHeadTags } from './analytics.js';
+import { posthogInitScript } from '@hagicode/hagilight-core/posthog';
 import { collectFeedItems, feedHeadTags, writeDiscoveryOutputs } from './discovery.js';
 import { PLUGIN_NAME } from './global-data.js';
 import { resolveOptions } from './options.js';
@@ -14,15 +15,45 @@ const PACKAGE_VERSION = JSON.parse(readFileSync(new URL('../package.json', impor
 function packageFile(relativePath) {
     return fileURLToPath(new URL(relativePath, import.meta.url));
 }
-function analyticsHeadTags(options) {
+function analyticsHeadTags(options, site) {
     if (process.env.NODE_ENV !== 'production')
         return [];
+    const consent = options.consent.enabled;
+    const posthogContext = {
+        siteId: options.links.siteId?.trim() || hostnameOf(site.url),
+        framework: 'docusaurus',
+        version: PACKAGE_VERSION,
+    };
     return [
-        ...(options.googleAnalyticsId === undefined ? [] : googleAnalyticsHeadTags(options.googleAnalyticsId)),
-        ...(options.fiftyOneLaId === undefined ? [] : fiftyOneLaHeadTags(options.fiftyOneLaId)),
-        ...(options.posthogApiKey === undefined ? [] : posthogHeadTags(options.posthogApiKey)),
+        // With consent on, each provider leaves inert data for the gate instead of an executable loader.
+        ...(options.googleAnalyticsId === undefined ? [] : consent
+            ? [consentDescriptorTag('googleAnalytics', { measurementId: options.googleAnalyticsId })]
+            : googleAnalyticsHeadTags(options.googleAnalyticsId)),
+        ...(options.fiftyOneLaId === undefined ? [] : consent
+            ? [consentDescriptorTag('fiftyOneLa', { siteId: options.fiftyOneLaId })]
+            : fiftyOneLaHeadTags(options.fiftyOneLaId)),
+        ...(options.posthogApiKey === undefined ? [] : [
+            // The client reads this to classify routes for `page_type`; it is emitted only with PostHog.
+            { tagName: 'meta', attributes: { name: 'hagilight-base-path', content: site.baseUrl } },
+            ...(consent
+                ? [consentDescriptorTag('posthog', { apiKey: options.posthogApiKey, loader: posthogInitScript(options.posthogApiKey, posthogContext, { searchQuery: options.posthogSearchQuery }) })]
+                : posthogHeadTags(options.posthogApiKey, posthogContext, { searchQuery: options.posthogSearchQuery })),
+        ]),
+        ...(consent ? [consentConfigTag({
+                providers: options.consent.providers,
+                privacyUrl: options.consent.privacyUrl,
+                policyVersion: options.consent.policyVersion,
+            })] : []),
     ];
 }
+function hostnameOf(url) {
+    try {
+        return new URL(url).hostname || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
 /** Exposes the footer site identifier to the client banner, which tags its call to action with it. */
 function promotoSiteIdHeadTags(options) {
     const siteId = options.links.siteId?.trim();
@@ -33,12 +64,17 @@ function promotoSiteIdHeadTags(options) {
 /** The footer avatar pair in the core package; matched by path so the rule holds in any install layout. */
 const FOOTER_AVATAR_ASSET = /[\\/]footer[\\/]avatar\.(?:avif|webp)$/u;
 function clientModules(options) {
-    const analyticsEnabled = options.googleAnalyticsId !== undefined || options.fiftyOneLaId !== undefined;
+    // The analytics client also installs the PostHog click sink, so PostHog alone is enough to bundle it.
+    const analyticsEnabled = options.googleAnalyticsId !== undefined || options.fiftyOneLaId !== undefined || options.posthogApiKey !== undefined;
     const footerAvatarPicker = options.footer && options.footerAvatar.randomAvatar;
     return [
         ...(analyticsEnabled ? [packageFile('./client/analytics.js')] : []),
+        ...(options.consent.enabled ? [packageFile('./client/consent.js')] : []),
+        // Interaction observers are independent of Google Analytics and 51LA, so PostHog alone registers them.
+        ...(options.posthogApiKey === undefined ? [] : [packageFile('./client/posthog-interactions.js')]),
         ...(options.promoto ? [packageFile('./client/promoto.js'), packageFile('../promoto.css')] : []),
         ...(options.footer ? [packageFile('../styles.css')] : []),
+        ...(options.consent.enabled ? [packageFile('../consent.css')] : []),
         ...(footerAvatarPicker ? [packageFile('./client/random-image.js')] : []),
     ];
 }
@@ -55,7 +91,8 @@ function createPlugin(context, options) {
             ? randomPoolFromManifest(footerAvatarManifest.pool)
             : undefined,
     };
-    const themeEnabled = options.footer || options.seo.enabled;
+    // The PostHog 404 wrapper lives in the theme, so PostHog alone also enables the theme path.
+    const themeEnabled = options.footer || options.seo.enabled || options.posthogApiKey !== undefined;
     const site = {
         title: context.siteConfig.title,
         tagline: context.siteConfig.tagline,
@@ -109,7 +146,7 @@ function createPlugin(context, options) {
         injectHtmlTags() {
             return {
                 headTags: [
-                    ...analyticsHeadTags(options),
+                    ...analyticsHeadTags(options, site),
                     ...seoHeadTags(options.seo, site),
                     ...feedHeadTags(site, options.rss, feedItems.length),
                     ...promotoSiteIdHeadTags(options),

package/dist/options.d.ts

@@ -1,5 +1,6 @@
 import type { SiteLinksOptions } from '@hagicode/hagilight-core/links';
 import { type ResolvedFooterAvatarOptions } from '@hagicode/hagilight-core/footer-avatar';
+import { type ConsentPopupOptions } from '@hagicode/hagilight-core/consent-markup';
 import { type SiteMetadataOption } from '@hagicode/hagilight-core/site-metadata';
 export interface FeatureToggle {
     enabled?: boolean;
@@ -14,10 +15,28 @@ export interface AnalyticsOptions {
     googleAnalytics?: GoogleAnalyticsOptions;
     fiftyOneLa?: FiftyOneLaOptions;
     posthog?: PostHogOptions;
+    consent?: ConsentOptions;
+}
+export interface ConsentOptions {
+    /** 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. */
+    policyVersion?: string;
+}
+export interface ResolvedConsentOptions {
+    enabled: boolean;
+    privacyUrl: string | undefined;
+    policyVersion: string;
+    providers: ConsentPopupOptions['providers'];
 }
 export interface PostHogOptions extends FeatureToggle {
     apiKey?: string;
+    /** `zero-results` sends search text only for searches with no results. Defaults to `off`; never changes enablement. */
+    searchQuery?: PostHogSearchQueryOption;
 }
+export type PostHogSearchQueryOption = 'off' | 'zero-results';
 export interface SeoOrganizationOptions {
     name?: string;
     url?: string;
@@ -78,6 +97,8 @@ export interface ResolvedHagilightOptions {
     googleAnalyticsId: string | undefined;
     fiftyOneLaId: string | undefined;
     posthogApiKey: string | undefined;
+    consent: ResolvedConsentOptions;
+    posthogSearchQuery: PostHogSearchQueryOption;
     promoto: boolean;
     languageSelector: boolean;
     seo: ResolvedSeoOptions;

package/dist/options.js

@@ -1,5 +1,6 @@
 import { resolveFooterAvatarOptions } from '@hagicode/hagilight-core/footer-avatar';
 import { DEFAULT_POSTHOG_API_KEY, POSTHOG_API_KEY_PATTERN } from '@hagicode/hagilight-core/posthog';
+import { validatePolicyVersion, validatePrivacyUrl, } from '@hagicode/hagilight-core/consent-markup';
 import { isValidSeoImageReference, resolveAbsoluteHttpUrl } from '@hagicode/hagilight-core/seo';
 import { resolveSiteMetadataOption } from '@hagicode/hagilight-core/site-metadata';
 import { DEFAULT_FIFTY_ONE_LA_ID, DEFAULT_GOOGLE_ANALYTICS_ID, FIFTY_ONE_LA_ID_PATTERN, GOOGLE_ANALYTICS_ID_PATTERN, } from './analytics.js';
@@ -40,6 +41,26 @@ function featureEnabled(value, path) {
         return true;
     return booleanOption(objectOption(value, path).enabled, `${path}.enabled`) ?? true;
 }
+function resolvePostHogSearchQuery(value) {
+    if (value === undefined)
+        return 'off';
+    const mode = objectOption(value, 'analytics.posthog').searchQuery;
+    if (mode === undefined || mode === 'off')
+        return 'off';
+    if (mode === 'zero-results')
+        return mode;
+    throw invalid('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(value) {
+    if (value === undefined || typeof value !== 'object' || value === null || !Object.hasOwn(value, 'searchQuery'))
+        return value;
+    const { searchQuery: _searchQuery, ...rest } = value;
+    return Object.keys(rest).length === 0 ? undefined : rest;
+}
 function resolveProvider(value, path, idKey, pattern, defaultId) {
     if (value === undefined)
         return defaultId;
@@ -94,16 +115,40 @@ function resolveRss(value) {
         includeBlog: booleanOption(group.includeBlog, 'rss.includeBlog') ?? true,
     };
 }
+/**
+ * Consent is on by default whenever a provider is enabled; `enabled: false` restores immediate loading. Invalid values
+ * throw from the core validators, which name the option.
+ */
+function resolveConsent(config, providers) {
+    const record = config === undefined ? {} : objectOption(config, 'analytics.consent');
+    const requested = booleanOption(record.enabled, 'analytics.consent.enabled');
+    return {
+        enabled: providers.length > 0 && (requested ?? true),
+        privacyUrl: validatePrivacyUrl(record.privacyUrl),
+        policyVersion: validatePolicyVersion(record.policyVersion),
+        providers,
+    };
+}
 export function resolveOptions(input) {
     const options = input === undefined ? {} : objectOption(input, 'options');
     const analytics = options.analytics === undefined ? {} : objectOption(options.analytics, 'analytics');
+    const googleAnalyticsId = resolveProvider(analytics.googleAnalytics, 'analytics.googleAnalytics', 'measurementId', GOOGLE_ANALYTICS_ID_PATTERN, DEFAULT_GOOGLE_ANALYTICS_ID);
+    const fiftyOneLaId = resolveProvider(analytics.fiftyOneLa, 'analytics.fiftyOneLa', 'siteId', FIFTY_ONE_LA_ID_PATTERN, DEFAULT_FIFTY_ONE_LA_ID);
+    const posthogSearchQuery = resolvePostHogSearchQuery(analytics.posthog);
+    const posthogApiKey = resolveProvider(providerOptionsWithoutSearchQuery(analytics.posthog), 'analytics.posthog', 'apiKey', POSTHOG_API_KEY_PATTERN, DEFAULT_POSTHOG_API_KEY);
     return {
         footer: featureEnabled(options.footer, 'footer'),
         footerAvatar: resolveFooterAvatar(options.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),
-        posthogApiKey: resolveProvider(analytics.posthog, 'analytics.posthog', 'apiKey', POSTHOG_API_KEY_PATTERN, DEFAULT_POSTHOG_API_KEY),
+        googleAnalyticsId,
+        fiftyOneLaId,
+        posthogApiKey,
+        posthogSearchQuery,
+        consent: resolveConsent(analytics.consent, [
+            ...(googleAnalyticsId === undefined ? [] : ['googleAnalytics']),
+            ...(fiftyOneLaId === undefined ? [] : ['fiftyOneLa']),
+            ...(posthogApiKey === undefined ? [] : ['posthog']),
+        ]),
         promoto: featureEnabled(options.promoto, 'promoto'),
         languageSelector: featureEnabled(options.languageSelector, 'languageSelector'),
         seo: resolveSeo(options.seo),

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

@@ -13,5 +13,11 @@ export interface FooterViewProps {
     year: number;
     buildInfo?: BuildInfo;
     avatar?: FooterAvatar;
+    /** Identifies the hosting site in campaign tags; without it the brand links stay untagged. */
+    siteId?: string;
+    /** The hosting site's URL, used only to recognise same-origin destinations that must stay untagged. */
+    siteUrl?: string;
+    /** The localized "Cookie settings" label. Set only when the consent popup is mounted. */
+    consentLabel?: string;
 }
-export declare function FooterView({ links, version, year, buildInfo, avatar }: FooterViewProps): ReactElement;
+export declare function FooterView({ links, version, year, buildInfo, avatar, siteId, siteUrl, consentLabel }: FooterViewProps): ReactElement;

package/dist/theme/Footer/FooterView.js

@@ -5,16 +5,33 @@ import { buildInfoItems } from '@hagicode/hagilight-core/build-info';
 import { pickFooterBrandLinks, resolveFooterBrand } from '@hagicode/hagilight-core/footer-brand';
 import { footerAvatarImageAttributes } from '@hagicode/hagilight-core/footer-avatar';
 import { randomPoolAttribute } from '@hagicode/hagilight-core/random-image';
+import { withCampaignUtm } from '@hagicode/hagilight-core/links';
 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))) }) })] }));
 }
-function FooterBrand({ locale, links, avatar }) {
+function FooterBrand({ locale, links, avatar, siteId, siteUrl }) {
     const brand = resolveFooterBrand(locale);
     const { primary, secondary } = pickFooterBrandLinks(links);
-    return (_jsxs("section", { className: "hagilight-brand", lang: brand.locale, "aria-labelledby": "hagilight-brand-title", children: [_jsxs("div", { className: "hagilight-brand__lead", children: [_jsxs("div", { className: "hagilight-brand__title", children: [avatar && (_jsxs("picture", { className: "hagilight-brand__avatar", "data-random-fan": avatar.randomPool && randomPoolAttribute(avatar.randomPool), children: [_jsx("source", { type: "image/avif", srcSet: avatar.avif }), _jsx("source", { type: "image/webp", srcSet: avatar.webp }), _jsx("img", { src: avatar.webp, ...footerAvatarImageAttributes() })] })), _jsx("h2", { className: "hagilight-brand__headline", id: "hagilight-brand-title", children: brand.headline })] }), _jsxs("div", { className: "hagilight-brand__body", children: [_jsx("p", { className: "hagilight-brand__summary", children: brand.summary }), (primary || secondary) && (_jsxs("div", { className: "hagilight-brand__actions", children: [primary && (_jsxs("a", { className: "hagilight-brand__primary", href: primary.href, target: primary.target, rel: primary.rel, "aria-label": primary.ariaLabel, ...siteLinkGaAttributes(primary, 'footer_brand'), children: [_jsx("span", { children: primary.label }), _jsx("svg", { className: "hagilight-brand__arrow", viewBox: "0 0 16 16", width: "16", height: "16", "aria-hidden": "true", focusable: "false", children: _jsx("path", { d: "M2.5 8h10M8.5 3.5 13 8l-4.5 4.5", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round" }) })] })), secondary && (_jsx("a", { className: "hagilight-brand__secondary", href: secondary.href, target: secondary.target, rel: secondary.rel, "aria-label": secondary.ariaLabel, ...siteLinkGaAttributes(secondary, 'footer_brand'), children: secondary.label }))] }))] })] }), _jsx("dl", { className: "hagilight-brand__pillars", children: brand.pillars.map((pillar, index) => (_jsxs("div", { className: "hagilight-brand__pillar", "data-pillar": pillar.id, style: { '--hagilight-brand-i': index }, children: [_jsx("dt", { children: pillar.label }), _jsx("dd", { children: pillar.description })] }, pillar.id))) })] }));
+    const origin = (() => {
+        try {
+            return siteUrl ? new URL(siteUrl).origin : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    })();
+    // Re-tagged from the untagged destination, so the brand block's content reads `footer_brand`.
+    const brandHref = (link) => withCampaignUtm(link.untaggedHref ?? link.href, {
+        siteId,
+        medium: 'footer',
+        campaign: link.id,
+        content: 'footer_brand',
+        origin,
+    });
+    return (_jsxs("section", { className: "hagilight-brand", lang: brand.locale, "aria-labelledby": "hagilight-brand-title", children: [_jsxs("div", { className: "hagilight-brand__lead", children: [_jsxs("div", { className: "hagilight-brand__title", children: [avatar && (_jsxs("picture", { className: "hagilight-brand__avatar", "data-random-fan": avatar.randomPool && randomPoolAttribute(avatar.randomPool), children: [_jsx("source", { type: "image/avif", srcSet: avatar.avif }), _jsx("source", { type: "image/webp", srcSet: avatar.webp }), _jsx("img", { src: avatar.webp, ...footerAvatarImageAttributes() })] })), _jsx("h2", { className: "hagilight-brand__headline", id: "hagilight-brand-title", children: brand.headline })] }), _jsxs("div", { className: "hagilight-brand__body", children: [_jsx("p", { className: "hagilight-brand__summary", children: brand.summary }), (primary || secondary) && (_jsxs("div", { className: "hagilight-brand__actions", children: [primary && (_jsxs("a", { className: "hagilight-brand__primary", href: brandHref(primary), target: primary.target, rel: primary.rel, "aria-label": primary.ariaLabel, ...siteLinkGaAttributes(primary, 'footer_brand'), children: [_jsx("span", { children: primary.label }), _jsx("svg", { className: "hagilight-brand__arrow", viewBox: "0 0 16 16", width: "16", height: "16", "aria-hidden": "true", focusable: "false", children: _jsx("path", { d: "M2.5 8h10M8.5 3.5 13 8l-4.5 4.5", fill: "none", stroke: "currentColor", strokeWidth: "1.75", strokeLinecap: "round", strokeLinejoin: "round" }) })] })), secondary && (_jsx("a", { className: "hagilight-brand__secondary", href: brandHref(secondary), target: secondary.target, rel: secondary.rel, "aria-label": secondary.ariaLabel, ...siteLinkGaAttributes(secondary, 'footer_brand'), children: secondary.label }))] }))] })] }), _jsx("dl", { className: "hagilight-brand__pillars", children: brand.pillars.map((pillar, index) => (_jsxs("div", { className: "hagilight-brand__pillar", "data-pillar": pillar.id, style: { '--hagilight-brand-i': index }, children: [_jsx("dt", { children: pillar.label }), _jsx("dd", { children: pillar.description })] }, pillar.id))) })] }));
 }
-export function FooterView({ links, version, year, buildInfo, avatar }) {
+export function FooterView({ links, version, year, buildInfo, avatar, siteId, siteUrl, consentLabel }) {
     const { labels } = links;
     const buildItems = buildInfoItems(buildInfo);
-    return (_jsxs("footer", { className: "hagilight-footer", children: [_jsx(FooterBrand, { locale: links.locale, links: links.quick, avatar: avatar }), _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] }), buildItems.map((item) => (_jsxs(Fragment, { children: [' | ', _jsxs("span", { className: "hagilight-footer__build", "data-build-field": item.field, title: item.title, "data-build-commit": item.title, children: [item.label, ": ", item.datetime ? _jsx("time", { dateTime: item.datetime, children: item.text }) : item.text] })] }, item.field)))] })] }));
+    return (_jsxs("footer", { className: "hagilight-footer", children: [_jsx(FooterBrand, { locale: links.locale, links: links.quick, avatar: avatar, siteId: siteId, siteUrl: siteUrl }), _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 || consentLabel) && (_jsxs("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))), consentLabel && (_jsx("button", { type: "button", className: "hagilight-footer__consent", "data-consent-preferences": true, children: consentLabel }))] })), _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] }), buildItems.map((item) => (_jsxs(Fragment, { children: [' | ', _jsxs("span", { className: "hagilight-footer__build", "data-build-field": item.field, title: item.title, "data-build-commit": item.title, children: [item.label, ": ", item.datetime ? _jsx("time", { dateTime: item.datetime, children: item.text }) : item.text] })] }, item.field)))] })] }));
 }

package/dist/theme/Footer/index.js

@@ -3,6 +3,7 @@ import FooterDefaults from '@theme-init/Footer';
 import useDocusaurusContext from '@docusaurus/useDocusaurusContext';
 import { usePluginData } from '@docusaurus/useGlobalData';
 import { resolveFooterLinks } from '../../footer.js';
+import { resolveConsentCopy } from '@hagicode/hagilight-core/consent-copy';
 import { PLUGIN_NAME } from '../../global-data.js';
 import { FooterView } from './FooterView.js';
 import avatarAvif from '@hagicode/hagilight-core/assets/footer/avatar.avif';
@@ -21,5 +22,5 @@ export default function Footer() {
         links: options.links,
         rssEnabled: options.rss.enabled,
     });
-    return (_jsx(FooterView, { links: links, version: version, year: new Date().getFullYear(), buildInfo: buildInfo, avatar: avatar }));
+    return (_jsx(FooterView, { links: links, version: version, year: new Date().getFullYear(), buildInfo: buildInfo, avatar: avatar, siteId: options.links.siteId, siteUrl: options.links.siteUrl ?? siteConfig.url, consentLabel: options.consent.enabled ? resolveConsentCopy(i18n.currentLocale).footerEntry : undefined }));
 }

package/dist/theme/NotFound/Content/index.d.ts

@@ -0,0 +1,7 @@
+import Content from '@theme-init/NotFound/Content';
+import { type ComponentProps, type ReactElement } from 'react';
+/**
+ * The Docusaurus 404 content, with one `not_found_viewed` event per view. The wrapper remounts on each
+ * client navigation to the 404 route, so each view reports once. Without PostHog the capture is silent.
+ */
+export default function NotFoundContent(props: ComponentProps<typeof Content>): ReactElement;

package/dist/theme/NotFound/Content/index.js

@@ -0,0 +1,22 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Content from '@theme-init/NotFound/Content';
+import { useEffect } from 'react';
+import { capturePostHogEvent, referrerDomain } from '@hagicode/hagilight-core/posthog-events';
+/**
+ * The Docusaurus 404 content, with one `not_found_viewed` event per view. The wrapper remounts on each
+ * client navigation to the 404 route, so each view reports once. Without PostHog the capture is silent.
+ */
+export default function NotFoundContent(props) {
+    useEffect(() => {
+        try {
+            capturePostHogEvent('not_found_viewed', {
+                path: window.location.pathname,
+                referrer_domain: referrerDomain(document.referrer),
+            });
+        }
+        catch {
+            // Analytics must never break the 404 page.
+        }
+    }, []);
+    return _jsx(Content, { ...props });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hagicode/hagilight-docusaurus",
-  "version": "0.18.0",
+  "version": "0.19.1-dev.184.1.830a4c6",
   "type": "module",
   "description": "Docusaurus plugin for HagiCode site features: footer, analytics, promote card, locales, SEO, sitemap, robots.txt, and RSS",
   "repository": {
@@ -33,12 +33,13 @@
     "README.md",
     "styles.css",
     "promoto.css",
+    "consent.css",
     "dist/**/*.js",
     "dist/**/*.d.ts"
   ],
   "dependencies": {
     "@docusaurus/types": "^3.9.2",
-    "@hagicode/hagilight-core": "0.18.0"
+    "@hagicode/hagilight-core": "0.19.1-dev.184.1.830a4c6"
   },
   "peerDependencies": {
     "@docusaurus/core": "^3.9.2",