flexdesk 0.17.18 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,96 @@
 # Changelog
 
+## 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
+what the applications on FlexDesk each kept a copy of: a page rail, a workspace
+picker, a filter builder, a rich select, combobox and popover, and an assistant
+chat shell. The entries under "Changed behaviour" change what embedders see.
+
+A consumer on a caret range has to raise it: `^0.17.18` does not take 0.18.0.
+
+### Added
+
+- [`@flexdesk/git`, a tenth entry point](docs/concepts/packages-and-entry-points.md#ten-entry-points): [a source-control panel, `createGitPanel`](docs/components/git.md#the-panel-creategitpanel-0180), [a commit graph, `createGitGraph`](docs/components/git.md#the-commit-graph-creategitgraph-0180) and [a diff viewer, `createDiffViewer`](docs/components/git.md#the-diff-viewer-creatediffviewer-0180), with [`computeLineDiff`, the line diff without the viewer](docs/components/git.md#the-line-diff-without-the-viewer-0180) and [`openDiffWindow` and `openGitDiffWindow`](docs/components/git.md#a-diff-in-a-window-opendiffwindow-opengitdiffwindow-0180), over [a written adapter contract](docs/components/git.md#the-git-adapter-contract-0180). A consumer's import map needs `@flexdesk/git`.
+- [The pages as a vertical rail: `chrome.rail`](docs/components/shell.md#the-pages-as-a-vertical-rail-chromerail-0180): `createShell` paints the top-nav kinds as an icon rail, `mountPageRail` does it for a shell of your own, and a kind's `railPin: 'bottom'` holds it at the bottom of the bar. [F1..F12 press the rail's buttons](docs/components/keymap.md#f1f12-and-a-page-rail-0180) as they do the top nav's. `chrome.rail` with `chrome.topNav` is refused at boot.
+- [A workspace picker: `createWorkspacePicker`](docs/components/workspace-picker.md#a-field-and-a-switcher-createworkspacepicker-0180), from [the field, `mountPickerField`](docs/components/workspace-picker.md#the-field-mountpickerfield-0180) and [the switcher, `createPickerSwitcher`](docs/components/workspace-picker.md#the-switcher-createpickerswitcher-0180), and [a store of what was recently opened, `createRecentItems`](docs/components/workspace-picker.md#recently-opened-createrecentitems-0180).
+- A filter builder: [the model, `createFilterModel`](docs/components/filter-builder.md#the-model-createfiltermodel-0180) with [its condition tree](docs/components/filter-builder.md#the-condition-tree-0180), [the builder, `createFilterBuilder`](docs/components/filter-builder.md#the-builder-createfilterbuilder-0180) with [custom value editors](docs/components/filter-builder.md#a-custom-value-editor-0180), and [the dialog, `openFilterDialog`](docs/components/filter-builder.md#the-dialog-openfilterdialog-0180).
+- [A select drawn in the DOM: `createSelect`](docs/components/input-fields.md#a-select-drawn-in-the-dom-createselect-0180), [a text box that also offers a list: `createCombobox`](docs/components/input-fields.md#a-text-box-that-also-offers-a-list-createcombobox-0180) and [a rich popover: `openPopover`](docs/components/menus.md#a-rich-popover-openpopover-0180), on [one rule for an anchored layer: `positionAnchored`, `openAnchoredLayer`, `isInAnchoredLayer`](docs/components/menus.md#an-anchored-layer-positionanchored-openanchoredlayer-0180).
+- [An assistant chat: `mountChatShell`](docs/components/chat-shell.md#an-assistant-chat-mountchatshell-0180), a domain-free chat over the conversation view with its state machine (`ChatStateMachine`) and a transport of yours.
+- [Taking one message out of a conversation: `view.remove(id)`](docs/components/conversation.md#taking-one-message-out-remove-0180).
+- [Tag suggestions and one spelling for tags: `suggestions`, `normalise`](docs/components/input-fields.md#suggestions-and-one-spelling-for-tags-suggestions-normalise-0180) on the tag input.
+- [A modal that can refuse to close: `beforeClose`](docs/components/forms-and-dialogs.md#a-modal-that-can-refuse-to-close-beforeclose-0180) on `openModal`.
+
+### Changed behaviour
+
+- **[A saved desktop with no `tree` is an empty desktop](docs/components/panels-and-desktops.md#a-desktop-with-no-tree-is-an-empty-desktop-0180).** It loads, seeded with the root kind, and its siblings load with it. **Upgrade warning for a host that composes the layout blob:** from 0.17.14 to 0.17.18 a desktop with no `tree` key set the whole layout aside, and the next layout change overwrote the user's saved desktops for good. Go straight to 0.18.0, or write `tree: null` on those releases. A layout that is still unreadable is still set aside whole and overwritten at the next save.
+- **Tab stays inside a popover.** [`openPopover`](docs/components/menus.md#a-rich-popover-openpopover-0180) goes round its controls, as a modal and a `CategoryPicker` do, and Escape is the way out. The flow kit's popover is now this one, so the step picker and *Insert a value* no longer close when Tab leaves them.
+- **A modal's focus trap leaves focus in an anchored layer alone**, so a popover opened from a modal keeps its focus.
+- **The flow kit's popover: test `handle.el`, not `handle.toggled`.** `toggled` is true only when the call closed the popover its anchor held. An anchor that is not on the page now opens nothing and answers `el: null`, `toggled: false`, so a caller asking whether anything opened tests `!handle.el`. Two kit popovers can now be open when one owns the other's anchor, and the outline menu answers `el: null` when nothing opened.
+- **`taxonomy.topNavEntries()` entries carry `railPin`** (null unless set). A consumer's test that deep-compares an entry sees the new key. `railPin` of any other value, or on a kind that is not `isTopNav`, is a boot error.
+- `.twm-fl-bar` and `.twm-fl-item` had rules and no code that drew them. They are now the rail's: `.twm-fl-bar` has its width, background and overflow and no `height: 100%`, and `.twm-fl-item`'s grey comes from `--twm-rail-icon` ([details](docs/components/shell.md#the-pages-as-a-vertical-rail-chromerail-0180)).
+- [An `openForm` combobox field draws with `createCombobox`](docs/components/forms-and-dialogs.md#it-is-createcombobox-0180), not an `<input list>`: Enter with the list open closes the list and the next one submits, Escape closes the list and leaves the form open, there is no `<datalist>`, and `.twm-combobox__hint` has no `data-for`.
+- [The tag input](docs/components/input-fields.md#suggestions-and-one-spelling-for-tags-suggestions-normalise-0180): the list it opens with, and `setValue`'s, drop a repeat unless `allowDuplicates` is set, as typing always did.
+- `ActionDropdown` places its menu with `positionAnchored`, the one placement every floating panel uses.
+- `shell.dispose()` empties `chrome.topNav` and takes its click listener off. The element is the embedder's and outlives the shell, and a shell rebuilt on it left each dead shell opening pages too.
+- The DOM events FlexDesk fires (`managed-window-*`, `tile:*-request`, a select's, combobox's, colour field's and form field's `input` and `change`) are built by the target's own window. A bare constructor threw under jsdom on Node 19 or later, in the middle of a window's close, so a consumer's suite no longer needs to replace the global `CustomEvent` for them.
+
+### Removed files
+
+- `css/base.css` and `css/overrides.css` are gone from the package. They were the sources `css/flexdesk.css` was once generated from; the generator has left the repository, `exports` never mapped them and no consumer loaded them, and they lacked more than half of the library's rules. `flexdesk/css`, `flexdesk/css/tokens` and `flexdesk/css/reset` are unchanged. A rule that once went in both goes in `css/flexdesk.css` alone.
+
+### Removed or renamed exports
+
+None. Compared with 0.17.18 across every entry point. New:
+
+- `@flexdesk/git`: `createGitPanel`, `createGitGraph`, `createDiffViewer`, `openDiffWindow`, `openGitDiffWindow`, `computeGraphLanes`, `parseGitRefs`, `computeLineDiff`, `parseUnifiedDiff`, `splitLines`, `diffStats`, `LINE_DIFF_LIMIT`.
+- `@flexdesk/wm`: `mountPageRail`; the `chrome.rail` option, `shell.chrome.railEl` and `KindDef.railPin`.
+- `@flexdesk/widgets`:
+  - the select, combobox and layers: `createSelect`, `createCombobox`, `attachInputOptions`, `filterOptions`, `openPopover`, `positionAnchored`, `openAnchoredLayer`, `isInAnchoredLayer`;
+  - the picker: `createWorkspacePicker`, `mountPickerField`, `createPickerSwitcher`, `createRecentItems`;
+  - the filter: `createFilterModel`, `createFilterBuilder`, `openFilterDialog`, `emptyFilter`, `cloneFilter`, `parseFilter`, `serializeFilter`, `countConditions`, `coerceFilterValue`, `toConditionTree`, `fromConditionTree`, `FILTER_OPERATORS`, `FILTER_TYPE_OPERATORS`;
+  - the chat: `mountChatShell`, `ChatStateMachine`, `CHAT_STATES`, `CHAT_TRANSITIONS`, `CHAT_BUS_EVENTS`, `CHAT_TRANSPORT_EVENTS`, `CHAT_SHELL_LABELS`.
+- `view.remove(id)` on the conversation view; `createTagInput`'s `suggestions` and `normalise` options; `openModal`'s `beforeClose` option.
+- Custom properties in `tokens.css`: `--twm-diff-add-bg`, `--twm-diff-add-fg`, `--twm-diff-del-bg`, `--twm-diff-del-fg`, `--twm-git-lane-0` to `--twm-git-lane-7`, `--twm-rail-width`, `--twm-rail-item-height`, `--twm-rail-icon-size`, `--twm-rail-bg`, `--twm-rail-icon`, `--twm-rail-icon-on`.
+
 ## 0.17.18 (2026-10-27)
 
 A patch release. One additive menu bar option; one entry changes what

package/README.md

@@ -31,6 +31,7 @@ Import only what you use. The entries share their code, so loading several does
 | `@flexdesk/editor` | A Monaco multi-file editor (Monaco is a peer dependency) |
 | `@flexdesk/canvas` | A pannable, zoomable canvas with an edge router and a graph layer |
 | `@flexdesk/flow` | Flow editors: canvas, outline and lanes |
+| `@flexdesk/git` | A source-control panel, a commit graph and a diff viewer, over a written adapter contract |
 
 With npm the entries are imported as `flexdesk/wm`, `flexdesk/widgets` and so on. The docs write them as `@flexdesk/…`, the names an import map gives them. [Packages and entry points](docs/concepts/packages-and-entry-points.md) has the sizes.