efficient-shell 4.168.0 → 4.173.0

package/README.md

@@ -965,10 +965,11 @@ All exports are named — `import { Modal, ... } from 'efficient-shell'`.
 | `<ShellAuthProvider value={{ hasAnyPerm }}>` | Permission-filter nav items. |
 | `<ShellPrefsProvider value={{ prefs, save }}>` | Where the shell reads/writes user prefs (theme, taskbar pos, sticky notes, …). Use `useLocalStoragePrefs(key)` for a backend-less default. Since 4.92.0 it is also how `<EntityList>` / `<ResizableTable>` column config and sort persist: with no provider mounted, `useShellPrefs()` reads empty and drops saves, so both silently degrade to localStorage-only and never reach the user's profile. Session restore reads `session_windows` once, at mount: hand the provider prefs that are already loaded by then (an adapter whose prefs arrive later misses that load's replay, though the saved set is kept). |
 | `<ShellStringsProvider value={{ … }} locale?>` | Translates every word the shell and the kit draw on their own account — window controls, taskbar hints, dialogs, pickers, pagers, list footers, upload zones, charts, timelines. English works with NO provider; the override is a typed partial merged per section, so an incomplete catalog falls back rather than breaking. Prop-level text (`emptyText`, placeholders) always wins over the catalog. `locale` (a BCP 47 tag) writes dates and numbers that locale's way; without one nothing moves. See [Languages, dates and numbers](#languages-dates-and-numbers--shellstringsprovider) for the full catalog. |
+| `<ShellLanguageProvider languages language strings? onChange? reload?>` | Which interface language is in force. Takes the tag `resolveShellLanguage` chose before mount and that language's shell catalog, mounts `ShellStringsProvider` with both, stamps `<html lang>`, and gives `useShellLanguage()` its `setLanguage`, which saves the choice and reloads. See [Choosing the language](#choosing-the-language--shelllanguageprovider). |
 | `<ShellEntityFetcherProvider value={(endpoint, id) => …}>` | How the modal stack fetches entity data. |
 | `<BugReportConfigProvider value={{ submit, list?, resolve? }}>` | Wire the bug-report flow to your backend. |
 | `<DesktopHostProvider value={{ stickyResolver?, saveShortcuts?, … }}>` | Sticky-note ref resolver + persistence callbacks. |
-| `<StatusBadgeProvider groups={{ status: 'success' \| ... }}>` | Status string → semantic group. |
+| `<StatusBadgeProvider groups={{ status: 'success' \| ... }} labelFor?>` | Status string → semantic group. `labelFor(status)` gives every badge under it the host's words for a status (an interface in another language passes it once); a status it returns `undefined` for keeps the derived label, and a badge's own `label` still wins. `useStatusLabel()` says a status the same way outside a badge: a filter option, a search result's second line. |
 | `<PortalBrandingProvider load={...} fallback={...}>` | Loads public hostname-scoped Company Profile identity before authentication, applies its favicon and optional derived document title, and exposes it through `usePortalBranding()`. |
 | `setShellApiClient(axios)` | Module-level: register your axios instance once. |
 | `setShellAuthBridge({ user, logout })` | Module-level: register user identity / logout handler. |
@@ -995,6 +996,7 @@ All exports are named — `import { Modal, ... } from 'efficient-shell'`.
 | `useUndoCanEdit(canEdit)` | A form's own word on whether the record may be edited right now — `useUndoCanEdit(!isLocked)`. While false the stack records nothing, ⌘Z is left alone and the footer shows no controls. A nested `<UndoProvider canEdit={false}>` in the form's JSX says the same thing: it shadows the stack for its children AND forwards the read-only claim to the window's stack, which is where the form's own `useUndoableState` calls (made above it in the tree) register. Either form of the claim makes the whole window read-only. The positive claim, `useUndoCanEdit(true)`, is how a window that edits in place outside Edit mode — a detail with inline cells behind a permission — asks the footer for the pair. |
 | `useMultiModal()` | Manages multi-window stacking + activate/blur. |
 | `useShellAuth() / useShellPrefs() / useShellEntityFetcher() / useBugReport() / useDesktopHost()` | Context readers — the shell uses these internally; consumers may also call them. |
+| `useShellLanguage()` | `{ language, languages, setLanguage }` — the active language's tag, the ones on offer, and the switch. English with nothing to switch to when no `ShellLanguageProvider` is mounted. |
 | `useShellStrings() / useShellLocale()` | The active catalog, and the provider's `locale` (`undefined` without one) — for a host cell that should write a date or a number the way the kit does. |
 
 ### Apps barrel — `efficient-shell/apps`
