@scalebun/web 1.0.0

package/dist/features/performance/spa.js

@@ -0,0 +1,40 @@
+export function installSpaRoutes(onRouteChange) {
+    if (typeof window === 'undefined' || typeof history === 'undefined' || typeof location === 'undefined') {
+        return () => { };
+    }
+    const currentRoute = () => location.pathname + location.search;
+    let last = currentRoute();
+    const fire = () => {
+        const route = currentRoute();
+        if (route !== last) {
+            last = route;
+            try {
+                onRouteChange(route);
+            }
+            catch {
+                /* never let the handler break navigation */
+            }
+        }
+    };
+    const origPush = history.pushState;
+    const origReplace = history.replaceState;
+    history.pushState = function patchedPush(...args) {
+        const ret = origPush.apply(this, args);
+        fire();
+        return ret;
+    };
+    history.replaceState = function patchedReplace(...args) {
+        const ret = origReplace.apply(this, args);
+        fire();
+        return ret;
+    };
+    window.addEventListener('popstate', fire);
+    window.addEventListener('hashchange', fire);
+    return () => {
+        history.pushState = origPush;
+        history.replaceState = origReplace;
+        window.removeEventListener('popstate', fire);
+        window.removeEventListener('hashchange', fire);
+    };
+}
+//# sourceMappingURL=spa.js.map

package/dist/features/performance/spa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.js","sourceRoot":"","sources":["../../../src/features/performance/spa.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,gBAAgB,CAAC,aAAsC;IACrE,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QACvG,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,GAAW,EAAE,CAAC,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC;IACvE,IAAI,IAAI,GAAG,YAAY,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,GAAS,EAAE;QACtB,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;QAC7B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,GAAG,KAAK,CAAC;YACb,IAAI,CAAC;gBACH,aAAa,CAAC,KAAK,CAAC,CAAC;YACvB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;YAC9C,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,SAAS,CAAC;IACnC,MAAM,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,OAAO,CAAC,SAAS,GAAG,SAAS,WAAW,CAAgB,GAAG,IAAI;QAC7D,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,IAA6B,CAAC,CAAC;QAChE,IAAI,EAAE,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,OAAO,CAAC,YAAY,GAAG,SAAS,cAAc,CAAgB,GAAG,IAAI;QACnE,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,IAA6B,CAAC,CAAC;QACnE,IAAI,EAAE,CAAC;QACP,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IACF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,CAAC,gBAAgB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IAE5C,OAAO,GAAG,EAAE;QACV,OAAO,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC7B,OAAO,CAAC,YAAY,GAAG,WAAW,CAAC;QACnC,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7C,MAAM,CAAC,mBAAmB,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/performance/throttle.d.ts

