@sentientui/react 0.2.0 → 0.3.0

package/README.md

@@ -0,0 +1,150 @@
+# @sentientui/react
+
+React SDK for [SentientUI](https://sentientui.dev) — drop-in components and hooks that let a contextual bandit automatically serve the best-performing UI variant for each visitor.
+
+## Installation
+
+```bash
+npm install @sentientui/react @sentientui/core
+```
+
+## Quick start
+
+### 1. Wrap your app with `AdaptiveProvider`
+
+```tsx
+import { AdaptiveProvider } from '@sentientui/react';
+
+export default function App({ children }) {
+  return (
+    <AdaptiveProvider apiKey="pk_your_key" context="saas">
+      {children}
+    </AdaptiveProvider>
+  );
+}
+```
+
+### 2. Add an `<Adaptive>` component
+
+```tsx
+import { Adaptive } from '@sentientui/react';
+
+export default function Hero() {
+  return (
+    <Adaptive
+      id="hero-headline"
+      goal="click"
+      variants={{
+        control: <h1>Ship faster with SentientUI</h1>,
+        variant_b: <h1>Your UI, optimised automatically</h1>,
+      }}
+    />
+  );
+}
+```
+
+The bandit tracks which variant drives more clicks and gradually shifts traffic toward the winner.
+
+## Next.js (App Router)
+
+Use `AdaptiveRoot` in your layout for SEO-safe server-rendered assignments with no variant flash:
+
+```tsx
+// app/layout.tsx
+import { AdaptiveRoot } from '@sentientui/react/next';
+
+export default function Layout({ children }) {
+  return (
+    <AdaptiveRoot
+      components={[
+        { id: 'hero-headline', variantIds: ['control', 'variant_b'] },
+        { id: 'pricing-cta', variantIds: ['control', 'variant_b'] },
+      ]}
+      serverApiKey={process.env.SENTIENT_API_KEY!}
+      apiKey={process.env.NEXT_PUBLIC_SENTIENT_API_KEY!}
+      context="saas"
+    >
+      {children}
+    </AdaptiveRoot>
+  );
+}
+```
+
+`AdaptiveRoot` is a Server Component that fetches assignments before HTML is sent, then passes them to `AdaptiveProvider` as `initialAssignments` so crawlers and hydration see real content.
+
+## API
+
+### `<AdaptiveProvider>`
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `apiKey` | `string` | Your public API key (`pk_…`) |
+| `context` | `string` | Site context — `'landing'`, `'ecommerce'`, `'saas'`, or `'marketplace'` |
+| `initialAssignments` | `Record<string, string>` | SSR-preloaded assignments (prevents hydration mismatch) |
+| `sessionSegment` | `string` | Segment string from SSR (`device:source`) |
+| `ssrFallback` | `'first' \| 'none'` | How to render adaptive slots without preloaded assignments. `'first'` renders the first variant (good for SEO). Defaults to `'first'` |
+| `consent` | `boolean` | Set to `false` to disable tracking before cookie consent |
+| `onAssignment` | `(componentId, variantId) => void` | Called once per component per session — forward to Mixpanel, PostHog, Segment, etc. |
+| `debug` | `boolean` | Logs events to the console |
+
+### `<Adaptive>`
+
+| Prop | Type | Description |
+|------|------|-------------|
+| `id` | `string` | Unique component identifier |
+| `variants` | `Record<string, ReactNode>` | Map of variant ID → content |
+| `goal` | `string \| GoalConfig` | Conversion goal. Pass a string label for click tracking, or a `GoalConfig` object for scroll depth, form submit, or composite goals |
+| `clientOnly` | `boolean` | Skip SSR rendering — use for decorative slots where a blank placeholder is preferable to a hydration mismatch |
+
+#### Goal types
+
+```ts
+// Click on anything inside the variant
+goal="click"
+
+// Click on a specific element
+goal={{ type: 'click', selector: 'button.cta' }}
+
+// User scrolls past 80% of the page
+goal={{ type: 'scroll_depth', threshold: 80 }}
+
+// A form inside the variant is submitted
+goal={{ type: 'form_submit' }}
+
+// Multiple goals must all fire
+goal={{ type: 'composite', all: [{ type: 'scroll_depth', threshold: 50 }, { type: 'click' }] }}
+```
+
+### `useAssignment(componentId, variantIds)`
+
+Lower-level hook for manual variant resolution when you need full control over rendering.
+
+```tsx
+import { useAssignment } from '@sentientui/react';
+
+function MyComponent() {
+  const { variantId, isLoading } = useAssignment('hero', ['control', 'variant_b']);
+
+  if (isLoading) return <Skeleton />;
+  return variantId === 'variant_b' ? <NewHero /> : <DefaultHero />;
+}
+```
+
+### `onAssignment` — forwarding to analytics
+
+```tsx
+<AdaptiveProvider
+  apiKey="pk_…"
+  context="saas"
+  onAssignment={(componentId, variantId) => {
+    posthog.capture('$experiment_started', {
+      experiment_name: componentId,
+      variant: variantId,
+    });
+  }}
+>
+```
+
+## License
+
+MIT

package/dist/index.d.cts

@@ -2,13 +2,13 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { SentientConfig, SentientClient } from '@sentientui/core';
 export { deriveSessionSegment as detectSegment } from '@sentientui/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** How to render adaptive slots during SSR when assignments are not preloaded. */
 type SsrFallback = 'first' | 'none';
 type AdaptiveProviderProps = {
     apiKey: string;
     context: SentientConfig['context'];
-    ingestUrl: string;
     debug?: boolean;
     /**
      * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.
@@ -40,6 +40,12 @@ type AdaptiveProviderProps = {
      * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.
      */
     onAssignment?: (componentId: string, variantId: string) => void;
+    /**
+     * SSR-preloaded section order from `loadAdaptiveDecision()`.
+     * Pass the `layoutOrder` field from `DecideResult`. When set,
+     * `useLayoutOrder()` returns this on first render so there is no layout shift.
+     */
+    initialLayoutOrder?: string[] | null;
     children: ReactNode;
 };
 /**
@@ -54,6 +60,11 @@ declare function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element;
 declare function useSentient(): SentientClient | null;
 /** Internal: SSR-preloaded assignments for hydration-safe first render. */
 declare function useInitialAssignments(): Record<string, string>;
+/**
+ * Returns the persona-specific section order from SSR, or null when no
+ * sections were declared on AdaptiveRoot or reliability is below threshold.
+ */
+declare function useLayoutOrder(): string[] | null;
 
 type ScrollDepthGoal = {
     type: 'scroll_depth';
@@ -86,6 +97,14 @@ declare function AdaptiveImpl(props: AdaptiveProps): JSX.Element | null;
 /** Re-renders only when the chosen variant changes. */
 declare const Adaptive: react.MemoExoticComponent<typeof AdaptiveImpl>;
 
+type AdaptiveTextProps = {
+    id: string;
+    default: string;
+    component?: keyof JSX.IntrinsicElements;
+    className?: string;
+};
+declare function AdaptiveText({ id, default: defaultText, component: Tag, className, }: AdaptiveTextProps): react_jsx_runtime.JSX.Element;
+
 declare global {
     interface Window {
         __sentient_overrides?: Record<string, string>;
@@ -133,4 +152,4 @@ declare function update(componentId: string, weights: ComponentWeights): void;
  */
 declare function getWeights(componentId: string): ComponentWeights | null;
 
-export { Adaptive, type AdaptiveProps, AdaptiveProvider, type AdaptiveProviderProps, type AssignmentState, type ClickGoal, type ComponentWeights, type CompositeGoal, type FormSubmitGoal, type GoalConfig, type ScrollDepthGoal, type SsrFallback, type VariantWeight, getWeights, subscribe as subscribeWeights, update as updateWeights, useAssignment, useInitialAssignments, useSentient };
+export { Adaptive, type AdaptiveProps, AdaptiveProvider, type AdaptiveProviderProps, AdaptiveText, type AdaptiveTextProps, type AssignmentState, type ClickGoal, type ComponentWeights, type CompositeGoal, type FormSubmitGoal, type GoalConfig, type ScrollDepthGoal, type SsrFallback, type VariantWeight, getWeights, subscribe as subscribeWeights, update as updateWeights, useAssignment, useInitialAssignments, useLayoutOrder, useSentient };

package/dist/index.d.ts

@@ -2,13 +2,13 @@ import * as react from 'react';
 import { ReactNode } from 'react';
 import { SentientConfig, SentientClient } from '@sentientui/core';
 export { deriveSessionSegment as detectSegment } from '@sentientui/core';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /** How to render adaptive slots during SSR when assignments are not preloaded. */
 type SsrFallback = 'first' | 'none';
 type AdaptiveProviderProps = {
     apiKey: string;
     context: SentientConfig['context'];
-    ingestUrl: string;
     debug?: boolean;
     /**
      * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.
@@ -40,6 +40,12 @@ type AdaptiveProviderProps = {
      * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.
      */
     onAssignment?: (componentId: string, variantId: string) => void;
+    /**
+     * SSR-preloaded section order from `loadAdaptiveDecision()`.
+     * Pass the `layoutOrder` field from `DecideResult`. When set,
+     * `useLayoutOrder()` returns this on first render so there is no layout shift.
+     */
+    initialLayoutOrder?: string[] | null;
     children: ReactNode;
 };
 /**
@@ -54,6 +60,11 @@ declare function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element;
 declare function useSentient(): SentientClient | null;
 /** Internal: SSR-preloaded assignments for hydration-safe first render. */
 declare function useInitialAssignments(): Record<string, string>;
+/**
+ * Returns the persona-specific section order from SSR, or null when no
+ * sections were declared on AdaptiveRoot or reliability is below threshold.
+ */
+declare function useLayoutOrder(): string[] | null;
 
 type ScrollDepthGoal = {
     type: 'scroll_depth';
@@ -86,6 +97,14 @@ declare function AdaptiveImpl(props: AdaptiveProps): JSX.Element | null;
 /** Re-renders only when the chosen variant changes. */
 declare const Adaptive: react.MemoExoticComponent<typeof AdaptiveImpl>;
 
+type AdaptiveTextProps = {
+    id: string;
+    default: string;
+    component?: keyof JSX.IntrinsicElements;
+    className?: string;
+};
+declare function AdaptiveText({ id, default: defaultText, component: Tag, className, }: AdaptiveTextProps): react_jsx_runtime.JSX.Element;
+
 declare global {
     interface Window {
         __sentient_overrides?: Record<string, string>;
@@ -133,4 +152,4 @@ declare function update(componentId: string, weights: ComponentWeights): void;
  */
 declare function getWeights(componentId: string): ComponentWeights | null;
 
-export { Adaptive, type AdaptiveProps, AdaptiveProvider, type AdaptiveProviderProps, type AssignmentState, type ClickGoal, type ComponentWeights, type CompositeGoal, type FormSubmitGoal, type GoalConfig, type ScrollDepthGoal, type SsrFallback, type VariantWeight, getWeights, subscribe as subscribeWeights, update as updateWeights, useAssignment, useInitialAssignments, useSentient };
+export { Adaptive, type AdaptiveProps, AdaptiveProvider, type AdaptiveProviderProps, AdaptiveText, type AdaptiveTextProps, type AssignmentState, type ClickGoal, type ComponentWeights, type CompositeGoal, type FormSubmitGoal, type GoalConfig, type ScrollDepthGoal, type SsrFallback, type VariantWeight, getWeights, subscribe as subscribeWeights, update as updateWeights, useAssignment, useInitialAssignments, useLayoutOrder, useSentient };

package/dist/index.js

@@ -23,12 +23,14 @@ var src_exports = {};
 __export(src_exports, {
   Adaptive: () => Adaptive,
   AdaptiveProvider: () => AdaptiveProvider,
+  AdaptiveText: () => AdaptiveText,
   detectSegment: () => import_core2.deriveSessionSegment,
   getWeights: () => getWeights,
   subscribeWeights: () => subscribe,
   updateWeights: () => update,
   useAssignment: () => useAssignment,
   useInitialAssignments: () => useInitialAssignments,
+  useLayoutOrder: () => useLayoutOrder,
   useSentient: () => useSentient
 });
 module.exports = __toCommonJS(src_exports);
@@ -43,10 +45,11 @@ var AdaptiveContext = (0, import_react.createContext)({
   initialAssignments: {},
   sessionSegment: "desktop:direct",
   ssrFallback: "first",
-  onAssignment: void 0
+  onAssignment: void 0,
+  initialLayoutOrder: null
 });
 function AdaptiveProvider(props) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const [client, setClient] = (0, import_react.useState)(null);
   (0, import_react.useEffect)(() => {
     if (props.consent === false) {
@@ -59,7 +62,6 @@ function AdaptiveProvider(props) {
     const c = (0, import_core.init)({
       apiKey: props.apiKey,
       context: props.context,
-      ingestUrl: props.ingestUrl,
       debug: props.debug,
       initialAssignments: props.initialAssignments,
       sessionSegment: props.sessionSegment,
@@ -80,7 +82,8 @@ function AdaptiveProvider(props) {
         initialAssignments: (_b = props.initialAssignments) != null ? _b : {},
         sessionSegment: (_c = props.sessionSegment) != null ? _c : "desktop:direct",
         ssrFallback,
-        onAssignment: props.onAssignment
+        onAssignment: props.onAssignment,
+        initialLayoutOrder: (_d = props.initialLayoutOrder) != null ? _d : null
       },
       children: props.children
     }
@@ -104,6 +107,9 @@ function useSsrFallback() {
 function useOnAssignment() {
   return (0, import_react.useContext)(AdaptiveContext).onAssignment;
 }
+function useLayoutOrder() {
+  return (0, import_react.useContext)(AdaptiveContext).initialLayoutOrder;
+}
 
 // src/adaptive.tsx
 var import_react3 = require("react");
@@ -437,18 +443,63 @@ var Adaptive = (0, import_react3.memo)(AdaptiveImpl, (prev, next) => {
   return prevKeys.every((k) => k in next.variants);
 });
 
+// src/adaptive-text.tsx
+var import_react4 = require("react");
+var import_jsx_runtime3 = require("react/jsx-runtime");
+function AdaptiveText({
+  id,
+  default: defaultText,
+  component: Tag = "span",
+  className
+}) {
+  const client = useSentient();
+  const projectId = useAdaptiveProjectId();
+  const onAssignment = useOnAssignment();
+  const [text, setText] = (0, import_react4.useState)(null);
+  const [variantId, setVariantId] = (0, import_react4.useState)(null);
+  const trackedRef = (0, import_react4.useRef)(null);
+  (0, import_react4.useEffect)(() => {
+    if (!client) return;
+    let cancelled = false;
+    void client.assign(id).then((result) => {
+      if (cancelled || !result) return;
+      setVariantId(result.variantId);
+      if (result.content) setText(result.content);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, id]);
+  (0, import_react4.useEffect)(() => {
+    if (!client || !variantId || !projectId) return;
+    if (trackedRef.current === variantId) return;
+    trackedRef.current = variantId;
+    client.track({
+      projectId,
+      componentId: id,
+      variantId,
+      eventType: "variant_assigned",
+      payload: {}
+    });
+    onAssignment == null ? void 0 : onAssignment(id, variantId);
+  }, [client, variantId, projectId, id, onAssignment]);
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Tag, { className, children: text != null ? text : defaultText });
+}
+
 // src/segment.ts
 var import_core2 = require("@sentientui/core");
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Adaptive,
   AdaptiveProvider,
+  AdaptiveText,
   detectSegment,
   getWeights,
   subscribeWeights,
   updateWeights,
   useAssignment,
   useInitialAssignments,
+  useLayoutOrder,
   useSentient
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["export { AdaptiveProvider, useSentient, useInitialAssignments } from './provider.js';\r\nexport type { AdaptiveProviderProps, SsrFallback } from './provider.js';\r\n\r\nexport { Adaptive } from './adaptive.js';\r\nexport type {\r\n  AdaptiveProps,\r\n  GoalConfig,\r\n  ClickGoal,\r\n  ScrollDepthGoal,\r\n  FormSubmitGoal,\r\n  CompositeGoal,\r\n} from './adaptive.js';\r\n\r\nexport { useAssignment } from './use-assignment.js';\r\nexport type { AssignmentState } from './use-assignment.js';\r\n\r\nexport {\r\n  subscribe as subscribeWeights,\r\n  update as updateWeights,\r\n  getWeights,\r\n} from './weights-store.js';\r\nexport type { ComponentWeights, VariantWeight } from './weights-store.js';\r\n\r\nexport { detectSegment } from './segment.js';\r\n","'use client';\r\n\r\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\r\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\r\n\r\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\r\nexport type SsrFallback = 'first' | 'none';\r\n\r\ntype AdaptiveContextValue = {\r\n  client: SentientClient | null;\r\n  projectId: string;\r\n  initialAssignments: Record<string, string>;\r\n  sessionSegment: string;\r\n  ssrFallback: SsrFallback;\r\n  onAssignment: ((componentId: string, variantId: string) => void) | undefined;\r\n};\r\n\r\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\r\n  client: null,\r\n  projectId: '',\r\n  initialAssignments: {},\r\n  sessionSegment: 'desktop:direct',\r\n  ssrFallback: 'first',\r\n  onAssignment: undefined,\r\n});\r\n\r\nexport type AdaptiveProviderProps = {\r\n  apiKey: string;\r\n  context: SentientConfig['context'];\r\n  ingestUrl: string;\r\n  debug?: boolean;\r\n  /**\r\n   * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\r\n   * Passed through to `useAssignment` as synchronous initial state so crawlers and\r\n   * the first paint see real content (recommended for SEO).\r\n   */\r\n  initialAssignments?: Record<string, string>;\r\n  /**\r\n   * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\r\n   * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\r\n   */\r\n  sessionSegment?: string;\r\n  /**\r\n   * When no `initialAssignments` exist for a component, `'first'` renders\r\n   * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\r\n   * decorative slots marked `clientOnly`.\r\n   * @default 'first'\r\n   */\r\n  ssrFallback?: SsrFallback;\r\n  /**\r\n   * Consent gate. When `false` the SDK is not initialised and no events are\r\n   * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\r\n   * initialise and begin tracking.\r\n   */\r\n  consent?: boolean;\r\n  /**\r\n   * Called once per component the first time a variant is resolved for that\r\n   * component in this session. Use to forward assignments to your own analytics\r\n   * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\r\n   */\r\n  onAssignment?: (componentId: string, variantId: string) => void;\r\n  children: ReactNode;\r\n};\r\n\r\n/**\r\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\r\n * client via React context. Re-initialises when `consent` changes.\r\n */\r\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\r\n  const [client, setClient] = useState<SentientClient | null>(null);\r\n\r\n  useEffect(() => {\r\n    // When consent is explicitly false, tear down any existing client.\r\n    if (props.consent === false) {\r\n      setClient((prev: SentientClient | null) => {\r\n        prev?.destroy();\r\n        return null;\r\n      });\r\n      return;\r\n    }\r\n\r\n    const c = init({\r\n      apiKey: props.apiKey,\r\n      context: props.context,\r\n      ingestUrl: props.ingestUrl,\r\n      debug: props.debug,\r\n      initialAssignments: props.initialAssignments,\r\n      sessionSegment: props.sessionSegment,\r\n      consent: props.consent,\r\n    });\r\n    setClient(c);\r\n    return () => {\r\n      c.destroy();\r\n    };\r\n    // Re-init when consent changes. Other props are intentionally stable.\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [props.consent]);\r\n\r\n  const ssrFallback = props.ssrFallback ?? 'first';\r\n\r\n  return (\r\n    <AdaptiveContext.Provider\r\n      value={{\r\n        client,\r\n        projectId: props.apiKey,\r\n        initialAssignments: props.initialAssignments ?? {},\r\n        sessionSegment: props.sessionSegment ?? 'desktop:direct',\r\n        ssrFallback,\r\n        onAssignment: props.onAssignment,\r\n      }}\r\n    >\r\n      {props.children}\r\n    </AdaptiveContext.Provider>\r\n  );\r\n}\r\n\r\n/**\r\n * Returns the SentientClient, or null until the provider has finished\r\n * initialising on the client.\r\n */\r\nexport function useSentient(): SentientClient | null {\r\n  return useContext(AdaptiveContext).client;\r\n}\r\n\r\n/** Internal: project identifier carried alongside the client. */\r\nexport function useAdaptiveProjectId(): string {\r\n  return useContext(AdaptiveContext).projectId;\r\n}\r\n\r\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\r\nexport function useInitialAssignments(): Record<string, string> {\r\n  return useContext(AdaptiveContext).initialAssignments;\r\n}\r\n\r\n/** Internal: bandit segment aligned with SSR session upsert. */\r\nexport function useSessionSegment(): string {\r\n  return useContext(AdaptiveContext).sessionSegment;\r\n}\r\n\r\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\r\nexport function useSsrFallback(): SsrFallback {\r\n  return useContext(AdaptiveContext).ssrFallback;\r\n}\r\n\r\n/** Internal: forwarding hook for consumer analytics integration. */\r\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\r\n  return useContext(AdaptiveContext).onAssignment;\r\n}\r\n","'use client';\r\n\r\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\r\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\r\nimport { useAssignment } from './use-assignment.js';\r\n\r\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\r\nexport type ClickGoal = { type: 'click'; selector?: string };\r\nexport type FormSubmitGoal = { type: 'form_submit' };\r\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\r\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\r\n\r\nexport type AdaptiveProps = {\r\n  id: string;\r\n  variants: Record<string, ReactNode>;\r\n  goal: string | GoalConfig;\r\n  /**\r\n   * When true, renders nothing during SSR and before client hydration.\r\n   * Use when you cannot pass `initialAssignments` and prefer a blank slot over\r\n   * a hydration mismatch. Tradeoff: minor CLS on first paint.\r\n   */\r\n  clientOnly?: boolean;\r\n};\r\n\r\nfunction normalize(goal: string | GoalConfig): GoalConfig {\r\n  if (typeof goal === 'string') return { type: 'click' };\r\n  return goal;\r\n}\r\n\r\nfunction isClickableTarget(el: EventTarget | null): boolean {\r\n  if (!(el instanceof Element)) return false;\r\n  const tag = el.tagName.toLowerCase();\r\n  if (tag === 'a' || tag === 'button') return true;\r\n  const role = el.getAttribute('role');\r\n  return role === 'button';\r\n}\r\n\r\nfunction findClickable(start: Element, container: Element): boolean {\r\n  let cursor: Element | null = start;\r\n  while (cursor && cursor !== container) {\r\n    if (isClickableTarget(cursor)) return true;\r\n    cursor = cursor.parentElement;\r\n  }\r\n  return false;\r\n}\r\n\r\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\r\n  const client = useSentient();\r\n  const projectId = useAdaptiveProjectId();\r\n  const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\r\n  const { variantId } = useAssignment(props.id, variantIds);\r\n  const containerRef = useRef<HTMLDivElement>(null);\r\n  const [mounted, setMounted] = useState(false);\r\n\r\n  useEffect(() => { setMounted(true); }, []);\r\n  const goalFiredRef = useRef(false);\r\n  const assignTrackedRef = useRef<string | null>(null);\r\n  const goal = useMemo(() => normalize(props.goal), [props.goal]);\r\n  const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\r\n\r\n  // Track variant_assigned exactly once per (component, variant) mount.\r\n  // Captures innerHTML as previewHtml so the dashboard can render a live preview\r\n  // without requiring manual registry calls. First-seen wins on the server.\r\n  // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\r\n  // and their container div is actually in the DOM.\r\n  useEffect(() => {\r\n    if (!client || !variantId || !projectId) return;\r\n    if (assignTrackedRef.current === variantId) return;\r\n    const rawHtml = containerRef.current?.innerHTML ?? '';\r\n    // For clientOnly, the container is null until mounted — defer until it exists.\r\n    if (!rawHtml && !mounted) return;\r\n    assignTrackedRef.current = variantId;\r\n    client.track({\r\n      projectId,\r\n      componentId: props.id,\r\n      variantId,\r\n      eventType: 'variant_assigned',\r\n      payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\r\n    });\r\n  }, [client, variantId, projectId, props.id, mounted]);\r\n\r\n  // Reset goal latch when variant changes.\r\n  useEffect(() => {\r\n    goalFiredRef.current = false;\r\n  }, [variantId]);\r\n\r\n  // Emit cursor_signal after 800 ms of continuous hover.\r\n  useEffect(() => {\r\n    if (!client || !variantId) return;\r\n    const node = containerRef.current;\r\n    if (!node) return;\r\n\r\n    let timerId: ReturnType<typeof setTimeout> | null = null;\r\n    let hoverStart = 0;\r\n\r\n    const onEnter = (): void => {\r\n      hoverStart = Date.now();\r\n      timerId = setTimeout(() => {\r\n        client.track({\r\n          projectId,\r\n          componentId: props.id,\r\n          variantId: variantId!,\r\n          eventType: 'cursor_signal',\r\n          payload: { hoverDuration: Date.now() - hoverStart },\r\n        });\r\n        timerId = null;\r\n      }, 800);\r\n    };\r\n\r\n    const onLeave = (): void => {\r\n      if (timerId !== null) {\r\n        clearTimeout(timerId);\r\n        timerId = null;\r\n      }\r\n    };\r\n\r\n    node.addEventListener('mouseenter', onEnter);\r\n    node.addEventListener('mouseleave', onLeave);\r\n    return () => {\r\n      node.removeEventListener('mouseenter', onEnter);\r\n      node.removeEventListener('mouseleave', onLeave);\r\n      if (timerId !== null) clearTimeout(timerId);\r\n    };\r\n  }, [client, variantId, projectId, props.id]);\r\n\r\n  // Attach goal tracking.\r\n  useEffect(() => {\r\n    if (!client || !variantId) return;\r\n    const node = containerRef.current;\r\n    if (!node) return;\r\n\r\n    const fireGoal = (): void => {\r\n      if (goalFiredRef.current) return;\r\n      goalFiredRef.current = true;\r\n      client.track({\r\n        projectId,\r\n        componentId: props.id,\r\n        variantId,\r\n        eventType: 'goal_achieved',\r\n        goalType: goalLabel,\r\n        payload: { reward: 1.0 },\r\n      });\r\n    };\r\n\r\n    const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\r\n    const remaining = new Set<number>(subgoals.map((_, i) => i));\r\n    const checkComposite = (idx: number): void => {\r\n      remaining.delete(idx);\r\n      if (remaining.size === 0) fireGoal();\r\n    };\r\n\r\n    const cleanups: Array<() => void> = [];\r\n\r\n    subgoals.forEach((sub, idx) => {\r\n      if (sub.type === 'click') {\r\n        const onClick = (e: MouseEvent): void => {\r\n          const target = e.target;\r\n          if (!(target instanceof Element)) return;\r\n          if (!findClickable(target, node)) return;\r\n          if (goal.type === 'composite') checkComposite(idx);\r\n          else fireGoal();\r\n        };\r\n        node.addEventListener('click', onClick);\r\n        cleanups.push(() => node.removeEventListener('click', onClick));\r\n        return;\r\n      }\r\n\r\n      if (sub.type === 'form_submit') {\r\n        const onSubmit = (e: Event): void => {\r\n          if (!(e.target instanceof HTMLFormElement)) return;\r\n          if (!node.contains(e.target)) return;\r\n          if (goal.type === 'composite') checkComposite(idx);\r\n          else fireGoal();\r\n        };\r\n        node.addEventListener('submit', onSubmit);\r\n        cleanups.push(() => node.removeEventListener('submit', onSubmit));\r\n        return;\r\n      }\r\n\r\n      if (sub.type === 'scroll_depth') {\r\n        const threshold = Math.max(0, Math.min(1, sub.threshold));\r\n        const io = new IntersectionObserver(\r\n          (entries) => {\r\n            for (const entry of entries) {\r\n              if (entry.intersectionRatio >= threshold) {\r\n                if (goal.type === 'composite') checkComposite(idx);\r\n                else fireGoal();\r\n                io.disconnect();\r\n                break;\r\n              }\r\n            }\r\n          },\r\n          { threshold: [threshold] },\r\n        );\r\n        io.observe(node);\r\n        cleanups.push(() => io.disconnect());\r\n        return;\r\n      }\r\n    });\r\n\r\n    return () => {\r\n      for (const c of cleanups) c();\r\n    };\r\n  }, [client, variantId, projectId, props.id, goal, goalLabel]);\r\n\r\n  // Decorative slots: empty in SSR HTML and until the client has mounted.\r\n  if (props.clientOnly && (!mounted || !client)) return null;\r\n  if (!variantId) return null;\r\n  const content = props.variants[variantId] ?? null;\r\n\r\n  return (\r\n    <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\r\n      {content}\r\n    </div>\r\n  );\r\n}\r\n\r\n/** Re-renders only when the chosen variant changes. */\r\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\r\n  if (prev.id !== next.id) return false;\r\n  if (prev.goal !== next.goal) return false;\r\n  if (prev.variants === next.variants) return true;\r\n  const prevKeys = Object.keys(prev.variants);\r\n  const nextKeys = Object.keys(next.variants);\r\n  if (prevKeys.length !== nextKeys.length) return false;\r\n  return prevKeys.every((k) => k in next.variants);\r\n});\r\n","import { useEffect, useRef, useState } from 'react';\r\nimport { type AssignResult } from '@sentientui/core';\r\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\r\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\r\n\r\ndeclare global {\r\n  interface Window { __sentient_overrides?: Record<string, string>; }\r\n}\r\n\r\nfunction getDevOverride(componentId: string): string | null {\r\n  if (typeof window === 'undefined') return null;\r\n  const global = window.__sentient_overrides?.[componentId];\r\n  if (global) return global;\r\n  try {\r\n    const params = new URLSearchParams(window.location.search);\r\n    for (const raw of params.getAll('sentient_variant')) {\r\n      // sentient_variant=componentId:variantId  (repeatable for multiple components)\r\n      const sep = raw.indexOf(':');\r\n      if (sep === -1) continue;\r\n      if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\r\n    }\r\n  } catch { /* non-browser env */ }\r\n  return null;\r\n}\r\n\r\nexport type AssignmentState = {\r\n  variantId: string | null;\r\n  isLoading: boolean;\r\n};\r\n\r\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\r\n  let best: { variantId: string; avgReward: number } | null = null;\r\n  for (const v of weights.variants) {\r\n    if (!variantIds.includes(v.variantId)) continue;\r\n    if (!best || v.avgReward > best.avgReward) {\r\n      best = { variantId: v.variantId, avgReward: v.avgReward };\r\n    }\r\n  }\r\n  return best?.variantId ?? null;\r\n}\r\n\r\n/**\r\n * Returns a sticky variant assignment for a component.\r\n *\r\n * First render reads the local SDK cache; if empty, falls back to a\r\n * deterministic default and asynchronously calls `/v1/assign`. The server\r\n * picks the actual variant via ε-greedy and the result replaces the fallback\r\n * on the next render. Subsequent paints read synchronously from cache —\r\n * no flicker, no loading state after first paint.\r\n */\r\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\r\n  const initialAssignments = useInitialAssignments();\r\n  const ssrFallback = useSsrFallback();\r\n  const client = useSentient();\r\n  const segment = useSessionSegment();\r\n  const onAssignment = useOnAssignment();\r\n  const assignmentReportedRef = useRef<string | null>(null);\r\n\r\n  // Dev override: URL param ?sentient_variant=componentId:variantId\r\n  // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\r\n  const devOverride = getDevOverride(componentId);\r\n  const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\r\n  if (overrideVariant) {\r\n    console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\r\n  }\r\n\r\n  const initial = (() => {\r\n    if (overrideVariant) {\r\n      return { variantId: overrideVariant, isLoading: false };\r\n    }\r\n    // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\r\n    // the server and client first render agree on the same variant (no mismatch).\r\n    if (!client) {\r\n      const preloaded = initialAssignments[componentId];\r\n      if (preloaded && variantIds.includes(preloaded)) {\r\n        return { variantId: preloaded, isLoading: false };\r\n      }\r\n      if (ssrFallback === 'first' && variantIds.length > 0) {\r\n        return { variantId: variantIds[0], isLoading: false };\r\n      }\r\n      return { variantId: null, isLoading: true };\r\n    }\r\n    const cached = client.getAssignment(componentId, segment);\r\n    if (cached && variantIds.includes(cached.variantId)) {\r\n      return { variantId: cached.variantId, isLoading: false };\r\n    }\r\n    const weights = getWeights(componentId);\r\n    if (weights) {\r\n      const chosen = pickFromWeights(weights, variantIds);\r\n      if (chosen) return { variantId: chosen, isLoading: false };\r\n    }\r\n    return { variantId: variantIds[0] ?? null, isLoading: false };\r\n  })();\r\n\r\n  const [state, setState] = useState<AssignmentState>(initial);\r\n\r\n  // Helper: call onAssignment at most once per resolved variant.\r\n  const reportAssignment = (variantId: string): void => {\r\n    if (!onAssignment) return;\r\n    if (assignmentReportedRef.current === variantId) return;\r\n    assignmentReportedRef.current = variantId;\r\n    onAssignment(componentId, variantId);\r\n  };\r\n\r\n  // As soon as the client is ready, unblock the UI immediately with variantIds[0]\r\n  // (or a cached value) so the component never stays invisible while assign is\r\n  // in-flight. The async assign call below then swaps to the bandit-chosen variant.\r\n  useEffect(() => {\r\n    if (overrideVariant) return;\r\n    if (!client) return;\r\n    const cached = client.getAssignment(componentId, segment);\r\n    if (cached && variantIds.includes(cached.variantId)) {\r\n      setState({ variantId: cached.variantId, isLoading: false });\r\n      reportAssignment(cached.variantId);\r\n      return;\r\n    }\r\n    setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [overrideVariant, client, componentId, segment]);\r\n\r\n  // Ask the server for a real assignment when we have a client but no cached one.\r\n  useEffect(() => {\r\n    if (overrideVariant) return;\r\n    if (!client) return;\r\n    const cached = client.getAssignment(componentId, segment);\r\n    if (cached && variantIds.includes(cached.variantId)) return;\r\n\r\n    let cancelled = false;\r\n    void client.assign(componentId, variantIds).then((result: AssignResult | null) => {\r\n      if (cancelled) return;\r\n      // If the API is unreachable or returns null, the fallback set above stays.\r\n      if (!result || !variantIds.includes(result.variantId)) return;\r\n      setState({ variantId: result.variantId, isLoading: false });\r\n      reportAssignment(result.variantId);\r\n    });\r\n    return () => { cancelled = true; };\r\n    // variantIds intentionally excluded — changing variants mid-mount is unsupported\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [overrideVariant, client, componentId, segment]);\r\n\r\n  // Live weight updates from the dashboard SSE stream (when wired).\r\n  useEffect(() => {\r\n    if (overrideVariant) return;\r\n    if (!client) return;\r\n    return subscribe(componentId, (weights) => {\r\n      const cached = client.getAssignment(componentId, segment);\r\n      if (cached && variantIds.includes(cached.variantId)) {\r\n        setState({ variantId: cached.variantId, isLoading: false });\r\n        return;\r\n      }\r\n      const chosen = pickFromWeights(weights, variantIds);\r\n      if (chosen) setState({ variantId: chosen, isLoading: false });\r\n    });\r\n    // eslint-disable-next-line react-hooks/exhaustive-deps\r\n  }, [overrideVariant, client, componentId, segment]);\r\n\r\n  if (overrideVariant) {\r\n    return { variantId: overrideVariant, isLoading: false };\r\n  }\r\n\r\n  return state;\r\n}\r\n","/** Per-component weights store with isolated subscriptions. */\n\nexport type VariantWeight = {\n  variantId: string;\n  pulls: number;\n  avgReward: number;\n};\n\nexport type ComponentWeights = {\n  componentId: string;\n  variants: VariantWeight[];\n  updatedAt: number;\n};\n\ntype Listener = (weights: ComponentWeights) => void;\n\nconst store = new Map<string, ComponentWeights>();\nconst listeners = new Map<string, Set<Listener>>();\n\n/**\n * Subscribes a listener to a single component. Returns an unsubscribe function.\n * Updates to other components never trigger this listener.\n */\nexport function subscribe(componentId: string, cb: Listener): () => void {\n  let set = listeners.get(componentId);\n  if (!set) {\n    set = new Set();\n    listeners.set(componentId, set);\n  }\n  set.add(cb);\n  return () => {\n    set!.delete(cb);\n    if (set!.size === 0) listeners.delete(componentId);\n  };\n}\n\n/**\n * Replaces the weights for a component and notifies only that component's\n * subscribers.\n */\nexport function update(componentId: string, weights: ComponentWeights): void {\n  store.set(componentId, weights);\n  const set = listeners.get(componentId);\n  if (!set) return;\n  for (const cb of set) {\n    try {\n      cb(weights);\n    } catch {\n      /* never throw to other listeners */\n    }\n  }\n}\n\n/**\n * Returns the latest known weights for a component, or null if none seen.\n */\nexport function getWeights(componentId: string): ComponentWeights | null {\n  return store.get(componentId) ?? null;\n}\n\n/** Test-only: wipe the entire store. */\nexport function _resetWeightsStore(): void {\n  store.clear();\n  listeners.clear();\n}\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\r\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,mBAA+E;AAC/E,kBAA+D;AAkG3D;AApFJ,IAAM,sBAAkB,4BAAoC;AAAA,EAC1D,QAAQ;AAAA,EACR,WAAW;AAAA,EACX,oBAAoB,CAAC;AAAA,EACrB,gBAAgB;AAAA,EAChB,aAAa;AAAA,EACb,cAAc;AAChB,CAAC;AA4CM,SAAS,iBAAiB,OAA2C;AApE5E;AAqEE,QAAM,CAAC,QAAQ,SAAS,QAAI,uBAAgC,IAAI;AAEhE,8BAAU,MAAM;AAEd,QAAI,MAAM,YAAY,OAAO;AAC3B,gBAAU,CAAC,SAAgC;AACzC,qCAAM;AACN,eAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AAEA,UAAM,QAAI,kBAAK;AAAA,MACb,QAAQ,MAAM;AAAA,MACd,SAAS,MAAM;AAAA,MACf,WAAW,MAAM;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,oBAAoB,MAAM;AAAA,MAC1B,gBAAgB,MAAM;AAAA,MACtB,SAAS,MAAM;AAAA,IACjB,CAAC;AACD,cAAU,CAAC;AACX,WAAO,MAAM;AACX,QAAE,QAAQ;AAAA,IACZ;AAAA,EAGF,GAAG,CAAC,MAAM,OAAO,CAAC;AAElB,QAAM,eAAc,WAAM,gBAAN,YAAqB;AAEzC,SACE;AAAA,IAAC,gBAAgB;AAAA,IAAhB;AAAA,MACC,OAAO;AAAA,QACL;AAAA,QACA,WAAW,MAAM;AAAA,QACjB,qBAAoB,WAAM,uBAAN,YAA4B,CAAC;AAAA,QACjD,iBAAgB,WAAM,mBAAN,YAAwB;AAAA,QACxC;AAAA,QACA,cAAc,MAAM;AAAA,MACtB;AAAA,MAEC,gBAAM;AAAA;AAAA,EACT;AAEJ;AAMO,SAAS,cAAqC;AACnD,aAAO,yBAAW,eAAe,EAAE;AACrC;AAGO,SAAS,uBAA+B;AAC7C,aAAO,yBAAW,eAAe,EAAE;AACrC;AAGO,SAAS,wBAAgD;AAC9D,aAAO,yBAAW,eAAe,EAAE;AACrC;AAGO,SAAS,oBAA4B;AAC1C,aAAO,yBAAW,eAAe,EAAE;AACrC;AAGO,SAAS,iBAA8B;AAC5C,aAAO,yBAAW,eAAe,EAAE;AACrC;AAGO,SAAS,kBAAkF;AAChG,aAAO,yBAAW,eAAe,EAAE;AACrC;;;ACjJA,IAAAA,gBAA2E;;;ACF3E,IAAAC,gBAA4C;;;ACgB5C,IAAM,QAAQ,oBAAI,IAA8B;AAChD,IAAM,YAAY,oBAAI,IAA2B;AAM1C,SAAS,UAAU,aAAqB,IAA0B;AACvE,MAAI,MAAM,UAAU,IAAI,WAAW;AACnC,MAAI,CAAC,KAAK;AACR,UAAM,oBAAI,IAAI;AACd,cAAU,IAAI,aAAa,GAAG;AAAA,EAChC;AACA,MAAI,IAAI,EAAE;AACV,SAAO,MAAM;AACX,QAAK,OAAO,EAAE;AACd,QAAI,IAAK,SAAS,EAAG,WAAU,OAAO,WAAW;AAAA,EACnD;AACF;AAMO,SAAS,OAAO,aAAqB,SAAiC;AAC3E,QAAM,IAAI,aAAa,OAAO;AAC9B,QAAM,MAAM,UAAU,IAAI,WAAW;AACrC,MAAI,CAAC,IAAK;AACV,aAAW,MAAM,KAAK;AACpB,QAAI;AACF,SAAG,OAAO;AAAA,IACZ,SAAQ;AAAA,IAER;AAAA,EACF;AACF;AAKO,SAAS,WAAW,aAA8C;AAxDzE;AAyDE,UAAO,WAAM,IAAI,WAAW,MAArB,YAA0B;AACnC;;;ADjDA,SAAS,eAAe,aAAoC;AAT5D;AAUE,MAAI,OAAO,WAAW,YAAa,QAAO;AAC1C,QAAM,UAAS,YAAO,yBAAP,mBAA8B;AAC7C,MAAI,OAAQ,QAAO;AACnB,MAAI;AACF,UAAM,SAAS,IAAI,gBAAgB,OAAO,SAAS,MAAM;AACzD,eAAW,OAAO,OAAO,OAAO,kBAAkB,GAAG;AAEnD,YAAM,MAAM,IAAI,QAAQ,GAAG;AAC3B,UAAI,QAAQ,GAAI;AAChB,UAAI,IAAI,MAAM,GAAG,GAAG,MAAM,YAAa,QAAO,IAAI,MAAM,MAAM,CAAC;AAAA,IACjE;AAAA,EACF,SAAQ;AAAA,EAAwB;AAChC,SAAO;AACT;AAOA,SAAS,gBAAgB,SAA2B,YAAqC;AA9BzF;AA+BE,MAAI,OAAwD;AAC5D,aAAW,KAAK,QAAQ,UAAU;AAChC,QAAI,CAAC,WAAW,SAAS,EAAE,SAAS,EAAG;AACvC,QAAI,CAAC,QAAQ,EAAE,YAAY,KAAK,WAAW;AACzC,aAAO,EAAE,WAAW,EAAE,WAAW,WAAW,EAAE,UAAU;AAAA,IAC1D;AAAA,EACF;AACA,UAAO,kCAAM,cAAN,YAAmB;AAC5B;AAWO,SAAS,cAAc,aAAqB,YAAuC;AACxF,QAAM,qBAAqB,sBAAsB;AACjD,QAAM,cAAc,eAAe;AACnC,QAAM,SAAS,YAAY;AAC3B,QAAM,UAAU,kBAAkB;AAClC,QAAM,eAAe,gBAAgB;AACrC,QAAM,4BAAwB,sBAAsB,IAAI;AAIxD,QAAM,cAAc,eAAe,WAAW;AAC9C,QAAM,kBAAkB,eAAe,WAAW,SAAS,WAAW,IAAI,cAAc;AACxF,MAAI,iBAAiB;AACnB,YAAQ,KAAK,+BAA+B,WAAW,OAAO,eAAe,EAAE;AAAA,EACjF;AAEA,QAAM,WAAW,MAAM;AAlEzB;AAmEI,QAAI,iBAAiB;AACnB,aAAO,EAAE,WAAW,iBAAiB,WAAW,MAAM;AAAA,IACxD;AAGA,QAAI,CAAC,QAAQ;AACX,YAAM,YAAY,mBAAmB,WAAW;AAChD,UAAI,aAAa,WAAW,SAAS,SAAS,GAAG;AAC/C,eAAO,EAAE,WAAW,WAAW,WAAW,MAAM;AAAA,MAClD;AACA,UAAI,gBAAgB,WAAW,WAAW,SAAS,GAAG;AACpD,eAAO,EAAE,WAAW,WAAW,CAAC,GAAG,WAAW,MAAM;AAAA,MACtD;AACA,aAAO,EAAE,WAAW,MAAM,WAAW,KAAK;AAAA,IAC5C;AACA,UAAM,SAAS,OAAO,cAAc,aAAa,OAAO;AACxD,QAAI,UAAU,WAAW,SAAS,OAAO,SAAS,GAAG;AACnD,aAAO,EAAE,WAAW,OAAO,WAAW,WAAW,MAAM;AAAA,IACzD;AACA,UAAM,UAAU,WAAW,WAAW;AACtC,QAAI,SAAS;AACX,YAAM,SAAS,gBAAgB,SAAS,UAAU;AAClD,UAAI,OAAQ,QAAO,EAAE,WAAW,QAAQ,WAAW,MAAM;AAAA,IAC3D;AACA,WAAO,EAAE,YAAW,gBAAW,CAAC,MAAZ,YAAiB,MAAM,WAAW,MAAM;AAAA,EAC9D,GAAG;AAEH,QAAM,CAAC,OAAO,QAAQ,QAAI,wBAA0B,OAAO;AAG3D,QAAM,mBAAmB,CAAC,cAA4B;AACpD,QAAI,CAAC,aAAc;AACnB,QAAI,sBAAsB,YAAY,UAAW;AACjD,0BAAsB,UAAU;AAChC,iBAAa,aAAa,SAAS;AAAA,EACrC;AAKA,+BAAU,MAAM;AACd,QAAI,gBAAiB;AACrB,QAAI,CAAC,OAAQ;AACb,UAAM,SAAS,OAAO,cAAc,aAAa,OAAO;AACxD,QAAI,UAAU,WAAW,SAAS,OAAO,SAAS,GAAG;AACnD,eAAS,EAAE,WAAW,OAAO,WAAW,WAAW,MAAM,CAAC;AAC1D,uBAAiB,OAAO,SAAS;AACjC;AAAA,IACF;AACA,aAAS,CAAC,SAAM;AApHpB;AAoHuB,kBAAK,YAAY,OAAO,EAAE,YAAW,gBAAW,CAAC,MAAZ,YAAiB,MAAM,WAAW,MAAM;AAAA,KAAC;AAAA,EAEnG,GAAG,CAAC,iBAAiB,QAAQ,aAAa,OAAO,CAAC;AAGlD,+BAAU,MAAM;AACd,QAAI,gBAAiB;AACrB,QAAI,CAAC,OAAQ;AACb,UAAM,SAAS,OAAO,cAAc,aAAa,OAAO;AACxD,QAAI,UAAU,WAAW,SAAS,OAAO,SAAS,EAAG;AAErD,QAAI,YAAY;AAChB,SAAK,OAAO,OAAO,aAAa,UAAU,EAAE,KAAK,CAAC,WAAgC;AAChF,UAAI,UAAW;AAEf,UAAI,CAAC,UAAU,CAAC,WAAW,SAAS,OAAO,SAAS,EAAG;AACvD,eAAS,EAAE,WAAW,OAAO,WAAW,WAAW,MAAM,CAAC;AAC1D,uBAAiB,OAAO,SAAS;AAAA,IACnC,CAAC;AACD,WAAO,MAAM;AAAE,kBAAY;AAAA,IAAM;AAAA,EAGnC,GAAG,CAAC,iBAAiB,QAAQ,aAAa,OAAO,CAAC;AAGlD,+BAAU,MAAM;AACd,QAAI,gBAAiB;AACrB,QAAI,CAAC,OAAQ;AACb,WAAO,UAAU,aAAa,CAAC,YAAY;AACzC,YAAM,SAAS,OAAO,cAAc,aAAa,OAAO;AACxD,UAAI,UAAU,WAAW,SAAS,OAAO,SAAS,GAAG;AACnD,iBAAS,EAAE,WAAW,OAAO,WAAW,WAAW,MAAM,CAAC;AAC1D;AAAA,MACF;AACA,YAAM,SAAS,gBAAgB,SAAS,UAAU;AAClD,UAAI,OAAQ,UAAS,EAAE,WAAW,QAAQ,WAAW,MAAM,CAAC;AAAA,IAC9D,CAAC;AAAA,EAEH,GAAG,CAAC,iBAAiB,QAAQ,aAAa,OAAO,CAAC;AAElD,MAAI,iBAAiB;AACnB,WAAO,EAAE,WAAW,iBAAiB,WAAW,MAAM;AAAA,EACxD;AAEA,SAAO;AACT;;;ADkDI,IAAAC,sBAAA;AA3LJ,SAAS,UAAU,MAAuC;AACxD,MAAI,OAAO,SAAS,SAAU,QAAO,EAAE,MAAM,QAAQ;AACrD,SAAO;AACT;AAEA,SAAS,kBAAkB,IAAiC;AAC1D,MAAI,EAAE,cAAc,SAAU,QAAO;AACrC,QAAM,MAAM,GAAG,QAAQ,YAAY;AACnC,MAAI,QAAQ,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,OAAO,GAAG,aAAa,MAAM;AACnC,SAAO,SAAS;AAClB;AAEA,SAAS,cAAc,OAAgB,WAA6B;AAClE,MAAI,SAAyB;AAC7B,SAAO,UAAU,WAAW,WAAW;AACrC,QAAI,kBAAkB,MAAM,EAAG,QAAO;AACtC,aAAS,OAAO;AAAA,EAClB;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAA0C;AA9ChE;AA+CE,QAAM,SAAS,YAAY;AAC3B,QAAM,YAAY,qBAAqB;AACvC,QAAM,iBAAa,uBAAQ,MAAM,OAAO,KAAK,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC;AAC9E,QAAM,EAAE,UAAU,IAAI,cAAc,MAAM,IAAI,UAAU;AACxD,QAAM,mBAAe,sBAAuB,IAAI;AAChD,QAAM,CAAC,SAAS,UAAU,QAAI,wBAAS,KAAK;AAE5C,+BAAU,MAAM;AAAE,eAAW,IAAI;AAAA,EAAG,GAAG,CAAC,CAAC;AACzC,QAAM,mBAAe,sBAAO,KAAK;AACjC,QAAM,uBAAmB,sBAAsB,IAAI;AACnD,QAAM,WAAO,uBAAQ,MAAM,UAAU,MAAM,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC;AAC9D,QAAM,YAAY,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO,KAAK;AAOrE,+BAAU,MAAM;AAjElB,QAAAC,KAAA;AAkEI,QAAI,CAAC,UAAU,CAAC,aAAa,CAAC,UAAW;AACzC,QAAI,iBAAiB,YAAY,UAAW;AAC5C,UAAM,WAAU,MAAAA,MAAA,aAAa,YAAb,gBAAAA,IAAsB,cAAtB,YAAmC;AAEnD,QAAI,CAAC,WAAW,CAAC,QAAS;AAC1B,qBAAiB,UAAU;AAC3B,WAAO,MAAM;AAAA,MACX;AAAA,MACA,aAAa,MAAM;AAAA,MACnB;AAAA,MACA,WAAW;AAAA,MACX,SAAS,UAAU,EAAE,aAAa,QAAQ,MAAM,GAAG,GAAM,EAAE,IAAI,CAAC;AAAA,IAClE,CAAC;AAAA,EACH,GAAG,CAAC,QAAQ,WAAW,WAAW,MAAM,IAAI,OAAO,CAAC;AAGpD,+BAAU,MAAM;AACd,iBAAa,UAAU;AAAA,EACzB,GAAG,CAAC,SAAS,CAAC;AAGd,+BAAU,MAAM;AACd,QAAI,CAAC,UAAU,CAAC,UAAW;AAC3B,UAAM,OAAO,aAAa;AAC1B,QAAI,CAAC,KAAM;AAEX,QAAI,UAAgD;AACpD,QAAI,aAAa;AAEjB,UAAM,UAAU,MAAY;AAC1B,mBAAa,KAAK,IAAI;AACtB,gBAAU,WAAW,MAAM;AACzB,eAAO,MAAM;AAAA,UACX;AAAA,UACA,aAAa,MAAM;AAAA,UACnB;AAAA,UACA,WAAW;AAAA,UACX,SAAS,EAAE,eAAe,KAAK,IAAI,IAAI,WAAW;AAAA,QACpD,CAAC;AACD,kBAAU;AAAA,MACZ,GAAG,GAAG;AAAA,IACR;AAEA,UAAM,UAAU,MAAY;AAC1B,UAAI,YAAY,MAAM;AACpB,qBAAa,OAAO;AACpB,kBAAU;AAAA,MACZ;AAAA,IACF;AAEA,SAAK,iBAAiB,cAAc,OAAO;AAC3C,SAAK,iBAAiB,cAAc,OAAO;AAC3C,WAAO,MAAM;AACX,WAAK,oBAAoB,cAAc,OAAO;AAC9C,WAAK,oBAAoB,cAAc,OAAO;AAC9C,UAAI,YAAY,KAAM,cAAa,OAAO;AAAA,IAC5C;AAAA,EACF,GAAG,CAAC,QAAQ,WAAW,WAAW,MAAM,EAAE,CAAC;AAG3C,+BAAU,MAAM;AACd,QAAI,CAAC,UAAU,CAAC,UAAW;AAC3B,UAAM,OAAO,aAAa;AAC1B,QAAI,CAAC,KAAM;AAEX,UAAM,WAAW,MAAY;AAC3B,UAAI,aAAa,QAAS;AAC1B,mBAAa,UAAU;AACvB,aAAO,MAAM;AAAA,QACX;AAAA,QACA,aAAa,MAAM;AAAA,QACnB;AAAA,QACA,WAAW;AAAA,QACX,UAAU;AAAA,QACV,SAAS,EAAE,QAAQ,EAAI;AAAA,MACzB,CAAC;AAAA,IACH;AAEA,UAAM,WAAyB,KAAK,SAAS,cAAc,KAAK,MAAM,CAAC,IAAI;AAC3E,UAAM,YAAY,IAAI,IAAY,SAAS,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC;AAC3D,UAAM,iBAAiB,CAAC,QAAsB;AAC5C,gBAAU,OAAO,GAAG;AACpB,UAAI,UAAU,SAAS,EAAG,UAAS;AAAA,IACrC;AAEA,UAAM,WAA8B,CAAC;AAErC,aAAS,QAAQ,CAAC,KAAK,QAAQ;AAC7B,UAAI,IAAI,SAAS,SAAS;AACxB,cAAM,UAAU,CAAC,MAAwB;AACvC,gBAAM,SAAS,EAAE;AACjB,cAAI,EAAE,kBAAkB,SAAU;AAClC,cAAI,CAAC,cAAc,QAAQ,IAAI,EAAG;AAClC,cAAI,KAAK,SAAS,YAAa,gBAAe,GAAG;AAAA,cAC5C,UAAS;AAAA,QAChB;AACA,aAAK,iBAAiB,SAAS,OAAO;AACtC,iBAAS,KAAK,MAAM,KAAK,oBAAoB,SAAS,OAAO,CAAC;AAC9D;AAAA,MACF;AAEA,UAAI,IAAI,SAAS,eAAe;AAC9B,cAAM,WAAW,CAAC,MAAmB;AACnC,cAAI,EAAE,EAAE,kBAAkB,iBAAkB;AAC5C,cAAI,CAAC,KAAK,SAAS,EAAE,MAAM,EAAG;AAC9B,cAAI,KAAK,SAAS,YAAa,gBAAe,GAAG;AAAA,cAC5C,UAAS;AAAA,QAChB;AACA,aAAK,iBAAiB,UAAU,QAAQ;AACxC,iBAAS,KAAK,MAAM,KAAK,oBAAoB,UAAU,QAAQ,CAAC;AAChE;AAAA,MACF;AAEA,UAAI,IAAI,SAAS,gBAAgB;AAC/B,cAAM,YAAY,KAAK,IAAI,GAAG,KAAK,IAAI,GAAG,IAAI,SAAS,CAAC;AACxD,cAAM,KAAK,IAAI;AAAA,UACb,CAAC,YAAY;AACX,uBAAW,SAAS,SAAS;AAC3B,kBAAI,MAAM,qBAAqB,WAAW;AACxC,oBAAI,KAAK,SAAS,YAAa,gBAAe,GAAG;AAAA,oBAC5C,UAAS;AACd,mBAAG,WAAW;AACd;AAAA,cACF;AAAA,YACF;AAAA,UACF;AAAA,UACA,EAAE,WAAW,CAAC,SAAS,EAAE;AAAA,QAC3B;AACA,WAAG,QAAQ,IAAI;AACf,iBAAS,KAAK,MAAM,GAAG,WAAW,CAAC;AACnC;AAAA,MACF;AAAA,IACF,CAAC;AAED,WAAO,MAAM;AACX,iBAAW,KAAK,SAAU,GAAE;AAAA,IAC9B;AAAA,EACF,GAAG,CAAC,QAAQ,WAAW,WAAW,MAAM,IAAI,MAAM,SAAS,CAAC;AAG5D,MAAI,MAAM,eAAe,CAAC,WAAW,CAAC,QAAS,QAAO;AACtD,MAAI,CAAC,UAAW,QAAO;AACvB,QAAM,WAAU,WAAM,SAAS,SAAS,MAAxB,YAA6B;AAE7C,SACE,6CAAC,SAAI,KAAK,cAAc,oBAAkB,MAAM,IAAI,yBAAuB,WACxE,mBACH;AAEJ;AAGO,IAAM,eAAW,oBAAK,cAAc,CAAC,MAAM,SAAS;AACzD,MAAI,KAAK,OAAO,KAAK,GAAI,QAAO;AAChC,MAAI,KAAK,SAAS,KAAK,KAAM,QAAO;AACpC,MAAI,KAAK,aAAa,KAAK,SAAU,QAAO;AAC5C,QAAM,WAAW,OAAO,KAAK,KAAK,QAAQ;AAC1C,QAAM,WAAW,OAAO,KAAK,KAAK,QAAQ;AAC1C,MAAI,SAAS,WAAW,SAAS,OAAQ,QAAO;AAChD,SAAO,SAAS,MAAM,CAAC,MAAM,KAAK,KAAK,QAAQ;AACjD,CAAC;;;AGjOD,IAAAC,eAAsD;","names":["import_react","import_react","import_jsx_runtime","_a","import_core"]}
+{"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/adaptive-text.tsx","../src/segment.ts"],"sourcesContent":["export { AdaptiveProvider, useSentient, useInitialAssignments, useLayoutOrder } from './provider.js';\nexport type { AdaptiveProviderProps, SsrFallback } from './provider.js';\n\nexport { Adaptive } from './adaptive.js';\nexport type {\n  AdaptiveProps,\n  GoalConfig,\n  ClickGoal,\n  ScrollDepthGoal,\n  FormSubmitGoal,\n  CompositeGoal,\n} from './adaptive.js';\n\nexport { AdaptiveText } from './adaptive-text.js';\nexport type { AdaptiveTextProps } from './adaptive-text.js';\n\nexport { useAssignment } from './use-assignment.js';\nexport type { AssignmentState } from './use-assignment.js';\n\nexport {\n  subscribe as subscribeWeights,\n  update as updateWeights,\n  getWeights,\n} from './weights-store.js';\nexport type { ComponentWeights, VariantWeight } from './weights-store.js';\n\nexport { detectSegment } from './segment.js';\n","'use client';\n\nimport { createContext, useContext, useEffect, useState, type ReactNode } from 'react';\nimport { init, type SentientClient, type SentientConfig } from '@sentientui/core';\n\n/** How to render adaptive slots during SSR when assignments are not preloaded. */\nexport type SsrFallback = 'first' | 'none';\n\ntype AdaptiveContextValue = {\n  client: SentientClient | null;\n  projectId: string;\n  initialAssignments: Record<string, string>;\n  sessionSegment: string;\n  ssrFallback: SsrFallback;\n  onAssignment: ((componentId: string, variantId: string) => void) | undefined;\n  initialLayoutOrder: string[] | null;\n};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n  client: null,\n  projectId: '',\n  initialAssignments: {},\n  sessionSegment: 'desktop:direct',\n  ssrFallback: 'first',\n  onAssignment: undefined,\n  initialLayoutOrder: null,\n});\n\nexport type AdaptiveProviderProps = {\n  apiKey: string;\n  context: SentientConfig['context'];\n  debug?: boolean;\n  /**\n   * SSR-preloaded assignments from `preloadAssignments()` / `loadAdaptiveAssignments()`.\n   * Passed through to `useAssignment` as synchronous initial state so crawlers and\n   * the first paint see real content (recommended for SEO).\n   */\n  initialAssignments?: Record<string, string>;\n  /**\n   * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker\n   * weights on one row — must match `loadAdaptiveAssignments` / session upsert.\n   */\n  sessionSegment?: string;\n  /**\n   * When no `initialAssignments` exist for a component, `'first'` renders\n   * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for\n   * decorative slots marked `clientOnly`.\n   * @default 'first'\n   */\n  ssrFallback?: SsrFallback;\n  /**\n   * Consent gate. When `false` the SDK is not initialised and no events are\n   * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to\n   * initialise and begin tracking.\n   */\n  consent?: boolean;\n  /**\n   * Called once per component the first time a variant is resolved for that\n   * component in this session. Use to forward assignments to your own analytics\n   * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.\n   */\n  onAssignment?: (componentId: string, variantId: string) => void;\n  /**\n   * SSR-preloaded section order from `loadAdaptiveDecision()`.\n   * Pass the `layoutOrder` field from `DecideResult`. When set,\n   * `useLayoutOrder()` returns this on first render so there is no layout shift.\n   */\n  initialLayoutOrder?: string[] | null;\n  children: ReactNode;\n};\n\n/**\n * Initialises the Sentient core SDK in a useEffect (SSR-safe) and exposes the\n * client via React context. Re-initialises when `consent` changes.\n */\nexport function AdaptiveProvider(props: AdaptiveProviderProps): JSX.Element {\n  const [client, setClient] = useState<SentientClient | null>(null);\n\n  useEffect(() => {\n    // When consent is explicitly false, tear down any existing client.\n    if (props.consent === false) {\n      setClient((prev: SentientClient | null) => {\n        prev?.destroy();\n        return null;\n      });\n      return;\n    }\n\n    const c = init({\n      apiKey: props.apiKey,\n      context: props.context,\n      debug: props.debug,\n      initialAssignments: props.initialAssignments,\n      sessionSegment: props.sessionSegment,\n      consent: props.consent,\n    });\n    setClient(c);\n    return () => {\n      c.destroy();\n    };\n    // Re-init when consent changes. Other props are intentionally stable.\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [props.consent]);\n\n  const ssrFallback = props.ssrFallback ?? 'first';\n\n  return (\n    <AdaptiveContext.Provider\n      value={{\n        client,\n        projectId: props.apiKey,\n        initialAssignments: props.initialAssignments ?? {},\n        sessionSegment: props.sessionSegment ?? 'desktop:direct',\n        ssrFallback,\n        onAssignment: props.onAssignment,\n        initialLayoutOrder: props.initialLayoutOrder ?? null,\n      }}\n    >\n      {props.children}\n    </AdaptiveContext.Provider>\n  );\n}\n\n/**\n * Returns the SentientClient, or null until the provider has finished\n * initialising on the client.\n */\nexport function useSentient(): SentientClient | null {\n  return useContext(AdaptiveContext).client;\n}\n\n/** Internal: project identifier carried alongside the client. */\nexport function useAdaptiveProjectId(): string {\n  return useContext(AdaptiveContext).projectId;\n}\n\n/** Internal: SSR-preloaded assignments for hydration-safe first render. */\nexport function useInitialAssignments(): Record<string, string> {\n  return useContext(AdaptiveContext).initialAssignments;\n}\n\n/** Internal: bandit segment aligned with SSR session upsert. */\nexport function useSessionSegment(): string {\n  return useContext(AdaptiveContext).sessionSegment;\n}\n\n/** Internal: SSR fallback strategy when a slot has no preloaded assignment. */\nexport function useSsrFallback(): SsrFallback {\n  return useContext(AdaptiveContext).ssrFallback;\n}\n\n/** Internal: forwarding hook for consumer analytics integration. */\nexport function useOnAssignment(): ((componentId: string, variantId: string) => void) | undefined {\n  return useContext(AdaptiveContext).onAssignment;\n}\n\n/**\n * Returns the persona-specific section order from SSR, or null when no\n * sections were declared on AdaptiveRoot or reliability is below threshold.\n */\nexport function useLayoutOrder(): string[] | null {\n  return useContext(AdaptiveContext).initialLayoutOrder;\n}\n","'use client';\n\nimport { memo, useEffect, useMemo, useRef, useState, type ReactNode } from 'react';\nimport { useAdaptiveProjectId, useSentient } from './provider.js';\nimport { useAssignment } from './use-assignment.js';\n\nexport type ScrollDepthGoal = { type: 'scroll_depth'; threshold: number };\nexport type ClickGoal = { type: 'click'; selector?: string };\nexport type FormSubmitGoal = { type: 'form_submit' };\nexport type CompositeGoal = { type: 'composite'; all: GoalConfig[] };\nexport type GoalConfig = ScrollDepthGoal | ClickGoal | FormSubmitGoal | CompositeGoal;\n\nexport type AdaptiveProps = {\n  id: string;\n  variants: Record<string, ReactNode>;\n  goal: string | GoalConfig;\n  /**\n   * When true, renders nothing during SSR and before client hydration.\n   * Use when you cannot pass `initialAssignments` and prefer a blank slot over\n   * a hydration mismatch. Tradeoff: minor CLS on first paint.\n   */\n  clientOnly?: boolean;\n};\n\nfunction normalize(goal: string | GoalConfig): GoalConfig {\n  if (typeof goal === 'string') return { type: 'click' };\n  return goal;\n}\n\nfunction isClickableTarget(el: EventTarget | null): boolean {\n  if (!(el instanceof Element)) return false;\n  const tag = el.tagName.toLowerCase();\n  if (tag === 'a' || tag === 'button') return true;\n  const role = el.getAttribute('role');\n  return role === 'button';\n}\n\nfunction findClickable(start: Element, container: Element): boolean {\n  let cursor: Element | null = start;\n  while (cursor && cursor !== container) {\n    if (isClickableTarget(cursor)) return true;\n    cursor = cursor.parentElement;\n  }\n  return false;\n}\n\nfunction AdaptiveImpl(props: AdaptiveProps): JSX.Element | null {\n  const client = useSentient();\n  const projectId = useAdaptiveProjectId();\n  const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);\n  const { variantId } = useAssignment(props.id, variantIds);\n  const containerRef = useRef<HTMLDivElement>(null);\n  const [mounted, setMounted] = useState(false);\n\n  useEffect(() => { setMounted(true); }, []);\n  const goalFiredRef = useRef(false);\n  const assignTrackedRef = useRef<string | null>(null);\n  const goal = useMemo(() => normalize(props.goal), [props.goal]);\n  const goalLabel = typeof props.goal === 'string' ? props.goal : goal.type;\n\n  // Track variant_assigned exactly once per (component, variant) mount.\n  // Captures innerHTML as previewHtml so the dashboard can render a live preview\n  // without requiring manual registry calls. First-seen wins on the server.\n  // `mounted` is in deps so the effect re-runs after clientOnly components hydrate\n  // and their container div is actually in the DOM.\n  useEffect(() => {\n    if (!client || !variantId || !projectId) return;\n    if (assignTrackedRef.current === variantId) return;\n    const rawHtml = containerRef.current?.innerHTML ?? '';\n    // For clientOnly, the container is null until mounted — defer until it exists.\n    if (!rawHtml && !mounted) return;\n    assignTrackedRef.current = variantId;\n    client.track({\n      projectId,\n      componentId: props.id,\n      variantId,\n      eventType: 'variant_assigned',\n      payload: rawHtml ? { previewHtml: rawHtml.slice(0, 30_000) } : {},\n    });\n  }, [client, variantId, projectId, props.id, mounted]);\n\n  // Reset goal latch when variant changes.\n  useEffect(() => {\n    goalFiredRef.current = false;\n  }, [variantId]);\n\n  // Emit cursor_signal after 800 ms of continuous hover.\n  useEffect(() => {\n    if (!client || !variantId) return;\n    const node = containerRef.current;\n    if (!node) return;\n\n    let timerId: ReturnType<typeof setTimeout> | null = null;\n    let hoverStart = 0;\n\n    const onEnter = (): void => {\n      hoverStart = Date.now();\n      timerId = setTimeout(() => {\n        client.track({\n          projectId,\n          componentId: props.id,\n          variantId: variantId!,\n          eventType: 'cursor_signal',\n          payload: { hoverDuration: Date.now() - hoverStart },\n        });\n        timerId = null;\n      }, 800);\n    };\n\n    const onLeave = (): void => {\n      if (timerId !== null) {\n        clearTimeout(timerId);\n        timerId = null;\n      }\n    };\n\n    node.addEventListener('mouseenter', onEnter);\n    node.addEventListener('mouseleave', onLeave);\n    return () => {\n      node.removeEventListener('mouseenter', onEnter);\n      node.removeEventListener('mouseleave', onLeave);\n      if (timerId !== null) clearTimeout(timerId);\n    };\n  }, [client, variantId, projectId, props.id]);\n\n  // Attach goal tracking.\n  useEffect(() => {\n    if (!client || !variantId) return;\n    const node = containerRef.current;\n    if (!node) return;\n\n    const fireGoal = (): void => {\n      if (goalFiredRef.current) return;\n      goalFiredRef.current = true;\n      client.track({\n        projectId,\n        componentId: props.id,\n        variantId,\n        eventType: 'goal_achieved',\n        goalType: goalLabel,\n        payload: { reward: 1.0 },\n      });\n    };\n\n    const subgoals: GoalConfig[] = goal.type === 'composite' ? goal.all : [goal];\n    const remaining = new Set<number>(subgoals.map((_, i) => i));\n    const checkComposite = (idx: number): void => {\n      remaining.delete(idx);\n      if (remaining.size === 0) fireGoal();\n    };\n\n    const cleanups: Array<() => void> = [];\n\n    subgoals.forEach((sub, idx) => {\n      if (sub.type === 'click') {\n        const onClick = (e: MouseEvent): void => {\n          const target = e.target;\n          if (!(target instanceof Element)) return;\n          if (!findClickable(target, node)) return;\n          if (goal.type === 'composite') checkComposite(idx);\n          else fireGoal();\n        };\n        node.addEventListener('click', onClick);\n        cleanups.push(() => node.removeEventListener('click', onClick));\n        return;\n      }\n\n      if (sub.type === 'form_submit') {\n        const onSubmit = (e: Event): void => {\n          if (!(e.target instanceof HTMLFormElement)) return;\n          if (!node.contains(e.target)) return;\n          if (goal.type === 'composite') checkComposite(idx);\n          else fireGoal();\n        };\n        node.addEventListener('submit', onSubmit);\n        cleanups.push(() => node.removeEventListener('submit', onSubmit));\n        return;\n      }\n\n      if (sub.type === 'scroll_depth') {\n        const threshold = Math.max(0, Math.min(1, sub.threshold));\n        const io = new IntersectionObserver(\n          (entries) => {\n            for (const entry of entries) {\n              if (entry.intersectionRatio >= threshold) {\n                if (goal.type === 'composite') checkComposite(idx);\n                else fireGoal();\n                io.disconnect();\n                break;\n              }\n            }\n          },\n          { threshold: [threshold] },\n        );\n        io.observe(node);\n        cleanups.push(() => io.disconnect());\n        return;\n      }\n    });\n\n    return () => {\n      for (const c of cleanups) c();\n    };\n  }, [client, variantId, projectId, props.id, goal, goalLabel]);\n\n  // Decorative slots: empty in SSR HTML and until the client has mounted.\n  if (props.clientOnly && (!mounted || !client)) return null;\n  if (!variantId) return null;\n  const content = props.variants[variantId] ?? null;\n\n  return (\n    <div ref={containerRef} data-sentient-id={props.id} data-sentient-variant={variantId}>\n      {content}\n    </div>\n  );\n}\n\n/** Re-renders only when the chosen variant changes. */\nexport const Adaptive = memo(AdaptiveImpl, (prev, next) => {\n  if (prev.id !== next.id) return false;\n  if (prev.goal !== next.goal) return false;\n  if (prev.variants === next.variants) return true;\n  const prevKeys = Object.keys(prev.variants);\n  const nextKeys = Object.keys(next.variants);\n  if (prevKeys.length !== nextKeys.length) return false;\n  return prevKeys.every((k) => k in next.variants);\n});\n","import { useEffect, useRef, useState } from 'react';\nimport { type AssignResult } from '@sentientui/core';\nimport { useSentient, useInitialAssignments, useSessionSegment, useSsrFallback, useOnAssignment } from './provider.js';\nimport { subscribe, getWeights, type ComponentWeights } from './weights-store.js';\n\ndeclare global {\n  interface Window { __sentient_overrides?: Record<string, string>; }\n}\n\nfunction getDevOverride(componentId: string): string | null {\n  if (typeof window === 'undefined') return null;\n  const global = window.__sentient_overrides?.[componentId];\n  if (global) return global;\n  try {\n    const params = new URLSearchParams(window.location.search);\n    for (const raw of params.getAll('sentient_variant')) {\n      // sentient_variant=componentId:variantId  (repeatable for multiple components)\n      const sep = raw.indexOf(':');\n      if (sep === -1) continue;\n      if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);\n    }\n  } catch { /* non-browser env */ }\n  return null;\n}\n\nexport type AssignmentState = {\n  variantId: string | null;\n  isLoading: boolean;\n};\n\nfunction pickFromWeights(weights: ComponentWeights, variantIds: string[]): string | null {\n  let best: { variantId: string; avgReward: number } | null = null;\n  for (const v of weights.variants) {\n    if (!variantIds.includes(v.variantId)) continue;\n    if (!best || v.avgReward > best.avgReward) {\n      best = { variantId: v.variantId, avgReward: v.avgReward };\n    }\n  }\n  return best?.variantId ?? null;\n}\n\n/**\n * Returns a sticky variant assignment for a component.\n *\n * First render reads the local SDK cache; if empty, falls back to a\n * deterministic default and asynchronously calls `/v1/assign`. The server\n * picks the actual variant via ε-greedy and the result replaces the fallback\n * on the next render. Subsequent paints read synchronously from cache —\n * no flicker, no loading state after first paint.\n */\nexport function useAssignment(componentId: string, variantIds: string[]): AssignmentState {\n  const initialAssignments = useInitialAssignments();\n  const ssrFallback = useSsrFallback();\n  const client = useSentient();\n  const segment = useSessionSegment();\n  const onAssignment = useOnAssignment();\n  const assignmentReportedRef = useRef<string | null>(null);\n\n  // Dev override: URL param ?sentient_variant=componentId:variantId\n  // or window.__sentient_overrides[componentId]. Short-circuits the bandit entirely.\n  const devOverride = getDevOverride(componentId);\n  const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;\n  if (overrideVariant) {\n    console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);\n  }\n\n  const initial = (() => {\n    if (overrideVariant) {\n      return { variantId: overrideVariant, isLoading: false };\n    }\n    // SSR / pre-hydration: no client yet. Use initialAssignments if provided so\n    // the server and client first render agree on the same variant (no mismatch).\n    if (!client) {\n      const preloaded = initialAssignments[componentId];\n      if (preloaded && variantIds.includes(preloaded)) {\n        return { variantId: preloaded, isLoading: false };\n      }\n      if (ssrFallback === 'first' && variantIds.length > 0) {\n        return { variantId: variantIds[0], isLoading: false };\n      }\n      return { variantId: null, isLoading: true };\n    }\n    const cached = client.getAssignment(componentId, segment);\n    if (cached && variantIds.includes(cached.variantId)) {\n      return { variantId: cached.variantId, isLoading: false };\n    }\n    const weights = getWeights(componentId);\n    if (weights) {\n      const chosen = pickFromWeights(weights, variantIds);\n      if (chosen) return { variantId: chosen, isLoading: false };\n    }\n    return { variantId: variantIds[0] ?? null, isLoading: false };\n  })();\n\n  const [state, setState] = useState<AssignmentState>(initial);\n\n  // Helper: call onAssignment at most once per resolved variant.\n  const reportAssignment = (variantId: string): void => {\n    if (!onAssignment) return;\n    if (assignmentReportedRef.current === variantId) return;\n    assignmentReportedRef.current = variantId;\n    onAssignment(componentId, variantId);\n  };\n\n  // As soon as the client is ready, unblock the UI immediately with variantIds[0]\n  // (or a cached value) so the component never stays invisible while assign is\n  // in-flight. The async assign call below then swaps to the bandit-chosen variant.\n  useEffect(() => {\n    if (overrideVariant) return;\n    if (!client) return;\n    const cached = client.getAssignment(componentId, segment);\n    if (cached && variantIds.includes(cached.variantId)) {\n      setState({ variantId: cached.variantId, isLoading: false });\n      reportAssignment(cached.variantId);\n      return;\n    }\n    setState((prev) => prev.variantId ? prev : { variantId: variantIds[0] ?? null, isLoading: false });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [overrideVariant, client, componentId, segment]);\n\n  // Ask the server for a real assignment when we have a client but no cached one.\n  useEffect(() => {\n    if (overrideVariant) return;\n    if (!client) return;\n    const cached = client.getAssignment(componentId, segment);\n    if (cached && variantIds.includes(cached.variantId)) return;\n\n    let cancelled = false;\n    void client.assign(componentId, variantIds).then((result: AssignResult | null) => {\n      if (cancelled) return;\n      // If the API is unreachable or returns null, the fallback set above stays.\n      if (!result || !variantIds.includes(result.variantId)) return;\n      setState({ variantId: result.variantId, isLoading: false });\n      reportAssignment(result.variantId);\n    });\n    return () => { cancelled = true; };\n    // variantIds intentionally excluded — changing variants mid-mount is unsupported\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [overrideVariant, client, componentId, segment]);\n\n  // Live weight updates from the dashboard SSE stream (when wired).\n  useEffect(() => {\n    if (overrideVariant) return;\n    if (!client) return;\n    return subscribe(componentId, (weights) => {\n      const cached = client.getAssignment(componentId, segment);\n      if (cached && variantIds.includes(cached.variantId)) {\n        setState({ variantId: cached.variantId, isLoading: false });\n        return;\n      }\n      const chosen = pickFromWeights(weights, variantIds);\n      if (chosen) setState({ variantId: chosen, isLoading: false });\n    });\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [overrideVariant, client, componentId, segment]);\n\n  if (overrideVariant) {\n    return { variantId: overrideVariant, isLoading: false };\n  }\n\n  return state;\n}\n","/** Per-component weights store with isolated subscriptions. */\n\nexport type VariantWeight = {\n  variantId: string;\n  pulls: number;\n  avgReward: number;\n};\n\nexport type ComponentWeights = {\n  componentId: string;\n  variants: VariantWeight[];\n  updatedAt: number;\n};\n\ntype Listener = (weights: ComponentWeights) => void;\n\nconst store = new Map<string, ComponentWeights>();\nconst listeners = new Map<string, Set<Listener>>();\n\n/**\n * Subscribes a listener to a single component. Returns an unsubscribe function.\n * Updates to other components never trigger this listener.\n */\nexport function subscribe(componentId: string, cb: Listener): () => void {\n  let set = listeners.get(componentId);\n  if (!set) {\n    set = new Set();\n    listeners.set(componentId, set);\n  }\n  set.add(cb);\n  return () => {\n    set!.delete(cb);\n    if (set!.size === 0) listeners.delete(componentId);\n  };\n}\n\n/**\n * Replaces the weights for a component and notifies only that component's\n * subscribers.\n */\nexport function update(componentId: string, weights: ComponentWeights): void {\n  store.set(componentId, weights);\n  const set = listeners.get(componentId);\n  if (!set) return;\n  for (const cb of set) {\n    try {\n      cb(weights);\n    } catch {\n      /* never throw to other listeners */\n    }\n  }\n}\n\n/**\n * Returns the latest known weights for a component, or null if none seen.\n */\nexport function getWeights(componentId: string): ComponentWeights | null {\n  return store.get(componentId) ?? null;\n}\n\n/** Test-only: wipe the entire store. */\nexport function _resetWeightsStore(): void {\n  store.clear();\n  listeners.clear();\n}\n","'use client';\n\nimport { useEffect, useRef, useState } from 'react';\nimport type { AssignResult } from '@sentientui/core';\nimport { useSentient, useAdaptiveProjectId, useOnAssignment } from './provider.js';\n\nexport type AdaptiveTextProps = {\n  id: string;\n  default: string;\n  component?: keyof JSX.IntrinsicElements;\n  className?: string;\n};\n\nexport function AdaptiveText({\n  id,\n  default: defaultText,\n  component: Tag = 'span',\n  className,\n}: AdaptiveTextProps) {\n  const client = useSentient();\n  const projectId = useAdaptiveProjectId();\n  const onAssignment = useOnAssignment();\n  const [text, setText] = useState<string | null>(null);\n  const [variantId, setVariantId] = useState<string | null>(null);\n  const trackedRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (!client) return;\n    let cancelled = false;\n    void client.assign(id).then((result: AssignResult | null) => {\n      if (cancelled || !result) return;\n      setVariantId(result.variantId);\n      if (result.content) setText(result.content);\n    });\n    return () => {\n      cancelled = true;\n    };\n  }, [client, id]);\n\n  useEffect(() => {\n    if (!client || !variantId || !projectId) return;\n    if (trackedRef.current === variantId) return;\n    trackedRef.current = variantId;\n    client.track({\n      projectId,\n      componentId: id,\n      variantId,\n      eventType: 'variant_assigned',\n      payload: {},\n    });\n    onAssignment?.(id, variantId);\n  }, [client, variantId, projectId, id, onAssignment]);\n\n  return <Tag className={className}>{text ?? defaultText}</Tag>;\n}\n","/** @deprecated Use `useSessionSegment()` from the provider, or `deriveSessionSegment` from `@sentientui/core`. */\nexport { deriveSessionSegment as detectSegment } from '@sentientui/core';\n"],"mappings":"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","names":["import_react","import_react","import_jsx_runtime","_a","import_react","import_jsx_runtime","import_core"]}

package/dist/index.mjs

@@ -10,10 +10,11 @@ var AdaptiveContext = createContext({
   initialAssignments: {},
   sessionSegment: "desktop:direct",
   ssrFallback: "first",
-  onAssignment: void 0
+  onAssignment: void 0,
+  initialLayoutOrder: null
 });
 function AdaptiveProvider(props) {
-  var _a, _b, _c;
+  var _a, _b, _c, _d;
   const [client, setClient] = useState(null);
   useEffect(() => {
     if (props.consent === false) {
@@ -26,7 +27,6 @@ function AdaptiveProvider(props) {
     const c = init({
       apiKey: props.apiKey,
       context: props.context,
-      ingestUrl: props.ingestUrl,
       debug: props.debug,
       initialAssignments: props.initialAssignments,
       sessionSegment: props.sessionSegment,
@@ -47,7 +47,8 @@ function AdaptiveProvider(props) {
         initialAssignments: (_b = props.initialAssignments) != null ? _b : {},
         sessionSegment: (_c = props.sessionSegment) != null ? _c : "desktop:direct",
         ssrFallback,
-        onAssignment: props.onAssignment
+        onAssignment: props.onAssignment,
+        initialLayoutOrder: (_d = props.initialLayoutOrder) != null ? _d : null
       },
       children: props.children
     }
@@ -71,6 +72,9 @@ function useSsrFallback() {
 function useOnAssignment() {
   return useContext(AdaptiveContext).onAssignment;
 }
+function useLayoutOrder() {
+  return useContext(AdaptiveContext).initialLayoutOrder;
+}
 
 // src/adaptive.tsx
 import { memo, useEffect as useEffect3, useMemo, useRef as useRef2, useState as useState3 } from "react";
@@ -404,17 +408,62 @@ var Adaptive = memo(AdaptiveImpl, (prev, next) => {
   return prevKeys.every((k) => k in next.variants);
 });
 
+// src/adaptive-text.tsx
+import { useEffect as useEffect4, useRef as useRef3, useState as useState4 } from "react";
+import { jsx as jsx3 } from "react/jsx-runtime";
+function AdaptiveText({
+  id,
+  default: defaultText,
+  component: Tag = "span",
+  className
+}) {
+  const client = useSentient();
+  const projectId = useAdaptiveProjectId();
+  const onAssignment = useOnAssignment();
+  const [text, setText] = useState4(null);
+  const [variantId, setVariantId] = useState4(null);
+  const trackedRef = useRef3(null);
+  useEffect4(() => {
+    if (!client) return;
+    let cancelled = false;
+    void client.assign(id).then((result) => {
+      if (cancelled || !result) return;
+      setVariantId(result.variantId);
+      if (result.content) setText(result.content);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [client, id]);
+  useEffect4(() => {
+    if (!client || !variantId || !projectId) return;
+    if (trackedRef.current === variantId) return;
+    trackedRef.current = variantId;
+    client.track({
+      projectId,
+      componentId: id,
+      variantId,
+      eventType: "variant_assigned",
+      payload: {}
+    });
+    onAssignment == null ? void 0 : onAssignment(id, variantId);
+  }, [client, variantId, projectId, id, onAssignment]);
+  return /* @__PURE__ */ jsx3(Tag, { className, children: text != null ? text : defaultText });
+}
+
 // src/segment.ts
 import { deriveSessionSegment } from "@sentientui/core";
 export {
   Adaptive,
   AdaptiveProvider,
+  AdaptiveText,
   deriveSessionSegment as detectSegment,
   getWeights,
   subscribe as subscribeWeights,
   update as updateWeights,
   useAssignment,
   useInitialAssignments,
+  useLayoutOrder,
   useSentient
 };
 //# sourceMappingURL=index.mjs.map