@se-studio/core-ui 1.35.9 → 1.35.11

package/ANALYTICS.md

@@ -81,7 +81,7 @@ Target names (same property names where the site already uses them):
 |-------|------|
 | `page_view` | Full and soft navigations |
 | `click` | Tracked UI clicks (`trackClick`) |
-| `form_view` | Form component mount (not viewport impression; see below) |
+| `form_view` | Form first enters the viewport (IntersectionObserver, threshold 0.5; once per form instance) |
 | `form_start` | First interaction with a form field |
 | `form_submit` | Successful submit (HubSpot/API accept) |
 | `form_error` | Submit failed (validation or HubSpot/API error shown to the user) |
@@ -91,9 +91,9 @@ Sites may add extra events. Do not rename or drop an existing site event only to
 
 ### Form analytics (non-PII)
 
-`useFormAnalytics` / `createFormAnalyticsSession` emit the four events through `useAnalytics().trackEvent`. Import them from `@se-studio/core-ui/form-analytics` (not the root `@se-studio/core-ui` barrel). `@se-studio/hubspot` `useHubspotSubmit` and `HubspotDynamicForm` emit only when you pass `formAnalytics={true}` (off by default so upgrades are a no-op).
+`useFormAnalytics` / `createFormAnalyticsSession` emit the four events through `useAnalytics().trackEvent`. Import them from `@se-studio/core-ui/form-analytics` (not the root `@se-studio/core-ui` barrel). `@se-studio/hubspot` `useHubspotSubmit` and `HubspotDynamicForm` emit only when you pass `formAnalytics={true}` (off by default so upgrades are a no-op). Attach the returned `rootRef` to the form root (HubSpot wrappers already do this).
 
-`form_view` fires **on mount**, not when the form enters the viewport. A form below the fold still counts as a view, so view-to-submit will sit close to page-view rates. That is v1; do not treat it as an impression rate. A visibility option can come later.
+`form_view` fires **once per form instance** when the form first enters the viewport (`IntersectionObserver`, default threshold **0.5** — half of the form visible). Scroll bounce does not re-fire (`markView` is idempotent; the observer disconnects after the first intersection). Optional hook overrides: `viewTrigger: 'viewport' | 'mount'` (default `'viewport'`) and `viewThreshold?: number` (default `0.5`). Use `'mount'` only for rare above-the-fold callers that need the old behaviour. If `IntersectionObserver` is missing, `form_view` falls back to mount so views are not silently dropped. `form_start` / `form_submit` / `form_error` are unchanged.
 
 Allowed parameters only:
 

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @se-studio/core-ui
 
+## 1.35.11
+
+### Patch Changes
+
+- Updated dependencies
+  - @se-studio/contentful-rest-api@2.0.2
+
+## 1.35.10
+
+### Patch Changes
+
+- Gate `form_view` on viewport intersection (default threshold 0.5) instead of mount. Opt-in `formAnalytics` sites get a correct impression metric; `form_start` / `form_submit` / `form_error` are unchanged. HubSpot wrappers attach the analytics `rootRef` to the form. Use `viewTrigger: 'mount'` to restore the previous behaviour.
+
 ## 1.35.9
 
 ### Patch Changes

package/dist/analytics/form/index.d.ts

@@ -1,5 +1,5 @@
 export { type CreateFormAnalyticsSessionOptions, createFormAnalyticsSession, type FormAnalyticsSession, type FormAnalyticsSessionState, } from './createFormAnalyticsSession';
 export { FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, type FormAnalyticsAllowedKey, type FormAnalyticsErrorInfo, type FormAnalyticsEventName, type FormAnalyticsIdentity, type FormAnalyticsProperties, type FormAnalyticsTrackFn, type FormErrorCategory, } from './formAnalyticsTypes';
 export { sanitizeFormAnalyticsProperties } from './sanitizeFormAnalyticsProperties';
-export { type UseFormAnalyticsOptions, useFormAnalytics } from './useFormAnalytics';
+export { FORM_VIEW_DEFAULT_THRESHOLD, type FormViewTrigger, type UseFormAnalyticsOptions, type UseFormAnalyticsResult, useFormAnalytics, } from './useFormAnalytics';
 //# sourceMappingURL=index.d.ts.map

