@sentientui/react 0.1.0

package/dist/index.mjs

@@ -0,0 +1,420 @@
+'use client';
+
+// src/provider.tsx
+import { createContext, useContext, useEffect, useState } from "react";
+import { init } from "@sentientui/core";
+import { jsx } from "react/jsx-runtime";
+var AdaptiveContext = createContext({
+  client: null,
+  projectId: "",
+  initialAssignments: {},
+  sessionSegment: "desktop:direct",
+  ssrFallback: "first",
+  onAssignment: void 0
+});
+function AdaptiveProvider(props) {
+  var _a, _b, _c;
+  const [client, setClient] = useState(null);
+  useEffect(() => {
+    if (props.consent === false) {
+      setClient((prev) => {
+        prev == null ? void 0 : prev.destroy();
+        return null;
+      });
+      return;
+    }
+    const c = init({
+      apiKey: props.apiKey,
+      context: props.context,
+      ingestUrl: props.ingestUrl,
+      debug: props.debug,
+      initialAssignments: props.initialAssignments,
+      sessionSegment: props.sessionSegment,
+      consent: props.consent
+    });
+    setClient(c);
+    return () => {
+      c.destroy();
+    };
+  }, [props.consent]);
+  const ssrFallback = (_a = props.ssrFallback) != null ? _a : "first";
+  return /* @__PURE__ */ jsx(
+    AdaptiveContext.Provider,
+    {
+      value: {
+        client,
+        projectId: props.apiKey,
+        initialAssignments: (_b = props.initialAssignments) != null ? _b : {},
+        sessionSegment: (_c = props.sessionSegment) != null ? _c : "desktop:direct",
+        ssrFallback,
+        onAssignment: props.onAssignment
+      },
+      children: props.children
+    }
+  );
+}
+function useSentient() {
+  return useContext(AdaptiveContext).client;
+}
+function useAdaptiveProjectId() {
+  return useContext(AdaptiveContext).projectId;
+}
+function useInitialAssignments() {
+  return useContext(AdaptiveContext).initialAssignments;
+}
+function useSessionSegment() {
+  return useContext(AdaptiveContext).sessionSegment;
+}
+function useSsrFallback() {
+  return useContext(AdaptiveContext).ssrFallback;
+}
+function useOnAssignment() {
+  return useContext(AdaptiveContext).onAssignment;
+}
+
+// src/adaptive.tsx
+import { memo, useEffect as useEffect3, useMemo, useRef as useRef2, useState as useState3 } from "react";
+
+// src/use-assignment.ts
+import { useEffect as useEffect2, useRef, useState as useState2 } from "react";
+
+// src/weights-store.ts
+var store = /* @__PURE__ */ new Map();
+var listeners = /* @__PURE__ */ new Map();
+function subscribe(componentId, cb) {
+  let set = listeners.get(componentId);
+  if (!set) {
+    set = /* @__PURE__ */ new Set();
+    listeners.set(componentId, set);
+  }
+  set.add(cb);
+  return () => {
+    set.delete(cb);
+    if (set.size === 0) listeners.delete(componentId);
+  };
+}
+function update(componentId, weights) {
+  store.set(componentId, weights);
+  const set = listeners.get(componentId);
+  if (!set) return;
+  for (const cb of set) {
+    try {
+      cb(weights);
+    } catch (e) {
+    }
+  }
+}
+function getWeights(componentId) {
+  var _a;
+  return (_a = store.get(componentId)) != null ? _a : null;
+}
+
+// src/use-assignment.ts
+function getDevOverride(componentId) {
+  var _a;
+  if (typeof window === "undefined") return null;
+  const global = (_a = window.__sentient_overrides) == null ? void 0 : _a[componentId];
+  if (global) return global;
+  try {
+    const params = new URLSearchParams(window.location.search);
+    for (const raw of params.getAll("sentient_variant")) {
+      const sep = raw.indexOf(":");
+      if (sep === -1) continue;
+      if (raw.slice(0, sep) === componentId) return raw.slice(sep + 1);
+    }
+  } catch (e) {
+  }
+  return null;
+}
+function pickFromWeights(weights, variantIds) {
+  var _a;
+  let best = null;
+  for (const v of weights.variants) {
+    if (!variantIds.includes(v.variantId)) continue;
+    if (!best || v.avgReward > best.avgReward) {
+      best = { variantId: v.variantId, avgReward: v.avgReward };
+    }
+  }
+  return (_a = best == null ? void 0 : best.variantId) != null ? _a : null;
+}
+function useAssignment(componentId, variantIds) {
+  const initialAssignments = useInitialAssignments();
+  const ssrFallback = useSsrFallback();
+  const client = useSentient();
+  const segment = useSessionSegment();
+  const onAssignment = useOnAssignment();
+  const assignmentReportedRef = useRef(null);
+  const devOverride = getDevOverride(componentId);
+  const overrideVariant = devOverride && variantIds.includes(devOverride) ? devOverride : null;
+  if (overrideVariant) {
+    console.info(`[sentient] override active: ${componentId} -> ${overrideVariant}`);
+  }
+  const initial = (() => {
+    var _a;
+    if (overrideVariant) {
+      return { variantId: overrideVariant, isLoading: false };
+    }
+    if (!client) {
+      const preloaded = initialAssignments[componentId];
+      if (preloaded && variantIds.includes(preloaded)) {
+        return { variantId: preloaded, isLoading: false };
+      }
+      if (ssrFallback === "first" && variantIds.length > 0) {
+        return { variantId: variantIds[0], isLoading: false };
+      }
+      return { variantId: null, isLoading: true };
+    }
+    const cached = client.getAssignment(componentId, segment);
+    if (cached && variantIds.includes(cached.variantId)) {
+      return { variantId: cached.variantId, isLoading: false };
+    }
+    const weights = getWeights(componentId);
+    if (weights) {
+      const chosen = pickFromWeights(weights, variantIds);
+      if (chosen) return { variantId: chosen, isLoading: false };
+    }
+    return { variantId: (_a = variantIds[0]) != null ? _a : null, isLoading: false };
+  })();
+  const [state, setState] = useState2(initial);
+  const reportAssignment = (variantId) => {
+    if (!onAssignment) return;
+    if (assignmentReportedRef.current === variantId) return;
+    assignmentReportedRef.current = variantId;
+    onAssignment(componentId, variantId);
+  };
+  useEffect2(() => {
+    if (overrideVariant) return;
+    if (!client) return;
+    const cached = client.getAssignment(componentId, segment);
+    if (cached && variantIds.includes(cached.variantId)) {
+      setState({ variantId: cached.variantId, isLoading: false });
+      reportAssignment(cached.variantId);
+      return;
+    }
+    setState((prev) => {
+      var _a;
+      return prev.variantId ? prev : { variantId: (_a = variantIds[0]) != null ? _a : null, isLoading: false };
+    });
+  }, [overrideVariant, client, componentId, segment]);
+  useEffect2(() => {
+    if (overrideVariant) return;
+    if (!client) return;
+    const cached = client.getAssignment(componentId, segment);
+    if (cached && variantIds.includes(cached.variantId)) return;
+    let cancelled = false;
+    void client.assign(componentId, variantIds).then((result) => {
+      if (cancelled) return;
+      if (!result || !variantIds.includes(result.variantId)) return;
+      setState({ variantId: result.variantId, isLoading: false });
+      reportAssignment(result.variantId);
+    });
+    return () => {
+      cancelled = true;
+    };
+  }, [overrideVariant, client, componentId, segment]);
+  useEffect2(() => {
+    if (overrideVariant) return;
+    if (!client) return;
+    return subscribe(componentId, (weights) => {
+      const cached = client.getAssignment(componentId, segment);
+      if (cached && variantIds.includes(cached.variantId)) {
+        setState({ variantId: cached.variantId, isLoading: false });
+        return;
+      }
+      const chosen = pickFromWeights(weights, variantIds);
+      if (chosen) setState({ variantId: chosen, isLoading: false });
+    });
+  }, [overrideVariant, client, componentId, segment]);
+  if (overrideVariant) {
+    return { variantId: overrideVariant, isLoading: false };
+  }
+  return state;
+}
+
+// src/adaptive.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+function normalize(goal) {
+  if (typeof goal === "string") return { type: "click" };
+  return goal;
+}
+function isClickableTarget(el) {
+  if (!(el instanceof Element)) return false;
+  const tag = el.tagName.toLowerCase();
+  if (tag === "a" || tag === "button") return true;
+  const role = el.getAttribute("role");
+  return role === "button";
+}
+function findClickable(start, container) {
+  let cursor = start;
+  while (cursor && cursor !== container) {
+    if (isClickableTarget(cursor)) return true;
+    cursor = cursor.parentElement;
+  }
+  return false;
+}
+function AdaptiveImpl(props) {
+  var _a;
+  const client = useSentient();
+  const projectId = useAdaptiveProjectId();
+  const variantIds = useMemo(() => Object.keys(props.variants), [props.variants]);
+  const { variantId } = useAssignment(props.id, variantIds);
+  const containerRef = useRef2(null);
+  const [mounted, setMounted] = useState3(false);
+  useEffect3(() => {
+    setMounted(true);
+  }, []);
+  const goalFiredRef = useRef2(false);
+  const assignTrackedRef = useRef2(null);
+  const goal = useMemo(() => normalize(props.goal), [props.goal]);
+  const goalLabel = typeof props.goal === "string" ? props.goal : goal.type;
+  useEffect3(() => {
+    var _a2, _b;
+    if (!client || !variantId || !projectId) return;
+    if (assignTrackedRef.current === variantId) return;
+    const rawHtml = (_b = (_a2 = containerRef.current) == null ? void 0 : _a2.innerHTML) != null ? _b : "";
+    if (!rawHtml && !mounted) return;
+    assignTrackedRef.current = variantId;
+    client.track({
+      projectId,
+      componentId: props.id,
+      variantId,
+      eventType: "variant_assigned",
+      payload: rawHtml ? { previewHtml: rawHtml.slice(0, 3e4) } : {}
+    });
+  }, [client, variantId, projectId, props.id, mounted]);
+  useEffect3(() => {
+    goalFiredRef.current = false;
+  }, [variantId]);
+  useEffect3(() => {
+    if (!client || !variantId) return;
+    const node = containerRef.current;
+    if (!node) return;
+    let timerId = null;
+    let hoverStart = 0;
+    const onEnter = () => {
+      hoverStart = Date.now();
+      timerId = setTimeout(() => {
+        client.track({
+          projectId,
+          componentId: props.id,
+          variantId,
+          eventType: "cursor_signal",
+          payload: { hoverDuration: Date.now() - hoverStart }
+        });
+        timerId = null;
+      }, 800);
+    };
+    const onLeave = () => {
+      if (timerId !== null) {
+        clearTimeout(timerId);
+        timerId = null;
+      }
+    };
+    node.addEventListener("mouseenter", onEnter);
+    node.addEventListener("mouseleave", onLeave);
+    return () => {
+      node.removeEventListener("mouseenter", onEnter);
+      node.removeEventListener("mouseleave", onLeave);
+      if (timerId !== null) clearTimeout(timerId);
+    };
+  }, [client, variantId, projectId, props.id]);
+  useEffect3(() => {
+    if (!client || !variantId) return;
+    const node = containerRef.current;
+    if (!node) return;
+    const fireGoal = () => {
+      if (goalFiredRef.current) return;
+      goalFiredRef.current = true;
+      client.track({
+        projectId,
+        componentId: props.id,
+        variantId,
+        eventType: "goal_achieved",
+        goalType: goalLabel,
+        payload: { reward: 1 }
+      });
+    };
+    const subgoals = goal.type === "composite" ? goal.all : [goal];
+    const remaining = new Set(subgoals.map((_, i) => i));
+    const checkComposite = (idx) => {
+      remaining.delete(idx);
+      if (remaining.size === 0) fireGoal();
+    };
+    const cleanups = [];
+    subgoals.forEach((sub, idx) => {
+      if (sub.type === "click") {
+        const onClick = (e) => {
+          const target = e.target;
+          if (!(target instanceof Element)) return;
+          if (!findClickable(target, node)) return;
+          if (goal.type === "composite") checkComposite(idx);
+          else fireGoal();
+        };
+        node.addEventListener("click", onClick);
+        cleanups.push(() => node.removeEventListener("click", onClick));
+        return;
+      }
+      if (sub.type === "form_submit") {
+        const onSubmit = (e) => {
+          if (!(e.target instanceof HTMLFormElement)) return;
+          if (!node.contains(e.target)) return;
+          if (goal.type === "composite") checkComposite(idx);
+          else fireGoal();
+        };
+        node.addEventListener("submit", onSubmit);
+        cleanups.push(() => node.removeEventListener("submit", onSubmit));
+        return;
+      }
+      if (sub.type === "scroll_depth") {
+        const threshold = Math.max(0, Math.min(1, sub.threshold));
+        const io = new IntersectionObserver(
+          (entries) => {
+            for (const entry of entries) {
+              if (entry.intersectionRatio >= threshold) {
+                if (goal.type === "composite") checkComposite(idx);
+                else fireGoal();
+                io.disconnect();
+                break;
+              }
+            }
+          },
+          { threshold: [threshold] }
+        );
+        io.observe(node);
+        cleanups.push(() => io.disconnect());
+        return;
+      }
+    });
+    return () => {
+      for (const c of cleanups) c();
+    };
+  }, [client, variantId, projectId, props.id, goal, goalLabel]);
+  if (props.clientOnly && (!mounted || !client)) return null;
+  if (!variantId) return null;
+  const content = (_a = props.variants[variantId]) != null ? _a : null;
+  return /* @__PURE__ */ jsx2("div", { ref: containerRef, "data-sentient-id": props.id, "data-sentient-variant": variantId, children: content });
+}
+var Adaptive = memo(AdaptiveImpl, (prev, next) => {
+  if (prev.id !== next.id) return false;
+  if (prev.goal !== next.goal) return false;
+  if (prev.variants === next.variants) return true;
+  const prevKeys = Object.keys(prev.variants);
+  const nextKeys = Object.keys(next.variants);
+  if (prevKeys.length !== nextKeys.length) return false;
+  return prevKeys.every((k) => k in next.variants);
+});
+
+// src/segment.ts
+import { deriveSessionSegment } from "@sentientui/core";
+export {
+  Adaptive,
+  AdaptiveProvider,
+  deriveSessionSegment as detectSegment,
+  getWeights,
+  subscribe as subscribeWeights,
+  update as updateWeights,
+  useAssignment,
+  useInitialAssignments,
+  useSentient
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/provider.tsx","../src/adaptive.tsx","../src/use-assignment.ts","../src/weights-store.ts","../src/segment.ts"],"sourcesContent":["'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};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n  client: null,\n  projectId: '',\n  initialAssignments: {},\n  sessionSegment: 'desktop:direct',\n  ssrFallback: 'first',\n  onAssignment: undefined,\n});\n\nexport type AdaptiveProviderProps = {\n  apiKey: string;\n  context: SentientConfig['context'];\n  ingestUrl: string;\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  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) => {\n        prev?.destroy();\n        return null;\n      });\n      return;\n    }\n\n    const c = init({\n      apiKey: props.apiKey,\n      context: props.context,\n      ingestUrl: props.ingestUrl,\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      }}\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","'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 { 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) => {\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. */\r\n\r\nexport type VariantWeight = {\r\n  variantId: string;\r\n  pulls: number;\r\n  avgReward: number;\r\n};\r\n\r\nexport type ComponentWeights = {\r\n  componentId: string;\r\n  variants: VariantWeight[];\r\n  updatedAt: number;\r\n};\r\n\r\ntype Listener = (weights: ComponentWeights) => void;\r\n\r\nconst store = new Map<string, ComponentWeights>();\r\nconst listeners = new Map<string, Set<Listener>>();\r\n\r\n/**\r\n * Subscribes a listener to a single component. Returns an unsubscribe function.\r\n * Updates to other components never trigger this listener.\r\n */\r\nexport function subscribe(componentId: string, cb: Listener): () => void {\r\n  let set = listeners.get(componentId);\r\n  if (!set) {\r\n    set = new Set();\r\n    listeners.set(componentId, set);\r\n  }\r\n  set.add(cb);\r\n  return () => {\r\n    set!.delete(cb);\r\n    if (set!.size === 0) listeners.delete(componentId);\r\n  };\r\n}\r\n\r\n/**\r\n * Replaces the weights for a component and notifies only that component's\r\n * subscribers.\r\n */\r\nexport function update(componentId: string, weights: ComponentWeights): void {\r\n  store.set(componentId, weights);\r\n  const set = listeners.get(componentId);\r\n  if (!set) return;\r\n  for (const cb of set) {\r\n    try {\r\n      cb(weights);\r\n    } catch {\r\n      /* never throw to other listeners */\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Returns the latest known weights for a component, or null if none seen.\r\n */\r\nexport function getWeights(componentId: string): ComponentWeights | null {\r\n  return store.get(componentId) ?? null;\r\n}\r\n\r\n/** Test-only: wipe the entire store. */\r\nexport function _resetWeightsStore(): void {\r\n  store.clear();\r\n  listeners.clear();\r\n}\r\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":["useEffect","useRef","useState","useEffect","useState","useState","useEffect","jsx","useRef","useState","useEffect","_a"]}

package/dist/next/adaptive-root-client.d.ts

@@ -0,0 +1,50 @@
+import { ReactNode } from 'react';
+import { SentientConfig } from '@sentientui/core';
+
+/** 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()`.
+     * Passed through to `useAssignment` as synchronous initial state so crawlers and
+     * the first paint see real content (recommended for SEO).
+     */
+    initialAssignments?: Record<string, string>;
+    /**
+     * Bandit segment from SSR (`device:source`). Keeps cache, assign, and worker
+     * weights on one row — must match `loadAdaptiveAssignments` / session upsert.
+     */
+    sessionSegment?: string;
+    /**
+     * When no `initialAssignments` exist for a component, `'first'` renders
+     * `variantIds[0]` in server HTML (safe default for SEO). Use `'none'` only for
+     * decorative slots marked `clientOnly`.
+     * @default 'first'
+     */
+    ssrFallback?: SsrFallback;
+    /**
+     * Consent gate. When `false` the SDK is not initialised and no events are
+     * sent. Flip to `true` (e.g. after the user accepts the cookie banner) to
+     * initialise and begin tracking.
+     */
+    consent?: boolean;
+    /**
+     * Called once per component the first time a variant is resolved for that
+     * component in this session. Use to forward assignments to your own analytics
+     * (Mixpanel, PostHog, Segment, etc.) without having to wrap `useAssignment`.
+     */
+    onAssignment?: (componentId: string, variantId: string) => void;
+    children: ReactNode;
+};
+
+type AdaptiveRootClientProps = AdaptiveProviderProps & {
+    children: ReactNode;
+};
+/** Client boundary for {@link AdaptiveRoot} — keeps context/hooks out of the server bundle. */
+declare function AdaptiveRootClient(props: AdaptiveRootClientProps): JSX.Element;
+
+export { AdaptiveRootClient, type AdaptiveRootClientProps };

package/dist/next/adaptive-root-client.js

@@ -0,0 +1,82 @@
+'use client';
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+
+// src/provider.tsx
+import { createContext, useContext, useEffect, useState } from "react";
+import { init } from "@sentientui/core";
+import { jsx } from "react/jsx-runtime";
+var AdaptiveContext = createContext({
+  client: null,
+  projectId: "",
+  initialAssignments: {},
+  sessionSegment: "desktop:direct",
+  ssrFallback: "first",
+  onAssignment: void 0
+});
+function AdaptiveProvider(props) {
+  var _a, _b, _c;
+  const [client, setClient] = useState(null);
+  useEffect(() => {
+    if (props.consent === false) {
+      setClient((prev) => {
+        prev == null ? void 0 : prev.destroy();
+        return null;
+      });
+      return;
+    }
+    const c = init({
+      apiKey: props.apiKey,
+      context: props.context,
+      ingestUrl: props.ingestUrl,
+      debug: props.debug,
+      initialAssignments: props.initialAssignments,
+      sessionSegment: props.sessionSegment,
+      consent: props.consent
+    });
+    setClient(c);
+    return () => {
+      c.destroy();
+    };
+  }, [props.consent]);
+  const ssrFallback = (_a = props.ssrFallback) != null ? _a : "first";
+  return /* @__PURE__ */ jsx(
+    AdaptiveContext.Provider,
+    {
+      value: {
+        client,
+        projectId: props.apiKey,
+        initialAssignments: (_b = props.initialAssignments) != null ? _b : {},
+        sessionSegment: (_c = props.sessionSegment) != null ? _c : "desktop:direct",
+        ssrFallback,
+        onAssignment: props.onAssignment
+      },
+      children: props.children
+    }
+  );
+}
+
+// src/next/adaptive-root-client.tsx
+import { jsx as jsx2 } from "react/jsx-runtime";
+function AdaptiveRootClient(props) {
+  return /* @__PURE__ */ jsx2(AdaptiveProvider, __spreadValues({}, props));
+}
+export {
+  AdaptiveRootClient
+};
+//# sourceMappingURL=adaptive-root-client.js.map

package/dist/next/adaptive-root-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/provider.tsx","../../src/next/adaptive-root-client.tsx"],"sourcesContent":["'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};\n\nconst AdaptiveContext = createContext<AdaptiveContextValue>({\n  client: null,\n  projectId: '',\n  initialAssignments: {},\n  sessionSegment: 'desktop:direct',\n  ssrFallback: 'first',\n  onAssignment: undefined,\n});\n\nexport type AdaptiveProviderProps = {\n  apiKey: string;\n  context: SentientConfig['context'];\n  ingestUrl: string;\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  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) => {\n        prev?.destroy();\n        return null;\n      });\n      return;\n    }\n\n    const c = init({\n      apiKey: props.apiKey,\n      context: props.context,\n      ingestUrl: props.ingestUrl,\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      }}\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","'use client';\r\n\r\nimport type { ReactNode } from 'react';\r\nimport { AdaptiveProvider, type AdaptiveProviderProps } from '../provider.js';\r\n\r\nexport type AdaptiveRootClientProps = AdaptiveProviderProps & {\r\n  children: ReactNode;\r\n};\r\n\r\n/** Client boundary for {@link AdaptiveRoot} — keeps context/hooks out of the server bundle. */\r\nexport function AdaptiveRootClient(props: AdaptiveRootClientProps): JSX.Element {\r\n  return <AdaptiveProvider {...props} />;\r\n}\r\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAEA,SAAS,eAAe,YAAY,WAAW,gBAAgC;AAC/E,SAAS,YAAsD;AAkG3D;AApFJ,IAAM,kBAAkB,cAAoC;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,IAAI,SAAgC,IAAI;AAEhE,YAAU,MAAM;AAEd,QAAI,MAAM,YAAY,OAAO;AAC3B,gBAAU,CAAC,SAAS;AAClB,qCAAM;AACN,eAAO;AAAA,MACT,CAAC;AACD;AAAA,IACF;AAEA,UAAM,IAAI,KAAK;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;;;ACvGS,gBAAAA,YAAA;AADF,SAAS,mBAAmB,OAA6C;AAC9E,SAAO,gBAAAA,KAAC,qCAAqB,MAAO;AACtC;","names":["jsx"]}