@kolkrabbi/kol-shell 0.64.0 → 0.66.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.64.0",
+  "version": "0.66.0",
   "private": false,
   "description": "The application shell",
   "license": "MIT",
@@ -12,7 +12,7 @@
     "./src/*": "./src/*"
   },
   "peerDependencies": {
-    "@kolkrabbi/kol-component": ">=0.246.0",
+    "@kolkrabbi/kol-component": ">=0.266.0",
     "@kolkrabbi/kol-icons": ">=0.16.0",
     "@kolkrabbi/kol-theme": ">=0.165.0",
     "gsap": "^3.13.0",
@@ -20,10 +20,10 @@
     "react-dom": "^18.3.0 || ^19.0.0"
   },
   "devDependencies": {
-    "@kolkrabbi/kol-framework": "^0.49.0",
+    "@kolkrabbi/kol-component": "^0.266.0",
+    "@kolkrabbi/kol-icons": "^0.39.0",
     "@kolkrabbi/kol-theme": "^0.174.0",
-    "@kolkrabbi/kol-icons": "^0.38.0",
-    "@kolkrabbi/kol-component": "^0.261.0"
+    "@kolkrabbi/kol-framework": "^0.50.0"
   },
   "files": [
     "src",

package/src/AppHub.jsx

@@ -2,9 +2,10 @@ import { useEffect, useState } from 'react'
 import AppShell from './AppShell.jsx'
 import HubHome from './HubHome.jsx'
 import HubSettings from './HubSettings.jsx'
-import { ShortcutsOverlay } from '@kolkrabbi/kol-component'
+import HubDev from './HubDev.jsx'
+import { CommandOverlay } from '@kolkrabbi/kol-component'
 
-/* taxonomy-ok: organism — nests AppShell / HubHome / HubSettings / ShortcutsOverlay (relative) */
+/* taxonomy-ok: organism — nests AppShell / HubHome / HubSettings / HubDev (relative) + kol-component's CommandOverlay */
 
 /**
  * AppHub — An app's shell and hub in one. Shell + Hub in one call; the app passes its Tool as children (the app anatomy,
@@ -37,6 +38,9 @@ import { ShortcutsOverlay } from '@kolkrabbi/kol-component'
  *                              OPT-IN like AppShell's `bottomItems` (apps review 2026-09-29: *"not sure it makes sense
  *                              to neccessarily have settings manditory part of the rail"*) — no `settings`, no rail
  *                              row, no route, no `,` key. It was pinned whether the app had settings or not.
+ * @param {Object}   dev        HubDev's props (`tabs`, `title`, `subtitle`) + `path` (default `/dev`). OPT-IN, and only on
+ *                              a dev server (`import.meta.env.DEV`; `always: true` overrides) — a `code` row above
+ *                              Settings (CompareGridDevTab, kol-monitor 2026-10-17)
  * @param {Array}    shortcuts  `[{ section, items: [{ id, label, combo }] }]` — the sheet AND Settings
  * @param {ReactNode} themeToggle  Settings' masthead toggle (a node — kol-framework is not a peer)
  * @param {string}   shortcutsKey  default `s`; `null` turns the sheet key off (a tool that owns S)
@@ -55,6 +59,7 @@ export default function AppHub({
   home,
   walkthrough,
   settings,
+  dev,
   shortcuts = [],
   themeToggle,
   settingsPath = '/settings',
@@ -65,6 +70,7 @@ export default function AppHub({
   children,
 }) {
   const [sheet, setSheet] = useState(false)
+  const [sheetQuery, setSheetQuery] = useState('')
 
   useEffect(() => {
     if (!shortcutsKey) return undefined
@@ -79,12 +85,18 @@ export default function AppHub({
     return () => window.removeEventListener('keydown', onKey)
   }, [shortcutsKey])
 
+  /* the dev page is a dev server's only — a production build never routes it or draws its row */
+  const devOn = !!dev && (dev.always || !!import.meta.env?.DEV)
+  const devPath = dev?.path ?? '/dev'
+  const { path: _dp, always: _da, ...devProps } = dev ?? {}
   const page = home && currentPath === homePath
     ? <HubHome app={app} iconComponent={iconComponent} walkthrough={walkthrough} {...home} />
     : settings && currentPath === settingsPath
       ? <HubSettings app={app} shortcuts={shortcuts} themeToggle={themeToggle} {...settings} />
-      : children
-  const bottom = settings ? SETTINGS_ROW(settingsPath) : []
+      : devOn && (currentPath === devPath || currentPath?.startsWith(`${devPath}/`))
+        ? <HubDev storageKey={`kol-dev-tab:${app.name ?? 'app'}`} {...devProps} />
+        : children
+  const bottom = [...(devOn ? [{ icon: 'code', path: devPath, label: 'Dev' }] : []), ...(settings ? SETTINGS_ROW(settingsPath) : [])]
   /* the phone bar lists Home as a tab — the rail draws it as the mark, the bar has no mark */
   const barItems = [...(home ? [{ icon: 'home-01', path: homePath, label: 'Home' }] : []), ...items, ...bottom]
 
@@ -111,7 +123,9 @@ export default function AppHub({
       {...shell}
     >
       {page}
-      {sheet && <ShortcutsOverlay shortcuts={shortcuts} onClose={() => setSheet(false)} />}
+      {/* THE SHEET IS THE OVERLAY'S SHORTCUTS MODE (5.3, 2026-10-17): the whole keymap at a glance, this page's
+        * first, the rest under Elsewhere; typing filters, Enter runs a row */}
+      <CommandOverlay open={sheet} mode="shortcuts" shortcuts={shortcuts} currentPath={currentPath} query={sheetQuery} onQueryChange={setSheetQuery} onClose={() => { setSheet(false); setSheetQuery('') }} />
     </AppShell>
   )
 }

package/src/AppStudio.jsx

@@ -37,6 +37,7 @@ import PageShell from './PageShell.jsx'
  * @param {Object} [use]        `{ children, path, label, icon }` — the tool
  * @param {Array}  [pages]      `[{ path, icon, label, children }]` — opt-in pages, after Use
  * @param {Object} [settings]   HubSettings' props
+ * @param {Object} [dev]        HubDev's props — AppHub's `dev`: a dev server's `code` page at `/dev`
  * @param {'mono'|'display'} [masthead='mono']
  * @param {Object} [shell]      any AppShell prop, spread last
  */
@@ -51,6 +52,7 @@ export default function AppStudio({
   use,
   pages = [],
   settings,
+  dev,
   walkthrough,
   shortcuts,
   themeToggle,
@@ -92,6 +94,7 @@ export default function AppStudio({
       home={home}
       walkthrough={walkthrough}
       settings={settings}
+      dev={dev}
       shortcuts={shortcuts}
       themeToggle={themeToggle}
       shortcutsKey={shortcutsKey}

package/src/HubDev.jsx

@@ -0,0 +1,45 @@
+import { useState } from 'react'
+import { PageHeader, TabsRow } from '@kolkrabbi/kol-component'
+import PageShell from './PageShell.jsx'
+
+/* taxonomy-ok: organism — nests PageShell (relative) + kol-component's PageHeader / TabsRow */
+
+const read = (key, fallback) => { try { return localStorage.getItem(key) ?? fallback } catch { return fallback } }
+const write = (key, value) => { try { localStorage.setItem(key, value) } catch { /* private mode: the tab just resets */ } }
+
+/**
+ * HubDev — A hub's development page. The one rail row for everything that is not the app yet: experiments,
+ * references, comparisons (CompareGridDevTab, kol-monitor 2026-10-17 — user: *"I would also maybe add
+ * instructions for making the dev tab to the hub … localhost only using the </> icon"*). Each app had built
+ * this page by hand and each read differently; this is the page made once, for reading.
+ *
+ * The shape: a small mono masthead with one line saying what the page is, the tabs on their own row under
+ * it, the active tab's one-line description, then the tab's content at full width. Detail belongs in the
+ * content's own toggles, not in more text here. The open tab is remembered per app.
+ *
+ * Rendered by `AppHub` / `AppStudio` from their `dev` prop, only on a dev server (`import.meta.env.DEV`),
+ * at `/dev`, behind the `code` rail row.
+ *
+ * @param {Array}  tabs        `[{ value, label, description?, content }]`
+ * @param {string} [title='Dev']
+ * @param {string} [subtitle]  one line: what the page is
+ * @param {string} [storageKey] where the open tab is remembered
+ */
+export default function HubDev({ tabs = [], title = 'Dev', subtitle = 'Experiments and reference, not the app', storageKey = 'kol-dev-tab' }) {
+  const [stored, setStored] = useState(() => read(storageKey, tabs[0]?.value))
+  const active = tabs.find((t) => t.value === stored) ?? tabs[0]
+  const pick = (v) => { setStored(v); write(storageKey, v) }
+
+  return (
+    <PageShell className="gap-6">
+      <PageHeader size="sm" voice="mono" title={title} subtitle={subtitle} />
+      {tabs.length > 1 && (
+        <div className="flex flex-col gap-2 border-b border-fg-08 pb-4">
+          <TabsRow look="text" tabs={tabs.map(({ value, label }) => ({ value, label }))} value={active?.value} onChange={pick} tracked />
+          {active?.description && <p className="kol-helper-12 text-meta">{active.description}</p>}
+        </div>
+      )}
+      {active && <div className="min-w-0">{active.content}</div>}
+    </PageShell>
+  )
+}

package/src/PhoneNav.jsx

@@ -1,5 +1,5 @@
 import { useEffect, useState } from 'react'
-import { Button, MobileTabBar } from '@kolkrabbi/kol-component'
+import { Button, TabsRow } from '@kolkrabbi/kol-component'
 
 /* taxonomy-ok: molecule — MobileTabBar + a More sheet of Buttons */
 
@@ -68,7 +68,9 @@ export default function PhoneNav({ items = [], currentPath = '/', onNavigate })
           ))}
         </div>
       )}
