@scalebun/web 1.0.0

package/dist/features/webVitals/WebVitalsFeature.d.ts

@@ -0,0 +1,46 @@
+/**
+ * F-VIT — Core Web Vitals (LCP/INP/CLS) + FCP/TTFB via raw PerformanceObserver (no dependency, to
+ * keep the core tiny). **Per-route (A4):** LCP/INP/CLS finalize + reset at each route boundary (SPA
+ * soft navigation, via the Navigation API or a popstate/history fallback) AND on `visibilitychange →
+ * hidden`, so every route reports its own vitals + attribution. FCP/TTFB are final early (initial route).
+ *
+ * Ordering note: bootstrap runs setupAll() BEFORE pipeline.start(), so this feature's
+ * visibilitychange listener is registered before the pipeline's flush listener → we emit the CWV
+ * items, then the pipeline flushes them (keepalive). Do not reorder bootstrap without preserving this.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class WebVitalsFeature implements IFeature {
+    readonly name = "webVitals";
+    private ctx;
+    private active;
+    private disconnects;
+    private lcp;
+    private clsState;
+    private inp;
+    private hideHandler?;
+    private lcpAttr?;
+    private clsAcc;
+    private inpAcc;
+    private route;
+    private routeStop?;
+    private loaf;
+    private inpWindow?;
+    private static readonly LOAF_CAP;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private emitTtfb;
+    /** Emit the accumulating route's LCP/CLS/INP (with attribution), then reset for the next route.
+     *  Called at each route boundary and on hide; after reset the value guards make a repeat call a no-op. */
+    private finalizeRoute;
+    /** A route boundary (SPA soft navigation): finalize the route we're leaving, switch to the new one. */
+    private onRouteChange;
+    /** Detect SPA route changes. Prefers the Navigation API (Chromium — fires for push/replace/popstate,
+     *  no patching); falls back to popstate + a guarded history patch elsewhere. */
+    private installRouteDetection;
+    private emit;
+    teardown(): void;
+}
+/** Collapse high-cardinality path segments (numeric / uuid / long-hash ids) → `:id` so routes group +
+ *  the dashboard route dropdown stays usable. e.g. `/orders/4821/items/abc123def0` → `/orders/:id/items/:id`. */
+export declare function normalizeRoute(path: string): string;
+//# sourceMappingURL=WebVitalsFeature.d.ts.map

package/dist/features/webVitals/WebVitalsFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebVitalsFeature.d.ts","sourceRoot":"","sources":["../../../src/features/webVitals/WebVitalsFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAexE,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,QAAQ,CAAC,IAAI,eAAe;IAC5B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,GAAG,CAAK;IAChB,OAAO,CAAC,WAAW,CAAC,CAAa;IAEjC,OAAO,CAAC,OAAO,CAAC,CAAkB;IAClC,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,KAAK,CAAO;IACpB,OAAO,CAAC,SAAS,CAAC,CAAa;IAG/B,OAAO,CAAC,IAAI,CAA2F;IACvG,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAM;IAEtC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAuFhC,OAAO,CAAC,QAAQ;IAahB;8GAC0G;IAC1G,OAAO,CAAC,aAAa;IA2BrB,uGAAuG;IACvG,OAAO,CAAC,aAAa;IAOrB;oFACgF;IAChF,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,IAAI;IA2BZ,QAAQ,IAAI,IAAI;CAUjB;AAUD;iHACiH;AACjH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMnD"}

package/dist/features/webVitals/WebVitalsFeature.js

