@node-projects/speedscope 2.1.0 → 2.2.0

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.
package/README.md CHANGED
@@ -37,6 +37,8 @@ speedscope is designed to ingest profiles from a variety of different profilers
37
37
  - [Importing from rbspy](https://github.com/jlfwong/speedscope/wiki/Importing-from-rbspy-(ruby))
38
38
  - [Importing from ruby-prof](https://github.com/jlfwong/speedscope/wiki/Importing-from-ruby-prof)
39
39
  - Python
40
+ - [Native cProfile `.prof` / `.pstats` / `.cprofile` statistics](docs/PYTHON_CPROFILE.md): flat self time and explicit immediate-caller projections, without invented full stacks.
41
+ - Python 3.15 `profiling.sampling --collapsed`: import the folded text output. Thread IDs remain stack roots and weights remain raw observation counts; see [format coverage](sample/profiles/python-sampling/README.md).
40
42
  - [Importing from py-spy](https://github.com/jlfwong/speedscope/wiki/Importing-from-py-spy-(python))
41
43
  - [pyspeedscope](https://github.com/windelbouwman/pyspeedscope)
42
44
  - [Importing from Austin](https://github.com/P403n1x87/austin-python#format-conversion)
@@ -44,6 +46,7 @@ speedscope is designed to ingest profiles from a variety of different profilers
44
46
  - PHP
45
47
  - [Importing from phpspy or sj-i/php-profiler](https://github.com/sj-i/php-profiler/pull/101)
46
48
  - Go
49
+ - [Signed pprof heap deltas and contribution-pair comparison](docs/PPROF_IMPORT.md)
47
50
  - [Importing from pprof](https://github.com/jlfwong/speedscope/wiki/Importing-from-pprof-(go))
48
51
  - Rust
49
52
  - [flamescope](https://github.com/coolreader18/flamescope)
@@ -52,31 +55,52 @@ speedscope is designed to ingest profiles from a variety of different profilers
52
55
  ](https://github.com/jlfwong/speedscope/wiki/Importing-from-async%E2%80%90profiler-(Java))
53
56
  - [Importing from Java Flight Recorder](https://github.com/jlfwong/speedscope/wiki/Importing-from-Java-Flight-Recorder)
54
57
  - [Importing Java thread dumps (`jstack` / `Thread.print`)](docs/JAVA_THREAD_DUMPS.md)
58
+ - [Importing ZIP archives of Java thread-dump snapshots](docs/JAVA_THREAD_DUMP_ZIP.md)
59
+ - Android
60
+ - [Classic Android method traces (versions 1–3)](docs/IMPORT_FORMATS.md#classic-android-method-traces)
61
+ - OpenTelemetry
62
+ - [Current OTLP Profiles JSON (sampled stacks)](docs/OTEL_PROFILES.md)
55
63
  - Erlang/Elixir
56
64
  - [eflambe](https://github.com/Stratus3D/eflambe)
57
65
  - Native code
58
66
  - [Importing from Instruments.app](https://github.com/jlfwong/speedscope/wiki/Importing-from-Instruments.app) (macOS)
59
67
  - [Importing from `perf`](https://github.com/jlfwong/speedscope/wiki/Importing-from-perf-(linux)) (linux)
68
+ — see [period weights, CPU time and inferred timelines](docs/PERF_IMPORT.md).
60
69
  - [Importing from .NET Core](https://github.com/jlfwong/speedscope/wiki/Importing-from-.NET-Core)
61
70
  - [Importing from GHC (Haskell)](https://github.com/jlfwong/speedscope/wiki/Importing-from-Haskell)
62
71
  - [Importing from custom sources](https://github.com/jlfwong/speedscope/wiki/Importing-from-custom-sources)
72
+ - [Differential folded files](docs/PROFILE_COMPARISON.md#differential-folded-files), using explicit import to preserve ordinary numeric symbol names.
73
+ - [Producer frame colors](docs/SOURCE_AND_LABELS.md), with theme contrast adaptation and exact RGB export.
63
74
 
64
75
  Contributions to add support for additional formats are welcome! Open an issue in
65
- [this fork](https://github.com/node-projects/speedscope/issues). The importer guides
66
- above are maintained upstream and remain useful for the supported file formats.
76
+ [this fork](https://github.com/node-projects/speedscope/issues). Upstream importer
77
+ guides remain useful for their formats; [fork-specific import behavior](docs/IMPORT_FORMATS.md)
78
+ documents the Android, archive, pprof and background-import policies.
67
79
  # Usage
68
80
 
69
81
  Visit [the hosted app](https://node-projects.github.io/speedscope/), then browse for a
70
82
  profile file or drag it onto the page. Imported profiles stay in your browser.
71
83
  After a successful online visit, the hosted app can reopen offline and import a
72
84
  local recording. See [offline use and update behavior](docs/OFFLINE.md).
73
-
74
- Large JSON and trace captures import in the background with progress and a
75
- **Cancel import** button. This improves responsiveness; very large captures can
85
+ Repository builds can also produce a self-contained HTML document with
86
+ `npm run build:single-file`; see [single-file builds and CSP](docs/SINGLE_FILE.md).
87
+
88
+ Recordings of at least 1 MiB use a background importer when workers are available,
89
+ including perf, folded stacks, pprof, JFR, Android traces and renamed captures.
90
+ Recognized gzip perf/folded/text files prefer a worker even when compressed
91
+ below 1 MiB.
92
+ Progress and **Cancel import** keep the app responsive. Supported perf/folded text
93
+ and duration traces stream plain/gzip input; generic fallback formats still
94
+ materialize their input. Final profile models remain proportional to recording
95
+ size. Very large captures can
76
96
  still exceed browser memory limits. Search offers Contains, Whole word and Exact
77
- matching for function names and source paths.
97
+ matching for function names and source paths. **Regex (RE2)** supports bounded,
98
+ linear-time regular-expression matching; unsupported syntax shows an error.
99
+ See [regex syntax and resource limits](docs/SEARCH_AND_LAYOUT.md#regular-expression-search).
78
100
  Graph-search navigation retains at most 10,000 results and clearly marks larger
79
101
  result sets; refine the query to narrow them. Symbol/highlight caches are bounded.
102
+ Chart search's **Zoom to match** refocuses a selected result after panning or
103
+ zooming out, while keeping measured frame widths unchanged.
80
104
  Use **Profile actions → Filter frames…** to include your code or exclude framework
81
105
  frames by file path or name. It creates a separate aggregate profile and keeps the
82
106
  original available. See [filter rules and weight semantics](docs/PROFILE_FILTERS.md).
@@ -84,6 +108,16 @@ Choose **Profile actions → Search all profiles…** to find functions across t
84
108
  and open a result in its original profile. Sandwich's table and caller/callee
85
109
  panes can now be resized with draggable or keyboard-operated dividers. See
86
110
  [search and layout controls](docs/SEARCH_AND_LAYOUT.md).
111
+ Choose **Profile actions → Compare profiles…** to compare a baseline and candidate,
112
+ including a second local recording. The differential flamegraph and paged table
113
+ show signed total/self changes, with absolute or normalized weights. Both inputs
114
+ remain in memory while comparing; graph rendering and comparison preparation have
115
+ explicit limits. See [comparison semantics and limits](docs/PROFILE_COMPARISON.md).
116
+ Use **Profile actions → Link to selected function…** to share a function selection.
117
+ For local recordings, the recipient opens the link and imports the same file.
118
+ Same-tab links and browser Back/Forward update the function selection without
119
+ reimporting the recording. Click the thread/profile selector to keep its chooser
120
+ open while selecting; it supports keyboard navigation, filtering and paging.
87
121
  Selected-stack scope names are clickable; deep stacks page through at most 100
88
122
  ancestors at a time to keep details responsive.
89
123
  Window titles identify the loaded file. Sandwich shows the selected function's
@@ -92,6 +126,9 @@ full name and source, and selected-stack details explain the statistics through
92
126
  **Profile actions** also offers configurable source-code links for VS Code or web
93
127
  repositories, and compact path labels in graphs. Full names remain searchable
94
128
  and available in details. See [source links and graph labels](docs/SOURCE_AND_LABELS.md).
129
+ Choose **Profile actions → Load linked source map…** to load a generated HTTP(S)
130
+ script's source map, review the preview and apply its original names and locations.
131
+ Local `.map` files can still be opened with Import after loading a recording.
95
132
  Duration traces stream plain/gzip input and discard unused events. Oversized
96
133
  captures stop with a clear limit error; see [import limits and measurements](docs/LARGE_TRACE_PERFORMANCE.md#streaming-duration-traces).
97
134
 
@@ -159,6 +196,10 @@ The Sandwich view is a table view in which you can find a list of all functions
159
196
 
160
197
  ## Navigation
161
198
 
199
+ **Help** opens an overlay inside the app with view descriptions, keyboard
200
+ shortcuts, import guidance and large-file/offline tips. Close it with Escape
201
+ or **Close help**; it also works without a network connection.
202
+
162
203
  Function selection follows you between Time Order, Left Heavy and Sandwich;
163
204
  each view keeps its own call instance and zoom within the active profile.
164
205
 
@@ -147,6 +147,12 @@
147
147
  "title": "col",
148
148
  "type": "number"
149
149
  },
150
+ "color": {
151
+ "description": "Producer-selected RGB color. Presentation may adapt it for text contrast.",
152
+ "pattern": "^#[0-9a-fA-F]{6}$",
153
+ "title": "color",
154
+ "type": "string"
155
+ },
150
156
  "file": {
151
157
  "title": "file",
152
158
  "type": "string"
@@ -11,7 +11,7 @@
11
11
  <link rel="icon" type="image/x-icon" href="favicon-FOKUP5Y5.ico">
12
12
  </head>
13
13
  <body>
14
- <script src="speedscope-OUBBGH23.js"></script>
14
+ <script src="speedscope-5DZPH3NW.js"></script>
15
15
 
16
16
 
17
17
 
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2023 Oleksii Vasyliev
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -1,3 +1,3 @@
1
- @node-projects/speedscope@2.1.0
2
- 2026-11-21T08:31:10.828Z
3
- 9138d9cc1a991e8f0558f108aa1907f19712fbfa
1
+ @node-projects/speedscope@2.2.0
2
+ 2026-11-21T13:54:07.001Z
3
+ c32c183a2eab8625106b3252db7b3ea46cddbaba