flexdesk 0.17.7 → 0.17.9

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # Changelog
 
+## 0.17.9 (2026-10-25)
+
+A patch release: everything below is additive. Every fix is documented in a
+section of the docs headed "(0.17.9)"; each entry links to it.
+
+### Added and changed
+
+- [Context menus stay inside the window](docs/components/menus.md#context-menus-stay-inside-the-window-0179): `showContextMenu(x, y, items, onAction)`, the DataTable's right-click menu and `NotebookTabBar`'s tab menu are placed the same way, however many items they hold. A menu is capped at the window's height less 8px above and below and scrolls inside when it is longer (flexdesk.css gives `.twm-context-menu` and `.nb-context-menu` `overflow-y: auto` and `box-sizing: border-box`); it opens with its top-left corner at the pointer and moves left or up only as far as it must to fit, never past the window's top or left edge. Before, a menu had no cap: the DataTable's opened above the window's top edge and `showContextMenu`'s ran off the bottom, so the items past the edge could not be reached. All three now take focus on the first enabled item, move it with Up/Down (wrapping), Home and End, scrolling the focused item into view, choose with Enter or Space, close with Escape and give focus back when they close (before, only `showContextMenu` did); scrolling the menu itself does not close it. Nothing changes in how you call them (BUG-0040).
+- [The plot config editor writes no stray "null"](docs/components/charts.md#the-plot-config-editor-writes-no-stray-null-0179): `renderPlotConfigEditor` appended the sections a subplot does not have as `null`, which `Element.append()` writes as the text `null`, so every 2D subplot showed a `null` line where a 3D chart's **Z axis** goes, and an editor without `seriesTransforms` showed another where **Derived series** goes. A section the subplot does not have is now left out; nothing else about the editor changed (BUG-0041).
+- [Interpolation `'auto'` is a listed choice](docs/components/charts.md#interpolation-auto-is-a-listed-choice-0179): a subplot's `interpolation` is `'linear'`, `'step'`, `'cubic'` or `'auto'`, and `'auto'` draws straight segments exactly as `'linear'` does (`buildTrace` gives both the Plotly line shape `linear`, as it always has). `renderPlotConfigEditor`'s **Interpolation** select now offers **Auto**, **Linear**, **Step** and **Cubic spline**, so a subplot saved with `'auto'` opens with Auto chosen instead of `auto (not found)` and keeps `'auto'` until another value is picked. A new subplot is still `'linear'`, and every value draws as before (BUG-0042).
+- [Action dropdowns: positioning against the end edge](docs/components/menus.md#action-dropdowns-positioning-against-the-end-edge-0179): `ActionDropdown.position(trigger, menu, { align })` takes an optional third argument. `align: 'start'` (the default, and what it did before) lines the menu up with the trigger's left edge first, `'end'` with its right edge; either flips to the other edge when the menu would leave the window (BUG-0043).
+- [A tile's ⋯ menu is drawn over the page](docs/components/tiles.md#the--menu-is-drawn-over-the-page-0179): a tile's **More actions** menu (`.tile-menu-dropdown`) is no longer drawn inside the tile. While it is open it is moved to `document.body` (or to the open modal's host, as `showContextMenu` does), placed with `ActionDropdown.position(button, menu, { align: 'end' })` as `position: fixed` on `--z-over-windows`, so neighbouring tiles and the managed window a grid sits in no longer clip it, and it stays 8px inside the window, opening under the button when it fits there, else above it when it fits there, else on the side with more room, scrolling inside. Choosing an entry, a press outside it or the ⋯ button again closes it and puts it back in the tile's header; `dispose()` closes an open menu first. Until 0.17.8 the menu was `position: absolute` inside the tile, so in a tile narrower than about 220px its left part and its labels were cut off (BUG-0043).
+
+### Removed or renamed exports
+
+None. Compared with 0.17.8, across every entry point (`core`, `widgets`, `wm`,
+`host`, `canvas`, `flow`, `charts`, `tiles`, `editor`) and the package
+`exports` map, no export was added, removed or renamed. Not an export but
+worth knowing: `ActionDropdown.position` takes an optional third argument,
+`{ align }`; `renderPlotConfigEditor` lists `'auto'` among the interpolations;
+an open tile ⋯ menu lives outside `tile.element` until it closes; and
+flexdesk.css caps `.twm-context-menu` and `.nb-context-menu` at the window's
+height with `overflow-y: auto`, and draws `.tile-menu-dropdown` on
+`--z-over-windows` (see above).
+
+## 0.17.8 (2026-10-24)
+
+A patch release: everything below is additive. Every fix is documented in a
+section of the docs headed "(0.17.8)"; each entry links to it.
+
+### Added and changed
+
+- [A series transform knows its series, and takes a choice parameter](docs/components/charts.md#a-series-transform-knows-its-series-and-takes-a-choice-parameter-0178): a `seriesTransforms` entry's `run` gets a third argument, `run(y, params, { series, subplot, results, resolveSeries })`: the subplot's series entry the trace was drawn from (null for any other trace, such as an overlay), the subplot config, the results the figure was drawn from and the `resolveSeries` it was drawn with, so a transform can resolve the same series from other results (a baseline scenario) the same way. `renderPlotGrid`, and so `PlotPopoutWindow`, run transforms on the same traces as in 0.17.7 and draw the same derived traces; `deriveSeriesTraces` takes the new optional `seriesOf`, `results` and `resolveSeries` options, and without them passes `series`, `results` and `resolveSeries` as null. A parameter declared `{ type: 'choice', options }` (an array of `{ value, label }`, or a function `(subplot) => options`) is drawn by `renderSeriesTransformControls` as a select (choice_controls' `selectBox`, styled by the new `.twm-series-transforms__select` rule) instead of a number field; the pick is saved under `subplot.transforms.<id>.params` and passed to `run` like a number, and without a `default` or a saved value it is the first enabled option. A transform written as `run(y, params)` with number parameters works and draws exactly as before (STORY-0111).
+
+### Removed or renamed exports
+
+None. Compared with 0.17.7, across every entry point (`core`, `widgets`, `wm`,
+`host`, `canvas`, `flow`, `charts`, `tiles`, `editor`) and the package
+`exports` map, no export was added, removed or renamed. Not an export but
+worth knowing: a series transform's `run` gets a third argument and
+`deriveSeriesTraces` takes three more options, all optional, and flexdesk.css
+gains a `.twm-series-transforms__select` rule (see above).
+
 ## 0.17.7 (2026-10-24)
 
 A patch release: everything below is additive. Every fix is documented in a

package/css/base.css

@@ -3434,11 +3434,14 @@ body.twm-window-maximized .twm-resize-handle {
     position: relative;
 }
 
+/* While open the menu is moved to document.body and placed `position: fixed`
+   by `ActionDropdown.position` (inline styles), so a narrow tile cannot clip
+   it; --z-over-windows keeps it over a managed window holding the grid. */
 .tile-menu-dropdown {
     position: absolute;
     top: 100%;
     right: 0;
-    z-index: var(--z-dropdown);
+    z-index: var(--z-over-windows);
     min-width: 180px;
     padding: var(--space-xs) 0;
     background: var(--surface-2);
@@ -5604,6 +5607,23 @@ button.twm-about-dialog__btn--close:focus {
 
 .nb-context-menu.visible { opacity: 1; }
 
+/* ── Context menus stay inside the window (0.17.9, BUG-0040) ─────────
+ * `showContextMenu`, the DataTable's right-click menu and NotebookTabBar's tab
+ * menu are placed by src/ui/utils/menu_viewport.js, which sets an inline
+ * max-height of the window's height less a margin top and bottom. Here: the
+ * same cap for a menu placed before that runs, border-box so the cap includes
+ * padding and border, and scrolling inside when the items are longer — they
+ * had no max-height and no overflow, so a 100-item menu ran off the window and
+ * its far items could not be reached. */
+.twm-context-menu,
+.nb-context-menu {
+    box-sizing: border-box;
+    max-height: calc(100vh - 2 * var(--space-md));
+    overflow-x: hidden;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+}
+
 .nb-context-menu__item {
     display: flex;
     align-items: center;

package/css/flexdesk.css

@@ -3959,11 +3959,14 @@ body.twm-window-maximized .twm-resize-handle {
     position: relative;
 }
 
+/* While open the menu is moved to document.body and placed `position: fixed`
+   by `ActionDropdown.position` (inline styles), so a narrow tile cannot clip
+   it; --z-over-windows keeps it over a managed window holding the grid. */
 .tile-menu-dropdown {
     position: absolute;
     top: 100%;
     right: 0;
-    z-index: var(--z-dropdown);
+    z-index: var(--z-over-windows);
     min-width: 180px;
     padding: var(--space-xs) 0;
     background: var(--surface-2);
@@ -7629,6 +7632,23 @@ body.twm-dragging * { user-select: none; }
     transition: opacity 90ms ease-out;
 }
 .nb-context-menu.visible { opacity: 1; }
+
+/* ── Context menus stay inside the window (0.17.9, BUG-0040) ─────────
+ * `showContextMenu`, the DataTable's right-click menu and NotebookTabBar's tab
+ * menu are placed by src/ui/utils/menu_viewport.js, which sets an inline
+ * max-height of the window's height less a margin top and bottom. Here: the
+ * same cap for a menu placed before that runs, border-box so the cap includes
+ * padding and border, and scrolling inside when the items are longer — they
+ * had no max-height and no overflow, so a 100-item menu ran off the window and
+ * its far items could not be reached. */
+.twm-context-menu,
+.nb-context-menu {
+    box-sizing: border-box;
+    max-height: calc(100vh - 2 * var(--space-md));
+    overflow-x: hidden;
+    overflow-y: auto;
+    overscroll-behavior: contain;
+}
 .nb-context-menu__item {
     display: flex;
     align-items: center;
@@ -10808,8 +10828,8 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
 /* ══ SERIES TRANSFORMS ═══════════════════════════════════════════════
  *
  * `renderSeriesTransformControls` (src/charts/series_transforms.js): per
- * injected transform, a group with a toggle per output and a number field per
- * parameter, in a subplot's config. */
+ * injected transform, a group with a toggle per output and a number field (or,
+ * for a choice parameter, a select) per parameter, in a subplot's config. */
 .twm-series-transforms {
     display: flex;
     flex-direction: column;
@@ -10849,6 +10869,13 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
 .twm-series-transforms__param:disabled {
     opacity: 0.5;
 }
+/* A choice parameter's select (0.17.8): as wide as its option labels. */
+.twm-series-transforms__select {
+    width: auto;
+    min-width: 96px;
+    max-width: 60%;
+    cursor: pointer;
+}
 /* ══ end SERIES TRANSFORMS ══ */
 
 /* ══ PLOT GRID ════════════════════════════════════════════════════════

package/dist/charts.js

@@ -1,6 +1,6 @@
 import {
   createTabs
-} from "./chunk-HYJYYEPK.js";
+} from "./chunk-REJ5HLIM.js";
 import {
   ALL_CHART_TYPES,
   CHART_TYPES_2D,
@@ -55,11 +55,11 @@ import {
   strideIndices,
   uid,
   updateChart
-} from "./chunk-RMTRWWEO.js";
+} from "./chunk-2YTM3GJE.js";
 import {
   AutocompleteField,
   createRafResizeObserver
-} from "./chunk-LWV23YVE.js";
+} from "./chunk-NIJEJAZ7.js";
 import {
   ColorField,
   ManagedWindow,
@@ -68,7 +68,7 @@ import {
 } from "./chunk-CVMCZZX2.js";
 import "./chunk-HNU6MM2B.js";
 import "./chunk-N7HC3ADV.js";
-import "./chunk-WVFGV5FT.js";
+import "./chunk-WUFLGETN.js";
 import "./chunk-JYWURG5T.js";
 
 // src/charts/data_series_plot_window.js
@@ -720,6 +720,7 @@ var LEGEND_POSITIONS2 = Object.freeze([
   { value: "right", label: "Right" }
 ]);
 var INTERPOLATIONS = Object.freeze([
+  { value: "auto", label: "Auto" },
   { value: "linear", label: "Linear" },
   { value: "step", label: "Step" },
   { value: "cubic", label: "Cubic spline" }
@@ -977,7 +978,7 @@ function renderPlotConfigEditor(container, config, options = {}) {
     const is3D = is3DChart(sp.chartType);
     let sources = null;
     const overlaySources = () => sources ??= Promise.resolve().then(() => opts.overlaySources());
-    body.append(
+    body.append(...[
       section("Subplot", field("Title", textInput(
         sp.displayName,
         (v) => {
@@ -993,7 +994,7 @@ function renderPlotConfigEditor(container, config, options = {}) {
       section("Reference lines", referenceLinesEditor(sp)),
       section("Shaded bands", shadedBandsEditor(sp)),
       transformsSection(sp)
-    );
+    ].filter(Boolean));
   }
   function displayFields(sp) {
     return [