@kolkrabbi/kol-shell 0.35.0 → 0.37.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.35.0",
+  "version": "0.37.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",
@@ -20,10 +20,10 @@
     "react-dom": "^18.3.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@kolkrabbi/kol-component": "^0.152.0",
-    "@kolkrabbi/kol-framework": "^0.36.0",
+    "@kolkrabbi/kol-component": "^0.154.1",
     "@kolkrabbi/kol-icons": "^0.25.0",
-    "@kolkrabbi/kol-theme": "^0.121.0"
+    "@kolkrabbi/kol-framework": "^0.36.0",
+    "@kolkrabbi/kol-theme": "^0.122.0"
   },
   "files": [
     "src",

package/src/AppShell.jsx

@@ -56,6 +56,14 @@ import TouchDeviceOverlay, { useTouchPrimary } from './TouchDeviceOverlay.jsx'
  *                                        `bare` renders the children with NO shell on a coarse-pointer device unless
  *                                        localStorage `kol-desktop` is '1' (fxr's gate); `overlay` keeps the shell and
  *                                        mounts TouchDeviceOverlay once (monitor's)
+ * @param {string[]} [props.drawerOpenOn=[]]  paths whose ENTRY opens the drawer (ShellDrawerOpenOnRoute,
+ *                                        kol-mirror 2026-09-01 — user: "the rail should load open on home, not
+ *                                        everywhere"): a home that is a catalog IS navigation, and arriving there
+ *                                        with the nav folded hides the one thing the page is for. Matched like the
+ *                                        rail's active row — `'/'` exact, anything else by prefix. Every other path
+ *                                        keeps the close-on-navigate rule; above `drawerBelow` there is no drawer
+ *                                        and the list is inert. A list, not a boolean: the policy is per-route and
+ *                                        the shell already owns the route.
  * @param {string}  props.appName       TouchDeviceOverlay's subject
  * @param {boolean} props.navKeys       Option+1…9 navigates to the rail's nth ROW through `onNavigate` — with a
  *                                        `logomark` that is the mark ('/') then the items, which is the order on
@@ -107,6 +115,7 @@ export default function AppShell({
   settingsPath,
   settingsKey,
   drawerBelow = 768,
+  drawerOpenOn = [],
   children,
 }) {
   const [navHidden, setNavHidden] = useState(false)
@@ -193,10 +202,13 @@ export default function AppShell({
    * `setNavHidden(false)` also made `navHidden` unusable as a consumer seam —
    * child effects run before parent effects, so a consumer hiding the rail on a
    * path change was overwritten in the same commit. */
+  /* …unless the destination is one where nav IS the page (`drawerOpenOn`):
+   * there the entry OPENS it. Runs on mount, on the fold and on navigation
+   * alike — `drawer` is a dep — so a phone arriving on home gets the rail. */
   useEffect(() => {
-    if (drawer) setDrawerOpen(false)
+    if (drawer) setDrawerOpen(drawerOpenOn.some((p) => (p === '/' ? currentPath === '/' : currentPath.startsWith(p))))
     else setNavHidden(false)
-  }, [currentPath, drawer])
+  }, [currentPath, drawer, drawerOpenOn])
 
   /* THE WASH ALSO GOES ON THE ROOT (2026-08-30). It is set on the content
    * wrapper below, which every page inherits — but a PORTALLED surface does

package/src/SettingsShortcuts.jsx

@@ -9,9 +9,20 @@ import { SettingsRow } from '@kolkrabbi/kol-component'
 /**
  * SettingsShortcuts — the keyboard-shortcuts block of a settings page
  * (ShellHomeSystem, kol-fxr 2026-08-27): the same `[{ section, items: [{ id,
- * label, combo }] }]` array `ShortcutsOverlay` takes, laid out six columns ×
+ * label, combo }] }]` array `ShortcutsOverlay` takes, laid out UP TO six columns ×
  * two sections per column, filled column-first (user, 2026-08-27) — each
- * section an eyebrow (`kol-eyebrow`, strong ink) over SettingsRows. A combo is one
+ * section an eyebrow (`kol-eyebrow`, strong ink) over SettingsRows. The six
+ * is a CEILING, not a command (SettingsShortcutsGridColumns, kol-mirror
+ * 2026-09-01 — the fourth home of the cols-as-command defect, unswept when
+ * CatalogPage was the third): `grid-cols-6` computed six 18px slivers in a
+ * 350px row. Same idiom as CatalogPage / ContentCollection — no track under
+ * the 150px floor (`GRAB AND PAN THE DESK` / `Space + drag`, the widest cells
+ * in the estate), none wider than the container, and the count falls out of
+ * the width: two at 390, six on the desk, where the sixth-share clears the
+ * floor so nothing moves. Below `md` the grid flows by ROW — the two-row
+ * column-first shape is a desk ruling and would overflow implicit columns
+ * off the right edge on a phone. Gap is `gap-x-6 md:gap-x-12`, the rung
+ * ContentFiltersMobileGaps set for this shape (48px was 17% of the row). A combo is one
  * token by nature — the value cell is `whitespace-nowrap` and the label yields
  * (SettingsShortcutsComboWrap, kol-monitor 2026-08-27: `⌘ K` broke as `⌘` over
  * `K` in the six-column grid — the cell was squeezed to min-content, not full).
@@ -27,7 +38,10 @@ import { SettingsRow } from '@kolkrabbi/kol-component'
  */
 export default function SettingsShortcuts({ sections = [], comboLabel = (c) => c, className = '' }) {
   return (
-    <div className={`grid grid-cols-6 grid-rows-2 grid-flow-col gap-x-12 gap-y-6 ${className}`.trim()}>
+    <div
+      className={`grid md:grid-rows-2 md:grid-flow-col gap-x-6 md:gap-x-12 gap-y-6 ${className}`.trim()}
+      style={{ gridTemplateColumns: 'repeat(auto-fill, minmax(min(100%, max(150px, calc((100% - 5 * 48px) / 6))), 1fr))' }}
+    >
       {sections.map(({ section, items }) => (
         <div key={section} style={{ display: 'flex', flexDirection: 'column', gap: 4 }}>
           <span className="kol-eyebrow text-strong mb-2">{section}</span>