@scalebun-release/web 2.2.2

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.js';
+//# 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.js';
+//# 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"}

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

@@ -0,0 +1,99 @@
+/**
+ * Pure CWV reducers — kept separate from the observer wiring so they're unit-testable without a
+ * browser. v1 uses simple, cheap definitions (documented approximations vs the web-vitals lib).
+ */
+type Entry = PerformanceEntry | Record<string, unknown>;
+/** LCP = the last largest-contentful-paint entry's render/load time. */
+export declare function lcpFrom(entries: ReadonlyArray<Entry>): number;
+/** CLS = running sum of layout-shift values, excluding shifts after recent input.
+ *  @deprecated naïve sum — overstates CLS on long/SPA sessions. Use the session-window reducer below
+ *  ({@link newClsState} + {@link addClsWindowed}) for the real CWV value. Kept for back-compat + tests. */
+export declare function addCls(current: number, entries: ReadonlyArray<Entry>): number;
+/** Session-window CLS state (the real Core Web Vital): the max sum over any window of consecutive
+ *  shifts each within 1 s of the previous and ≤ 5 s total. `max` is the reportable CLS. */
+export interface ClsState {
+    max: number;
+    cur: number;
+    first: number;
+    last: number;
+}
+/** Fresh session-window accumulator (reset per route). */
+export declare function newClsState(): ClsState;
+/**
+ * Fold layout-shift entries into the session-window CLS — the web-vitals algorithm: a shift extends
+ * the current window if it's < 1 s after the last shift and < 5 s after the window's first; otherwise
+ * it opens a new window. CLS = the largest window sum. Excludes shifts after recent input.
+ */
+export declare function addClsWindowed(state: ClsState, entries: ReadonlyArray<Entry>): ClsState;
+/** INP ≈ the worst interaction duration seen (cheap upper bound). */
+export declare function maxInp(current: number, entries: ReadonlyArray<Entry>): number;
+/** Drop query + hash from a URL (may carry tokens/PII). Keep origin + path. */
+export declare function stripUrlQuery(url: string | undefined): string | undefined;
+export interface LcpPhases {
+    ttfb: number;
+    resourceLoadDelay: number;
+    resourceLoadTime: number;
+    elementRenderDelay: number;
+}
+export interface TtfbPhases {
+    /** Time in HTTP redirects before the final document was even requested. */
+    redirect: number;
+    /** Service-worker startup, when one intercepted the navigation. */
+    worker: number;
+    dns: number;
+    tcp: number;
+    /** TLS handshake — part of `tcp` in the timeline, reported separately because it is fixable. */
+    tls: number;
+    /** requestStart → responseStart: the server actually thinking. Usually the whole story. */
+    request: number;
+}
+/**
+ * TTFB phase breakdown — the whole point of P4 for this metric.
+ *
+ * Until now TTFB was emitted as a bare number, so 0% of it carried attribution and the only advice a
+ * rule could give was "look at server response time". That is not a diagnosis. Every phase here comes
+ * from the SAME Navigation Timing entry TTFB itself is read from, so it costs one extra read and no
+ * new observer: a redirect chain, a cold service worker, a slow DNS lookup and a slow server are four
+ * completely different problems that were previously indistinguishable.
+ *
+ * Returns undefined when navigation timing is unavailable. Phases are clamped ≥ 0 and rounded, and
+ * sum to `responseStart` by construction (the marks are consecutive points on one timeline).
+ */
+export declare function ttfbPhases(): TtfbPhases | undefined;
+/**
+ * LCP timing breakdown (A5; web-vitals/attribution model): TTFB → resourceLoadDelay → resourceLoadTime
+ * → elementRenderDelay. Reads navigation + (for image LCP) resource timing. Returns undefined when
+ * timing is unavailable. All phases clamped ≥ 0 and rounded.
+ */
+export declare function lcpPhases(attr: {
+    url?: string;
+    loadTime?: number;
+    renderTime?: number;
+}): LcpPhases | undefined;
+/**
+ * The longest script among Long-Animation-Frame frames overlapping [start, end] — the script most
+ * likely responsible for an interaction's processing delay (A6, INP × LoAF). Undefined if none overlap.
+ */
+/** The script fields carried through the INP × LoAF join. `fn`/`invokerType` are P4 (see below). */
+export interface LoafScriptRef {
+    url: string;
+    dur: number;
+    fn?: string;
+    invokerType?: string;
+}
+export declare function loafScriptFor(loaf: ReadonlyArray<{
+    start: number;
+    end: number;
+    scripts: ReadonlyArray<LoafScriptRef>;
+}>, window: {
+    start: number;
+    end: number;
+}): {
+    url: string;
+    duration: number;
+    fn?: string;
+    invokerType?: string;
+} | undefined;
+export declare function rateVital(metric: string, value: number): 'good' | 'needs-improvement' | 'poor' | 'unknown';
+export {};
+//# sourceMappingURL=vitals.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../../../src/features/webVitals/vitals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,KAAK,KAAK,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7D;AAED;;2GAE2G;AAC3G,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7E;AAED;2FAC2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,QAAQ,CAevF;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7E;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;IACZ,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,UAAU,GAAG,SAAS,CAgBnD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,SAAS,CAyB/G;AAED;;;GAGG;AACH,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAAE,CAAC,EAC1F,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAclF;AAiBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAM1G"}

