@kolkrabbi/kol-shell 0.11.0 → 0.12.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.11.0",
+  "version": "0.12.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-icons": "^0.22.0",
-    "@kolkrabbi/kol-component": "^0.110.0",
-    "@kolkrabbi/kol-theme": "^0.72.0",
-    "@kolkrabbi/kol-framework": "^0.28.0"
+    "@kolkrabbi/kol-component": "^0.118.2",
+    "@kolkrabbi/kol-framework": "^0.30.0",
+    "@kolkrabbi/kol-icons": "^0.24.0",
+    "@kolkrabbi/kol-theme": "^0.78.1"
   },
   "files": [
     "src",

package/src/AppShell.jsx

@@ -26,6 +26,13 @@ import TouchDeviceOverlay, { useTouchPrimary } from './TouchDeviceOverlay.jsx'
  *                                        localStorage `kol-desktop` is '1' (fxr's gate); `overlay` keeps the shell and
  *                                        mounts TouchDeviceOverlay once (monitor's)
  * @param {string}  props.appName       TouchDeviceOverlay's subject
+ * @param {boolean} props.navKeys       Option+1…9 navigates to `items[n-1].path` through `onNavigate` — the
+ *                                        rail-order counterpart of `railToggleKey` (AppShellNavKeys, kol-monitor
+ *                                        2026-08-28 — user: "make command or alt 1234 go from home 1 2 3 4 in the
+ *                                        sidenav without clicking"). Option, not Command: ⌘1–9 is the browser's
+ *                                        tab switch. Matched on `e.code` (`Digit1`…) because Opt+digit yields
+ *                                        `¡ ™ £ ¢` as `e.key` on macOS; ignored while typing in a field; only
+ *                                        digits with an item; `preventDefault` on a match. Default off.
  * @param {string}  props.pageWash      a CSS colour painted by `PageShell` OVER the shell's primary back
  *                                        (ShellPageWash, kol-monitor 2026-08-27 — user: "the back of the back
  *                                        should be primary — then you can just add transparent on top to step
@@ -47,6 +54,7 @@ export default function AppShell({
   touch = 'shell',
   appName,
   pageWash,
+  navKeys = false,
   children,
 }) {
   const [navHidden, setNavHidden] = useState(false)
@@ -68,6 +76,23 @@ export default function AppShell({
     return () => window.removeEventListener('keydown', onKey)
   }, [railToggleKey])
 
+  /* Option+digit → the rail item in that position (never while typing) */
+  useEffect(() => {
+    if (!navKeys) return undefined
+    const onKey = (e) => {
+      const m = /^Digit([1-9])$/.exec(e.code)
+      if (!m || !e.altKey || e.metaKey || e.ctrlKey) return
+      const t = e.target
+      if (t?.isContentEditable || /^(INPUT|TEXTAREA|SELECT)$/.test(t?.tagName)) return
+      const item = items?.[Number(m[1]) - 1]
+      if (!item?.path) return
+      e.preventDefault()
+      onNavigate?.(item.path)
+    }
+    window.addEventListener('keydown', onKey)
+    return () => window.removeEventListener('keydown', onKey)
+  }, [navKeys, items, onNavigate])
+
   let wantsDesktop = false
   try { wantsDesktop = typeof localStorage !== 'undefined' && localStorage.getItem('kol-desktop') === '1' } catch { /* storage blocked */ }
   /* the wash variable rides the bare wrapper too (custom properties inherit