flexdesk 0.17.7 → 0.17.8

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # 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

package/css/flexdesk.css

@@ -10808,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;
@@ -10849,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/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