flexdesk 0.17.6 → 0.17.8

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Changelog
 
+## 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
+section of the docs headed "(0.17.7)"; each entry links to it.
+
+### Added and changed
+
+- [`installOverlayScrollbar` is styled by flexdesk.css](docs/components/layout-widgets.md#installoverlayscrollbar-is-styled-by-flexdeskcss-0177): the `.overlay-scrollbar-v` and `.overlay-scrollbar-h` bars that `installOverlayScrollbar` (and `installCollapsibleScrollbars`, `installTabsScrollbars` and `installWorkspaceScrollbars`, which build on it) appends now have rules in flexdesk.css, so they work with only FlexDesk's stylesheets loaded. The bar is `position: absolute` at the container's right or bottom edge, `--scrollbar-size` thick, on `--z-scrollbar`; it starts at `opacity: 0` and shows on hover while the container overflows; it takes no pointer events except on its thumb, which is at least 30px long. Its colours and rounding are the new tokens `--scrollbar-track`, `--scrollbar-thumb`, `--scrollbar-thumb-hover`, `--scrollbar-thumb-active` and `--scrollbar-radius` in tokens.css. Until now no FlexDesk stylesheet styled these classes, so the bar was `position: static`, fed the container's content height and grew it without limit unless the embedder brought its own CSS (BUG-0039).
+
+### Removed or renamed exports
+
+None. Compared with 0.17.6, 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: tokens.css gains the `--scrollbar-*` and `--z-scrollbar`
+custom properties, and flexdesk.css gains rules for `.overlay-scrollbar-v`,
+`.overlay-scrollbar-h` and their `.track` and `.thumb` (see above).
+
 ## 0.17.6 (2026-10-24)
 
 A patch release: everything below is additive. Every fix is documented in a

package/css/base.css

@@ -5969,6 +5969,74 @@ button.twm-about-dialog__btn--close:focus {
 }
 
 
+/* ══ OVERLAY SCROLLBARS (0.17.7) ═════════════════════════════════════
+ *
+ * `installOverlayScrollbar(container, { orientation })`
+ * (src/ui/utils/overlay_scrollbar.js) appends a `.overlay-scrollbar-v` or
+ * `.overlay-scrollbar-h` holding a `.track` and a `.thumb`, and sets their
+ * top/left/height/width from the container's scroll position. The bar is
+ * absolute, so it takes no layout space: a static bar is content, its height
+ * feeds the container's scrollHeight, and the container grows without limit
+ * (BUG-0039). The script sets `data-scrollable` on the container and drives
+ * the bar's opacity and pointer events itself (shown on hover or focus while
+ * the container overflows, kept while the thumb is dragged); these rules are
+ * the hidden starting state, the geometry and the colours. The bar takes no
+ * pointer events, so content under it stays clickable; the thumb takes them
+ * back to be dragged. */
+.overlay-scrollbar-v,
+.overlay-scrollbar-h {
+    position: absolute;
+    pointer-events: none;
+    opacity: 0;
+    transition: opacity var(--transition-fast);
+    z-index: var(--z-scrollbar);
+}
+.overlay-scrollbar-v {
+    top: 0;
+    right: 0;
+    width: var(--scrollbar-size);
+}
+.overlay-scrollbar-h {
+    left: 0;
+    bottom: 0;
+    height: var(--scrollbar-size);
+}
+.overlay-scrollbar-v .track,
+.overlay-scrollbar-h .track {
+    position: absolute;
+    inset: 0;
+    background: var(--scrollbar-track);
+    border-radius: var(--scrollbar-radius);
+}
+.overlay-scrollbar-v .thumb,
+.overlay-scrollbar-h .thumb {
+    position: absolute;
+    background: var(--scrollbar-thumb);
+    border-radius: var(--scrollbar-radius);
+    pointer-events: auto;
+    cursor: pointer;
+    transition: background 80ms ease;
+}
+.overlay-scrollbar-v .thumb {
+    right: 0;
+    width: 100%;
+    min-height: 30px;
+}
+.overlay-scrollbar-h .thumb {
+    bottom: 0;
+    height: 100%;
+    min-width: 30px;
+}
+.overlay-scrollbar-v .thumb:hover,
+.overlay-scrollbar-h .thumb:hover {
+    background: var(--scrollbar-thumb-hover);
+}
+.overlay-scrollbar-v .thumb:active,
+.overlay-scrollbar-h .thumb:active {
+    background: var(--scrollbar-thumb-active);
+}
+
+
 /* ══ RECORD LIST & FACT SHEET (0.7.0) ══════════════════════════════════
  * `createRecordList` (src/ui/components/record_list.js) and
  * `createFactTable` (src/ui/components/fact_table.js). Neither has a height

package/css/flexdesk.css

@@ -9593,6 +9593,74 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
 }
 
 
+/* ══ OVERLAY SCROLLBARS (0.17.7) ═════════════════════════════════════
+ *
+ * `installOverlayScrollbar(container, { orientation })`
+ * (src/ui/utils/overlay_scrollbar.js) appends a `.overlay-scrollbar-v` or
+ * `.overlay-scrollbar-h` holding a `.track` and a `.thumb`, and sets their
+ * top/left/height/width from the container's scroll position. The bar is
+ * absolute, so it takes no layout space: a static bar is content, its height
+ * feeds the container's scrollHeight, and the container grows without limit
+ * (BUG-0039). The script sets `data-scrollable` on the container and drives
+ * the bar's opacity and pointer events itself (shown on hover or focus while
+ * the container overflows, kept while the thumb is dragged); these rules are
+ * the hidden starting state, the geometry and the colours. The bar takes no
+ * pointer events, so content under it stays clickable; the thumb takes them
+ * back to be dragged. */
+.overlay-scrollbar-v,
+.overlay-scrollbar-h {
+    position: absolute;
+    pointer-events: none;
+    opacity: 0;
+    transition: opacity var(--transition-fast);
+    z-index: var(--z-scrollbar);
+}
+.overlay-scrollbar-v {
+    top: 0;
+    right: 0;
+    width: var(--scrollbar-size);
+}
+.overlay-scrollbar-h {
+    left: 0;
+    bottom: 0;
+    height: var(--scrollbar-size);
+}
+.overlay-scrollbar-v .track,
+.overlay-scrollbar-h .track {
+    position: absolute;
+    inset: 0;
+    background: var(--scrollbar-track);
+    border-radius: var(--scrollbar-radius);
+}
+.overlay-scrollbar-v .thumb,
+.overlay-scrollbar-h .thumb {
+    position: absolute;
+    background: var(--scrollbar-thumb);
+    border-radius: var(--scrollbar-radius);
+    pointer-events: auto;
+    cursor: pointer;
+    transition: background 80ms ease;
+}
+.overlay-scrollbar-v .thumb {
+    right: 0;
+    width: 100%;
+    min-height: 30px;
+}
+.overlay-scrollbar-h .thumb {
+    bottom: 0;
+    height: 100%;
+    min-width: 30px;
+}
+.overlay-scrollbar-v .thumb:hover,
+.overlay-scrollbar-h .thumb:hover {
+    background: var(--scrollbar-thumb-hover);
+}
+.overlay-scrollbar-v .thumb:active,
+.overlay-scrollbar-h .thumb:active {
+    background: var(--scrollbar-thumb-active);
+}
+
+
 /* ══ RECORD LIST & FACT SHEET (0.7.0) ══════════════════════════════════
  * `createRecordList` (src/ui/components/record_list.js) and
  * `createFactTable` (src/ui/components/fact_table.js). Neither has a height
@@ -10740,8 +10808,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;
@@ -10781,6 +10849,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/css/tokens.css

@@ -102,6 +102,14 @@
     --state-active:   rgba(255, 255, 255, 0.08);
     --state-selected: rgba(0, 122, 204, 0.15);
 
+    /* ── Overlay scrollbars (installOverlayScrollbar) ─────────── */
+    --scrollbar-size:         6px;
+    --scrollbar-radius:       3px;
+    --scrollbar-track:        rgba(255, 255, 255, 0.08);
+    --scrollbar-thumb:        rgba(255, 255, 255, 0.28);
+    --scrollbar-thumb-hover:  rgba(255, 255, 255, 0.38);
+    --scrollbar-thumb-active: rgba(255, 255, 255, 0.48);
+
     /* ── Shadows / elevation ──────────────────────────────────── */
     --shadow-sm:   0 1px 3px rgba(0, 0, 0, 0.3);
     --shadow-md:   0 4px 12px rgba(0, 0, 0, 0.4);
@@ -119,6 +127,9 @@
        stack from 6000 to 6999 (managed_window.js), so a popover at
        --z-popover would open behind the window that opened it. */
     --z-over-windows: 7100;
+    /* An overlay scrollbar inside a scroll container: over the container's
+       content and its dropdowns, under managed windows (6000+). */
+    --z-scrollbar: 500;
 
     /* ── Transitions ──────────────────────────────────────────── */
     --transition-fast:   120ms ease;

package/dist/charts.js

@@ -55,7 +55,7 @@ import {
   strideIndices,
   uid,
   updateChart
-} from "./chunk-RMTRWWEO.js";
+} from "./chunk-EIYNF4BD.js";
 import {
   AutocompleteField,
   createRafResizeObserver

package/dist/{chunk-RMTRWWEO.js → chunk-EIYNF4BD.js}

@@ -3,7 +3,9 @@ import {
   createRafResizeObserver
 } from "./chunk-LWV23YVE.js";
 import {
-  ManagedWindow
+  ManagedWindow,
+  flatChoices,
+  selectBox
 } from "./chunk-CVMCZZX2.js";
 
 // src/charts/plotly_wrapper.js
@@ -1177,12 +1179,25 @@ function migrateSingleChart(data) {
 }
 
 // src/charts/series_transforms.js
-function resolveParams(transform, state) {
+var isChoice = (spec) => spec?.type === "choice";
+function choiceOptions(spec, subplot) {
+  const options = typeof spec.options === "function" ? spec.options(subplot) : spec.options;
+  return Array.isArray(options) ? options : [];
+}
+function firstChoice(spec, subplot) {
+  const flat = flatChoices(choiceOptions(spec, subplot));
+  return (flat.find((o) => !o.disabled) ?? flat[0])?.value;
+}
+function resolveParams(transform, state, subplot) {
+  const saved = state?.params ?? {};
   const params = {};
   for (const [name, spec] of Object.entries(transform.params ?? {})) {
     params[name] = spec?.default;
+    if (isChoice(spec) && spec.default === void 0 && saved[name] === void 0) {
+      params[name] = firstChoice(spec, subplot);
+    }
   }
-  return { ...params, ...state?.params ?? {} };
+  return { ...params, ...saved };
 }
 function enabledOutputs(transform, state) {
   return Object.keys(transform.outputs ?? {}).filter((name) => state?.outputs?.[name] === true);
@@ -1191,19 +1206,20 @@ function isEligible(trace) {
   const type = trace.type ?? "scatter";
   return (type === "scatter" || type === "scattergl") && Array.isArray(trace.y);
 }
-async function deriveSeriesTraces(traces, subplot, seriesTransforms, { onError } = {}) {
+async function deriveSeriesTraces(traces, subplot, seriesTransforms, { onError, seriesOf, results, resolveSeries } = {}) {
   const derived = [];
   if (!seriesTransforms) return derived;
-  const sources = traces.filter(isEligible);
+  const sources = traces.filter(isEligible).map((trace) => ({ trace, series: typeof seriesOf === "function" ? seriesOf(trace) ?? null : null }));
   for (const [transformId, transform] of Object.entries(seriesTransforms)) {
     const state = subplot?.transforms?.[transformId];
     const outputs = enabledOutputs(transform, state);
     if (!outputs.length || typeof transform?.run !== "function") continue;
-    const params = resolveParams(transform, state);
-    for (const source of sources) {
+    const params = resolveParams(transform, state, subplot);
+    for (const { trace: source, series } of sources) {
+      const context = { series, subplot, results: results ?? null, resolveSeries: resolveSeries ?? null };
       let result;
       try {
-        result = await transform.run(source.y, params);
+        result = await transform.run(source.y, params, context);
       } catch (error) {
         onError?.({ transformId, traceName: source.name, error });
         continue;
@@ -1284,22 +1300,43 @@ function renderSeriesTransformControls(container, subplot, seriesTransforms, { o
       row.className = "twm-series-transforms__row";
       const text = document.createElement("span");
       text.textContent = spec?.label ?? name;
+      const writeParam = (value) => {
+        const state = stateOf(transformId);
+        const params = { ...state.params ?? {} };
+        if (value === void 0) delete params[name];
+        else params[name] = value;
+        state.params = params;
+        onChange?.();
+      };
+      const saved = subplot.transforms?.[transformId]?.params?.[name];
+      if (isChoice(spec)) {
+        const current2 = saved ?? spec.default ?? firstChoice(spec, subplot);
+        const choice = selectBox(choiceOptions(spec, subplot), current2, {
+          label: spec?.label ?? name,
+          valueAttr: "value",
+          className: "twm-series-transforms__param twm-series-transforms__select"
+        });
+        choice.box.addEventListener("change", () => {
+          const value = choice.valueOf();
+          choice.setOptions(choiceOptions(spec, subplot), value);
+          writeParam(value);
+        });
+        paramInputs.push(choice.box);
+        row.append(text, choice.box);
+        group.appendChild(row);
+        continue;
+      }
       const input = document.createElement("input");
       input.type = "number";
       input.className = "twm-series-transforms__param";
       for (const attr of ["min", "max", "step"]) {
         if (spec?.[attr] != null) input[attr] = String(spec[attr]);
       }
-      const current = subplot.transforms?.[transformId]?.params?.[name] ?? spec?.default;
+      const current = saved ?? spec?.default;
       input.value = current == null ? "" : String(current);
       input.addEventListener("change", () => {
         const value = parseFloat(input.value);
-        const state = stateOf(transformId);
-        const params = { ...state.params ?? {} };
-        if (Number.isFinite(value)) params[name] = value;
-        else delete params[name];
-        state.params = params;
-        onChange?.();
+        writeParam(Number.isFinite(value) ? value : void 0);
       });
       paramInputs.push(input);
       row.append(text, input);
@@ -1427,6 +1464,7 @@ function renderPlotGrid(container, plotConfig, results, options = {}) {
     const yRefByAxisId = {};
     let ownCount = 0;
     let hiddenCount = 0;
+    const seriesByTrace = /* @__PURE__ */ new Map();
     const useX = sp.xAxis && sp.xAxis.useTime === false && sp.xAxis.variable;
     const xData = useX ? opts.resolveSeries({ variable: sp.xAxis.variable }, data, sp)?.y ?? time : time;
     const yAxes = sp.yAxes ?? [];
@@ -1461,7 +1499,7 @@ function renderPlotGrid(container, plotConfig, results, options = {}) {
         if (!resolved?.y) continue;
         const x = resolved.x ?? xData;
         const y = Array.isArray(resolved.y) ? applyNanHandling(resolved.y, sp.nanHandling ?? "gap", x) : resolved.y;
-        traces.push(buildTrace({
+        const trace = buildTrace({
           chartType: sp.chartType || "line",
           x,
           y,
@@ -1473,7 +1511,9 @@ function renderPlotGrid(container, plotConfig, results, options = {}) {
           yAxisId: yRef,
           showMarkers: sp.showDataPoints ?? false,
           stackGroup: s.stackGroup ?? null
-        }));
+        });
+        traces.push(trace);
+        seriesByTrace.set(trace, s);
         const overlay = s.overlay ? opts.overlays?.[s.id] : null;
         if (!overlay?.years?.length) continue;
         const ov = s.overlay;
@@ -1503,12 +1543,12 @@ function renderPlotGrid(container, plotConfig, results, options = {}) {
         traces.push(ovTrace);
       }
     });
-    traces.push(...await deriveSeriesTraces(
-      traces,
-      sp,
-      opts.seriesTransforms,
-      { onError: opts.onTransformError ?? void 0 }
-    ));
+    traces.push(...await deriveSeriesTraces(traces, sp, opts.seriesTransforms, {
+      onError: opts.onTransformError ?? void 0,
+      seriesOf: (trace) => seriesByTrace.get(trace) ?? null,
+      results: data,
+      resolveSeries: opts.resolveSeries
+    }));
     if (opts.derivedTraces) {
       const extra = await opts.derivedTraces(traces, sp, { results: data, index });
       if (Array.isArray(extra)) traces.push(...extra);
@@ -1667,7 +1707,8 @@ var PlotPopoutWindow = class {
    *        renders the Config tab. What it returns is disposed (`dispose()`) when the
    *        window closes, so an editor drawn there (renderPlotConfigEditor) goes with it.
    * @param {Object} [options.seriesTransforms] - `{ [id]: transform }` (series_transforms.js);
-   *        absent => no derived series are drawn
+   *        absent => no derived series are drawn. Each runs as
+   *        `run(y, params, { series, subplot, results, resolveSeries })` (renderPlotGrid).
    * @param {string} [options.refreshEvent='data:changed'] - Bus event after which the
    *        window re-reads `getResults()` and redraws.
    * @param {{delta?: string|null, complete?: string|null}} [options.streamEvents] - Bus
@@ -2799,4 +2840,4 @@ export {
   openPlotPopoutWindow,
   openRawTracesWindow
 };
-//# sourceMappingURL=chunk-RMTRWWEO.js.map
+//# sourceMappingURL=chunk-EIYNF4BD.js.map