Deploy May 7, 2026

.github/workflows/ci.yml

@@ -46,6 +46,21 @@ jobs:
         with:
           fail_ci_if_error: false
 
+  cli-tests:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+
+      - name: Setup Node.js and install dependencies
+        uses: ./.github/actions/setup-node-and-install
+
+      - name: Run CLI tests
+        run: yarn test-cli
+
   build-prod:
     runs-on: ${{ matrix.os }}
     strategy:

.gitignore

@@ -15,3 +15,4 @@ webpack.local-config.js
 *.orig
 *.rej
 .idea/
+.profiler-cli-dev/

.prettierignore

@@ -1,5 +1,6 @@
 src/profile-logic/import/proto
 src/types/libdef/npm
+profiler-cli/dist
 docs-user/js
 docs-user/css
 src/test/fixtures/upgrades

bin/output-fixing-commands.js

@@ -13,6 +13,7 @@ const fixingCommands = {
   'lint-css': 'lint-fix-css',
   'prettier-run': 'prettier-fix',
   test: 'test -u',
+  'test-cli': 'test-cli -u',
 };
 
 const command = process.argv.slice(2);

docs-developer/deploying.md

@@ -97,3 +97,61 @@ To deploy on nginx (without support for direct upload from the Firefox UI), run
 and point nginx at the `dist` directory, which needs to be at the root of the webserver. Additionally,
 a `error_page 404 =200 /index.html;` directive needs to be added so that unknown URLs respond with index.html.
 For a more production-ready configuration, have a look at the netlify [`_headers`](/res/_headers) file.
