@node-projects/speedscope 2.0.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)
@@ -51,22 +54,83 @@ speedscope is designed to ingest profiles from a variety of different profilers
51
54
  - [Importing from async‐profiler (Java)
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)
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)
54
63
  - Erlang/Elixir
55
64
  - [eflambe](https://github.com/Stratus3D/eflambe)
56
65
  - Native code
57
66
  - [Importing from Instruments.app](https://github.com/jlfwong/speedscope/wiki/Importing-from-Instruments.app) (macOS)
58
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).
59
69
  - [Importing from .NET Core](https://github.com/jlfwong/speedscope/wiki/Importing-from-.NET-Core)
60
70
  - [Importing from GHC (Haskell)](https://github.com/jlfwong/speedscope/wiki/Importing-from-Haskell)
61
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.
62
74
 
63
75
  Contributions to add support for additional formats are welcome! Open an issue in
64
- [this fork](https://github.com/node-projects/speedscope/issues). The importer guides
65
- 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.
66
79
  # Usage
67
80
 
68
81
  Visit [the hosted app](https://node-projects.github.io/speedscope/), then browse for a
69
82
  profile file or drag it onto the page. Imported profiles stay in your browser.
83
+ After a successful online visit, the hosted app can reopen offline and import a
84
+ local recording. See [offline use and update behavior](docs/OFFLINE.md).
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
96
+ still exceed browser memory limits. Search offers Contains, Whole word and Exact
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).
100
+ Graph-search navigation retains at most 10,000 results and clearly marks larger
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.
104
+ Use **Profile actions → Filter frames…** to include your code or exclude framework
105
+ frames by file path or name. It creates a separate aggregate profile and keeps the
106
+ original available. See [filter rules and weight semantics](docs/PROFILE_FILTERS.md).
107
+ Choose **Profile actions → Search all profiles…** to find functions across threads
108
+ and open a result in its original profile. Sandwich's table and caller/callee
109
+ panes can now be resized with draggable or keyboard-operated dividers. See
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.
121
+ Selected-stack scope names are clickable; deep stacks page through at most 100
122
+ ancestors at a time to keep details responsive.
123
+ Window titles identify the loaded file. Sandwich shows the selected function's
124
+ full name and source, and selected-stack details explain the statistics through
125
+ **About these statistics**.
126
+ **Profile actions** also offers configurable source-code links for VS Code or web
127
+ repositories, and compact path labels in graphs. Full names remain searchable
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.
132
+ Duration traces stream plain/gzip input and discard unused events. Oversized
133
+ captures stop with a clear limit error; see [import limits and measurements](docs/LARGE_TRACE_PERFORMANCE.md#streaming-duration-traces).
70
134
 
71
135
  ## Command line usage
72
136
 
@@ -132,6 +196,16 @@ The Sandwich view is a table view in which you can find a list of all functions
132
196
 
133
197
  ## Navigation
134
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
+
203
+ Function selection follows you between Time Order, Left Heavy and Sandwich;
204
+ each view keeps its own call instance and zoom within the active profile.
205
+
206
+ The overview outlines the visible range. Tab to **Profile overview** for keyboard
207
+ pan, plus/minus zoom, and Home to reset. See [overview controls](docs/SEARCH_AND_LAYOUT.md#navigate-the-overview).
208
+
135
209
  Once a profile has loaded, the main view is split into two: the top area is the "minimap", and the bottom area is the "stack view".
136
210
 
137
211
  Colors follow the order of frames sorted by file path and symbol name. Frames
@@ -204,8 +278,8 @@ Publishing a GitHub release tagged `vX.Y.Z` (or `X.Y.Z`) publishes
204
278
  `@node-projects/speedscope` with that version, after tests and packaging. Prerelease
205
279
  versions or releases marked as prereleases use npm's `next` tag. Stable releases
206
280
  use `latest`. The workflow attaches standalone ZIP and npm tarball downloads to
207
- the release. npm publishing requires one-time authorization; see
208
- [release setup and operation](docs/RELEASING.md).
281
+ the release. npm trusted publishing is configured for this workflow; see
282
+ [release operation and first-publish validation](docs/RELEASING.md).
209
283
 
210
284
  Support development via [GitHub Sponsors](https://github.com/sponsors/jogibear9988)
211
285
  or [Patreon](https://www.patreon.com/jogibear9988). Funding configuration is shared
@@ -213,4 +287,9 @@ with [Web Component Designer](https://github.com/node-projects/web-component-des
213
287
 
214
288
  ## Contributing
215
289
 
290
+ The [maintained issue backlog](docs/ISSUE_BACKLOG.md) classifies all reviewed open
291
+ upstream reports as bugs, features or maintenance, including usefulness,
292
+ implementation status, remaining work and priorities. We have not fixed every
293
+ upstream issue; partial and unverified reports stay explicit in that list.
294
+
216
295
  Do you want to contribute to speedscope? Sweeeeet. Check out [CONTRIBUTING.md](./CONTRIBUTING.md) for instructions on setting up your dev environment.
package/bin/cli.mjs CHANGED
File without changes
@@ -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,8 @@
11
11
  <link rel="icon" type="image/x-icon" href="favicon-FOKUP5Y5.ico">
12
12
  </head>
13
13
  <body>
14
- <script src="speedscope-IT6IHU5E.js"></script>
14
+ <script src="speedscope-5DZPH3NW.js"></script>
15
+
15
16
 
16
17
 
17
18
 
@@ -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.0.0
2
- 2026-11-18T12:45:21.017Z
3
- ffa7a2fe0de2bc0efaadadb7127c767b8d2458d3
1
+ @node-projects/speedscope@2.2.0
2
+ 2026-11-21T13:54:07.001Z
3
+ c32c183a2eab8625106b3252db7b3ea46cddbaba