@kolkrabbi/kol-framework 0.40.0 → 0.41.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-framework",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "KOL app shell — sidenav, layout, theme toggle, footer, heroes + brand color layer. SideNav takes nav data as props so the tree stays app-local.",
   "license": "MIT",
   "type": "module",

package/src/PageLayout.jsx

@@ -15,9 +15,11 @@ export const ShellTocContext = createContext(null)
  * useLayoutEffect(() => { setTocCollapsed(true); return () => setTocCollapsed(false) }, [setTocCollapsed]) */
 export const ShellTocCollapsedContext = createContext(null)
 
-/* `getActivePage` — ACCEPTED-but-inert since the 2026-08-09 SideNav port (the
- * two-level elder model derives the active category from the route); kept so
- * no call site breaks. */
+/* `getActivePage` — inert since the 2026-08-09 SideNav port (the two-level
+ * elder model derives the active category from the route). No longer
+ * destructured: a prop nobody reads is not part of the signature (props gate
+ * P2), and an unknown prop on a component is simply ignored, so no call site
+ * breaks. */
 /* `sideNav` — every SideNav prop AppShell does not own, spread onto the rail
  * (sidenav-rail-hairline, 2026-08-26): `background`, `hairline`, `isActive`,
  * `onNavigate` … the next rail option needs no AppShell release. */
@@ -49,7 +51,6 @@ export const ShellTocCollapsedContext = createContext(null)
  * one component takes one model, and kol-studio passes its wash.
  *
  * @param {Array}     navTree            the sidenav's tree (see SideNav)
- * @param {Function}  getActivePage      accepted, inert since 2026-08-09
  * @param {ReactNode} header             above the outlet on the plane
  * @param {ReactNode} footer             below the outlet on the plane
  * @param {ReactNode} defaultTocContent  the TOC rail's content when no page registers one
@@ -57,7 +58,7 @@ export const ShellTocCollapsedContext = createContext(null)
  * @param {string}    pageWash           the plane's wash, a CSS colour (e.g. `'var(--kol-fg-02)'`)
  * @param {boolean}   bare               plane + outlet only (default false)
  */
-export default function PageLayout({ navTree = [], getActivePage: _getActivePage, header, footer, defaultTocContent, sideNav, pageWash, bare = false }) {
+export default function PageLayout({ navTree = [], header, footer, defaultTocContent, sideNav, pageWash, bare = false }) {
   const [drawerOpen, setDrawerOpen] = useState(false)
   const [tocContent, setTocContent] = useState(null)
   const [tocCollapsed, setTocCollapsed] = useState(false)
@@ -75,11 +76,19 @@ export default function PageLayout({ navTree = [], getActivePage: _getActivePage
   const effectiveTocContent = tocContent ?? defaultTocContent
   const showToc = Boolean(effectiveTocContent) && !tocCollapsed
 
-  /* the plane paints the wash; the var lives on the plane so any child that
-     reads it resolves the same value (BrandLayout, verbatim) */
+  /* ONE OWNER PER PIXEL (two-page-scaffolds-one-job, kol-client-olina
+   * 2026-09-03). The plane paints the wash and hands `--kol-shell-page-wash:
+   * transparent` down: the variable means WHAT IS LEFT TO PAINT, so a
+   * PageShell — or any page root that reads it — inside this frame paints
+   * nothing over the plane. BrandLayout's line set the wash on the plane AND
+   * painted it, so a nested PageShell painted it again: `fg-02` rendered as two
+   * 0.02 layers, measured on olina's /slide-deck, the one page beside twenty
+   * `.kol-page` siblings that came out darker. kol-shell's AppShell keeps its
+   * own model (the wrapper paints the back, PageShell paints the wash — one
+   * paint there too). */
   const plane = {
-    '--kol-shell-page-wash': pageWash,
-    background: 'var(--kol-shell-page-wash, var(--kol-surface-primary))',
+    background: pageWash ?? 'var(--kol-surface-primary)',
+    '--kol-shell-page-wash': 'transparent',
   }
 
   if (bare) {