@kolkrabbi/kol-framework 0.52.0 → 0.53.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-framework",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "description": "Site shell and page layout",
   "license": "MIT",
   "type": "module",
@@ -22,7 +22,7 @@
     "react-router-dom": "^6.0.0 || ^7.0.0"
   },
   "devDependencies": {
-    "@kolkrabbi/kol-component": "^0.283.0",
+    "@kolkrabbi/kol-component": "^0.284.0",
     "@kolkrabbi/kol-icons": "^0.41.0"
   },
   "files": [

package/src/loaderApp.js

@@ -2,13 +2,18 @@
  * hideLoaderApp — the app loader's other half (`loaderApp()` in `@kolkrabbi/kol-framework/vite` writes it into
  * index.html). Call it once React has committed: two frames later the loader fades (240 ms, none under reduced
  * motion — the CSS drops the transition) and leaves the DOM. Safe to call when there is no loader.
+ *
+ * `minMs` (default 600, LoaderAppMinimumTime — kol-monitor, user ruling 2026-10-22) holds the loader at least
+ * that long from navigation start, which is when the static loader first paints: a fast load flashed the mark
+ * for a blink, a slow one waits nothing extra. Reduced motion drops the fade, never the minimum. `minMs: 0` is
+ * the old behaviour.
  */
-export function hideLoaderApp() {
+export function hideLoaderApp({ minMs = 600 } = {}) {
   if (typeof document === 'undefined') return
   const el = document.getElementById('kol-loader-app')
   if (!el) return
-  requestAnimationFrame(() => requestAnimationFrame(() => {
+  setTimeout(() => requestAnimationFrame(() => requestAnimationFrame(() => {
     el.classList.add('is-done')
     setTimeout(() => { el.remove(); document.getElementById('kol-loader-app-css')?.remove() }, 300)
-  }))
+  })), Math.max(0, minMs - performance.now()))
 }

package/src/vite.js

@@ -34,7 +34,7 @@ export function devFavicon({ label = 'K', ground = '#7C5CFF', ink = '#FFFFFF' }
  * owned in DS and consumed by the fxr monitor and mirror? with custom graphic input as prop?"*). The app's mark
  * centred on the theme's ground, pulsing while the bundle downloads. It has to be static HTML in `index.html` —
  * a React component would only appear after the wait it covers — so this plugin writes it there: fxr's loader,
- * once, with the graphic as an option. Call `hideLoaderApp()` (kol-framework) after the first commit.
+ * once, with the graphic as an option. Call `hideLoaderApp()` (kol-framework) after the first commit — it holds the loader 600 ms from navigation start (`minMs`).
  *
  * Ground and ink follow the stored `data-theme`, else the system (run `THEME_BOOT_SCRIPT` before it, as every
  * KOL app does). Reduced motion: no pulse, no fade.