@kolkrabbi/kol-shell 0.43.0 → 0.44.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.43.0",
+  "version": "0.44.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",
@@ -14,7 +14,7 @@
   "peerDependencies": {
     "@kolkrabbi/kol-component": ">=0.174.0",
     "@kolkrabbi/kol-icons": ">=0.16.0",
-    "@kolkrabbi/kol-theme": ">=0.135.0",
+    "@kolkrabbi/kol-theme": ">=0.136.0",
     "gsap": "^3.13.0",
     "react": "^18.3.0 || ^19.0.0",
     "react-dom": "^18.3.0 || ^19.0.0"
@@ -23,7 +23,7 @@
     "@kolkrabbi/kol-component": "^0.176.0",
     "@kolkrabbi/kol-framework": "^0.41.0",
     "@kolkrabbi/kol-icons": "^0.25.0",
-    "@kolkrabbi/kol-theme": "^0.135.0"
+    "@kolkrabbi/kol-theme": "^0.136.0"
   },
   "files": [
     "src",

package/src/CatalogPage.jsx

@@ -48,6 +48,8 @@ import WalkthroughPanel from './WalkthroughPanel.jsx'
  * @param {'bleed'|'capped'} width   the page's TIER, forwarded to PageShell (two-page-scaffolds-one-job, 2026-09-03):
  *                                 `bleed` (default) fills the window — the app tier; `capped` centres on the
  *                                 framework container — the site tier, so a brand book adopting this page keeps its geometry
+ * @param {ReactNode} trailingActions  the header's RIGHT slot (ContentFilters' — MediaLibrary's SELECT / FLAT); never empty beside the divider
+ * @param {number}    minColumn      the grid track's floor in px (default 160); a shelf of three decks passes 280 — the six-track ceiling still applies
  * @param {ElementType} iconComponent  icon renderer seam for ContentFilters
  * @param {boolean}  showCountOnlyWhenFiltering  (default true)
  * @param {Object}   filtersProps  spread onto ContentFilters last — e.g. `{ mutuallyExclusiveFilters: ['category', 'u_label'] }`
@@ -87,6 +89,13 @@ export default function CatalogPage({
   defaultLayout = 'grid',
   walkthrough,
   actions,
+  /* the header's RIGHT slot — where MediaLibrary puts SELECT / FLAT. CatalogPage
+     shipped with no way to fill it, so every catalog page rendered an empty slot
+     beside the divider (kol-client-olina 2026-09-03, on /slide-deck). */
+  trailingActions,
+  /* the grid track's floor. 160 is a 26-tile catalog's; a shelf of three decks
+     wants ~280 so the cards read at all. A ceiling of 6 tracks still applies. */
+  minColumn = 160,
   iconComponent,
   showCountOnlyWhenFiltering = true,
   filtersProps,
@@ -109,6 +118,7 @@ export default function CatalogPage({
           showCountOnlyWhenFiltering={showCountOnlyWhenFiltering}
           iconComponent={iconComponent}
           viewModeOptions={views}
+          trailingActions={trailingActions}
           viewMode={view}
           onViewModeChange={onViewChange}
           defaultViewMode={defaultView}
@@ -131,13 +141,13 @@ export default function CatalogPage({
               * six-column ruling — below the ceiling the hide-set is
               * desktop-only geometry. */
             return (
-            <div style={{ display: 'grid', gridTemplateColumns: layout === 'list' ? 'repeat(auto-fill, minmax(min(100%, max(240px, calc((100% - 3 * 8px) / 4))), 1fr))' : 'repeat(auto-fill, minmax(min(100%, max(160px, calc((100% - 5 * 24px) / 6))), 1fr))', gap: layout === 'list' ? 8 : 24 }}>
+            <div style={{ display: 'grid', gridTemplateColumns: layout === 'list' ? 'repeat(auto-fill, minmax(min(100%, max(240px, calc((100% - 3 * 8px) / 4))), 1fr))' : `repeat(auto-fill, minmax(min(100%, max(${minColumn}px, calc((100% - 5 * 24px) / 6))), 1fr))`, gap: layout === 'list' ? 8 : 24 }}>
               {rows.map((item, i) => {
                 if (hidden.has(i)) return null
                 const c = cards[i]
                 const key = c.key ?? item.key ?? item.id ?? item.name ?? i
                 return layout === 'list'
-                  ? <ContentRow key={key} variant="catalog" title={c.title} detail={c.detail} actions={c.actions} onClick={c.onClick} href={c.href} onNavigate={c.onNavigate} />
+                  ? <ContentRow key={key} variant="catalog" media={c.media} ratio={c.ratio} title={c.title} detail={c.detail} actions={c.actions} onClick={c.onClick} href={c.href} onNavigate={c.onNavigate} />
                   : <ContentCard key={key} variant="catalog" fit={c.fit ?? 'cover'} ratio={c.ratio} title={c.title} detail={c.detail} media={c.media} actions={c.actions} onClick={c.onClick} href={c.href} onNavigate={c.onNavigate} expanded={c.expanded} expandedContent={c.expandedContent} />
               })}
             </div>