@@ -0,0 +1,21 @@
+/**
+ * A plain rolling rate cap (no dedup, no levels) — backstops a long-task / LoAF storm so a janky
+ * page can't flood the pipeline. Counts what it drops (no silent caps), mirroring F-ERR/F-CON.
+ */
+export interface RateCapOptions {
+    /** Max accepted per `windowMs`. */
+    capCount?: number;
+    windowMs?: number;
+}
+export declare class RateCap {
+    private readonly capCount;
+    private readonly windowMs;
+    private recent;
+    private dropped;
+    constructor(opts?: RateCapOptions);
+    /** True if this occurrence is within the cap; false otherwise (counts a drop). */
+    accept(): boolean;
+    /** Read + reset the dropped counter (rides along on the next emitted item's metadata). */
+    takeDropped(): number;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/features/performance/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/features/performance/throttle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,OAAO;IAClB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,cAAc;IAKjC,kFAAkF;IAClF,MAAM,IAAI,OAAO;IAWjB,0FAA0F;IAC1F,WAAW,IAAI,MAAM;CAKtB"}

package/dist/features/performance/throttle.js

@@ -0,0 +1,26 @@
+export class RateCap {
+    constructor(opts) {
+        this.recent = [];
+        this.dropped = 0;
+        this.capCount = opts?.capCount ?? 60;
+        this.windowMs = opts?.windowMs ?? 10000;
+    }
+    /** True if this occurrence is within the cap; false otherwise (counts a drop). */
+    accept() {
+        const t = Date.now();
+        this.recent = this.recent.filter((ts) => t - ts < this.windowMs);
+        if (this.recent.length >= this.capCount) {
+            this.dropped++;
+            return false;
+        }
+        this.recent.push(t);
+        return true;
+    }
+    /** Read + reset the dropped counter (rides along on the next emitted item's metadata). */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/dist/features/performance/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/features/performance/throttle.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,OAAO;IAMlB,YAAY,IAAqB;QAHzB,WAAM,GAAa,EAAE,CAAC;QACtB,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,KAAK,CAAC;IAC1C,CAAC;IAED,kFAAkF;IAClF,MAAM;QACJ,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0FAA0F;IAC1F,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/features/performance/trace/context.d.ts

@@ -0,0 +1,17 @@
+/**
+ * W3C Trace Context (RUM P1) — trace/span id generation + `traceparent` format/parse. The Perf
+ * vertical owns the ACTIVE transaction's trace context; the Network vertical reads it (the P5/N5 seam)
+ * so an outbound request injects the SAME traceparent → FE transaction ↔ FE request ↔ BE span share
+ * one distributed trace. Lazy chunk (loaded with the transaction engine).
+ */
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+}
+export declare function newTraceId(): string;
+export declare function newSpanId(): string;
+export declare function formatTraceparent(c: TraceContext): string;
+/** Parse an incoming `traceparent` (e.g. server-supplied) → context, or null if malformed. */
+export declare function parseTraceparent(header: string): TraceContext | null;
+//# sourceMappingURL=context.d.ts.map

package/dist/features/performance/trace/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;CAClB;AAeD,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AACD,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,YAAY,GAAG,MAAM,CAEzD;AAID,8FAA8F;AAC9F,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAIpE"}

package/dist/features/performance/trace/context.js

@@ -0,0 +1,33 @@
+function hex(bytes) {
+    const a = new Uint8Array(bytes);
+    if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+        crypto.getRandomValues(a);
+    }
+    else {
+        // Degraded fallback when WebCrypto is unavailable — uniqueness over cryptographic quality.
+        for (let i = 0; i < bytes; i++)
+            a[i] = (Date.now() + i * 0x9e3779b1) & 0xff;
+    }
+    let s = '';
+    for (let i = 0; i < bytes; i++)
+        s += (a[i] ?? 0).toString(16).padStart(2, '0');
+    return s;
+}
+export function newTraceId() {
+    return hex(16);
+}
+export function newSpanId() {
+    return hex(8);
+}
+export function formatTraceparent(c) {
+    return `00-${c.traceId}-${c.spanId}-${c.sampled ? '01' : '00'}`;
+}
+const TRACEPARENT = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+/** Parse an incoming `traceparent` (e.g. server-supplied) → context, or null if malformed. */
+export function parseTraceparent(header) {
+    const m = TRACEPARENT.exec(header.trim().toLowerCase());
+    if (!m)
+        return null;
+    return { traceId: m[1] ?? '', spanId: m[2] ?? '', sampled: (parseInt(m[3] ?? '0', 16) & 1) === 1 };
+}
+//# sourceMappingURL=context.js.map

package/dist/features/performance/trace/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../../src/features/performance/trace/context.ts"],"names":[],"mappings":"AAYA,SAAS,GAAG,CAAC,KAAa;IACxB,MAAM,CAAC,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC5D,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;SAAM,CAAC;QACN,2FAA2F;QAC3F,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC;IAC9E,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;QAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,GAAG,CAAC,EAAE,CAAC,CAAC;AACjB,CAAC;AACD,MAAM,UAAU,SAAS;IACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,CAAe;IAC/C,OAAO,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAClE,CAAC;AAED,MAAM,WAAW,GAAG,kDAAkD,CAAC;AAEvE,8FAA8F;AAC9F,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;AACrG,CAAC"}