+
+# Publishing profiler-cli to npm
+
+The [`@firefox-devtools/profiler-cli`](https://www.npmjs.com/package/@firefox-devtools/profiler-cli)
+package is published to npm from this repository. It provides a command-line
+interface for querying Firefox Profiler profiles — see
+[`profiler-cli/README.md`](../profiler-cli/README.md) for usage.
+
+## Prerequisites
+
+- Be logged in to npm (`npm login`) with publish access to the `@firefox-devtools` scope.
+- Make sure the working tree is clean and you are on the commit you want to publish.
+- Run `yarn test-all` (or at least `yarn test-cli`) to confirm the CLI still builds and passes tests.
+
+## Bump the version
+
+Edit the `version` field in [`profiler-cli/package.json`](../profiler-cli/package.json),
+then land the version bump on `main` before publishing.
+
+## Publish
+
+From the repository root:
+
+```
+yarn publish-profiler-cli
+```
+
+[`scripts/publish-profiler-cli.mjs`](../scripts/publish-profiler-cli.mjs) will:
+
+1. Run `yarn build-profiler-cli` to produce `profiler-cli/dist/profiler-cli.js` (a
+   single self-contained bundle with no runtime dependencies).
+2. Run `npm publish profiler-cli/`, picking `--tag next` when the version
+   contains `-` (e.g. `0.1.0-next.1`) and `--tag latest` otherwise.
+3. Trigger the `prepublishOnly` hook in `profiler-cli/package.json`, which runs
+   [`scripts/verify-profiler-cli-build.mjs`](../scripts/verify-profiler-cli-build.mjs)
+   to confirm the bundle exists and embeds the current `package.json` version —
+   this guards against publishing a stale build.
+
+Extra arguments are forwarded to `npm publish`. For example:
+
+```
+# Build and verify, but do not actually publish.
+yarn publish-profiler-cli --dry-run
+
+# Override the automatic dist-tag.
+yarn publish-profiler-cli --tag alpha
+```
+
+## Verify the release
+
+After publishing, confirm the new version is listed on
+[npm](https://www.npmjs.com/package/@firefox-devtools/profiler-cli) and installs
+cleanly:
+
+```
+npm install -g @firefox-devtools/profiler-cli@latest
+profiler-cli --version
+```

eslint.config.mjs

@@ -18,6 +18,7 @@ export default defineConfig(
     ignores: [
       'src/profile-logic/import/proto/**',
       'src/types/libdef/npm/**',
+      'profiler-cli/dist/**',
       'res/**',
       'dist/**',
       'node-tools-dist/**',
@@ -253,7 +254,7 @@ export default defineConfig(
 
   // Test files override
   {
-    files: ['src/test/**/*'],
+    files: ['src/test/**/*', 'profiler-cli/src/test/**/*'],
     languageOptions: {
       globals: {
         ...globals.jest,

jest.config.js

@@ -2,21 +2,14 @@
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
 
-module.exports = {
-  testMatch: ['<rootDir>/src/**/*.test.{js,jsx,ts,tsx}'],
-  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx'],
-
-  // Use custom resolver that respects the "browser" field in package.json
-  resolver: './jest-resolver.js',
-
+// Shared config for projects that need a browser-like (jsdom) environment.
+// CLI unit tests use the same environment because they import browser-side
+// fixtures to construct profile data.
+const browserEnvConfig = {
   testEnvironment: './src/test/custom-environment',
   setupFilesAfterEnv: ['jest-extended/all', './src/test/setup.ts'],
-
-  collectCoverageFrom: [
-    'src/**/*.{js,jsx,ts,tsx}',
-    '!**/node_modules/**',
-    '!src/types/libdef/**',
-  ],
+  moduleFileExtensions: ['js', 'jsx', 'ts', 'tsx'],
+  resolver: './jest-resolver.js',
 
   transform: {
     '\\.([jt]sx?|mjs)$': 'babel-jest',
@@ -43,5 +36,61 @@ module.exports = {
     escapeString: true,
     printBasicPrototype: true,
   },
-  verbose: false,
+};
+
+const allProjects = [
+  // ========================================================================
+  // Browser Tests (React/browser environment)
+  // ========================================================================
+  {
+    ...browserEnvConfig,
+    displayName: 'browser',
+    testMatch: ['<rootDir>/src/**/*.test.{js,jsx,ts,tsx}'],
+
+    collectCoverageFrom: [
+      'src/**/*.{js,jsx,ts,tsx}',
+      '!**/node_modules/**',
+      '!src/types/libdef/**',
+    ],
+  },
+
+  // ========================================================================
+  // CLI Unit Tests (browser/jsdom environment - imports browser-side fixtures)
+  // ========================================================================
+  {
+    ...browserEnvConfig,
+    displayName: 'cli',
+    testMatch: ['<rootDir>/profiler-cli/src/test/unit/**/*.test.ts'],
+  },
+
+  // ========================================================================
+  // CLI Integration Tests (Node.js environment - spawns real processes)
+  // ========================================================================
+  {
+    displayName: 'cli-integration',
+    testMatch: ['<rootDir>/profiler-cli/src/test/integration/**/*.test.ts'],
+
+    testEnvironment: 'node',
+
+    setupFilesAfterEnv: ['./profiler-cli/src/test/integration/setup.ts'],
+
+    // Integration tests can be slow (loading profiles, spawning processes)
+    testTimeout: 30000,
+
+    moduleFileExtensions: ['ts', 'js'],
+
+    transform: {
+      '\\.([jt]sx?|mjs)$': 'babel-jest',
+    },
+  },
+];
+
+// Filter projects by JEST_PROJECTS env var (comma-separated displayNames).
+// Preferred over --selectProjects because that CLI flag is variadic and
+// swallows positional args like `yarn test process-profile.ts`.
+const filter = process.env.JEST_PROJECTS;
+module.exports = {
+  projects: filter
+    ? allProjects.filter((p) => filter.split(',').includes(p.displayName))
+    : allProjects,
 };

locales/en-CA/app.ftl

@@ -823,6 +823,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Deallocation Site
     .title = Summarize using bytes of memory deallocated, by the site where the memory was deallocated
 StackSettings--invert-call-stack = Invert call stack
     .title = Sort by the time spent in a call node, ignoring its children.
+StackSettings--include-idle-samples = Include idle samples
+    .title = Uncheck to hide samples whose leaf frame is in the Idle category.
 StackSettings--show-user-timing = Show user timing
 StackSettings--use-stack-chart-same-widths = Use the same width for each stack
 StackSettings--panel-search =
@@ -1149,6 +1151,12 @@ BottomBox--assembly-code-not-available-title = Assembly code not available
 # Elements:
 #   <a>link text</a> - A link to the github issue about supported scenarios.
 BottomBox--assembly-code-not-available-text = See <a>issue #4520</a> for supported scenarios and planned improvements.
+# The toggle button for making the bottom box fullscreen.
+BottomBox--hide-fullscreen =
+    .title = Exit fullscreen
+# The toggle button for making the bottom box fullscreen.
+BottomBox--show-fullscreen =
+    .title = Fullscreen
 SourceView--close-button =
     .title = Close the source view
 

locales/en-GB/app.ftl

@@ -823,6 +823,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Deallocation Site
     .title = Summarise using bytes of memory deallocated, by the site where the memory was deallocated
 StackSettings--invert-call-stack = Invert call stack
     .title = Sort by the time spent in a call node, ignoring its children.
+StackSettings--include-idle-samples = Include idle samples
+    .title = Untick to hide samples whose leaf frame is in the Idle category.
 StackSettings--show-user-timing = Show user timing
 StackSettings--use-stack-chart-same-widths = Use the same width for each stack
 StackSettings--panel-search =

locales/es-CL/app.ftl

@@ -742,6 +742,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Sitios de desasig
     .title = Resume usando bytes de memoria desasignada, por el sitio donde la memoria fue desasignada
 StackSettings--invert-call-stack = Invertir llamada de pila
     .title = Ordenar por el tiempo ocupado en un nodo de llamada, ignorando sus hijos.
+StackSettings--include-idle-samples = Incluir muestras inactivas
+    .title = Desmarca esta casilla para ocultar las muestras cuyo marco de hoja se encuentre en la categoría de inactiva.
 StackSettings--show-user-timing = Mostrar usando tiempos
 StackSettings--use-stack-chart-same-widths = Utilizar el mismo ancho para cada pila
 StackSettings--panel-search =

locales/fy-NL/app.ftl

@@ -823,6 +823,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = De-allokaasje fan
     .title = Gearfetting oan de hân fan de de-allokearre bytes ûnthâldromte, per website wêrfan de ûnthâldromte de-allokearre wie.
 StackSettings--invert-call-stack = Oanropstack omkeare
     .title = Sortearje op de tiid dy’t yn in oanropnode bestege wurdt, wêrby ûnderlizzende nodes negearre wurde
+StackSettings--include-idle-samples = Ynaktive samples opnimme
+    .title = Helje it finkje fuort om samples te ferstopjen wêrfan it leaf-frame yn de kategory Ynaktyf stiet.
 StackSettings--show-user-timing = Brûkerstiming toane
 StackSettings--use-stack-chart-same-widths = Foar elke stack deselde breedte brûke
 StackSettings--panel-search =
@@ -1149,6 +1151,12 @@ BottomBox--assembly-code-not-available-title = Gearstallingskoade net beskikber
 # Elements:
 #   <a>link text</a> - A link to the github issue about supported scenarios.
 BottomBox--assembly-code-not-available-text = Sjoch <a>issue #4520</a> foar stipjende senario's en plande ferbetteringen.
+# The toggle button for making the bottom box fullscreen.
+BottomBox--hide-fullscreen =
+    .title = Folslein skerm ferlitte
+# The toggle button for making the bottom box fullscreen.
+BottomBox--show-fullscreen =
+    .title = Folslein skerm
 SourceView--close-button =
     .title = Boarnewerjefte slute
 

locales/ia/app.ftl

@@ -807,6 +807,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Sitos de de-alloc
     .title = Summarisa per le bytes de memoria de-allocate, per le sito ubi le memoria ha essite de-allocate
 StackSettings--invert-call-stack = Inverter le pila de appello
     .title = Ordina per le tempore passate in un nodo de appello, ignorante su filios.
+StackSettings--include-idle-samples = Includer specimens inactive
+    .title = Dismarca iste option pro celar specimens cuje quadro de folio es in le categoria Inactive.
 StackSettings--show-user-timing = Monstrar temporisation de usator
 StackSettings--use-stack-chart-same-widths = Usar le mesme largessa pro cata pila
 StackSettings--panel-search =

locales/nl/app.ftl

@@ -823,6 +823,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Deallocatie van w
     .title = Samenvatting aan de hand van de gedealloceerde bytes geheugenruimte, per website waarvan de geheugenruimte was gedealloceerd.
 StackSettings--invert-call-stack = Aanroepstack omkeren
     .title = Sorteren op de tijd die in een aanroepnode wordt besteed, waarbij onderliggende nodes worden genegeerd
+StackSettings--include-idle-samples = Inactieve samples opnemen
+    .title = Haal het vinkje weg om samples te verbergen waarvan het leaf-frame zich in de categorie Inactief bevindt.
 StackSettings--show-user-timing = Gebruikerstiming tonen
 StackSettings--use-stack-chart-same-widths = Voor elke stack dezelfde breedte gebruiken
 StackSettings--panel-search =

locales/ru/app.ftl

@@ -824,6 +824,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Сайты осв
     .title = Суммировать, используя байты освобожденной памяти, по сайту, где была освобождена память
 StackSettings--invert-call-stack = Инвертировать стек вызовов
     .title = Сортировать по времени, потраченному на вызов узла, игнорируя его дочерние элементы.
+StackSettings--include-idle-samples = Включить замеры неактивности
+    .title = Снимите флажок, чтобы скрыть семплы, конечный фрейм которых находится в категории неактивных.
 StackSettings--show-user-timing = Показать время пользователя
 StackSettings--use-stack-chart-same-widths = Использовать одинаковую ширину для всех стеков
 StackSettings--panel-search =

locales/sv-SE/app.ftl

@@ -818,6 +818,8 @@ StackSettings--call-tree-strategy-native-deallocations-sites = Tilldelningswebbp
     .title = Sammanfatta med hjälp av byte av minne som delas ut efter webbplatsen där minnet tilldelades
 StackSettings--invert-call-stack = Invertera anropsstack
     .title = Sortera efter tiden i en anropsnod, utan att ignorera dess barn.
+StackSettings--include-idle-samples = Inkludera inaktiva prover
+    .title = Avmarkera för att dölja exempel vars lövram är i kategorin inaktiv.
 StackSettings--show-user-timing = Visa användartiming
 StackSettings--use-stack-chart-same-widths = Använd samma bredd för varje stack
 StackSettings--panel-search =