@@ -0,0 +1,252 @@
+/**
+ * F-VIT — Core Web Vitals (LCP/INP/CLS) + FCP/TTFB via raw PerformanceObserver (no dependency, to
+ * keep the core tiny). **Per-route (A4):** LCP/INP/CLS finalize + reset at each route boundary (SPA
+ * soft navigation, via the Navigation API or a popstate/history fallback) AND on `visibilitychange →
+ * hidden`, so every route reports its own vitals + attribution. FCP/TTFB are final early (initial route).
+ *
+ * Ordering note: bootstrap runs setupAll() BEFORE pipeline.start(), so this feature's
+ * visibilitychange listener is registered before the pipeline's flush listener → we emit the CWV
+ * items, then the pipeline flushes them (keepalive). Do not reorder bootstrap without preserving this.
+ */
+import { safeObserve } from './observe';
+import { lcpFrom, maxInp, newClsState, addClsWindowed, stripUrlQuery, lcpPhases, ttfbPhases, loafScriptFor, rateVital } from './vitals';
+import { lcpAttribution, newShiftAcc, addShiftSources, clsAttribution, newInpAcc, addInpInteraction, inpAttribution, } from './attribution';
+import { uuid, now } from '../../core';
+export class WebVitalsFeature {
+    constructor() {
+        this.name = 'webVitals';
+        this.ctx = null;
+        this.active = false;
+        this.disconnects = [];
+        this.lcp = 0;
+        this.clsState = newClsState(); // session-window CLS (the real CWV)
+        this.inp = 0;
+        this.clsAcc = newShiftAcc();
+        this.inpAcc = newInpAcc();
+        // Per-route (A4): the normalized route currently accumulating. Vitals finalize + reset at each route
+        // boundary (SPA soft navigation) and on hide, so every route reports its OWN LCP/CLS/INP.
+        this.route = '/';
+        // A6 — Long Animation Frames (capped) + the worst interaction's time window, joined at finalize so
+        // INP attribution names the blocking script.
+        this.loaf = [];
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        if (typeof PerformanceObserver === 'undefined')
+            return;
+        this.disconnects.push(safeObserve('largest-contentful-paint', (e) => {
+            const next = lcpFrom(e);
+            if (next) {
+                this.lcp = next;
+                // The last entry is the current LCP winner — capture its element/url/timing.
+                this.lcpAttr = lcpAttribution(e[e.length - 1]) ?? this.lcpAttr;
+                if (this.lcpAttr?.url)
+                    this.lcpAttr.url = stripUrlQuery(this.lcpAttr.url); // #1 privacy: drop query/hash
+            }
+        }));
+        this.disconnects.push(safeObserve('layout-shift', (e) => {
+            addClsWindowed(this.clsState, e); // real session-window CLS value
+            addShiftSources(this.clsAcc, e); // shift sources (attribution)
+        }));
+        this.disconnects.push(safeObserve('event', (e) => {
+            // Track the worst interaction's time window (for the LoAF join), before bumping the max.
+            let worst = this.inp;
+            for (const entry of e) {
+                if (typeof entry.duration === 'number' && entry.duration > worst && typeof entry.startTime === 'number') {
+                    worst = entry.duration;
+                    this.inpWindow = { start: entry.startTime, end: entry.startTime + entry.duration };
+                }
+            }
+            this.inp = maxInp(this.inp, e);
+            addInpInteraction(this.inpAcc, e);
+        }, { durationThreshold: 40 }));
+        // A6 — Long Animation Frames: keep a bounded list of frames + their scripts to blame for INP jank.
+        this.disconnects.push(safeObserve('long-animation-frame', (e) => {
+            for (const entry of e) {
+                if (this.loaf.length >= WebVitalsFeature.LOAF_CAP)
+                    break; // bounded memory
+                const start = entry.startTime ?? 0;
+                const scripts = (entry.scripts ?? []).map((sc) => ({
+                    url: stripUrlQuery(sc.sourceURL || sc.name || '') ?? '',
+                    dur: typeof sc.duration === 'number' ? sc.duration : 0,
+                    // P4 — carried so INP attribution can name the function, not just the bundle.
+                    fn: sc.sourceFunctionName,
+                    invokerType: sc.invokerType,
+                }));
+                this.loaf.push({ start, end: start + (entry.duration ?? 0), scripts });
+            }
+        }));
+        // FCP — final early.
+        this.disconnects.push(safeObserve('paint', (e) => {
+            const fcp = e.find((x) => x.name === 'first-contentful-paint');
+            if (fcp)
+                this.emit('fcp', fcp.startTime, 'ms');
+        }));
+        this.route = normalizeRoute(currentPath());
+        this.installRouteDetection(); // SPA soft-nav → finalize the route we leave, start the new one
+        this.emitTtfb();
+        // Finalize the current route's CWV on hide (covers the last route + the non-SPA single-page case).
+        if (typeof document !== 'undefined') {
+            this.hideHandler = () => {
+                if (document.visibilityState === 'hidden')
+                    this.finalizeRoute();
+            };
+            document.addEventListener('visibilitychange', this.hideHandler);
+        }
+        this.active = true;
+    }
+    emitTtfb() {
+        try {
+            const nav = (typeof performance !== 'undefined'
+                ? performance.getEntriesByType('navigation')[0]
+                : undefined);
+            // P4: TTFB now ships its phase breakdown. It was previously the only vital with NO attribution
+            // at all, which left every diagnosis at "your server is slow" — see ttfbPhases().
+            if (nav && nav.responseStart > 0)
+                this.emit('ttfb', nav.responseStart, 'ms', { ttfbPhases: ttfbPhases() });
+        }
+        catch {
+            /* navigation timing unavailable */
+        }
+    }
+    /** Emit the accumulating route's LCP/CLS/INP (with attribution), then reset for the next route.
+     *  Called at each route boundary and on hide; after reset the value guards make a repeat call a no-op. */
+    finalizeRoute() {
+        const cls = this.clsState.max;
+        if (this.lcp > 0) {
+            if (this.lcpAttr) {
+                const phases = lcpPhases(this.lcpAttr); // A5 — TTFB → render breakdown
+                if (phases)
+                    this.lcpAttr.phases = phases;
+            }
+            this.emit('lcp', this.lcp, 'ms', this.lcpAttr);
+        }
+        if (this.inp > 0) {
+            const inpAttr = inpAttribution(this.inpAcc);
+            if (inpAttr && this.inpWindow) {
+                const ls = loafScriptFor(this.loaf, this.inpWindow); // A6 — blame the blocking script
+                if (ls)
+                    inpAttr.loafScript = ls;
+            }
+            this.emit('inp', this.inp, 'ms', inpAttr);
+        }
+        if (cls > 0)
+            this.emit('cls', Math.round(cls * 1000) / 1000, 'score', clsAttribution(this.clsAcc));
+        this.lcp = this.inp = 0;
+        this.clsState = newClsState();
+        this.lcpAttr = undefined;
+        this.clsAcc = newShiftAcc();
+        this.inpAcc = newInpAcc();
+        this.loaf = [];
+        this.inpWindow = undefined;
+    }
+    /** A route boundary (SPA soft navigation): finalize the route we're leaving, switch to the new one. */
+    onRouteChange() {
+        const next = normalizeRoute(currentPath());
+        if (next === this.route)
+            return; // hash-only / no path change → not a new route
+        this.finalizeRoute();
+        this.route = next;
+    }
+    /** Detect SPA route changes. Prefers the Navigation API (Chromium — fires for push/replace/popstate,
+     *  no patching); falls back to popstate + a guarded history patch elsewhere. */
+    installRouteDetection() {
+        const w = typeof window !== 'undefined'
+            ? window
+            : undefined;
+        if (!w)
+            return;
+        const fire = () => this.onRouteChange();
+        const nav = w.navigation;
+        if (nav && typeof nav.addEventListener === 'function') {
+            nav.addEventListener('currententrychange', fire);
+            this.routeStop = () => nav.removeEventListener('currententrychange', fire);
+            return;
+        }
+        w.addEventListener('popstate', fire);
+        const h = w.history;
+        const origPush = h.pushState;
+        const origReplace = h.replaceState;
+        const wrap = (orig) => function (...args) {
+            const r = orig.apply(this, args);
+            fire();
+            return r;
+        };
+        try {
+            h.pushState = wrap(origPush);
+            h.replaceState = wrap(origReplace);
+        }
+        catch {
+            /* history not writable */
+        }
+        this.routeStop = () => {
+            w.removeEventListener('popstate', fire);
+            try {
+                h.pushState = origPush;
+                h.replaceState = origReplace;
+            }
+            catch {
+                /* ignore */
+            }
+        };
+    }
+    emit(metric, value, unit, attribution) {
+        const item = {
+            kind: 'performance',
+            metric,
+            value: unit === 'score' ? value : Math.round(value),
+            unit,
+            screenName: this.route, // the route this vital was accumulated on (per-route attribution)
+            clientId: `vit_${uuid()}`,
+            timestamp: now(),
+        };
+        if (attribution)
+            item.attribution = attribution;
+        this.ctx?.emit(item);
+        // ALSO raise it as a capture signal, which AnalyticsFeature promotes to a `$web_vital` product
+        // event. Vitals lived only in the performance lane, so a funnel could not segment on them —
+        // "conversion for sessions whose LCP was over 2.5s" was unaskable despite the data existing.
+        // The rating is computed here (one place that knows the thresholds) rather than in every consumer.
+        // `signal?.` — optional call, like AnalyticsFeature's `onSignal?.`. Reporting a vital must never
+        // throw because a host (or a test double) handed us a partial context.
+        this.ctx?.signal?.('web_vital', {
+            metric,
+            value: item.value,
+            unit,
+            rating: rateVital(metric, item.value),
+            path: this.route,
+        });
+    }
+    teardown() {
+        for (const d of this.disconnects)
+            d();
+        this.disconnects = [];
+        if (this.hideHandler && typeof document !== 'undefined') {
+            document.removeEventListener('visibilitychange', this.hideHandler);
+        }
+        this.routeStop?.();
+        this.routeStop = undefined;
+        this.active = false;
+    }
+}
+WebVitalsFeature.LOAF_CAP = 30;
+function currentPath() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : '/';
+    }
+    catch {
+        return '/';
+    }
+}
+/** Collapse high-cardinality path segments (numeric / uuid / long-hash ids) → `:id` so routes group +
+ *  the dashboard route dropdown stays usable. e.g. `/orders/4821/items/abc123def0` → `/orders/:id/items/:id`. */
+export function normalizeRoute(path) {
+    return (path
+        .replace(/\/[0-9a-f]{8,}(?=\/|$)/gi, '/:id') // uuids / long hashes
+        .replace(/\/\d+(?=\/|$)/g, '/:id') || '/' // numeric ids
+    );
+}
+//# sourceMappingURL=WebVitalsFeature.js.map

