@solidjs/web 2.0.0-rc.0 → 2.0.0-rc.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (108) hide show
  1. package/README.md +1 -1
  2. package/dist/server.dev.js +4472 -0
  3. package/dist/server.js +1363 -224
  4. package/dist/{server.cjs → server.observe.js} +1563 -424
  5. package/dist/{dev.cjs → web.dev.js} +708 -365
  6. package/dist/web.js +460 -144
  7. package/dist/{dev.js → web.observe.js} +511 -213
  8. package/frames/dist/client.dev.js +464 -72
  9. package/frames/dist/client.js +364 -71
  10. package/frames/dist/{client.dev.cjs → client.observe.js} +487 -134
  11. package/frames/dist/server.dev.js +1713 -0
  12. package/frames/dist/server.js +553 -2495
  13. package/frames/dist/server.observe.js +1713 -0
  14. package/frames/package.json +2 -25
  15. package/package.json +214 -254
  16. package/performance-tracks/dist/performance-tracks.dev.js +678 -0
  17. package/performance-tracks/dist/performance-tracks.js +6 -0
  18. package/performance-tracks/dist/performance-tracks.observe.js +666 -0
  19. package/performance-tracks/package.json +7 -0
  20. package/performance-tracks/types/index.d.ts +67 -0
  21. package/serialization/decode/package.json +2 -15
  22. package/serialization/dist/decode.js +101 -12
  23. package/serialization/dist/serialization.js +112 -20
  24. package/serialization/package.json +2 -15
  25. package/serialization/types/index.d.ts +76 -157
  26. package/serialization/types/serializer-decode.d.ts +149 -112
  27. package/serialization/types/serializer.d.ts +101 -0
  28. package/server-functions/dist/client.dev.js +1364 -0
  29. package/server-functions/dist/client.js +745 -85
  30. package/server-functions/dist/client.observe.js +1343 -0
  31. package/server-functions/dist/server.dev.js +2203 -175
  32. package/server-functions/dist/server.js +2111 -176
  33. package/server-functions/dist/server.observe.js +3043 -0
  34. package/server-functions/package.json +2 -35
  35. package/server-functions/rich-args/package.json +2 -15
  36. package/storage/package.json +2 -15
  37. package/types/client.d.ts +193 -288
  38. package/types/constants.d.ts +20 -0
  39. package/types/cookies.d.ts +32 -84
  40. package/types/diagnostics.d.ts +56 -0
  41. package/types/frames/client.d.ts +1 -1
  42. package/types/frames/frame-client.d.ts +323 -259
  43. package/types/frames/frame-container-plugin.d.ts +72 -0
  44. package/types/frames/frame-sink.d.ts +101 -158
  45. package/types/frames/frame-transport.d.ts +192 -190
  46. package/types/frames/serializer-decode.d.ts +219 -0
  47. package/types/frames/serializer.d.ts +76 -157
  48. package/types/frames/server.d.ts +1 -1
  49. package/types/head.d.ts +19 -0
  50. package/types/index.d.ts +62 -76
  51. package/types/index.server.d.ts +174 -0
  52. package/types/jsx.d.ts +33 -26
  53. package/types/observe.d.ts +358 -0
  54. package/types/reconcile.d.ts +1 -0
  55. package/types/render.d.ts +9 -0
  56. package/types/response.d.ts +75 -150
  57. package/types/serializer-decode.d.ts +149 -112
  58. package/types/serializer.d.ts +76 -157
  59. package/types/server-functions/client.d.ts +202 -174
  60. package/types/server-functions/flash.d.ts +28 -30
  61. package/types/server-functions/registry.d.ts +102 -0
  62. package/types/server-functions/rich-args.d.ts +1 -10
  63. package/types/server-functions/server.d.ts +518 -454
  64. package/types/server-functions/shared.d.ts +366 -425
  65. package/types/server-mock.d.ts +110 -13
  66. package/types/server-observe.d.ts +77 -0
  67. package/types/server.d.ts +425 -425
  68. package/types/trace.d.ts +127 -0
  69. package/LICENSE +0 -21
  70. package/dist/web.cjs +0 -2007
  71. package/frames/dist/client.cjs +0 -1916
  72. package/frames/dist/server.cjs +0 -3667
  73. package/serialization/dist/decode.cjs +0 -110
  74. package/serialization/dist/serialization.cjs +0 -232
  75. package/serialization/types-cjs/index.d.cts +0 -182
  76. package/serialization/types-cjs/package.json +0 -3
  77. package/serialization/types-cjs/serializer-decode.d.cts +0 -182
  78. package/server-functions/dist/client.cjs +0 -646
  79. package/server-functions/dist/rich-args.cjs +0 -11
  80. package/server-functions/dist/server.cjs +0 -1077
  81. package/server-functions/dist/server.dev.cjs +0 -1077
  82. package/storage/dist/storage.cjs +0 -12
  83. package/storage/types-cjs/index.d.cts +0 -28
  84. package/storage/types-cjs/package.json +0 -3
  85. package/types/core.d.ts +0 -6
  86. package/types-cjs/client.d.cts +0 -337
  87. package/types-cjs/cookies.d.cts +0 -93
  88. package/types-cjs/core.d.cts +0 -6
  89. package/types-cjs/frames/client.d.cts +0 -36
  90. package/types-cjs/frames/frame-client.d.cts +0 -338
  91. package/types-cjs/frames/frame-sink.d.cts +0 -194
  92. package/types-cjs/frames/frame-transport.d.cts +0 -222
  93. package/types-cjs/frames/serializer.d.cts +0 -182
  94. package/types-cjs/frames/server.d.cts +0 -52
  95. package/types-cjs/index.d.cts +0 -230
  96. package/types-cjs/jsx-properties.d.cts +0 -93
  97. package/types-cjs/jsx.d.cts +0 -4150
  98. package/types-cjs/package.json +0 -3
  99. package/types-cjs/response.d.cts +0 -174
  100. package/types-cjs/serializer-decode.d.cts +0 -182
  101. package/types-cjs/serializer.d.cts +0 -182
  102. package/types-cjs/server-functions/client.d.cts +0 -201
  103. package/types-cjs/server-functions/flash.d.cts +0 -38
  104. package/types-cjs/server-functions/rich-args.d.cts +0 -10
  105. package/types-cjs/server-functions/server.d.cts +0 -588
  106. package/types-cjs/server-functions/shared.d.cts +0 -523
  107. package/types-cjs/server-mock.d.cts +0 -277
  108. package/types-cjs/server.d.cts +0 -523