@@ -1475,6 +1477,35 @@ classes in `ui.css` (the timeline card's) carry pixel radii of their own.
 }
 ```
 
+**Corners.** A component does not pick a step of the scale for itself; it asks
+for the radius of what it is. Four role tokens, each defaulting to the step that
+role has always drawn, so they change nothing until you set one:
+
+| Token | Default | Drawn by |
+|---|---|---|
+| `--radius-control` | `--radius-md` (6px) | buttons, fields, a segmented control's options |
+| `--radius-card` | `--radius-lg` (8px) | `Card`, `Dialog`, a segmented control's track |
+| `--radius-popup` | `--radius-2xl` (16px) | menus, select lists, the start menu, the search palette |
+| `--radius-window` | `--radius-2xl` (16px) | windows and their title bars |
+
+They are plain custom properties: `:root { --radius-control: 2px; }` restyles
+one role and leaves the rest. Pills (switches, status badges, avatars) are round
+at every setting. Popovers, tooltips, drawers and menu rows still sit on their
+own scale steps, because each draws a different radius today and moving them
+onto a role would change how they look.
+
+**Corners is also a setting of the theme.** The `corners` preference
+(`'square' | 'soft' | 'round'`, in Customization beside the colour theme) is
+stamped on `<html>` as `data-corners` by `useTheme` and
+`applyThemePrefs({ corners })`; a host with its own switcher calls
+`applyCorners(value)`. It rescales the whole radius scale, so the roles follow
+it and so does every scale utility in your own markup, and it remaps bare
+`rounded`, which the scale cannot reach. `soft` is the absence of the attribute:
+no rule applies and your own `@theme` radii still decide. `square` and `round`
+are a person's own choice, so they win over the host's theme, the way a chosen
+colour theme does. Do not write literal radii (an arbitrary-value radius class,
+an inline `borderRadius`): they are the one thing the setting cannot reach.
+
 **Glass.** Menus, popups, listboxes and tooltips are frosted glass
 (`glassStyle()`). `--menu-opacity` (0–1, default `0.95`) sets how much shows
 through. `rosh-reduce-transparency` on `<html>` makes every popup one solid
@@ -1595,6 +1626,72 @@ the field, because what is typed there is parsed back.
 `formatDate(value, { locale, style })` or `fmtSliderDate(ms, locale)`, or hand it
 to `Intl` directly — so a host's dates and numbers read like the kit's.
 
+#### Choosing the language — `ShellLanguageProvider`
+
+`ShellStringsProvider` can speak another language; `ShellLanguageProvider` is
+what decides which. It holds the languages you offer, the one in force and the
+reader's saved choice, stamps `<html lang>`, and mounts `ShellStringsProvider`
+for you with that language's catalog and locale.
+
+A language is fixed for the life of a page. Resolve it before you mount, load
+its copy, and hand both over; `setLanguage` saves the choice and reloads. That
+is deliberate: column sets, navigation and status buckets usually read their
+copy when they are imported, a list snapshots its columns when it mounts, and
+a reload is the one switch that leaves none of them in the old language.
+
+```tsx
+import {
+  ENGLISH, ShellLanguageProvider, resolveShellLanguage, useShellLanguage,
+  type ShellLanguage,
+} from 'efficient-shell/ui';
+
+const LANGUAGES: ShellLanguage[] = [ENGLISH, { tag: 'zh-Hans', name: '简体中文' }];
+
+// Before React mounts: the saved choice, then the browser's list, then the first offered.
+const language = resolveShellLanguage({ offered: LANGUAGES });
+
+<ShellLanguageProvider
+  languages={LANGUAGES}
+  language={language}
+  strings={shellCatalogForThatLanguage}      // omit for English
+  onChange={tag => saveToTheAccount(tag)}    // awaited, then the page reloads
+>
+  <App />
+</ShellLanguageProvider>
+
+const { language, languages, setLanguage } = useShellLanguage();
+```
+
+- **Resolution.** `resolveShellLanguage` reads the choice saved on the device
+  (`SHELL_LANGUAGE_STORAGE_KEY`, `react-os-shell:language`), then
+  `navigator.languages`, then falls back to the first language offered. A
+  browser asking for `zh-CN` or `zh-SG` gets `zh-Hans`; with both Chineses on
+  offer `zh-TW` gets `zh-Hant`, and with only Simplified it gets that rather
+  than English. A saved choice that is no longer offered is skipped.
+  `matchShellLanguage(wanted, offered)` is the matching on its own.
+- **English keeps its dates and numbers.** A language's `locale` defaults to
+  its tag. `ENGLISH` carries `locale: null`, so mounting the provider for
+  English moves no date and no number: the kit writes them as it does with no
+  provider at all.
+- **The account.** `onChange` is where a host with accounts keeps the choice.
+  It is awaited before the reload, and a failure does not stop the switch: the
+  device has the choice. `saveShellLanguage(tag)` returns `true` only when the
+  write reads back, for a sign-in sync that would otherwise reload on a write
+  that never landed.
+- **`reload={false}`** leaves the switch to you: the choice is saved and
+  `onChange` runs, and you re-render the provider with the new `language` and
+  `strings`.
+
+**The windowed shell's lists, records and forms are in the catalog too.**
+`EntityList`'s row menu and its copy and export toasts (`entityList`),
+`ResizableTable`'s column chooser (`columns`), a record window with no record
+to draw (`record`), `ChangePasswordForm` (`password`), `PdfActionButton`
+(`pdfAction`), `UndoControls` (`undo`), the copy icon beside a record's number
+(`copy`), the plain "Loading..." line (`loading`) and `SoundsPanel`'s scheme
+and event names (`sounds`). Their own props — `submitLabel`, `doneLabel`, the
+PDF button's `label`, a list's `errorTitle` — still win, and the keys a sound
+scheme is stored under are identifiers, never translated.
+
 **What is not in the catalog, on purpose:** month and weekday names (the
 `locale` supplies them); file-format names in `BrandAssetEditor`'s default
 `acceptHint` and the `20ft`/`40ft` container codes (notation, not language); the
@@ -1603,7 +1700,7 @@ tables read); the sample content of the starter templates (`DashboardTemplate`,
 `AuthScreen` and the rest are demos to copy, not components to configure); and
 console warnings, which are for developers.
 
-**The full catalog** — 39 sections, 362 keys. A function's default is shown
+**The full catalog** — 55 sections, 522 keys. A function's default is shown
 with sample arguments.
 
 <details><summary><code>window</code> — 17 keys</summary>
@@ -1741,7 +1838,7 @@ with sample arguments.
 
 </details>
 
-<details><summary><code>pageTabs</code> — 13 keys</summary>
+<details><summary><code>pageTabs</code> — 16 keys</summary>
 
 | Key | Type | English default |
 |---|---|---|
@@ -1752,6 +1849,9 @@ with sample arguments.
 | `closeRight` | `string` | `Close tabs to the right` |
 | `closeAll` | `string` | `Close all tabs` |
 | `unsaved` | `string` | `Unsaved changes` |
+| `copy` | `(text: string) => string` | `Copy {text}` |
+| `copied` | `string` | `Copied` |
+| `tabMenu` | `string` | `Window menu` |
 | `discardTitle` | `string` | `Discard unsaved changes?` |
 | `discardOne` | `string` | `This page has changes that have not been saved. Close it anyway?` |
 | `discardMany` | `string` | `pages have changes that have not been saved. Close them anyway?` |
@@ -1845,11 +1945,12 @@ with sample arguments.
 
 </details>
 
-<details><summary><code>list</code> — 8 keys</summary>
+<details><summary><code>list</code> — 9 keys</summary>
 
 | Key | Type | English default |
 |---|---|---|
 | `selected` | `(count: number) => string` | `3 selected` |
+| `selectedNotShown` | `(count: number, notShown: number) => string` | `3 selected, 3 not shown` |
 | `allLoaded` | `(total: number, label: string) => string` | `All 3 {label} loaded` |
 | `count` | `(total: number, label: string) => string` | `3 {label}` |
 | `loadedOf` | `(loaded: number, total: number, label: string) => string` | `3 of 3 {label}` |
@@ -1929,13 +2030,15 @@ with sample arguments.
 
 </details>
 
-<details><summary><code>copy</code> — 5 keys</summary>
+<details><summary><code>copy</code> — 7 keys</summary>
 
 | Key | Type | English default |
 |---|---|---|
 | `copy` | `string` | `Copy` |
 | `copyLabel` | `(label: string) => string` | `Copy {label}` |
 | `copied` | `string` | `Copied` |
+| `copyValue` | `(value: string) => string` | `Copy {value}` |
+| `copiedValue` | `string` | `Copied!` |
 | `copiedLabel` | `(label: string) => string` | `{label} copied` |
 | `failed` | `string` | `Could not copy to the clipboard` |
 
@@ -2052,6 +2155,60 @@ with sample arguments.
 
 </details>
 
+<details><summary><code>resizeHandle</code> — 2 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `label` | `string` | `Resize panel` |
+| `hint` | `string` | `Drag to resize · double-click to reset` |
+
+</details>
+
+<details><summary><code>number</code> — 2 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `increase` | `string` | `Increase` |
+| `decrease` | `string` | `Decrease` |
+
+</details>
+
+<details><summary><code>slider</code> — 1 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `value` | `(label: string) => string` | `{label} value` |
+
+</details>
+
+<details><summary><code>color</code> — 9 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `swatch` | `(label: string, value: string) => string` | `{label}: {value}` |
+| `none` | `string` | `None` |
+| `panel` | `(label: string) => string` | `{label} picker` |
+| `square` | `string` | `Saturation and brightness` |
+| `squareValue` | `(saturation: number, brightness: number) => string` | `Saturation 3%, brightness 3%` |
+| `hue` | `string` | `Hue` |
+| `hex` | `(label: string) => string` | `{label} hex code` |
+| `presets` | `string` | `Presets` |
+| `clear` | `string` | `No color` |
+
+</details>
+
+<details><summary><code>tree</code> — 5 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `empty` | `string` | `Nothing here yet` |
+| `dropHere` | `string` | `Drop here` |
+| `dragHint` | `string` | `Drag to move` |
+| `moveHint` | `string` | `Alt+Arrow Up or Alt+Arrow Down moves it` |
+| `insertHere` | `string` | `Insert here` |
+
+</details>
+
 <details><summary><code>layout</code> — 17 keys</summary>
 
 | Key | Type | English default |
@@ -2276,6 +2433,183 @@ with sample arguments.
 
 </details>
 
+<details><summary><code>map</code> — 14 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `failed` | `string` | `The map could not be drawn here. The list has everything it shows.` |
+| `approximate` | `(label: string) => string` | `{label}, approximate location` |
+| `approximateTitle` | `(label: string) => string` | `{label} (approximate)` |
+| `places` | `(count: number) => string` | `places` (`place` for one) |
+| `group` | `(count: number, noun: string) => string` | `3 {noun} here` |
+| `stops` | `(numbers: string) => string` | `Stops {numbers}` |
+| `closeBy` | `(count: number, noun: string) => string` | `3 more {noun} close by, drawn when the map is closer` |
+| `spread` | `string` | `Press to see them apart` |
+| `cycle` | `string` | `They stand on one spot: press for the next of them` |
+| `fullScreen` | `string` | `Full screen` |
+| `leaveFullScreen` | `string` | `Leave full screen` |
+| `chosen` | `(label: string) => string` | `{label}, chosen on the map` |
+| `closeCard` | `string` | `Close` |
+| `openRecord` | `string` | `Open` |
+
+</details>
+
+<details><summary><code>pdf</code> — 16 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `previousPage` | `string` | `Previous page` |
+| `nextPage` | `string` | `Next page` |
+| `pageOf` | `(page: number, total: number) => string` | `2 / 5` |
+| `zoomOut` | `string` | `Zoom out` |
+| `zoomIn` | `string` | `Zoom in` |
+| `zoom` | `string` | `Zoom` |
+| `fitWidth` | `string` | `Fit width` |
+| `fitPage` | `string` | `Fit page` |
+| `fit` | `string` | `Fit` |
+| `fitHint` | `string` | `Fit to the pane: follows its size until you zoom by hand` |
+| `print` | `string` | `Print` |
+| `download` | `string` | `Download` |
+| `email` | `string` | `Email` |
+| `loading` | `string` | `Loading PDF…` |
+| `loadFailed` | `string` | `Failed to load PDF` |
+| `allowPopups` | `string` | `Allow popups to print` |
+
+</details>
+
+<details><summary><code>loading</code> — 1 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `label` | `string` | `Loading...` |
+
+</details>
+
+<details><summary><code>entityList</code> — 15 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `open` | `string` | `Open` |
+| `copy` | `string` | `Copy` |
+| `copyColumn` | `(column: string) => string` | `Copy {column}` |
+| `copyRows` | `(count: number) => string` | `Copy 3 rows` (`Copy row` for one) |
+| `exportSelected` | `string` | `Export selected to CSV` |
+| `selectAll` | `string` | `Select all` |
+| `selectAllLoaded` | `(loaded: number) => string` | `Select all 3 loaded` |
+| `clearSelection` | `string` | `Clear selection` |
+| `refresh` | `string` | `Refresh` |
+| `copiedText` | `string` | `Text` |
+| `copiedRows` | `(count: number) => string` | `3 rows` (`Row` for one) |
+| `exported` | `(count: number) => string` | `Exported 3 rows.` (`Exported 1 row.` for one) |
+| `exportTruncated` | `(kept: number, asked: number) => string` | `Exported 5000 of 8000 rows. The server capped this export, so the file is incomplete.` |
+| `exportTruncatedUnknown` | `(asked: number) => string` | `Exported only some of the 8000 rows. The server capped this export, so the file is incomplete.` |
+| `exportFailed` | `string` | `CSV export failed.` |
+
+</details>
+
+<details><summary><code>columns</code> — 9 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `choose` | `string` | `Choose columns` |
+| `heading` | `string` | `Columns` |
+| `reset` | `string` | `Reset` |
+| `saveDefault` | `string` | `Save as default for all users` |
+| `savedDefault` | `string` | `Saved as default` |
+| `select` | `string` | `Select` |
+| `selectDone` | `string` | `Done` |
+| `showSelection` | `string` | `Show selection column` |
+| `hideSelection` | `string` | `Hide selection column` |
+
+</details>
+
+<details><summary><code>record</code> — 8 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `loading` | `string` | `Loading record…` |
+| `signInRequired` | `string` | `Sign in required` |
+| `signInBody` | `string` | `Your session may have expired. Sign in again to open this record.` |
+| `notFound` | `string` | `Record not found` |
+| `loadFailed` | `string` | `Couldn't load record` |
+| `checkConnection` | `string` | `Check your connection and try again.` |
+| `rejected` | `string` | `The server rejected this request.` |
+| `retry` | `string` | `Try again` |
+
+</details>
+
+<details><summary><code>password</code> — 11 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `current` | `string` | `Current Password` |
+| `newPassword` | `string` | `New Password` |
+| `confirm` | `string` | `Confirm Password` |
+| `submit` | `string` | `Change Password` |
+| `submitting` | `string` | `Changing...` |
+| `done` | `string` | `Done` |
+| `currentRequired` | `string` | `Current password is required.` |
+| `tooShort` | `(minLength: number) => string` | `New password must be at least 8 characters.` |
+| `mismatch` | `string` | `Passwords do not match.` |
+| `failed` | `string` | `Failed to change password.` |
+| `changed` | `string` | `Your password has been changed successfully.` |
+
+</details>
+
+<details><summary><code>pdfAction</code> — 10 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `label` | `string` | `PDF` |
+| `loading` | `string` | `Loading...` |
+| `preview` | `string` | `Preview` |
+| `download` | `string` | `Download` |
+| `email` | `string` | `Send by Email` |
+| `downloaded` | `(filename: string) => string` | `{filename} downloaded.` |
+| `tookTooLong` | `(filename: string) => string` | `{filename} took too long to load. Please try again.` |
+| `previewLoading` | `string` | `LOADING PDF` |
+| `previewTookTooLong` | `string` | `This document took too long to load. Close this window and try again.` |
+| `previewFailed` | `string` | `Failed to load PDF.` |
+
+</details>
+
+<details><summary><code>undo</code> — 6 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `undo` | `string` | `Undo` |
+| `redo` | `string` | `Redo` |
+| `undoStep` | `(label: string, keys: string) => string` | `Undo {label} ({keys})` |
+| `redoStep` | `(label: string, keys: string) => string` | `Redo {label} ({keys})` |
+| `nothingToUndo` | `string` | `Nothing to undo` |
+| `nothingToRedo` | `string` | `Nothing to redo` |
+
+</details>
+
+<details><summary><code>sounds</code> — 17 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `title` | `string` | `Sounds` |
+| `enable` | `string` | `Sound effects` |
+| `autosave` | `string` | `Changes are saved automatically` |
+| `choice` | `(event: string, pack: string) => string` | `{event} — {pack}` |
+| `packClassic` | `string` | `Classic` |
+| `packMinimal` | `string` | `Minimal` |
+| `packRetro` | `string` | `Retro` |
+| `packSoft` | `string` | `Soft` |
+| `packArcade` | `string` | `Arcade` |
+| `packSilent` | `string` | `Silent` |
+| `eventClick` | `string` | `Click` |
+| `eventSuccess` | `string` | `Success` |
+| `eventError` | `string` | `Error` |
+| `eventNotification` | `string` | `Notification` |
+| `eventStartup` | `string` | `Startup` |
+| `eventTimerDone` | `string` | `Timer` |
+| `eventLogout` | `string` | `Logout` |
+
+</details>
+
 ### Brand surfaces — `efficient-shell/brand.css`
 
 For output that is not a portal window — a report, a published artifact, a