package/dist/analytics/form/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAE,KAAK,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,GAC/B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EACL,2BAA2B,EAC3B,KAAK,eAAe,EACpB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/analytics/form/index.js

@@ -1,5 +1,5 @@
 export { createFormAnalyticsSession, } from './createFormAnalyticsSession';
 export { FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, } from './formAnalyticsTypes';
 export { sanitizeFormAnalyticsProperties } from './sanitizeFormAnalyticsProperties';
-export { useFormAnalytics } from './useFormAnalytics';
+export { FORM_VIEW_DEFAULT_THRESHOLD, useFormAnalytics, } from './useFormAnalytics';
 //# sourceMappingURL=index.js.map

package/dist/analytics/form/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0BAA0B,GAG3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GAQtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EAAgC,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analytics/form/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,0BAA0B,GAG3B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,GAQtB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,+BAA+B,EAAE,MAAM,mCAAmC,CAAC;AACpF,OAAO,EACL,2BAA2B,EAI3B,gBAAgB,GACjB,MAAM,oBAAoB,CAAC"}

package/dist/analytics/form/useFormAnalytics.d.ts

@@ -1,13 +1,36 @@
+import { type RefObject } from 'react';
 import { type FormAnalyticsSession } from './createFormAnalyticsSession';
 import type { FormAnalyticsIdentity } from './formAnalyticsTypes';
+/** IntersectionObserver threshold for default `form_view` (50% of the form visible). */
+export declare const FORM_VIEW_DEFAULT_THRESHOLD = 0.5;
+export type FormViewTrigger = 'viewport' | 'mount';
 export interface UseFormAnalyticsOptions {
     identity: FormAnalyticsIdentity;
     /** When false, no events are emitted. Default true. */
     enabled?: boolean;
+    /**
+     * When to fire `form_view`. Default `viewport` (first intersection).
+     * `mount` restores v1 behaviour for rare above-the-fold-only callers.
+     */
+    viewTrigger?: FormViewTrigger;
+    /**
+     * IntersectionObserver threshold when `viewTrigger` is `viewport`.
+     * Default {@link FORM_VIEW_DEFAULT_THRESHOLD} (0.5).
+     */
+    viewThreshold?: number;
+    /**
+     * Form root to observe. When omitted, the hook creates a ref — attach it to the
+     * form (or wrapper) element so viewport `form_view` has a target.
+     */
+    rootRef?: RefObject<HTMLElement | null>;
+}
+export interface UseFormAnalyticsResult extends FormAnalyticsSession {
+    rootRef: RefObject<HTMLElement | null>;
 }
 /**
  * Binds a form analytics session to `useAnalytics().trackEvent`.
- * Fires `form_view` once on mount when enabled (not on viewport impression).
+ * Fires `form_view` once when the form first enters the viewport (default),
+ * or on mount when `viewTrigger` is `'mount'`. `markView` stays idempotent.
  */
-export declare function useFormAnalytics({ identity, enabled, }: UseFormAnalyticsOptions): FormAnalyticsSession;
+export declare function useFormAnalytics({ identity, enabled, viewTrigger, viewThreshold, rootRef: rootRefOption, }: UseFormAnalyticsOptions): UseFormAnalyticsResult;
 //# sourceMappingURL=useFormAnalytics.d.ts.map

