# jscher2000/firefox-window-autonumber architecture

> Architecture diagram of the GitHub repository jscher2000/firefox-window-autonumber, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jscher2000/firefox-window-autonumber
- Repository: https://github.com/jscher2000/firefox-window-autonumber

## Overview

This Firefox add-on keeps window titles numbered in window-ID order to stabilize their menu order. When enabled, its background script numbers existing windows and responds to window creation/removal; users can also trigger renumbering from the Tools menu or popup toolbar UI. The popup can list and filter windows, switch to one, and request tab-list permission. The README also documents a numberless option, but the supplied excerpts do not show its implementation. Relationships below are limited to the README and shown source; manifest wiring was not sampled.

Main entry points: [`window-autonumber-background.js`](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js) (Background controller), [`window-autonumber-popup.js`](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js) (Popup UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_background["Background numbering"]
  node_background["Background controller"]
  node_renumber["Title renumbering"]
  node_menu["Tools menu"]
  node_alarms["Delayed renumbering"]
end

subgraph group_popup["Popup interface"]
  node_popup["Popup UI"]
  node_windowlist["Window list"]
  node_filter["Title filtering"]
  node_prefs["Popup preferences"]
end

subgraph group_browser["Firefox services"]
  node_windowapi["Windows API"]
  node_tabsapi["Tabs API"]
  node_storage[("Extension storage")]
  node_permissions["Permissions API"]
  node_alarmservice["Alarms API"]
  node_runtime["Runtime messaging"]
end

node_user(("User"))

node_user -->|"selects command"| node_menu
node_user -->|"opens toolbar"| node_popup
node_menu -->|"requests renumber"| node_renumber
node_background -->|"initializes numbering"| node_renumber
node_background -->|"reads setting"| node_storage
node_background -->|"writes setting"| node_storage
node_background -->|"registers window events"| node_windowapi
node_renumber -->|"reads and updates"| node_windowapi
node_background -->|"schedules retry"| node_alarms
node_alarms -->|"creates alarm"| node_alarmservice
node_alarmservice -->|"dispatches alarm"| node_background
node_popup -->|"loads settings"| node_prefs
node_prefs -->|"reads preferences"| node_storage
node_popup -->|"builds list"| node_windowlist
node_windowlist -->|"gets and focuses windows"| node_windowapi
node_windowlist -->|"gets active tabs"| node_tabsapi
node_popup -->|"checks and changes"| node_permissions
node_filter -->|"filters titles"| node_windowlist
node_popup -->|"sends renumber request"| node_runtime
node_runtime -->|"dispatches request"| node_background

click node_background "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js"
click node_renumber "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js"
click node_menu "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js"
click node_alarms "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js"
click node_popup "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js"
click node_windowlist "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js"
click node_filter "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js"
click node_prefs "https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_background,node_renumber,node_menu,node_alarms,node_user toneBlue
class node_popup,node_windowlist,node_filter,node_prefs toneAmber
class node_windowapi,node_tabsapi,node_storage,node_permissions,node_alarmservice,node_runtime toneMint
```

## Components

### Background numbering

- [Background controller](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js): `window-autonumber-background.js`
- [Title renumbering](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js): `window-autonumber-background.js`
- [Tools menu](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js): `window-autonumber-background.js`
- [Delayed renumbering](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-background.js): `window-autonumber-background.js`

### Popup interface

- [Popup UI](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js): `window-autonumber-popup.js`
- [Window list](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js): `window-autonumber-popup.js`
- [Title filtering](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js): `window-autonumber-popup.js`
- [Popup preferences](https://github.com/jscher2000/firefox-window-autonumber/blob/main/window-autonumber-popup.js): `window-autonumber-popup.js`

### Firefox services

- **Windows API**
- **Tabs API**
- **Extension storage**
- **Permissions API**
- **Alarms API**
- **Runtime messaging**

### Other components

- **User**

## Connections

- User → Tools menu: selects command (evidence: `README.md`)
- User → Popup UI: opens toolbar (evidence: `README.md`)
- Tools menu → Title renumbering: requests renumber (evidence: `window-autonumber-background.js`)
- Background controller → Title renumbering: initializes numbering (evidence: `window-autonumber-background.js`)
- Background controller → Extension storage: reads setting (evidence: `window-autonumber-background.js`)
- Background controller → Extension storage: writes setting (evidence: `window-autonumber-background.js`)
- Background controller → Windows API: registers window events (evidence: `window-autonumber-background.js`)
- Title renumbering → Windows API: reads and updates (evidence: `window-autonumber-background.js`)
- Background controller → Delayed renumbering: schedules retry (evidence: `window-autonumber-background.js`)
- Delayed renumbering → Alarms API: creates alarm (evidence: `window-autonumber-background.js`)
- Alarms API → Background controller: dispatches alarm (evidence: `window-autonumber-background.js`)
- Popup UI → Popup preferences: loads settings (evidence: `window-autonumber-popup.js`)
- Popup preferences → Extension storage: reads preferences (evidence: `window-autonumber-popup.js`)
- Popup UI → Window list: builds list (evidence: `window-autonumber-popup.js`)
- Window list → Windows API: gets and focuses windows (evidence: `window-autonumber-popup.js`)
- Window list → Tabs API: gets active tabs (evidence: `window-autonumber-popup.js`)
- Popup UI → Permissions API: checks and changes (evidence: `window-autonumber-popup.js`)
- Title filtering → Window list: filters titles (evidence: `window-autonumber-popup.js`)
- Popup UI → Runtime messaging: sends renumber request (evidence: `window-autonumber-popup.js`)
- Runtime messaging → Background controller: dispatches request (evidence: `window-autonumber-background.js`)
