@kolkrabbi/kol-shell 0.23.0 → 0.24.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.23.0",
+  "version": "0.24.0",
   "private": false,
   "description": "KOL application shell — fixed 48px NavRail + AppShell layout root, PageShell/PageHeader scaffolds, ContentFilters catalog organism, GridCard, SettingsScaffold, WalkthroughPanel, ShortcutsOverlay. App chrome (kol-framework owns site chrome). Nav items, content, shortcuts and settings are consumer-injected. Sits above @kolkrabbi/kol-{theme,component,framework}.",
   "license": "MIT",

package/src/SettingsScaffold.jsx

@@ -50,7 +50,9 @@ import PageHeader from './PageHeader.jsx'
  * @param {Array}     props.items           rows to search/filter over; omit and the row is chrome only
  * @param {Array}     props.filterGroups    ContentFilters groups
  * @param {Array}     props.searchKeys      which keys `items` are searched on
- * @param {ReactNode} props.trailingActions the page's own controls, right of the row
+ * @param {ReactNode|Function} props.trailingActions the page's own controls, right of the row.
+ *                                  A FUNCTION receives `(tab, setTab)` — for a control that has to
+ *                                  move the page, e.g. an icon pair that jumps back to Settings
  * @param {string}    props.tone            forwarded to ContentFilters (`sunken` is fxr's approved page)
  * @param {Object}    props.filtersProps    escape hatch — anything else the organism takes
  */
@@ -97,7 +99,19 @@ export default function SettingsScaffold({
         totalCount={items?.length ?? 0}
         filterGroups={filterGroups}
         searchKeys={searchKeys}
-        trailingActions={trailingActions}
+        /* A NODE cannot reach the tab it sits beside. fxr's OPTIONS /
+         * SHORTCUTS pair stays visible on About and Repo (user 2026-08-28 — the
+         * row is the page's furniture, and hiding it made the header jump a
+         * line on every leave), and picking either one must return you to
+         * Settings. Owning `tab` here took that away: the pair changed the
+         * settings view while you sat on About and you had to click SETTINGS
+         * yourself (SettingsScaffoldTabFromTrailing, 2026-08-30).
+         *
+         * A render prop, not a controlled `tab`/`onTabChange` pair: the
+         * controlled shape hands page state back to the consumer, which is
+         * precisely what 0.23.0 removed. This hands out a setter and leaves the
+         * state where the last ticket put it. A plain node still works. */
+        trailingActions={typeof trailingActions === 'function' ? trailingActions(tab, setTab) : trailingActions}
         /* THE TABS ARE THE VIEW STRIP — the same row fxr's SETTINGS and the home
          * page's RECENT / SAVED run on, not a strip of our own. That is the
          * whole point: one row grammar, not a settings dialect of it. */