-      <MobileTabBar
+      <TabsRow
+        look="stacked"
+        placement="phone"
         tabs={tabs}
         value={value}
         onChange={(v) => (v === MORE ? setOpen((o) => !o) : onNavigate?.(v))}

package/src/TabStrip.jsx

@@ -1,34 +1,9 @@
+import { TabsRow } from '@kolkrabbi/kol-component'
+
 /**
- * TabStrip — A row of text tabs. the flat text-tab idiom both shells use twice (ContentFilters
- * view-mode/layout spans, Settings tabs): `kol-helper-14`, active
- * `text-fg-96`, rest `text-fg-32 hover:text-fg-48`.
- *
- * No auto-casing — labels render exactly as authored (the source repos'
- * `text-transform: uppercase` dropped per the DS law; author "GRID" if you
- * want GRID). `tracked` adds the 1px letter-spacing the view-mode strips
- * carried.
- *
- * SINGLE-SELECT ONLY. A `Set` form for multi-select was added 2026-08-15 so the
- * retired ContentFilters fork could render filter values through this — and
- * removed the same day with it. A multi-select, handler-carrying, active/rest
- * chip is a `Tag`; building a second one here under another name in another
- * package is exactly the duplication kol-shell exists to end.
- *
- * @param {Array} props.options  `[{ value, label }]`
+ * @deprecated 2026-10-17 — alias of kol-component's `TabsRow look="text"` (TabsStackedLayout: one tab component). Drops when nobody imports it (04-retirements.md).
+ * TabStrip — Old name for TabsRow's text look. Same props: `options` (`{ value, label }`) · `value` · `onChange` · `size` · `tracked` · `className` · `style`.
  */
