flexdesk 0.12.1 → 0.14.0

package/README.md

@@ -45,7 +45,7 @@ manager, and neither of them should drag in a plotting engine or a code editor.
 | `@flexdesk/wm` | 166 kB | Tiling window manager: tabs, splits, desktops, command palette, taxonomy, `createShell()` |
 | `@flexdesk/widgets` | 192 kB | DataTable, modals, managed windows, toasts, trees, panels, context menus |
 | `@flexdesk/charts` | 26 kB | Plotly wrapper, chart types, subplot layouts, downsampling, plot windows |
-| `@flexdesk/tiles` | 67 kB | Draggable/resizable widget grid, tile base class, widget registry, layout persistence |
+| `@flexdesk/tiles` | 67 kB | Draggable/resizable widget grid, tile base class, widget registry, layout persistence, chart and KPI tiles |
 | `@flexdesk/editor` | 62 kB | Monaco loader + factory, multi-file tab bar, search, split panes, undo manager |
 | `@flexdesk/canvas` | 14 kB | The canvas kernel: a pannable, zoomable surface, the edge router, a generic graph layer ([Flow editors](#flow-editors)) |
 | `@flexdesk/flow` | 381 kB | The flow-editor kit and the canvas, outline and lane editors ([Flow editors](#flow-editors)) |
@@ -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).
@@ -1731,6 +1784,38 @@ the configuration step is explicit rather than lazy.
 A layout is keyed by *something* — a document, a user, a run — and the library has
 no opinion about which. It calls that a `contextId`.
 
+### Chart and KPI tiles (0.13.0)
+
+`@flexdesk/tiles` ships two widgets: `flexdesk.chart` (line, bar, area, scatter,
+pie, donut, funnel, histogram — Plotly, so `setPlotlySource` first) and
+`flexdesk.kpi` (one number, a label and an optional delta; plain DOM, no Plotly).
+Nothing registers at import — call `registerChartTiles()` (idempotent). You hand
+a tile **already-computed** series; turning records into series is yours:
+
+```js
+import { registerChartTiles } from '@flexdesk/tiles';
+registerChartTiles();
+const chart = grid.addTile('flexdesk.chart', { x: 0, y: 0, w: 6, h: 4 },
+                           { chart_type: 'line', title: 'Burndown', unit: 'pts' });
+chart.onPointClick = ({ customdata }) => openItem(customdata);
+chart.setData({
+    series: [
+        { x: days, y: remaining, name: 'Remaining', interpolation: 'step', customdata: ids },
+        { x: days, y: ideal, name: 'Ideal', lineStyle: 'dashed' },
+    ],
+    markers: [{ x: today, label: 'Today' }],   // vertical lines
+    note: 'From 41 stories',                    // a line under the figure
+});
+grid.addTile('flexdesk.kpi', { x: 6, y: 0, w: 3, h: 2 }, { title: 'Open', unit: 'bugs' })
+    .setData({ value: 42, reference: 37 });     // ▲ +5 bugs
+```
+
+`setData(null)` or an empty series is the empty state, and it releases any figure
+still drawing. A pie takes `{labels, values}`, a histogram `{values}`. The config
+(`chart_type`, `title`, `unit`, …) round-trips through `getLayout()`/`setLayout()`.
+`buildOverlayShapes` gained `verticalLines: [{x, label?, color?, lineStyle?}]` for
+the same marker outside a tile.
+
 ## 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;
@@ -3448,6 +3454,83 @@ body.twm-window-maximized .twm-resize-handle {
 .twm-tile-error .material-symbols-outlined {
     font-size: 32px;
 }
+
+/* ── the chart and KPI tiles (0.13.0, src/tiles/chart_tiles.js) ──────── */
+/* The figure flexes into what `.tile-content`'s column leaves; the note takes
+   its own line BELOW it, so the height chain above is untouched. */
+.fd-chart-tile {
+    display: flex;
+    flex-direction: column;
+    flex: 1 1 auto;
+    min-width: 0;
+    min-height: 0;
+    position: relative;
+}
+
+/* Plotly puts `.js-plotly-plot` on the figure itself, and the rule above makes
+   that `height: 100% !important` — which, beside a note, pushes the note out of
+   the tile. Here the flex column sizes the figure instead. */
+.tile-content .fd-chart-tile.js-plotly-plot {
+    height: auto !important;
+}
+
+.fd-chart-tile__note {
+    flex: 0 0 auto;
+    padding: 2px 8px 0;
+    font-size: var(--font-size-xs);
+    line-height: 1.35;
+    color: var(--text-muted);
+    white-space: nowrap;
+    overflow: hidden;
+    text-overflow: ellipsis;
+}
+
+.fd-kpi {
+    --fd-kpi-value: 30px;
+    flex: 1 1 auto;
+    display: flex;
+    flex-direction: column;
+    align-items: flex-start;
+    justify-content: center;
+    gap: 2px;
+    min-height: 0;
+}
+
+.fd-kpi__label {
+    color: var(--text-secondary);
+    font-size: var(--font-size-xs);
+    text-transform: uppercase;
+    letter-spacing: 0.06em;
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 100%;
+}
+
+.fd-kpi__value {
+    font-size: var(--fd-kpi-value);
+    font-weight: 700;
+    color: var(--text-bright);
+    line-height: 1.1;
+    font-variant-numeric: tabular-nums;
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 100%;
+}
+
+/* AN ARROW AND A SIGN, not a colour alone: the modifiers change the colour,
+   the character in front of the number survives a monochrome display. */
+.fd-kpi__delta {
+    display: inline-flex;
+    align-items: center;
+    gap: 3px;
+    font-size: var(--font-size-sm);
+    font-variant-numeric: tabular-nums;
+    color: var(--text-secondary);
+}
+.fd-kpi__delta--up { color: var(--color-success); }
+.fd-kpi__delta--down { color: var(--color-danger); }
+
+.fd-kpi__foot {
+    color: var(--text-muted);
+    font-size: var(--font-size-xs);
+    white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 100%;
+}
 /* ===================================================================
    REUSABLE ACTION DROPDOWN COMPONENT
    Used by Add Scenario, Add Widget, and other action dropdowns
@@ -7660,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;
@@ -7705,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

@@ -27,6 +27,7 @@ import {
   hasPlot,
   hexToRgba,
   is3DChart,
+  lttb,
   makeDefaultSubplot,
   migrateData,
   migrateSingleChart,
@@ -37,9 +38,11 @@ import {
   resize,
   restyle,
   setPlotlySource,
+  strideDownsampleShared,
+  strideIndices,
   uid,
   updateChart
-} from "./chunk-2LEJQD4H.js";
+} from "./chunk-IYMNDPWH.js";
 import {
   createRafResizeObserver
 } from "./chunk-M2L4XW2U.js";
@@ -660,78 +663,6 @@ function closeDataSeriesPlotWindow(seriesId) {
     _openPlotWindows.delete(seriesId);
   }
 }
-
-// src/charts/downsample.js
-function strideIndices(n, targetPoints) {
-  if (!Number.isFinite(n) || n <= 0) return null;
-  const target = Math.max(2, Math.floor(targetPoints) || 0);
-  if (n <= target) return null;
-  const step = (n - 1) / (target - 1);
-  const idx = new Array(target);
-  for (let i = 0; i < target; i++) idx[i] = Math.round(i * step);
-  idx[target - 1] = n - 1;
-  let w = 0;
-  for (let r = 0; r < idx.length; r++) {
-    if (w === 0 || idx[r] > idx[w - 1]) idx[w++] = idx[r];
-  }
-  idx.length = w;
-  return idx;
-}
-function strideDownsampleShared(time, series, targetPoints) {
-  const idx = strideIndices(time?.length ?? 0, targetPoints);
-  if (!idx) return { time, series };
-  const dsTime = idx.map((i) => time[i]);
-  const dsSeries = {};
-  for (const [name, arr] of Object.entries(series || {})) {
-    if (!Array.isArray(arr)) {
-      dsSeries[name] = arr;
-      continue;
-    }
-    dsSeries[name] = idx.map((i) => i < arr.length ? arr[i] : null);
-  }
-  return { time: dsTime, series: dsSeries };
-}
-function lttb(x, y, threshold) {
-  const n = Math.min(x?.length ?? 0, y?.length ?? 0);
-  const target = Math.floor(threshold) || 0;
-  if (target <= 0 || target >= n) return { x: x.slice(0, n), y: y.slice(0, n) };
-  if (target < 3) return { x: [x[0], x[n - 1]], y: [y[0], y[n - 1]] };
-  const num = (v) => Number.isFinite(v) ? v : 0;
-  const outX = [x[0]];
-  const outY = [y[0]];
-  const bucketSize = (n - 2) / (target - 2);
-  let a = 0;
-  for (let i = 0; i < target - 2; i++) {
-    let nextStart = Math.floor((i + 1) * bucketSize) + 1;
-    let nextEnd = Math.min(Math.floor((i + 2) * bucketSize) + 1, n);
-    if (nextEnd <= nextStart) nextEnd = Math.min(nextStart + 1, n);
-    let avgX = 0, avgY = 0;
-    const count = nextEnd - nextStart;
-    for (let j = nextStart; j < nextEnd; j++) {
-      avgX += x[j];
-      avgY += num(y[j]);
-    }
-    avgX /= count;
-    avgY /= count;
-    const curStart = Math.floor(i * bucketSize) + 1;
-    const curEnd = Math.min(Math.floor((i + 1) * bucketSize) + 1, n);
-    const ax = x[a], ay = num(y[a]);
-    let maxArea = -1, chosen = curStart;
-    for (let j = curStart; j < curEnd; j++) {
-      const area = Math.abs((ax - avgX) * (num(y[j]) - ay) - (ax - x[j]) * (avgY - ay));
-      if (area > maxArea) {
-        maxArea = area;
-        chosen = j;
-      }
-    }
-    outX.push(x[chosen]);
-    outY.push(y[chosen]);
-    a = chosen;
-  }
-  outX.push(x[n - 1]);
-  outY.push(y[n - 1]);
-  return { x: outX, y: outY };
-}
 export {
   ALL_CHART_TYPES,
   CHART_TYPES_2D,