package/dist/analytics/form/useFormAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useFormAnalytics.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/useFormAnalytics.ts"],"names":[],"mappings":"AAIA,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAc,GACf,EAAE,uBAAuB,GAAG,oBAAoB,CAsEhD"}
+{"version":3,"file":"useFormAnalytics.d.ts","sourceRoot":"","sources":["../../../src/analytics/form/useFormAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAkC,MAAM,OAAO,CAAC;AAEvE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAA0B,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE1F,wFAAwF;AACxF,eAAO,MAAM,2BAA2B,MAAM,CAAC;AAE/C,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,CAAC;AAEnD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,qBAAqB,CAAC;IAChC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,sBAAuB,SAAQ,oBAAoB;IAClE,OAAO,EAAE,SAAS,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACxC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAC/B,QAAQ,EACR,OAAc,EACd,WAAwB,EACxB,aAA2C,EAC3C,OAAO,EAAE,aAAa,GACvB,EAAE,uBAAuB,GAAG,sBAAsB,CAmHlD"}

package/dist/analytics/form/useFormAnalytics.js

@@ -2,15 +2,20 @@
 import { useCallback, useEffect, useRef } from 'react';
 import { useAnalytics } from '../useAnalytics';
 import { createFormAnalyticsSession, } from './createFormAnalyticsSession';
+/** IntersectionObserver threshold for default `form_view` (50% of the form visible). */
+export const FORM_VIEW_DEFAULT_THRESHOLD = 0.5;
 /**
  * Binds a form analytics session to `useAnalytics().trackEvent`.
- * Fires `form_view` once on mount when enabled (not on viewport impression).
+ * Fires `form_view` once when the form first enters the viewport (default),
+ * or on mount when `viewTrigger` is `'mount'`. `markView` stays idempotent.
  */
-export function useFormAnalytics({ identity, enabled = true, }) {
+export function useFormAnalytics({ identity, enabled = true, viewTrigger = 'viewport', viewThreshold = FORM_VIEW_DEFAULT_THRESHOLD, rootRef: rootRefOption, }) {
     const { trackEvent } = useAnalytics();
     const trackEventRef = useRef(trackEvent);
     trackEventRef.current = trackEvent;
     const sessionRef = useRef(null);
+    const internalRootRef = useRef(null);
+    const rootRef = rootRefOption ?? internalRootRef;
     const formId = identity.form_id ?? '';
     const formName = identity.form_name ?? '';
     const formType = identity.form_type ?? '';
@@ -34,13 +39,48 @@ export function useFormAnalytics({ identity, enabled = true, }) {
             },
         });
         sessionRef.current = session;
-        session.markView();
+        const fireView = () => {
+            sessionRef.current?.markView();
+        };
+        if (viewTrigger === 'mount') {
+            fireView();
+            return () => {
+                if (sessionRef.current === session) {
+                    sessionRef.current = null;
+                }
+            };
+        }
+        if (typeof IntersectionObserver === 'undefined') {
+            fireView();
+            return () => {
+                if (sessionRef.current === session) {
+                    sessionRef.current = null;
+                }
+            };
+        }
+        const el = rootRef.current;
+        if (!el) {
+            return () => {
+                if (sessionRef.current === session) {
+                    sessionRef.current = null;
+                }
+            };
+        }
+        const observer = new IntersectionObserver((entries) => {
+            const entry = entries[0];
+            if (entry?.isIntersecting) {
+                fireView();
+                observer.disconnect();
+            }
+        }, { threshold: viewThreshold });
+        observer.observe(el);
         return () => {
+            observer.disconnect();
             if (sessionRef.current === session) {
                 sessionRef.current = null;
             }
         };
-    }, [enabled, formId, formName, formType, cmsEntryId, step]);
+    }, [enabled, formId, formName, formType, cmsEntryId, step, viewTrigger, viewThreshold, rootRef]);
     const markView = useCallback(() => {
         sessionRef.current?.markView();
     }, []);
@@ -62,6 +102,6 @@ export function useFormAnalytics({ identity, enabled = true, }) {
             validationErrorThisAttempt: false,
         });
     }, []);
-    return { markView, markStart, markSubmit, markError, getState };
+    return { markView, markStart, markSubmit, markError, getState, rootRef };
 }
 //# sourceMappingURL=useFormAnalytics.js.map

package/dist/analytics/form/useFormAnalytics.js.map

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

package/dist/analytics/formAnalyticsEntry.d.ts

@@ -4,7 +4,7 @@
  * main `core-ui` barrel (Visual / Lottie) is not pulled into the form graph.
  */
 export { AnalyticsProvider, useAnalyticsContext } from './AnalyticsProvider';
