catalyst-core 0.2.0-beta.3 → 0.3.0-beta.1

package/dist/native/bridge/perf/core/summary.js

@@ -1 +1,174 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buildSummary=buildSummary;const SLOW_MS={interaction:300,request:500,nativeApi:150,render:50};function round(value){return Number.isFinite(value)?Math.round(value):value;}function durationOf(record){if(Number.isFinite(record?.durationMs))return record.durationMs;if(Number.isFinite(record?.startTime)&&Number.isFinite(record?.endTime)){return Math.max(0,record.endTime-record.startTime);}return 0;}function byDurationDesc(a,b){return durationOf(b)-durationOf(a);}function overlaps(record,start,end,padding=0){if(!Number.isFinite(start)||!Number.isFinite(end))return false;const recordStart=record.startTime??0;const recordEnd=record.endTime??recordStart;return recordStart<end+padding&&recordEnd>=start-padding;}function top(records,count=5){return[...records].sort(byDurationDesc).slice(0,count);}function countBy(records,key){return records.reduce((acc,record)=>{const value=record?.[key]??"unknown";acc[value]=(acc[value]??0)+1;return acc;},{});}function summarizeInteraction(interaction,data){const start=interaction.startTime;const end=interaction.endTime;const sessionId=interaction.sessionId??interaction.detail?.sessionId;const related=(record,padding=150)=>{const detail=record.detail??{};return detail.sessionId===sessionId||detail.interactionId===sessionId||record.sessionId===sessionId||record.interactionId===sessionId||overlaps(record,start,end,padding);};const requests=data.requests.filter(request=>related(request));const render=data.metrics.filter(metric=>["fps-drop","long-task","loaf","layout-shift"].includes(metric.kind)).filter(metric=>related(metric,300));const insights=data.insights.filter(insight=>related(insight,300));const nativeApiTime=requests.filter(request=>request.kind==="native-api").reduce((total,request)=>total+durationOf(request),0);const networkTime=requests.filter(request=>request.kind==="network").reduce((total,request)=>total+durationOf(request),0);const slowestRequest=top(requests,1)[0]??null;return{id:interaction.id,label:interaction.label,target:interaction.target??interaction.detail?.target??null,startTime:round(start),durationMs:round(durationOf(interaction)),requestCount:requests.length,renderIssueCount:render.length,insightCount:insights.length,nativeApiTimeMs:round(nativeApiTime),networkTimeMs:round(networkTime),slowestRequest:slowestRequest?{id:slowestRequest.id,kind:slowestRequest.kind,label:slowestRequest.label,durationMs:round(durationOf(slowestRequest))}:null,severity:durationOf(interaction)>=SLOW_MS.interaction||render.length>0||insights.length>0?"warning":"ok"};}function buildFindings(data,interactionSummaries){const findings=[];const slowInteractions=interactionSummaries.filter(interaction=>interaction.durationMs>=SLOW_MS.interaction);const slowRequests=data.requests.filter(request=>durationOf(request)>=SLOW_MS.request);const slowNativeApi=data.requests.filter(request=>request.kind==="native-api"&&durationOf(request)>=SLOW_MS.nativeApi);const renderIssues=data.metrics.filter(metric=>["fps-drop","long-task","loaf","layout-shift"].includes(metric.kind));const cacheMisses=data.requests.filter(request=>request.cacheStatus==="miss");if(slowInteractions.length>0){findings.push({severity:"warning",title:`${slowInteractions.length} slow interaction${slowInteractions.length===1?"":"s"}`,detail:`${slowInteractions[0].label} took ${slowInteractions[0].durationMs}ms`});}if(slowRequests.length>0){const slowest=top(slowRequests,1)[0];findings.push({severity:"warning",title:`${slowRequests.length} slow request${slowRequests.length===1?"":"s"}`,detail:`${slowest.label} took ${round(durationOf(slowest))}ms`});}if(slowNativeApi.length>0){const slowest=top(slowNativeApi,1)[0];findings.push({severity:"warning",title:`${slowNativeApi.length} slow native call${slowNativeApi.length===1?"":"s"}`,detail:`${slowest.label} took ${round(durationOf(slowest))}ms`});}if(renderIssues.length>0){findings.push({severity:"warning",title:`${renderIssues.length} render issue${renderIssues.length===1?"":"s"}`,detail:renderIssues[0].label});}if(cacheMisses.length>0){findings.push({severity:"info",title:`${cacheMisses.length} cache miss${cacheMisses.length===1?"":"es"}`,detail:cacheMisses[0].label});}return findings;}function buildSummary(data){const sessions=data.sessions??[];const requests=data.requests??[];const metrics=data.metrics??[];const events=data.events??[];const insights=data.insights??[];const interactions=sessions.filter(session=>session.kind==="interaction");const renderIssues=metrics.filter(metric=>["fps-drop","long-task","loaf","layout-shift"].includes(metric.kind));const memory=metrics.find(metric=>metric.kind==="memory-summary")??null;const interactionSummaries=top(interactions,10).map(interaction=>summarizeInteraction(interaction,data));return{generatedAt:new Date().toISOString(),counts:{events:events.length,sessions:sessions.length,requests:requests.length,metrics:metrics.length,insights:insights.length},byKind:{sessions:countBy(sessions,"kind"),requests:countBy(requests,"kind"),metrics:countBy(metrics,"kind")},slowest:{interactions:top(interactions).map(record=>({id:record.id,label:record.label,durationMs:round(durationOf(record))})),requests:top(requests).map(record=>({id:record.id,kind:record.kind,label:record.label,durationMs:round(durationOf(record))})),render:top(renderIssues).map(record=>({id:record.id,kind:record.kind,label:record.label,durationMs:round(durationOf(record))}))},interactions:interactionSummaries,memory:memory?{label:memory.label,latest:memory.detail?.latest??{},peak:memory.detail?.peak??{},sampleCount:memory.detail?.sampleCount??0}:null,findings:buildFindings(data,interactionSummaries)};}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildSummary = buildSummary;
+const SLOW_MS = {
+  interaction: 300,
+  request: 500,
+  nativeApi: 150,
+  render: 50
+};
+function round(value) {
+  return Number.isFinite(value) ? Math.round(value) : value;
+}
+function durationOf(record) {
+  if (Number.isFinite(record?.durationMs)) return record.durationMs;
+  if (Number.isFinite(record?.startTime) && Number.isFinite(record?.endTime)) {
+    return Math.max(0, record.endTime - record.startTime);
+  }
+  return 0;
+}
+function byDurationDesc(a, b) {
+  return durationOf(b) - durationOf(a);
+}
+function overlaps(record, start, end, padding = 0) {
+  if (!Number.isFinite(start) || !Number.isFinite(end)) return false;
+  const recordStart = record.startTime ?? 0;
+  const recordEnd = record.endTime ?? recordStart;
+  return recordStart < end + padding && recordEnd >= start - padding;
+}
+function top(records, count = 5) {
+  return [...records].sort(byDurationDesc).slice(0, count);
+}
+function countBy(records, key) {
+  return records.reduce((acc, record) => {
+    const value = record?.[key] ?? "unknown";
+    acc[value] = (acc[value] ?? 0) + 1;
+    return acc;
+  }, {});
+}
+function summarizeInteraction(interaction, data) {
+  const start = interaction.startTime;
+  const end = interaction.endTime;
+  const sessionId = interaction.sessionId ?? interaction.detail?.sessionId;
+  const related = (record, padding = 150) => {
+    const detail = record.detail ?? {};
+    return detail.sessionId === sessionId || detail.interactionId === sessionId || record.sessionId === sessionId || record.interactionId === sessionId || overlaps(record, start, end, padding);
+  };
+  const requests = data.requests.filter(request => related(request));
+  const render = data.metrics.filter(metric => ["fps-drop", "long-task", "loaf", "layout-shift"].includes(metric.kind)).filter(metric => related(metric, 300));
+  const insights = data.insights.filter(insight => related(insight, 300));
+  const nativeApiTime = requests.filter(request => request.kind === "native-api").reduce((total, request) => total + durationOf(request), 0);
+  const networkTime = requests.filter(request => request.kind === "network").reduce((total, request) => total + durationOf(request), 0);
+  const slowestRequest = top(requests, 1)[0] ?? null;
+  return {
+    id: interaction.id,
+    label: interaction.label,
+    target: interaction.target ?? interaction.detail?.target ?? null,
+    startTime: round(start),
+    durationMs: round(durationOf(interaction)),
+    requestCount: requests.length,
+    renderIssueCount: render.length,
+    insightCount: insights.length,
+    nativeApiTimeMs: round(nativeApiTime),
+    networkTimeMs: round(networkTime),
+    slowestRequest: slowestRequest ? {
+      id: slowestRequest.id,
+      kind: slowestRequest.kind,
+      label: slowestRequest.label,
+      durationMs: round(durationOf(slowestRequest))
+    } : null,
+    severity: durationOf(interaction) >= SLOW_MS.interaction || render.length > 0 || insights.length > 0 ? "warning" : "ok"
+  };
+}
+function buildFindings(data, interactionSummaries) {
+  const findings = [];
+  const slowInteractions = interactionSummaries.filter(interaction => interaction.durationMs >= SLOW_MS.interaction);
+  const slowRequests = data.requests.filter(request => durationOf(request) >= SLOW_MS.request);
+  const slowNativeApi = data.requests.filter(request => request.kind === "native-api" && durationOf(request) >= SLOW_MS.nativeApi);
+  const renderIssues = data.metrics.filter(metric => ["fps-drop", "long-task", "loaf", "layout-shift"].includes(metric.kind));
+  const cacheMisses = data.requests.filter(request => request.cacheStatus === "miss");
+  if (slowInteractions.length > 0) {
+    findings.push({
+      severity: "warning",
+      title: `${slowInteractions.length} slow interaction${slowInteractions.length === 1 ? "" : "s"}`,
+      detail: `${slowInteractions[0].label} took ${slowInteractions[0].durationMs}ms`
+    });
+  }
+  if (slowRequests.length > 0) {
+    const slowest = top(slowRequests, 1)[0];
+    findings.push({
+      severity: "warning",
+      title: `${slowRequests.length} slow request${slowRequests.length === 1 ? "" : "s"}`,
+      detail: `${slowest.label} took ${round(durationOf(slowest))}ms`
+    });
+  }
+  if (slowNativeApi.length > 0) {
+    const slowest = top(slowNativeApi, 1)[0];
+    findings.push({
+      severity: "warning",
+      title: `${slowNativeApi.length} slow native call${slowNativeApi.length === 1 ? "" : "s"}`,
+      detail: `${slowest.label} took ${round(durationOf(slowest))}ms`
+    });
+  }
+  if (renderIssues.length > 0) {
+    findings.push({
+      severity: "warning",
+      title: `${renderIssues.length} render issue${renderIssues.length === 1 ? "" : "s"}`,
+      detail: renderIssues[0].label
+    });
+  }
+  if (cacheMisses.length > 0) {
+    findings.push({
+      severity: "info",
+      title: `${cacheMisses.length} cache miss${cacheMisses.length === 1 ? "" : "es"}`,
+      detail: cacheMisses[0].label
+    });
+  }
+  return findings;
+}
+function buildSummary(data) {
+  const sessions = data.sessions ?? [];
+  const requests = data.requests ?? [];
+  const metrics = data.metrics ?? [];
+  const events = data.events ?? [];
+  const insights = data.insights ?? [];
+  const interactions = sessions.filter(session => session.kind === "interaction");
+  const renderIssues = metrics.filter(metric => ["fps-drop", "long-task", "loaf", "layout-shift"].includes(metric.kind));
+  const memory = metrics.find(metric => metric.kind === "memory-summary") ?? null;
+  const interactionSummaries = top(interactions, 10).map(interaction => summarizeInteraction(interaction, data));
+  return {
+    generatedAt: new Date().toISOString(),
+    counts: {
+      events: events.length,
+      sessions: sessions.length,
+      requests: requests.length,
+      metrics: metrics.length,
+      insights: insights.length
+    },
+    byKind: {
+      sessions: countBy(sessions, "kind"),
+      requests: countBy(requests, "kind"),
+      metrics: countBy(metrics, "kind")
+    },
+    slowest: {
+      interactions: top(interactions).map(record => ({
+        id: record.id,
+        label: record.label,
+        durationMs: round(durationOf(record))
+      })),
+      requests: top(requests).map(record => ({
+        id: record.id,
+        kind: record.kind,
+        label: record.label,
+        durationMs: round(durationOf(record))
+      })),
+      render: top(renderIssues).map(record => ({
+        id: record.id,
+        kind: record.kind,
+        label: record.label,
+        durationMs: round(durationOf(record))
+      }))
+    },
+    interactions: interactionSummaries,
+    memory: memory ? {
+      label: memory.label,
+      latest: memory.detail?.latest ?? {},
+      peak: memory.detail?.peak ?? {},
+      sampleCount: memory.detail?.sampleCount ?? 0
+    } : null,
+    findings: buildFindings(data, interactionSummaries)
+  };
+}