package/dist/features/performance/trace/index.d.ts

@@ -0,0 +1,7 @@
+/** Lazy trace-engine barrel — Transaction/Span tree + W3C trace context. Loaded once at
+ *  PerformanceFeature.setup so it stays out of the core bundle (mirrors the replay engine / errors). */
+export { Transaction } from './transaction';
+export type { TransactionData, SpanData, TransactionOptions } from './transaction';
+export { newTraceId, newSpanId, formatTraceparent, parseTraceparent, type TraceContext } from './context';
+export { buildPageload } from './pageload';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/performance/trace/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/index.ts"],"names":[],"mappings":"AAAA;wGACwG;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,eAAe,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnF,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/features/performance/trace/index.js

@@ -0,0 +1,6 @@
+/** Lazy trace-engine barrel — Transaction/Span tree + W3C trace context. Loaded once at
+ *  PerformanceFeature.setup so it stays out of the core bundle (mirrors the replay engine / errors). */
+export { Transaction } from './transaction';
+export { newTraceId, newSpanId, formatTraceparent, parseTraceparent } from './context';
+export { buildPageload } from './pageload';
+//# sourceMappingURL=index.js.map

package/dist/features/performance/trace/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/features/performance/trace/index.ts"],"names":[],"mappings":"AAAA;wGACwG;AACxG,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,EAAE,gBAAgB,EAAqB,MAAM,WAAW,CAAC;AAC1G,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/features/performance/trace/pageload.d.ts

@@ -0,0 +1,3 @@
+import type { TransactionData } from './transaction';
+export declare function buildPageload(nav: PerformanceNavigationTiming, route: string): TransactionData;
+//# sourceMappingURL=pageload.d.ts.map

package/dist/features/performance/trace/pageload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageload.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/pageload.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,eAAe,EAAY,MAAM,eAAe,CAAC;AAI/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,2BAA2B,EAAE,KAAK,EAAE,MAAM,GAAG,eAAe,CAyB9F"}

package/dist/features/performance/trace/pageload.js

@@ -0,0 +1,34 @@
+/**
+ * Page-load transaction builder (RUM P2). Built RETROACTIVELY from the `PerformanceNavigationTiming`
+ * entry (the load already happened) — not live-timed — so each navigation phase becomes a child span
+ * with explicit start/end. Lazy chunk (uses trace-context id generation). Pure + testable.
+ */
+import { newTraceId, newSpanId } from './context';
+const r = (n) => Math.round(n);
+export function buildPageload(nav, route) {
+    const traceId = newTraceId();
+    const rootSpanId = newSpanId();
+    const spans = [];
+    const add = (op, start, end) => {
+        if (start > 0 && end > start)
+            spans.push({ spanId: newSpanId(), parentSpanId: rootSpanId, op, startMs: r(start), endMs: r(end) });
+    };
+    add('dns', nav.domainLookupStart, nav.domainLookupEnd);
+    add('connect', nav.connectStart, nav.connectEnd);
+    if (nav.secureConnectionStart > 0)
+        add('tls', nav.secureConnectionStart, nav.connectEnd);
+    add('request', nav.requestStart, nav.responseStart);
+    add('response', nav.responseStart, nav.responseEnd);
+    add('dom', nav.responseEnd, nav.domContentLoadedEventEnd);
+    add('load', nav.domContentLoadedEventEnd, nav.loadEventEnd);
+    return {
+        name: `pageload ${route}`,
+        traceId,
+        spanId: rootSpanId,
+        sampled: true,
+        startMs: 0, // navigationStart is the time origin
+        durationMs: r(nav.loadEventEnd || nav.duration),
+        spans,
+    };
+}
+//# sourceMappingURL=pageload.js.map

