efficient-shell 4.175.0 → 4.179.0

package/README.md

@@ -920,7 +920,7 @@ All exports are named — `import { Modal, ... } from 'efficient-shell'`.
 | `Popover` | A button and the panel it opens, right under it, placed by `DropdownMenu`'s rule (left edges together, or right with `align="end"`, flipping and shifting to stay on screen and in its window, never wider than a phone allows): a non-modal `role="dialog"` named by `title` or `aria-label`, for check boxes, a date, a short form. A kit popup opened inside it (a `DatePicker`'s calendar, a `Select`'s list) does not close it. Focus moves in as it opens; Tab reads it as if it sat right after its trigger; Escape closes it and gives focus back. See [Popovers](#popovers). |
 | `Dialog`, `Drawer` | A modal sheet that is not a shell window — centred (`Dialog`) or pinned to an edge (`Drawer`, `side` right / left / bottom) — for a till, a routed page or a form: trapped focus, a locked page, Escape and a backdrop click to close (`blocking` turns both off), a close cross when there is no `footer`. A `Dialog` is never taller than the screen less its gutter: a longer form — on a phone, most of them — scrolls inside the panel, footer included, and a footer wider than the panel wraps. `title` names it; `description` is a line under the title that DESCRIBES it to a screen reader — without one the body does, which suits a confirm whose body is the question and not a form, whose every label would be read out. `role="alertdialog"` (Dialog) for a confirmation that interrupts. A heading or note that lives in the body — a form that loads the record its heading names — names and describes it through `aria-labelledby` / `aria-describedby`. Two open at once — the second inside the first, or beside it on `<body>` where a host portals its dialogs — each hold focus, and only the one in front moves Tab (`useFocusTrap` keeps a stack). |
 | `ConfirmProvider`, `confirm` | Imperative `confirm({ title, body })` returning a Promise<boolean>. |
-| `GlobalSearch` | Cmd-K command palette. Pass `providers: SearchProvider[]` to add results; a provider is called `(query, { signal })` and the `signal` aborts when a newer query, closing the palette or unmount supersedes the call, so pass it to the request. Only the latest query's response is shown, whether or not a provider honours the signal. A result whose `entity_type` is `__page__` opens a page; an `entity_id` of `/path?search=text` (URL-encoded) opens that page's list with its search box filled in. Portalled to `<body>` on the overlay layer (`Z_LAYERS.overlay`), so it covers every window, pinned or not; opening it closes any open popup (`dismissPopups`). Results are grouped under a header per `result.type` (with a count), in the order each type first appears in the merged responses — providers answer best match first, so the group holding an exact match leads. ↑/↓ run through every row across groups, Tab / Shift+Tab jump to the first row of the next / previous group, Enter opens; the input is an ARIA combobox over a listbox with `role="group"` sections. With fewer than two characters typed it shows an empty state instead: **Recent** (the last 8 results picked, most recent first, deduplicated by `entity_type` + `entity_id`), **Favorites** and **Actions** — each section only when it has rows. `recent` + `onRecord` and `favorites` are props, so a routed app that passes none gets no Recent / Favorites (`pushRecentSearch(recent, picked)` keeps the list for it); `Layout` passes them from the user's preferences (`search_recent`, `favorite_documents`). Picking a result or a Recent row calls `onRecord(result)` then `onSelect(result)`; picking a Favorite or an Action does not record. **While searching**, the previous answer's rows stay drawn (with a spinner in the input row) until the next one lands; "Searching…" shows only when there is nothing to draw yet. **Failures are not "no results"**: an aborted call is silent, but a provider that rejects marks the search failed — every provider down shows `strings.search.searchFailed` instead of "No results", some down shows the rows that arrived plus a one-line `partialFailure` warning. **"See all"**: a provider may answer `SearchResult[]` or a `SearchResponse` (`{ results, truncatedTypes? }`); a group whose type is in `truncatedTypes` counts as "5+", and when `SearchConfig.listRoutes` maps its type to a `SearchListRoute` (`{ path, label }`, label the plural the consumer names its list by, e.g. `customers`) it ends in a "See all {label}" row that calls `onSelect` with a `__page__` result for `${path}?search=${encodeURIComponent(query)}` (so the page must read `usePageSearch()`); it is never recorded in Recent, and a group that is not truncated gets neither the "+" nor the row. `SearchConfig.quickActions` (`{ label, icon?, keywords?, onSelect }[]`) are the Actions: always in the empty state, and in a typed search an "Actions" group at the end for those whose label or keywords contain the query. |
+| `GlobalSearch` | Cmd-K command palette. Pass `providers: SearchProvider[]` to add results; a provider is called `(query, { signal })` and the `signal` aborts when a newer query, closing the palette or unmount supersedes the call, so pass it to the request. Only the latest query's response is shown, whether or not a provider honours the signal. A result whose `entity_type` is `__page__` opens a page; an `entity_id` of `/path?search=text` (URL-encoded) opens that page's list with its search box filled in. Portalled to `<body>` on the overlay layer (`Z_LAYERS.overlay`), so it covers every window, pinned or not; opening it closes any open popup (`dismissPopups`). Results are grouped under a header per `result.type` (with a count), in the order each type first appears in the merged responses — providers answer best match first, so the group holding an exact match leads. ↑/↓ run through every row across groups, Tab / Shift+Tab jump to the first row of the next / previous group, Enter opens; the input is an ARIA combobox over a listbox with `role="group"` sections. With fewer than two characters typed it shows an empty state instead: **Recent** (the last 8 results picked, most recent first, deduplicated by `entity_type` + `entity_id`), **Favorites** and **Actions** — each section only when it has rows. `recent` + `onRecord` and `favorites` are props, so a routed app that passes none gets no Recent / Favorites (`pushRecentSearch(recent, picked)` keeps the list for it); `Layout` passes them from the user's preferences (`search_recent`, `favorite_documents`). Picking a result or a Recent row calls `onRecord(result)` then `onSelect(result)`; picking a Favorite or an Action does not record. **While searching**, the previous answer's rows stay drawn (with a spinner in the input row) until the next one lands; "Searching…" shows only when there is nothing to draw yet. **Failures are not "no results"**: an aborted call is silent, but a provider that rejects marks the search failed — every provider down shows `strings.search.searchFailed` instead of "No results", some down shows the rows that arrived plus a one-line `partialFailure` warning. **"See all"**: a provider may answer `SearchResult[]` or a `SearchResponse` (`{ results, truncatedTypes? }`); a group whose type is in `truncatedTypes` counts as "5+", and when `SearchConfig.listRoutes` maps its type to a `SearchListRoute` (`{ path, label }`, label the plural the consumer names its list by, e.g. `customers`) it ends in a "See all {label}" row that calls `onSelect` with a `__page__` result for `${path}?search=${encodeURIComponent(query)}` (so the page must read `usePageSearch()`); it is never recorded in Recent, and a group that is not truncated gets neither the "+" nor the row. `SearchConfig.quickActions` (`{ label, icon?, keywords?, onSelect }[]`) are the Actions: always in the empty state, and in a typed search an "Actions" group at the end for those whose label or keywords contain the query. **A result's kind and its words are separate**: `result.type` is the heading the reader sees, and an optional `result.typeKey` (`sales_order`) is the identity results group by and `typeIcons`, `listRoutes` and `truncatedTypes` are keyed by. Without `typeKey` the heading is the key, as before; a host with a translated interface sets it, because the same kind arrives under a different heading in each language. `SearchConfig.typeLabels` maps a type key to today's words, so a group's heading and the badge on a Recent row saved in another language read in the language the page is in. |
 | `ShortcutHelp` | The keyboard cheatsheet shown on `?`. |
 | `NotificationBell` | Taskbar bell — config via `<Layout notifications={…}>`. |
 | `BugReportDetail` | Used inside an entity-window registry entry; reads from `<BugReportConfigProvider>`. |