@@ -2553,8 +2887,8 @@ missing or cannot be read. All of them are also exported from
 | `formatTime(value, options?)` | `9:30 am` — twelve-hour, small am/pm; a `locale` gives the locale's own clock. |
 | `getUserTimezone()`, `setUserTimezone(zone)`, `syncTimezoneFromProfile(zone)`, `TZ_AUTO` | The zone setting. `undefined` / `'auto'` follow the browser. Call `syncTimezoneFromProfile` when the signed-in user loads; a blank value changes nothing. |
 | `getUserDateFormat()`, `setUserDateFormat(key)`, `DATE_FORMAT_OPTIONS` | The format setting and the 16 formats a settings page offers. |
-| `timeAgo(value, { precise? })` | `just now` under a minute, then `5m ago`, `3h ago`, `2d ago`; from seven days on the date (`formatDate`). A future time is `just now`. `precise` counts seconds (`12s ago`) for a status screen. Takes a string, a `Date` or epoch ms. |
-| `<TimeAgo value precise? className? />` | `timeAgo` in a `<time>` whose hover (`title`) is the full `formatDateTime`. Use it wherever a relative time is shown. |
+| `timeAgo(value, { precise? })` | `just now` under a minute, then `5m ago`, `3h ago`, `2d ago`; from seven days on the date (`formatDate`). A future time is `just now`. `precise` counts seconds (`12s ago`) for a status screen. Takes a string, a `Date` or epoch ms. With `locale` (a BCP 47 tag) the words are `Intl.RelativeTimeFormat`'s in that language, and the fallback date is written in it too. |
+| `<TimeAgo value precise? locale? className? />` | `timeAgo` in a `<time>` whose hover (`title`) is the full `formatDateTime`. Use it wherever a relative time is shown. It follows `ShellStringsProvider`'s `locale`; pass `locale` to override. |
 | `setCurrencyFormats(catalog)` | Hand the kit the currency catalog (`/api/currencies/`: `{ AUD: { symbol: 'A$', decimals: 2 }, … }`) once a session starts. Until then amounts show their code. |
 | `formatMoney(amount, currency?, { whole? })` | `A$1,234.50`, `-€50.00`, `CHF 1,200.00`. The catalog's symbol — an unknown code prints as the code, never a guessed `$`. Minus first, commas, the catalog's decimals (2 by default); `whole` drops them (`A$3,841`) for a storefront card. No currency prints the bare figure. Takes a number or the API's string. |
 | `currencySymbol(code)`, `currencyDecimals(code)` | The two catalog lookups `formatMoney` uses. |