package/dist/features/performance/trace/pageload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pageload.js","sourceRoot":"","sources":["../../../../src/features/performance/trace/pageload.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGlD,MAAM,CAAC,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE/C,MAAM,UAAU,aAAa,CAAC,GAAgC,EAAE,KAAa;IAC3E,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,SAAS,EAAE,CAAC;IAC/B,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,MAAM,GAAG,GAAG,CAAC,EAAU,EAAE,KAAa,EAAE,GAAW,EAAQ,EAAE;QAC3D,IAAI,KAAK,GAAG,CAAC,IAAI,GAAG,GAAG,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,EAAE,YAAY,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpI,CAAC,CAAC;IAEF,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,iBAAiB,EAAE,GAAG,CAAC,eAAe,CAAC,CAAC;IACvD,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACjD,IAAI,GAAG,CAAC,qBAAqB,GAAG,CAAC;QAAE,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,qBAAqB,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACzF,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;IACpD,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,aAAa,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;IACpD,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAC1D,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,wBAAwB,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IAE5D,OAAO;QACL,IAAI,EAAE,YAAY,KAAK,EAAE;QACzB,OAAO;QACP,MAAM,EAAE,UAAU;QAClB,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,CAAC,EAAE,qCAAqC;QACjD,UAAU,EAAE,CAAC,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,CAAC;QAC/C,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/features/performance/trace/transaction.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Transaction + Span tree (RUM P1). A transaction is a timed root with a bounded tree of child spans
+ * (resource loads, long-tasks, user spans). Pure + dependency-free (injected clock → unit-testable
+ * without a browser). Bounds cardinality: caps spans per transaction, drop-counts overflow (no silent
+ * caps), and is idempotent on finish. Lazy chunk.
+ */
+import { type TraceContext } from './context';
+import { type SpanHandle, type TransactionHandle } from './types';
+export interface SpanData {
+    spanId: string;
+    parentSpanId?: string;
+    op: string;
+    description?: string;
+    startMs: number;
+    endMs?: number;
+    data?: Record<string, unknown>;
+}
+export interface TransactionData {
+    name: string;
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+    startMs: number;
+    durationMs: number;
+    spans: SpanData[];
+    droppedSpans?: number;
+    errorCount?: number;
+}
+export interface TransactionOptions {
+    clock: () => number;
+    maxSpans?: number;
+    sampled?: boolean;
+    onFinish: (t: Transaction) => void;
+}
+export declare class Transaction implements TransactionHandle {
+    readonly name: string;
+    readonly traceId: string;
+    readonly rootSpanId: string;
+    readonly startMs: number;
+    readonly sampled: boolean;
+    private endMs?;
+    private readonly spans;
+    private dropped;
+    private errors;
+    private readonly clock;
+    private readonly maxSpans;
+    private readonly onFinish;
+    constructor(name: string, opts: TransactionOptions);
+    private open;
+    startSpan(op: string, description?: string): SpanHandle;
+    /** Add an already-measured span with EXPLICIT times (for retroactive entries that happened before
+     *  we could open a live span — long-tasks, LoAF, resources). Bounded + drop-counted like live spans. */
+    addSpan(op: string, startMs: number, endMs: number, data?: Record<string, unknown>): void;
+    finish(endMs?: number): void;
+    /** Note that an error occurred during this transaction's window (drives correlation + sampling). */
+    noteError(): void;
+    /** The active trace context — read by the Network vertical (P5/N5 seam) to share the trace. */
+    context(): TraceContext;
+    data(): TransactionData;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/features/performance/trace/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/transaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE7E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACpC;AAED,qBAAa,WAAY,YAAW,iBAAiB;IAcjD,QAAQ,CAAC,IAAI,EAAE,MAAM;IAbvB,QAAQ,CAAC,OAAO,SAAgB;IAChC,QAAQ,CAAC,UAAU,SAAe;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAGzC,IAAI,EAAE,MAAM,EACrB,IAAI,EAAE,kBAAkB;IAS1B,OAAO,CAAC,IAAI;IAmBZ,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAIvD;4GACwG;IACxG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAezF,MAAM,CAAC,KAAK,SAAe,GAAG,IAAI;IAMlC,oGAAoG;IACpG,SAAS,IAAI,IAAI;IAIjB,+FAA+F;IAC/F,OAAO,IAAI,YAAY;IAIvB,IAAI,IAAI,eAAe;CAaxB"}

package/dist/features/performance/trace/transaction.js

@@ -0,0 +1,90 @@
+/**
+ * Transaction + Span tree (RUM P1). A transaction is a timed root with a bounded tree of child spans
+ * (resource loads, long-tasks, user spans). Pure + dependency-free (injected clock → unit-testable
+ * without a browser). Bounds cardinality: caps spans per transaction, drop-counts overflow (no silent
+ * caps), and is idempotent on finish. Lazy chunk.
+ */
+import { newTraceId, newSpanId } from './context';
+import { NOOP_SPAN } from './types';
+export class Transaction {
+    constructor(name, opts) {
+        this.name = name;
+        this.traceId = newTraceId();
+        this.rootSpanId = newSpanId();
+        this.spans = [];
+        this.dropped = 0;
+        this.errors = 0;
+        this.clock = opts.clock;
+        this.maxSpans = opts.maxSpans ?? 1000;
+        this.sampled = opts.sampled ?? true;
+        this.onFinish = opts.onFinish;
+        this.startMs = this.clock();
+    }
+    open(op, parentSpanId, description) {
+        if (this.endMs != null || this.spans.length >= this.maxSpans) {
+            this.dropped++;
+            return NOOP_SPAN; // transaction already finished, or span budget exhausted
+        }
+        const span = { spanId: newSpanId(), parentSpanId, op, description, startMs: this.clock() };
+        this.spans.push(span);
+        const clock = this.clock;
+        return {
+            startChild: (childOp, childDesc) => this.open(childOp, span.spanId, childDesc),
+            finish: (endMs = clock()) => {
+                if (span.endMs == null)
+                    span.endMs = endMs;
+            },
+            setData: (key, value) => {
+                (span.data ?? (span.data = {}))[key] = value;
+            },
+        };
+    }
+    startSpan(op, description) {
+        return this.open(op, this.rootSpanId, description);
+    }
+    /** Add an already-measured span with EXPLICIT times (for retroactive entries that happened before
+     *  we could open a live span — long-tasks, LoAF, resources). Bounded + drop-counted like live spans. */
+    addSpan(op, startMs, endMs, data) {
+        if (this.endMs != null || this.spans.length >= this.maxSpans) {
+            this.dropped++;
+            return;
+        }
+        this.spans.push({
+            spanId: newSpanId(),
+            parentSpanId: this.rootSpanId,
+            op,
+            startMs: Math.round(startMs),
+            endMs: Math.round(endMs),
+            ...(data ? { data } : {}),
+        });
+    }
+    finish(endMs = this.clock()) {
+        if (this.endMs != null)
+            return; // idempotent
+        this.endMs = endMs;
+        this.onFinish(this);
+    }
+    /** Note that an error occurred during this transaction's window (drives correlation + sampling). */
+    noteError() {
+        if (this.endMs == null)
+            this.errors++;
+    }
+    /** The active trace context — read by the Network vertical (P5/N5 seam) to share the trace. */
+    context() {
+        return { traceId: this.traceId, spanId: this.rootSpanId, sampled: this.sampled };
+    }
+    data() {
+        return {
+            name: this.name,
+            traceId: this.traceId,
+            spanId: this.rootSpanId,
+            sampled: this.sampled,
+            startMs: this.startMs,
+            durationMs: Math.max(0, (this.endMs ?? this.startMs) - this.startMs),
+            spans: this.spans.slice(),
+            ...(this.dropped > 0 ? { droppedSpans: this.dropped } : {}),
+            ...(this.errors > 0 ? { errorCount: this.errors } : {}),
+        };
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/features/performance/trace/transaction.js.map

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

package/dist/features/performance/trace/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transaction/Span handle types + no-op singletons (RUM P1). Kept EAGER + tiny so the public API
+ * (`ScaleBun.startTransaction`) can always return a safe handle — even before the lazy trace engine
+ * has loaded — without pulling the engine into core. The engine (`transaction.ts`/`context.ts`) is a
+ * separate lazy chunk.
+ */
+export interface SpanHandle {
+    /** Open a child span under this one. */
+    startChild(op: string, description?: string): SpanHandle;
+    /** Close the span (defaults to now). Idempotent. */
+    finish(endMs?: number): void;
+    /** Attach arbitrary data to the span. */
+    setData(key: string, value: unknown): void;
+}
+export interface TransactionHandle {
+    /** Open a span under the transaction root. */
+    startSpan(op: string, description?: string): SpanHandle;
+    /** Close the transaction → emits a `performance` item with its span tree. Idempotent. */
+    finish(endMs?: number): void;
+}
+export declare const NOOP_SPAN: SpanHandle;
+export declare const NOOP_TXN: TransactionHandle;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/performance/trace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACzD,oDAAoD;IACpD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACxD,yFAAyF;IACzF,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,SAAS,EAAE,UAIvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,iBAGtB,CAAC"}

package/dist/features/performance/trace/types.js

@@ -0,0 +1,10 @@
+export const NOOP_SPAN = {
+    startChild: () => NOOP_SPAN,
+    finish() { },
+    setData() { },
+};
+export const NOOP_TXN = {
+    startSpan: () => NOOP_SPAN,
+    finish() { },
+};
+//# sourceMappingURL=types.js.map

package/dist/features/performance/trace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/features/performance/trace/types.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,SAAS,GAAe;IACnC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;IAC3B,MAAM,KAAI,CAAC;IACX,OAAO,KAAI,CAAC;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAsB;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;IAC1B,MAAM,KAAI,CAAC;CACZ,CAAC"}

package/dist/features/performance/traces.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Custom-trace registry — name-keyed spans for startTrace()/stopTrace(). Pure + dependency-free
+ * (takes a clock so it's unit-testable without a browser). Bounds cardinality: caps live spans,
+ * expires never-stopped spans via a TTL, and counts drops (no silent caps).
+ */
+export interface TraceOptions {
+    /** Max simultaneously-open spans before new starts are dropped. */
+    maxOpen?: number;
+    /** A span open longer than this (ms) is considered abandoned and discarded on the next op. */
+    ttlMs?: number;
+    /** Clock injection for tests (defaults to Date.now). */
+    clock?: () => number;
+}
+export interface TraceResult {
+    name: string;
+    /** Elapsed time in ms. */
+    durationMs: number;
+}
+export declare class TraceRegistry {
+    private readonly maxOpen;
+    private readonly ttlMs;
+    private readonly clock;
+    private readonly open;
+    private dropped;
+    constructor(opts?: TraceOptions);
+    /** Begin a span. Last-write-wins on a duplicate name; over-cap starts are dropped + counted. */
+    start(name: string): void;
+    /** End a span → its elapsed ms, or null if it was never started (or already expired). */
+    stop(name: string): TraceResult | null;
+    /** Drop spans that have been open past the TTL (a forgotten stopTrace must not leak). */
+    private expire;
+    /** Read + reset the dropped counter. */
+    takeDropped(): number;
+    clear(): void;
+}
+//# sourceMappingURL=traces.d.ts.map

package/dist/features/performance/traces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../../src/features/performance/traces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,YAAY;IAM/B,gGAAgG;IAChG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUzB,yFAAyF;IACzF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQtC,yFAAyF;IACzF,OAAO,CAAC,MAAM;IAUd,wCAAwC;IACxC,WAAW,IAAI,MAAM;IAMrB,KAAK,IAAI,IAAI;CAId"}

package/dist/features/performance/traces.js

@@ -0,0 +1,50 @@
+export class TraceRegistry {
+    constructor(opts) {
+        this.open = new Map(); // name → startTime
+        this.dropped = 0;
+        this.maxOpen = opts?.maxOpen ?? 100;
+        this.ttlMs = opts?.ttlMs ?? 60000;
+        this.clock = opts?.clock ?? Date.now;
+    }
+    /** Begin a span. Last-write-wins on a duplicate name; over-cap starts are dropped + counted. */
+    start(name) {
+        if (!name)
+            return;
+        this.expire();
+        if (!this.open.has(name) && this.open.size >= this.maxOpen) {
+            this.dropped++;
+            return;
+        }
+        this.open.set(name, this.clock());
+    }
+    /** End a span → its elapsed ms, or null if it was never started (or already expired). */
+    stop(name) {
+        this.expire();
+        const startedAt = this.open.get(name);
+        if (startedAt == null)
+            return null;
+        this.open.delete(name);
+        return { name, durationMs: this.clock() - startedAt };
+    }
+    /** Drop spans that have been open past the TTL (a forgotten stopTrace must not leak). */
+    expire() {
+        const t = this.clock();
+        for (const [name, startedAt] of this.open) {
+            if (t - startedAt > this.ttlMs) {
+                this.open.delete(name);
+                this.dropped++;
+            }
+        }
+    }
+    /** Read + reset the dropped counter. */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+    clear() {
+        this.open.clear();
+        this.dropped = 0;
+    }
+}
+//# sourceMappingURL=traces.js.map

package/dist/features/performance/traces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../../src/features/performance/traces.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAa;IAOxB,YAAY,IAAmB;QAHd,SAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,mBAAmB;QAC9D,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,SAAS,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;IACxD,CAAC;IAED,yFAAyF;IACjF,MAAM;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvB,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/features/profiler/ProfilerFeature.d.ts

@@ -0,0 +1,28 @@
+/**
+ * F-PROF — JS Self-Profiling (flame graphs). Captures a sampled call-stack trace via the W3C JS
+ * Self-Profiling API (`window.Profiler`) and ships it as a perf item (metric:'js_profile', the trace in
+ * metadata) — reusing the existing PerformanceMetric lane, so NO backend migration.
+ *
+ * OPT-IN (default off): profiling has a CPU cost, and `window.Profiler` only exists when the host page
+ * is served with `Document-Policy: js-profiling` — so this is an advanced, explicitly-enabled feature
+ * that degrades to a graceful no-op everywhere else. Short windows on demand (manual start/stop or
+ * around a known-slow operation). Zero third-party deps.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class ProfilerFeature implements IFeature {
+    readonly name = "profiler";
+    private ctx;
+    private active;
+    private profiler?;
+    private startedAt;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    /** Whether the JS Self-Profiling API is usable (host must send Document-Policy: js-profiling). */
+    available(): boolean;
+    /** Begin a profiling window. Returns false if unavailable or one is already running. */
+    start(sampleIntervalMs?: number): boolean;
+    /** Stop the window and ship the trace as a js_profile perf item. Returns false if none running. */
+    stop(): Promise<boolean>;
+    teardown(): void;
+}
+//# sourceMappingURL=ProfilerFeature.d.ts.map

package/dist/features/profiler/ProfilerFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfilerFeature.d.ts","sourceRoot":"","sources":["../../../src/features/profiler/ProfilerFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkBxE,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAK;IAEtB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKhC,kGAAkG;IAClG,SAAS,IAAI,OAAO;IAIpB,wFAAwF;IACxF,KAAK,CAAC,gBAAgB,SAAK,GAAG,OAAO;IAarC,mGAAmG;IAC7F,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAuB9B,QAAQ,IAAI,IAAI;CAYjB"}