@@ -951,7 +951,7 @@ All exports are named — `import { Modal, ... } from 'efficient-shell'`.
 | `DataTable` | Read-only table for server-driven lists: it renders and reports, and never sorts or pages its own `data`. Controlled sort and pager, row selection, column groups, pinned columns, windowed rendering. `onRow` gives a row `onClick`, a `className`, any `data-*` attributes for its `<tr>` — a test's or a stylesheet's hook (`data-testid`, `data-state`) — the pointer and the keyboard coming in and out (`onMouseEnter` … `onBlur`) and `current`. `rowHref` makes each row one real link (`onRowPress` a button) with its controls still pressable — see [DataTable rows that are links](#datatable-rows-that-are-links). `stackOnNarrow` turns each row into a labelled card on a narrow container — see [DataTable on a narrow screen](#datatable-on-a-narrow-screen). |
 | `Pagination` | Numbered page control (pairs with tables; complements `ListFooter`). |
 | `Sparkline`, `LineChart`, `BarChart`, `DonutChart`, `ScatterChart` | Dependency-free inline-SVG charts (`currentColor`-themed). `LineChart` is the multi-series trend with optional scale, legend, dots and area fill. `ScatterChart` takes `xDomain` / `yDomain` to override the derived axis, and `xScale` / `yScale` of `'log'` for a long tail; a point outside a supplied domain is dropped and counted in the accessible label. |
-| `BulkImportGrid` | Paste-or-upload bulk entry with column mapping, duplicate review and optional sum-merge. Hands resolved rows to `onImport`; owns no persistence. The whole panel takes a dropped CSV; the Upload CSV button opens the same dialog. |
+| `BulkImportGrid` | Paste-or-upload bulk entry with column mapping, duplicate review and optional sum-merge. Hands resolved rows to `onImport`; owns no persistence. The whole panel takes a dropped CSV; the Upload CSV button opens the same dialog. Its words are the strings catalog's `bulkImport` section (a `description` prop wins), and its totals are written in the provider's `locale`. |
 | `UndoProvider`, `UndoControls` | One undo stack per form window, covering its fields, line items and bulk imports. Register state with `useUndoable` and the shell shows the Undo/Redo pair itself, leftmost in the window footer, as soon as the form has state and the window is editing (a draft, a duplicate, Edit mode) or the form has said `useUndoCanEdit(true)` — a view that merely holds state gets nothing — it joins a footer that is there for other reasons and never creates one, and the mobile chrome (footer hidden) gets nothing. A form mounts `UndoControls` by hand only for a place the footer is not (a plain overlay, a section header); a hand mount claims the stack and the shell then mounts nothing for it, so a form shows one pair wherever it chose to put it. Binds ⌘Z / ⇧⌘Z (and Ctrl+Y) except while the caret is in a field, where the browser's own undo wins. `WindowManager` already mounts one per window, scoped with `windowId` so a keypress reaches only the frontmost window; pass `windowId` yourself for any provider you mount outside a `<Modal>`, or two open windows will step back together. Offered to anyone who may edit the record — gate with `canEdit` and/or `perms`; a reader sees no controls and records no history. The shell-level provider cannot know the record's permissions, so a read-only form nests its own `<UndoProvider canEdit={false}>` to shadow it. A provider nested inside a window puts its own pair in the footer on the same footer terms — it joins a footer that is there for other reasons, never creates one or holds it open, and shows nothing on the mobile chrome — but its `canEdit` takes the place of the editing check: the form that nested it has already said whether the record may be edited, so pass `canEdit={isEditing}` (or the lock) rather than leaving the default. |
 | `Calendar` | Month grid with full keyboard navigation (arrows, Home/End, PageUp/Down) and `role="grid"` semantics. Single or range. Days of the months either side are quieter than the month's own but keep AA contrast: they are dates a person can press. The shared grid behind `DatePicker` and `DateRangePicker`. `weekStartsOn` defaults to the provider locale's first day of the week (`firstDayOfWeek`), Sunday without one. |
 | `DashboardTemplate`, `DataTablePage`, `FormLayoutPage`, `CheckoutTemplate`, `EmailTemplate`, `ChatTemplate`, `GalleryTemplate`, `AuthScreen`, `ErrorPage` | Zero-prop starter page templates composed from the primitives. |
@@ -1007,7 +1007,7 @@ All exports are named — `import { Modal, ... } from 'efficient-shell'`.
 | `utilityApps`, `documentApps`, `webApps` | Subsets of `bundledApps`. |
 | `Calculator`, `Spreadsheet`, `Weather`, `CurrencyConverter`, `PomodoroTimer`, `TodoList`, `Browser` | Lazy components — use directly in custom registry entries. |
 | `PdfViewer` | Lazy component — the PDF reader on its own, for embedding. See below. |
-| `BUILTIN_APP_INFO` | Per-app metadata for the document/web apps (Spreadsheets, Notepad, Documents, Preview, Files, Browser): display name, independent app version and one-line description. Drives each app's "About" dialog (window title menu → About <App>), which also shows the shell version. |
+| `BUILTIN_APP_INFO` | Per-app metadata for the document/web apps (Spreadsheets, Notepad, Documents, Preview, Files, Browser): display name, independent app version and one-line description. Drives each app's "About" dialog (window title menu → About <App>), which also shows the shell version. The dialog's words, and each app's description, are the strings catalog's `aboutApp` section; `description` here is its English default. |
 
 #### An embedded PDF — `PdfViewer`
 
@@ -1695,6 +1695,94 @@ const { language, languages, setLanguage } = useShellLanguage();
   except after a language change, when the tab takes its route's title until
   its page mounts and titles it again.
 
+#### Shipped languages — `efficient-shell/locales/zh-Hans`
+
+The shell ships its own catalogue for Simplified Chinese (mainland usage), so
+its window controls, pagers and dialogs read the same in every host:
+
+```tsx
+import { zhHansStrings } from 'efficient-shell/locales/zh-Hans';
+
+<ShellLanguageProvider languages={LANGUAGES} language="zh-Hans" strings={zhHansStrings()}>
+  <App />
+</ShellLanguageProvider>
+
+// or, without the language provider:
+<ShellStringsProvider value={zhHansStrings()} locale="zh-Hans">…</ShellStringsProvider>
+```
+
+- **It is a draft.** No native speaker has reviewed it yet.
+  `ZH_HANS_REVIEWED_SECTIONS` (same subpath) lists the catalogue sections one
+  has signed off, and it is empty: the whole catalogue is draft. The shell only
+  reports this; whether to offer the language meanwhile is the host's call.
+- **It is the whole catalogue.** `zhHansStrings(locale = 'zh-Hans')` returns a
+  complete `ShellStrings`, the word-order entries included, so no key falls
+  back to English. Its counts are written in `locale`. A key you want said
+  differently is one spread away: `{ ...zh, dialog: { ...zh.dialog, ok: '好' } }`.
+- **A caller's words are spaced the Chinese way.** A label or a name you pass
+  in is closed up against Chinese and set off by a space when it is Latin
+  (`复制采购订单号`, `复制 SO-0041`), so a host part-way through its own
+  translation reads correctly in both.
+- **What stays in Latin letters** is notation: file formats (`PDF`, `CSV`,
+  `DXF`), key names (`Esc`, `Enter`), units, the drawing panel's commands and
+  package names.
+- **Nothing loads it by accident.** The subpath is its own entry with no React
+  and no peer, safe to call from server code, and neither `efficient-shell` nor
+  `efficient-shell/ui` imports it: a host that offers one language downloads
+  none of it. `createShellI18n` (below) fetches it with a dynamic import when
+  `zh-Hans` is activated.
+
+#### Your own copy — `efficient-shell/i18n`
+
+The catalog above is the shell's words. A host's own copy (its column
+headings, page titles, toasts) goes through [i18next](https://www.i18next.com/),
+and this entry sets it up the same way in every host, driven by the same
+language. `i18next` and `react-i18next` are optional peers of this entry alone:
+a host that offers one language installs neither.
+
+```ts
+// src/i18n/index.ts — module scope
+import { createShellI18n } from 'efficient-shell/i18n';
+import common from '../locales/en/common.json';
+import orders from '../locales/en/orders.json';
+
+export const { i18n, t, activate } = createShellI18n({
+  copy: { common, orders },                                   // English, bundled
+  load: language => import(`../locales/${language}/index.ts`).then(m => m.default),
+  // loadShellStrings: omitted, the shell loads the catalogue it ships for the language
+});
+```
+
+```ts
+// boot, BEFORE the app is imported
+const language = resolveShellLanguage({ offered: LANGUAGES });
+const activation = await activate(language);                  // never rejects
+const { default: App } = await import('./App');
+// <ShellLanguageProvider language={activation.language} strings={activation.strings} …>
+```
+
+- **`t` answers at once.** `createShellI18n` initialises synchronously with the
+  source-language copy, so `t('orders:title')` is English from the next line. A
+  unit test that imports a column set gets English with no setup.
+- **`activate(language)`** loads that language's copy and the shell's catalog
+  together, then switches `t`. A key the language lacks falls back to the
+  source language. If either load fails the page stays in the source language
+  and the result says `failed: true`; it never rejects into a blank page.
+- **The shell's catalogue comes by default.** With no `loadShellStrings`,
+  `activate` loads the catalogue the shell ships for the language
+  (`efficient-shell/locales/zh-Hans`, lazily) and hands it back as
+  `activation.strings`; a language the shell does not ship activates with
+  `strings: undefined` and the shell's own words stay in English. Pass
+  `loadShellStrings` to supply your own instead: it wins.
+- **Import the app after `activate`.** Module-level constants call `t` when
+  they are imported and keep what it said, so copy read before `activate` stays
+  in the source language for the life of the page. `activate` reports that on
+  the console when it happens.
+- **`useTranslation`** from `react-i18next` reads the same instance, with no
+  provider to mount. Type your keys the i18next way, by augmenting
+  `CustomTypeOptions` with your English resources, and a misspelt key stops
+  compiling.
+
 **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
@@ -1705,15 +1793,35 @@ 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.
 
+**The status and file surfaces are in the catalog too.**
+`ServerStatusIndicator`'s tooltip and card (`serverStatus`), `BulkImportGrid`
+with its column mapper and both duplicate reviews (`bulkImport`), the Preview
+window (`preview`) with its drawing panel and command bar (`drawing`) and its
+3D panel (`model`), `ImageAnnotator` (`annotator`), what `openAttachment` says
+when a stored file cannot be shown in a window (`attachment`) and a bundled
+app's About dialog (`aboutApp`). The PDF panel was already `pdf`. A caller's own
+words still win: the bulk grid's `description`, a staged `convertingMessage`,
+`openAttachment`'s `loadingMessage`, a fetch error's own message. The times on
+the status card and the totals over the bulk grid are written in `locale`, and
+exactly as before without one.
+
 **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
 `Kbd` shortcut constants (key symbols); `STAGES` labels (data a consumer's own
 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** — 56 sections, 525 keys. A function's default is shown
+console warnings, which are for developers. In the Preview window the same
+goes for file extensions and the two optional packages' names, the drawing
+panel's command names (`DI`, `DIM`, `H`, `V`, `Z`, `LA`: what is typed is the
+same in every language) and its `ΔX`/`ΔY`, the axis letters and `⊥` of the 3D
+panel, a measurement's unit (`18.56 mm`, `1.250 m`) and the status card's
+latency (`42 ms`), a colour swatch's hex code, and the names of the files a
+snapshot or an annotated image is saved under. A bundled app's NAME is its
+window-registry label and is not in the catalog either; its one-line
+description is.
+
+**The full catalog** — 64 sections, 781 keys. A function's default is shown
 with sample arguments.
 
 <details><summary><code>window</code> — 17 keys</summary>
@@ -2633,6 +2741,318 @@ with sample arguments.
 
 </details>
 
+<details><summary><code>serverStatus</code> — 27 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `connected` | `string` | `Connected` |
+| `disconnected` | `string` | `Disconnected` |
+| `checking` | `string` | `Checking…` |
+| `lastOkTitle` | `(status: string, time: string) => string` | `{status} · last ok {time}` |
+| `details` | `string` | `Server connection details` |
+| `lastPoll` | `(ago: string) => string` | `Last poll {ago}.` |
+| `lastFailure` | `(ago: string) => string` | `Last failure {ago}.` |
+| `firstPoll` | `string` | `First poll in flight…` |
+| `server` | `string` | `Server` |
+| `protocol` | `string` | `Protocol` |
+| `browser` | `string` | `Browser` |
+| `online` | `string` | `Online` |
+| `offline` | `string` | `Offline` |
+| `lastOk` | `string` | `Last OK` |
+| `lastFail` | `string` | `Last fail` |
+| `latency` | `string` | `Latency` |
+| `poll` | `string` | `Poll` |
+| `pollEvery` | `(seconds: number) => string` | `every 3 s` |
+| `session` | `string` | `Session` |
+| `user` | `string` | `User` |
+| `notSignedIn` | `string` | `Not signed in` |
+| `role` | `string` | `Role` |
+| `build` | `string` | `Build` |
+| `app` | `string` | `App` |
+| `userAgent` | `string` | `UA` |
+| `pingHint` | `string` | `Click ↻ to ping now` |
+| `refresh` | `string` | `Refresh` |
+
+</details>
+
+<details><summary><code>bulkImport</code> — 29 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `description` | `string` | `Paste from spreadsheets, type directly, or upload a CSV. Rows don't need to be in order — they'll be matched. Values not in the list will be added to the end. Fields left blank will not be affected.` |
+| `lines` | `(count: number) => string` | `3 lines` |
+| `total` | `(label: string, value: string) => string` | `{label}: {value}` |
+| `clear` | `string` | `Clear` |
+| `upload` | `string` | `Upload CSV` |
+| `importLines` | `(count: number) => string` | `Import 3 Lines` |
+| `importing` | `string` | `Importing...` |
+| `importFailed` | `string` | `Import failed.` |
+| `enterAtLeastOne` | `(noun: string, title: string) => string` | `Enter at least one {noun}.` (`Enter at least one value.` with no title) |
+| `allSkipped` | `string` | `All rows skipped.` |
+| `cancel` | `string` | `Cancel` |
+| `mapTitle` | `string` | `Map CSV columns to fields` |
+| `skip` | `string` | `— Skip —` |
+| `columnOption` | `(column: number, sample: string) => string` | `Column 3 (e.g. {sample})` |
+| `rowsDetected` | `(count: number) => string` | `3 rows detected` |
+| `confirmMapping` | `string` | `Confirm Mapping` |
+| `duplicatesTitle` | `string` | `Duplicate entries detected` |
+| `duplicatesFound` | `(count: number) => string` | `3 values appear more than once in your import. Choose how to handle each before proceeding.` (`1 value appears…` for one) |
+| `occurrences` | `(count: number) => string` | `3 occurrences` |
+| `keepFirst` | `string` | `Keep first` |
+| `keepLast` | `string` | `Keep last` |
+| `keepAll` | `string` | `Keep all` |
+| `skipAll` | `string` | `Skip all` |
+| `keptDropped` | `(kept: number, dropped: number) => string` | `3 kept · 3 dropped` |
+| `proceed` | `string` | `Proceed` |
+| `duplicatesMerged` | `(count: number) => string` | `3 values appeared more than once. Each is merged into a single line with its quantity summed — review before proceeding.` (`1 value appeared…` for one) |
+| `mergedFrom` | `string` | `Merged from` |
+| `mergedRows` | `(count: number) => string` | `3 rows` |
+| `mergeSummary` | `(rows: number, lines: number) => string` | `3 duplicate rows → 3 merged lines` (`… → 1 merged line` for one) |
+
+</details>
+
+<details><summary><code>preview</code> — 29 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `windowTitle` | `(name: string) => string` | `{name} - Preview` |
+| `untitled` | `string` | `Untitled` |
+| `open` | `string` | `Open` |
+| `formats` | `string` | `PDF · DXF · 3D · Images` |
+| `dropHere` | `(open: string) => string` | `Drop a file here, or click {open}.` |
+| `supportedFormats` | `string` | `Supported formats` |
+| `formatPdf` | `string` | `multi-page document viewer` |
+| `formatDxf` | `(packageName: string) => string` | `vector CAD drawings (optional {packageName} peer dep)` |
+| `format3d` | `(packageName: string) => string` | `3D models (optional {packageName} peer dep)` |
+| `formatImage` | `string` | `raster images` |
+| `dwgNote` | `string` | `DWG files need to be converted to PDF or DXF first (server-side).` |
+| `dropToOpen` | `string` | `Drop to open` |
+| `dwgUnsupported` | `string` | `DWG files need server-side conversion. Convert to PDF or DXF first.` |
+| `unsupportedType` | `(extension: string) => string` | `Unsupported file type: .{extension}` (`.unknown` with none) |
+| `converting` | `string` | `Converting file` |
+| `download` | `string` | `Download` |
+| `email` | `string` | `Email` |
+| `howToNavigate` | `string` | `How to navigate` |
+| `stopMeasuring` | `string` | `Stop measuring (Esc)` |
+| `scrollToZoom` | `string` | `Scroll to zoom` |
+| `closePanel` | `string` | `Close` |
+| `annotate` | `string` | `Annotate` |
+| `annotateHint` | `string` | `Annotate this image` |
+| `view` | `string` | `View` |
+| `viewHint` | `string` | `Back to viewer` |
+| `copy` | `string` | `Copy` |
+| `save` | `string` | `Save` |
+| `imageFailed` | `string` | `Failed to load image.` |
+| `downloadFailed` | `string` | `Download failed — couldn't reach the file.` |
+
+</details>
+
+<details><summary><code>drawing</code> — 49 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `loading` | `string` | `Loading drawing…` |
+| `notInstalled` | `string` | `dxf-viewer is not installed in this app.` |
+| `renderFailed` | `string` | `Failed to render DXF.` |
+| `layers` | `string` | `Layers` |
+| `layersHint` | `string` | `Toggle layer visibility` |
+| `allLayers` | `string` | `All` |
+| `noLayers` | `string` | `None` |
+| `measure` | `string` | `Measure` |
+| `measureHint` | `string` | `Measure distance — click two points on the drawing, or type DI / DIM below` |
+| `auto` | `string` | `Auto` |
+| `autoHint` | `string` | `Auto — AutoCAD DIMLINEAR: measures ΔX or ΔY, whichever is larger between the two picks` |
+| `horizontalHint` | `string` | `Horizontal — distance along the X axis between two picks (AutoCAD DIMLINEAR horizontal)` |
+| `verticalHint` | `string` | `Vertical — distance along the Y axis between two picks (AutoCAD DIMLINEAR vertical)` |
+| `point` | `string` | `Point` |
+| `pointHint` | `string` | `Point — straight-line (Euclidean) distance between two picks (AutoCAD DIST)` |
+| `fixX` | `string` | `fix Δx` |
+| `fixY` | `string` | `fix Δy` |
+| `fixHint` | `string` | `Lock the second pick's axis coord to first pick + this value (mm). The reported measurement becomes the perpendicular distance.` |
+| `clearFixed` | `string` | `Clear fixed distance` |
+| `horizontalDistance` | `(auto: boolean) => string` | `Horizontal distance (Δx) between the two picked points` (plus ` — Auto resolved to the X axis` when `auto`) |
+| `verticalDistance` | `(auto: boolean) => string` | `Vertical distance (Δy) between the two picked points` (plus ` — Auto resolved to the Y axis` when `auto`) |
+| `straightDistance` | `string` | `Straight-line distance between the two picked points` |
+| `fit` | `string` | `Fit` |
+| `fitHint` | `string` | `Fit drawing to view` |
+| `dragToPan` | `string` | `Drag to pan` |
+| `fitToReset` | `string` | `Fit to reset` |
+| `typeToMeasure` | `(commands: string) => string` | `Type {commands} to measure` |
+| `commandPlaceholder` | `string` | `Type a command — DI, DIM, H, V, Z, LA (? for help)` |
+| `commandHelp` | `string` | `Commands: DI distance · DIM/DLI linear dim · H / V force axis · <number> lock Δ · U undo pick · Z fit · LA layers · Esc exit` |
+| `echoDistance` | `(distance: string, deltaX: string, deltaY: string) => string` | `Distance = {distance}   ΔX = {deltaX}   ΔY = {deltaY}` |
+| `echoLinear` | `(distance: string, axis: string) => string` | `Linear dimension = {distance} ({axis})` |
+| `echoLocked` | `(axis: string, distance: string, lockedAxis: string, locked: string) => string` | `{axis} = {distance} with {lockedAxis} locked to {locked}` |
+| `axisLocked` | `(axis: string, distance: string) => string` | `{axis} locked to {distance} — the label shows the perpendicular distance` |
+| `fixedCleared` | `string` | `Fixed distance cleared.` |
+| `fixedNeedsAxis` | `string` | `Fixed distances apply in H or V mode — type H or V first.` |
+| `echoDist` | `string` | `DIST — click two points; straight-line distance (Esc to exit)` |
+| `echoDimLinear` | `string` | `DIMLINEAR — click two points; measures ΔX or ΔY, whichever is larger (H / V to force)` |
+| `echoHorizontal` | `string` | `Horizontal — ΔX between the two picks` |
+| `echoVertical` | `string` | `Vertical — ΔY between the two picks` |
+| `echoAuto` | `string` | `Auto (DIMLINEAR) — measures along the dominant axis of the two picks` |
+| `measureOn` | `string` | `Measure on — click two points.` |
+| `measureOff` | `string` | `Measure off.` |
+| `pickRemoved` | `string` | `Last pick removed.` |
+| `zoomExtents` | `string` | `Zoom extents.` |
+| `layersToggled` | `string` | `Layer panel toggled.` |
+| `measurementCleared` | `string` | `Measurement cleared.` |
+| `readOnly` | `(command: string) => string` | `{command} is a drawing command — Preview is a read-only viewer. Measuring: DI, DIM, H, V (? for help)` |
+| `unknownCommand` | `(command: string) => string` | `Unknown command "{command}" — try DI, DIM, H, V, Z, LA (? for help)` |
+| `cancelled` | `string` | `*Cancel*` |
+
+</details>
+
+<details><summary><code>model</code> — 53 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `loading` | `string` | `Loading 3D model…` |
+| `stepNote` | `string` | `STEP files load OpenCascade WASM (~5 MB) on first use.` |
+| `notInstalled` | `string` | `online-3d-viewer is not installed in this app. Add it to enable 3D file viewing.` |
+| `loadFailed` | `string` | `Failed to load 3D model.` |
+| `rootNode` | `string` | `Root` |
+| `node` | `string` | `Node` |
+| `collapse` | `string` | `Collapse` |
+| `expand` | `string` | `Expand` |
+| `fitToView` | `string` | `Fit to view` |
+| `hide` | `string` | `Hide` |
+| `show` | `string` | `Show` |
+| `isometric` | `string` | `ISO` |
+| `isometricView` | `string` | `Isometric view` |
+| `top` | `string` | `TOP` |
+| `topView` | `string` | `Top view` |
+| `front` | `string` | `FRT` |
+| `frontView` | `string` | `Front view` |
+| `side` | `string` | `SDE` |
+| `sideView` | `string` | `Side view` |
+| `perspective` | `string` | `Perspective` |
+| `orthographic` | `string` | `Orthographic` |
+| `toPerspective` | `string` | `Switch to perspective view` |
+| `toOrthographic` | `string` | `Switch to orthographic view` |
+| `snapshot` | `string` | `Save snapshot as PNG` |
+| `measureHint` | `string` | `Measure distance — click two points on the model` |
+| `point` | `string` | `Point` |
+| `pointHint` | `string` | `Point — measure straight-line distance between two picked points` |
+| `perpendicularHint` | `string` | `Perpendicular — pick two surfaces and measure the perpendicular gap between them` |
+| `straightDistance` | `string` | `Straight-line distance between the two picked points` |
+| `perpendicularDistance` | `string` | `Perpendicular distance between the two picked surfaces` |
+| `meshesHint` | `string` | `Toggle meshes panel` |
+| `displayHint` | `string` | `Toggle display panel` |
+| `downloadOriginal` | `string` | `Download original file` |
+| `meshes` | `string` | `Meshes` |
+| `readingModel` | `string` | `Reading model…` |
+| `noStructure` | `string` | `No structure available` |
+| `allVisible` | `string` | `All visible` |
+| `hiddenCount` | `(count: number) => string` | `3 hidden` |
+| `dragToRotate` | `string` | `Drag to rotate` |
+| `rightDragToPan` | `string` | `Right-click drag to pan` |
+| `display` | `string` | `Model Display` |
+| `backgroundColor` | `string` | `Background Color` |
+| `showEdges` | `string` | `Show Edges` |
+| `edgeColor` | `string` | `Edge Color` |
+| `edgeThreshold` | `string` | `Edge Threshold` |
+| `sectionView` | `string` | `Section View` |
+| `angle` | `string` | `Angle` |
+| `axis` | `string` | `Axis` |
+| `flipHint` | `string` | `Flip section direction` |
+| `flip` | `string` | `flip →` |
+| `flipped` | `string` | `← flipped` |
+| `position` | `string` | `Position` |
+| `resetDisplay` | `string` | `Reset to Default` |
+
+</details>
+
+<details><summary><code>annotator</code> — 52 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `toolSelect` | `string` | `Select / Move` |
+| `toolDraw` | `string` | `Pen / Draw` |
+| `toolRect` | `string` | `Rectangle` |
+| `toolEllipse` | `string` | `Ellipse` |
+| `toolArrow` | `string` | `Arrow` |
+| `toolMosaic` | `string` | `Mosaic` |
+| `toolText` | `string` | `Text` |
+| `toolCrop` | `string` | `Crop` |
+| `weight` | `string` | `Weight` |
+| `radius` | `string` | `Radius` |
+| `size` | `string` | `Size` |
+| `padding` | `string` | `Pad` |
+| `fontSystem` | `string` | `System` |
+| `fontSerif` | `string` | `Serif` |
+| `fontMono` | `string` | `Mono` |
+| `fontCursive` | `string` | `Cursive` |
+| `bold` | `string` | `Bold` |
+| `boldLetter` | `string` | `B` |
+| `italic` | `string` | `Italic` |
+| `italicLetter` | `string` | `I` |
+| `underline` | `string` | `Underline` |
+| `underlineLetter` | `string` | `U` |
+| `border` | `string` | `Border` |
+| `borderColor` | `string` | `Text-box border color` |
+| `addBorder` | `string` | `Add a border` |
+| `removeBorder` | `string` | `Remove border` |
+| `fill` | `string` | `Fill` |
+| `fillColor` | `string` | `Text-box background color` |
+| `addFill` | `string` | `Add a background fill` |
+| `removeFill` | `string` | `Remove fill` |
+| `add` | `string` | `Add` |
+| `zoomOut` | `string` | `Zoom out` |
+| `zoomIn` | `string` | `Zoom in` |
+| `fit` | `string` | `Fit` |
+| `fitHint` | `string` | `Fit to area` |
+| `undo` | `string` | `Undo` |
+| `applyCrop` | `string` | `Apply Crop` |
+| `cancel` | `string` | `Cancel` |
+| `apply` | `string` | `Apply` |
+| `hintSelected` | `string` | `Drag to move. Drag a corner to resize. Delete / Backspace removes. Click outside to deselect.` |
+| `hintSelect` | `string` | `Tap a shape to select. Double-click text to edit.` |
+| `hintText` | `string` | `Click to drop a text label.` |
+| `hintCrop` | `string` | `Drag a rectangle to set the crop region.` |
+| `hintDraw` | `string` | `Drag to draw freehand.` |
+| `hintShape` | `string` | `Drag on the image to draw.` |
+| `textPlaceholder` | `string` | `Type then Enter…` |
+| `loadFailed` | `string` | `Failed to load image` |
+| `exportFailed` | `string` | `Failed to export` |
+| `clipboardUnsupported` | `string` | `Clipboard images not supported in this browser` |
+| `copyFailed` | `string` | `Failed to copy` |
+| `copied` | `string` | `Copied to clipboard` |
+| `copyRefused` | `string` | `Copy failed (clipboard permission?)` |
+
+</details>
+
+<details><summary><code>attachment</code> — 7 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `fallbackName` | `string` | `attachment` |
+| `noLink` | `string` | `This attachment has no download link.` |
+| `spreadsheetFailed` | `string` | `Could not open the spreadsheet — opening the file instead.` |
+| `workbookUnavailable` | `string` | `Spreadsheet preview is unavailable for this file type. Opening the file instead.` |
+| `noViewer` | `string` | `Opening this file outside the app — no viewer can show it here.` |
+| `loading` | `string` | `LOADING FILE` |
+| `loadFailed` | `string` | `Failed to load this file.` |
+
+</details>
+
+<details><summary><code>aboutApp</code> — 10 keys</summary>
+
+| Key | Type | English default |
+|---|---|---|
+| `title` | `(name: string) => string` | `About {name}` |
+| `version` | `(version: string) => string` | `Version {version}` |
+| `partOf` | `(shell: string) => string` | `Part of the {shell} desktop environment` |
+| `shellVersion` | `(version: string) => string` | `shell v{version}` |
+| `spreadsheet` | `string` | `Multi-sheet spreadsheet editor with CSV / TSV import and export.` |
+| `notepad` | `string` | `Color-coded notes with checklists, desktop stickies and entity autolinking.` |
+| `documents` | `string` | `Letter-page editor for Word documents and plain-text files — images, lists, alignment.` |
+| `preview` | `string` | `Viewer for PDF documents, images, DXF drawings and 3D models — CAD-style measuring with object snap and an AutoCAD-like command bar.` |
+| `files` | `string` | `Personal file manager with folders, uploads, quota, trash and desktop shortcut folders.` |
+| `browser` | `string` | `Minimal web browser with bookmarks, history and navigation bar.` |
+
+</details>
+
 ### Brand surfaces — `efficient-shell/brand.css`
 
 For output that is not a portal window — a report, a published artifact, a

package/dist/{Browser-PZIVSYLM.js → Browser-LZMLL4CZ.js}

@@ -1,29 +1,29 @@
-import{peekBrowserStartUrl as e,claimBrowserStartUrl as t}from"./chunk-LWLCNQY7.js";import{AboutApp as o}from"./chunk-VRLHUZSC.js";import{WindowTitle as r}from"./chunk-GCO3A63X.js";import"./chunk-DSSLOQDW.js";import"./chunk-ZOPYAOUP.js";import"./chunk-7LAPNAKS.js";import"./chunk-YJRC6IKD.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-XJYXKO7K.js";import"./chunk-AFYQTVZO.js";import"./chunk-X4FJ54PP.js";import"./chunk-3YTHR7IC.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),[C,j]=s([k]),[z,M]=s(0),[H,S]=s(0),[R,W]=s(f),[A,O]=s(!1),[B,D]=s(null),E=a(null),P=a(null);i(()=>{try{localStorage.setItem(d,JSON.stringify(R))}catch{}},[R]);const X=e=>{const t=b(e);t&&(w(t),L(t),j(e=>{const o=e.slice(0,z+1);return o.push(t),o}),M(e=>e+1),O(!1))},I=()=>{"undefined"!=typeof window&&window.open(k,"_blank","noopener,noreferrer")},T=()=>{const e=B?.trim();e?(W(t=>[...t,{label:e,url:k}]),D(null)):D(null)};i(()=>{if(null===B)return;E.current?.focus(),E.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!==B]);const U=e=>{W(t=>t.filter((t,o)=>o!==e))},K=z>0,V=z<C.length-1,J=R.some(e=>e.url===k),Y="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-CZK2VKIO.js";import{WindowTitle as r}from"./chunk-N6STBYXR.js";import"./chunk-DSSLOQDW.js";import"./chunk-KVOFUFPP.js";import"./chunk-AZURXTRB.js";import"./chunk-CIXQKCFA.js";import"./chunk-5A7MWTXX.js";import"./chunk-OGXU7QFW.js";import{confirm as n}from"./chunk-ZAE6ROV7.js";import"./chunk-AA4TMQOS.js";import"./chunk-AFYQTVZO.js";import"./chunk-HZZNJHRH.js";import"./chunk-X4FJ54PP.js";import"./chunk-D65T4H6J.js";import"./chunk-J3LIIIHJ.js";import"./chunk-C3QOHMR6.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,M]=s(0),[R,H]=s(0),[S,W]=s(f),[A,O]=s(!1),[B,I]=s(null),T=a(null),E=a(null);i(()=>{try{localStorage.setItem(d,JSON.stringify(S))}catch{}},[S]);const D=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),O(!1))},F=()=>{"undefined"!=typeof window&&window.open(k,"_blank","noopener,noreferrer")},X=()=>{const e=B?.trim();e?(W(t=>[...t,{label:e,url:k}]),I(null)):I(null)};i(()=>{if(null===B)return;T.current?.focus(),T.current?.select();const e=e=>{const t=e.target;t?.closest("[data-bookmark-popover]")||I(null)},t=setTimeout(()=>document.addEventListener("mousedown",e),0);return()=>{clearTimeout(t),document.removeEventListener("mousedown",e)}},[null!==B]);const P=e=>{W(t=>t.filter((t,o)=>o!==e))},U=z>0,V=z<j.length-1,K=S.some(e=>e.url===k),J="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(C[e]),L(C[e]),O(!1)}},disabled:!K,className:Y,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<C.length-1){const e=z+1;M(e),w(C[e]),L(C[e]),O(!1)}},disabled:!V,className:Y,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:Y,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:()=>X(p),className:Y,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(),X(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("button",{onClick:()=>{if(z>0){const e=z-1;M(e),w(j[e]),L(j[e]),O(!1)}},disabled:!U,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]),O(!1)}},disabled:!V,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:()=>H(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:()=>D(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("form",{onSubmit:e=>{e.preventDefault(),D(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:()=>J?U(R.findIndex(e=>e.url===k)):void D(v(k)),className:Y+" "+(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:I,className:Y,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:()=>O(e=>!e),className:Y,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("button",{"data-bookmark-popover":!0,onClick:()=>K?P(S.findIndex(e=>e.url===k)):void I(v(k)),className:J+" "+(K?"text-yellow-500":""),title:K?"Remove bookmark":"Add bookmark",children:/* @__PURE__ */c("svg",{className:"h-4 w-4",fill:K?"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: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:()=>O(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!==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:E,type:"text",value:B,onChange:e=>D(e.target.value),onKeyDown:e=>{"Enter"===e.key?T():"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:T,type:"text",value:B,onChange:e=>I(e.target.value),onKeyDown:e=>{"Enter"===e.key?X():"Escape"===e.key&&I(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:T,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===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:()=>X(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"})&&U(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:()=>I(null),className:"px-2 py-1 text-xs text-gray-600 hover:bg-gray-100 rounded",children:"Cancel"}),
+/* @__PURE__ */c("button",{onClick:X,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:()=>D(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:H,iframeRef:P,openExternal:I,showHelp:A,dismissHelp:()=>O(!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:R,iframeRef:E,openExternal:F,showHelp:A,dismissHelp:()=>O(!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 ",