@@ -2581,6 +2915,68 @@ missing or cannot be read. All of them are also exported from
 | `dismissPopups()`, `OVERLAY_OPEN_EVENT` | An overlay calls `dismissPopups()` as it opens; every open kit popup (`Select`, `SearchableSelect`, `TagInput`, `DatePicker`, `DateRangePicker`, `PopupMenu` via its `onClose`, `ServerStatusIndicator`) closes rather than floating over the overlay. The kit's own overlays already call it. A consumer's own popup listens for `OVERLAY_OPEN_EVENT` on `window` while open. |
 | `Kbd` constants — `MOD`, `ALT`, `SHIFT`, `ENTER`, `ALT_SHIFT_E`, `CMD_K`, … | Symbol constants for rendering keyboard shortcuts. |
 
+### Icons — `efficient-shell/icons`
+
+Every icon comes through this package (harness UI-24). A component asks for an
+icon by what it **means**, and the set the theme chose draws it:
+
+```tsx
+import { Icon, registerIconSet } from 'efficient-shell/icons';
+import { heroicons } from 'efficient-shell/icons/heroicons';
+
+registerIconSet(heroicons);              // once, at startup, in client code
+
+<Icon name="trash" />                     // 1em square, the text's colour
+<Icon name="search" size={20} tone="muted" />
+<Icon name="warning" title="Overdue" />   // named: an image, not decoration
+```
+
+`Icon` and the registry are also exported from `efficient-shell/ui` and the
+root entry. They import React and nothing else.
+
+**The catalogue.** `IconName` is 197 meanings (`add`, `close`, `edit`, `trash`,
+`search`, `download`, `chevron-down`, `warning`, …), built from the icons the
+EFFICIENT frontends import today. `<Icon name>` is typed to it, so a misspelt
+meaning does not compile. To add one, add it to `src/icons/catalogue.json` with
+its icon in every package and run `npm run icons`.
+
+**The sets.** Each is its own subpath, so a host bundles only what it
+registers, and the icon package behind it is an optional peer:
+
+| Import | Set | Draws | Needs |
+|---|---|---|---|
+| `efficient-shell/icons/heroicons` | `heroicons` | the whole catalogue | `@heroicons/react` |
+| `efficient-shell/icons/lucide` | `lucide` | the whole catalogue | `lucide-react` (0.577 or later) |
+| `efficient-shell/icons/efficient` | `efficient` | the 165 house glyphs, which draw 58 of the catalogue meanings | nothing |
+
+The first set registered is the default (`setDefaultIconSet(name)` changes
+that). A meaning the chosen set does not draw falls back to the default set, so
+a partial set never leaves a hole.
+
+**Part of the theme.** The `icon_set` preference sits beside the colour theme
+and the corners: `useTheme` and `applyThemePrefs({ icon_set })` choose the set
+and stamp `data-icon-set` on `<html>`, and every `<Icon>` on the page redraws.
+A host with its own switcher calls `applyIconSet(name)` or `setIconSet(name)`;
+`iconSets()` lists what is registered. Like `corners`, a call without the key
+leaves the choice alone.
+
+**A product's own glyphs.** An editor's block types and settings rows are not
+in the catalogue. Register them and draw them by `glyph`, with no icon package
+imported:
+
+```tsx
+registerIcons('editor', { 'block-product': BlockProductGlyph });
+<Icon glyph="block-product" />
+```
+
+They are found under any theme. `efficient-shell/icons/efficient` also exports
+each house glyph as a component (`TrashIcon`, `StylesIcon`, `PaddingTopIcon`,
+…, `size` 18 by default) for code that wants one drawing whatever the theme.
+
+With no set registered, `<Icon>` draws nothing and warns once per meaning. The
+kit's own components (a window's close button, a filter chip) keep drawing
+through a built-in fallback, so a host that registers nothing sees no change.
+
 ### The UI kit check — `efficient-shell-ui-check`
 
 Every surface a person operates takes its UI from this package (harness
@@ -2616,9 +3012,10 @@ itself where the kit has an answer:
 | `native` | `window.confirm` / `alert` / `prompt`, or a bare call nothing in the file binds | `confirm`, `confirmDestructive`, `prompt`, `toast` |
 | `dark` | a `dark:` variant in a class string | the light class alone; the kit remaps it |
 | `hex` | a hex colour in a `.tsx` string (not in `href`, `to`, `id`, `key`, `htmlFor`) | a token or a palette class |
+| `radius` | a literal corner radius: an arbitrary-value radius class (`rounded-[4px]`) or an inline `borderRadius` number or length (not `inherit`, `var(…)`, `50%` or `9999`) | a scale utility or a role token; the theme's Corners setting shapes them |
 | `kit` | an import of a second UI kit (`@headlessui`, `@radix-ui`, `@mui`, `antd`, `sonner`, …) | the kit's component |
-| `icon` | an import of an icon package (`@heroicons`, `lucide-react`, `@tabler/icons`, …) | the icon through this package |
-| `kit-dep` | one of those packages declared in `package.json` (not `devDependencies`) | remove it |
+| `icon` | an import of an icon package (`@heroicons`, `lucide-react`, `@tabler/icons`, …) | `<Icon name>` from `efficient-shell/icons` |
+| `kit-dep` | one of those packages declared in `package.json` (not `devDependencies`, and not one the shell needs from an entry the repository imports: `@headlessui/react` and `@heroicons/react` for the root entry, an icon set's own package) | remove it |
 
 Known gaps: `rgb()` / `hsl()` colours, colours in `.ts` maps, and
 `createElement('button')` are not counted.

package/dist/{Browser-PZPREN6H.js → Browser-X7UTQJOX.js}

@@ -1,29 +1,29 @@
-import{peekBrowserStartUrl as e,claimBrowserStartUrl as t}from"./chunk-LWLCNQY7.js";import{AboutApp as o}from"./chunk-6MBERZOS.js";import"./chunk-7U3F53IG.js";import{WindowTitle as r}from"./chunk-LW27IM3S.js";import"./chunk-A7Q4BCPI.js";import"./chunk-DSSLOQDW.js";import"./chunk-5A7MWTXX.js";import"./chunk-JYLI2WXW.js";import"./chunk-6KO2U66R.js";import{confirm as n}from"./chunk-M4DB7UBZ.js";import"./chunk-N3ZXQE4M.js";import"./chunk-AFYQTVZO.js";import"./chunk-HZZNJHRH.js";import"./chunk-X4FJ54PP.js";import"./chunk-NCQLGQYR.js";import"./chunk-D65T4H6J.js";import{useRef as a,useEffect as i,useState as s}from"react";import{jsxs as l,jsx as c,Fragment as m}from"react/jsx-runtime";var d="react-os-shell:browser-bookmarks",u="react-os-shell:browser-homepage",h="https://en.wikipedia.org/wiki/Main_Page",p=[{label:"Wikipedia",url:"https://en.wikipedia.org/wiki/Main_Page"},{label:"DevDocs",url:"https://devdocs.io"},{label:"Example",url:"https://example.com"}],g=new Set(["ac ad ae af ag ai al am ao aq ar as at au aw ax az ba bb bd be bf bg bh bi","bj bm bn bo br bs bt bw by bz ca cc cd cf cg ch ci ck cl cm cn co cr cu cv","cw cx cy cz de dj dk dm do dz ec ee eg er es et eu fi fj fk fm fo fr ga gd","ge gf gg gh gi gl gm gn gp gq gr gs gt gu gw gy hk hm hn hr ht hu id ie il","im in io iq ir is it je jm jo jp ke kg kh ki km kn kp kr kw ky kz la lb lc","li lk lr ls lt lu lv ly ma mc md me mg mh mk ml mm mn mo mp mq mr ms mt mu","mv mw mx my mz na nc ne nf ng ni nl no np nr nu nz om pa pe pf pg ph pk pl","pm pn pr ps pt pw py qa re ro rs ru rw sa sb sc sd se sg sh si sk sl sm sn","so sr ss st su sv sx sy sz tc td tf tg th tj tk tl tm tn to tr tt tv tw tz","ua ug uk us uy uz va vc ve vg vi vn vu wf ws ye yt za zm zw","com net org edu gov mil int info biz name pro app dev xyz online site tech","store shop cloud design digital agency studio media news blog live life","world today email systems solutions services software page link space host","press wiki team group works careers finance capital energy academy"].join(" ").split(" "));function b(e){let t=e.trim();return t?/^[a-z][a-z0-9+.-]*:\/\//i.test(t)?t:function(e){const t=/^([\w-]+\.)+([a-z]{2,})(\/.*)?$/i.exec(e);return null!==t&&g.has(t[2].toLowerCase())}(t)?"https://"+t:"https://duckduckgo.com/?q="+encodeURIComponent(t):""}var k=["duckduckgo.com","developer.mozilla.org","google.com","gmail.com","youtube.com","facebook.com","instagram.com","whatsapp.com","twitter.com","x.com","github.com","gitlab.com","linkedin.com","reddit.com","pinterest.com","amazon.com","amazon.ca","amazon.co.uk","apple.com","icloud.com","microsoft.com","outlook.com","live.com","office.com","netflix.com","spotify.com","paypal.com","stripe.com","chat.openai.com","chatgpt.com","claude.ai"];function f(){if("undefined"==typeof window)return p;try{const e=localStorage.getItem(d);if(!e)return p;const t=JSON.parse(e);if(Array.isArray(t)&&t.every(e=>"string"==typeof e?.url))return t}catch{}return p}function x(){return"undefined"==typeof window?h:localStorage.getItem(u)||h}function w(){const m=a(void 0);void 0===m.current&&(m.current=e()),i(()=>{null!=m.current&&t(m.current)},[]);const h=m.current?b(m.current.url):"",[p,g]=s(x),[k,w]=s(h||p),[N,L]=s(k),[j,C]=s([k]),[z,M]=s(0),[W,S]=s(0),[R,B]=s(f),[H,A]=s(!1),[E,D]=s(null),I=a(null),O=a(null);i(()=>{try{localStorage.setItem(d,JSON.stringify(R))}catch{}},[R]);const T=e=>{const t=b(e);t&&(w(t),L(t),C(e=>{const o=e.slice(0,z+1);return o.push(t),o}),M(e=>e+1),A(!1))},U=()=>{"undefined"!=typeof window&&window.open(k,"_blank","noopener,noreferrer")},P=()=>{const e=E?.trim();e?(B(t=>[...t,{label:e,url:k}]),D(null)):D(null)};i(()=>{if(null===E)return;I.current?.focus(),I.current?.select();const e=e=>{const t=e.target;t?.closest("[data-bookmark-popover]")||D(null)},t=setTimeout(()=>document.addEventListener("mousedown",e),0);return()=>{clearTimeout(t),document.removeEventListener("mousedown",e)}},[null!==E]);const F=e=>{B(t=>t.filter((t,o)=>o!==e))},Q=z>0,X=z<j.length-1,q=R.some(e=>e.url===k),J="p-1.5 rounded hover:bg-gray-200 transition-colors text-gray-600 disabled:opacity-30";/* @__PURE__ */
+import{peekBrowserStartUrl as e,claimBrowserStartUrl as t}from"./chunk-LWLCNQY7.js";import{AboutApp as o}from"./chunk-XHWT4DH2.js";import{WindowTitle as r}from"./chunk-X5LH3UOJ.js";import"./chunk-DSSLOQDW.js";import"./chunk-6TDPY7WG.js";import"./chunk-XJX3NA37.js";import"./chunk-CQN5CFKA.js";import"./chunk-5A7MWTXX.js";import"./chunk-EXXHI5DO.js";import"./chunk-PGVUO7GB.js";import"./chunk-HZZNJHRH.js";import"./chunk-D65T4H6J.js";import{confirm as n}from"./chunk-FIGVDYJR.js";import"./chunk-AFYQTVZO.js";import"./chunk-X4FJ54PP.js";import"./chunk-S5QF4VFG.js";import"./chunk-YKZHOXI4.js";import{useRef as a,useEffect as i,useState as s}from"react";import{jsxs as l,jsx as c,Fragment as m}from"react/jsx-runtime";var d="react-os-shell:browser-bookmarks",u="react-os-shell:browser-homepage",h="https://en.wikipedia.org/wiki/Main_Page",p=[{label:"Wikipedia",url:"https://en.wikipedia.org/wiki/Main_Page"},{label:"DevDocs",url:"https://devdocs.io"},{label:"Example",url:"https://example.com"}],g=new Set(["ac ad ae af ag ai al am ao aq ar as at au aw ax az ba bb bd be bf bg bh bi","bj bm bn bo br bs bt bw by bz ca cc cd cf cg ch ci ck cl cm cn co cr cu cv","cw cx cy cz de dj dk dm do dz ec ee eg er es et eu fi fj fk fm fo fr ga gd","ge gf gg gh gi gl gm gn gp gq gr gs gt gu gw gy hk hm hn hr ht hu id ie il","im in io iq ir is it je jm jo jp ke kg kh ki km kn kp kr kw ky kz la lb lc","li lk lr ls lt lu lv ly ma mc md me mg mh mk ml mm mn mo mp mq mr ms mt mu","mv mw mx my mz na nc ne nf ng ni nl no np nr nu nz om pa pe pf pg ph pk pl","pm pn pr ps pt pw py qa re ro rs ru rw sa sb sc sd se sg sh si sk sl sm sn","so sr ss st su sv sx sy sz tc td tf tg th tj tk tl tm tn to tr tt tv tw tz","ua ug uk us uy uz va vc ve vg vi vn vu wf ws ye yt za zm zw","com net org edu gov mil int info biz name pro app dev xyz online site tech","store shop cloud design digital agency studio media news blog live life","world today email systems solutions services software page link space host","press wiki team group works careers finance capital energy academy"].join(" ").split(" "));function b(e){let t=e.trim();return t?/^[a-z][a-z0-9+.-]*:\/\//i.test(t)?t:function(e){const t=/^([\w-]+\.)+([a-z]{2,})(\/.*)?$/i.exec(e);return null!==t&&g.has(t[2].toLowerCase())}(t)?"https://"+t:"https://duckduckgo.com/?q="+encodeURIComponent(t):""}var k=["duckduckgo.com","developer.mozilla.org","google.com","gmail.com","youtube.com","facebook.com","instagram.com","whatsapp.com","twitter.com","x.com","github.com","gitlab.com","linkedin.com","reddit.com","pinterest.com","amazon.com","amazon.ca","amazon.co.uk","apple.com","icloud.com","microsoft.com","outlook.com","live.com","office.com","netflix.com","spotify.com","paypal.com","stripe.com","chat.openai.com","chatgpt.com","claude.ai"];function f(){if("undefined"==typeof window)return p;try{const e=localStorage.getItem(d);if(!e)return p;const t=JSON.parse(e);if(Array.isArray(t)&&t.every(e=>"string"==typeof e?.url))return t}catch{}return p}function x(){return"undefined"==typeof window?h:localStorage.getItem(u)||h}function w(){const m=a(void 0);void 0===m.current&&(m.current=e()),i(()=>{null!=m.current&&t(m.current)},[]);const h=m.current?b(m.current.url):"",[p,g]=s(x),[k,w]=s(h||p),[N,L]=s(k),[j,C]=s([k]),[z,H]=s(0),[M,W]=s(0),[S,R]=s(f),[A,D]=s(!1),[B,O]=s(null),X=a(null),E=a(null);i(()=>{try{localStorage.setItem(d,JSON.stringify(S))}catch{}},[S]);const T=e=>{const t=b(e);t&&(w(t),L(t),C(e=>{const o=e.slice(0,z+1);return o.push(t),o}),H(e=>e+1),D(!1))},F=()=>{"undefined"!=typeof window&&window.open(k,"_blank","noopener,noreferrer")},I=()=>{const e=B?.trim();e?(R(t=>[...t,{label:e,url:k}]),O(null)):O(null)};i(()=>{if(null===B)return;X.current?.focus(),X.current?.select();const e=e=>{const t=e.target;t?.closest("[data-bookmark-popover]")||O(null)},t=setTimeout(()=>document.addEventListener("mousedown",e),0);return()=>{clearTimeout(t),document.removeEventListener("mousedown",e)}},[null!==B]);const P=e=>{R(t=>t.filter((t,o)=>o!==e))},V=z>0,G=z<j.length-1,J=S.some(e=>e.url===k),U="p-1.5 rounded hover:bg-gray-200 transition-colors text-gray-600 disabled:opacity-30";/* @__PURE__ */
 return l("div",{className:"relative flex flex-col h-full bg-white",children:[
 /* @__PURE__ */c(r,{title:`Browser - ${v(k)}`}),
 /* @__PURE__ */c(o,{app:"browser"}),
 /* @__PURE__ */l("div",{className:"flex items-center gap-1 px-2 py-1.5 border-b border-gray-200 bg-gray-50 shrink-0",children:[
-/* @__PURE__ */c("button",{onClick:()=>{if(z>0){const e=z-1;M(e),w(j[e]),L(j[e]),A(!1)}},disabled:!Q,className:J,title:"Back",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:2,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M15.75 19.5L8.25 12l7.5-7.5"})})}),
-/* @__PURE__ */c("button",{onClick:()=>{if(z<j.length-1){const e=z+1;M(e),w(j[e]),L(j[e]),A(!1)}},disabled:!X,className:J,title:"Forward",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:2,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M8.25 4.5l7.5 7.5-7.5 7.5"})})}),
-/* @__PURE__ */c("button",{onClick:()=>S(e=>e+1),className:J,title:"Refresh",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.8,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M16.023 9.348h4.992V4.356M2.985 19.644v-4.992h4.992M3.05 9.348a9 9 0 0114.85-3.36L21.015 9.348m0 5.304a9 9 0 01-14.85 3.36l-3.115-3.36"})})}),
-/* @__PURE__ */c("button",{onClick:()=>T(p),className:J,title:"Home",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.8,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M2.25 12l8.954-8.955a1.5 1.5 0 012.122 0l8.954 8.955M4.5 9.75v10.125c0 .621.504 1.125 1.125 1.125H9.75v-4.875c0-.621.504-1.125 1.125-1.125h2.25c.621 0 1.125.504 1.125 1.125V21h4.125c.621 0 1.125-.504 1.125-1.125V9.75M8.25 21h8.25"})})}),
+/* @__PURE__ */c("button",{onClick:()=>{if(z>0){const e=z-1;H(e),w(j[e]),L(j[e]),D(!1)}},disabled:!V,className:U,title:"Back",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:2,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M15.75 19.5L8.25 12l7.5-7.5"})})}),
+/* @__PURE__ */c("button",{onClick:()=>{if(z<j.length-1){const e=z+1;H(e),w(j[e]),L(j[e]),D(!1)}},disabled:!G,className:U,title:"Forward",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:2,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M8.25 4.5l7.5 7.5-7.5 7.5"})})}),
+/* @__PURE__ */c("button",{onClick:()=>W(e=>e+1),className:U,title:"Refresh",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.8,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M16.023 9.348h4.992V4.356M2.985 19.644v-4.992h4.992M3.05 9.348a9 9 0 0114.85-3.36L21.015 9.348m0 5.304a9 9 0 01-14.85 3.36l-3.115-3.36"})})}),
+/* @__PURE__ */c("button",{onClick:()=>T(p),className:U,title:"Home",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.8,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M2.25 12l8.954-8.955a1.5 1.5 0 012.122 0l8.954 8.955M4.5 9.75v10.125c0 .621.504 1.125 1.125 1.125H9.75v-4.875c0-.621.504-1.125 1.125-1.125h2.25c.621 0 1.125.504 1.125 1.125V21h4.125c.621 0 1.125-.504 1.125-1.125V9.75M8.25 21h8.25"})})}),
 /* @__PURE__ */c("form",{onSubmit:e=>{e.preventDefault(),T(N)},className:"flex-1 flex items-center mx-1",children:/* @__PURE__ */l("div",{className:"flex items-center w-full bg-white border border-gray-300 rounded focus-within:border-blue-400 focus-within:ring-1 focus-within:ring-blue-200",children:[
 /* @__PURE__ */c("span",{className:"px-2 text-gray-400 text-xs",children:k.startsWith("https://")?"🔒":"⚠️"}),
 /* @__PURE__ */c("input",{type:"text",value:N,onChange:e=>L(e.target.value),onFocus:e=>e.target.select(),className:"flex-1 px-1 py-1 text-sm bg-transparent outline-none font-mono",spellCheck:!1,placeholder:"Enter URL or search…"}),k!==N&&/* @__PURE__ */c("button",{type:"button",onClick:()=>L(k),className:"px-1.5 text-[10px] text-gray-400 hover:text-gray-700",title:"Reset to current URL",children:"×"})]})}),
-/* @__PURE__ */c("button",{"data-bookmark-popover":!0,onClick:()=>q?F(R.findIndex(e=>e.url===k)):void D(v(k)),className:J+" "+(q?"text-yellow-500":""),title:q?"Remove bookmark":"Add bookmark",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:q?"currentColor":"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M11.48 3.499a.562.562 0 011.04 0l2.125 5.111a.563.563 0 00.475.345l5.518.442c.499.04.701.663.321.988l-4.204 3.602a.563.563 0 00-.182.557l1.285 5.385a.562.562 0 01-.84.61l-4.725-2.885a.563.563 0 00-.586 0L6.982 20.54a.562.562 0 01-.84-.61l1.285-5.386a.562.562 0 00-.182-.557l-4.204-3.602a.563.563 0 01.321-.988l5.518-.442a.563.563 0 00.475-.345L11.48 3.5z"})})}),
-/* @__PURE__ */c("button",{onClick:U,className:J,title:"Open in new tab",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M13.5 6H5.25A2.25 2.25 0 003 8.25v10.5A2.25 2.25 0 005.25 21h10.5A2.25 2.25 0 0018 18.75V10.5m-7.5-9L21 3m0 0v6m0-6L9.75 14.25"})})}),
-/* @__PURE__ */c("button",{onClick:()=>A(e=>!e),className:J,title:"Embedding help",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M9.879 7.519c1.171-1.025 3.071-1.025 4.242 0 1.172 1.025 1.172 2.687 0 3.712-.203.179-.43.326-.67.442-.745.361-1.45.999-1.45 1.827v.75M21 12a9 9 0 11-18 0 9 9 0 0118 0zm-9 5.25h.008v.008H12v-.008z"})})})]}),null!==E&&/* @__PURE__ */l("div",{"data-bookmark-popover":!0,className:"absolute right-3 top-12 z-30 w-72 bg-white border border-gray-200 rounded-md shadow-lg p-3",children:[
+/* @__PURE__ */c("button",{"data-bookmark-popover":!0,onClick:()=>J?P(S.findIndex(e=>e.url===k)):void O(v(k)),className:U+" "+(J?"text-yellow-500":""),title:J?"Remove bookmark":"Add bookmark",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:J?"currentColor":"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M11.48 3.499a.562.562 0 011.04 0l2.125 5.111a.563.563 0 00.475.345l5.518.442c.499.04.701.663.321.988l-4.204 3.602a.563.563 0 00-.182.557l1.285 5.385a.562.562 0 01-.84.61l-4.725-2.885a.563.563 0 00-.586 0L6.982 20.54a.562.562 0 01-.84-.61l1.285-5.386a.562.562 0 00-.182-.557l-4.204-3.602a.563.563 0 01.321-.988l5.518-.442a.563.563 0 00.475-.345L11.48 3.5z"})})}),
+/* @__PURE__ */c("button",{onClick:F,className:U,title:"Open in new tab",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M13.5 6H5.25A2.25 2.25 0 003 8.25v10.5A2.25 2.25 0 005.25 21h10.5A2.25 2.25 0 0018 18.75V10.5m-7.5-9L21 3m0 0v6m0-6L9.75 14.25"})})}),
+/* @__PURE__ */c("button",{onClick:()=>D(e=>!e),className:U,title:"Embedding help",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.5,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M9.879 7.519c1.171-1.025 3.071-1.025 4.242 0 1.172 1.025 1.172 2.687 0 3.712-.203.179-.43.326-.67.442-.745.361-1.45.999-1.45 1.827v.75M21 12a9 9 0 11-18 0 9 9 0 0118 0zm-9 5.25h.008v.008H12v-.008z"})})})]}),null!==B&&/* @__PURE__ */l("div",{"data-bookmark-popover":!0,className:"absolute right-3 top-12 z-30 w-72 bg-white border border-gray-200 rounded-md shadow-lg p-3",children:[
 /* @__PURE__ */c("div",{className:"text-[11px] font-semibold uppercase tracking-wide text-gray-500 mb-1",children:"Bookmark this page"}),
 /* @__PURE__ */c("div",{className:"text-[11px] text-gray-400 truncate mb-2 font-mono",title:k,children:k}),
-/* @__PURE__ */c("input",{ref:I,type:"text",value:E,onChange:e=>D(e.target.value),onKeyDown:e=>{"Enter"===e.key?P():"Escape"===e.key&&D(null)},placeholder:"Name",className:"w-full text-sm px-2 py-1.5 border border-gray-300 rounded focus:outline-none focus:border-blue-400 focus:ring-1 focus:ring-blue-200"}),
+/* @__PURE__ */c("input",{ref:X,type:"text",value:B,onChange:e=>O(e.target.value),onKeyDown:e=>{"Enter"===e.key?I():"Escape"===e.key&&O(null)},placeholder:"Name",className:"w-full text-sm px-2 py-1.5 border border-gray-300 rounded focus:outline-none focus:border-blue-400 focus:ring-1 focus:ring-blue-200"}),
 /* @__PURE__ */l("div",{className:"flex justify-end gap-1 mt-2",children:[
-/* @__PURE__ */c("button",{onClick:()=>D(null),className:"px-2 py-1 text-xs text-gray-600 hover:bg-gray-100 rounded",children:"Cancel"}),
-/* @__PURE__ */c("button",{onClick:P,disabled:!E.trim(),className:"px-2 py-1 text-xs bg-blue-500 text-white rounded hover:bg-blue-600 disabled:opacity-40",children:"Save"})]})]}),
-/* @__PURE__ */l("div",{className:"flex items-center gap-0.5 px-2 py-1 border-b border-gray-200 bg-white shrink-0 overflow-x-auto",children:[0===R.length&&/* @__PURE__ */c("span",{className:"text-[11px] text-gray-400 italic px-2",children:"No bookmarks yet — star the address bar to add one."}),R.map((e,t)=>/* @__PURE__ */l("button",{onClick:()=>T(e.url),onContextMenu:async o=>{o.preventDefault();await n({title:"Remove bookmark",message:`"${e.label}" will be removed from your bookmarks.`,confirmLabel:"Remove",variant:"danger"})&&F(t)},className:"flex items-center gap-1.5 px-2 py-0.5 rounded text-[12px] text-gray-700 hover:bg-gray-100 whitespace-nowrap",title:`${e.url}\n(right-click to remove)`,children:[
+/* @__PURE__ */c("button",{onClick:()=>O(null),className:"px-2 py-1 text-xs text-gray-600 hover:bg-gray-100 rounded",children:"Cancel"}),
+/* @__PURE__ */c("button",{onClick:I,disabled:!B.trim(),className:"px-2 py-1 text-xs bg-blue-500 text-white rounded hover:bg-blue-600 disabled:opacity-40",children:"Save"})]})]}),
+/* @__PURE__ */l("div",{className:"flex items-center gap-0.5 px-2 py-1 border-b border-gray-200 bg-white shrink-0 overflow-x-auto",children:[0===S.length&&/* @__PURE__ */c("span",{className:"text-[11px] text-gray-400 italic px-2",children:"No bookmarks yet — star the address bar to add one."}),S.map((e,t)=>/* @__PURE__ */l("button",{onClick:()=>T(e.url),onContextMenu:async o=>{o.preventDefault();await n({title:"Remove bookmark",message:`"${e.label}" will be removed from your bookmarks.`,confirmLabel:"Remove",variant:"danger"})&&P(t)},className:"flex items-center gap-1.5 px-2 py-0.5 rounded text-[12px] text-gray-700 hover:bg-gray-100 whitespace-nowrap",title:`${e.url}\n(right-click to remove)`,children:[
 /* @__PURE__ */c("img",{src:`https://icons.duckduckgo.com/ip3/${new URL(e.url).hostname}.ico`,alt:"",className:"h-3.5 w-3.5",onError:e=>{e.target.style.visibility="hidden"}}),e.label]},t)),
 /* @__PURE__ */c("div",{className:"flex-1"}),
 /* @__PURE__ */c("button",{onClick:()=>{g(k);try{localStorage.setItem(u,k)}catch{}},className:"px-2 py-0.5 text-[11px] text-gray-500 hover:text-gray-800",title:"Set current page as homepage",children:"Set as home"})]}),
-/* @__PURE__ */c("div",{className:"flex-1 relative min-h-0 bg-gray-50",children:/* @__PURE__ */c(y,{url:k,iframeKey:W,iframeRef:O,openExternal:U,showHelp:H,dismissHelp:()=>A(!1)})})]})}function v(e){try{return new URL(e).hostname.replace(/^www\./,"")}catch{return e}}function y({url:e,iframeKey:t,iframeRef:o,openExternal:r,showHelp:n,dismissHelp:a}){const[d,u]=s(!1);i(()=>{u(!1)},[e]);return function(e){try{const t=new URL(e).hostname.toLowerCase();return k.some(e=>t===e||t.endsWith("."+e))}catch{return!1}}(e)&&!d?/* @__PURE__ */c("div",{className:"absolute inset-0 flex items-center justify-center bg-white p-8",children:/* @__PURE__ */l("div",{className:"max-w-md text-center",children:[
+/* @__PURE__ */c("div",{className:"flex-1 relative min-h-0 bg-gray-50",children:/* @__PURE__ */c(y,{url:k,iframeKey:M,iframeRef:E,openExternal:F,showHelp:A,dismissHelp:()=>D(!1)})})]})}function v(e){try{return new URL(e).hostname.replace(/^www\./,"")}catch{return e}}function y({url:e,iframeKey:t,iframeRef:o,openExternal:r,showHelp:n,dismissHelp:a}){const[d,u]=s(!1);i(()=>{u(!1)},[e]);return function(e){try{const t=new URL(e).hostname.toLowerCase();return k.some(e=>t===e||t.endsWith("."+e))}catch{return!1}}(e)&&!d?/* @__PURE__ */c("div",{className:"absolute inset-0 flex items-center justify-center bg-white p-8",children:/* @__PURE__ */l("div",{className:"max-w-md text-center",children:[
 /* @__PURE__ */c("svg",{className:"h-14 w-14 mx-auto text-gray-300 mb-3",fill:"none",viewBox:"0 0 24 24",stroke:"currentColor",strokeWidth:1.2,children:/* @__PURE__ */c("path",{strokeLinecap:"round",strokeLinejoin:"round",d:"M18.364 18.364A9 9 0 005.636 5.636m12.728 12.728L5.636 5.636m12.728 12.728L21 21M5.636 5.636L3 3m9 9a9 9 0 110-18 9 9 0 010 18z"})}),
 /* @__PURE__ */l("h3",{className:"text-base font-semibold text-gray-800 mb-1",children:[v(e)," can't be embedded"]}),
 /* @__PURE__ */l("p",{className:"text-sm text-gray-500 mb-4",children:["This site sends an ",