package/dist/features/webVitals/WebVitalsFeature.js.map

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

package/dist/features/webVitals/attribution.d.ts

@@ -0,0 +1,50 @@
+/**
+ * F-VIT attribution — turns a Web Vital number into the element/cause to fix it, with ZERO
+ * third-party deps. Pure functions that read raw PerformanceObserver entries
+ * (`largest-contentful-paint`, `layout-shift`, `event`/`first-input`) and produce optional
+ * `attribution` fields for the `performance` wire item.
+ *
+ * Why local: these helpers must stay inside features/webVitals/ (parallel-work boundary) and add no
+ * runtime deps, so the selector helper below is a tiny local copy rather than a cross-feature import.
+ */
+import type { PerfAttribution } from '@scalebun/protocol';
+type Loose = Record<string, unknown>;
+/** A stable, structure-only CSS selector for an element (no text/PII). */
+export declare function stableSelector(el: Element | null | undefined): string | undefined;
+/**
+ * Attribution for the winning largest-contentful-paint entry: the element selector + tag, the
+ * image/resource url (if media), and load/render timing. Returns undefined when nothing useful.
+ */
+export declare function lcpAttribution(entry: Loose | undefined): PerfAttribution | undefined;
+interface ShiftAcc {
+    /** The single largest layout-shift value seen this session. */
+    largestValue: number;
+    /** Sources of that largest shift. */
+    sources: NonNullable<PerfAttribution['sources']>;
+}
+/** Fresh CLS-source accumulator. */
+export declare function newShiftAcc(): ShiftAcc;
+/**
+ * Fold a batch of layout-shift entries into the accumulator, keeping the SOURCES (the elements that
+ * moved) of the single largest qualifying shift. Mirrors `addCls`'s hadRecentInput exclusion.
+ */
+export declare function addShiftSources(acc: ShiftAcc, entries: ReadonlyArray<Loose>, maxSources?: number): ShiftAcc;
+/** Build the CLS attribution object from the accumulator (undefined when no sources captured). */
+export declare function clsAttribution(acc: ShiftAcc): PerfAttribution | undefined;
+interface InpAcc {
+    duration: number;
+    attribution?: PerfAttribution;
+}
+/** Fresh INP accumulator. */
+export declare function newInpAcc(): InpAcc;
+/**
+ * Track the slowest interaction across `event`/`first-input` entries and capture its target
+ * selector, event type, and phase breakdown (input delay / processing / presentation).
+ */
+export declare function addInpInteraction(acc: InpAcc, entries: ReadonlyArray<Loose>): InpAcc;
+/** Phase breakdown for a single event-timing entry. */
+export declare function inpAttributionFromEntry(e: Loose): PerfAttribution;
+/** Attribution for the slowest interaction (undefined when none captured). */
+export declare function inpAttribution(acc: InpAcc): PerfAttribution | undefined;
+export {};
+//# sourceMappingURL=attribution.d.ts.map