package/dist/native/bridge/perf/core/traceExport.js

@@ -1 +1,240 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buildChromeTrace=buildChromeTrace;exports.downloadChromeTrace=downloadChromeTrace;const THREADS={navigation:1,input:2,render:3,memory:4,network:5,nativeApi:6,insights:7,events:8};const THREAD_NAMES={[THREADS.navigation]:"Navigation",[THREADS.input]:"Input",[THREADS.render]:"Render",[THREADS.memory]:"Memory",[THREADS.network]:"Network / Cache",[THREADS.nativeApi]:"Native API execution",[THREADS.insights]:"Insights",[THREADS.events]:"Events"};function us(ms){return Math.max(0,Math.round((Number(ms)||0)*1000));}function durationMs(record){if(Number.isFinite(record.durationMs))return Math.max(0.001,record.durationMs);if(Number.isFinite(record.startTime)&&Number.isFinite(record.endTime)){return Math.max(0.001,record.endTime-record.startTime);}return 0.001;}function label(record,fallback){return record.label??record.title??record.name??record.type??record.kind??fallback;}function detail(record){const source=record.detail??record;const relatedTap=record.interactionId??record.sessionId??source.interactionId??source.sessionId;return relatedTap?{relatedTap,...source}:source;}function displayLabel(record,fallback){const base=label(record,fallback);const source=record.detail??record;const relatedTap=record.interactionId??record.sessionId??source.interactionId??source.sessionId;if(!relatedTap)return base;if(record.kind==="interaction")return`${relatedTap}: ${record.target??source.target??base}`;return base.startsWith(`[${relatedTap}]`)?base:`[${relatedTap}] ${base}`;}function sessionThread(kind){if(kind==="page-load"||kind==="route")return THREADS.navigation;if(kind==="scroll"||kind==="keyboard"||kind==="interaction")return THREADS.input;if(kind==="hw-accel"||kind==="hook")return THREADS.render;return THREADS.events;}function requestThread(kind){if(kind==="native-api")return THREADS.nativeApi;return THREADS.network;}function metricThread(kind){if(kind==="memory"||kind==="memory-summary")return THREADS.memory;if(kind==="startup"||kind==="paint")return THREADS.navigation;return THREADS.render;}function addMetadata(events,pid){events.push({ph:"M",pid,tid:0,name:"process_name",args:{name:"Catalyst"}});for(const[tid,name]of Object.entries(THREAD_NAMES)){events.push({ph:"M",pid,tid:Number(tid),name:"thread_name",args:{name}});}}function addDuration(events,record,tid,category,fallbackName){const startTime=record.startTime??record.time??0;events.push({name:displayLabel(record,fallbackName),cat:category,ph:"X",ts:us(startTime),dur:us(durationMs(record)),pid:1,tid,args:detail(record)});}function addInstant(events,record,tid,category,fallbackName){events.push({name:displayLabel(record,fallbackName),cat:category,ph:"i",s:"t",ts:us(record.startTime??record.time??0),pid:1,tid,args:detail(record)});}function addTapMarker(events,session){const source=session.detail??session;const tap=session.interactionId??session.sessionId??source.interactionId??source.sessionId;if(!tap)return;events.push({name:`${tap}: ${session.target??source.target??"interaction"}`,cat:"Catalyst Interaction",ph:"i",s:"g",ts:us(session.startTime??0),pid:1,tid:THREADS.input,args:{relatedTap:tap,target:session.target??source.target??"unknown"}});}function addCounter(events,record){const args={};const source=record.detail??record;for(const key of["jvmMb","webviewMb","nativeMb","otherMb","totalMb","peakMb"]){if(Number.isFinite(source[key]))args[key]=source[key];}if(Object.keys(args).length===0&&Number.isFinite(record.value)){args.value=record.value;}events.push({name:label(record,"Memory"),cat:"Catalyst Memory",ph:"C",ts:us(record.startTime??record.time??0),pid:1,tid:THREADS.memory,args});}function buildChromeTrace(data){const traceEvents=[];addMetadata(traceEvents,1);for(const session of data.sessions??[]){addDuration(traceEvents,session,sessionThread(session.kind),`Catalyst ${session.kind}`,"Session");if(session.kind==="interaction")addTapMarker(traceEvents,session);}for(const request of data.requests??[]){addDuration(traceEvents,request,requestThread(request.kind),`Catalyst ${request.kind}`,"Request");}const hasMemorySamples=(data.metrics??[]).some(metric=>metric.kind==="memory");for(const metric of data.metrics??[]){if(metric.kind==="memory-summary"&&hasMemorySamples)continue;if(metric.kind==="memory"||metric.kind==="memory-summary"){addCounter(traceEvents,metric);}else{addDuration(traceEvents,metric,metricThread(metric.kind),`Catalyst ${metric.kind}`,"Metric");}}for(const event of data.events??[]){addInstant(traceEvents,event,THREADS.events,`Catalyst ${event.kind??"event"}`,"Event");}for(const insight of data.insights??[]){addInstant(traceEvents,insight,THREADS.insights,"Catalyst Insights","Insight");}return{traceEvents:traceEvents.sort((a,b)=>(a.ts??0)-(b.ts??0)),metadata:{source:"CatalystPerf",createdAt:new Date().toISOString(),storeCreatedAt:data.createdAt??null,version:data.version??1}};}function downloadChromeTrace(data,filename){const trace=buildChromeTrace(data);const traceJson=JSON.stringify(trace);const resolvedFilename=filename??`catalyst-trace-${new Date().toISOString().replace(/[:.]/g,"-")}.json`;const eventCount=trace.traceEvents.length;const isIOSNative=typeof window!=="undefined"&&!!window.webkit?.messageHandlers?.NativeBridge;const isAndroidNative=typeof window!=="undefined"&&!!window.NativeBridge;if(typeof console!=="undefined"){console.info(`[CatalystPerf] Trace ready: ${resolvedFilename} (${eventCount} events)`);}if(isIOSNative){window.webkit.messageHandlers.NativeBridge.postMessage({command:"exportCatalystTrace",data:{filename:resolvedFilename,trace:traceJson}});if(typeof console!=="undefined"){console.info(`[CatalystPerf] Sent ${resolvedFilename} to the iOS share sheet.`);}return;}if(isAndroidNative){return;}if(typeof document==="undefined"||typeof Blob==="undefined"||typeof URL==="undefined"){return;}const link=document.createElement("a");if(!("download"in link)){if(typeof console!=="undefined"){console.warn("[CatalystPerf] Browser does not support blob downloads. Use CatalystPerf.trace() instead.");}return;}const blob=new Blob([traceJson],{type:"application/json"});const url=URL.createObjectURL(blob);link.href=url;link.download=resolvedFilename;document.body.appendChild(link);link.click();link.remove();setTimeout(()=>URL.revokeObjectURL(url),30000);if(typeof console!=="undefined"){console.info(`[CatalystPerf] Download started. Check your browser Downloads for ${resolvedFilename}.`);}}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildChromeTrace = buildChromeTrace;
+exports.downloadChromeTrace = downloadChromeTrace;
+const THREADS = {
+  navigation: 1,
+  input: 2,
+  render: 3,
+  memory: 4,
+  network: 5,
+  nativeApi: 6,
+  insights: 7,
+  events: 8
+};
+const THREAD_NAMES = {
+  [THREADS.navigation]: "Navigation",
+  [THREADS.input]: "Input",
+  [THREADS.render]: "Render",
+  [THREADS.memory]: "Memory",
+  [THREADS.network]: "Network / Cache",
+  [THREADS.nativeApi]: "Native API execution",
+  [THREADS.insights]: "Insights",
+  [THREADS.events]: "Events"
+};
+function us(ms) {
+  return Math.max(0, Math.round((Number(ms) || 0) * 1000));
+}
+function durationMs(record) {
+  if (Number.isFinite(record.durationMs)) return Math.max(0.001, record.durationMs);
+  if (Number.isFinite(record.startTime) && Number.isFinite(record.endTime)) {
+    return Math.max(0.001, record.endTime - record.startTime);
+  }
+  return 0.001;
+}
+function label(record, fallback) {
+  return record.label ?? record.title ?? record.name ?? record.type ?? record.kind ?? fallback;
+}
+function detail(record) {
+  const source = record.detail ?? record;
+  const relatedTap = record.interactionId ?? record.sessionId ?? source.interactionId ?? source.sessionId;
+  return relatedTap ? {
+    relatedTap,
+    ...source
+  } : source;
+}
+function displayLabel(record, fallback) {
+  const base = label(record, fallback);
+  const source = record.detail ?? record;
+  const relatedTap = record.interactionId ?? record.sessionId ?? source.interactionId ?? source.sessionId;
+  if (!relatedTap) return base;
+  if (record.kind === "interaction") return `${relatedTap}: ${record.target ?? source.target ?? base}`;
+  return base.startsWith(`[${relatedTap}]`) ? base : `[${relatedTap}] ${base}`;
+}
+function sessionThread(kind) {
+  if (kind === "page-load" || kind === "route") return THREADS.navigation;
+  if (kind === "scroll" || kind === "keyboard" || kind === "interaction") return THREADS.input;
+  if (kind === "hw-accel" || kind === "hook") return THREADS.render;
+  return THREADS.events;
+}
+function requestThread(kind) {
+  if (kind === "native-api") return THREADS.nativeApi;
+  return THREADS.network;
+}
+function metricThread(kind) {
+  if (kind === "memory" || kind === "memory-summary") return THREADS.memory;
+  if (kind === "startup" || kind === "paint") return THREADS.navigation;
+  return THREADS.render;
+}
+function addMetadata(events, pid) {
+  events.push({
+    ph: "M",
+    pid,
+    tid: 0,
+    name: "process_name",
+    args: {
+      name: "Catalyst"
+    }
+  });
+  for (const [tid, name] of Object.entries(THREAD_NAMES)) {
+    events.push({
+      ph: "M",
+      pid,
+      tid: Number(tid),
+      name: "thread_name",
+      args: {
+        name
+      }
+    });
+  }
+}
+function addDuration(events, record, tid, category, fallbackName) {
+  const startTime = record.startTime ?? record.time ?? 0;
+  events.push({
+    name: displayLabel(record, fallbackName),
+    cat: category,
+    ph: "X",
+    ts: us(startTime),
+    dur: us(durationMs(record)),
+    pid: 1,
+    tid,
+    args: detail(record)
+  });
+}
+function addInstant(events, record, tid, category, fallbackName) {
+  events.push({
+    name: displayLabel(record, fallbackName),
+    cat: category,
+    ph: "i",
+    s: "t",
+    ts: us(record.startTime ?? record.time ?? 0),
+    pid: 1,
+    tid,
+    args: detail(record)
+  });
+}
+function addTapMarker(events, session) {
+  const source = session.detail ?? session;
+  const tap = session.interactionId ?? session.sessionId ?? source.interactionId ?? source.sessionId;
+  if (!tap) return;
+  events.push({
+    name: `${tap}: ${session.target ?? source.target ?? "interaction"}`,
+    cat: "Catalyst Interaction",
+    ph: "i",
+    s: "g",
+    ts: us(session.startTime ?? 0),
+    pid: 1,
+    tid: THREADS.input,
+    args: {
+      relatedTap: tap,
+      target: session.target ?? source.target ?? "unknown"
+    }
+  });
+}
+function addCounter(events, record) {
+  const args = {};
+  const source = record.detail ?? record;
+  for (const key of ["jvmMb", "webviewMb", "nativeMb", "otherMb", "totalMb", "peakMb"]) {
+    if (Number.isFinite(source[key])) args[key] = source[key];
+  }
+  if (Object.keys(args).length === 0 && Number.isFinite(record.value)) {
+    args.value = record.value;
+  }
+  events.push({
+    name: label(record, "Memory"),
+    cat: "Catalyst Memory",
+    ph: "C",
+    ts: us(record.startTime ?? record.time ?? 0),
+    pid: 1,
+    tid: THREADS.memory,
+    args
+  });
+}
+function buildChromeTrace(data) {
+  const traceEvents = [];
+  addMetadata(traceEvents, 1);
+  for (const session of data.sessions ?? []) {
+    addDuration(traceEvents, session, sessionThread(session.kind), `Catalyst ${session.kind}`, "Session");
+    if (session.kind === "interaction") addTapMarker(traceEvents, session);
+  }
+  for (const request of data.requests ?? []) {
+    addDuration(traceEvents, request, requestThread(request.kind), `Catalyst ${request.kind}`, "Request");
+  }
+  const hasMemorySamples = (data.metrics ?? []).some(metric => metric.kind === "memory");
+  for (const metric of data.metrics ?? []) {
+    if (metric.kind === "memory-summary" && hasMemorySamples) continue;
+    if (metric.kind === "memory" || metric.kind === "memory-summary") {
+      addCounter(traceEvents, metric);
+    } else {
+      addDuration(traceEvents, metric, metricThread(metric.kind), `Catalyst ${metric.kind}`, "Metric");
+    }
+  }
+  for (const event of data.events ?? []) {
+    addInstant(traceEvents, event, THREADS.events, `Catalyst ${event.kind ?? "event"}`, "Event");
+  }
+  for (const insight of data.insights ?? []) {
+    addInstant(traceEvents, insight, THREADS.insights, "Catalyst Insights", "Insight");
+  }
+  return {
+    traceEvents: traceEvents.sort((a, b) => (a.ts ?? 0) - (b.ts ?? 0)),
+    metadata: {
+      source: "CatalystPerf",
+      createdAt: new Date().toISOString(),
+      storeCreatedAt: data.createdAt ?? null,
+      version: data.version ?? 1
+    }
+  };
+}
+function downloadChromeTrace(data, filename) {
+  const trace = buildChromeTrace(data);
+  const traceJson = JSON.stringify(trace);
+  const resolvedFilename = filename ?? `catalyst-trace-${new Date().toISOString().replace(/[:.]/g, "-")}.json`;
+  const eventCount = trace.traceEvents.length;
+  const isIOSNative = typeof window !== "undefined" && !!window.webkit?.messageHandlers?.NativeBridge;
+  const isAndroidNative = typeof window !== "undefined" && !!window.NativeBridge;
+  if (typeof console !== "undefined") {
+    console.info(`[CatalystPerf] Trace ready: ${resolvedFilename} (${eventCount} events)`);
+  }
+  if (isIOSNative) {
+    window.webkit.messageHandlers.NativeBridge.postMessage({
+      command: "exportCatalystTrace",
+      data: {
+        filename: resolvedFilename,
+        trace: traceJson
+      }
+    });
+    if (typeof console !== "undefined") {
+      console.info(`[CatalystPerf] Sent ${resolvedFilename} to the iOS share sheet.`);
+    }
+    return;
+  }
+  if (isAndroidNative) {
+    return;
+  }
+  if (typeof document === "undefined" || typeof Blob === "undefined" || typeof URL === "undefined") {
+    return;
+  }
+  const link = document.createElement("a");
+  if (!("download" in link)) {
+    if (typeof console !== "undefined") {
+      console.warn("[CatalystPerf] Browser does not support blob downloads. Use CatalystPerf.trace() instead.");
+    }
+    return;
+  }
+  const blob = new Blob([traceJson], {
+    type: "application/json"
+  });
+  const url = URL.createObjectURL(blob);
+  link.href = url;
+  link.download = resolvedFilename;
+  document.body.appendChild(link);
+  link.click();
+  link.remove();
+  setTimeout(() => URL.revokeObjectURL(url), 30000);
+  if (typeof console !== "undefined") {
+    console.info(`[CatalystPerf] Download started. Check your browser Downloads for ${resolvedFilename}.`);
+  }
+}