@@ -0,0 +1,666 @@
1
+ import { OBSERVE } from 'solid-js';
2
+ import { attribution, formatRerun, formatOrigin } from 'solid-js/attribution';
3
+
4
+ const IS_DEV = false;
5
+ const GROUP = "Solid";
6
+ const TRACKS = {
7
+ interactions: "Interactions",
8
+ propagation: "Propagation",
9
+ effects: "Effects",
10
+ memos: "Memos",
11
+ async: "Async",
12
+ holds: "Holds",
13
+ navigations: "Navigations",
14
+ server: "Server"
15
+ };
16
+ const noop = () => {};
17
+ function enablePerformanceTracks(options = {}) {
18
+ if (instance !== null) return instance.join();
19
+ const observe = OBSERVE;
20
+ if (observe === undefined) return noop;
21
+ if (typeof performance !== "object" || typeof performance.now !== "function") return noop;
22
+ const emitter = createEmitter(options.rich ?? IS_DEV);
23
+ if (emitter === undefined) return noop;
24
+ const minMs = options.minMs ?? (0.05);
25
+ const painter = new Painter(emitter, minMs);
26
+ const server = new ServerSpans(emitter);
27
+ server.start();
28
+ const {
29
+ records
30
+ } = observe;
31
+ const releases = [() => server.dispose(), attribution.enable({
32
+ log: false,
33
+ ...options.attribution
34
+ }), records.subscribe("rerun", (e, node) => painter.rerun(e, node)), records.subscribe("create", (e, node) => painter.create(e, node)), records.subscribe("effect", (e, node) => painter.effect(e, node)), records.subscribe("flush", e => painter.flush(e)), records.subscribe("flight", (e, node) => painter.flight(e, node)), records.subscribe("fallback", (e, subtree) => painter.fallback(e, subtree)), records.subscribe("interaction", e => painter.interaction(e)), records.subscribe("hold", e => painter.hold(e)), records.subscribe("navigation", e => painter.navigation(e)), records.subscribe("call", (e, live) => {
35
+ painter.call(e);
36
+ server.call(e, live);
37
+ }), records.subscribe("frame", e => painter.frame(e)), observe.diagnostics.subscribe((e, subject) => painter.diagnostic(e, subject))];
38
+ const active = {
39
+ holders: 0,
40
+ join() {
41
+ active.holders++;
42
+ let held = true;
43
+ return () => {
44
+ if (!held) return;
45
+ held = false;
46
+ if (--active.holders > 0 || instance !== active) return;
47
+ instance = null;
48
+ for (const release of releases) release();
49
+ emitter.dispose();
50
+ };
51
+ }
52
+ };
53
+ instance = active;
54
+ return active.join();
55
+ }
56
+ let instance = null;
57
+ function createEmitter(rich) {
58
+ const hasMeasure = typeof performance.measure === "function";
59
+ const hasTimeStamp = typeof console !== "undefined" && typeof console.timeStamp === "function";
60
+ let emitter;
61
+ if (rich && hasMeasure || !hasTimeStamp && hasMeasure) {
62
+ const names = new Map();
63
+ const markNames = new Map();
64
+ let pending = 0;
65
+ const clear = () => {
66
+ pending = 0;
67
+ clearOwned(names, "measure", performance.clearMeasures);
68
+ clearOwned(markNames, "mark", performance.clearMarks);
69
+ };
70
+ const hasMark = typeof performance.mark === "function";
71
+ emitter = {
72
+ rich: true,
73
+ span(label, start, end, track, color, tooltip, properties, task) {
74
+ const devtools = {
75
+ dataType: "track-entry",
76
+ track,
77
+ trackGroup: GROUP,
78
+ color
79
+ };
80
+ if (tooltip !== undefined) devtools.tooltipText = tooltip;
81
+ if (properties !== undefined) devtools.properties = properties;
82
+ const measure = () => performance.measure(label, {
83
+ start,
84
+ end,
85
+ detail: {
86
+ devtools
87
+ }
88
+ });
89
+ if (!guarded(measure, task)) return;
90
+ names.set(label, (names.get(label) ?? 0) + 1);
91
+ if (++pending >= CLEAR_EVERY) clear();
92
+ },
93
+ mark(label, color, tooltip, properties, issue, task) {
94
+ if (!hasMark) return;
95
+ const devtools = {
96
+ dataType: "marker",
97
+ color
98
+ };
99
+ if (tooltip !== undefined) devtools.tooltipText = tooltip;
100
+ if (properties !== undefined) devtools.properties = properties;
101
+ if (issue !== undefined) devtools.performanceIssue = issue;
102
+ const mark = () => performance.mark(label, {
103
+ detail: {
104
+ devtools
105
+ }
106
+ });
107
+ if (!guarded(mark, task)) return;
108
+ markNames.set(label, (markNames.get(label) ?? 0) + 1);
109
+ if (++pending >= CLEAR_EVERY) clear();
110
+ },
111
+ dispose: clear
112
+ };
113
+ } else if (hasTimeStamp) {
114
+ const timeStamp = console.timeStamp;
115
+ emitter = {
116
+ rich: false,
117
+ span(label, start, end, track, color, _tooltip, _properties, task) {
118
+ guarded(() => timeStamp(label, start, end, track, GROUP, color), task);
119
+ },
120
+ mark(label, _color, _tooltip, _properties, _issue, task) {
121
+ guarded(() => timeStamp(label), task);
122
+ },
123
+ dispose: noop
124
+ };
125
+ } else return undefined;
126
+ for (const track of Object.values(TRACKS)) {
127
+ emitter.span(track, SEED_AT, SEED_AT, track, "primary-light");
128
+ }
129
+ return emitter;
130
+ }
131
+ const SEED_AT = 0.003;
132
+ const CLEAR_EVERY = 500;
133
+ function guarded(fn, task) {
134
+ try {
135
+ task !== undefined ? task.run(fn) : fn();
136
+ return true;
137
+ } catch (error) {
138
+ return false;
139
+ }
140
+ }
141
+ function clearOwned(owned, type, clearFn) {
142
+ if (typeof clearFn !== "function" || typeof performance.getEntriesByName !== "function") {
143
+ owned.clear();
144
+ return;
145
+ }
146
+ for (const [name, count] of owned) {
147
+ if (performance.getEntriesByName(name, type).length <= count) {
148
+ clearFn.call(performance, name);
149
+ owned.delete(name);
150
+ }
151
+ }
152
+ }
153
+ class Painter {
154
+ roots = new Set();
155
+ unchanged = 0;
156
+ names = new Map();
157
+ constructor(emit, minMs) {
158
+ this.emit = emit;
159
+ this.minMs = minMs;
160
+ this.rich = emit.rich;
161
+ }
162
+ rerun(event, subject) {
163
+ collectRoots(event.causes, this.roots);
164
+ if (!event.changed) this.unchanged++;
165
+ const node = describe(event.nodeName, OBSERVE.ownerPath(subject));
166
+ this.names.set(event.nodeId, node.short);
167
+ if (event.totalMs < this.minMs) return;
168
+ const track = event.nodeKind === "effect" ? TRACKS.effects : TRACKS.memos;
169
+ const color = event.phase === "optimistic" ? "tertiary" : !event.changed ? "warning" : bySelfTime(event.selfMs);
170
+ let tooltip;
171
+ let properties;
172
+ if (this.rich) {
173
+ tooltip = formatRerun(event);
174
+ properties = [["Run", `${event.run} (run ${event.nodeRuns} of this node)`], ["Self time", ms(event.selfMs)], ["Total time", ms(event.totalMs)], ["Changed", event.changed ? "yes" : "no — unchanged (wasted)"], ["Phase", event.phase + (event.held ? ", held" : "")], ["Deps", String(event.depCount)]];
175
+ this.identity(properties, node, event.nodeId);
176
+ if (event.depsAdded.length > 0) properties.push(["Deps added", event.depsAdded.join(", ")]);
177
+ if (event.depsRemoved.length > 0) properties.push(["Deps removed", event.depsRemoved.join(", ")]);
178
+ if (event.causes.length > 0) properties.push(["Causes", event.causes.map(rootCause).join("; ")]);
179
+ const origin = rootOrigin(event.causes);
180
+ if (origin !== undefined && origin !== event.interaction) properties.push(["Origin", this.origin(origin)]);
181
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
182
+ }
183
+ const end = event.at + event.totalMs;
184
+ const task = taskOf();
185
+ this.emit.span(node.label, event.at, end, track, color, tooltip, properties, task);
186
+ this.emit.span(`${node.label} ← ${this.causeLabels(event.causes)}`, event.at, end, TRACKS.propagation, color, tooltip, properties, task);
187
+ }
188
+ create(event, subject) {
189
+ const node = describe(event.nodeName, OBSERVE.ownerPath(subject));
190
+ this.names.set(event.nodeId, node.short);
191
+ if (event.totalMs < this.minMs) return;
192
+ let properties;
193
+ if (this.rich) {
194
+ properties = [["Self time", ms(event.selfMs)], ["Total time", ms(event.totalMs)], ["Phase", event.phase + (event.held ? ", held" : "")], ["Deps", String(event.depCount)]];
195
+ this.identity(properties, node, event.nodeId);
196
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
197
+ }
198
+ const label = `${node.label} · create`;
199
+ const end = event.at + event.totalMs;
200
+ const color = event.phase === "optimistic" ? "tertiary" : bySelfTime(event.selfMs);
201
+ const task = taskOf();
202
+ this.emit.span(label, event.at, end, event.nodeKind === "effect" ? TRACKS.effects : TRACKS.memos, color, undefined, properties, task);
203
+ this.emit.span(label, event.at, end, TRACKS.propagation, color, undefined, properties, task);
204
+ }
205
+ effect(event, subject) {
206
+ if (event.durationMs < this.minMs) return;
207
+ const node = describe(event.nodeName, OBSERVE.ownerPath(subject));
208
+ let properties;
209
+ if (this.rich) {
210
+ properties = [["Duration", ms(event.durationMs)]];
211
+ this.identity(properties, node, event.nodeId);
212
+ if (event.run !== undefined) properties.push(["Run", String(event.run)]);
213
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
214
+ }
215
+ const label = `${node.label} · callback`;
216
+ const end = event.at + event.durationMs;
217
+ const color = event.durationMs < 10 ? "secondary-light" : event.durationMs < 100 ? "secondary" : "error";
218
+ const task = taskOf();
219
+ this.emit.span(label, event.at, end, TRACKS.effects, color, undefined, properties, task);
220
+ this.emit.span(label, event.at, end, TRACKS.propagation, color, undefined, properties, task);
221
+ }
222
+ diagnostic(event, subject) {
223
+ const owner = event.ownerPath?.join(" › ");
224
+ const label = event.ownerPath !== undefined ? `${event.code} — ${nearest(event.ownerPath).join(" › ")}` : event.code;
225
+ const color = event.severity === "error" ? "error" : event.severity === "warn" ? "warning" : "primary-light";
226
+ let tooltip;
227
+ let properties;
228
+ let issue;
229
+ if (this.rich) {
230
+ tooltip = event.message;
231
+ properties = [["Code", event.code], ["Kind", event.kind], ["Severity", event.severity]];
232
+ if (owner !== undefined) properties.push(["Owner path", owner]);
233
+ if (event.nodeName !== undefined) properties.push(["Node", event.nodeName]);
234
+ properties.push(["Message", event.message]);
235
+ if (event.data !== undefined) {
236
+ for (const [key, value] of Object.entries(event.data)) {
237
+ if (typeof value === "number") properties.push([key, Number.isInteger(value) ? String(value) : value.toFixed(2)]);else if (typeof value === "string" || typeof value === "boolean") properties.push([key, String(value)]);
238
+ }
239
+ }
240
+ const guide = undefined;
241
+ if (event.severity !== "info") {
242
+ issue = {
243
+ name: `Solid: ${event.code}`,
244
+ severity: event.severity === "error" ? "error" : "warning",
245
+ description: tooltip,
246
+ learnMoreUrl: guide
247
+ };
248
+ }
249
+ }
250
+ this.emit.mark(label, color, tooltip, properties, issue, taskOf());
251
+ }
252
+ identity(properties, node, nodeId) {
253
+ if (node.path !== undefined) properties.push(["Owner path", node.path]);
254
+ if (node.internal !== undefined) properties.push(["Node", node.internal]);
255
+ properties.push(["Node id", String(nodeId)]);
256
+ }
257
+ flush(event) {
258
+ const roots = [...this.roots];
259
+ const unchanged = this.unchanged;
260
+ this.roots.clear();
261
+ this.unchanged = 0;
262
+ this.names.clear();
263
+ let label = roots.length > 0 ? this.writes(roots, 3) : "flush";
264
+ const origin = event.interaction ?? roots.map(r => r.origin).find(o => o !== undefined && o.kind !== "external");
265
+ if (origin !== undefined) label += ` — ${this.origin(origin)}`;
266
+ label += ` · ${event.runs} ${event.runs === 1 ? "run" : "runs"}`;
267
+ if (unchanged > 0) label += `, ${unchanged} unchanged`;
268
+ if (event.created > 0) label += `, ${event.created} created`;
269
+ if (event.held) label += " · held";
270
+ let properties;
271
+ if (this.rich) {
272
+ properties = [["Duration", ms(event.durationMs)], ["Writes", roots.length > 0 ? this.writes(roots, Infinity) : "none"], ["Re-runs", String(event.runs)], ["Unchanged", `${unchanged} (wasted)`], ["Created", String(event.created)], ["Held", event.held ? "yes — a transition parked" : "no"]];
273
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
274
+ }
275
+ this.emit.span(label, event.at, event.at + event.durationMs, TRACKS.propagation, event.held ? "tertiary" : unchanged > 0 && unchanged * 2 >= event.runs ? "warning" : event.durationMs < 16 ? "primary" : "primary-dark", undefined, properties);
276
+ }
277
+ flight(event, subject) {
278
+ const node = describe(event.nodeName, event.ownerPath);
279
+ let properties;
280
+ if (this.rich) {
281
+ properties = [["In the air", ms(event.durationMs)], ["Outcome", event.outcome]];
282
+ if (node.path !== undefined) properties.push(["Owner path", node.path]);
283
+ if (node.internal !== undefined) properties.push(["Node", node.internal]);
284
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
285
+ }
286
+ this.emit.span(`${node.label}${event.outcome === "abandoned" ? " · abandoned" : ""}`, event.at, event.at + event.durationMs, TRACKS.async, event.outcome === "abandoned" ? "warning" : "secondary", undefined, properties, taskOf());
287
+ }
288
+ fallback(event, subject) {
289
+ const path = event.ownerPath;
290
+ const label = `fallback${path !== undefined ? ` ${nearest(path).join(" › ")}` : ""}`;
291
+ let properties;
292
+ if (this.rich) {
293
+ properties = [["Shown", ms(event.shownMs)]];
294
+ if (path !== undefined && nearest(path).length !== path.length) properties.push(["Owner path", path.join(" › ")]);
295
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
296
+ }
297
+ this.emit.span(label, event.at, event.at + event.shownMs, TRACKS.async, "tertiary", undefined, properties, taskOf());
298
+ }
299
+ interaction(event) {
300
+ const label = this.origin(event.origin);
301
+ const handlerStart = event.at + (event.inputDelayMs ?? 0);
302
+ const handlerEnd = handlerStart + event.handlerMs;
303
+ let properties;
304
+ if (this.rich) {
305
+ properties = [["Handler", ms(event.handlerMs)], ["Writes", String(event.writes)], ["Re-runs", `${event.runs} (${ms(event.runMs)} self time)`], ["Created", String(event.created)]];
306
+ if (event.inputDelayMs !== undefined) properties.unshift(["Input delay", ms(event.inputDelayMs)]);
307
+ if (event.settledMs !== undefined) properties.push(["Settled", ms(event.settledMs)]);
308
+ if (event.outcome !== undefined) properties.push(["Outcome", event.outcome]);
309
+ if (event.holds.length > 0) properties.push(["Holds", String(event.holds.length)]);
310
+ if (event.navigations.length > 0) properties.push(["Navigations", event.navigations.map(n => this.origin(n.origin)).join("; ")]);
311
+ }
312
+ if (event.inputDelayMs !== undefined && event.inputDelayMs > 0) {
313
+ this.emit.span("input delay", event.at, handlerStart, TRACKS.interactions, "primary-light");
314
+ }
315
+ this.emit.span(label, handlerStart, handlerEnd, TRACKS.interactions, "primary", undefined, properties);
316
+ const outcome = event.outcome;
317
+ if (event.settledMs === undefined || outcome === undefined || outcome === "idle") return;
318
+ const settleEnd = event.at + event.settledMs;
319
+ if (settleEnd <= handlerEnd) return;
320
+ const silent = outcome === "held" && event.holds.some(h => h.silent);
321
+ this.emit.span(outcome, handlerEnd, settleEnd, TRACKS.interactions, silent ? "warning" : outcome === "held" ? "tertiary" : "secondary-light", undefined, this.rich ? [["Settled", ms(event.settledMs)]] : undefined);
322
+ }
323
+ hold(event) {
324
+ const {
325
+ long,
326
+ silent
327
+ } = event;
328
+ const what = event.blockers.length > 0 ? event.blockers.join(", ") : "a transition";
329
+ const label = event.origin !== undefined ? `${this.origin(event.origin)} — waiting on ${what}` : `waiting on ${what}`;
330
+ let properties;
331
+ if (this.rich) {
332
+ properties = [["Held", ms(event.holdMs)], ["Tail", `${ms(event.tailMs)} (last write → commit)`], ["Flushes", String(event.flushes)], ["Held writes", event.heldWrites.map(heldWrite).join(", ") || "none"], ["Acknowledged by", event.acknowledgements.map(a => `${a.kind}(${a.source})`).join(", ") || "nothing"], ["Painted during hold", String(event.paintedDuringHold)]];
333
+ if (silent) properties.push(["Verdict", "silent hold — no feedback while waiting"]);
334
+ if (long) properties.push(["Verdict", "long hold"]);
335
+ if (event.action) properties.push(["Action", "yes"]);
336
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
337
+ }
338
+ this.emit.span(label, event.at, event.at + event.holdMs, TRACKS.holds, long ? "error" : silent ? "warning" : "tertiary", undefined, properties);
339
+ }
340
+ navigation(event) {
341
+ if (event.settledMs === undefined) return;
342
+ let properties;
343
+ if (this.rich) {
344
+ properties = [["Settled", ms(event.settledMs)], ["Writes", String(event.writes)]];
345
+ if (event.to !== undefined) properties.push(["To", event.to]);
346
+ if (event.from !== undefined) properties.push(["From", event.from]);
347
+ if (event.params !== undefined) {
348
+ const params = Object.entries(event.params).filter(([, v]) => v !== undefined).map(([k, v]) => `${k}=${v}`).join(", ");
349
+ if (params) properties.push(["Params", params]);
350
+ }
351
+ if (event.redirects !== undefined) properties.push(["Redirected from", event.redirects.map(hop => hop.to ?? hop.name ?? "?").join(" → ")]);
352
+ if (event.outcome !== undefined) properties.push(["Outcome", event.outcome]);
353
+ if (event.interaction !== undefined) properties.push(["Interaction", this.origin(event.interaction)]);
354
+ }
355
+ this.emit.span(formatOrigin(event.origin), event.at, event.at + event.settledMs, TRACKS.navigations, event.outcome === "superseded" ? "secondary-light" : event.outcome === "held" ? "tertiary" : "secondary", undefined, properties);
356
+ }
357
+ call(event) {
358
+ let label = `${event.method} ${event.id}`;
359
+ if (event.status !== undefined) label += ` · ${event.status}`;
360
+ let properties;
361
+ if (this.rich) {
362
+ properties = [["Duration", ms(event.durationMs)], ["Outcome", event.outcome]];
363
+ if (event.status !== undefined) properties.push(["Status", String(event.status)]);
364
+ if (event.deferred) properties.push(["Deferred", "the body is consumed by the caller"]);
365
+ if (event.origin !== undefined) properties.push(["Origin", this.origin(event.origin)]);
366
+ }
367
+ this.emit.span(label, event.at, event.at + event.durationMs, TRACKS.server, event.outcome === "error" ? "error" : "secondary", undefined, properties);
368
+ }
369
+ frame(event) {
370
+ if (event.side !== "client") return;
371
+ const label = `frame ${event.id || "(unnamed)"}`;
372
+ let properties;
373
+ if (this.rich) {
374
+ properties = [["Duration", ms(event.durationMs)], ["Outcome", event.outcome], ["Chunks", String(event.chunks)], ["Fragments", String(event.fragments)], ["Slots", String(event.slots)], ["Regions", String(event.regions)], ["Errors", String(event.errors)], ["Version", String(event.version)]];
375
+ if (event.shellMs !== undefined) properties.splice(1, 0, ["Shell", ms(event.shellMs)]);
376
+ if (event.address !== undefined) properties.push(["Applied as", event.address]);
377
+ }
378
+ if (event.shellMs !== undefined && event.shellMs > 0) {
379
+ this.emit.span(`${label} · shell`, event.at, event.at + event.shellMs, TRACKS.server, "secondary-light");
380
+ }
381
+ this.emit.span(label, event.at, event.at + event.durationMs, TRACKS.server, event.outcome === "complete" ? "secondary" : "error", undefined, properties);
382
+ }
383
+ causeLabels(causes) {
384
+ const labels = new Set();
385
+ for (const c of causes) {
386
+ const name = (c.kind === "derived" && c.nodeId !== undefined ? this.names.get(c.nodeId) : undefined) ?? c.name;
387
+ labels.add(c.kind === "async" ? `${name} landed` : c.kind === "refresh" ? `refresh ${name}` : name);
388
+ }
389
+ return [...labels].join(", ");
390
+ }
391
+ writes(roots, limit) {
392
+ const shown = roots.slice(0, limit).map(r => {
393
+ let out = r.kind === "async" ? `${r.name} landed` : r.kind === "refresh" ? `refresh ${r.name}` : r.name;
394
+ if (r.prev !== undefined) out += ` ${r.prev} → ${r.value}`;
395
+ return out;
396
+ });
397
+ if (roots.length > limit) shown.push(`+${roots.length - limit} more`);
398
+ return shown.join(", ");
399
+ }
400
+ origin(origin) {
401
+ return formatOrigin(origin);
402
+ }
403
+ }
404
+ const FLOW_INTERNALS = {
405
+ "<Show>": new Set(["condition value", "condition", "value"]),
406
+ "<Switch>": new Set(["children", "conditions", "condition value", "condition", "eval conditions"]),
407
+ "<Loading>": new Set(["children", "boundary", "value"]),
408
+ "<Errored>": new Set(["children", "boundary", "value"]),
409
+ "<Reveal>": new Set(["reveal order"])
410
+ };
411
+ const FLOW_TAGS = new Set(["<Show>", "<For>", "<Repeat>", "<Switch>", "<Match>", "<Errored>", "<Loading>", "<Reveal>", "<Portal>", "<Dynamic>"]);
412
+ function nearest(segments) {
413
+ for (let i = segments.length - 1; i > 0; i--) {
414
+ const s = segments[i];
415
+ if (s.charCodeAt(0) === 60 && !FLOW_TAGS.has(s)) return segments.slice(i);
416
+ }
417
+ return segments;
418
+ }
419
+ function describe(nodeName, path) {
420
+ const full = path === undefined ? [nodeName] : path[path.length - 1] === nodeName ? path : [...path, nodeName];
421
+ const segments = [];
422
+ let flow;
423
+ let internal;
424
+ for (let i = 0; i < full.length; i++) {
425
+ const name = full[i];
426
+ let shown;
427
+ if (flow !== undefined && flow.has(name)) {
428
+ internal = name;
429
+ } else {
430
+ flow = FLOW_INTERNALS[name];
431
+ const dot = name.indexOf(".");
432
+ if (dot > 0 && name.charCodeAt(0) !== 60 ) {
433
+ shown = name.slice(0, dot);
434
+ internal = name.slice(dot + 1);
435
+ } else {
436
+ shown = name;
437
+ internal = undefined;
438
+ }
439
+ }
440
+ if (shown !== undefined && shown !== segments[segments.length - 1]) segments.push(shown);
441
+ }
442
+ const short = segments[segments.length - 1];
443
+ const label = nearest(segments).join(" › ");
444
+ const described = {
445
+ label,
446
+ short
447
+ };
448
+ if (internal !== undefined) described.internal = internal;
449
+ const runtimePath = full.join(" › ");
450
+ if (runtimePath !== label) described.path = runtimePath;
451
+ return described;
452
+ }
453
+ function taskOf(subject) {
454
+ return undefined;
455
+ }
456
+ function rootOrigin(causes) {
457
+ for (const c of causes) {
458
+ let root = c;
459
+ while (root.causes !== undefined && root.causes.length > 0) root = root.causes[0];
460
+ if (root.origin !== undefined && root.origin.kind !== "external") return root.origin;
461
+ }
462
+ return undefined;
463
+ }
464
+ function collectRoots(causes, out) {
465
+ for (const c of causes) {
466
+ if (c.kind === "derived") {
467
+ if (c.causes !== undefined) collectRoots(c.causes, out);
468
+ } else out.add(c);
469
+ }
470
+ }
471
+ function bySelfTime(selfMs) {
472
+ return selfMs < 0.5 ? "primary-light" : selfMs < 10 ? "primary" : selfMs < 100 ? "primary-dark" : "error";
473
+ }
474
+ const SOLID_METRIC = /^solid-(invocation|shell|boundary)$/;
475
+ const PENDING_MS = 30_000;
476
+ class ServerSpans {
477
+ pending = [];
478
+ constructor(emit) {
479
+ this.emit = emit;
480
+ }
481
+ start() {
482
+ this.navigation();
483
+ if (typeof PerformanceObserver !== "function") return;
484
+ try {
485
+ const observer = new PerformanceObserver(list => this.resources(list.getEntries()));
486
+ observer.observe({
487
+ type: "resource",
488
+ buffered: true
489
+ });
490
+ this.observer = observer;
491
+ } catch {
492
+ this.observer = undefined;
493
+ }
494
+ }
495
+ dispose() {
496
+ if (this.observer !== undefined) this.observer.disconnect();
497
+ this.observer = undefined;
498
+ this.pending.length = 0;
499
+ }
500
+ call(event, live) {
501
+ const response = live.response;
502
+ if (response === undefined) return;
503
+ let header;
504
+ try {
505
+ header = response.headers.get("server-timing");
506
+ } catch {
507
+ return;
508
+ }
509
+ if (!header) return;
510
+ const metrics = parseServerTiming(header).filter(m => SOLID_METRIC.test(m.name));
511
+ if (metrics.length === 0) return;
512
+ if (this.observer === undefined) {
513
+ this.paint(metrics, event, undefined);
514
+ return;
515
+ }
516
+ if (typeof performance.getEntriesByName === "function") {
517
+ const entry = findResource(performance.getEntriesByName(response.url, "resource"), event);
518
+ if (entry !== undefined) {
519
+ this.paint(metrics, event, entry);
520
+ return;
521
+ }
522
+ }
523
+ this.pending.push({
524
+ event,
525
+ url: response.url,
526
+ metrics,
527
+ expires: performance.now() + PENDING_MS
528
+ });
529
+ }
530
+ resources(entries) {
531
+ const pending = this.pending;
532
+ if (pending.length === 0) return;
533
+ const now = performance.now();
534
+ for (let i = pending.length - 1; i >= 0; i--) {
535
+ const call = pending[i];
536
+ if (call.expires <= now) {
537
+ pending.splice(i, 1);
538
+ continue;
539
+ }
540
+ const entry = findResource(entries.filter(e => e.name === call.url), call.event);
541
+ if (entry === undefined) continue;
542
+ pending.splice(i, 1);
543
+ this.paint(call.metrics, call.event, entry);
544
+ }
545
+ }
546
+ navigation() {
547
+ if (typeof performance.getEntriesByType !== "function") return;
548
+ const [nav] = performance.getEntriesByType("navigation");
549
+ if (nav === undefined || !Array.isArray(nav.serverTiming) || !(nav.responseStart > 0)) return;
550
+ const end = nav.responseStart;
551
+ const rich = this.emit.rich;
552
+ for (const metric of nav.serverTiming) {
553
+ if (!SOLID_METRIC.test(metric.name)) continue;
554
+ const kind = metric.name.slice(6);
555
+ const path = kind === "boundary" ? metric.description.split(" > ") : undefined;
556
+ const label = kind === "shell" ? "shell · server" : path !== undefined ? `boundary ${nearest(path).join(" › ")} · server` : `${metric.description} · server`;
557
+ let properties;
558
+ if (rich) {
559
+ properties = [["Duration", ms(metric.duration)], ["Source", "Server-Timing on the document"], ["Placement", kind === "shell" ? "ends at responseStart — the head left when the shell was ready" : "ends with the shell — settled at or before the flush"]];
560
+ if (path !== undefined && nearest(path).length !== path.length) properties.push(["Owner path", path.join(" › ")]);
561
+ }
562
+ this.emit.span(label, end - metric.duration, end, TRACKS.server, kind === "shell" ? "tertiary" : "tertiary-light", undefined, properties);
563
+ }
564
+ }
565
+ paint(metrics, event, entry) {
566
+ const rich = this.emit.rich;
567
+ const end = entry !== undefined && entry.responseStart > 0 ? entry.responseStart : undefined;
568
+ const mid = event.at + event.durationMs / 2;
569
+ for (const metric of metrics) {
570
+ const start = end !== undefined ? end - metric.duration : mid - metric.duration / 2;
571
+ const stop = end !== undefined ? end : mid + metric.duration / 2;
572
+ const label = `${metric.description || event.id} · server`;
573
+ let properties;
574
+ if (rich) {
575
+ properties = [["Duration", ms(metric.duration)], ["Wire", ms(Math.max(0, event.durationMs - metric.duration))], ["Source", "Server-Timing"], ["Placement", end !== undefined ? "ends at the response's responseStart" : "centred in the call — no resource timing for this fetch"]];
576
+ }
577
+ this.emit.span(label, start, stop, TRACKS.server, "tertiary", undefined, properties);
578
+ }
579
+ }
580
+ }
581
+ function findResource(entries, event) {
582
+ const from = event.at - 1;
583
+ const to = event.at + event.durationMs + 1;
584
+ for (const entry of entries) {
585
+ if (entry.startTime >= from && entry.startTime <= to) {
586
+ return entry;
587
+ }
588
+ }
589
+ return undefined;
590
+ }
591
+ function parseServerTiming(value) {
592
+ const out = [];
593
+ let start = 0;
594
+ let quoted = false;
595
+ const take = end => {
596
+ const entry = value.slice(start, end).trim();
597
+ if (entry === "") return;
598
+ const parts = splitParams(entry);
599
+ const name = parts[0].trim().toLowerCase();
600
+ if (name === "") return;
601
+ let duration;
602
+ let description = "";
603
+ for (let i = 1; i < parts.length; i++) {
604
+ const eq = parts[i].indexOf("=");
605
+ if (eq === -1) continue;
606
+ const key = parts[i].slice(0, eq).trim().toLowerCase();
607
+ const raw = parts[i].slice(eq + 1).trim();
608
+ if (key === "dur") duration = Number(raw);else if (key === "desc") description = unquote(raw);
609
+ }
610
+ if (duration === undefined || !(duration >= 0)) return;
611
+ out.push({
612
+ name,
613
+ duration,
614
+ description
615
+ });
616
+ };
617
+ for (let i = 0; i < value.length; i++) {
618
+ const c = value[i];
619
+ if (quoted) {
620
+ if (c === "\\") i++;else if (c === '"') quoted = false;
621
+ } else if (c === '"') quoted = true;else if (c === ",") {
622
+ take(i);
623
+ start = i + 1;
624
+ }
625
+ }
626
+ take(value.length);
627
+ return out;
628
+ }
629
+ function splitParams(entry) {
630
+ const parts = [];
631
+ let start = 0;
632
+ let quoted = false;
633
+ for (let i = 0; i < entry.length; i++) {
634
+ const c = entry[i];
635
+ if (quoted) {
636
+ if (c === "\\") i++;else if (c === '"') quoted = false;
637
+ } else if (c === '"') quoted = true;else if (c === ";") {
638
+ parts.push(entry.slice(start, i));
639
+ start = i + 1;
640
+ }
641
+ }
642
+ parts.push(entry.slice(start));
643
+ return parts;
644
+ }
645
+ function unquote(raw) {
646
+ if (raw.length >= 2 && raw[0] === '"' && raw[raw.length - 1] === '"') {
647
+ return raw.slice(1, -1).replace(/\\(.)/g, "$1");
648
+ }
649
+ return raw;
650
+ }
651
+ function ms(value) {
652
+ return `${value.toFixed(2)}ms`;
653
+ }
654
+ function rootCause(cause) {
655
+ let root = cause;
656
+ while (root.causes !== undefined && root.causes.length > 0) root = root.causes[0];
657
+ let out = `${root.kind === "derived" ? "memo" : "signal"} "${root.name}" ${root.kind}`;
658
+ if (root.prev !== undefined) out += ` ${root.prev} → ${root.value}`;
659
+ if (root.origin !== undefined && root.origin.kind !== "external") out += ` — ${formatOrigin(root.origin)}`;
660
+ return out;
661
+ }
662
+ function heldWrite(write) {
663
+ return write.prev === undefined ? write.name : `${write.name} ${write.prev} → ${write.value}`;
664
+ }
665
+
666
+ export { enablePerformanceTracks };
@@ -0,0 +1,7 @@
1
+ {
2
+ "main": "./dist/performance-tracks.js",
3
+ "module": "./dist/performance-tracks.js",
4
+ "types": "./types/index.d.ts",
5
+ "type": "module",
6
+ "sideEffects": false
7
+ }