flexdesk 0.13.0 → 0.14.0

package/README.md

@@ -1671,6 +1671,43 @@ const nc = new NotificationCenter({ eventBus, maxVisible: 3, overflow: 'collapse
 nc.mount(document.body);
 ```
 
+### 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
+dismissed, and four pieces draw it. Each works without the others:
+
+| Piece | Entry point | Does |
+|---|---|---|
+| `createAlertLog({ source, limit })` | `widgets` | Entries `{id, at, level, title, body?, ref?, read}`, newest first; `add`, `receive`, `markRead`, `dismiss`, `unreadCount`, `worstUnread`, `subscribe`, `loadMore` |
+| `localSource({ read, write })` | `widgets` | Keeps the whole log in one stored value (localStorage, a workspace file) |
+| `mountAlertsPane(el, { log, onOpen, onBadge, rules?, stillMatches? })` | `widgets` | Level chips with counts, a filter, day groups, relative times, Open / Dismiss / Mark all read / Clear, *Load older* |
+| `createBottomPanelTabs(el, { panes, remember, store, eventBus })` | `wm` | The `.twm-bp` tab strip: `select`, `setBadge(id, n, level)`, `bottompanel:show {tab}` |
+| `new NotificationHistory({ alertLog, mountPoint, alertsTab, onOpen })` | `widgets` | The bell shows the log's unread count in the worst level's colour; a click (and "+N more") opens the Alerts tab |
+
+A **source** is where entries live: `load({offset, limit})` answers
+`{entries, more?, unread?}`, plus `markRead(ids | null)` and, optionally,
+`dismiss(ids | null)`. Without `dismiss`, the pane offers no Dismiss or Clear.
+Levels are `info`, `warning` and `alert`; `warn`, `error` and `danger` are read as
+those.
+
+```js
+const log = createAlertLog({ source: {
+    load: ({ offset, limit }) => api.notifications({ offset, limit }),
+    markRead: (ids) => (ids ? Promise.all(ids.map(api.readNotification)) : api.readAll()),
+} });
+const tabs = createBottomPanelTabs(panelEl, { eventBus, panes: [
+    { id: 'alerts', label: 'Alerts', eager: true,
+      mount: (el, store, api) => mountAlertsPane(el, { log, onOpen: openRef,
+          onBadge: ({ unread, level }) => api.setBadge('alerts', unread, level) }) },
+] });
+new NotificationHistory({ notificationCenter: nc, eventBus, alertLog: log, mountPoint: statusBarEl }).mount();
+```
+
+An eager pane, and the first one shown, mount inside `createBottomPanelTabs`
+before it returns. Reach the host through `mount`'s `api` argument, not the
+variable being assigned. Without `alertLog` and `mountPoint`, `NotificationHistory`
+is the bell it was.
+
 ## The host port
 
 FlexDesk never touches `pywebview`, `fetch`, `localStorage` or the filesystem. It
@@ -1688,6 +1725,22 @@ createHost({
 
 `NULL_HOST` is a valid host with nothing behind it.
 
+Two adapters ship ready-made. `createPywebviewHost()` speaks to a pywebview
+window, and `createPhotinoHost()` (0.14.0) to a Photino.NET window over
+`window.external.sendMessage` / `receiveMessage`:
+
+```js
+import { createPhotinoHost } from '@flexdesk/host';
+
+// In a browser tab this is NULL_HOST. Keep a capability of your own by passing
+// it in, or leave one out with null.
+const host = createPhotinoHost({ state: myServerState, onEvent: (name, value) => {} });
+```
+
+Its `window.chrome()` answers `'native'`, `dialogs.saveFile` falls back to a
+Blob download when the window refuses, and the messages the C# side has to
+answer are in [`src/host/photino_host.md`](src/host/photino_host.md).
+
 ## Peer dependencies
 
 `@flexdesk/charts` needs Plotly (4.4 MB). `@flexdesk/editor` needs Monaco (14 MB).

package/css/flexdesk.css

@@ -394,6 +394,12 @@
     padding: 0 3px;
     line-height: 1;
 }
+/* On an alert log (STORY-0020): the worst unread level's colour, and the bell
+ * itself brighter while anything is unread. */
+.twm-notification-history__badge--info    { background: var(--color-info); }
+.twm-notification-history__badge--warning { background: var(--color-warning); color: #1e1e1e; }
+.twm-notification-history__badge--alert   { background: var(--color-danger); }
+.twm-notification-history__trigger--unread { color: var(--text-bright); }
 .twm-notification-history__panel {
     position: fixed;
     z-index: 9999;
@@ -7737,6 +7743,28 @@ tr:hover .twm-row-action { opacity: 1; }
     color: var(--text-bright);
     border-bottom-color: #fff;
 }
+/* A tab's count (createBottomPanelTabs' setBadge): Alerts' unread in the
+ * worst unread level's colour, a Changes count in the neutral one. */
+.twm-bp__badge {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 16px;
+    height: 16px;
+    margin-left: 6px;
+    padding: 0 4px;
+    box-sizing: border-box;
+    border-radius: 8px;
+    background: var(--accent);
+    color: #fff;
+    font-size: 10.5px;
+    line-height: 16px;
+    text-transform: none;
+}
+.twm-bp__badge[hidden] { display: none; }
+.twm-bp__badge--info    { background: color-mix(in srgb, var(--color-info) 35%, var(--surface-0)); }
+.twm-bp__badge--warning { background: color-mix(in srgb, var(--color-warning) 35%, var(--surface-0)); }
+.twm-bp__badge--alert   { background: color-mix(in srgb, var(--color-danger) 45%, var(--surface-0)); }
 .twm-bp__body {
     flex: 1 1 auto;
     min-height: 0;
@@ -7782,6 +7810,77 @@ tr:hover .twm-row-action { opacity: 1; }
 .twm-bp-log__row--error .twm-bp-log__level,
 .twm-bp-log__row--error .twm-bp-log__msg { color: var(--color-danger); }
 .twm-bp-log__msg { color: var(--text-body); white-space: pre-wrap; word-break: break-word; }
+
+/* ── The Alerts pane (alerts_pane.js, STORY-0019) ─────────────────────────
+ * bugdesk's Alerts tab, on tokens: rules on the left when the embedder has
+ * them, the log on the right, newest first, grouped by day. */
+.twm-alerts { display: flex; height: 100%; min-height: 0; font-size: var(--font-size-xs); color: var(--text-body); }
+/* In the bottom panel the pane fills the body, so the log scrolls and the
+ * status line sits at the foot. Only a pane holding the Alerts pane: other
+ * panes keep their padding and their own height. */
+.twm-bp-pane:has(> .twm-alerts) { height: 100%; padding: 0; box-sizing: border-box; }
+.twm-alerts .material-symbols-outlined { font-size: 15px; }
+.twm-alerts__spacer { flex: 1 1 auto; }
+.twm-alerts__rules { flex: 0 0 280px; display: flex; flex-direction: column; min-width: 0; border-right: 1px solid var(--border-subtle); }
+.twm-alerts__head, .twm-alerts__bar { flex: none; display: flex; align-items: center; gap: 8px; min-height: 34px; padding: 0 12px; border-bottom: 1px solid var(--border-subtle); }
+.twm-alerts__bar { flex-wrap: wrap; }
+.twm-alerts__caps { color: var(--text-muted); font-size: 10.5px; letter-spacing: .08em; }
+.twm-alerts__link { padding: 0; border: 0; background: none; color: var(--accent-bright); font: inherit; cursor: pointer; }
+.twm-alerts__link:hover { text-decoration: underline; }
+.twm-alerts__rulelist { flex: 1 1 auto; overflow-y: auto; padding: 4px 0; }
+.twm-alerts__rulebtn { width: 100%; display: flex; align-items: center; gap: 10px; height: 30px; padding: 0 12px; border: 0; background: none; color: var(--text-body); font: inherit; cursor: pointer; }
+.twm-alerts__rulebtn:hover { background: var(--state-hover); }
+.twm-alerts__rulebtn--on { background: var(--state-selected); box-shadow: inset 2px 0 0 var(--accent-bright); }
+.twm-alerts__rulebtn--off { color: var(--text-dim); }
+.twm-alerts__dot { flex: none; width: 8px; height: 8px; border-radius: 50%; }
+.twm-alerts__dot--alert { background: var(--color-danger); }
+.twm-alerts__dot--warning { background: var(--color-warning); }
+.twm-alerts__dot--info { background: var(--color-info); }
+.twm-alerts__rulename { flex: 1; min-width: 0; text-align: left; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.twm-alerts__meta { flex: none; color: var(--text-muted); font-size: 11px; }
+.twm-alerts__foot { padding: 6px 12px; border-top: 1px solid var(--border-subtle); color: var(--text-muted); font-size: 11px; line-height: 1.4; }
+.twm-alerts__main { flex: 1 1 auto; min-width: 0; display: flex; flex-direction: column; }
+.twm-alerts__chips { display: flex; gap: 4px; }
+.twm-alerts__chip { height: 24px; padding: 0 10px; border: 1px solid var(--surface-3); border-radius: 12px; background: none; color: var(--text-secondary); font: inherit; cursor: pointer; }
+.twm-alerts__chip:hover { color: var(--text-bright); }
+.twm-alerts__count { color: var(--text-muted); }
+.twm-alerts__chip--on { border-color: var(--accent-bright); background: var(--state-selected); color: var(--text-bright); }
+.twm-alerts__q { width: 220px; height: 24px; box-sizing: border-box; padding: 0 8px; border: 1px solid var(--surface-3); border-radius: 3px; background: var(--surface-1); color: var(--text-body); font: inherit; }
+.twm-alerts__q:focus { outline: none; border-color: var(--accent-bright); }
+.twm-alerts__btn { height: 24px; }
+.twm-alerts__btn[hidden] { display: none; }
+.twm-alerts__log { flex: 1 1 auto; min-height: 0; overflow-y: auto; }
+.twm-alerts__day { padding: 8px 12px 4px 34px; color: var(--text-muted); font-size: 10.5px; letter-spacing: .08em; }
+.twm-alerts__row { display: flex; align-items: center; gap: 10px; height: 30px; padding: 0 12px; }
+.twm-alerts__row:hover { background: var(--state-hover); }
+.twm-alerts__unread { flex: 0 0 7px; height: 7px; border-radius: 50%; }
+.twm-alerts__row--unread .twm-alerts__unread { background: var(--accent-bright); }
+.twm-alerts__icon { flex: 0 0 18px; }
+.twm-alerts__row--info .twm-alerts__icon { color: var(--color-info); }
+.twm-alerts__row--warning .twm-alerts__icon { color: var(--color-warning); }
+.twm-alerts__row--alert .twm-alerts__icon { color: var(--color-danger); }
+.twm-alerts__time { flex: 0 0 78px; color: var(--text-muted); white-space: nowrap; }
+.twm-alerts__rule { flex: 0 0 170px; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--text-primary); }
+.twm-alerts__tag { flex: none; display: inline-flex; align-items: center; height: 18px; padding: 0 6px; border-radius: 3px; background: var(--surface-2); color: var(--text-secondary); font-size: 10.5px; }
+.twm-alerts__tag--none { display: none; }
+.twm-alerts__ref { flex: 0 0 auto; max-width: 140px; padding: 0; border: 0; background: none; font-family: var(--font-family-mono); font-size: 11.5px; color: var(--accent-bright); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: left; }
+button.twm-alerts__ref { cursor: pointer; }
+button.twm-alerts__ref:hover { text-decoration: underline; }
+.twm-alerts__ref:empty { display: none; }
+.twm-alerts__text { flex: 1 1 auto; min-width: 0; display: flex; gap: 8px; overflow: hidden; white-space: nowrap; }
+.twm-alerts__title { overflow: hidden; text-overflow: ellipsis; color: var(--text-secondary); }
+.twm-alerts__row--unread .twm-alerts__title { color: var(--text-primary); font-weight: 500; }
+.twm-alerts__body { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; color: var(--text-muted); }
+.twm-alerts__state { flex: 0 0 128px; font-size: 11px; color: var(--text-muted); }
+.twm-alerts__state--gone { color: var(--text-dim); font-style: italic; }
+.twm-alerts__acts { flex: 0 0 auto; display: flex; justify-content: flex-end; gap: 2px; }
+.twm-alerts__icon-btn { display: inline-flex; align-items: center; justify-content: center; width: 24px; height: 24px; padding: 0; border: 0; border-radius: 3px; background: none; color: var(--text-muted); cursor: pointer; }
+.twm-alerts__icon-btn:hover { background: var(--surface-2); color: var(--text-bright); }
+.twm-alerts__icon-btn .material-symbols-outlined { font-size: 14px; }
+.twm-alerts__none { padding: 28px 16px; text-align: center; color: var(--text-muted); }
+.twm-alerts__more { display: block; margin: 8px auto; height: 24px; }
+.twm-alerts__status { flex: none; display: flex; align-items: center; height: 26px; padding: 0 12px; border-top: 1px solid var(--border-subtle); color: var(--text-muted); font-size: 11px; }
+.twm-alerts__status[hidden] { display: none; }
 /* Context menu — override main_new.css's .twm-context-menu to the tighter,
  * grid-style look (icon | label) with a flat surface-1 background and
  * square corners. All callers (sidebars, tile chrome, desktop bar, …)

package/dist/flexdesk.css

@@ -394,6 +394,12 @@
     padding: 0 3px;
     line-height: 1;
 }
+/* On an alert log (STORY-0020): the worst unread level's colour, and the bell
+ * itself brighter while anything is unread. */
+.twm-notification-history__badge--info    { background: var(--color-info); }
+.twm-notification-history__badge--warning { background: var(--color-warning); color: #1e1e1e; }
+.twm-notification-history__badge--alert   { background: var(--color-danger); }
+.twm-notification-history__trigger--unread { color: var(--text-bright); }
 .twm-notification-history__panel {
     position: fixed;
     z-index: 9999;
@@ -7737,6 +7743,28 @@ tr:hover .twm-row-action { opacity: 1; }
     color: var(--text-bright);
     border-bottom-color: #fff;
 }
+/* A tab's count (createBottomPanelTabs' setBadge): Alerts' unread in the
+ * worst unread level's colour, a Changes count in the neutral one. */
+.twm-bp__badge {
+    display: inline-flex;
+    align-items: center;
+    justify-content: center;
+    min-width: 16px;
+    height: 16px;
+    margin-left: 6px;
+    padding: 0 4px;
+    box-sizing: border-box;
+    border-radius: 8px;
+    background: var(--accent);
+    color: #fff;
+    font-size: 10.5px;
+    line-height: 16px;
+    text-transform: none;
+}
+.twm-bp__badge[hidden] { display: none; }
+.twm-bp__badge--info    { background: color-mix(in srgb, var(--color-info) 35%, var(--surface-0)); }
+.twm-bp__badge--warning { background: color-mix(in srgb, var(--color-warning) 35%, var(--surface-0)); }
+.twm-bp__badge--alert   { background: color-mix(in srgb, var(--color-danger) 45%, var(--surface-0)); }
 .twm-bp__body {
     flex: 1 1 auto;
     min-height: 0;
@@ -7782,6 +7810,77 @@ tr:hover .twm-row-action { opacity: 1; }
 .twm-bp-log__row--error .twm-bp-log__level,
 .twm-bp-log__row--error .twm-bp-log__msg { color: var(--color-danger); }
 .twm-bp-log__msg { color: var(--text-body); white-space: pre-wrap; word-break: break-word; }
+
+/* ── The Alerts pane (alerts_pane.js, STORY-0019) ─────────────────────────
+ * bugdesk's Alerts tab, on tokens: rules on the left when the embedder has
+ * them, the log on the right, newest first, grouped by day. */
+.twm-alerts { display: flex; height: 100%; min-height: 0; font-size: var(--font-size-xs); color: var(--text-body); }
+/* In the bottom panel the pane fills the body, so the log scrolls and the
+ * status line sits at the foot. Only a pane holding the Alerts pane: other
+ * panes keep their padding and their own height. */
+.twm-bp-pane:has(> .twm-alerts) { height: 100%; padding: 0; box-sizing: border-box; }
+.twm-alerts .material-symbols-outlined { font-size: 15px; }
+.twm-alerts__spacer { flex: 1 1 auto; }
+.twm-alerts__rules { flex: 0 0 280px; display: flex; flex-direction: column; min-width: 0; border-right: 1px solid var(--border-subtle); }
+.twm-alerts__head, .twm-alerts__bar { flex: none; display: flex; align-items: center; gap: 8px; min-height: 34px; padding: 0 12px; border-bottom: 1px solid var(--border-subtle); }
+.twm-alerts__bar { flex-wrap: wrap; }
+.twm-alerts__caps { color: var(--text-muted); font-size: 10.5px; letter-spacing: .08em; }
+.twm-alerts__link { padding: 0; border: 0; background: none; color: var(--accent-bright); font: inherit; cursor: pointer; }
+.twm-alerts__link:hover { text-decoration: underline; }
+.twm-alerts__rulelist { flex: 1 1 auto; overflow-y: auto; padding: 4px 0; }
+.twm-alerts__rulebtn { width: 100%; display: flex; align-items: center; gap: 10px; height: 30px; padding: 0 12px; border: 0; background: none; color: var(--text-body); font: inherit; cursor: pointer; }
+.twm-alerts__rulebtn:hover { background: var(--state-hover); }
+.twm-alerts__rulebtn--on { background: var(--state-selected); box-shadow: inset 2px 0 0 var(--accent-bright); }
+.twm-alerts__rulebtn--off { color: var(--text-dim); }
+.twm-alerts__dot { flex: none; width: 8px; height: 8px; border-radius: 50%; }
+.twm-alerts__dot--alert { background: var(--color-danger); }
+.twm-alerts__dot--warning { background: var(--color-warning); }
+.twm-alerts__dot--info { background: var(--color-info); }
+.twm-alerts__rulename { flex: 1; min-width: 0; text-align: left; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.twm-alerts__meta { flex: none; color: var(--text-muted); font-size: 11px; }
+.twm-alerts__foot { padding: 6px 12px; border-top: 1px solid var(--border-subtle); color: var(--text-muted); font-size: 11px; line-height: 1.4; }
+.twm-alerts__main { flex: 1 1 auto; min-width: 0; display: flex; flex-direction: column; }
+.twm-alerts__chips { display: flex; gap: 4px; }
+.twm-alerts__chip { height: 24px; padding: 0 10px; border: 1px solid var(--surface-3); border-radius: 12px; background: none; color: var(--text-secondary); font: inherit; cursor: pointer; }
+.twm-alerts__chip:hover { color: var(--text-bright); }
+.twm-alerts__count { color: var(--text-muted); }
+.twm-alerts__chip--on { border-color: var(--accent-bright); background: var(--state-selected); color: var(--text-bright); }
+.twm-alerts__q { width: 220px; height: 24px; box-sizing: border-box; padding: 0 8px; border: 1px solid var(--surface-3); border-radius: 3px; background: var(--surface-1); color: var(--text-body); font: inherit; }
+.twm-alerts__q:focus { outline: none; border-color: var(--accent-bright); }
+.twm-alerts__btn { height: 24px; }
+.twm-alerts__btn[hidden] { display: none; }
+.twm-alerts__log { flex: 1 1 auto; min-height: 0; overflow-y: auto; }
+.twm-alerts__day { padding: 8px 12px 4px 34px; color: var(--text-muted); font-size: 10.5px; letter-spacing: .08em; }
+.twm-alerts__row { display: flex; align-items: center; gap: 10px; height: 30px; padding: 0 12px; }
+.twm-alerts__row:hover { background: var(--state-hover); }
+.twm-alerts__unread { flex: 0 0 7px; height: 7px; border-radius: 50%; }
+.twm-alerts__row--unread .twm-alerts__unread { background: var(--accent-bright); }
+.twm-alerts__icon { flex: 0 0 18px; }
+.twm-alerts__row--info .twm-alerts__icon { color: var(--color-info); }
+.twm-alerts__row--warning .twm-alerts__icon { color: var(--color-warning); }
+.twm-alerts__row--alert .twm-alerts__icon { color: var(--color-danger); }
+.twm-alerts__time { flex: 0 0 78px; color: var(--text-muted); white-space: nowrap; }
+.twm-alerts__rule { flex: 0 0 170px; min-width: 0; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; color: var(--text-primary); }
+.twm-alerts__tag { flex: none; display: inline-flex; align-items: center; height: 18px; padding: 0 6px; border-radius: 3px; background: var(--surface-2); color: var(--text-secondary); font-size: 10.5px; }
+.twm-alerts__tag--none { display: none; }
+.twm-alerts__ref { flex: 0 0 auto; max-width: 140px; padding: 0; border: 0; background: none; font-family: var(--font-family-mono); font-size: 11.5px; color: var(--accent-bright); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; text-align: left; }
+button.twm-alerts__ref { cursor: pointer; }
+button.twm-alerts__ref:hover { text-decoration: underline; }
+.twm-alerts__ref:empty { display: none; }
+.twm-alerts__text { flex: 1 1 auto; min-width: 0; display: flex; gap: 8px; overflow: hidden; white-space: nowrap; }
+.twm-alerts__title { overflow: hidden; text-overflow: ellipsis; color: var(--text-secondary); }
+.twm-alerts__row--unread .twm-alerts__title { color: var(--text-primary); font-weight: 500; }
+.twm-alerts__body { flex: 1 1 auto; min-width: 0; overflow: hidden; text-overflow: ellipsis; color: var(--text-muted); }
+.twm-alerts__state { flex: 0 0 128px; font-size: 11px; color: var(--text-muted); }
+.twm-alerts__state--gone { color: var(--text-dim); font-style: italic; }
+.twm-alerts__acts { flex: 0 0 auto; display: flex; justify-content: flex-end; gap: 2px; }
+.twm-alerts__icon-btn { display: inline-flex; align-items: center; justify-content: center; width: 24px; height: 24px; padding: 0; border: 0; border-radius: 3px; background: none; color: var(--text-muted); cursor: pointer; }
+.twm-alerts__icon-btn:hover { background: var(--surface-2); color: var(--text-bright); }
+.twm-alerts__icon-btn .material-symbols-outlined { font-size: 14px; }
+.twm-alerts__none { padding: 28px 16px; text-align: center; color: var(--text-muted); }
+.twm-alerts__more { display: block; margin: 8px auto; height: 24px; }
+.twm-alerts__status { flex: none; display: flex; align-items: center; height: 26px; padding: 0 12px; border-top: 1px solid var(--border-subtle); color: var(--text-muted); font-size: 11px; }
+.twm-alerts__status[hidden] { display: none; }
 /* Context menu — override main_new.css's .twm-context-menu to the tighter,
  * grid-style look (icon | label) with a flat surface-1 background and
  * square corners. All callers (sidebars, tile chrome, desktop bar, …)

package/dist/flow.js

@@ -199,6 +199,7 @@ function openPopover({ anchor, content, label, className = "", onClose = null, f
     handle.close("escape");
   };
   const onResize = () => place();
+  const sized = typeof ResizeObserver === "function" ? new ResizeObserver(() => place()) : null;
   const handle = {
     el: pop,
     anchor,
@@ -212,6 +213,7 @@ function openPopover({ anchor, content, label, className = "", onClose = null, f
       document.removeEventListener("mousedown", onPress, true);
       pop.removeEventListener("keydown", onKey);
       window.removeEventListener("resize", onResize);
+      sized?.disconnect();
       pop.remove();
       if (ACTIVE === handle) ACTIVE = null;
       if (held && reason !== "blur" && anchor?.isConnected) anchor.focus?.({ preventScroll: true });
@@ -226,6 +228,7 @@ function openPopover({ anchor, content, label, className = "", onClose = null, f
   }, 0);
   pop.addEventListener("keydown", onKey);
   window.addEventListener("resize", onResize);
+  sized?.observe(pop);
   place();
   (focus || pop).focus?.({ preventScroll: true });
   return handle;