flexdesk 0.17.16 → 0.17.18

package/docs/components/menus.md

@@ -66,7 +66,8 @@ bar.setChecked('dark', true);     // …and unchecks the rest of the radio group
 `createMenuBar(el, opts)` returns a `MenuBar` (also exported, for
 `instanceof`). Its methods: `open(menuId, { focusItem })`, `close()`,
 `focus()`, `isOpen()`, `isEnabled(id)`, `isChecked(id)`, `setEnabled(id, on)`,
-`setChecked(id, on)`, `commands()` and `dispose()`.
+`setChecked(id, on)`, `commands()`, `setStyle(style)` (0.17.18, below) and
+`dispose()`.
 
 - **Pointer.** Clicking a title opens its menu; while one is open, hovering
   another title switches to it. Hovering an item with a submenu opens it.
@@ -101,6 +102,42 @@ The bar is `.twm-menubar` (not the older `.twm-menu-bar` icon strip).
 `tests/menu_bar.test.mjs` drives it in jsdom; `tests/menu_bar_css.test.mjs`
 holds its stylesheet.
 
+## A hamburger instead of the bar: `style: 'hamburger'` (0.17.18)
+
+The same menus can be drawn as one icon button in place of the row of titles,
+for a top bar with no room for File / Edit / Help. Its menu lists the menus,
+and each one flies out its items: ☰ › File › Open…
+
+```js
+const bar = createMenuBar(el, { menus, onAction, style: 'hamburger', label: 'Main menu' });
+bar.setStyle('bar');        // and back: bar.setStyle('hamburger')
+bar.style;                  // 'bar' | 'hamburger'
+```
+
+- **Options.** `style` is `'bar'` (the default) or `'hamburger'`; anything
+  else is a boot error. `icon` is the button's Material Symbols glyph
+  (`'menu'`). `label` names the button (its `aria-label` and its tooltip).
+- **The same model.** `onAction`, `setEnabled`, `setChecked`, `isEnabled`,
+  `isChecked` and `commands()` work as in the bar; an item fires with its own
+  id, never a hamburger id.
+- **`open(menuId, { focusItem })`** opens the hamburger with that menu flown
+  out, focus on its row (or, with `focusItem`, on its first item).
+- **Keyboard.** Alt or F10 focuses the button; Down, Enter or Space opens it.
+  In its menu Up/Down move across the menus, Right flies one out and Left
+  closes it. There is no next or previous title, so Left/Right on the button
+  itself, and at the top level of its menu, go nowhere. Esc closes one level.
+- **`setStyle(style)`** switches at run time (a setting, a narrow window). It
+  closes whatever is open and keeps every `setEnabled` / `setChecked`; if the
+  bar had focus, the first title (or the button) gets it.
+- **Styling.** The bar gets `.twm-menubar--hamburger`, the button
+  `.twm-menubar__title--icon`, the size of the top bar's other icon buttons
+  (`.twm-panel-toggle-btn`).
+
+In a shell, pass it with the model: `menuBar: { menus, onAction, style:
+'hamburger' }`, and switch later through `shell.chrome.menuBar.setStyle(…)`.
+A hamburger belongs in the top bar itself (at the left, before the app's
+icon), not in the `.twm-global-menu-bar` row below.
+
 ## The menu bar in its own row under the top bar (0.17.13)
 
 A shell's menu bar can sit on a second line, as a full-width strip directly

package/docs/components/notifications.md

@@ -120,7 +120,8 @@ background, a left border in the severity's colour (`--color-success`,
 `--color-warning`, `--color-danger`; info keeps the blue) and the entry
 animation `twm-notification-in`, which the sheet now defines. The card sets
 `pointer-events: auto` over the root's `none`, so its buttons and its
