begeniux 0.1.0

package/dist/index.cjs

@@ -0,0 +1,523 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BeGenProvider: () => BeGenProvider,
+  BeGenSurface: () => BeGenSurface,
+  PERSONAS: () => PERSONAS,
+  createGeminiClassifier: () => createGeminiClassifier,
+  createHeuristicClassifier: () => createHeuristicClassifier,
+  useBeGenContext: () => useBeGenContext,
+  useBehaviorTracker: () => useBehaviorTracker
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/BeGenProvider.tsx
+var React = __toESM(require("react"), 1);
+var import_jsx_runtime = require("react/jsx-runtime");
+var BeGenContext = React.createContext(null);
+function BeGenProvider({ children }) {
+  const [variant, setVariant] = React.useState("neutral");
+  const [directive, setDirective] = React.useState(null);
+  const [summary, setSummary] = React.useState(null);
+  const value = React.useMemo(
+    () => ({ variant, directive, summary, setVariant, setDirective, setSummary }),
+    [variant, directive, summary]
+  );
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(BeGenContext.Provider, { value, children });
+}
+
+// src/BeGenSurface.tsx
+var React2 = __toESM(require("react"), 1);
+
+// src/useBehaviorTracker.ts
+var import_react = require("react");
+var RECENT_EVENTS_CAP = 5;
+var HOVER_MIN_MS = 200;
+function targetLabel(el) {
+  if (!(el instanceof HTMLElement)) return "unknown";
+  return el.dataset.begenId || el.getAttribute("data-product-id") || el.getAttribute("aria-label") || el.tagName.toLowerCase();
+}
+function computeSummary(buffer, bufferSize, pageContext) {
+  const now = Date.now();
+  const windowStart = now - 6e4;
+  let clicksLastMin = 0;
+  let dwellSum = 0;
+  let dwellCount = 0;
+  let maxScroll = 0;
+  const hoverTargets = /* @__PURE__ */ new Set();
+  for (const ev of buffer) {
+    if (ev.kind === "click" && ev.t >= windowStart) clicksLastMin += 1;
+    if (ev.kind === "dwell") {
+      dwellSum += ev.durationMs;
+      dwellCount += 1;
+    }
+    if (ev.kind === "scroll" && ev.depth > maxScroll) maxScroll = ev.depth;
+    if (ev.kind === "hover") hoverTargets.add(ev.target);
+  }
+  return {
+    clicks_per_min: clicksLastMin,
+    avg_dwell_ms: dwellCount === 0 ? 0 : Math.round(dwellSum / dwellCount),
+    scroll_depth: Math.max(0, Math.min(1, maxScroll)),
+    hover_count: hoverTargets.size,
+    events_seen: Math.min(buffer.length, bufferSize),
+    page_context: pageContext
+  };
+}
+function useBehaviorTracker(opts) {
+  const {
+    containerRef,
+    flushEveryEvents = 10,
+    flushAfterMs = 5e3,
+    bufferSize = 50,
+    onFlush,
+    pageContext,
+    seedTrace
+  } = opts;
+  const bufferRef = (0, import_react.useRef)([]);
+  const sinceFlushRef = (0, import_react.useRef)(0);
+  const lastFlushAtRef = (0, import_react.useRef)(Date.now());
+  const hoverStartRef = (0, import_react.useRef)(/* @__PURE__ */ new Map());
+  const scrollRafRef = (0, import_react.useRef)(null);
+  const onFlushRef = (0, import_react.useRef)(onFlush);
+  const pageContextRef = (0, import_react.useRef)(pageContext);
+  (0, import_react.useEffect)(() => {
+    onFlushRef.current = onFlush;
+  }, [onFlush]);
+  (0, import_react.useEffect)(() => {
+    pageContextRef.current = pageContext;
+  }, [pageContext]);
+  const [recentEvents, setRecentEvents] = (0, import_react.useState)([]);
+  const pushEvent = (ev) => {
+    const buf = bufferRef.current;
+    buf.push(ev);
+    if (buf.length > bufferSize) buf.splice(0, buf.length - bufferSize);
+    sinceFlushRef.current += 1;
+    setRecentEvents((prev) => {
+      const next = [...prev, ev];
+      if (next.length > RECENT_EVENTS_CAP) next.splice(0, next.length - RECENT_EVENTS_CAP);
+      return next;
+    });
+    if (sinceFlushRef.current >= flushEveryEvents) {
+      flush();
+    }
+  };
+  const flush = () => {
+    const summary = computeSummary(bufferRef.current, bufferSize, pageContextRef.current);
+    sinceFlushRef.current = 0;
+    lastFlushAtRef.current = Date.now();
+    onFlushRef.current(summary);
+  };
+  (0, import_react.useEffect)(() => {
+    if (seedTrace && seedTrace.length > 0) {
+      const buf = bufferRef.current;
+      const maxT = seedTrace.reduce((m, e) => e.t > m ? e.t : m, -Infinity);
+      const now = Date.now();
+      const offset = Number.isFinite(maxT) ? now - maxT : 0;
+      const rebased = seedTrace.map((e) => ({ ...e, t: e.t + offset }));
+      buf.push(...rebased);
+      if (buf.length > bufferSize) buf.splice(0, buf.length - bufferSize);
+      const summary = computeSummary(buf, bufferSize, pageContextRef.current);
+      sinceFlushRef.current = 0;
+      lastFlushAtRef.current = Date.now();
+      onFlushRef.current(summary);
+    }
+  }, []);
+  (0, import_react.useEffect)(() => {
+    const el = containerRef.current;
+    if (!el) return;
+    const onClick = (e) => {
+      pushEvent({ kind: "click", target: targetLabel(e.target), t: Date.now() });
+    };
+    const onMouseOver = (e) => {
+      const label = targetLabel(e.target);
+      if (!hoverStartRef.current.has(label)) {
+        hoverStartRef.current.set(label, Date.now());
+      }
+    };
+    const onMouseOut = (e) => {
+      const label = targetLabel(e.target);
+      const started = hoverStartRef.current.get(label);
+      if (started == null) return;
+      hoverStartRef.current.delete(label);
+      const durationMs = Date.now() - started;
+      if (durationMs < HOVER_MIN_MS) return;
+      const t = Date.now();
+      pushEvent({ kind: "hover", target: label, durationMs, t });
+      pushEvent({ kind: "dwell", target: label, durationMs, t });
+    };
+    const computeScrollDepth = () => {
+      const rect = el.getBoundingClientRect();
+      const viewportH = window.innerHeight || 1;
+      const elementH = el.scrollHeight || rect.height || 1;
+      const visibleBottom = Math.min(rect.bottom, viewportH);
+      const scrolledPast = Math.max(0, visibleBottom - rect.top);
+      return Math.max(0, Math.min(1, scrolledPast / elementH));
+    };
+    const onScroll = () => {
+      if (scrollRafRef.current != null) return;
+      scrollRafRef.current = requestAnimationFrame(() => {
+        scrollRafRef.current = null;
+        pushEvent({ kind: "scroll", depth: computeScrollDepth(), t: Date.now() });
+      });
+    };
+    el.addEventListener("click", onClick);
+    el.addEventListener("mouseover", onMouseOver);
+    el.addEventListener("mouseout", onMouseOut);
+    window.addEventListener("scroll", onScroll, { passive: true });
+    const interval = window.setInterval(() => {
+      if (Date.now() - lastFlushAtRef.current >= flushAfterMs) {
+        flush();
+      }
+    }, Math.max(250, Math.floor(flushAfterMs / 4)));
+    return () => {
+      el.removeEventListener("click", onClick);
+      el.removeEventListener("mouseover", onMouseOver);
+      el.removeEventListener("mouseout", onMouseOut);
+      window.removeEventListener("scroll", onScroll);
+      window.clearInterval(interval);
+      if (scrollRafRef.current != null) cancelAnimationFrame(scrollRafRef.current);
+    };
+  }, [containerRef, flushAfterMs, flushEveryEvents, bufferSize]);
+  return { recentEvents };
+}
+
+// src/personas.ts
+function buildDecisive() {
+  const events = [];
+  const productIds = ["p-101", "p-102", "p-103", "p-104", "p-105", "p-106"];
+  let t = 0;
+  for (let i = 0; i < 12; i++) {
+    t += 1500;
+    events.push({ kind: "click", target: productIds[i % productIds.length], t });
+  }
+  for (let i = 0; i < 6; i++) {
+    t += 800;
+    events.push({
+      kind: "dwell",
+      target: productIds[i % productIds.length],
+      durationMs: 600 + i * 80,
+      t
+    });
+  }
+  for (let i = 0; i < 6; i++) {
+    t += 1200;
+    events.push({
+      kind: "scroll",
+      depth: Math.min(0.95, 0.4 + i * 0.1),
+      t
+    });
+  }
+  for (let i = 0; i < 2; i++) {
+    t += 600;
+    events.push({
+      kind: "hover",
+      target: productIds[i],
+      durationMs: 250,
+      t
+    });
+  }
+  return events;
+}
+function buildDeliberate() {
+  const events = [];
+  const productIds = ["p-201", "p-202", "p-203", "p-204", "p-205", "p-206"];
+  let t = 0;
+  for (let i = 0; i < 6; i++) {
+    t += 5500;
+    const target = productIds[i];
+    events.push({ kind: "hover", target, durationMs: 1800 + i * 200, t });
+    t += 200;
+    events.push({
+      kind: "dwell",
+      target,
+      durationMs: 5e3 + i * 400,
+      t
+    });
+  }
+  for (let i = 0; i < 3; i++) {
+    t += 4e3;
+    events.push({ kind: "click", target: productIds[i], t });
+  }
+  for (let i = 0; i < 5; i++) {
+    t += 1500;
+    events.push({
+      kind: "scroll",
+      depth: Math.min(0.6, 0.2 + i * 0.08),
+      t
+    });
+  }
+  return events;
+}
+var PERSONAS = {
+  get decisive() {
+    return buildDecisive();
+  },
+  get deliberate() {
+    return buildDeliberate();
+  }
+};
+
+// src/BeGenSurface.tsx
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function BeGenSurface(props) {
+  const {
+    variants,
+    classify,
+    variantProps,
+    pageContext,
+    seedPersona,
+    rateLimitMs = 4e3,
+    className,
+    style
+  } = props;
+  const containerRef = React2.useRef(null);
+  const ctx = React2.useContext(BeGenContext);
+  const [currentVariant, setCurrentVariant] = React2.useState("neutral");
+  const [lastDirective, setLastDirective] = React2.useState(null);
+  const [lastSummary, setLastSummary] = React2.useState(null);
+  const lastClassifyAtRef = React2.useRef(0);
+  const inFlightRef = React2.useRef(false);
+  const classifyRef = React2.useRef(classify);
+  React2.useEffect(() => {
+    classifyRef.current = classify;
+  }, [classify]);
+  const ctxRef = React2.useRef(ctx);
+  React2.useEffect(() => {
+    ctxRef.current = ctx;
+  }, [ctx]);
+  const handleFlush = React2.useCallback(async (summary) => {
+    setLastSummary(summary);
+    ctxRef.current?.setSummary(summary);
+    const now = Date.now();
+    if (inFlightRef.current) return;
+    if (now - lastClassifyAtRef.current < rateLimitMs) return;
+    lastClassifyAtRef.current = now;
+    inFlightRef.current = true;
+    try {
+      const directive = await classifyRef.current(summary);
+      setLastDirective(directive);
+      setCurrentVariant(directive.variant);
+      ctxRef.current?.setDirective(directive);
+      ctxRef.current?.setVariant(directive.variant);
+    } catch {
+    } finally {
+      inFlightRef.current = false;
+    }
+  }, [rateLimitMs]);
+  const seedTrace = seedPersona ? PERSONAS[seedPersona] : void 0;
+  useBehaviorTracker({
+    containerRef,
+    onFlush: handleFlush,
+    pageContext,
+    seedTrace
+  });
+  const ActiveComponent = variants[currentVariant] ?? variants.neutral;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(
+    "div",
+    {
+      ref: containerRef,
+      className,
+      style,
+      "data-begen-surface": true,
+      "data-begen-variant": currentVariant,
+      children: [
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "div",
+          {
+            style: {
+              opacity: 1,
+              transition: "opacity 200ms ease",
+              animation: "begen-fade-in 200ms ease"
+            },
+            children: ActiveComponent ? /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(ActiveComponent, { ...variantProps ?? {} }) : null
+          },
+          currentVariant
+        ),
+        /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(BeGenSurfaceStyles, {}),
+        lastDirective && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+          "span",
+          {
+            style: { display: "none" },
+            "data-begen-confidence": lastDirective.confidence,
+            "data-begen-reasoning": lastDirective.reasoning,
+            "data-begen-events": lastSummary?.events_seen ?? 0
+          }
+        )
+      ]
+    }
+  );
+}
+var STYLE_INJECTED = "__begen_styles__";
+function BeGenSurfaceStyles() {
+  React2.useEffect(() => {
+    if (typeof document === "undefined") return;
+    if (document[STYLE_INJECTED]) return;
+    const tag = document.createElement("style");
+    tag.setAttribute("data-begen-styles", "");
+    tag.textContent = `@keyframes begen-fade-in { from { opacity: 0 } to { opacity: 1 } }`;
+    document.head.appendChild(tag);
+    document[STYLE_INJECTED] = true;
+  }, []);
+  return null;
+}
+
+// src/useBeGenContext.ts
+var React3 = __toESM(require("react"), 1);
+function useBeGenContext() {
+  const ctx = React3.useContext(BeGenContext);
+  if (!ctx) {
+    throw new Error("useBeGenContext must be used inside <BeGenProvider>");
+  }
+  return ctx;
+}
+
+// src/classifier/gemini.ts
+var CLASSIFIER_SYSTEM_PROMPT = `
+You classify e-commerce shopper behavior into UI variants.
+
+You receive a JSON object describing a user's recent interaction pattern on
+a product listing page. Decide which UI variant best serves them right now.
+
+Variants:
+- "decisive": user knows what they want; minimize friction. Dense grid,
+  prominent prices, fast paths to cart, no recommendations.
+  Signals: high clicks/min, low dwell, high scroll depth, few hovers.
+- "deliberate": user is researching; help them compare. Larger cards,
+  reviews surfaced inline, "people also viewed", expandable detail.
+  Signals: low clicks/min, high dwell, hovers across multiple products.
+- "neutral": insufficient signal yet, or pattern is mixed. Baseline grid.
+  Default for first ~10 events.
+
+Examples:
+Input: {"clicks_per_min":14,"avg_dwell_ms":820,"scroll_depth":0.91,"hover_count":2,"events_seen":18}
+Output: {"variant":"decisive","confidence":0.86,"reasoning":"Fast clicks, low dwell, deep scroll \u2014 purposeful navigation."}
+
+Input: {"clicks_per_min":3,"avg_dwell_ms":7400,"scroll_depth":0.42,"hover_count":4,"events_seen":22}
+Output: {"variant":"deliberate","confidence":0.81,"reasoning":"Slow pace, long dwell, multi-product hover \u2014 comparing options."}
+
+Input: {"clicks_per_min":5,"avg_dwell_ms":2100,"scroll_depth":0.55,"hover_count":2,"events_seen":7}
+Output: {"variant":"neutral","confidence":0.6,"reasoning":"Not enough events yet to commit to a mode."}
+
+Return ONLY a JSON object. No prose, no markdown.
+`.trim();
+var VALID_VARIANTS = /* @__PURE__ */ new Set(["decisive", "deliberate", "neutral"]);
+var FALLBACK = {
+  variant: "neutral",
+  confidence: 0,
+  reasoning: "Classifier error."
+};
+function createGeminiClassifier(opts) {
+  const { apiKey, model = "gemini-2.0-flash", endpoint, fetchImpl } = opts;
+  const url = endpoint ?? `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(model)}:generateContent`;
+  const fetcher = fetchImpl ?? (typeof fetch !== "undefined" ? fetch.bind(globalThis) : null);
+  return async (summary) => {
+    if (!fetcher) return FALLBACK;
+    try {
+      const res = await fetcher(`${url}?key=${encodeURIComponent(apiKey)}`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({
+          systemInstruction: { parts: [{ text: CLASSIFIER_SYSTEM_PROMPT }] },
+          contents: [
+            {
+              role: "user",
+              parts: [{ text: JSON.stringify(summary) }]
+            }
+          ],
+          generationConfig: {
+            responseMimeType: "application/json",
+            temperature: 0.2
+          }
+        })
+      });
+      if (!res.ok) return FALLBACK;
+      const data = await res.json();
+      const text = data.candidates?.[0]?.content?.parts?.[0]?.text;
+      if (!text) return FALLBACK;
+      const parsed = JSON.parse(text);
+      if (!parsed || typeof parsed !== "object" || typeof parsed.variant !== "string" || !VALID_VARIANTS.has(parsed.variant) || typeof parsed.reasoning !== "string") {
+        return FALLBACK;
+      }
+      const confidence = typeof parsed.confidence === "number" && Number.isFinite(parsed.confidence) ? Math.max(0, Math.min(1, parsed.confidence)) : 0.5;
+      return {
+        variant: parsed.variant,
+        confidence,
+        reasoning: parsed.reasoning
+      };
+    } catch {
+      return FALLBACK;
+    }
+  };
+}
+
+// src/classifier/heuristic.ts
+function createHeuristicClassifier() {
+  return async (summary) => {
+    if (summary.events_seen < 10) {
+      return {
+        variant: "neutral",
+        confidence: 0.5,
+        reasoning: "Insufficient events."
+      };
+    }
+    if (summary.clicks_per_min > 8 && summary.avg_dwell_ms < 2e3) {
+      return {
+        variant: "decisive",
+        confidence: 0.8,
+        reasoning: "Fast pace, low dwell."
+      };
+    }
+    if (summary.avg_dwell_ms > 4e3 && summary.hover_count > 2) {
+      return {
+        variant: "deliberate",
+        confidence: 0.8,
+        reasoning: "Slow pace, multi-hover."
+      };
+    }
+    return {
+      variant: "neutral",
+      confidence: 0.6,
+      reasoning: "Mixed signals."
+    };
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BeGenProvider,
+  BeGenSurface,
+  PERSONAS,
+  createGeminiClassifier,
+  createHeuristicClassifier,
+  useBeGenContext,
+  useBehaviorTracker
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/BeGenProvider.tsx","../src/BeGenSurface.tsx","../src/useBehaviorTracker.ts","../src/personas.ts","../src/useBeGenContext.ts","../src/classifier/gemini.ts","../src/classifier/heuristic.ts"],"sourcesContent":["// Components\nexport { BeGenProvider } from \"./BeGenProvider\";\nexport { BeGenSurface } from \"./BeGenSurface\";\n\n// Hooks\nexport { useBehaviorTracker } from \"./useBehaviorTracker\";\nexport { useBeGenContext } from \"./useBeGenContext\";\n\n// Classifier helpers\nexport { createGeminiClassifier } from \"./classifier/gemini\";\nexport { createHeuristicClassifier } from \"./classifier/heuristic\";\n\n// Persona trace presets\nexport { PERSONAS } from \"./personas\";\n\n// Types\nexport type {\n  BehaviorEvent,\n  BehaviorSummary,\n  Variant,\n  AgentDirective,\n  ClassifyFn,\n} from \"./types\";\nexport type { BeGenSurfaceProps } from \"./BeGenSurface\";\nexport type { BeGenContextValue } from \"./BeGenProvider\";\nexport type { CreateGeminiClassifierOpts } from \"./classifier/gemini\";\nexport type { UseBehaviorTrackerOpts } from \"./useBehaviorTracker\";\n","import * as React from \"react\";\nimport type { AgentDirective, BehaviorSummary, Variant } from \"./types\";\n\nexport type BeGenContextValue = {\n  variant: Variant;\n  directive: AgentDirective | null;\n  summary: BehaviorSummary | null;\n  setVariant: (v: Variant) => void;\n  setDirective: (d: AgentDirective) => void;\n  setSummary: (s: BehaviorSummary) => void;\n};\n\nexport const BeGenContext = React.createContext<BeGenContextValue | null>(null);\n\nexport function BeGenProvider({ children }: { children: React.ReactNode }) {\n  const [variant, setVariant] = React.useState<Variant>(\"neutral\");\n  const [directive, setDirective] = React.useState<AgentDirective | null>(null);\n  const [summary, setSummary] = React.useState<BehaviorSummary | null>(null);\n\n  const value = React.useMemo<BeGenContextValue>(\n    () => ({ variant, directive, summary, setVariant, setDirective, setSummary }),\n    [variant, directive, summary],\n  );\n\n  return <BeGenContext.Provider value={value}>{children}</BeGenContext.Provider>;\n}\n","import * as React from \"react\";\nimport type { AgentDirective, BehaviorSummary, ClassifyFn, Variant } from \"./types\";\nimport { useBehaviorTracker } from \"./useBehaviorTracker\";\nimport { BeGenContext } from \"./BeGenProvider\";\nimport { PERSONAS } from \"./personas\";\n\nexport type BeGenSurfaceProps = {\n  variants: Record<Variant, React.ComponentType<any>>;\n  classify: ClassifyFn;\n  variantProps?: Record<string, any>;\n  pageContext: BehaviorSummary[\"page_context\"];\n  seedPersona?: \"decisive\" | \"deliberate\";\n  rateLimitMs?: number;\n  className?: string;\n  style?: React.CSSProperties;\n  children?: never;\n};\n\nexport function BeGenSurface(props: BeGenSurfaceProps) {\n  const {\n    variants,\n    classify,\n    variantProps,\n    pageContext,\n    seedPersona,\n    rateLimitMs = 4000,\n    className,\n    style,\n  } = props;\n\n  const containerRef = React.useRef<HTMLDivElement>(null);\n  const ctx = React.useContext(BeGenContext);\n\n  const [currentVariant, setCurrentVariant] = React.useState<Variant>(\"neutral\");\n  const [lastDirective, setLastDirective] = React.useState<AgentDirective | null>(null);\n  const [lastSummary, setLastSummary] = React.useState<BehaviorSummary | null>(null);\n\n  const lastClassifyAtRef = React.useRef(0);\n  const inFlightRef = React.useRef(false);\n  const classifyRef = React.useRef(classify);\n  React.useEffect(() => {\n    classifyRef.current = classify;\n  }, [classify]);\n\n  const ctxRef = React.useRef(ctx);\n  React.useEffect(() => {\n    ctxRef.current = ctx;\n  }, [ctx]);\n\n  const handleFlush = React.useCallback(async (summary: BehaviorSummary) => {\n    setLastSummary(summary);\n    ctxRef.current?.setSummary(summary);\n\n    const now = Date.now();\n    if (inFlightRef.current) return;\n    if (now - lastClassifyAtRef.current < rateLimitMs) return;\n\n    lastClassifyAtRef.current = now;\n    inFlightRef.current = true;\n    try {\n      const directive = await classifyRef.current(summary);\n      setLastDirective(directive);\n      setCurrentVariant(directive.variant);\n      ctxRef.current?.setDirective(directive);\n      ctxRef.current?.setVariant(directive.variant);\n    } catch {\n      // Keep current variant on classifier failure.\n    } finally {\n      inFlightRef.current = false;\n    }\n  }, [rateLimitMs]);\n\n  const seedTrace = seedPersona ? PERSONAS[seedPersona] : undefined;\n\n  useBehaviorTracker({\n    containerRef,\n    onFlush: handleFlush,\n    pageContext,\n    seedTrace,\n  });\n\n  const ActiveComponent = variants[currentVariant] ?? variants.neutral;\n\n  return (\n    <div\n      ref={containerRef}\n      className={className}\n      style={style}\n      data-begen-surface\n      data-begen-variant={currentVariant}\n    >\n      <div\n        key={currentVariant}\n        style={{\n          opacity: 1,\n          transition: \"opacity 200ms ease\",\n          animation: \"begen-fade-in 200ms ease\",\n        }}\n      >\n        {ActiveComponent ? <ActiveComponent {...(variantProps ?? {})} /> : null}\n      </div>\n      <BeGenSurfaceStyles />\n      {/* Expose directive/summary on a hidden node for debugging */}\n      {lastDirective && (\n        <span\n          style={{ display: \"none\" }}\n          data-begen-confidence={lastDirective.confidence}\n          data-begen-reasoning={lastDirective.reasoning}\n          data-begen-events={lastSummary?.events_seen ?? 0}\n        />\n      )}\n    </div>\n  );\n}\n\nconst STYLE_INJECTED = \"__begen_styles__\";\n\nfunction BeGenSurfaceStyles() {\n  React.useEffect(() => {\n    if (typeof document === \"undefined\") return;\n    if ((document as any)[STYLE_INJECTED]) return;\n    const tag = document.createElement(\"style\");\n    tag.setAttribute(\"data-begen-styles\", \"\");\n    tag.textContent = `@keyframes begen-fade-in { from { opacity: 0 } to { opacity: 1 } }`;\n    document.head.appendChild(tag);\n    (document as any)[STYLE_INJECTED] = true;\n  }, []);\n  return null;\n}\n","import { useEffect, useRef, useState } from \"react\";\nimport type { BehaviorEvent, BehaviorSummary } from \"./types\";\n\nexport type UseBehaviorTrackerOpts = {\n  containerRef: React.RefObject<HTMLElement>;\n  flushEveryEvents?: number;\n  flushAfterMs?: number;\n  bufferSize?: number;\n  onFlush: (summary: BehaviorSummary) => void;\n  pageContext: BehaviorSummary[\"page_context\"];\n  seedTrace?: BehaviorEvent[];\n};\n\nconst RECENT_EVENTS_CAP = 5;\nconst HOVER_MIN_MS = 200;\n\nfunction targetLabel(el: EventTarget | null): string {\n  if (!(el instanceof HTMLElement)) return \"unknown\";\n  return (\n    el.dataset.begenId ||\n    el.getAttribute(\"data-product-id\") ||\n    el.getAttribute(\"aria-label\") ||\n    el.tagName.toLowerCase()\n  );\n}\n\nfunction computeSummary(\n  buffer: BehaviorEvent[],\n  bufferSize: number,\n  pageContext: BehaviorSummary[\"page_context\"],\n): BehaviorSummary {\n  const now = Date.now();\n  const windowStart = now - 60_000;\n\n  let clicksLastMin = 0;\n  let dwellSum = 0;\n  let dwellCount = 0;\n  let maxScroll = 0;\n  const hoverTargets = new Set<string>();\n\n  for (const ev of buffer) {\n    if (ev.kind === \"click\" && ev.t >= windowStart) clicksLastMin += 1;\n    if (ev.kind === \"dwell\") {\n      dwellSum += ev.durationMs;\n      dwellCount += 1;\n    }\n    if (ev.kind === \"scroll\" && ev.depth > maxScroll) maxScroll = ev.depth;\n    if (ev.kind === \"hover\") hoverTargets.add(ev.target);\n  }\n\n  return {\n    clicks_per_min: clicksLastMin,\n    avg_dwell_ms: dwellCount === 0 ? 0 : Math.round(dwellSum / dwellCount),\n    scroll_depth: Math.max(0, Math.min(1, maxScroll)),\n    hover_count: hoverTargets.size,\n    events_seen: Math.min(buffer.length, bufferSize),\n    page_context: pageContext,\n  };\n}\n\nexport function useBehaviorTracker(opts: UseBehaviorTrackerOpts): {\n  recentEvents: BehaviorEvent[];\n} {\n  const {\n    containerRef,\n    flushEveryEvents = 10,\n    flushAfterMs = 5000,\n    bufferSize = 50,\n    onFlush,\n    pageContext,\n    seedTrace,\n  } = opts;\n\n  const bufferRef = useRef<BehaviorEvent[]>([]);\n  const sinceFlushRef = useRef(0);\n  const lastFlushAtRef = useRef(Date.now());\n  const hoverStartRef = useRef<Map<string, number>>(new Map());\n  const scrollRafRef = useRef<number | null>(null);\n\n  const onFlushRef = useRef(onFlush);\n  const pageContextRef = useRef(pageContext);\n  useEffect(() => {\n    onFlushRef.current = onFlush;\n  }, [onFlush]);\n  useEffect(() => {\n    pageContextRef.current = pageContext;\n  }, [pageContext]);\n\n  const [recentEvents, setRecentEvents] = useState<BehaviorEvent[]>([]);\n\n  const pushEvent = (ev: BehaviorEvent) => {\n    const buf = bufferRef.current;\n    buf.push(ev);\n    if (buf.length > bufferSize) buf.splice(0, buf.length - bufferSize);\n    sinceFlushRef.current += 1;\n\n    setRecentEvents((prev) => {\n      const next = [...prev, ev];\n      if (next.length > RECENT_EVENTS_CAP) next.splice(0, next.length - RECENT_EVENTS_CAP);\n      return next;\n    });\n\n    if (sinceFlushRef.current >= flushEveryEvents) {\n      flush();\n    }\n  };\n\n  const flush = () => {\n    const summary = computeSummary(bufferRef.current, bufferSize, pageContextRef.current);\n    sinceFlushRef.current = 0;\n    lastFlushAtRef.current = Date.now();\n    onFlushRef.current(summary);\n  };\n\n  useEffect(() => {\n    if (seedTrace && seedTrace.length > 0) {\n      const buf = bufferRef.current;\n      // Rebase t values so the latest seed event aligns with Date.now().\n      // Personas use small relative timestamps; this ensures click-per-min\n      // and freshness-based metrics see them as recent activity.\n      const maxT = seedTrace.reduce((m, e) => (e.t > m ? e.t : m), -Infinity);\n      const now = Date.now();\n      const offset = Number.isFinite(maxT) ? now - maxT : 0;\n      const rebased = seedTrace.map((e) => ({ ...e, t: e.t + offset }));\n      buf.push(...rebased);\n      if (buf.length > bufferSize) buf.splice(0, buf.length - bufferSize);\n      const summary = computeSummary(buf, bufferSize, pageContextRef.current);\n      sinceFlushRef.current = 0;\n      lastFlushAtRef.current = Date.now();\n      onFlushRef.current(summary);\n    }\n    // mount-only seed\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  useEffect(() => {\n    const el = containerRef.current;\n    if (!el) return;\n\n    const onClick = (e: MouseEvent) => {\n      pushEvent({ kind: \"click\", target: targetLabel(e.target), t: Date.now() });\n    };\n\n    const onMouseOver = (e: MouseEvent) => {\n      const label = targetLabel(e.target);\n      if (!hoverStartRef.current.has(label)) {\n        hoverStartRef.current.set(label, Date.now());\n      }\n    };\n\n    const onMouseOut = (e: MouseEvent) => {\n      const label = targetLabel(e.target);\n      const started = hoverStartRef.current.get(label);\n      if (started == null) return;\n      hoverStartRef.current.delete(label);\n      const durationMs = Date.now() - started;\n      if (durationMs < HOVER_MIN_MS) return;\n      const t = Date.now();\n      pushEvent({ kind: \"hover\", target: label, durationMs, t });\n      pushEvent({ kind: \"dwell\", target: label, durationMs, t });\n    };\n\n    const computeScrollDepth = () => {\n      const rect = el.getBoundingClientRect();\n      const viewportH = window.innerHeight || 1;\n      const elementH = el.scrollHeight || rect.height || 1;\n      const visibleBottom = Math.min(rect.bottom, viewportH);\n      const scrolledPast = Math.max(0, visibleBottom - rect.top);\n      return Math.max(0, Math.min(1, scrolledPast / elementH));\n    };\n\n    const onScroll = () => {\n      if (scrollRafRef.current != null) return;\n      scrollRafRef.current = requestAnimationFrame(() => {\n        scrollRafRef.current = null;\n        pushEvent({ kind: \"scroll\", depth: computeScrollDepth(), t: Date.now() });\n      });\n    };\n\n    el.addEventListener(\"click\", onClick);\n    el.addEventListener(\"mouseover\", onMouseOver);\n    el.addEventListener(\"mouseout\", onMouseOut);\n    window.addEventListener(\"scroll\", onScroll, { passive: true });\n\n    const interval = window.setInterval(() => {\n      if (Date.now() - lastFlushAtRef.current >= flushAfterMs) {\n        flush();\n      }\n    }, Math.max(250, Math.floor(flushAfterMs / 4)));\n\n    return () => {\n      el.removeEventListener(\"click\", onClick);\n      el.removeEventListener(\"mouseover\", onMouseOver);\n      el.removeEventListener(\"mouseout\", onMouseOut);\n      window.removeEventListener(\"scroll\", onScroll);\n      window.clearInterval(interval);\n      if (scrollRafRef.current != null) cancelAnimationFrame(scrollRafRef.current);\n    };\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [containerRef, flushAfterMs, flushEveryEvents, bufferSize]);\n\n  return { recentEvents };\n}\n","import type { BehaviorEvent } from \"./types\";\n\n// Persona traces use *relative* t values (ms). The tracker rebases them so the\n// latest event becomes Date.now() at mount, keeping clicks_per_min meaningful.\n\nfunction buildDecisive(): BehaviorEvent[] {\n  // ~12 fast clicks across 6 product targets, short dwells, deep scroll.\n  const events: BehaviorEvent[] = [];\n  const productIds = [\"p-101\", \"p-102\", \"p-103\", \"p-104\", \"p-105\", \"p-106\"];\n  let t = 0;\n\n  for (let i = 0; i < 12; i++) {\n    t += 1500;\n    events.push({ kind: \"click\", target: productIds[i % productIds.length], t });\n  }\n  for (let i = 0; i < 6; i++) {\n    t += 800;\n    events.push({\n      kind: \"dwell\",\n      target: productIds[i % productIds.length],\n      durationMs: 600 + i * 80,\n      t,\n    });\n  }\n  for (let i = 0; i < 6; i++) {\n    t += 1200;\n    events.push({\n      kind: \"scroll\",\n      depth: Math.min(0.95, 0.4 + i * 0.1),\n      t,\n    });\n  }\n  for (let i = 0; i < 2; i++) {\n    t += 600;\n    events.push({\n      kind: \"hover\",\n      target: productIds[i],\n      durationMs: 250,\n      t,\n    });\n  }\n\n  return events;\n}\n\nfunction buildDeliberate(): BehaviorEvent[] {\n  // ~3 clicks across 6 distinct hover targets, long dwells, modest scroll.\n  const events: BehaviorEvent[] = [];\n  const productIds = [\"p-201\", \"p-202\", \"p-203\", \"p-204\", \"p-205\", \"p-206\"];\n  let t = 0;\n\n  for (let i = 0; i < 6; i++) {\n    t += 5500;\n    const target = productIds[i];\n    events.push({ kind: \"hover\", target, durationMs: 1800 + i * 200, t });\n    t += 200;\n    events.push({\n      kind: \"dwell\",\n      target,\n      durationMs: 5000 + i * 400,\n      t,\n    });\n  }\n  for (let i = 0; i < 3; i++) {\n    t += 4000;\n    events.push({ kind: \"click\", target: productIds[i], t });\n  }\n  for (let i = 0; i < 5; i++) {\n    t += 1500;\n    events.push({\n      kind: \"scroll\",\n      depth: Math.min(0.6, 0.2 + i * 0.08),\n      t,\n    });\n  }\n\n  return events;\n}\n\nexport const PERSONAS: Record<\"decisive\" | \"deliberate\", BehaviorEvent[]> = {\n  get decisive() {\n    return buildDecisive();\n  },\n  get deliberate() {\n    return buildDeliberate();\n  },\n};\n","import * as React from \"react\";\nimport { BeGenContext, type BeGenContextValue } from \"./BeGenProvider\";\n\nexport function useBeGenContext(): BeGenContextValue {\n  const ctx = React.useContext(BeGenContext);\n  if (!ctx) {\n    throw new Error(\"useBeGenContext must be used inside <BeGenProvider>\");\n  }\n  return ctx;\n}\n","import type { AgentDirective, ClassifyFn, Variant } from \"../types\";\n\nconst CLASSIFIER_SYSTEM_PROMPT = `\nYou classify e-commerce shopper behavior into UI variants.\n\nYou receive a JSON object describing a user's recent interaction pattern on\na product listing page. Decide which UI variant best serves them right now.\n\nVariants:\n- \"decisive\": user knows what they want; minimize friction. Dense grid,\n  prominent prices, fast paths to cart, no recommendations.\n  Signals: high clicks/min, low dwell, high scroll depth, few hovers.\n- \"deliberate\": user is researching; help them compare. Larger cards,\n  reviews surfaced inline, \"people also viewed\", expandable detail.\n  Signals: low clicks/min, high dwell, hovers across multiple products.\n- \"neutral\": insufficient signal yet, or pattern is mixed. Baseline grid.\n  Default for first ~10 events.\n\nExamples:\nInput: {\"clicks_per_min\":14,\"avg_dwell_ms\":820,\"scroll_depth\":0.91,\"hover_count\":2,\"events_seen\":18}\nOutput: {\"variant\":\"decisive\",\"confidence\":0.86,\"reasoning\":\"Fast clicks, low dwell, deep scroll — purposeful navigation.\"}\n\nInput: {\"clicks_per_min\":3,\"avg_dwell_ms\":7400,\"scroll_depth\":0.42,\"hover_count\":4,\"events_seen\":22}\nOutput: {\"variant\":\"deliberate\",\"confidence\":0.81,\"reasoning\":\"Slow pace, long dwell, multi-product hover — comparing options.\"}\n\nInput: {\"clicks_per_min\":5,\"avg_dwell_ms\":2100,\"scroll_depth\":0.55,\"hover_count\":2,\"events_seen\":7}\nOutput: {\"variant\":\"neutral\",\"confidence\":0.6,\"reasoning\":\"Not enough events yet to commit to a mode.\"}\n\nReturn ONLY a JSON object. No prose, no markdown.\n`.trim();\n\nconst VALID_VARIANTS: ReadonlySet<Variant> = new Set([\"decisive\", \"deliberate\", \"neutral\"]);\n\nconst FALLBACK: AgentDirective = {\n  variant: \"neutral\",\n  confidence: 0,\n  reasoning: \"Classifier error.\",\n};\n\nexport type CreateGeminiClassifierOpts = {\n  apiKey: string;\n  model?: string;\n  endpoint?: string;\n  fetchImpl?: typeof fetch;\n};\n\nexport function createGeminiClassifier(opts: CreateGeminiClassifierOpts): ClassifyFn {\n  const { apiKey, model = \"gemini-2.0-flash\", endpoint, fetchImpl } = opts;\n  const url =\n    endpoint ??\n    `https://generativelanguage.googleapis.com/v1beta/models/${encodeURIComponent(model)}:generateContent`;\n  const fetcher = fetchImpl ?? (typeof fetch !== \"undefined\" ? fetch.bind(globalThis) : null);\n\n  return async (summary) => {\n    if (!fetcher) return FALLBACK;\n    try {\n      const res = await fetcher(`${url}?key=${encodeURIComponent(apiKey)}`, {\n        method: \"POST\",\n        headers: { \"content-type\": \"application/json\" },\n        body: JSON.stringify({\n          systemInstruction: { parts: [{ text: CLASSIFIER_SYSTEM_PROMPT }] },\n          contents: [\n            {\n              role: \"user\",\n              parts: [{ text: JSON.stringify(summary) }],\n            },\n          ],\n          generationConfig: {\n            responseMimeType: \"application/json\",\n            temperature: 0.2,\n          },\n        }),\n      });\n\n      if (!res.ok) return FALLBACK;\n      const data = (await res.json()) as {\n        candidates?: { content?: { parts?: { text?: string }[] } }[];\n      };\n      const text = data.candidates?.[0]?.content?.parts?.[0]?.text;\n      if (!text) return FALLBACK;\n\n      const parsed = JSON.parse(text) as Partial<AgentDirective>;\n      if (\n        !parsed ||\n        typeof parsed !== \"object\" ||\n        typeof parsed.variant !== \"string\" ||\n        !VALID_VARIANTS.has(parsed.variant as Variant) ||\n        typeof parsed.reasoning !== \"string\"\n      ) {\n        return FALLBACK;\n      }\n      const confidence =\n        typeof parsed.confidence === \"number\" && Number.isFinite(parsed.confidence)\n          ? Math.max(0, Math.min(1, parsed.confidence))\n          : 0.5;\n\n      return {\n        variant: parsed.variant as Variant,\n        confidence,\n        reasoning: parsed.reasoning,\n      };\n    } catch {\n      return FALLBACK;\n    }\n  };\n}\n","import type { ClassifyFn } from \"../types\";\n\nexport function createHeuristicClassifier(): ClassifyFn {\n  return async (summary) => {\n    if (summary.events_seen < 10) {\n      return {\n        variant: \"neutral\",\n        confidence: 0.5,\n        reasoning: \"Insufficient events.\",\n      };\n    }\n    if (summary.clicks_per_min > 8 && summary.avg_dwell_ms < 2000) {\n      return {\n        variant: \"decisive\",\n        confidence: 0.8,\n        reasoning: \"Fast pace, low dwell.\",\n      };\n    }\n    if (summary.avg_dwell_ms > 4000 && summary.hover_count > 2) {\n      return {\n        variant: \"deliberate\",\n        confidence: 0.8,\n        reasoning: \"Slow pace, multi-hover.\",\n      };\n    }\n    return {\n      variant: \"neutral\",\n      confidence: 0.6,\n      reasoning: \"Mixed signals.\",\n    };\n  };\n}\n"],"mappings":"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","names":["React","import_jsx_runtime","React"]}

package/dist/index.d.cts

@@ -0,0 +1,94 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React$1 from 'react';
+
+type BehaviorEvent = {
+    kind: "click";
+    target: string;
+    t: number;
+} | {
+    kind: "scroll";
+    depth: number;
+    t: number;
+} | {
+    kind: "hover";
+    target: string;
+    durationMs: number;
+    t: number;
+} | {
+    kind: "dwell";
+    target: string;
+    durationMs: number;
+    t: number;
+};
+type BehaviorSummary = {
+    clicks_per_min: number;
+    avg_dwell_ms: number;
+    scroll_depth: number;
+    hover_count: number;
+    events_seen: number;
+    page_context: {
+        route: string;
+        visible_product_ids: string[];
+    };
+};
+type Variant = "decisive" | "deliberate" | "neutral";
+type AgentDirective = {
+    variant: Variant;
+    confidence: number;
+    reasoning: string;
+};
+type ClassifyFn = (summary: BehaviorSummary) => Promise<AgentDirective>;
+
+type BeGenContextValue = {
+    variant: Variant;
+    directive: AgentDirective | null;
+    summary: BehaviorSummary | null;
+    setVariant: (v: Variant) => void;
+    setDirective: (d: AgentDirective) => void;
+    setSummary: (s: BehaviorSummary) => void;
+};
+declare function BeGenProvider({ children }: {
+    children: React$1.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+type BeGenSurfaceProps = {
+    variants: Record<Variant, React$1.ComponentType<any>>;
+    classify: ClassifyFn;
+    variantProps?: Record<string, any>;
+    pageContext: BehaviorSummary["page_context"];
+    seedPersona?: "decisive" | "deliberate";
+    rateLimitMs?: number;
+    className?: string;
+    style?: React$1.CSSProperties;
+    children?: never;
+};
+declare function BeGenSurface(props: BeGenSurfaceProps): react_jsx_runtime.JSX.Element;
+
+type UseBehaviorTrackerOpts = {
+    containerRef: React.RefObject<HTMLElement>;
+    flushEveryEvents?: number;
+    flushAfterMs?: number;
+    bufferSize?: number;
+    onFlush: (summary: BehaviorSummary) => void;
+    pageContext: BehaviorSummary["page_context"];
+    seedTrace?: BehaviorEvent[];
+};
+declare function useBehaviorTracker(opts: UseBehaviorTrackerOpts): {
+    recentEvents: BehaviorEvent[];
+};
+
+declare function useBeGenContext(): BeGenContextValue;
+
+type CreateGeminiClassifierOpts = {
+    apiKey: string;
+    model?: string;
+    endpoint?: string;
+    fetchImpl?: typeof fetch;
+};
+declare function createGeminiClassifier(opts: CreateGeminiClassifierOpts): ClassifyFn;
+
+declare function createHeuristicClassifier(): ClassifyFn;
+
+declare const PERSONAS: Record<"decisive" | "deliberate", BehaviorEvent[]>;
+
+export { type AgentDirective, type BeGenContextValue, BeGenProvider, BeGenSurface, type BeGenSurfaceProps, type BehaviorEvent, type BehaviorSummary, type ClassifyFn, type CreateGeminiClassifierOpts, PERSONAS, type UseBehaviorTrackerOpts, type Variant, createGeminiClassifier, createHeuristicClassifier, useBeGenContext, useBehaviorTracker };