mnfst 0.5.251 → 0.5.253

package/lib/manifest.appwrite.data.js

@@ -2,7 +2,7 @@
 
 (function () {
 
-const MANIFEST_BUILD_VERSION = '0.5.251';
+const MANIFEST_BUILD_VERSION = '0.5.253';
 
 /* Manifest Data Sources - Appwrite Integration */
 

package/lib/manifest.d.ts

@@ -657,6 +657,15 @@ declare global {
         };
         Alpine?: unknown;
         __manifestLoaded?: unknown;
+        /** Pending work that will still change the page; mnfst-render's auto settle won't snapshot early while count > 0. */
+        ManifestPending?: {
+            /** Hold until the work's DOM update lands; call the returned function to release. */
+            hold(label?: string): () => void;
+            readonly count: number;
+            labels(): string[];
+            /** Mark a timer callback as housekeeping that never changes the page (auto settle ignores it). */
+            background<T extends Function>(fn: T): T;
+        };
         /** Rich text engine (rich-text plugin). */
         ManifestRichText?: {
             attach(el: Element, options?: ManifestRichTextAttachOptions): ManifestRichTextHandle | null;

package/lib/manifest.data.js

@@ -2,7 +2,7 @@
 
 (function () {
 
-const MANIFEST_BUILD_VERSION = '0.5.251';
+const MANIFEST_BUILD_VERSION = '0.5.253';
 
 /* Manifest Data Sources - Configuration */
 
@@ -1134,10 +1134,11 @@ function setupTeamChangeListener() {
             lastTeamId = authStore.currentTeam?.$id || null;
             if (!teamCheckIntervalId) {
                 // Poll every 2s to limit CPU wakeups; team changes are rare
-                teamCheckIntervalId = setInterval(checkTeamChange, 2000);
+                teamCheckIntervalId = setInterval(window.ManifestPending?.background?.(checkTeamChange) ?? checkTeamChange, 2000);
             }
         } else {
-            setTimeout(startPolling, 100);
+            // Waits for an auth plugin that may never load: housekeeping, not page work
+            setTimeout(window.ManifestPending?.background?.(startPolling) ?? startPolling, 100);
         }
     };
 
@@ -9479,7 +9480,8 @@ function registerXMagicMethod(loadDataSource) {
                                 : (typeof Alpine !== 'undefined' && Alpine.store('locale')?.current) || 'en';
                             pendingLoads.set(prop, Promise.resolve(loadDataSource(prop, locale)));
                             pendingLoads.get(prop).finally(() => {
-                                setTimeout(() => pendingLoads.delete(prop), 1000);
+                                const clear = () => pendingLoads.delete(prop);
+                                setTimeout(window.ManifestPending?.background?.(clear) ?? clear, 1000);
                             });
                         }
                         track();
@@ -9904,9 +9906,8 @@ function registerXMagicMethod(loadDataSource) {
                                     }
                                 }
                                 // Only clear pendingLoads after a delay to prevent rapid retries
-                                setTimeout(() => {
-                                    pendingLoads.delete(prop);
-                                }, 1000);
+                                const clear = () => { pendingLoads.delete(prop); };
+                                setTimeout(window.ManifestPending?.background?.(clear) ?? clear, 1000);
                             });
 
                             activeProps.delete(propKey); // Remove from active set before returning

package/lib/manifest.defer.js

@@ -470,7 +470,9 @@ function markReady() {
     if (ready) return;
     ready = true;
     schedule();
-    setTimeout(() => { bootDrained = true; }, 5000); // lazy components may keep the boot queue busy
+    // lazy components may keep the boot queue busy; only gates gesture promotion, so not page work
+    const drained = () => { bootDrained = true; };
+    setTimeout(window.ManifestPending?.background?.(drained) ?? drained, 5000);
 }
 
 function armReady() {
@@ -548,7 +550,8 @@ if (window.Alpine && typeof window.Alpine.interceptInit === 'function') {
             ensureDeferPluginInitialized();
         }
     }, 10);