package/dist/features/webVitals/vitals.js

@@ -0,0 +1,166 @@
+/**
+ * Pure CWV reducers — kept separate from the observer wiring so they're unit-testable without a
+ * browser. v1 uses simple, cheap definitions (documented approximations vs the web-vitals lib).
+ */
+/** LCP = the last largest-contentful-paint entry's render/load time. */
+export function lcpFrom(entries) {
+    const last = entries[entries.length - 1];
+    if (!last)
+        return 0;
+    return last.renderTime || last.loadTime || last.startTime || 0;
+}
+/** CLS = running sum of layout-shift values, excluding shifts after recent input.
+ *  @deprecated naïve sum — overstates CLS on long/SPA sessions. Use the session-window reducer below
+ *  ({@link newClsState} + {@link addClsWindowed}) for the real CWV value. Kept for back-compat + tests. */
+export function addCls(current, entries) {
+    let v = current;
+    for (const e of entries) {
+        if (!e.hadRecentInput && typeof e.value === 'number')
+            v += e.value;
+    }
+    return v;
+}
+/** Fresh session-window accumulator (reset per route). */
+export function newClsState() {
+    return { max: 0, cur: 0, first: 0, last: 0 };
+}
+/**
+ * Fold layout-shift entries into the session-window CLS — the web-vitals algorithm: a shift extends
+ * the current window if it's < 1 s after the last shift and < 5 s after the window's first; otherwise
+ * it opens a new window. CLS = the largest window sum. Excludes shifts after recent input.
+ */
+export function addClsWindowed(state, entries) {
+    for (const e of entries) {
+        if (e.hadRecentInput || typeof e.value !== 'number')
+            continue;
+        const t = typeof e.startTime === 'number' ? e.startTime : state.last;
+        if (state.cur > 0 && t - state.last < 1000 && t - state.first < 5000) {
+            state.cur += e.value;
+            state.last = t;
+        }
+        else {
+            state.cur = e.value;
+            state.first = t;
+            state.last = t;
+        }
+        if (state.cur > state.max)
+            state.max = state.cur;
+    }
+    return state;
+}
+/** INP ≈ the worst interaction duration seen (cheap upper bound). */
+export function maxInp(current, entries) {
+    let m = current;
+    for (const e of entries) {
+        if (typeof e.duration === 'number' && e.duration > m)
+            m = e.duration;
+    }
+    return m;
+}
+/** Drop query + hash from a URL (may carry tokens/PII). Keep origin + path. */
+export function stripUrlQuery(url) {
+    if (!url)
+        return undefined;
+    return url.replace(/[?#].*$/, '');
+}
+/**
+ * TTFB phase breakdown — the whole point of P4 for this metric.
+ *
+ * Until now TTFB was emitted as a bare number, so 0% of it carried attribution and the only advice a
+ * rule could give was "look at server response time". That is not a diagnosis. Every phase here comes
+ * from the SAME Navigation Timing entry TTFB itself is read from, so it costs one extra read and no
+ * new observer: a redirect chain, a cold service worker, a slow DNS lookup and a slow server are four
+ * completely different problems that were previously indistinguishable.
+ *
+ * Returns undefined when navigation timing is unavailable. Phases are clamped ≥ 0 and rounded, and
+ * sum to `responseStart` by construction (the marks are consecutive points on one timeline).
+ */
+export function ttfbPhases() {
+    if (typeof performance === 'undefined' || typeof performance.getEntriesByType !== 'function')
+        return undefined;
+    const nav = performance.getEntriesByType('navigation')[0];
+    if (!nav || !(nav.responseStart > 0))
+        return undefined;
+    // `seg` semantics, inlined: a zero mark means "did not happen" (no redirect, no worker) or
+    // "not exposed", and both must read as 0 rather than as a negative span.
+    const r = (a, b) => (a > 0 && b >= a ? Math.round(b - a) : 0);
+    return {
+        redirect: r(nav.redirectStart, nav.redirectEnd),
+        // workerStart has no paired end mark; the span to fetchStart is the startup cost.
+        worker: r(nav.workerStart, nav.fetchStart),
+        dns: r(nav.domainLookupStart, nav.domainLookupEnd),
+        tcp: r(nav.connectStart, nav.connectEnd),
+        tls: r(nav.secureConnectionStart, nav.connectEnd),
+        request: r(nav.requestStart, nav.responseStart),
+    };
+}
+/**
+ * LCP timing breakdown (A5; web-vitals/attribution model): TTFB → resourceLoadDelay → resourceLoadTime
+ * → elementRenderDelay. Reads navigation + (for image LCP) resource timing. Returns undefined when
+ * timing is unavailable. All phases clamped ≥ 0 and rounded.
+ */
+export function lcpPhases(attr) {
+    if (typeof performance === 'undefined' || typeof performance.getEntriesByType !== 'function')
+        return undefined;
+    const nav = performance.getEntriesByType('navigation')[0];
+    const ttfb = Math.max(0, nav?.responseStart ?? 0);
+    const renderTime = attr.renderTime ?? attr.loadTime ?? 0;
+    if (renderTime <= 0)
+        return undefined;
+    let lcpRequestStart = ttfb;
+    let lcpResponseEnd = attr.loadTime ?? renderTime;
+    if (attr.url) {
+        const res = performance.getEntriesByName(attr.url)[0];
+        if (res) {
+            lcpRequestStart = Math.max(ttfb, res.requestStart || res.startTime || ttfb);
+            lcpResponseEnd = attr.loadTime || res.responseEnd || lcpResponseEnd;
+        }
+    }
+    const r = (n) => Math.round(Math.max(0, n));
+    return {
+        ttfb: r(ttfb),
+        resourceLoadDelay: r(lcpRequestStart - ttfb),
+        resourceLoadTime: attr.url ? r(lcpResponseEnd - lcpRequestStart) : 0,
+        elementRenderDelay: r(renderTime - (attr.url ? lcpResponseEnd : ttfb)),
+    };
+}
+export function loafScriptFor(loaf, window) {
+    let best;
+    for (const f of loaf) {
+        if (f.end < window.start || f.start > window.end)
+            continue; // no overlap with the interaction
+        for (const sc of f.scripts) {
+            // P4: carry the function name and invoker type through the join. `inp-long-handler` previously
+            // could only name a minified bundle ("a handler in app.js runs for 420 ms"); with these it can
+            // name the function, and distinguish an event listener from a promise continuation — which need
+            // different fixes.
+            if (sc.url && (!best || sc.dur > best.duration))
+                best = { url: sc.url, duration: Math.round(sc.dur), fn: sc.fn, invokerType: sc.invokerType };
+        }
+    }
+    return best;
+}
+/**
+ * Core Web Vitals "good / needs-improvement / poor" thresholds, from web.dev.
+ *
+ * Lives here (not at the call site) so the SDK has ONE definition of what a good LCP is — the same
+ * rating then travels on the `$web_vital` event, and a funnel filtering `rating = 'poor'` means the
+ * same thing as the dashboard's own colouring.
+ */
+const VITAL_THRESHOLDS = {
+    lcp: [2500, 4000],
+    inp: [200, 500],
+    cls: [0.1, 0.25],
+    fcp: [1800, 3000],
+    ttfb: [800, 1800],
+};
+export function rateVital(metric, value) {
+    const t = VITAL_THRESHOLDS[metric];
+    // An unknown metric has no thresholds, and guessing one would be a fabricated verdict.
+    if (!t)
+        return 'unknown';
+    if (value <= t[0])
+        return 'good';
+    return value <= t[1] ? 'needs-improvement' : 'poor';
+}
+//# sourceMappingURL=vitals.js.map

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

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

package/dist/features/webperf/WebPerfFeature.d.ts

@@ -0,0 +1,19 @@
+/**
+ * F-PERFWEB — Web RUM: page-load (Navigation Timing) + FPS (rAF) + LoAF. Maps onto the EXISTING
+ * PerformanceMetric types (screen_load / frame_metrics / js_stall) so the dashboards already read it.
+ * The collector wiring is LAZY-loaded (its work is deferred anyway — load event, 30 s FPS cadence,
+ * buffered LoAF) so it stays out of the core bundle. Raw web APIs only (zero third-party deps).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export { fpsFromFrames, loafSeverity, navMetric } from './math.js';
+export declare class WebPerfFeature implements IFeature {
+    readonly name = "webPerf";
+    private ctx;
+    private active;
+    private stop?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): Promise<void>;
+    private emit;
+    teardown(): void;
+}
+//# sourceMappingURL=WebPerfFeature.d.ts.map

package/dist/features/webperf/WebPerfFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebPerfFeature.d.ts","sourceRoot":"","sources":["../../../src/features/webperf/WebPerfFeature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAUhE,qBAAa,cAAe,YAAW,QAAQ;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAC,CAAa;IAE1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,OAAO,CAAC,IAAI;IAaZ,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/features/webperf/WebPerfFeature.js

@@ -0,0 +1,48 @@
+import { uuid, now } from '../../core/index.js';
+// Re-export the pure math (also covered by the unit tests).
+export { fpsFromFrames, loafSeverity, navMetric } from './math.js';
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class WebPerfFeature {
+    constructor() {
+        this.name = 'webPerf';
+        this.ctx = null;
+        this.active = false;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined' || typeof performance === 'undefined')
+            return;
+        this.active = true;
+        const { startCollectors } = await import('./collectors.js');
+        if (this.active)
+            this.stop = startCollectors((metric, value, metadata, duration) => this.emit(metric, value, metadata, duration), () => this.active);
+    }
+    emit(metric, value, metadata, duration) {
+        this.ctx?.emit({
+            kind: 'performance',
+            metric,
+            value,
+            screenName: currentScreen(),
+            ...(duration != null ? { duration } : {}),
+            metadata,
+            clientId: `pw_${uuid()}`,
+            timestamp: now(),
+        });
+    }
+    teardown() {
+        this.active = false;
+        this.stop?.();
+        this.stop = undefined;
+    }
+}
+//# sourceMappingURL=WebPerfFeature.js.map

package/dist/features/webperf/WebPerfFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebPerfFeature.js","sourceRoot":"","sources":["../../../src/features/webperf/WebPerfFeature.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEhE,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,cAAc;IAA3B;QACW,SAAI,GAAG,SAAS,CAAC;QAClB,QAAG,GAA0B,IAAI,CAAC;QAClC,WAAM,GAAG,KAAK,CAAC;IAiCzB,CAAC;IA9BC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAmB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,WAAW,KAAK,WAAW;YAAE,OAAO;QAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvJ,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,KAAa,EAAE,QAAiC,EAAE,QAAiB;QAC9F,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;YACb,IAAI,EAAE,aAAa;YACnB,MAAM;YACN,KAAK;YACL,UAAU,EAAE,aAAa,EAAE;YAC3B,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,QAAQ;YACR,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE;YACxB,SAAS,EAAE,GAAG,EAAE;SACwB,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/features/webperf/collectors.d.ts

@@ -0,0 +1,3 @@
+export type EmitPerf = (metric: string, value: number, metadata: Record<string, unknown>, duration?: number) => void;
+export declare function startCollectors(emit: EmitPerf, isActive: () => boolean): () => void;
+//# sourceMappingURL=collectors.d.ts.map

package/dist/features/webperf/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../../src/features/webperf/collectors.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAUrH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI,CAkGnF"}