@qoretechnologies/reqraft 0.10.56 → 0.10.57-pr.127.g0a792ea

package/.claude/CLAUDE.md

@@ -307,6 +307,7 @@ yarn build:test         # Type-check without emit
 | `src/components/form/` | Form field components |
 | `src/components/log/` | Log display component |
 | `src/components/menu/` | Navigation menu component |
+| `src/tracking/` | First-party tracking, consent and A/B testing (`core/` no DOM, `browser/`, `react/`, and `ui/`: the A/B test card and overlay on Reqore); how-to in `design/TRACKING.md` |
 | `src/types/` | Shared TypeScript types |
 | `__tests__/` | Vitest unit tests (jsdom) |
 

package/README.md

@@ -148,6 +148,26 @@ client.onNotification('qonsole/sessionStateChanged', (params) => { /* … */ });
 client.disconnect();
 ```
 
+## Tracking, consent and A/B testing
+
+First-party analytics with a consent gate and client-side A/B testing, for any Qore web app. The core is plain TypeScript with no DOM, the browser layer attaches the listeners, and the React bindings sit on top. Everything product-specific comes in through config; the server keeps each product's data separate by `property`.
+
+```tsx
+import { createBrowserTracker, Experiment, TrackingProvider } from '@qoretechnologies/reqraft/dist/tracking';
+
+const tracking = createBrowserTracker({
+  property: 'ide',
+  endpoint: '/qorus-cloud/collect',
+  experimentsEndpoint: '/qorus-cloud/experiments',
+});
+
+<TrackingProvider tracker={tracking.tracker} attach={tracking.attach} location={pathname + search}>
+  <Experiment id='signup-cta' variants={{ a: <Current />, b: <New /> }} />
+</TrackingProvider>;
+```
+
+`@qoretechnologies/reqraft/dist/tracking` loads nothing else from Reqraft; the same names are exported from the package root. The A/B test UI every product shows (`<ExperimentsOverlay>`, `<ExperimentCard>`, `useExperimentsAdmin`) is in `@qoretechnologies/reqraft/dist/tracking/ui`. Config, consent, `useExperiment`, `trackClick` / `trackSection` markup, `createMemoryTracker` for tests and the server contract: [design/TRACKING.md](design/TRACKING.md).
+
 Clients on the same LSP endpoint share ONE underlying WebSocket — each `ReqraftLspClient` is a per-document facade over the shared connection, multiplexed by document URI (the server keys language sessions per document), so N editors cost one socket. Auto-reconnect re-opens every document on the shared socket, 15s request timeout, request/response correlation by `id`, pending requests rejected on close. A `connect()` never outlives its socket: once the socket exhausts `maxReconnectTries`, a handshake still waiting rejects, and the next `connect()` — from that client or any other — dials again, so an editor opened after an outage connects once the server is back, without a page reload. Document URIs should be opaque and client-generated — per the Qonsole LSP contract they must not contain session tokens, usernames, sandbox identifiers, or other secrets that end up in server logs.
 
 ## Community

package/design/TRACKING.md

@@ -0,0 +1,290 @@
+# Tracking, consent and A/B testing
+
+First-party analytics, a consent gate and client-side A/B testing for any Qore web app (the
+landing site, the Qorus IDE, the admin portal). One module, one server: every product sends to
+the same collector and reads the same experiments, and **the server keeps each product's data
+separate by `property`**: events, goals, experiments and results never mix between properties.
+
+The contract (event shapes, the batch envelope, experiment definitions, goals, statistics,
+storage, the admin API) is owned by qorus-api:
+[`design/analytics-and-experiments-design.md`](https://git.qoretechnologies.com/qorus/qorus-api/-/blob/develop/design/analytics-and-experiments-design.md)
+(introduced in [qorus-api MR !34](https://git.qoretechnologies.com/qorus/qorus-api/-/merge_requests/34)).
+Change the contract there first, then the code here. Section numbers below (§3, §5 …) refer to it.
+
+## 1. What it does
+
+- **Anonymous, with consent.** Nothing is sent and no id exists until the user allows tracking.
+  Then a random visitor id (`vid`) lives in `localStorage["<prefix>vid"]`. Declining or
+  withdrawing deletes it and stops everything.
+- **Events** go in batches to the collector: page views, a page summary (time, engaged time,
+  scroll depth, per-section attention), clicks on tagged elements, a heartbeat, goals, custom
+  events and experiment exposures.
+- **Experiments** are fetched from the experiments endpoint (`?property=<property>` appended)
+  and every visitor is assigned locally with GrowthBook's hash v2 on the `vid`, the same way on
+  every visit and every page.
+- **Fails open.** No backend, no consent, blocked storage, an error anywhere: the app works as
+  without the module, every experiment shows its control, and nothing is thrown into the page.
+
+## 2. Install and import
+
+```bash
+yarn add @qoretechnologies/reqraft
+```
+
+Everything is exported from the package root, and from its own entry, which loads nothing else
+from Reqraft (no Reqore, react-query or editors; React is its only dependency). Prefer the entry
+in an app that does not already use Reqraft:
+
+```ts
+import { createBrowserTracker, TrackingProvider, Experiment } from '@qoretechnologies/reqraft/dist/tracking';
+// or
+import { createBrowserTracker, TrackingProvider, Experiment } from '@qoretechnologies/reqraft';
+```
+
+The module has three layers, and each only imports the ones above it:
+
+| Layer | Folder | What |
+|---|---|---|
+| core | `src/tracking/core/` | plain TypeScript, no DOM: `Tracker`, consent, the batching queue, section and engagement clocks, hashing, assignment, the experiments client |
+| browser | `src/tracking/browser/` | the only code that touches `window` / `document`: transport (`sendBeacon` → `fetch` keepalive), storage, listeners, `IntersectionObserver` on sections, delegated clicks |
+| react | `src/tracking/react/` | `<TrackingProvider>`, `useTracker`, `useConsent`, `useExperiment`, `<Experiment>` |
+
+Plus `markup.ts` (`trackClick`, `trackSection`) and `testing.ts` (`createMemoryTracker`). The A/B test UI (the card and the overlay, on Reqore) is a fourth layer, `src/tracking/ui/`, with its own entry (§8); the engine never imports it.
+
+## 3. Configure one tracker per app
+
+Create the tracker once, at module level, and mount the provider at the app shell:
+
+```tsx
+import { createBrowserTracker, TrackingProvider } from '@qoretechnologies/reqraft/dist/tracking';
+
+export const tracking = createBrowserTracker({
+  property: 'ide',                                  // required: which product the data belongs to
+  endpoint: '/qorus-cloud/collect',                 // required: the collector (POST)
+  experimentsEndpoint: '/qorus-cloud/experiments',  // required: running experiments (GET)
+  storagePrefix: 'qa.ide.',                         // when another product shares the origin
+  consentVersion: 1,
+  enabled: import.meta.env.PROD,
+  debug: false,
+});
+
+const App = () => {
+  const location = useLocation();
+  return (
+    <TrackingProvider tracker={tracking.tracker} attach={tracking.attach} location={location.pathname + location.search}>
+      <Routes>…</Routes>
+    </TrackingProvider>
+  );
+};
+```
+
+Each `location` change is a new page view. Without a provider (or with `tracker={null}`),
+everything still renders: consent reads `unknown` and experiments show their control.
+
+| Option | Default | Meaning |
+|---|---|---|
+| `property` | required | The product (`landing`, `ide`, `admin`, …). Sent with every batch and with the experiments request; the server keeps each property's data apart. |
+| `endpoint` | required | Collector URL. Same origin in the products so far. |
+| `experimentsEndpoint` | required | Running-experiments URL; `?property=` is appended. |
+| `enabled` | `true` | `false`: nothing is ever sent and every experiment shows its control. Turn it off where a page view is not a visit (a preview iframe, a test build). |
+| `consentVersion` | `1` | Bump when the consent text changes materially: stored answers to older versions count as no answer, so the prompt asks again. |
+| `storagePrefix` | `qa.` | Prefix of every storage key. **Two products on one origin need different prefixes**, or they share one consent answer, one visitor id and one experiments cache. |
+| `previewParam` | `qa_variant` | Query parameter of a shareable preview link. |
+| `debug` | `false` | Log every batch (and every swallowed error) to the console. |
+| `flushIntervalMs`, `maxQueued`, `heartbeatMs`, `sessionTimeoutMs`, `engagedWindowMs` | 5 s, 20, 15 s, 30 min, 10 s | Batching and timing. |
+
+`resolveConfig(options)` gives the full config; `DEFAULT_CONFIG` holds the defaults.
+
+## 4. Consent
+
+```tsx
+const { state, grant, deny, available } = useConsent(); // state: 'unknown' | 'granted' | 'denied'
+```
+
+- Stored in `localStorage["<prefix>consent"]` (`granted` | `denied`) and `<prefix>consent.v`
+  (the version answered).
+- Before `granted`: no id, no request to the collector, controls only, sign-up links
+  undecorated. The experiments list is still fetched: it is public and carries no visitor data.
+- `deny()` (declining or withdrawing) deletes `vid`, `exp`, `sid` and `utm` and drops unsent events.
+- The consent prompt is the app's own UI. `openConsentSettings()` / `closeConsentSettings()` /
+  `useConsentPanelOpen()` let a "Cookie settings" link reopen it.
+
+## 5. Experiments
+
+Wrap what is being tested:
+
+```tsx
+<Experiment id='signup-cta' trigger='pricing' variants={{ a: <Current />, b: <New /> }} />
+```
+
+or, for logic rather than markup:
+
+```tsx
+const { variant, assignment, triggerRef } = useExperiment('signup-cta', { variants: ['a', 'b'] });
+```
+
+- `a` is the control unless `control="…"` says otherwise; the control must be today's behaviour.
+- **The variant is decided once when the component mounts** and kept for the page view: no
+  flicker. A consent or definition that arrives later applies from the next page view.
+- **Exposure** is logged once per page view, only for enrolled visitors, when the trigger is
+  seen: the definition's `trigger.section`, else the `trigger` prop, else the element you put
+  `triggerRef` on, else at render.
+- Visitors without consent, outside `traffic`, or not targeted see the control and log nothing.
+  A concluded experiment shows its winner to everybody and logs nothing.
+- Order of `tracker.decide()`: a concluded winner, then the in-app switch or a preview link, then
+  consent, the definition and the assignment. `assignment.reason` says which one decided.
+- `<Experiment>` wraps its output in a `display: contents` element (no box, so the layout is
+  unchanged) with `data-experiment`, `data-variant`, `data-variants` and
+  `data-experiment-reason`, so an editor overlay can find every test on the page.
+- **Preview link:** `?qa_variant=signup-cta:b` (several: `?qa_variant=a-test:b,other:a`) shows a
+  version for QA, sticks for the browser session, works without consent and is never logged.
+  `?qa_variant=clear` removes it.
+- **In-app switch** (for an editor): `tracker.experiments.setEditorOverride(key, variant | null)`
+  shows one version in this browser, live and never logged; `tracker.experiments.refresh()`
+  reloads the definitions and makes mounted experiments decide again.
+
+Assignment (§5.2): `n = fnv1a32(String(fnv1a32(key + vid))) % 10000 / 10000`; variant *i* owns
+`[c_i, c_i + traffic × w_i)` where `c_i` is the sum of the weights before it. Raising `traffic`
+never moves an enrolled visitor. Fixed vectors: `__tests__/tracking/hash.test.ts`; if one of them
+changes, every visitor's assignment changes.
+
+The experiment itself (key, variants, weights, traffic, targeting, trigger, metrics) is created
+and started through the admin API (§9); until it runs, everybody sees the control.
+
+## 6. Events, goals and markup
+
+```ts
+const tracker = useTracker();                   // null outside the provider: always use ?.
+tracker?.goal('contact-submitted');             // a conversion the server's goals can match
+tracker?.goal('demo-booked', 1);                // with a value
+tracker?.custom('plan-picked', { plan: 'pro' }); // a named event with props
+```
+
+Never put free text a user typed, emails or names in props.
+
+**Sections** (visible time, "seen", exit section) and **clicks** are tagged in markup; one
+`IntersectionObserver` and one delegated click listener pick them up:
+
+```tsx
+<section data-track-section='pricing'>…</section>
+<ReqoreButton data-track-click='get-started' data-track-placement='hero'>Get started</ReqoreButton>
+// where JSX attributes cannot be written (object-literal props, e.g. panel actions):
+<ReqorePanel actions={[{ ...trackClick('contact', 'pricing-panel'), label: 'Talk to us' }]} />
+<div {...trackSection('pricing')}>…</div>
+```
+
+- `data-track-click` is what the click means (`get-started`, `contact`, …);
+  `data-track-placement` is where (defaults to the enclosing section's id);
+  `data-track-label` overrides the label (defaults to the element's text).
+- "Seen" is at least 50 % of the section, or 50 % of the screen covered by it, for at least one
+  second in one stretch, with the tab visible. Reports key on section ids: keep them stable.
+
+**Sign-up attribution** (§5.4): `tracker.decorateSignupUrl(url)` adds
+`qa_exp=<experiment>:<variant>,…` and the session's first-touch `utm_*` to a sign-up link (with
+consent only, never the `vid`); the server's sign-up flow reads them.
+
+## 7. Tests and stories
+
+`createMemoryTracker(options)` is a tracker with no browser behind it: memory storage, a clock
+and timers you drive, and a transport that records every batch.
+
+```ts
+import { createMemoryTracker } from '@qoretechnologies/reqraft/dist/tracking';
+
+const m = createMemoryTracker({ consent: 'granted', vid: 'visitor-1', experiments: [definition] });
+m.tracker.start();
+await m.advance(5000);                      // runs due timers: the queue flushes
+m.sent[0].batch.events;                     // what reached the collector
+m.local.get(m.keys.vid);                    // storage, under the configured prefix
+```
+
+Options: `config` (any config field; `property` defaults to `test`), `consent`, `experiments`
+(a list, a function read on every load, or `'fail'`), `page` (path, search, device, …), `vid`,
+`start` (the clock), `seed` (localStorage before the tracker starts). In a story, pass
+`m.tracker` to `<TrackingProvider>` without `attach`; seed the experiments cache
+(`KEYS.experimentsCache`) so the first render already has the definitions — see
+`src/tracking/ui/ExperimentsOverlay.stories.tsx`.
+
+Unit tests: `__tests__/tracking/` (hashing vectors, assignment, consent gating, batching,
+sections, page views, sign-up links, concluded winners, the in-app switch, product config,
+the React bindings, and the layer rules).
+
+## 8. The A/B test UI: embed the overlay
+
+The same A/B test controls every product shows, built on Reqore, in their own entry so the engine
+stays light:
+
+```ts
+import { ExperimentsOverlay, ExperimentCard, useExperimentsAdmin } from '@qoretechnologies/reqraft/dist/tracking/ui';
+```
+
+| Export | What |
+|---|---|
+| `<ExperimentsOverlay>` | Finds every `<Experiment>` on the page (its `data-experiment` marker) and draws a dashed outline and an "A/B test · <name>" handle at its corner. Hover, keyboard focus or a click opens the test's card, anchored to the element: it scrolls and resizes with it and flips above or below the handle to stay in view. ✕, Esc and a click outside close it. An ended test shows "Winner live · code clean-up pending" instead. |
+| `<ExperimentCard>` | One test: name, status tag, a "?" help and ✕; the verdict; one row per version, best first (conversion on the primary metric, then visitors; re-sorted only when new data arrives), the best one tagged "Leading", or "Winner" for a likely winner or an ended test's winner, the original tagged "Original". A row shows visitors, conversion, chance to beat the original and a bar; the shown version is the info-coloured row (`aria-current`); the whole row shows that version (Enter / Space too). Row actions: a chart icon for that version's analytics (`versionDetailsUrl`), minimal Accept, and a bin icon (Remove) at the far end. Footer: the optional "Open in …" link and Start / Resume (solid), Pause, Stop. Past three and a half rows the list scrolls inside the card. Every action asks first (Reqore's confirm dialog) and notifies what happened. |
+| `useExperimentsAdmin(options)` | Optional: the list and the actions from the qorus-api routes. |
+| `createExperimentsAdminClient(options)` | The same without React. |
+| `placeCard`, `cardReducer`, `versionRows`, `verdictLine`, `versionsMaxHeight`, … | The plain logic behind them, for tests and custom UIs. |
+
+Both components are driven by props only: the data is the qorus-api editor / admin list (an array of
+`{ experiment, results }`: the admin experiment object with `status`, `variants`, `phase`,
+`phases`, `history`, `winner`, and the results object with `verdict_text` and the per-metric
+numbers), and every action is a callback that may return a promise (the button shows busy until it
+settles, and a rejection's message is shown). An action whose callback is not given does not
+appear. Neither makes a request of its own.
+
+```tsx
+import { ExperimentsOverlay, useExperimentsAdmin } from '@qoretechnologies/reqraft/dist/tracking/ui';
+
+const AbTestsLayer = ({ visible }: { visible: boolean }) => {
+  const admin = useExperimentsAdmin({
+    listUrl: '/qorus-cloud/editor/experiments?property=ide', // actions go to …/experiments/<key>/<action>
+    headers: { Authorization: `Bearer ${editorToken}` },      // or leave it to a proxy
+    enabled: visible,
+  });
+  return (
+    <ExperimentsOverlay
+      visible={visible}                     // the product's "hide editor elements"
+      tests={admin.tests}
+      loadError={admin.error}
+      onAccept={admin.accept}
+      onRemove={admin.remove}
+      onStart={admin.start}
+      onPause={admin.pause}
+      onStop={admin.stop}
+      detailsUrl={(key) => `${ADMIN_PORTAL}/analytics?dashboard=tracking&experiment=${key}`}
+      actorLabels={{ 'ide-editor': 'in the IDE' }}
+      topInset={() => document.querySelector('header')?.getBoundingClientRect().bottom ?? 0}
+    />
+  );
+};
+```
+
+- Mount it inside `<TrackingProvider>`: then clicking a version's row uses the tracker's in-app
+  switch (`tracker.experiments.setEditorOverride`, this browser only, never logged), and after
+  an action the page shows what visitors see now (the switch is cleared and the tracker reloads
+  the definitions). Pass `onShow` / `onSettled` to do something else.
+- `versionDetailsUrl={(key, variant) => \`${ADMIN_PORTAL}/analytics?dashboard=tracking&experiment=${key}&variant=${variant}\`}`
+  adds the per-version "Show analytics" action (the admin portal opens the test with that version
+  expanded); without it the action is hidden. `detailsUrl` stays for the whole test.
+- The "?" opens a dialog explaining the test for a marketer: every button, how visitors are split
+  and counted, reading the verdict and the chance to beat, the too-early rule (the test's
+  `min_sample`, 200 visitors per version and 7 days by default), a test that is not set up, and
+  where the full analytics are (`analyticsLabel`).
+- A test that is in the page's code (`<Experiment>`) but not registered in the analytics service
+  yet shows "Not set up" and asks to have it set up (`notSetUpText` changes the words); when the list
+  cannot be loaded (`loadError`) it shows "No connection" instead.
+- `exclude` (a selector) skips markers inside the product's own UI (e.g. its preview frames);
+  markers inside the overlay itself are always skipped.
+- The same overlay works inside a phone-preview iframe: mount it in the frame's page too. The
+  switch is shared through `localStorage`, so both follow it.
+- `useExperimentsAdmin` reloads the list every minute (`refreshMs`) and after every action; its
+  errors explain a 401 / 403 as a missing or wrong key. `actionUrl` and `createUrl` change the
+  routes; `fetch` replaces the transport.
+- The card on its own: `<ExperimentCard experimentKey="signup-cta" test={entry} shown="a" codeVariants={['a', 'b']} onShow={…} onAccept={…} … />`.
+
+Stories: `Tracking/Experiment Card` (draft, running with two and five versions, paused, concluded,
+no data yet, not set up, no connection, the confirm step on Remove, the help) and
+`Tracking/Experiments Overlay` (anchored, flipped above near the bottom, hidden), each in dark,
+light and phone. The visually empty ones (hidden, the phone flip) run as tests without a Qlip
+snapshot (`parameters.qlip.skip`).

package/dist/index.d.ts

@@ -29,4 +29,6 @@ export * from './components/ticketThread';
 export * from './components/ticketReferences';
 export * from './components/searchFilterBar';
 export * from './components/codeSize';
+export * from './tracking';
+export * from './tracking/ui';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,eAAe,EACf,gCAAgC,GACjC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,cAAc,mCAAmC,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,sBAAsB,CAAC;AACrC,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,4BAA4B,EAC5B,eAAe,EACf,gCAAgC,GACjC,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,cAAc,4BAA4B,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,YAAY,EACV,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,YAAY,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACxE,cAAc,mCAAmC,CAAC;AAClD,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,gBAAgB,IAAI,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,YAAY,EACV,YAAY,EACZ,iBAAiB,GAClB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,WAAW,EACX,KAAK,EACL,QAAQ,EACR,cAAc,EACd,eAAe,EACf,UAAU,GACX,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,mBAAmB,EACnB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AACvB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,wBAAwB,EACxB,YAAY,EACZ,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC;AACxC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AAItC,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -61,4 +61,9 @@ __exportStar(require("./components/ticketThread"), exports);
 __exportStar(require("./components/ticketReferences"), exports);
 __exportStar(require("./components/searchFilterBar"), exports);
 __exportStar(require("./components/codeSize"), exports);
+// First-party tracking, consent and A/B testing (design/TRACKING.md). Also importable
+// on its own, without the rest of Reqraft: `@qoretechnologies/reqraft/dist/tracking`
+// (the engine, React only) and `@qoretechnologies/reqraft/dist/tracking/ui` (the A/B test UI).
+__exportStar(require("./tracking"), exports);
+__exportStar(require("./tracking/ui"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,uDAAqC;AACrC,qDAS+B;AAR7B,4GAAA,aAAa,OAAA;AACb,sHAAA,uBAAuB,OAAA;AACvB,yGAAA,UAAU,OAAA;AACV,+GAAA,gBAAgB,OAAA;AAChB,6GAAA,cAAc,OAAA;AACd,2HAAA,4BAA4B,OAAA;AAC5B,8GAAA,eAAe,OAAA;AACf,+HAAA,gCAAgC,OAAA;AAGlC,iDAAoD;AAA3C,0GAAA,aAAa,OAAA;AACtB,6DAA2C;AAC3C,+CAAqD;AAA5C,mGAAA,WAAW,OAAA;AAQpB,sDAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,4DAAkE;AAAzD,+GAAA,iBAAiB,OAAA;AAE1B,oEAAkD;AAClD,+DAIqC;AAHnC,oHAAA,iBAAiB,OAAA;AACjB,kHAAA,eAAe,OAAA;AACf,qHAAA,kBAAkB,OAAA;AAEpB,gEAA+F;AAAtF,sHAAA,gBAAgB,OAA2B;AAKpD,uCAOuB;AANrB,oGAAA,WAAW,OAAA;AACX,8FAAA,KAAK,OAAA;AACL,iGAAA,QAAQ,OAAA;AACR,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AAQZ,oDAAkC;AAClC,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA;AAiBzB,wDAAsC;AACtC,2DAAyC;AACzC,0DAAwC;AACxC,iEAA+C;AAC/C,6DAA2C;AAC3C,4DAA0C;AAC1C,gEAA8C;AAC9C,+DAA6C;AAC7C,wDAAsC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,uDAAqC;AACrC,qDAS+B;AAR7B,4GAAA,aAAa,OAAA;AACb,sHAAA,uBAAuB,OAAA;AACvB,yGAAA,UAAU,OAAA;AACV,+GAAA,gBAAgB,OAAA;AAChB,6GAAA,cAAc,OAAA;AACd,2HAAA,4BAA4B,OAAA;AAC5B,8GAAA,eAAe,OAAA;AACf,+HAAA,gCAAgC,OAAA;AAGlC,iDAAoD;AAA3C,0GAAA,aAAa,OAAA;AACtB,6DAA2C;AAC3C,+CAAqD;AAA5C,mGAAA,WAAW,OAAA;AAQpB,sDAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,4DAAkE;AAAzD,+GAAA,iBAAiB,OAAA;AAE1B,oEAAkD;AAClD,+DAIqC;AAHnC,oHAAA,iBAAiB,OAAA;AACjB,kHAAA,eAAe,OAAA;AACf,qHAAA,kBAAkB,OAAA;AAEpB,gEAA+F;AAAtF,sHAAA,gBAAgB,OAA2B;AAKpD,uCAOuB;AANrB,oGAAA,WAAW,OAAA;AACX,8FAAA,KAAK,OAAA;AACL,iGAAA,QAAQ,OAAA;AACR,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,mGAAA,UAAU,OAAA;AAQZ,oDAAkC;AAClC,+CAAqD;AAA5C,6GAAA,gBAAgB,OAAA;AAiBzB,wDAAsC;AACtC,2DAAyC;AACzC,0DAAwC;AACxC,iEAA+C;AAC/C,6DAA2C;AAC3C,4DAA0C;AAC1C,gEAA8C;AAC9C,+DAA6C;AAC7C,wDAAsC;AACtC,sFAAsF;AACtF,qFAAqF;AACrF,+FAA+F;AAC/F,6CAA2B;AAC3B,gDAA8B"}

package/dist/tracking/browser/attach.d.ts

@@ -0,0 +1,8 @@
+import type { Tracker } from '../core/tracker';
+export interface IAttached {
+    detach: () => void;
+    /** Observes an element under a synthetic id (an experiment's wrapped element); not in the page summary. */
+    observeElement: (el: Element, id: string) => () => void;
+}
+export declare const attachToPage: (tracker: Tracker, heartbeatMs: number) => IAttached;
+//# sourceMappingURL=attach.d.ts.map

package/dist/tracking/browser/attach.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.d.ts","sourceRoot":"","sources":["../../../src/tracking/browser/attach.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAoB/C,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,2GAA2G;IAC3G,cAAc,EAAE,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,KAAK,MAAM,IAAI,CAAC;CACzD;AAOD,eAAO,MAAM,YAAY,YAAa,OAAO,eAAe,MAAM,KAAG,SAyJpE,CAAC"}

package/dist/tracking/browser/attach.js

@@ -0,0 +1,182 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachToPage = void 0;
+var sections_1 = require("../core/sections");
+/**
+ * Connects a `Tracker` to the page: tab visibility, page leave, interactions,
+ * scroll depth, the heartbeat, section visibility (IntersectionObserver on every
+ * `[data-track-section]`) and clicks (one delegated listener for
+ * `[data-track-click]`). Returns a function that removes all of it.
+ *
+ * Markup contract (see design/TRACKING.md):
+ *   data-track-section="<id>"        a section: visible time, seen, exit section
+ *   data-track-click="<target>"      a tracked click (`get-started`, `contact`, …)
+ *   data-track-placement="<where>"   optional; defaults to the enclosing section id
+ *   data-track-label="<text>"        optional; defaults to the element's text
+ */
+var SECTION_SELECTOR = '[data-track-section]';
+var THRESHOLDS = Array.from({ length: 21 }, function (_, i) { return i / 20; });
+var TICK_MS = 250;
+var ACTIVITY_EVENTS = ['pointerdown', 'keydown', 'wheel', 'touchstart', 'mousemove', 'scroll'];
+var clean = function (s, max) {
+    if (max === void 0) { max = 80; }
+    var t = (s !== null && s !== void 0 ? s : '').replace(/\s+/g, ' ').trim();
+    return t ? t.slice(0, max) : null;
+};
+var attachToPage = function (tracker, heartbeatMs) {
+    var cleanup = [];
+    var on = function (target, type, fn, opts) {
+        target.addEventListener(type, fn, opts);
+        cleanup.push(function () { return target.removeEventListener(type, fn, opts); });
+    };
+    var safe = function (fn) { return function () {
+        try {
+            fn();
+        }
+        catch (_a) {
+            /* never into the page */
+        }
+    }; };
+    // ── tab visibility and page leave
+    on(document, 'visibilitychange', safe(function () { return tracker.setTabVisible(document.visibilityState === 'visible'); }));
+    on(window, 'pagehide', safe(function () { return tracker.leave(); }));
+    if (document.visibilityState !== 'visible')
+        tracker.setTabVisible(false);
+    // ── engagement (throttled to one signal per second)
+    var lastActivity = 0;
+    var activity = safe(function () {
+        var now = Date.now();
+        if (now - lastActivity < 1000)
+            return;
+        lastActivity = now;
+        tracker.activity();
+    });
+    ACTIVITY_EVENTS.forEach(function (t) { return on(window, t, activity, { passive: true, capture: true }); });
+    // ── scroll depth (once per frame)
+    var scrollQueued = false;
+    var measureScroll = safe(function () {
+        var _a, _b;
+        scrollQueued = false;
+        var doc = document.documentElement;
+        var scrollable = Math.max(doc.scrollHeight, (_b = (_a = document.body) === null || _a === void 0 ? void 0 : _a.scrollHeight) !== null && _b !== void 0 ? _b : 0);
+        var seen = window.scrollY + window.innerHeight;
+        tracker.scrolled(scrollable > 0 ? (seen / scrollable) * 100 : 100);
+    });
+    on(window, 'scroll', function () {
+        if (scrollQueued)
+            return;
+        scrollQueued = true;
+        requestAnimationFrame(measureScroll);
+    }, { passive: true });
+    // ── heartbeat while visible, and the section clock
+    var heartbeat = setInterval(safe(function () { return document.visibilityState === 'visible' && tracker.heartbeat(); }), heartbeatMs);
+    var tick = setInterval(safe(function () { return tracker.sections.tick(tracker.now()); }), TICK_MS);
+    cleanup.push(function () { return clearInterval(heartbeat); }, function () { return clearInterval(tick); });
+    // ── sections
+    var ratios = new Map();
+    var ids = new Map();
+    var report = new Map();
+    var apply = function (id) {
+        var best = 0;
+        ids.forEach(function (other, el) { var _a; return other === id && (best = Math.max(best, (_a = ratios.get(el)) !== null && _a !== void 0 ? _a : 0)); });
+        tracker.sections.update(id, best, tracker.now());
+    };
+    var io = typeof IntersectionObserver !== 'undefined'
+        ? new IntersectionObserver(function (entries) {
+            return safe(function () {
+                var vh = window.innerHeight || document.documentElement.clientHeight;
+                entries.forEach(function (e) {
+                    var _a, _b;
+                    var id = ids.get(e.target);
+                    if (!id)
+                        return;
+                    ratios.set(e.target, (0, sections_1.effectiveRatio)(e.intersectionRatio, e.intersectionRect.height, (_b = (_a = e.rootBounds) === null || _a === void 0 ? void 0 : _a.height) !== null && _b !== void 0 ? _b : vh));
+                    apply(id);
+                });
+            })();
+        }, { threshold: THRESHOLDS })
+        : null;
+    var track = function (el, id, inSummary) {
+        var _a;
+        if (ids.get(el) === id)
+            return;
+        ids.set(el, id);
+        report.set(id, ((_a = report.get(id)) !== null && _a !== void 0 ? _a : false) || inSummary);
+        tracker.sections.register(id, inSummary);
+        io === null || io === void 0 ? void 0 : io.observe(el);
+    };
+    var untrack = function (el) {
+        var id = ids.get(el);
+        if (!id)
+            return;
+        io === null || io === void 0 ? void 0 : io.unobserve(el);
+        ids.delete(el);
+        ratios.delete(el);
+        apply(id);
+    };
+    var scan = safe(function () {
+        var present = new Set(Array.from(document.querySelectorAll(SECTION_SELECTOR)));
+        ids.forEach(function (id, el) { return report.get(id) && !present.has(el) && !el.isConnected && untrack(el); });
+        present.forEach(function (el) {
+            var id = el.dataset.trackSection;
+            if (id)
+                track(el, id, true);
+        });
+    });
+    // Re-measure everything at a new page view: the section clock starts from zero,
+    // and re-observing makes the observer report every element's current state.
+    var remeasure = safe(function () {
+        scan();
+        ids.forEach(function (_id, el) {
+            io === null || io === void 0 ? void 0 : io.unobserve(el);
+            io === null || io === void 0 ? void 0 : io.observe(el);
+        });
+    });
+    cleanup.push(tracker.pageViewId.subscribe(remeasure));
+    var scanTimer = null;
+    var mo = typeof MutationObserver !== 'undefined'
+        ? new MutationObserver(function () {
+            if (scanTimer)
+                return;
+            scanTimer = setTimeout(function () {
+                scanTimer = null;
+                scan();
+            }, 150);
+        })
+        : null;
+    mo === null || mo === void 0 ? void 0 : mo.observe(document.body, { childList: true, subtree: true });
+    scan();
+    cleanup.push(function () {
+        mo === null || mo === void 0 ? void 0 : mo.disconnect();
+        io === null || io === void 0 ? void 0 : io.disconnect();
+        if (scanTimer)
+            clearTimeout(scanTimer);
+    });
+    // ── clicks: one delegated listener
+    var onClick = function (e) {
+        return safe(function () {
+            var _a, _b, _c, _d, _e;
+            var el = (_b = (_a = e.target) === null || _a === void 0 ? void 0 : _a.closest) === null || _b === void 0 ? void 0 : _b.call(_a, '[data-track-click]');
+            if (!el)
+                return;
+            var d = el.dataset;
+            var link = el.closest('a');
+            tracker.click({
+                target: d.trackClick || 'unknown',
+                placement: d.trackPlacement || ((_c = el.closest(SECTION_SELECTOR)) === null || _c === void 0 ? void 0 : _c.dataset.trackSection) || null,
+                label: (_e = (_d = clean(d.trackLabel)) !== null && _d !== void 0 ? _d : clean(el.innerText)) !== null && _e !== void 0 ? _e : clean(el.getAttribute('aria-label')),
+                href: d.trackHref || (link === null || link === void 0 ? void 0 : link.href) || null,
+            });
+        })();
+    };
+    on(document, 'click', onClick, { capture: true });
+    return {
+        detach: function () { return cleanup.forEach(function (fn) { return fn(); }); },
+        observeElement: function (el, id) {
+            track(el, id, false);
+            return function () { return untrack(el); };
+        },
+    };
+};
+exports.attachToPage = attachToPage;
+//# sourceMappingURL=attach.js.map

package/dist/tracking/browser/attach.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attach.js","sourceRoot":"","sources":["../../../src/tracking/browser/attach.ts"],"names":[],"mappings":"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"}

package/dist/tracking/browser/env.d.ts

@@ -0,0 +1,14 @@
+import type { ITransport } from '../core/queue';
+import type { IPageInfo, ITrackerEnv } from '../core/tracker';
+/**
+ * Sends a batch. `beacon` (page going away): `navigator.sendBeacon`, falling back
+ * to `fetch(…, { keepalive: true })` when the beacon is refused (too big, or the
+ * browser has none). Any HTTP answer counts as delivered — the collector always
+ * answers 204, and a 404 (collector not installed) must not turn into a retry loop;
+ * only a network error keeps the batch for the next flush.
+ */
+export declare const browserTransport: (endpoint: string) => ITransport;
+/** desktop / tablet / mobile from the user agent (targeting only; the server classifies for reports). */
+export declare const deviceOf: (ua: string) => IPageInfo['device'];
+export declare const browserEnv: (endpoint: string) => ITrackerEnv;
+//# sourceMappingURL=env.d.ts.map

package/dist/tracking/browser/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/tracking/browser/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,aAAc,MAAM,KAAG,UAuBlD,CAAC;AAcH,yGAAyG;AACzG,eAAO,MAAM,QAAQ,OAAQ,MAAM,KAAG,SAAS,CAAC,QAAQ,CAIvD,CAAC;AAaF,eAAO,MAAM,UAAU,aAAc,MAAM,KAAG,WAW5C,CAAC"}