flexdesk 0.13.0 → 0.14.1

package/README.md

@@ -907,6 +907,20 @@ list.setColumnVisible(3, true);
 A column sorted on and then hidden keeps the order; its arrow comes back with
 the column.
 
+### DataTable: the CSV button on every table (0.14.1)
+
+`showExportButton: true` draws "Download visible rows as CSV" in the pagination
+strip, and now draws the strip for it on a table that fits on one page too (the
+button alone, no page buttons). `exportFilename` — a string, or `(table) =>
+string` — names the file (default `data.csv`). With a `host` that has `dialogs`
+the button opens the native Save dialog, suggesting that name; without one it
+is a browser download.
+
+```js
+DataTable.mount(el, { headers, rows, pagination: true, showExportButton: true,
+                      exportFilename: 'bugs.csv', host });
+```
+
 ### DataTable: a select mode (0.12.0)
 
 A list whose click opens a row can still let people pick many rows: a toggle
@@ -1671,6 +1685,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 +1739,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).
@@ -1763,6 +1830,11 @@ still drawing. A pie takes `{labels, values}`, a histogram `{values}`. The confi
 `buildOverlayShapes` gained `verticalLines: [{x, label?, color?, lineStyle?}]` for
 the same marker outside a tile.
 
+A chart tile's **Download PNG** (0.14.1) goes through the grid's `host`
+(`new TileGrid({ host })`): with `dialogs`, the native Save dialog — a save
+toasts where the file went, a cancel says nothing — and with no host, or a
+`saveFile` that answers null, the browser download it always was.
+
 ## Styling
 
 Three stylesheets, and that is the whole CSS contract:

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/charts.js

@@ -42,10 +42,10 @@ import {
   strideIndices,
   uid,
   updateChart
-} from "./chunk-IYMNDPWH.js";
+} from "./chunk-RQM5Z2MU.js";
 import {
   createRafResizeObserver
-} from "./chunk-M2L4XW2U.js";
+} from "./chunk-FBGP5KN5.js";
 import {
   ManagedWindow
 } from "./chunk-6JSOVNID.js";

package/dist/{chunk-M2L4XW2U.js → chunk-FBGP5KN5.js}

@@ -683,6 +683,7 @@ var DataTable = class {
       onRowContextMenu: null,
       onCellContextMenu: null,
       showExportButton: false,
+      exportFilename: null,
       // The host port. TOP LEVEL, deliberately — NOT inside `services`,
       // which most call sites never pass. Supplies the native save
       // dialog for downloadCSV(); absent => Blob fallback.
@@ -2400,7 +2401,7 @@ var DataTable = class {
     const displayedRows = isServerSide ? rows.length : Math.min(pageSize, effectiveTotal - offset);
     const endRow = Math.min(offset + displayedRows, effectiveTotal);
     const totalPages = Math.max(1, Math.ceil(effectiveTotal / pageSize));
-    if (totalPages <= 1 && !isFiltered) return null;
+    if (totalPages <= 1 && !isFiltered) return this._createExportOnlyStrip();
     const currentPage = Math.floor(offset / pageSize) + 1;
     const hasPrev = offset > 0;
     const hasNext = offset + pageSize < effectiveTotal;
@@ -2471,15 +2472,33 @@ var DataTable = class {
     el.appendChild(lastBtn);
     el.appendChild(jumpInput);
     el.appendChild(jumpBtn);
-    if (this.config.showExportButton) {
-      const exportBtn = this._createPaginationBtn(
-        "download",
-        "Download visible rows as CSV",
-        false,
-        () => this.downloadCSV("data.csv")
-      );
-      el.appendChild(exportBtn);
-    }
+    if (this.config.showExportButton) el.appendChild(this._createExportBtn());
+    return el;
+  }
+  /** The export button: downloadCSV() under the configured file name. */
+  _createExportBtn() {
+    const name = this.config.exportFilename;
+    const filename = (typeof name === "function" ? name(this) : name) || "data.csv";
+    return this._createPaginationBtn(
+      "download",
+      "Download visible rows as CSV",
+      false,
+      () => this.downloadCSV(filename)
+    );
+  }
+  /**
+   * The strip on a table with one page: nothing, as always, unless the export
+   * button needs somewhere to be. Then the button alone, with no page
+   * buttons (0.14.1).
+   */
+  _createExportOnlyStrip() {
+    if (!this.config.showExportButton) return null;
+    const el = document.createElement("div");
+    el.className = "twm-pagination-controls twm-pagination-controls--export-only";
+    el.style.cssText = "display:flex; align-items:center; gap:6px; padding:2px 8px; border-bottom:1px solid #2a2a2a; font-size:11px;";
+    const spacer = document.createElement("div");
+    spacer.style.flex = "1";
+    el.append(spacer, this._createExportBtn());
     return el;
   }
   _createPaginationBtn(icon, tooltip, disabled, onClick, textLabel = null) {
@@ -4277,8 +4296,8 @@ var DataTable = class {
     const pn = this._pageNav({ offset, held: drawn, total, hasMore: hasMoreKnown, pageSize });
     const { hasPrev, hasNext, page } = pn;
     const totalPages = pn.pages;
-    if (known && totalPages <= 1 && !isFiltered && !hasPrev) return null;
-    if (!known && !hasPrev && !hasNext) return null;
+    if (known && totalPages <= 1 && !isFiltered && !hasPrev) return this._createExportOnlyStrip();
+    if (!known && !hasPrev && !hasNext) return this._createExportOnlyStrip();
     const maxJump = Number.isFinite(c.maxJumpOffset) ? c.maxJumpOffset : null;
     const go = (newOffset) => {
       if (source) {
@@ -4372,14 +4391,7 @@ var DataTable = class {
     }, "Go");
     jumpBtn.dataset.pager = "go";
     el.append(info, spacer, firstBtn, prevBtn, pageInfo, nextBtn, lastBtn, jumpInput, jumpBtn);
-    if (c.showExportButton) {
-      el.appendChild(this._createPaginationBtn(
-        "download",
-        "Download visible rows as CSV",
-        false,
-        () => this.downloadCSV("data.csv")
-      ));
-    }
+    if (c.showExportButton) el.appendChild(this._createExportBtn());
     return el;
   }
   // ─────────────────────────────────────────────────────────────────
@@ -6168,4 +6180,4 @@ export {
   resolvePaging,
   DataTable
 };
-//# sourceMappingURL=chunk-M2L4XW2U.js.map
+//# sourceMappingURL=chunk-FBGP5KN5.js.map