flexdesk 0.17.13 → 0.17.14

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # Changelog
 
+## 0.17.14 (2026-10-26)
+
+A patch release. Everything below is additive except one changed default (see
+"Changed default"). Each entry with a docs section links to it.
+
+### Added and changed
+
+- [Tree items with row actions](docs/components/layout-widgets.md#tree-items-with-row-actions-01714): `createTreeItem` takes `actions` in the shape `createTreeNode` takes them (`{ id: { icon, title, onClick(id, event) } }`). The buttons (`.twm-tree-node__action-btn`) sit in one line in a `.twm-tree-item__actions` slot at the row's end, shown on hover, on focus within and on the selected item; the slot takes no height, so a row is as tall with actions as without; it is hidden by opacity, so Tab still reaches the buttons; a click on an action does not select the item and a double-click does not reach `onItemDoubleClick`. Without `actions` the markup is unchanged. `createTreeNode`'s action buttons, built by the same code, are now `type="button"`, so inside a form they no longer submit it (STORY-0121).
+- [The digit chords follow the key's position](docs/components/keymap.md#the-digit-chords-follow-the-keys-position-not-its-character-01714): Alt+1..9 and Alt+Shift+1..9 match `event.code` (`Digit1`..`Digit9`), so Alt+Shift+N moves the focused tile to desktop N from a real key press on any layout (BUG-0046).
+- [Spinners turn without keyframes of your own](docs/concepts/styling.md#spinners-turn-without-keyframes-of-your-own-01714): flexdesk.css defines the `@keyframes` its tile-loading, data-table, computing-status and run-progress spinners name (BUG-0047).
+- [A saved layout that cannot be read](docs/components/panels-and-desktops.md#a-saved-layout-that-cannot-be-read-01714): a saved `desktops` layout that is JSON but not a layout is ignored with one warning, and the shell opens its default layout instead of throwing (BUG-0048).
+- `flexdesk/css/tokens` resolves to `dist/tokens.css`, the file the docs name, like `flexdesk/css` and `flexdesk/css/reset` (BUG-0030).
+- [The menu-bar row is a band of its own](docs/components/menus.md#the-menu-bar-in-its-own-row-under-the-top-bar-01713): `.twm-global-menu-bar` has background `var(--surface-0)`, darker than the top bar, and a `1px solid var(--border-strong)` border above and below (was `var(--surface-1)` with a `var(--surface-0)` bottom border), so it is set off from the top bar and the tiles. The row is 1px taller (STORY-0122).
+
+### Changed default
+
+- `DEFAULT_STATE_GUARD_CONFIG.allowedDatasetKeys` no longer lists thirteen keys that one embedding application had left in it and no FlexDesk widget writes: `scenario-id`, `run-id`, `run-state`, `mirror-input`, `mirror-input-bound`, `mirror-change-bound`, `override-type`, `info-for`, `dsl-state`, `dsl-section-registered`, `dsl-scrollbars-installed`, `dsl-tabs-bound` and `dsl-controls-bound`. An app that writes one of them under a guard built on the defaults lists it on top of them; a strict guard otherwise throws on the write (BUG-0029).
+
+### Removed or renamed exports
+
+None. Compared with 0.17.13, 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, and no option was
+removed or renamed; `createTreeItem` has one new option, `actions`. Not an
+export but worth knowing: flexdesk.css has one new class,
+`.twm-tree-item__actions`, and defines no new custom property.
+
 ## 0.17.13 (2026-10-26)
 
 A patch release: everything below is additive. Every fix is documented in a

package/css/base.css

@@ -1282,16 +1282,19 @@ body.twm-dt-col-resizing {
  * to the top bar does not include it. No z-index, so it is no stacking
  * context: the top bar's dropdowns draw over it, and the .twm-menubar inside
  * keeps its own styles, its menus (position: fixed, --z-over-windows) drawing
- * over the page. Its height is the bar's plus the padding. */
+ * over the page. It reads as a band of its own (STORY-0122, 0.17.14): darker
+ * than the top bar, with a border above and below. Its height is the bar's
+ * plus the padding and the two borders. */
 .twm-global-menu-bar {
     display: flex;
     align-items: center;
     width: 100%;
     box-sizing: border-box;
     padding: var(--space-xxs) var(--space-xs);
-    background-color: var(--surface-1);
+    background-color: var(--surface-0);
     color: var(--text-body);
-    border-bottom: 1px solid var(--surface-0);
+    border-top: 1px solid var(--border-strong);
+    border-bottom: 1px solid var(--border-strong);
     overflow: visible; /* the bar's menus extend below */
 }
 .twm-bar-center {
@@ -2436,6 +2439,28 @@ body.twm-window-maximized .twm-resize-handle {
     color: var(--text-dim);
     margin-left: var(--space-xs);
 }
+/* Row actions (createTreeItem's `actions`, STORY-0121): one line at the row's
+ * end, after label, subtitle and badge, shown on hover, on focus within and on
+ * the selected item. Hidden by opacity, not display, so the buttons stay in
+ * the tab order (Tab reaches them and :focus-within shows them) and the label
+ * keeps its width on hover. The slot is no taller than the label line, so a
+ * row is as high with actions as without. */
+.twm-tree-item__actions {
+    display: flex;
+    align-items: center;
+    gap: var(--space-xxs);
+    flex-shrink: 0;
+    height: 0;
+    overflow: visible;
+    opacity: 0;
+    pointer-events: none;
+}
+.twm-tree-item:hover > .twm-tree-item__actions,
+.twm-tree-item:focus-within > .twm-tree-item__actions,
+.twm-tree-item.selected > .twm-tree-item__actions {
+    opacity: 1;
+    pointer-events: auto;
+}
 /* ═══════════════════════════════════════════════════════════════════════════
    Plot Popout Window
    ═══════════════════════════════════════════════════════════════════════════ */
@@ -2813,6 +2838,18 @@ body.twm-window-maximized .twm-resize-handle {
     border-radius: 50%;
     animation: computing-spin 0.8s linear infinite;
 }
+/* The keyframes the rule above names. A spinner rule shipped with the animation
+   name and without the `@keyframes` block, which CSS does not report: an
+   undefined name is simply no animation, so the ring was drawn and never
+   turned, and nothing threw, logged or failed a build. `@keyframes` names are
+   global, so this one is not scoped (see `spin`): an embedder that defines
+   its own `computing-spin` wins or loses on source order, and either way the
+   ring turns. A full turn at the rule's own duration, linear and infinite, so
+   the loop has no seam: the arc is back where it started. */
+@keyframes computing-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-computing-status__message {
     font-size: var(--font-size-md);
     color: #b0b0b0;
@@ -2858,6 +2895,11 @@ body.twm-window-maximized .twm-resize-handle {
     flex-shrink: 0;
     animation: etl-spin 0.8s linear infinite;
 }
+/* The keyframes the rule above names; see `computing-spin`. */
+@keyframes etl-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-run-progress__message {
     font-size: var(--font-size-md);
     color: var(--text-primary, #ccc);

package/css/flexdesk.css

@@ -1702,16 +1702,19 @@ body.twm-dt-col-resizing {
  * to the top bar does not include it. No z-index, so it is no stacking
  * context: the top bar's dropdowns draw over it, and the .twm-menubar inside
  * keeps its own styles, its menus (position: fixed, --z-over-windows) drawing
- * over the page. Its height is the bar's plus the padding. */
+ * over the page. It reads as a band of its own (STORY-0122, 0.17.14): darker
+ * than the top bar, with a border above and below. Its height is the bar's
+ * plus the padding and the two borders. */
 .twm-global-menu-bar {
     display: flex;
     align-items: center;
     width: 100%;
     box-sizing: border-box;
     padding: var(--space-xxs) var(--space-xs);
-    background-color: var(--surface-1);
+    background-color: var(--surface-0);
     color: var(--text-body);
-    border-bottom: 1px solid var(--surface-0);
+    border-top: 1px solid var(--border-strong);
+    border-bottom: 1px solid var(--border-strong);
     overflow: visible; /* the bar's menus extend below */
 }
 .twm-bar-center {
@@ -2961,6 +2964,28 @@ body.twm-window-maximized .twm-resize-handle {
     color: var(--text-dim);
     margin-left: var(--space-xs);
 }
+/* Row actions (createTreeItem's `actions`, STORY-0121): one line at the row's
+ * end, after label, subtitle and badge, shown on hover, on focus within and on
+ * the selected item. Hidden by opacity, not display, so the buttons stay in
+ * the tab order (Tab reaches them and :focus-within shows them) and the label
+ * keeps its width on hover. The slot is no taller than the label line, so a
+ * row is as high with actions as without. */
+.twm-tree-item__actions {
+    display: flex;
+    align-items: center;
+    gap: var(--space-xxs);
+    flex-shrink: 0;
+    height: 0;
+    overflow: visible;
+    opacity: 0;
+    pointer-events: none;
+}
+.twm-tree-item:hover > .twm-tree-item__actions,
+.twm-tree-item:focus-within > .twm-tree-item__actions,
+.twm-tree-item.selected > .twm-tree-item__actions {
+    opacity: 1;
+    pointer-events: auto;
+}
 /* ═══════════════════════════════════════════════════════════════════════════
    Plot Popout Window
    ═══════════════════════════════════════════════════════════════════════════ */
@@ -3338,6 +3363,18 @@ body.twm-window-maximized .twm-resize-handle {
     border-radius: 50%;
     animation: computing-spin 0.8s linear infinite;
 }
+/* The keyframes the rule above names. A spinner rule shipped with the animation
+   name and without the `@keyframes` block, which CSS does not report: an
+   undefined name is simply no animation, so the ring was drawn and never
+   turned, and nothing threw, logged or failed a build. `@keyframes` names are
+   global, so this one is not scoped (see `spin`): an embedder that defines
+   its own `computing-spin` wins or loses on source order, and either way the
+   ring turns. A full turn at the rule's own duration, linear and infinite, so
+   the loop has no seam: the arc is back where it started. */
+@keyframes computing-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-computing-status__message {
     font-size: var(--font-size-md);
     color: #b0b0b0;
@@ -3383,6 +3420,11 @@ body.twm-window-maximized .twm-resize-handle {
     flex-shrink: 0;
     animation: etl-spin 0.8s linear infinite;
 }
+/* The keyframes the rule above names; see `computing-spin`. */
+@keyframes etl-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-run-progress__message {
     font-size: var(--font-size-md);
     color: var(--text-primary, #ccc);
@@ -8868,6 +8910,16 @@ tr:hover .twm-row-action { opacity: 1; }
     border-radius: 50%;
     animation: data-table__spin 0.7s linear infinite;
 }
+/* The keyframes the rule above names. Without them the name is no animation
+   (CSS reports nothing for it), so the ring was drawn and stood still. A full
+   turn at the rule's own 0.7s linear infinite. `@keyframes` names are global
+   and cannot be scoped (see `spin`); a definition of the same name in an
+   embedder's sheet wins or loses on source order, and either way the ring
+   turns. */
+@keyframes data-table__spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-data-table-component--compact .twm-pagination-controls > span {
     color: var(--ea-text-dim, #aaa) !important;
     font-size: 9.5px !important;
@@ -9045,6 +9097,11 @@ tr:hover .twm-row-action { opacity: 1; }
     border-radius: 50%;
     animation: twm-tile-loading-spin 0.7s linear infinite;
 }
+/* The keyframes the rule above names; see `data-table__spin`. */
+@keyframes twm-tile-loading-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 /* Merged home page — detail header row, then the project-setup body
  * fills the rest of the tile. */
 .twm-home-page {

package/css/overrides.css

@@ -2118,6 +2118,16 @@ tr:hover .twm-row-action { opacity: 1; }
     border-radius: 50%;
     animation: data-table__spin 0.7s linear infinite;
 }
+/* The keyframes the rule above names. Without them the name is no animation
+   (CSS reports nothing for it), so the ring was drawn and stood still. A full
+   turn at the rule's own 0.7s linear infinite. `@keyframes` names are global
+   and cannot be scoped (see `spin`); a definition of the same name in an
+   embedder's sheet wins or loses on source order, and either way the ring
+   turns. */
+@keyframes data-table__spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 .twm-data-table-component--compact .twm-pagination-controls > span {
     color: var(--ea-text-dim, #aaa) !important;
     font-size: 9.5px !important;
@@ -2295,6 +2305,11 @@ tr:hover .twm-row-action { opacity: 1; }
     border-radius: 50%;
     animation: twm-tile-loading-spin 0.7s linear infinite;
 }
+/* The keyframes the rule above names; see `data-table__spin`. */
+@keyframes twm-tile-loading-spin {
+    from { transform: rotate(0deg); }
+    to   { transform: rotate(360deg); }
+}
 /* Merged home page — detail header row, then the project-setup body
  * fills the rest of the tile. */
 .twm-home-page {

package/dist/core.js

@@ -519,11 +519,8 @@ var DEFAULT_ALLOWED_DATASET_KEYS = Object.freeze([
   "node-name",
   "lang",
   "playback-control",
-  // Simulation/scenario state keys
+  // Generic state words
   "status",
-  "scenario-id",
-  "run-id",
-  "run-state",
   "selected",
   "active",
   "disabled",
@@ -539,13 +536,10 @@ var DEFAULT_ALLOWED_DATASET_KEYS = Object.freeze([
   "input-index",
   "output-index",
   "port-index",
-  // Scenario editor keys
+  // Identifier and binding keys
   "source",
   "series-id",
   "dataset-id",
-  "mirror-input-bound",
-  "mirror-change-bound",
-  "mirror-input",
   "bound",
   "field",
   "key",
@@ -554,14 +548,11 @@ var DEFAULT_ALLOWED_DATASET_KEYS = Object.freeze([
   "tab-id",
   "param-id",
   "target-id",
-  "override-type",
   // Tree view component keys
   "item-id",
   "category-id",
-  // Calibration page keys
-  "info-for",
-  "column",
   // Data page keys
+  "column",
   "readonly",
   "id",
   "action",
@@ -580,12 +571,6 @@ var DEFAULT_ALLOWED_DATASET_KEYS = Object.freeze([
   "label",
   "title",
   "description",
-  // DSL generator keys
-  "dsl-state",
-  "dsl-section-registered",
-  "dsl-scrollbars-installed",
-  "dsl-tabs-bound",
-  "dsl-controls-bound",
   // Inline highlighter keys
   "inline-hl",
   // Overlay scrollbar keys (UI-only, not state storage)