@se-studio/ab-testing 18.1.0 → 18.2.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @se-studio/ab-testing
 
+## 18.2.0
+
+### Minor Changes
+
+- 3177455: AbTestStickyNavScript: beforeInteractive DOM patch for sticky nav CTA leaves (data-ab-sticky-cta), plus buildNavLeafOverridesBySlug helper — same early-apply pattern as AbTestUtmScript.
+
 ## 18.1.0
 
 ### Minor Changes

package/README.md

@@ -209,7 +209,19 @@ const overrides = useAbTestStickyNavOverrides({ testsByPath });
 const cta = applyNavLeafOverride(ssrCta, findNavLeafOverride(overrides, ctaPath));
 ```
 
-Editor pattern: clone the Navigation, change the CTA item, link it on `pageVariant.menu`. After deploy, that CTA follows the visitor site-wide for the assigned bucket. Brief control→variant flash on the CTA after JS is expected in v1.
+Editor pattern: clone the Navigation, change the CTA item, link it on `pageVariant.menu`. After deploy, that CTA follows the visitor site-wide for the assigned bucket.
+
+Optional early paint (same pattern as `AbTestUtmScript`): mark CTA hosts with `data-ab-sticky-cta="{indexPath}"` and mount in the root layout:
+
+```tsx
+import { AbTestStickyNavScript } from '@se-studio/ab-testing/components';
+import { testsByPath } from '@/generated/abTests';
+
+// root layout <head>:
+<AbTestStickyNavScript testsByPath={testsByPath} />
+```
+
+Keep the React hook path so HubSpot click props match after hydration. Brief control→variant flash is still possible if the script is omitted.
 
 ### 5. Create Your Analytics Reporter (Project-Specific)
 

package/dist/buildNavLeafOverridesBySlug.d.ts

@@ -0,0 +1,13 @@
+import type { CachedAbTest } from './middleware/types.js';
+import type { NavLeafOverride } from './types.js';
+/**
+ * Collapse baked `navLeafOverrides` across all tests into a slug → leaves map
+ * for {@link AbTestStickyNavScript} (beforeInteractive DOM patch).
+ *
+ * Later tests win on duplicate paths within the same slug; callers that need
+ * assignment-scoped merges should keep using {@link useAbTestStickyNavOverrides}.
+ */
+export declare function buildNavLeafOverridesBySlug(testsByPath: Record<string, CachedAbTest[]>): Record<string, NavLeafOverride[]>;
+/** DOM attribute sites put on sticky CTA hosts for {@link AbTestStickyNavScript}. */
+export declare const STICKY_NAV_CTA_ATTR = "data-ab-sticky-cta";
+//# sourceMappingURL=buildNavLeafOverridesBySlug.d.ts.map

package/dist/buildNavLeafOverridesBySlug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNavLeafOverridesBySlug.d.ts","sourceRoot":"","sources":["../src/buildNavLeafOverridesBySlug.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAC1C,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAYnC;AAED,qFAAqF;AACrF,eAAO,MAAM,mBAAmB,uBAAuB,CAAC"}

package/dist/buildNavLeafOverridesBySlug.js

@@ -0,0 +1,24 @@
+/**
+ * Collapse baked `navLeafOverrides` across all tests into a slug → leaves map
+ * for {@link AbTestStickyNavScript} (beforeInteractive DOM patch).
+ *
+ * Later tests win on duplicate paths within the same slug; callers that need
+ * assignment-scoped merges should keep using {@link useAbTestStickyNavOverrides}.
+ */
+export function buildNavLeafOverridesBySlug(testsByPath) {
+    const overridesBySlug = {};
+    for (const tests of Object.values(testsByPath)) {
+        for (const test of tests) {
+            if (!test.navLeafOverrides)
+                continue;
+            for (const [slug, leaves] of Object.entries(test.navLeafOverrides)) {
+                const existing = overridesBySlug[slug] ?? [];
+                overridesBySlug[slug] = [...existing, ...leaves];
+            }
+        }
+    }
+    return overridesBySlug;
+}
+/** DOM attribute sites put on sticky CTA hosts for {@link AbTestStickyNavScript}. */
+export const STICKY_NAV_CTA_ATTR = 'data-ab-sticky-cta';
+//# sourceMappingURL=buildNavLeafOverridesBySlug.js.map

package/dist/buildNavLeafOverridesBySlug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildNavLeafOverridesBySlug.js","sourceRoot":"","sources":["../src/buildNavLeafOverridesBySlug.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,WAA2C;IAE3C,MAAM,eAAe,GAAsC,EAAE,CAAC;IAC9D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAAE,SAAS;YACrC,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBACnE,MAAM,QAAQ,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7C,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAC"}

package/dist/components/AbTestStickyNavScript.d.ts

@@ -0,0 +1,25 @@
+import type { CachedAbTest } from '../middleware/types.js';
+export interface AbTestStickyNavScriptProps {
+    /**
+     * Baked testsByPath map from generate-ab-tests (same as the sticky hook).
+     */
+    testsByPath: Record<string, CachedAbTest[]>;
+    /**
+     * Cookie name to read assignments from.
+     * @default "ab-test-info"
+     */
+    cookieName?: string;
+}
+/**
+ * Inline script that patches sticky nav CTA leaves from the assignment cookie
+ * as early as possible (before React hydration), matching {@link AbTestUtmScript}.
+ *
+ * Sites mark CTA hosts with `data-ab-sticky-cta="{indexPath}"` (see
+ * {@link STICKY_NAV_CTA_ATTR}). Keep {@link useAbTestStickyNavOverrides} in the
+ * nav client so React props (and HubSpot click text) match after hydration.
+ *
+ * Must be rendered in the root layout only — Next.js requires
+ * `strategy="beforeInteractive"` scripts to live in the root layout.
+ */
+export declare function AbTestStickyNavScript({ testsByPath, cookieName, }: AbTestStickyNavScriptProps): import("react").JSX.Element;
+//# sourceMappingURL=AbTestStickyNavScript.d.ts.map

package/dist/components/AbTestStickyNavScript.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestStickyNavScript.d.ts","sourceRoot":"","sources":["../../src/components/AbTestStickyNavScript.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D,MAAM,WAAW,0BAA0B;IACzC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;IAC5C;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,EACpC,WAAW,EACX,UAA2B,GAC5B,EAAE,0BAA0B,+BAgF5B"}

package/dist/components/AbTestStickyNavScript.js

@@ -0,0 +1,93 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import Script from 'next/script';
+import { buildNavLeafOverridesBySlug, STICKY_NAV_CTA_ATTR, } from '../buildNavLeafOverridesBySlug.js';
+/**
+ * Inline script that patches sticky nav CTA leaves from the assignment cookie
+ * as early as possible (before React hydration), matching {@link AbTestUtmScript}.
+ *
+ * Sites mark CTA hosts with `data-ab-sticky-cta="{indexPath}"` (see
+ * {@link STICKY_NAV_CTA_ATTR}). Keep {@link useAbTestStickyNavOverrides} in the
+ * nav client so React props (and HubSpot click text) match after hydration.
+ *
+ * Must be rendered in the root layout only — Next.js requires
+ * `strategy="beforeInteractive"` scripts to live in the root layout.
+ */
+export function AbTestStickyNavScript({ testsByPath, cookieName = 'ab-test-info', }) {
+    const overridesBySlug = buildNavLeafOverridesBySlug(testsByPath);
+    const payload = JSON.stringify(overridesBySlug);
+    const attr = STICKY_NAV_CTA_ATTR;
+    return (_jsx(Script, { id: "ab-test-sticky-nav", strategy: "beforeInteractive", children: `
+(function() {
+  try {
+    var overridesBySlug = ${payload};
+    var cookieName = ${JSON.stringify(cookieName)};
+    var attr = ${JSON.stringify(attr)};
+    function readLeaves() {
+      var m = document.cookie.match(new RegExp('(?:^| )' + cookieName + '=([^;]+)'));
+      if (!m) return [];
+      var assignments = JSON.parse(decodeURIComponent(m[1]));
+      var leaves = [];
+      var seen = {};
+      for (var testId in assignments) {
+        if (!Object.prototype.hasOwnProperty.call(assignments, testId)) continue;
+        var slug = assignments[testId] && assignments[testId].variant_slug;
+        if (!slug || slug === 'control') continue;
+        var list = overridesBySlug[slug];
+        if (!list || !list.length) continue;
+        for (var i = 0; i < list.length; i++) {
+          var leaf = list[i];
+          if (!leaf || !leaf.path || seen[leaf.path]) continue;
+          seen[leaf.path] = true;
+          leaves.push(leaf);
+        }
+      }
+      return leaves;
+    }
+    var applying = false;
+    function applyLeaves(leaves) {
+      if (!leaves.length || applying) return;
+      applying = true;
+      try {
+        var nodes = document.querySelectorAll('[' + attr + ']');
+        for (var n = 0; n < nodes.length; n++) {
+          var host = nodes[n];
+          var path = host.getAttribute(attr);
+          if (!path) continue;
+          var el =
+            host.tagName === 'A' || host.tagName === 'BUTTON'
+              ? host
+              : host.querySelector('a,button');
+          if (!el) continue;
+          for (var i = 0; i < leaves.length; i++) {
+            if (leaves[i].path !== path) continue;
+            if (leaves[i].label && el.textContent !== leaves[i].label) {
+              el.textContent = leaves[i].label;
+            }
+            if (
+              leaves[i].href != null &&
+              el.tagName === 'A' &&
+              el.getAttribute('href') !== leaves[i].href
+            ) {
+              el.setAttribute('href', leaves[i].href);
+            }
+            break;
+          }
+        }
+      } finally {
+        applying = false;
+      }
+    }
+    function run() {
+      if (applying) return;
+      applyLeaves(readLeaves());
+    }
+    run();
+    if (typeof MutationObserver !== 'undefined') {
+      var obs = new MutationObserver(run);
+      obs.observe(document.documentElement, { childList: true, subtree: true });
+    }
+  } catch (e) {}
+})();
+    ` }));
+}
+//# sourceMappingURL=AbTestStickyNavScript.js.map

package/dist/components/AbTestStickyNavScript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbTestStickyNavScript.js","sourceRoot":"","sources":["../../src/components/AbTestStickyNavScript.tsx"],"names":[],"mappings":";AAAA,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,mCAAmC,CAAC;AAe3C;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACpC,WAAW,EACX,UAAU,GAAG,cAAc,GACA;IAC3B,MAAM,eAAe,GAAG,2BAA2B,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,mBAAmB,CAAC;IAEjC,OAAO,CACL,KAAC,MAAM,IAAC,EAAE,EAAC,oBAAoB,EAAC,QAAQ,EAAC,mBAAmB,YAAE;;;4BAGtC,OAAO;uBACZ,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;iBAChC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAmEhC,GAAU,CACZ,CAAC;AACJ,CAAC"}

package/dist/components/index.d.ts

@@ -1,3 +1,5 @@
 export { AbTestReporter } from './AbTestReporter';
+export type { AbTestStickyNavScriptProps } from './AbTestStickyNavScript';
+export { AbTestStickyNavScript } from './AbTestStickyNavScript';
 export { AbTestUtmScript } from './AbTestUtmScript';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAC1E,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/components/index.js

@@ -1,3 +1,4 @@
 export { AbTestReporter } from './AbTestReporter';
+export { AbTestStickyNavScript } from './AbTestStickyNavScript';
 export { AbTestUtmScript } from './AbTestUtmScript';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  *
  * @packageDocumentation
  */
+export { buildNavLeafOverridesBySlug, STICKY_NAV_CTA_ATTR, } from './buildNavLeafOverridesBySlug.js';
 export type { ActiveAbTestAssignment, UseAbTestAssignmentsOptions, UseAbTestStickyNavOverridesOptions, } from './hooks/index.js';
 export { applyNavLeafOverride, findNavLeafOverride, useAbTestAssignments, useAbTestStickyNavOverrides, } from './hooks/index.js';
 export type { AbTestMiddlewareConfig, AbTestResult, CachedAbTest, StaticAbTestMiddlewareOptions, TestsCache, } from './middleware/index.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAC1C,YAAY,EACV,sBAAsB,EACtB,2BAA2B,EAC3B,kCAAkC,GACnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,sBAAsB,EACtB,YAAY,EACZ,YAAY,EACZ,6BAA6B,EAC7B,UAAU,GACX,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAErF,YAAY,EACV,MAAM,EACN,gBAAgB,EAChB,YAAY,EACZ,aAAa,EACb,mBAAmB,EACnB,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAChG,YAAY,EACV,WAAW,EACX,oBAAoB,EACpB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -5,6 +5,8 @@
  *
  * @packageDocumentation
  */
+// Sticky nav leaf helpers (codegen + sites)
+export { buildNavLeafOverridesBySlug, STICKY_NAV_CTA_ATTR, } from './buildNavLeafOverridesBySlug.js';
 // Re-export hooks
 export { applyNavLeafOverride, findNavLeafOverride, useAbTestAssignments, useAbTestStickyNavOverrides, } from './hooks/index.js';
 // Re-export middleware utilities

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAQ1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAWrF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhG,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4CAA4C;AAC5C,OAAO,EACL,2BAA2B,EAC3B,mBAAmB,GACpB,MAAM,kCAAkC,CAAC;AAM1C,kBAAkB;AAClB,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAQ1B,iCAAiC;AACjC,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,sBAAsB,EACtB,gBAAgB,EAChB,4BAA4B,EAC5B,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,WAAW,EACX,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,aAAa,GACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,0CAA0C,CAAC;AAWrF,YAAY;AACZ,OAAO,EAAE,iBAAiB,EAAE,4BAA4B,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAMhG,8BAA8B;AAC9B,OAAO,EACL,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/docs/llms.md

@@ -87,6 +87,7 @@ const cta = applyNavLeafOverride(ssrCta, findNavLeafOverride(overrides, ctaPath)
 - Control bucket → empty overrides (SSR default nav).
 - Shape mismatch / missing menu → codegen skips sticky nav for that variant (warns, does not fail build).
 - `experiment_impression` stays path-scoped via `useAbTestAssignments`; sticky chrome does not re-fire exposure.
+- Optional early DOM patch: `AbTestStickyNavScript` from `@se-studio/ab-testing/components` with `testsByPath`, plus `data-ab-sticky-cta` markers on CTA hosts (`STICKY_NAV_CTA_ATTR`). Mount next to `AbTestUtmScript` in the root layout. Keep the hook so React/HubSpot props stay aligned after hydration.
 
 ## Webhook Handler (Contentful → update test cache)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/ab-testing",
-  "version": "18.1.0",
+  "version": "18.2.0",
   "description": "Server-side A/B testing framework for Next.js applications with Contentful CMS",
   "repository": {
     "type": "git",