-export default function TabStrip({ options = [], value, onChange, size = 14, tracked = false, className = 'gap-6', style }) {
-  return (
-    <div className={`flex items-center ${className}`.trim()} style={style}>
-      {options.map((opt) => (
-        <span
-          key={opt.value}
-          onClick={() => onChange?.(opt.value)}
-          className={`kol-helper-${size} cursor-pointer select-none ${value === opt.value ? 'text-fg-96' : 'text-fg-32 hover:text-fg-48'}`}
-          style={tracked ? { letterSpacing: 1 } : undefined}
-        >
-          {opt.label}
-        </span>
-      ))}
-    </div>
-  )
+export default function TabStrip({ options = [], className = 'gap-6', ...rest }) {
+  return <TabsRow look="text" tabs={options} className={className} {...rest} />
 }

package/src/index.js

@@ -26,7 +26,7 @@ export { default as TabStrip } from './TabStrip.jsx'
 export { default as SettingsScaffold } from './SettingsScaffold.jsx'
 export { default as WalkthroughPanel } from './WalkthroughPanel.jsx'
 /* lives in kol-component since 0.228.0 — re-exported so every kol-shell import keeps resolving */
-export { ShortcutsOverlay } from '@kolkrabbi/kol-component'
+export { ShortcutsOverlay, shortcutInScope } from '@kolkrabbi/kol-component'
 export { default as Logomark } from './Logomark.jsx'
 // the app tier, shipped once (ShellHomeSystem, kol-fxr 2026-08-27)
 export { default as CatalogPage } from './CatalogPage.jsx'
@@ -37,6 +37,7 @@ export { default as TouchDeviceOverlay, useTouchPrimary } from './TouchDeviceOve
 export { default as AppHub } from './AppHub.jsx'
 export { default as HubHome } from './HubHome.jsx'
 export { default as HubSettings } from './HubSettings.jsx'
+export { default as HubDev } from './HubDev.jsx'
 // the Studio — the Hub + Home · Library · Create · Use · pages · Settings, the workstation (apps review §6c, 2026-09-29)
 export { default as AppStudio } from './AppStudio.jsx'
 // a consumer slot in the opened rail — the page portals into it (NavRailConsumerSlot, kol-monitor 2026-10-15)