package/dist/features/webVitals/attribution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribution.d.ts","sourceRoot":"","sources":["../../../src/features/webVitals/attribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAI1D,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAQrC,0EAA0E;AAC1E,wBAAgB,cAAc,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CA4BjF;AAiCD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,GAAG,eAAe,GAAG,SAAS,CAgBpF;AAMD,UAAU,QAAQ;IAChB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,WAAW,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC;CAClD;AAED,oCAAoC;AACpC,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,EAAE,UAAU,SAAI,GAAG,QAAQ,CAmBtG;AAED,kGAAkG;AAClG,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,GAAG,eAAe,GAAG,SAAS,CAMzE;AAMD,UAAU,MAAM;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,6BAA6B;AAC7B,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAQpF;AAED,uDAAuD;AACvD,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,KAAK,GAAG,eAAe,CAkBjE;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAEvE"}

package/dist/features/webVitals/attribution.js

@@ -0,0 +1,186 @@
+/**
+ * F-VIT attribution — turns a Web Vital number into the element/cause to fix it, with ZERO
+ * third-party deps. Pure functions that read raw PerformanceObserver entries
+ * (`largest-contentful-paint`, `layout-shift`, `event`/`first-input`) and produce optional
+ * `attribution` fields for the `performance` wire item.
+ *
+ * Why local: these helpers must stay inside features/webVitals/ (parallel-work boundary) and add no
+ * runtime deps, so the selector helper below is a tiny local copy rather than a cross-feature import.
+ */
+// ---------------------------------------------------------------------------
+// Stable CSS selector: id > data-testid > tag + :nth-of-type() path, capped depth.
+// ---------------------------------------------------------------------------
+const MAX_DEPTH = 5;
+/** A stable, structure-only CSS selector for an element (no text/PII). */
+export function stableSelector(el) {
+    if (!el || typeof el.tagName !== 'string')
+        return undefined;
+    const parts = [];
+    let node = el;
+    let depth = 0;
+    while (node && node.nodeType === 1 && depth < MAX_DEPTH) {
+        // A unique id ends the path immediately (ids are document-unique by spec).
+        if (node.id) {
+            parts.unshift(`#${cssEscape(node.id)}`);
+            break;
+        }
+        const testid = node.getAttribute && node.getAttribute('data-testid');
+        if (testid) {
+            parts.unshift(`[data-testid="${cssEscape(testid)}"]`);
+            break;
+        }
+        const tag = node.tagName.toLowerCase();
+        const parent = node.parentElement;
+        if (!parent) {
+            parts.unshift(tag);
+            break;
+        }
+        const idx = nthOfType(node, tag);
+        parts.unshift(idx > 1 ? `${tag}:nth-of-type(${idx})` : tag);
+        node = parent;
+        depth++;
+    }
+    return parts.length ? parts.join(' > ') : undefined;
+}
+/** 1-based index of `node` among same-tag siblings. */
+function nthOfType(node, tag) {
+    let i = 1;
+    let sib = node.previousElementSibling;
+    while (sib) {
+        if (sib.tagName && sib.tagName.toLowerCase() === tag)
+            i++;
+        sib = sib.previousElementSibling;
+    }
+    return i;
+}
+/** Minimal CSS identifier escape — enough to keep selectors valid without pulling in CSS.escape. */
+function cssEscape(s) {
+    return s.replace(/([^\w-])/g, '\\$1');
+}
+function rectOf(r) {
+    if (!r)
+        return undefined;
+    return { x: num(r.x), y: num(r.y), width: num(r.width), height: num(r.height) };
+}
+function num(v) {
+    return typeof v === 'number' && isFinite(v) ? v : 0;
+}
+// ---------------------------------------------------------------------------
+// A1 — LCP attribution
+// ---------------------------------------------------------------------------
+/**
+ * Attribution for the winning largest-contentful-paint entry: the element selector + tag, the
+ * image/resource url (if media), and load/render timing. Returns undefined when nothing useful.
+ */
+export function lcpAttribution(entry) {
+    if (!entry)
+        return undefined;
+    const el = entry.element;
+    const url = typeof entry.url === 'string' && entry.url ? entry.url : undefined;
+    const selector = stableSelector(el);
+    const tag = el && typeof el.tagName === 'string' ? el.tagName.toLowerCase() : undefined;
+    const loadTime = typeof entry.loadTime === 'number' ? entry.loadTime : undefined;
+    const renderTime = typeof entry.renderTime === 'number' ? entry.renderTime : undefined;
+    if (!selector && !url && !tag && loadTime === undefined && renderTime === undefined)
+        return undefined;
+    const out = {};
+    if (selector)
+        out.element = selector;
+    if (tag)
+        out.elementTag = tag;
+    if (url)
+        out.url = url;
+    if (loadTime !== undefined)
+        out.loadTime = round(loadTime);
+    if (renderTime !== undefined)
+        out.renderTime = round(renderTime);
+    return out;
+}
+/** Fresh CLS-source accumulator. */
+export function newShiftAcc() {
+    return { largestValue: 0, sources: [] };
+}
+/**
+ * Fold a batch of layout-shift entries into the accumulator, keeping the SOURCES (the elements that
+ * moved) of the single largest qualifying shift. Mirrors `addCls`'s hadRecentInput exclusion.
+ */
+export function addShiftSources(acc, entries, maxSources = 5) {
+    for (const e of entries) {
+        if (e.hadRecentInput)
+            continue;
+        const value = num(e.value);
+        if (value <= 0 || value <= acc.largestValue)
+            continue;
+        const raw = e.sources || [];
+        const sources = [];
+        for (const s of raw.slice(0, maxSources)) {
+            const node = (s.node ?? undefined);
+            sources.push({
+                selector: stableSelector(node),
+                previousRect: rectOf(s.previousRect),
+                currentRect: rectOf(s.currentRect),
+            });
+        }
+        acc.largestValue = value;
+        acc.sources = sources;
+    }
+    return acc;
+}
+/** Build the CLS attribution object from the accumulator (undefined when no sources captured). */
+export function clsAttribution(acc) {
+    if (acc.largestValue <= 0 || acc.sources.length === 0)
+        return undefined;
+    return {
+        largestShiftValue: Math.round(acc.largestValue * 1000) / 1000,
+        sources: acc.sources,
+    };
+}
+/** Fresh INP accumulator. */
+export function newInpAcc() {
+    return { duration: 0 };
+}
+/**
+ * Track the slowest interaction across `event`/`first-input` entries and capture its target
+ * selector, event type, and phase breakdown (input delay / processing / presentation).
+ */
+export function addInpInteraction(acc, entries) {
+    for (const e of entries) {
+        const duration = num(e.duration);
+        if (duration <= acc.duration)
+            continue;
+        acc.duration = duration;
+        acc.attribution = inpAttributionFromEntry(e);
+    }
+    return acc;
+}
+/** Phase breakdown for a single event-timing entry. */
+export function inpAttributionFromEntry(e) {
+    const target = e.target ?? undefined;
+    const startTime = num(e.startTime);
+    const processingStart = num(e.processingStart);
+    const processingEnd = num(e.processingEnd);
+    const duration = num(e.duration);
+    const out = {};
+    const selector = stableSelector(target);
+    if (selector)
+        out.element = selector;
+    if (target && typeof target.tagName === 'string')
+        out.elementTag = target.tagName.toLowerCase();
+    if (typeof e.name === 'string')
+        out.eventType = e.name;
+    if (processingStart > 0)
+        out.inputDelay = round(Math.max(0, processingStart - startTime));
+    if (processingEnd >= processingStart && processingStart > 0)
+        out.processingTime = round(Math.max(0, processingEnd - processingStart));
+    if (processingEnd > 0)
+        out.presentationDelay = round(Math.max(0, startTime + duration - processingEnd));
+    return out;
+}
+/** Attribution for the slowest interaction (undefined when none captured). */
+export function inpAttribution(acc) {
+    return acc.duration > 0 ? acc.attribution : undefined;
+}
+function round(n) {
+    return Math.round(n);
+}
+//# sourceMappingURL=attribution.js.map

package/dist/features/webVitals/attribution.js.map

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

package/dist/features/webVitals/observe.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Re-export of the shared PerformanceObserver helper (moved to core/ so F-VIT and F-PERF share one
+ * implementation). Kept here so existing F-VIT imports stay stable.
+ */
+export { safeObserve } from '../../core/observe';
+//# sourceMappingURL=observe.d.ts.map

package/dist/features/webVitals/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../src/features/webVitals/observe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/features/webVitals/observe.js

@@ -0,0 +1,6 @@
+/**
+ * Re-export of the shared PerformanceObserver helper (moved to core/ so F-VIT and F-PERF share one
+ * implementation). Kept here so existing F-VIT imports stay stable.
+ */
+export { safeObserve } from '../../core/observe';
+//# sourceMappingURL=observe.js.map

package/dist/features/webVitals/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../../src/features/webVitals/observe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC"}