-export { type CreateFormAnalyticsSessionOptions, createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, type FormAnalyticsAllowedKey, type FormAnalyticsErrorInfo, type FormAnalyticsEventName, type FormAnalyticsIdentity, type FormAnalyticsProperties, type FormAnalyticsSession, type FormAnalyticsSessionState, type FormAnalyticsTrackFn, type FormErrorCategory, sanitizeFormAnalyticsProperties, type UseFormAnalyticsOptions, useFormAnalytics, } from './form';
+export { type CreateFormAnalyticsSessionOptions, createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, FORM_VIEW_DEFAULT_THRESHOLD, type FormAnalyticsAllowedKey, type FormAnalyticsErrorInfo, type FormAnalyticsEventName, type FormAnalyticsIdentity, type FormAnalyticsProperties, type FormAnalyticsSession, type FormAnalyticsSessionState, type FormAnalyticsTrackFn, type FormErrorCategory, type FormViewTrigger, sanitizeFormAnalyticsProperties, type UseFormAnalyticsOptions, type UseFormAnalyticsResult, useFormAnalytics, } from './form';
 export type { AnalyticsAdapter, ClickTrackingProperties, PageTrackingProperties } from './types';
 export { useAnalytics } from './useAnalytics';
 //# sourceMappingURL=formAnalyticsEntry.d.ts.map

package/dist/analytics/formAnalyticsEntry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"formAnalyticsEntry.d.ts","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"formAnalyticsEntry.d.ts","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EACL,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,yBAAyB,EAC9B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,+BAA+B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAChB,YAAY,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AACjG,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/analytics/formAnalyticsEntry.js

@@ -4,6 +4,6 @@
  * main `core-ui` barrel (Visual / Lottie) is not pulled into the form graph.
  */
 export { AnalyticsProvider, useAnalyticsContext } from './AnalyticsProvider';
-export { createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, sanitizeFormAnalyticsProperties, useFormAnalytics, } from './form';
+export { createFormAnalyticsSession, FORM_ANALYTICS_ALLOWED_KEYS, FORM_ANALYTICS_EVENT_NAMES, FORM_ANALYTICS_EVENTS, FORM_ERROR_CATEGORIES, FORM_VIEW_DEFAULT_THRESHOLD, sanitizeFormAnalyticsProperties, useFormAnalytics, } from './form';
 export { useAnalytics } from './useAnalytics';
 //# sourceMappingURL=formAnalyticsEntry.js.map

package/dist/analytics/formAnalyticsEntry.js.map

@@ -1 +1 @@
-{"version":3,"file":"formAnalyticsEntry.js","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAEL,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EAUrB,+BAA+B,EAE/B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"formAnalyticsEntry.js","sourceRoot":"","sources":["../../src/analytics/formAnalyticsEntry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC7E,OAAO,EAEL,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,qBAAqB,EACrB,qBAAqB,EACrB,2BAA2B,EAW3B,+BAA+B,EAG/B,gBAAgB,GACjB,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/docs/llms.md

@@ -187,7 +187,7 @@ Export `VIDEO_ENGAGEMENT_EVENTS` / `VIDEO_ENGAGEMENT_EVENT_NAMES` for GTM or Hub
 
 ### Form analytics events
 
-`form_view` (once on **mount**, not viewport impression) · `form_start` (first interaction) · `form_submit` (success) · `form_error` (validation or API failure).
+`form_view` (once when the form first enters the viewport, IntersectionObserver threshold 0.5; `viewTrigger: 'mount'` for the old immediate behaviour) · `form_start` (first interaction) · `form_submit` (success) · `form_error` (validation or API failure). Attach `rootRef` to the form root.
 
 Export `FORM_ANALYTICS_EVENTS` / `useFormAnalytics` / `sanitizeFormAnalyticsProperties` from `@se-studio/core-ui/form-analytics` only (not the root barrel). Payload keys: `form_id`, `form_name`, `form_type`, `cms_entry_id`, `step`, `error_code`, `error_category`. Never field values or raw error text. HubSpot forms emit these from `useHubspotSubmit` only when `formAnalytics={true}` (default off).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/core-ui",
-  "version": "1.35.9",
+  "version": "1.35.11",
   "description": "Shared React UI component library with Tailwind CSS v4 for SE Studio applications",
   "repository": {
     "type": "git",
@@ -80,7 +80,7 @@
     "@contentful/rich-text-react-renderer": "^16.2.2",
     "@contentful/rich-text-types": "^17.2.7",
     "@radix-ui/react-slot": "1.3.3",
-    "@se-studio/contentful-rest-api": "2.0.1",
+    "@se-studio/contentful-rest-api": "2.0.2",
     "@se-studio/core-data-types": "2.0.1",
     "@types/mustache": "4.2.6",
     "@vimeo/player": "^2.30.4",