Gestionnaire d'onglets

# Tab Manager

Tab Manager is a Chrome Manifest V3 extension for keeping tab-heavy sessions under control from a side panel. It combines focus tools, memory-saving actions, domain grouping, snapshots, and archive into one workflow.

## What It Does

- `Focus Mode`: freezes every non-whitelist tab so you can keep only the domains that matter active.
- `Suspend Idle Tabs`: discards tabs that have been idle longer than your configured threshold.
- `Auto Group by Domain`: keeps same-domain tabs together and updates grouping for newly opened tabs.
- `Group by Domain`: manually groups tabs in the current window.
- `Ungroup Tabs`: removes all current tab groups.
- `Close Duplicates`: closes tabs with the same normalized URL.
- `Save Current Tabs`: stores the current session as a restorable snapshot.
- `Archive Idle Tabs`: moves idle tabs out of the window into the archive list.
- `Archive Restore`: restores archived tabs back into Chrome from the side panel.

## UI Overview

### Side Panel

The extension uses Chrome's side panel instead of a popup. The panel includes:

- `Live Stats`: current tab count and group count.
- `Focus Mode`: one-click freeze action for non-whitelist tabs.
- `Quick Actions`: suspend, group, ungroup, dedupe, and archive actions.
- `Auto Group by Domain`: a toggle switch with visible `On` / `Off` state.
- `Snapshots`: save, restore, and delete snapshot entries.
- `Archive`: restore archived tab batches.

### Settings Page

The settings page includes:

- `Focus Mode`: enable focus mode during background scans.
- `Idle Suspension`: set idle time and quick presets (`Light`, `Balanced`, `Aggressive`).
- `Auto-group tabs by domain`: background grouping for new or updated tabs.
- `Include pinned tabs`: allow pinned tabs to be included in group/suspend flows.
- `Auto Archive`: automatically archive tabs after a longer idle threshold.
- `Whitelist Domains`: domains that should stay active during focus, suspend, and archive flows.

## How To Use

### Open the Extension

1. Reload the extension from `chrome://extensions` after code changes.
2. Click the extension icon.
3. If Chrome does not open the side panel automatically, use Chrome's side panel UI or right-click the extension icon and choose the side panel option.

### Everyday Workflow

1. Add a few domains to `Whitelist Domains` in settings.
2. Turn on `Auto-group tabs by domain` if you want new tabs to join existing domain groups.
3. Use `Focus: Freeze Non-Whitelist` when you want an immediate focus pass.
4. Use `Suspend Idle Tabs` to reclaim memory without closing tabs.
5. Use `Save Current Tabs` before a context switch.
6. Use `Archive Idle Tabs` when you want a cleaner window, not just suspended tabs.

### Snapshots

- Click `Save Current Tabs` to capture the current session.
- Click `Restore` to reopen the saved tabs.
- Click `Delete` to remove a snapshot from storage.

### Archive

- Click `Archive Idle Tabs` to move qualifying idle tabs into archive storage.
- Archived tabs are removed from the current window.
- Click `Restore` in the archive list to reopen them.

## Behavior Notes

- Focus mode and idle suspension use `chrome.tabs.discard`, so tabs stay in Chrome and reload when revisited.
- Archive removes tabs from the window instead of discarding them.
- Auto-group works per window and attempts to add new same-domain tabs into existing matching groups.
- If a grouped tab navigates to a different domain, it is removed from the old group.
- System pages such as `chrome://` are ignored.

## Permissions

- `storage`: saves settings, snapshots, and archives.
- `tabs`: reads and manages tab state.
- `tabGroups`: creates and removes tab groups.
- `alarms`: runs periodic background scans.
- `sidePanel`: provides the side panel UI.