flexdesk 0.18.0 → 0.18.2

package/CHANGELOG.md

@@ -1,5 +1,63 @@
 # Changelog
 
+## 0.18.2 (2026-11-07)
+
+A patch release with one addition.
+
+### Added
+
+- [A flat settings panel: `variant: 'sheet'` on `createSettingsPanel`](docs/components/flow-editors.md#a-flat-panel-variant-sheet-0182): no fill, the title and description in a margin at the left, the fields beside them, a rule between two sheets. For a settings page made of several panels.
+
+### Changed behaviour
+
+None. A panel created without `variant` is the card it was.
+
+### Fixed
+
+- A settings panel's checkbox (a `boolean` setting) sits at the start of its field, under the label's line; it was drawn in the middle of the field's width.
+
+### Removed or renamed exports
+
+None. New: the `variant` option. Classes: `.twm-flow-panel--sheet`, `.twm-flow-panel__sheet`, `.twm-flow-panel__margin`, `.twm-flow-panel__body`.
+
+## 0.18.1 (2026-11-06)
+
+A patch release: what four applications asked for when they adopted 0.18.0. The
+entries under "Changed behaviour" change what embedders see; the workspace picker's
+keyboard is the one to read first.
+
+### Added
+
+- [`hide` on `renderPlotConfigEditor`](docs/components/charts.md#hiding-parts-of-the-editor-hide-0181): takes away the 3D chart types with the z axis, the stack group and the x axis section (STORY-0109).
+- [A reference line that names a constant](docs/components/charts.md#a-reference-line-that-names-a-constant-constantsprovider-resolveconstant-0181): `constantsProvider` on `renderPlotConfigEditor`, `resolveConstant` on `renderPlotGrid` (STORY-0109).
+- [`dismissOnBackdrop` on `openModal`](docs/components/forms-and-dialogs.md#a-click-beside-a-modal-dismissonbackdrop-0181) and [on `openFilterDialog`](docs/components/filter-builder.md#a-click-beside-the-dialog-dismissonbackdrop-0181): a click on the dimmed page beside it dismisses it, through `beforeClose`. The press takes no focus from the dialog, so when `beforeClose` refuses, the caret is where it was.
+- [`confirm.message` as a function](docs/components/filter-builder.md#a-question-that-quotes-what-was-typed-0181) on `openFilterDialog`'s `actions`, computed when it is asked.
+- [`groupBrackets` on `describeFilter`](docs/components/filter-builder.md#what-a-sentence-says-0181); [`model.partialRanges`](docs/components/filter-builder.md#a-range-with-one-end-filled-is-refused-0181) and [`model.moveClause`](docs/components/filter-builder.md#what-a-condition-keeps-when-its-field-changes-0181).
+- [Tokens for the picker field's look](docs/components/workspace-picker.md#the-fields-look-tokens-0181), and [a trigger of your own on `createPickerSwitcher`](docs/components/workspace-picker.md#a-trigger-of-your-own-0181), written down and tested.
+- `attachInlineRenamer`'s `onStart` is handed the input: [`{ value, triggerEvent, input }`](docs/components/input-fields.md#a-list-under-a-name-being-edited-attachinlinerenamer-0181).
+
+### Changed behaviour
+
+- **[The workspace picker's keyboard moves real focus](docs/components/workspace-picker.md#the-keyboard-0181).** It used to keep the caret in the input and walk a highlight, so the card's and the footer's buttons were never announced. The arrows now move `document.activeElement` over every stop, the input among them; the rows are one tab stop; a character typed anywhere in the panel goes to the input. **The first ArrowDown from the input lands on the first row, not the second**, so a sequence of arrows reaches one stop later than before: `ArrowDown, Enter` takes the first row. The first ArrowUp lands on the last stop, the footer's last button if there is one. After `open({ select })` the arrows go on from the row it chose, as they did. A test dispatching keys on the input keeps working, one arrow longer. An answer that moves the row with focus leaves focus on it. Load more is `aria-disabled` while something loads, not `disabled`, so it keeps focus and refuses the press itself: a test reading `.disabled` reads the attribute. Enter in the input, Esc, a press outside and Shift+Delete do as they did, and Shift+Delete also works on a focused row.
+- **[Stop releases a turn that is waiting](docs/components/chat-shell.md#stop-releases-a-turn-that-is-waiting-0181).** A cancel promise that never settles, or a lost run-over, no longer hangs later sends: stopping the waiting turn sends the next one at once. A backend without a lock can then see two runs overlap; one that takes one run at a time should refuse the second.
+- **[Keyboard focus shows a tooltip](docs/components/shell.md#keyboard-focus-shows-a-tooltip-0181)**: `TooltipService` listens to `focusin` and `focusout` as well as the mouse. Keyboard focus means the last press was a key, not a Ctrl, Cmd or Alt chord, so the focus a click leaves shows nothing, nor does a text field its handler then focuses. While focus holds a tooltip a scroll does not hide it, the one the focus itself caused included: it goes with its target, and waits while the target is out of sight. A pointer does not take it down: over another target the pointer's tooltip shows for as long as the pointer stays, then focus's comes back. A consumer's own wiring of the same can go.
+- **[A press inside no longer disarms a context menu](docs/components/menus.md#a-press-inside-no-longer-disarms-a-context-menu-0181).** `showContextMenu`'s outside-press listener lasts until the menu closes.
+- **[`attachInlineRenamer` runs `onStart` before adding its own key listeners](docs/components/input-fields.md#a-list-under-a-name-being-edited-attachinlinerenamer-0181)**, so what it attaches hears a key first and Enter on a highlighted row commits the row. Taking its field off the page no longer fires a second commit through blur after a commit or an Esc, so a consumer's guard against that can go.
+- **[`openFilterDialog` refuses a range with one end filled](docs/components/filter-builder.md#a-range-with-one-end-filled-is-refused-0181)**, whatever `requireValid` and `prune` say. Such a filter used to leave the dialog and match nothing.
+- **[A seed goes beside a negated root](docs/components/filter-builder.md#a-seed-beside-a-negated-root-0181)**, not inside it, where it undid the filter.
+- **[Changing a condition's field keeps its operator and value](docs/components/filter-builder.md#what-a-condition-keeps-when-its-field-changes-0181)** when the new field offers the one and the other still fits. It used to start over, and `prune` then dropped the row.
+- **[`validateFilter` checks every value of a `multi` operator](docs/components/filter-builder.md#what-a-condition-keeps-when-its-field-changes-0181)** as it does a single one: `one_of ['abc']` on a number field, or `one_of ['soon']` on a date field whose `operators` offer `one_of`, is an error. It used to pass, and a server's type check was the first to refuse it.
+- **[A held condition under an operator its field does not offer shows its value read-only](docs/components/filter-builder.md#what-a-condition-keeps-when-its-field-changes-0181)**, where a box looked empty over a value the result still carried, and a custom `editor` is not asked about one. Its operator select reads as the catalogue's label on an unknown field too: `is`, not `is (unknown)`. An unknown field's whole warning is the select's tooltip.
+- **[`describeFilter` says more](docs/components/filter-builder.md#what-a-sentence-says-0181)**: every value of a list under a single-value operator, and an unknown field's operator and value (`⚠ unknown field “gone” is x`). A consumer's test on the old sentence sees the difference.
+- [The filter dialog's name box opens with its text selected](docs/components/filter-builder.md#the-name-box-opens-selected-0181), and a days box has `min="0"`.
+- [`openModal` leaves focus where `onMount` put it](docs/components/forms-and-dialogs.md#focus-placed-by-onmount-stays-0181), with its selection, rather than moving it to the first field.
+- `mountChatShell`'s model button has `aria-expanded`, so its open state is announced.
+- `activeConversation()` [answers an id](docs/components/chat-shell.md#conversations), as it always did; the docs read as if it answered a conversation.
+
+### Removed or renamed exports
+
+None. New: the `hide` and `constantsProvider` options, the `resolveConstant` option, `dismissOnBackdrop`, `groupBrackets`, `model.partialRanges`, `model.moveClause`. Custom properties in `tokens.css`: `--twm-wspicker-field-icon`, `--twm-wspicker-field-focus-border`, `--twm-wspicker-field-muted-icon`, `--twm-wspicker-field-muted-style`, `--twm-wspicker-field-muted-opacity`. Classes: `.twm-filter-builder__select--unknown`, `.twm-plot-config__constant`, `.twm-plot-config__constant-value`.
+
 ## 0.18.0 (2026-11-05)
 
 A minor release. A new entry point, `@flexdesk/git`, and six new components for

package/css/flexdesk.css

@@ -4899,14 +4899,14 @@ body.twm-window-maximized .twm-resize-handle {
 .twm-wspicker-field--open {
     outline: none;
     background: var(--state-active);
-    border-color: var(--accent-bright);
+    border-color: var(--twm-wspicker-field-focus-border);
 }
 .twm-wspicker-field [hidden] {
     display: none;
 }
 .twm-wspicker-field__icon.material-symbols-outlined {
     flex: none;
-    color: var(--accent-bright);
+    color: var(--twm-wspicker-field-icon);
     font-size: 15px;
     opacity: 0.85;
 }
@@ -4921,11 +4921,11 @@ body.twm-window-maximized .twm-resize-handle {
     white-space: nowrap;
 }
 .twm-wspicker-field--muted .twm-wspicker-field__name {
-    font-style: italic;
-    opacity: 0.55;
+    font-style: var(--twm-wspicker-field-muted-style);
+    opacity: var(--twm-wspicker-field-muted-opacity);
 }
 .twm-wspicker-field--muted .twm-wspicker-field__icon.material-symbols-outlined {
-    color: var(--text-muted);
+    color: var(--twm-wspicker-field-muted-icon);
 }
 .twm-wspicker-field__key {
     flex: none;
@@ -5063,6 +5063,10 @@ body.twm-window-maximized .twm-resize-handle {
     background: var(--state-selected);
     color: var(--text-bright);
 }
+/* A row with focus wears the highlight; no ring as well. */
+.twm-wspicker__row:focus {
+    outline: none;
+}
 .twm-wspicker__row--disabled {
     color: var(--text-dim);
     cursor: default;
@@ -5143,6 +5147,10 @@ body.twm-window-maximized .twm-resize-handle {
     width: calc(100% - 2 * var(--space-md));
     margin: var(--space-xs) var(--space-md);
 }
+.twm-wspicker__more[aria-disabled="true"] {
+    opacity: 0.4;
+    cursor: not-allowed;
+}
 .twm-wspicker__more-label {
     min-width: 0;
     overflow: hidden;
@@ -5392,6 +5400,9 @@ body.twm-window-maximized .twm-resize-handle {
 .twm-filter-builder__select--field {
     flex: 0 1 140px;
 }
+.twm-filter-builder__select--unknown {
+    flex: 0 1 auto;
+}
 .twm-filter-builder__select--op {
     flex: 0 1 120px;
 }
@@ -12372,6 +12383,23 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
 .twm-plot-config__row > .twm-plot-config__input--select {
     flex: 0 1 auto;
 }
+/* A reference line's value that may name a constant, and what the name is now. */
+.twm-plot-config__constant {
+    display: inline-flex;
+    flex: 1 1 140px;
+    align-items: center;
+    gap: var(--space-xs);
+    min-width: 0;
+}
+.twm-plot-config__constant > .twm-plot-config__input {
+    flex: 1 1 auto;
+    min-width: 0;
+}
+.twm-plot-config__constant-value {
+    flex: none;
+    color: var(--text-muted);
+    font-size: var(--font-size-xs);
+}
 /* On a field line a colour is the swatch and a hex box sized to `#rrggbb`. */
 .twm-plot-config__field > .twm-color-field {
     flex: 0 1 auto;
@@ -13614,6 +13642,55 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
     color: var(--twm-flow-warning-text);
 }
 
+/* ── the settings panel as a sheet (variant: 'sheet', 0.18.2) ──────────
+ * Flat: no fill and no chip. The title and the description sit in a margin at
+ * the left, the fields beside them; two sheets in a row are split by a rule, so
+ * a page of them reads as one form in sections. Narrower than 560px, the margin
+ * goes above the fields. */
+.twm-flow-panel--sheet {
+    container-type: inline-size;
+    gap: 0;
+    padding: 14px 0;
+    background: transparent;
+}
+.twm-flow-panel--sheet + .twm-flow-panel--sheet {
+    border-top: 1px solid var(--border-subtle);
+}
+.twm-flow-panel__sheet {
+    display: grid;
+    grid-template-columns: minmax(120px, 180px) minmax(0, 1fr);
+    gap: 10px 28px;
+    align-items: start;
+}
+.twm-flow-panel__margin {
+    display: flex;
+    flex-direction: column;
+    gap: 4px;
+    min-width: 0;
+    padding-top: 5px;
+}
+.twm-flow-panel__body {
+    display: flex;
+    flex-direction: column;
+    gap: 12px;
+    min-width: 0;
+}
+.twm-flow-panel--sheet .twm-flow-panel__icon { display: none; }
+.twm-flow-panel--sheet .twm-flow-panel__titles { flex-basis: auto; }
+.twm-flow-panel--sheet .twm-flow-panel__title,
+.twm-flow-panel--sheet .twm-flow-panel__title-input {
+    font-size: var(--font-size-md);
+}
+.twm-flow-panel--sheet .twm-flow-panel__description {
+    font-size: var(--font-size-xs);
+    color: var(--twm-flow-muted);
+}
+.twm-flow-panel--sheet .twm-flow-panel__fields { gap: 10px; }
+.twm-flow-panel--sheet .twm-flow-field__label { flex-basis: 110px; }
+@container (max-width: 560px) {
+    .twm-flow-panel__sheet { grid-template-columns: minmax(0, 1fr); }
+}
+
 /* ── a field: its label, its control, its finding, its help ─────────── */
 .twm-flow-field {
     display: flex;
@@ -13759,6 +13836,7 @@ button.twm-alerts__ref:hover { text-decoration: underline; }
     resize: vertical;
 }
 .twm-flow-checkbox {
+    align-self: flex-start;
     margin: 6px 0 0;
     accent-color: var(--twm-flow-focus);
 }

package/css/tokens.css

@@ -138,6 +138,13 @@
     --twm-rail-icon:    #9e9e9e;              /* an item at rest */
     --twm-rail-icon-on: var(--text-bright);   /* hovered, and the active item with its bar */
 
+    /* The workspace picker's field (0.18.1). */
+    --twm-wspicker-field-icon:           var(--accent-bright);
+    --twm-wspicker-field-focus-border:   var(--accent-bright);   /* focused by keyboard, and open */
+    --twm-wspicker-field-muted-icon:     var(--text-muted);      /* naming nothing */
+    --twm-wspicker-field-muted-style:    italic;
+    --twm-wspicker-field-muted-opacity:  0.55;
+
     /* ── Overlay scrollbars (installOverlayScrollbar) ─────────── */
     --scrollbar-size:         6px;
     --scrollbar-radius:       3px;

package/dist/charts.js

@@ -55,17 +55,18 @@ import {
   strideIndices,
   uid,
   updateChart
-} from "./chunk-P74F6I6P.js";
+} from "./chunk-4X4SY3CP.js";
 import {
   AutocompleteField,
   createRafResizeObserver
-} from "./chunk-U5GKJUOC.js";
+} from "./chunk-QRBOIUU3.js";
 import "./chunk-VLOAI3HS.js";
 import {
   ColorField,
   ManagedWindow,
-  ToggleField
-} from "./chunk-ZL3VKINP.js";
+  ToggleField,
+  attachInputOptions
+} from "./chunk-HL3IIHU3.js";
 import {
   selectBox
 } from "./chunk-Q7BALEPX.js";
@@ -709,6 +710,7 @@ var CHART_TYPE_OPTIONS = Object.freeze([
   { group: "2D", options: CHART_TYPES_2D },
   { group: "3D", options: CHART_TYPES_3D }
 ]);
+var HIDEABLE = Object.freeze(["3d", "stackGroup", "xAxis"]);
 var SCALES = Object.freeze([{ value: "linear", label: "Linear" }, { value: "log", label: "Log" }]);
 var POSITIONS = Object.freeze([{ value: "left", label: "Left" }, { value: "right", label: "Right" }]);
 var DASHES = Object.freeze([
@@ -829,9 +831,15 @@ function renderPlotConfigEditor(container, config, options = {}) {
     overlaySources: null,
     seriesTransforms: null,
     extraSeriesFields: null,
+    hide: [],
+    constantsProvider: null,
     logger: null,
     ...options
   };
+  for (const part of opts.hide) {
+    if (!HIDEABLE.includes(part)) throw new TypeError(`[plot config editor] cannot hide "${part}"`);
+  }
+  const hidden = new Set(opts.hide);
   const editorId = `twm-plot-config-${++editorCount}`;
   let fieldCount = 0;
   let active = 0;
@@ -985,6 +993,7 @@ function renderPlotConfigEditor(container, config, options = {}) {
   }
   function normalise(sp) {
     if (!sp.xAxis) sp.xAxis = { useTime: true, variable: "" };
+    if (hidden.has("xAxis")) sp.xAxis.useTime = true;
     if (!Array.isArray(sp.yAxes) || !sp.yAxes.length) sp.yAxes = [makeDefaultYAxis(0)];
     for (const axis of sp.yAxes) if (!Array.isArray(axis.series)) axis.series = [];
     if (is3DChart(sp.chartType) && !sp.zAxis) sp.zAxis = makeZAxis();
@@ -1009,9 +1018,9 @@ function renderPlotConfigEditor(container, config, options = {}) {
         { placeholder: "Untitled" }
       ))),
       section("Display", ...displayFields(sp)),
-      section("X axis", ...xAxisFields(sp)),
+      hidden.has("xAxis") ? null : section("X axis", ...xAxisFields(sp)),
       section("Y axes", yAxesEditor(sp, is3D, overlaySources)),
-      is3D ? section("Z axis", ...zAxisFields(sp)) : null,
+      is3D && !hidden.has("3d") ? section("Z axis", ...zAxisFields(sp)) : null,
       section("Reference lines", referenceLinesEditor(sp)),
       section("Shaded bands", shadedBandsEditor(sp)),
       transformsSection(sp)
@@ -1019,7 +1028,7 @@ function renderPlotConfigEditor(container, config, options = {}) {
   }
   function displayFields(sp) {
     return [
-      field("Chart type", select(CHART_TYPE_OPTIONS, sp.chartType ?? "line", (v) => {
+      field("Chart type", select(hidden.has("3d") ? CHART_TYPES_2D : CHART_TYPE_OPTIONS, sp.chartType ?? "line", (v) => {
         const was3D = is3DChart(sp.chartType);
         sp.chartType = v;
         const now3D = is3DChart(v);
@@ -1206,16 +1215,18 @@ function renderPlotConfigEditor(container, config, options = {}) {
       field("Dash", select(DASHES, s.lineStyle ?? "solid", (v) => {
         s.lineStyle = v;
         notify();
-      }, { label: "Dash" })),
-      field("Stack group", textInput(
+      }, { label: "Dash" }))
+    );
+    if (!hidden.has("stackGroup")) {
+      fields.appendChild(field("Stack group", textInput(
         s.stackGroup,
         (v) => {
           s.stackGroup = v || null;
           notify();
         },
         { placeholder: "None", label: "Stack group" }
-      ))
-    );
+      )));
+    }
     if (opts.extraSeriesFields) fields.appendChild(extraFields(sp, axis, s));
     if (opts.overlaySources) fields.appendChild(overlayEditor(s, overlaySources));
     row.append(head, fields);
@@ -1333,6 +1344,61 @@ function renderPlotConfigEditor(container, config, options = {}) {
     });
     return wrap;
   }
+  function constantValueField(line) {
+    const wrap = el("div", "twm-plot-config__constant");
+    const input = el("input", "twm-plot-config__input");
+    input.type = "text";
+    input.spellcheck = false;
+    input.placeholder = "Number or name";
+    input.setAttribute("aria-label", "Value");
+    input.value = line.value ?? "";
+    const now = el("span", "twm-plot-config__constant-value");
+    wrap.append(input, now);
+    const isNumber = (text) => text !== "" && Number.isFinite(Number(text));
+    const sayValue = () => {
+      const named = opts.constantsProvider().find((c) => c.name === input.value.trim());
+      now.textContent = named ? `= ${named.value}` : "";
+    };
+    const settle = () => {
+      const text = input.value.trim();
+      const next = isNumber(text) ? Number(text) : text || null;
+      sayValue();
+      if (next === (line.value ?? null)) return;
+      line.value = next;
+      notify();
+    };
+    const offered = (query) => {
+      const words = (query ?? "").trim().toLowerCase();
+      const groups = /* @__PURE__ */ new Map();
+      for (const c of opts.constantsProvider()) {
+        const text = c.label ?? c.name;
+        if (words && !`${c.name} ${text}`.toLowerCase().includes(words)) continue;
+        if (!groups.has(c.group)) groups.set(c.group, []);
+        groups.get(c.group).push({ value: c.name, label: text, hint: `= ${c.value}` });
+      }
+      return [...groups].flatMap(([group, rows]) => group ? [{ group, options: rows }] : rows);
+    };
+    const list = attachInputOptions(input, {
+      options: offered,
+      debounce: 0,
+      autoHighlight: true,
+      isCandidate: (typed) => isNumber(typed.trim()),
+      openOnFocus: true,
+      isCurrent: (option) => option.value === input.value.trim(),
+      onPick: (option) => {
+        input.value = option.value;
+        settle();
+      },
+      onSettle: settle
+    });
+    input.addEventListener("change", settle);
+    input.addEventListener("keydown", (event) => {
+      if (event.key === "Enter") settle();
+    });
+    track(() => list.destroy());
+    sayValue();
+    return wrap;
+  }
   function referenceLinesEditor(sp) {
     const axisOptions = sp.yAxes.map((a, i) => ({ value: a.id, label: a.label || `Y axis ${i + 1}` }));
     return listEditor(sp, "referenceLines", {
@@ -1348,7 +1414,7 @@ function renderPlotConfigEditor(container, config, options = {}) {
           },
           { label: "Axis" }
         ),
-        numberInput(line.value, (v) => {
+        opts.constantsProvider ? constantValueField(line) : numberInput(line.value, (v) => {
           line.value = v;
           notify();
         }, { placeholder: "Value", label: "Value" }),