-click-to-close work.
+click-to-close work. Since [Copy message](#copy-message), click-to-close takes
+only a click on the card outside its text.
 
 Until 0.17.2 the card carried the bare `notification` / `notification--<severity>`
 classes, which no FlexDesk sheet styled: the card had no background and no
@@ -156,6 +157,27 @@ Until 0.17.3 the bell counted only on bus events, so a toast raised through
 was pushed as a second entry: a toast that timed out was in `history` twice
 and counted twice. `tests/notification_history_follows_center.test.mjs` holds it.
 
+### Copy message
+
+Right-clicking a toast, or its entry in the `NotificationHistory` popover, opens
+the context menu (`showContextMenu`) with **Copy message**. It copies the
+notification's title, message and description, one per line and skipping any
+that is empty, as plain text through `navigator.clipboard.writeText`. The menu
+replaces the browser's native one there. The history popover stays open while
+its menu is used. Every context menu draws on `--z-context-menu` (tokens.css),
+over toasts (`--z-toast`) and managed windows, so the menu opens over the toast
+that was right-clicked.
+
+The text of a toast and of a history entry (title, message, description,
+status) is selectable: the sheets give it `user-select: text` over the body's
+`none`. A click or double-click on a toast's text (title, message,
+description, status) selects it and does not close the toast, nor does a click
+that ends a selection inside it. Only a click on the card outside the text (the
+header's empty space, the padding, the timestamp) closes it, besides the ×
+button. `notificationText(notification)` returns the copied
+text, and `showNotificationMenu(event, notification, logger)` opens the menu.
+Both are exported from `widgets`. `tests/notification_copy.test.mjs` covers it.
+
 ### Alerts with history: a log, a pane, a tab host and a bell (0.14.0)
 
 A toast is the moment. The **alert log** keeps what came in until it is

package/docs/components/panels-and-desktops.md

@@ -10,6 +10,7 @@ The shell's left, right and bottom panels, and its virtual desktops. A kind says
 - [Panels keep the size you dragged them to (0.17.0)](#panels-keep-the-size-you-dragged-them-to-0170)
 - [A navigation panel you drive yourself: `mountNavPanel` (0.17.0)](#a-navigation-panel-you-drive-yourself-mountnavpanel-0170)
 - [Your desktops beside the app's (0.10.0)](#your-desktops-beside-the-apps-0100)
+- [A page that opens on the desktop you are on (0.17.17)](#a-page-that-opens-on-the-desktop-you-are-on-01717)
 - [A saved layout that cannot be read (0.17.14)](#a-saved-layout-that-cannot-be-read-01714)
 
 ## Panels a page does not offer (0.17.0)
@@ -127,6 +128,27 @@ main pane; it used to replace that pane with the active tab alone. A target stil
 holding only its seed is replaced, as before. `dispose()` removes the bar, so a
 rebuilt shell paints a fresh one.
 
+## A page that opens on the desktop you are on (0.17.17)
+
+A desktop is the tiles and panels arranged on it. A kind marked `single: true`
+exists once in the app, so opening it from another desktop switches to the
+desktop that has it. A kind marked `single: 'desktop'` exists once per desktop
+instead: the top-nav button, `navigate` and `openInPrimary` reveal the
+instance on the active desktop, or open one there when that desktop has none,
+and never switch desktop.
+
+```js
+kinds: {
+    model: { label: 'Model', isTopNav: true, single: 'desktop' },
+}
+```
+
+On desktop 2, clicking *Model* opens the model on desktop 2 even while
+desktop 1 shows its own; clicking it again reveals desktop 2's. Each desktop's
+instance is saved with its layout and restored there. The details, and what
+counts as a window on a desktop, are in
+[Shell and navigation](shell.md#a-kind-that-exists-once-per-desktop-single-desktop-01717).
+
 ## A saved layout that cannot be read (0.17.14)
 
 The shell saves its layout through the host's `state` under the key `desktops`

package/docs/components/shell.md

@@ -10,6 +10,7 @@ A complete first boot is in the [quickstart](../quickstart.md#hello-shell). This
 
 - [Opt-in shell features](#opt-in-shell-features)
 - [A kind that exists once: `single` (0.17.0)](#a-kind-that-exists-once-single-0170)
+- [A kind that exists once per desktop: `single: 'desktop'` (0.17.17)](#a-kind-that-exists-once-per-desktop-single-desktop-01717)
 - [An open single instance takes new props: `navigate(props)` (0.17.2)](#an-open-single-instance-takes-new-props-navigateprops-0172)
 - [A link to a kind nobody registered (0.17.2)](#a-link-to-a-kind-nobody-registered-0172)
 - [A pane that names what it shows: `ctx.setTitle` (0.12.1)](#a-pane-that-names-what-it-shows-ctxsettitle-0121)
@@ -74,6 +75,59 @@ with it. The taxonomy answers `isSingle(kind)`, `instanceKey(kind, props)` and
 `singleReason(kind)`; the window manager answers `isSingleKind(kind)`,
 `findInstance(kind, props)` and `revealInstance(kind, props)`.
 
+## A kind that exists once per desktop: `single: 'desktop'` (0.17.17)
+
+A virtual desktop is the tiles and panels the user arranged on it, so a page
+the user opens from the top nav belongs on the desktop they are looking at,
+not on another desktop that already shows it. Mark such a kind
+`single: 'desktop'`: at most one instance per desktop.
+
+```js
+createTaxonomy({
+    root: 'cosmos',
+    kinds: {
+        cosmos:  { label: 'Cosmos', isTopNav: true },
+        chart:   { label: 'Star chart', isTopNav: true, single: 'desktop' },  // one per desktop
+    },
+});
+```
+
+- **Every open path looks only at the active desktop** — `navigate`, the top
+  nav, `openInPrimary`, `openInTab*`, `splitLeafWith`, Back. When the desktop
+  has the instance (in a tile, in a top-nav page a tile switched away from, or
+  in a window on it) it is revealed there, as for `single: true`; when it has
+  none, one is opened there. The open never switches desktop, and the
+  instances on other desktops are left as they are.
+- **A window is on the desktop it was opened on** or moved to. A window
+  contained to a pane (`promoteInPlace`) is shown on that desktop only; a
+  free-floating one (`navigate(kind, props, { dest: 'window' })`) is drawn over
+  every desktop but is still the instance of the one it was opened on, never
+  of another: on desktop 1, *Model* reveals desktop 1's own model even while
+  desktop 2's floats in front of it.
+- **The copy verbs refuse** within the desktop, as for `single: true`.
+- **The move verbs refuse** to carry the kind onto a desktop that already holds
+  it: *Move to desktop N* (Alt+Shift+N and the tile and window menus, whose row
+  is greyed with the reason), and dropping a floating window onto another
+  desktop's tile. `wm.desktopMoveRefusal({ leafId } | { windowId }, idx)`
+  answers that reason, or null. Removing a desktop brings its windows across
+  to the active desktop and never closes one, so that desktop can then hold
+  the kind twice, until a reload keeps the first.
+- **Navigating inside a window looks on the window's own desktop**
+  (`openInWindow`, and the in-window navigation that goes through it): a
+  floating window of desktop 1 navigated to the kind while desktop 2 is on
+  screen reveals desktop 1's instance, and shows the kind itself when desktop
+  1 has none. The window stays on its desktop.
+- **A page restore and a restored layout dedupe per desktop**: a tile's archived
+  page brings its instance back unless that desktop has it live elsewhere, and
+  a reload keeps the first instance on each desktop. Each desktop's instance
+  survives, live or archived.
+
+`single: true` keeps its meaning: one instance in the app, and opening it
+switches to the desktop it is on. Because `'desktop'` names this mode, it is
+not read as a prop name. `findInstance(kind)` answers the active desktop's
+instance; the taxonomy answers `isSinglePerDesktop(kind)`, and
+`instanceKey(kind, props)` is the same for every props.
+
 ## An open single instance takes new props: `navigate(props)` (0.17.2)
 
 Revealing a `single` instance used to drop the props the open asked for: the

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "flexdesk",
-    "version": "0.17.16",
+    "version": "0.17.18",
     "description": "A tiling window manager and widget set for desktop-class web applications. Zero runtime dependencies.",
     "license": "MIT",
     "repository": {

package/src/tiling/kind_taxonomy.js

@@ -53,15 +53,17 @@
  *               not inserted and their toggles are disabled, showing
  *               `reason`.
  *
- *   single?     `true`, or the name of a prop. The kind exists ONCE: content
- *               that holds heavy app-wide state and must not be mounted
- *               twice. With `true` there is one instance of the kind; with a
- *               prop name there is one per value of that prop (`'id'`: one
- *               tile per record). The window manager makes every open path
- *               reveal the instance that exists, refuses the copy verbs with
- *               a reason, and keeps the first of any duplicates a restored
- *               layout holds. The root kind cannot be single: every new
- *               pane, tab and desktop is seeded with it.
+ *   single?     `true`, `'desktop'`, or the name of a prop. The kind exists
+ *               ONCE: content that holds heavy app-wide state and must not be
+ *               mounted twice. With `true` there is one instance of the kind;
+ *               with `'desktop'` there is one per virtual desktop, found and
+ *               opened on the active one (so `'desktop'` is not a prop name
+ *               here); with a prop name there is one per value of that prop
+ *               (`'id'`: one tile per record). The window manager makes every
+ *               open path reveal the instance that exists, refuses the copy
+ *               verbs with a reason, and keeps the first of any duplicates a
+ *               restored layout holds. The root kind cannot be single: every
+ *               new pane, tab and desktop is seeded with it.
  *
  *   window?     `{ width?, height? }` — the initial size, in px, of a managed
  *               window this kind opens in (`navigate(…, { dest: 'window' })`,
@@ -249,14 +251,19 @@ export function createTaxonomy({ kinds, root } = {}) {
         return s === true || (typeof s === 'string' && s !== '');
     };
 
+    /** Whether `kind` exists once per virtual desktop (`single: 'desktop'`)
+     *  rather than once in the app. */
+    const isSinglePerDesktop = (kind) => _kinds[kind]?.single === 'desktop';
+
     /** The identity of one instance of a single kind: two tab specs with the
-     *  same key are the same instance. `null` for a kind that is not single,
-     *  which is how callers ask both questions at once. Keyed by the kind and,
-     *  for `single: '<prop>'`, that prop's value as a string. */
+     *  same key are the same instance (on one desktop, for
+     *  `single: 'desktop'`). `null` for a kind that is not single, which is
+     *  how callers ask both questions at once. Keyed by the kind and, for
+     *  `single: '<prop>'`, that prop's value as a string. */
     const instanceKey = (kind, props) => {
         if (!isSingle(kind)) return null;
         const by = _kinds[kind].single;
-        if (by === true) return String(kind);
+        if (by === true || by === 'desktop') return String(kind);
         const v = props?.[by];
         return `${kind}\u0000${v == null ? '' : String(v)}`;
     };
@@ -287,6 +294,7 @@ export function createTaxonomy({ kinds, root } = {}) {
         panelOffer,
         topNavEntries,
         isSingle,
+        isSinglePerDesktop,
         instanceKey,
         singleReason,
         isWindowOnly,

package/src/tiling/shell.js

@@ -712,8 +712,11 @@ function _tileContextMenu(wm, leafId, x, y) {
             // `isPanel` above) never a panel: `moveFocusedToDesktop` refuses all
             // three too, because the keyboard reaches it without this menu.
             if (i === wm.desktops.activeIdx || d.fixed) continue;
+            // A desktop holds a `single: 'desktop'` kind once: greyed, saying so.
+            const refusal = wm.desktopMoveRefusal({ leafId }, i);
             items.push({ label: `Move to desktop ${d.label}`, icon: 'sweep',
-                         action: `move:${i}` });
+                         action: `move:${i}`, disabled: !!refusal,
+                         title: refusal || undefined });
         }
     }
     items.push({ separator: true });