@kolkrabbi/kol-shell 0.48.0 → 0.49.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-shell",
-  "version": "0.48.0",
+  "version": "0.49.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/CatalogPage.jsx

@@ -53,7 +53,8 @@ import WalkthroughPanel from './WalkthroughPanel.jsx'
  *                                 `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 {number}    minColumn      the grid track's floor in px (default 160) — a minimum, never a count
+ * @param {number}    maxColumns     the grid's ceiling (default 6, the ruling); a three-deck shelf passes 3 and the tracks share the width
  * @param {string}    cardVariant    the grid card's variant, per page (default `catalog`); `toCard` may return `variant` per card
  * @param {'catalog'|'file'} rowVariant  the list row (default `catalog`, the 36px no-thumb row); `file` = the 48px thumb row, for a catalog whose grid shows a cover —
  *                                 its slots (`date` · `size` · `meta` · `selected`) come from `toCard` like everything else
@@ -104,6 +105,10 @@ export default function CatalogPage({
   /* 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,
+  /* the ceiling — the six-column ruling is a MAXIMUM; a three-deck shelf says 3
+     (kol-client-olina 2026-09-03; user: "why are the cards so small? they could
+     use 2 columns each" — raising the floor to force it was backwards) */
+  maxColumns = 6,
   /* the LIST row's variant. `catalog` (default) is the 36px GridCard row — title
      and detail on one line, no thumb — which is what every app-tier list was
      ruled on (CatalogPageMonitorParity). A catalog whose grid shows a cover
@@ -142,12 +147,12 @@ export default function CatalogPage({
     observer.current?.disconnect()
     observer.current = null
     if (!el) return
-    const measure = (W) => setCols((c) => { const n = Math.max(1, Math.min(6, Math.floor((W + 24) / (minColumn + 24)))); return c === n ? c : n })
+    const measure = (W) => setCols((c) => { const n = Math.max(1, Math.min(maxColumns, Math.floor((W + 24) / (minColumn + 24)))); return c === n ? c : n })
     measure(el.getBoundingClientRect().width)
     const ro = new ResizeObserver(([entry]) => measure(entry.contentRect.width))
     ro.observe(el)
     observer.current = ro
-  }, [minColumn])
+  }, [minColumn, maxColumns])
 
   return (
     <PageShell width={width} className={className} style={{ overflow: 'hidden', '--kol-catalog-n': cols ?? undefined, ...style }}>