-    setTimeout(() => clearInterval(checkAlpine), 5000);
+    const giveUp = () => clearInterval(checkAlpine);
+    setTimeout(window.ManifestPending?.background?.(giveUp) ?? giveUp, 5000);
 }
 
 })();

package/lib/manifest.device.js

@@ -449,6 +449,15 @@ const MANIFEST_BIOMETRIC_PLUGINS = ['BiometricAuthNative', 'BiometricAuth', 'Nat
 // Native only: bundled web builds expose plugin web stubs that always "verify".
 function manifestBiometricPlugin() {
     if (!manifestNativeIsNative()) return null;
+    // Prefer one in the native header list; without a list, first registered
+    const headers = window.Capacitor && window.Capacitor.PluginHeaders;
+    if (Array.isArray(headers)) {
+        for (const name of MANIFEST_BIOMETRIC_PLUGINS) {
+            const plugin = manifestNativePlugin(name);
+            if (plugin && headers.some(h => h && h.name === name)) return { name, plugin };
+        }
+        return null;
+    }
     for (const name of MANIFEST_BIOMETRIC_PLUGINS) {
         const plugin = manifestNativePlugin(name);
         if (plugin) return { name, plugin };

package/lib/manifest.integrity.json

@@ -1,6 +1,6 @@
 {
   "manifest.appwrite.auth.js": "sha384-dsIWnH0qCAGSzAXMGrd8fvOrVl4tOIE6j5tC35JPTrQXZ56qLD36ARyvhR7vi3Id",
-  "manifest.appwrite.data.js": "sha384-ctnqsfCC4EDugNArRonGeZMTQn2iwksugU0309QM6l0uh6JJZOaU/Gsvvp8JrmZ3",
+  "manifest.appwrite.data.js": "sha384-xxVLbIAAzMs+ksXTzRGtu0GxALohKKkFRXsvLyp6BvZesTk/JsS0lscvkIcOyGO1",
   "manifest.appwrite.presences.js": "sha384-JyVDWFT69b7Svq8J8p9tNWe2v9PZNQBY5UyhtOl1vnuHFAX0CRQ3MA9SiKq5wzNh",
   "manifest.bindings.js": "sha384-lPtMf8Ykaic9gNVZKq8Scia1881ZeMAyxer3WCIkUNwwrgzGBWto1OXADUwjvORF",
   "manifest.charts.js": "sha384-G+huD7UvjF9zDovdVVlh4I5X1Mq4oNnJfoFg4NnGdP3R/4Skq9hy5cGuHNYLxDYm",
@@ -11,30 +11,30 @@
   "manifest.combobox.js": "sha384-MILTkrgsTzsYUjGo4ZuADqV85Xs4GmfB4xexfe9vbJMIoQTZ42W4zs+DTaVSPEsx",
   "manifest.components.js": "sha384-BUFA8h+G5Plr82sV7bKzO42pPoiRZwRQcKj1lt2ROFiKjjlkayU/vmkAFqEsdBA+",
   "manifest.computed.js": "sha384-GYML/e81gQfN+iDbqhPUgny8bINCyL+SrbTofoGk4hlCnLLjv51mCv42JMqq+ku5",
-  "manifest.data.js": "sha384-ryR3dpYNybgJ8GONlEhkB0myOYz7fhGdnjEpXvKXcCQJUjZQaZbX7J8caPWv7UsN",
+  "manifest.data.js": "sha384-apX4l/k05t8snFyKYLbMbN+kG6xjHHI8gbs32376S3WruzynLOaF+uq43cCGfifp",
   "manifest.datepicker.js": "sha384-2XwFFnS4Bg5FDvG/v8x6KUvrjcBQEOYyTxynX2K/D/Qb3PI6+Y04lEwCnVDJLzwL",
-  "manifest.defer.js": "sha384-pMRGqQKiEoJhpUcD40QeM4jEHau7sz9Xn/YCpiUamT1T4xJBZDSiYX+xnVrSWoq+",
-  "manifest.device.js": "sha384-cm59lFxLFOu+DzQGkTUax0lfjZIeEz21vnk26c6nN0+/7irQwzVGt9u545BQjgzM",
+  "manifest.defer.js": "sha384-GK9qJkYtchtyzSQ+3zmDQUJE3+au4qthT2M8JnFjXxgfwCH5IVKc2r3tackgMryU",
+  "manifest.device.js": "sha384-jY+Xjt/v4I7SWTFzIGdPRJRTl634i6pj5T6jQaEn9keNTccPGD9lAIbYWq4J8oc7",
   "manifest.dropdowns.js": "sha384-acufUps7R9WjqB4XXW5JLACqniuHJGM4CNTb2rF4B2Q/jv7ZRmsAwfr2McanOz3s",
   "manifest.edit.js": "sha384-MOgQNdNLeHijhR0u2W6ntoOulKFglsATCFDqkinesOU15tHoILk/JNzHKkGi5dUG",
   "manifest.export.js": "sha384-Rx6XvqBZc4apzP/FwcDr6yIln4/zNa08Q4ZqBZcEqUz1aNZQfl4h0+Ae7mqCQyuG",
   "manifest.icons.js": "sha384-kKOINpX70YzNO3FvkV6umrmO3f0KIu0DNbwB+ej55a7y/lhU7v/myQtXL0bwCTbt",
   "manifest.localization.js": "sha384-EImsIw8Z3l13V5eH9ZJF/yfsOfIvR1oPRNSArANkPji7V8O3IRf6zMwsNiAGj3Hk",
   "manifest.markdown.js": "sha384-heyDR40LXHaAmAuA+fa381uFwShk1oAqpFFY6E2Qq4T3VN0TQfRqyc++MF40K5Hj",
-  "manifest.native.js": "sha384-cm59lFxLFOu+DzQGkTUax0lfjZIeEz21vnk26c6nN0+/7irQwzVGt9u545BQjgzM",
+  "manifest.native.js": "sha384-jY+Xjt/v4I7SWTFzIGdPRJRTl634i6pj5T6jQaEn9keNTccPGD9lAIbYWq4J8oc7",
   "manifest.payments.js": "sha384-8pofk2zhxtapPMpwnFyTelPMrYhShNhDCE722uQh/EYFvZFuPLmSdgunqsarVQjv",
   "manifest.rich.text.js": "sha384-ZBV9jXmu2nmprEHicddRE/m7nR4RPZtVc969Jte0+EJYBcVph7itkjcgN/61PyeC",
-  "manifest.router.js": "sha384-JcKnEb0E9azl6DVSN1DQMysyZOpGkskSQREjD947sMEs87nFEeZpCigB0iq8psz5",
+  "manifest.router.js": "sha384-9LMIkwrgnxmmFDv70TND2MRJF1z6Nl4yqG7fH5DbJ8oUIhdu/u4yUPSime1/EYhP",
   "manifest.slides.js": "sha384-3uRTkyK9XPLmnxI2+igZlpi4EyPlU/7IHj5j3BZJJ2KN455vXyk99fiXV3feO/XY",
   "manifest.status.js": "sha384-MBO345ab7H6Uq1X2dZLt4Ge1Gcra+Z2qYApvlAeIV8CJhDDJrz2FPXpp+Kcp8zcM",
   "manifest.svg.js": "sha384-qr/8H9+2cIhSXNbRWRtIdrDlTOxKlNJqwEefHvCYoiBNW/kKhPTFa109Orv/EBnb",
-  "manifest.sw.js": "sha384-9+0Y6SDUeQcjS5w5yr2OjMbyuM2uc3U4htcj+f+GUHBFL4X7zxm4u7fekQwAzyxI",
-  "manifest.tabs.js": "sha384-OIIcyaQnGS0eNYk4zgAFEDboNYect7THvUd9D0V6nqCeDOxQcoiqLrBEmmWVTTet",
+  "manifest.sw.js": "sha384-9Kcczuh7GSCImjjTu09aZ0C/EaVHItZ0McwTdNqv1ZCWZe0UfUn9+IYX3ISYE0kk",
+  "manifest.tabs.js": "sha384-otU09H7jnawVKQdLAYpMCd3jx00tgyPVr42D2hLIBzN5dG4se505YesavdnMqEi1",
   "manifest.tailwind.js": "sha384-r/Jvqb+Piz21jUts10BbVAJoKkShOdJRVFpywyi4HPIi/OfOJq5CtPyWAPbdkMgt",
   "manifest.toasts.js": "sha384-3zkWxzw693pxg3QDFsoYCA3CqYaLKmBaMArULXODD66Utolpewl0OAeTB92aWUVv",
   "manifest.tooltips.js": "sha384-4b24PH5WsfFsewGea5SMWLwmrhC4kD6eDP/vvjNyjXYnQXXFGi4nLdojrIOwzG8M",
   "manifest.url.parameters.js": "sha384-J2aSVBOPsoqsbafHndrWLHEDpKb4AKJAoQnVmKA4gZh5P/8HHjFWHO/lkusmG84l",
-  "manifest.utilities.js": "sha384-L5uXMLFBIF6LUM1haRjd4eGjHSWuqsCYSpPZRPYosNfJsMC5U5TnmjBxIhrZRe2d",
+  "manifest.utilities.js": "sha384-h17EquaRtNcEW0yfhk7R+a+2+CzTlBxPuFryO6i9NV/OiIRMihREoyzQ77QawoQ7",
   "manifest.virtual.js": "sha384-ZDNoF9QVhVcVpkjIK6NH15S6I5c6OBshiJpXSOYjNsIB+298I0a7g3aFO+jyq4Vb",
-  "manifest.js": "sha384-lLuq+77pwlGNK01XTOSimDh8boFBUmKQA8rR53QudXl/Igiv8MU4w+wRCSHdc/mg"
+  "manifest.js": "sha384-OmHDWM4X9puYLwv9Y0Hqnymh80AESBTsXrMYcksqduBCCRkolnxjRlIbCOU5pjvk"
 }

package/lib/manifest.js

@@ -11,6 +11,33 @@
 
 	const loaderScript = document.currentScript;
 
+	// Pending work that will still change the page: plugins hold() until their DOM update lands; mnfst-render's auto settle won't snapshot early while count > 0
+	if (!window.ManifestPending) {
+		const holds = new Map();
+		let seq = 0;
+		window.ManifestPending = {
+			hold(label = 'work') {
+				const id = ++seq;
+				holds.set(id, label);
+				return () => { holds.delete(id); };
+			},
+			get count() {
+				return holds.size + (window.__manifestMarkdownPending || 0) + (window.__manifestUtilitiesPending || 0);
+			},
+			labels() {
+				const out = [...holds.values()];
+				if (window.__manifestMarkdownPending > 0) out.push('markdown');
+				if (window.__manifestUtilitiesPending > 0) out.push('utilities');
+				return out;
+			},
+			// Marks a timer callback as housekeeping that never changes the page; prerender doesn't wait for it
+			background(fn) {
+				if (typeof fn === 'function') fn.__manifestBackground = true;
+				return fn;
+			},
+		};
+	}
+
 	/*
 	 * Hydration contract runtime: prerendered MPA pages carry a `#__manifest_hydrate__`
 	 * diff of source-authored attributes (and data-hydrate innerHTML). Applied once
@@ -1252,6 +1279,7 @@
 		function startReadyCoordinator(plugins, tailwindEnabled) {
 			if (window.__manifestReadyCoordinator) return;
 			window.__manifestReadyCoordinator = true;
+			const release = window.ManifestPending.hold('ready');
 			const needData = plugins.some(p => p === 'data' || p === 'appwrite-data');
 			const needUtilities = !!tailwindEnabled;
 			const state = {
@@ -1265,6 +1293,7 @@
 			const fire = () => {
 				if (fired) return;
 				fired = true;
+				release();
 				window.__manifestReady = true;
 				window.dispatchEvent(new CustomEvent('manifest:ready'));
 			};

package/lib/manifest.native.js

@@ -449,6 +449,15 @@ const MANIFEST_BIOMETRIC_PLUGINS = ['BiometricAuthNative', 'BiometricAuth', 'Nat
 // Native only: bundled web builds expose plugin web stubs that always "verify".
 function manifestBiometricPlugin() {
     if (!manifestNativeIsNative()) return null;
+    // Prefer one in the native header list; without a list, first registered
+    const headers = window.Capacitor && window.Capacitor.PluginHeaders;
+    if (Array.isArray(headers)) {
+        for (const name of MANIFEST_BIOMETRIC_PLUGINS) {
+            const plugin = manifestNativePlugin(name);
+            if (plugin && headers.some(h => h && h.name === name)) return { name, plugin };
+        }
+        return null;
+    }
     for (const name of MANIFEST_BIOMETRIC_PLUGINS) {
         const plugin = manifestNativePlugin(name);
         if (plugin) return { name, plugin };

package/lib/manifest.router.js

@@ -1396,7 +1396,8 @@ function initializeAnchors() {
                 if (anchors.length > 0) {
                     updateAnchors(anchors);
                     return true;
-                } else if (attempt < maxAttempts) {
+                } else if (attempt < maxAttempts && window.__manifestRenderSettle !== 'auto') {
+                    // mnfst-render's auto settle re-extracts anchors once content settles; no need to poll for it
                     setTimeout(() => {
                         attemptExtraction(attempt + 1, maxAttempts);
                     }, attempt * 200); // Progressive delay: 200ms, 400ms, 600ms, etc.
@@ -1465,7 +1466,8 @@ window.addEventListener('manifest:route-change', () => {
             t = setTimeout(finish, 50);
         });
         observer.observe(container, { childList: true, subtree: true });
-        const fallback = setTimeout(finish, 800);
+        // Under mnfst-render's auto settle the engine re-extracts anchors from settled content: don't hold it
+        const fallback = setTimeout(window.__manifestRenderSettle === 'auto' ? (window.ManifestPending?.background?.(finish) ?? finish) : finish, 800);
     };
 
     requestAnimationFrame(() => {

package/lib/manifest.schema.json

@@ -684,8 +684,20 @@
                 },
                 "incremental": {
                     "type": "boolean",
-                    "default": false,
-                    "description": "Skip re-rendering routes whose fingerprinted inputs are unchanged since the last successful run (ledger in .mnfst-cache/routes.json). Anything uncertain renders. Once a ledger exists, every full render refreshes it (participation); explicit false turns capture and recording fully off."
+                    "default": true,
+                    "description": "Skip re-rendering routes whose fingerprinted inputs are unchanged since the last successful run (ledger in .mnfst-cache/routes.json). On by default; anything uncertain renders, and every route re-renders at least weekly. --no-incremental renders everything but still records; false turns capture and recording fully off."
+                },
+                "waitAfterIdle": {
+                    "type": "number",
+                    "minimum": 0,
+                    "default": 0,
+                    "description": "Extra milliseconds after a page settles, before its og image and snapshot — for widgets that fill in late without network or DOM activity. --wait-after-idle overrides."
+                },
+                "settle": {
+                    "type": "string",
+                    "enum": ["fixed", "auto"],
+                    "default": "fixed",
+                    "description": "How a page counts as settled before its snapshot. fixed (default): network idle, then DOM quiet (about 2 seconds per page). auto (opt-in, faster): snapshots early when no request, timer, interval, scheduled task, animation, idle callback, stream, socket, worker, service-worker install, cross-origin frame, recent message-channel activity, data load or framework hold is pending; otherwise it uses the fixed waits. Pages whose scripts use other schedulers should stay on fixed. Use waitAfterIdle for content a script adds after a longer timer. --settle overrides."
                 },
                 "blockRequests": {
                     "type": "array",

package/lib/manifest.sw.js

@@ -16,7 +16,7 @@
 
 // Build stamps the published version here; unstamped (dev) falls back to the
 // registration URL's `v`, then 'dev'.
-const BUILD_VERSION = '0.5.251';
+const BUILD_VERSION = '0.5.253';
 const CACHE_PREFIX = 'mnfst-sw:';
 const META_CACHE = CACHE_PREFIX + 'meta';
 // Sized to hold a full precache.json warm-up (PRECACHE_MAX_ENTRIES server-side)

package/lib/manifest.tabs.js

@@ -348,10 +348,10 @@ function initializeTabsPlugin() {
         }
     }
 
-    // Add a fallback timer to catch cases where events don't fire
+    // Add a fallback timer to catch cases where events don't fire (mnfst-render auto settle: soon, so it waits for it)
     setTimeout(() => {
         processTabsWhenReady();
-    }, 2000);
+    }, window.__manifestRenderSettle === 'auto' ? 200 : 2000);
 }
 
 // Track initialization to prevent duplicates

package/lib/manifest.utilities.js

@@ -3226,7 +3226,7 @@ TailwindCompiler.prototype.compileDelta = function (themeCss) {
 // Coalesce cache writes: localStorage serialisation is too slow to run per compile
 TailwindCompiler.prototype.schedulePersistentSave = function (themeCss) {
     clearTimeout(this._persistTimer);
-    this._persistTimer = setTimeout(() => {
+    const save = () => {
         if (!this._applied) return;
         const classesHash = Array.from(this.dynamicClassCache).sort().join(',');
         const themeHash = this.generateThemeHash(themeCss);
@@ -3236,7 +3236,8 @@ TailwindCompiler.prototype.schedulePersistentSave = function (themeCss) {
             themeHash
         });
         this.savePersistentCache();
-    }, 1000);
+    };
+    this._persistTimer = setTimeout(window.ManifestPending?.background?.(save) ?? save, 1000);
 };
 
 // Helper function to filter critical utilities that are already in layer utilities

package/lib/manifest.utilities.node.mjs

@@ -2660,7 +2660,7 @@ TailwindCompiler.prototype.compileDelta = function (themeCss) {
 // Coalesce cache writes: localStorage serialisation is too slow to run per compile
 TailwindCompiler.prototype.schedulePersistentSave = function (themeCss) {
     clearTimeout(this._persistTimer);
-    this._persistTimer = setTimeout(() => {
+    const save = () => {
         if (!this._applied) return;
         const classesHash = Array.from(this.dynamicClassCache).sort().join(',');
         const themeHash = this.generateThemeHash(themeCss);
@@ -2670,7 +2670,8 @@ TailwindCompiler.prototype.schedulePersistentSave = function (themeCss) {
             themeHash
         });
         this.savePersistentCache();
-    }, 1000);
+    };
+    this._persistTimer = setTimeout(window.ManifestPending?.background?.(save) ?? save, 1000);
 };
 
 // Helper function to filter critical utilities that are already in layer utilities

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mnfst",
-    "version": "0.5.251",
+    "version": "0.5.253",
     "private": false,
     "workspaces": [
         "templates/starter",
@@ -46,6 +46,7 @@
         "test:e2e": "node tests/e2e/payments.e2e.mjs",
         "test:e2e:sdk": "node tests/e2e/payments.sdk.e2e.mjs",
         "test:e2e:sw": "node tests/e2e/sw.e2e.mjs",
+        "test:e2e:settle": "node tests/e2e/render-settle.e2e.mjs",
         "lint": "echo 'No linting configured'",
         "release:docs": "node scripts/release-bump.mjs packages/docs && cd packages/docs && npm publish --auth-type=web",
         "release:check": "node scripts/release-check.mjs"