package/dist/native/bridge/perf/core/waterfalls.js

@@ -1 +1,146 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:true});exports.buildWaterfall=buildWaterfall;exports.listWaterfalls=listWaterfalls;const REQUEST_LANES=new Set(["network","cache","native-api"]);function durationOf(row){if(Number.isFinite(row.durationMs))return row.durationMs;if(Number.isFinite(row.startTime)&&Number.isFinite(row.endTime)){return Math.max(0,Math.round(row.endTime-row.startTime));}return null;}function toRow(record,lane,group=null){const startTime=record.startTime??record.time??0;const endTime=record.endTime??startTime;return{id:record.id,lane,group,kind:record.kind??record.type??lane,label:record.label??record.name??record.type??record.kind??lane,startTime,endTime,durationMs:durationOf({...record,startTime,endTime}),severity:record.severity??null,detail:record.detail??record};}function byStartTime(a,b){return(a.startTime??0)-(b.startTime??0);}function overlaps(row,start,end){if(!Number.isFinite(start)||!Number.isFinite(end))return false;const rowStart=row.startTime??0;const rowEnd=row.endTime??rowStart;return rowStart<end&&rowEnd>=start;}function isStandaloneEvent(event){return event.kind==="startup"||event.type==="navigation-back"||event.type==="page-load-error";}function isTimelineMetric(metric){return metric.kind!=="memory"&&metric.kind!=="memory-summary";}function rowsForWindow(data,start,end,group){return[...data.sessions.map(session=>toRow(session,session.kind,group)),...data.requests.map(request=>toRow(request,request.kind,group)),...data.metrics.filter(isTimelineMetric).map(metric=>toRow(metric,metric.kind,group)),...data.events.filter(isStandaloneEvent).map(event=>toRow(event,event.kind??"event",group)),...data.insights.map(insight=>toRow(insight,"insight",group))].filter(row=>overlaps(row,start,end)).sort(byStartTime);}function buildPageLoadWaterfall(data){const pageLoads=data.sessions.filter(session=>session.kind==="page-load");if(pageLoads.length===0){return[...data.events.filter(event=>event.kind==="startup"||event.type?.startsWith("boot-")).map(event=>toRow(event,"startup","page-load")),...data.metrics.filter(metric=>metric.kind==="paint"||metric.kind==="startup").map(metric=>toRow(metric,metric.kind,"page-load"))].sort(byStartTime);}return pageLoads.flatMap((pageLoad,index)=>{const group=pageLoad.label;const startupRows=index===0?data.events.filter(event=>event.kind==="startup"&&(event.startTime??0)<=pageLoad.endTime).map(event=>toRow(event,"startup",group)):[];return[...startupRows,toRow(pageLoad,"page-load",group),...rowsForWindow(data,pageLoad.startTime,pageLoad.endTime,group).filter(row=>row.id!==pageLoad.id)];}).sort(byStartTime);}function buildRouteWaterfall(data){const routes=data.sessions.filter(session=>session.kind==="route");return routes.flatMap(route=>[toRow(route,"route",route.label),...rowsForWindow(data,route.startTime,route.endTime+1000,route.label).filter(row=>row.id!==route.id)]).sort(byStartTime);}function buildRequestWaterfall(data){return data.requests.filter(request=>REQUEST_LANES.has(request.kind)).map(request=>toRow(request,request.kind,request.sessionId??request.navigationId??null)).sort(byStartTime);}function buildNativeApiWaterfall(data){return data.requests.filter(request=>request.kind==="native-api").map(request=>toRow(request,request.kind,request.sessionId??null)).sort(byStartTime);}function buildInteractionWaterfall(data){const interactions=data.sessions.filter(session=>session.kind==="interaction");return interactions.flatMap(interaction=>{const group=interaction.label;const matchingSession=row=>{const detail=row.detail??{};return detail.sessionId===interaction.sessionId||detail.interactionId===interaction.sessionId||overlaps(row,interaction.startTime,interaction.endTime);};return[toRow(interaction,"interaction",group),...[...data.requests.map(request=>toRow(request,request.kind,group)),...data.metrics.filter(isTimelineMetric).map(metric=>toRow(metric,metric.kind,group)),...data.insights.map(insight=>toRow(insight,"insight",group))].filter(row=>row.id!==interaction.id&&matchingSession(row))];}).sort(byStartTime);}function buildRenderJankWaterfall(data){const renderKinds=new Set(["fps-drop","long-task","loaf","layout-shift","hw-accel"]);return[...data.metrics.filter(metric=>renderKinds.has(metric.kind)).map(metric=>toRow(metric,"render",metric.context??null)),...data.sessions.filter(session=>session.kind==="hw-accel").map(session=>toRow(session,"render",session.detail?.trigger??null))].sort(byStartTime);}function buildScrollWaterfall(data){const scrolls=data.sessions.filter(session=>session.kind==="scroll");return scrolls.flatMap(scroll=>[toRow(scroll,"scroll",scroll.label),...rowsForWindow(data,scroll.startTime,scroll.endTime,scroll.label).filter(row=>row.id!==scroll.id&&["fps-drop","long-task","loaf","layout-shift","insight"].includes(row.kind))]).sort(byStartTime);}function buildKeyboardWaterfall(data){const keyboards=data.sessions.filter(session=>session.kind==="keyboard");return keyboards.flatMap(keyboard=>[toRow(keyboard,"keyboard",keyboard.label),...rowsForWindow(data,keyboard.startTime,keyboard.endTime,keyboard.label).filter(row=>row.id!==keyboard.id&&["viewport-resize","scroll","layout-shift","insight"].includes(row.kind))]).sort(byStartTime);}function buildCacheWaterfall(data){return[...data.requests.filter(request=>request.kind==="cache").map(request=>toRow(request,"cache",request.cacheStatus??null)),...data.metrics.filter(metric=>metric.kind==="cache-summary").map(metric=>toRow(metric,"cache-summary"))].sort(byStartTime);}function buildMemoryTimeline(data){return data.metrics.filter(metric=>metric.kind==="memory"||metric.kind==="memory-summary").map(metric=>toRow(metric,"memory")).sort(byStartTime);}function buildAllWaterfall(data){return[...data.sessions.map(session=>toRow(session,session.kind)),...data.requests.map(request=>toRow(request,request.kind)),...data.metrics.filter(isTimelineMetric).map(metric=>toRow(metric,metric.kind)),...data.events.filter(isStandaloneEvent).map(event=>toRow(event,event.kind??"event")),...data.insights.map(insight=>toRow(insight,"insight"))].sort(byStartTime);}function buildWaterfall(data,type="all"){switch(type){case"page-load":case"page":return buildPageLoadWaterfall(data);case"route":case"navigation":return buildRouteWaterfall(data);case"requests":case"request":return buildRequestWaterfall(data);case"native-bridge":case"bridge":case"api":case"native-api":return buildNativeApiWaterfall(data);case"interactions":case"interaction":return buildInteractionWaterfall(data);case"render":case"jank":case"render-jank":return buildRenderJankWaterfall(data);case"scroll":return buildScrollWaterfall(data);case"keyboard":case"input":return buildKeyboardWaterfall(data);case"cache":return buildCacheWaterfall(data);case"memory":return buildMemoryTimeline(data);case"all":default:return buildAllWaterfall(data);}}function listWaterfalls(){return["page-load","navigation","requests","native-api","interactions","render-jank","scroll","keyboard","cache","memory","all"];}
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildWaterfall = buildWaterfall;
+exports.listWaterfalls = listWaterfalls;
+const REQUEST_LANES = new Set(["network", "cache", "native-api"]);
+function durationOf(row) {
+  if (Number.isFinite(row.durationMs)) return row.durationMs;
+  if (Number.isFinite(row.startTime) && Number.isFinite(row.endTime)) {
+    return Math.max(0, Math.round(row.endTime - row.startTime));
+  }
+  return null;
+}
+function toRow(record, lane, group = null) {
+  const startTime = record.startTime ?? record.time ?? 0;
+  const endTime = record.endTime ?? startTime;
+  return {
+    id: record.id,
+    lane,
+    group,
+    kind: record.kind ?? record.type ?? lane,
+    label: record.label ?? record.name ?? record.type ?? record.kind ?? lane,
+    startTime,
+    endTime,
+    durationMs: durationOf({
+      ...record,
+      startTime,
+      endTime
+    }),
+    severity: record.severity ?? null,
+    detail: record.detail ?? record
+  };
+}
+function byStartTime(a, b) {
+  return (a.startTime ?? 0) - (b.startTime ?? 0);
+}
+function overlaps(row, start, end) {
+  if (!Number.isFinite(start) || !Number.isFinite(end)) return false;
+  const rowStart = row.startTime ?? 0;
+  const rowEnd = row.endTime ?? rowStart;
+  return rowStart < end && rowEnd >= start;
+}
+function isStandaloneEvent(event) {
+  return event.kind === "startup" || event.type === "navigation-back" || event.type === "page-load-error";
+}
+function isTimelineMetric(metric) {
+  return metric.kind !== "memory" && metric.kind !== "memory-summary";
+}
+function rowsForWindow(data, start, end, group) {
+  return [...data.sessions.map(session => toRow(session, session.kind, group)), ...data.requests.map(request => toRow(request, request.kind, group)), ...data.metrics.filter(isTimelineMetric).map(metric => toRow(metric, metric.kind, group)), ...data.events.filter(isStandaloneEvent).map(event => toRow(event, event.kind ?? "event", group)), ...data.insights.map(insight => toRow(insight, "insight", group))].filter(row => overlaps(row, start, end)).sort(byStartTime);
+}
+function buildPageLoadWaterfall(data) {
+  const pageLoads = data.sessions.filter(session => session.kind === "page-load");
+  if (pageLoads.length === 0) {
+    return [...data.events.filter(event => event.kind === "startup" || event.type?.startsWith("boot-")).map(event => toRow(event, "startup", "page-load")), ...data.metrics.filter(metric => metric.kind === "paint" || metric.kind === "startup").map(metric => toRow(metric, metric.kind, "page-load"))].sort(byStartTime);
+  }
+  return pageLoads.flatMap((pageLoad, index) => {
+    const group = pageLoad.label;
+    const startupRows = index === 0 ? data.events.filter(event => event.kind === "startup" && (event.startTime ?? 0) <= pageLoad.endTime).map(event => toRow(event, "startup", group)) : [];
+    return [...startupRows, toRow(pageLoad, "page-load", group), ...rowsForWindow(data, pageLoad.startTime, pageLoad.endTime, group).filter(row => row.id !== pageLoad.id)];
+  }).sort(byStartTime);
+}
+function buildRouteWaterfall(data) {
+  const routes = data.sessions.filter(session => session.kind === "route");
+  return routes.flatMap(route => [toRow(route, "route", route.label), ...rowsForWindow(data, route.startTime, route.endTime + 1000, route.label).filter(row => row.id !== route.id)]).sort(byStartTime);
+}
+function buildRequestWaterfall(data) {
+  return data.requests.filter(request => REQUEST_LANES.has(request.kind)).map(request => toRow(request, request.kind, request.sessionId ?? request.navigationId ?? null)).sort(byStartTime);
+}
+function buildNativeApiWaterfall(data) {
+  return data.requests.filter(request => request.kind === "native-api").map(request => toRow(request, request.kind, request.sessionId ?? null)).sort(byStartTime);
+}
+function buildInteractionWaterfall(data) {
+  const interactions = data.sessions.filter(session => session.kind === "interaction");
+  return interactions.flatMap(interaction => {
+    const group = interaction.label;
+    const matchingSession = row => {
+      const detail = row.detail ?? {};
+      return detail.sessionId === interaction.sessionId || detail.interactionId === interaction.sessionId || overlaps(row, interaction.startTime, interaction.endTime);
+    };
+    return [toRow(interaction, "interaction", group), ...[...data.requests.map(request => toRow(request, request.kind, group)), ...data.metrics.filter(isTimelineMetric).map(metric => toRow(metric, metric.kind, group)), ...data.insights.map(insight => toRow(insight, "insight", group))].filter(row => row.id !== interaction.id && matchingSession(row))];
+  }).sort(byStartTime);
+}
+function buildRenderJankWaterfall(data) {
+  const renderKinds = new Set(["fps-drop", "long-task", "loaf", "layout-shift", "hw-accel"]);
+  return [...data.metrics.filter(metric => renderKinds.has(metric.kind)).map(metric => toRow(metric, "render", metric.context ?? null)), ...data.sessions.filter(session => session.kind === "hw-accel").map(session => toRow(session, "render", session.detail?.trigger ?? null))].sort(byStartTime);
+}
+function buildScrollWaterfall(data) {
+  const scrolls = data.sessions.filter(session => session.kind === "scroll");
+  return scrolls.flatMap(scroll => [toRow(scroll, "scroll", scroll.label), ...rowsForWindow(data, scroll.startTime, scroll.endTime, scroll.label).filter(row => row.id !== scroll.id && ["fps-drop", "long-task", "loaf", "layout-shift", "insight"].includes(row.kind))]).sort(byStartTime);
+}
+function buildKeyboardWaterfall(data) {
+  const keyboards = data.sessions.filter(session => session.kind === "keyboard");
+  return keyboards.flatMap(keyboard => [toRow(keyboard, "keyboard", keyboard.label), ...rowsForWindow(data, keyboard.startTime, keyboard.endTime, keyboard.label).filter(row => row.id !== keyboard.id && ["viewport-resize", "scroll", "layout-shift", "insight"].includes(row.kind))]).sort(byStartTime);
+}
+function buildCacheWaterfall(data) {
+  return [...data.requests.filter(request => request.kind === "cache").map(request => toRow(request, "cache", request.cacheStatus ?? null)), ...data.metrics.filter(metric => metric.kind === "cache-summary").map(metric => toRow(metric, "cache-summary"))].sort(byStartTime);
+}
+function buildMemoryTimeline(data) {
+  return data.metrics.filter(metric => metric.kind === "memory" || metric.kind === "memory-summary").map(metric => toRow(metric, "memory")).sort(byStartTime);
+}
+function buildAllWaterfall(data) {
+  return [...data.sessions.map(session => toRow(session, session.kind)), ...data.requests.map(request => toRow(request, request.kind)), ...data.metrics.filter(isTimelineMetric).map(metric => toRow(metric, metric.kind)), ...data.events.filter(isStandaloneEvent).map(event => toRow(event, event.kind ?? "event")), ...data.insights.map(insight => toRow(insight, "insight"))].sort(byStartTime);
+}
+function buildWaterfall(data, type = "all") {
+  switch (type) {
+    case "page-load":
+    case "page":
+      return buildPageLoadWaterfall(data);
+    case "route":
+    case "navigation":
+      return buildRouteWaterfall(data);
+    case "requests":
+    case "request":
+      return buildRequestWaterfall(data);
+    case "native-bridge":
+    case "bridge":
+    case "api":
+    case "native-api":
+      return buildNativeApiWaterfall(data);
+    case "interactions":
+    case "interaction":
+      return buildInteractionWaterfall(data);
+    case "render":
+    case "jank":
+    case "render-jank":
+      return buildRenderJankWaterfall(data);
+    case "scroll":
+      return buildScrollWaterfall(data);
+    case "keyboard":
+    case "input":
+      return buildKeyboardWaterfall(data);
+    case "cache":
+      return buildCacheWaterfall(data);
+    case "memory":
+      return buildMemoryTimeline(data);
+    case "all":
+    default:
+      return buildAllWaterfall(data);
+  }
+}
+function listWaterfalls() {
+  return ["page-load", "navigation", "requests", "native-api", "interactions", "render-jank", "scroll", "keyboard", "cache", "memory", "all"];
+}