mnfst 0.5.38 → 0.5.40

package/dist/manifest.icons.js

@@ -91,6 +91,12 @@ function initializeIconPlugin() {
         const iconValue = expression;
         if (!iconValue) return;
 
+        // Prerender (or static HTML) already inlined an Iconify SVG; leave it alone. Otherwise Alpine
+        // evaluates stale expressions like `module.icon` from templating and throws ReferenceError.
+        if (el.querySelector('svg[data-icon]')) {
+            return;
+        }
+
         // Check if it's a raw icon name (should contain a colon for icon format like 'lucide:house')
         const isRawIconName = iconValue.includes(':') &&
             !iconValue.includes("'") &&

package/dist/manifest.router.js

@@ -394,8 +394,20 @@ window.ManifestRoutingNavigation = {
 
 // Router visibility
 
+function isPrerenderedStaticMPA() {
+    try {
+        return document.querySelector('meta[name="manifest:prerendered"][content="1"]') !== null;
+    } catch (e) {
+        return false;
+    }
+}
+
 // Process visibility for all elements with x-route
 function processRouteVisibility(normalizedPath) {
+    // Static prerender output already contains only this route's sections; x-cloak + toggling here
+    // causes a visible flash (content → hidden via x-cloak → shown when Alpine boots).
+    if (isPrerenderedStaticMPA()) return;
+
     const routeElements = document.querySelectorAll('[x-route]');
 
     // First pass: collect all defined routes (excluding !* and other negative conditions)
@@ -511,6 +523,7 @@ function processRouteVisibility(normalizedPath) {
 
 // Add x-cloak to route elements that don't have it
 function addXCloakToRouteElements() {
+    if (isPrerenderedStaticMPA()) return;
     const routeElements = document.querySelectorAll('[x-route]:not([x-cloak])');
     routeElements.forEach(element => {
         element.setAttribute('x-cloak', '');
@@ -529,11 +542,13 @@ function initializeVisibility() {
 
     // Listen for route changes
     window.addEventListener('manifest:route-change', (event) => {
+        if (isPrerenderedStaticMPA()) return;
         processRouteVisibility(event.detail.normalizedPath);
     });
 
     // Listen for component processing to ensure visibility is applied after components load
     window.addEventListener('manifest:components-processed', () => {
+        if (isPrerenderedStaticMPA()) return;
         // Add x-cloak to any new route elements
         addXCloakToRouteElements();
 
@@ -559,11 +574,23 @@ if (document.readyState === 'loading') {
 // Export visibility interface
 window.ManifestRoutingVisibility = {
     initialize: initializeVisibility,
-    processRouteVisibility
+    processRouteVisibility,
+    isPrerenderedStaticMPA
 }; 
 
 // Router head
 
+function isPrerenderedStaticMPA() {
+    try {
+        if (window.ManifestRoutingVisibility && typeof window.ManifestRoutingVisibility.isPrerenderedStaticMPA === 'function') {
+            return window.ManifestRoutingVisibility.isPrerenderedStaticMPA();
+        }
+        return document.querySelector('meta[name="manifest:prerendered"][content="1"]') !== null;
+    } catch (e) {
+        return false;
+    }
+}
+
 // Track injected head content to prevent duplicates
 const injectedHeadContent = new Set();
 
@@ -713,6 +740,7 @@ function processElementHeadContent(element, normalizedPath) {
 
 // Process all head content in the DOM
 function processAllHeadContent(normalizedPath) {
+    if (isPrerenderedStaticMPA()) return;
 
     // Find all elements with head templates
     const elementsWithHead = document.querySelectorAll('template[data-head]');
@@ -791,6 +819,7 @@ function initializeHeadContent() {
     function processHeadContentAfterComponentsReady() {
         // Process initial head content after a longer delay to let components settle
         setTimeout(() => {
+            if (isPrerenderedStaticMPA()) return;
             const currentPath = window.ManifestRoutingNavigation?.getCurrentRoute() ?? window.location.pathname;
             const normalizedPath = currentPath === '/' ? '/' : currentPath.replace(/^\/|\/$/g, '');
 
@@ -810,6 +839,7 @@ function initializeHeadContent() {
 
     // Function to process head content immediately (for projects without components)
     function processHeadContentImmediately() {
+        if (isPrerenderedStaticMPA()) return;
         const currentPath = window.ManifestRoutingNavigation?.getCurrentRoute() ?? window.location.pathname;
         const normalizedPath = currentPath === '/' ? '/' : currentPath.replace(/^\/|\/$/g, '');
         processAllHeadContent(normalizedPath);
@@ -843,6 +873,7 @@ function initializeHeadContent() {
 
         // Wait a bit for components to settle after route change
         setTimeout(() => {
+            if (isPrerenderedStaticMPA()) return;
             // Process head content immediately to catch components before they're reverted
             const currentPath = window.ManifestRoutingNavigation?.getCurrentRoute() ?? window.location.pathname;
             const normalizedPath = currentPath === '/' ? '/' : currentPath.replace(/^\/|\/$/g, '');

package/dist/manifest.utilities.js

@@ -411,9 +411,60 @@ function createVariantGroups() {
 
 /* Manifest Utilities */
 
+/** True when prerender wrote utilities to prerender.utilities.css — skip runtime #utility-styles generation. */
+function manifestPageUsesStaticPrerenderUtilities() {
+    if (typeof document === 'undefined') return false;
+    try {
+        if (!document.querySelector('meta[name="manifest:prerendered"][content="1"]')) return false;
+        for (const link of document.querySelectorAll('link[rel="stylesheet"][href]')) {
+            if ((link.getAttribute('href') || '').toLowerCase().includes('prerender.utilities.css')) {
+                return true;
+            }
+        }
+    } catch (e) {
+        return false;
+    }
+    return false;
+}
+
 // Browser runtime compiler
 class TailwindCompiler {
     constructor(options = {}) {
+        this.usesStaticPrerenderUtilities = manifestPageUsesStaticPrerenderUtilities();
+
+        // Prerender already emitted utility CSS; do not inject duplicate #utility-styles / observers.
+        if (this.usesStaticPrerenderUtilities) {
+            this.debug = options.debug === true;
+            this.startTime = performance.now();
+            this.options = {
+                rootSelector: options.rootSelector || ':root',
+                themeSelector: options.themeSelector || '@theme',
+                debounceTime: options.debounceTime || 50,
+                maxCacheAge: options.maxCacheAge || 24 * 60 * 60 * 1000,
+                debug: options.debug !== false,
+                ...options
+            };
+            this.criticalStyleElement = null;
+            this.styleElement = null;
+            this.tailwindLink = null;
+            this.observer = null;
+            this.isCompiling = false;
+            this.compileTimeout = null;
+            this.cache = new Map();
+            this.hasInitialized = true;
+            // manifest.code.js (and others) may still register ignore rules; mirror full constructor defaults.
+            this.ignoredClassPatterns = [
+                /^hljs/, /^language-/, /^copy$/, /^copied$/, /^lines$/, /^selected$/
+            ];
+            this.ignoredElementSelectors = [
+                'pre', 'code', 'x-code', 'x-code-group'
+            ];
+            this.significantChangeSelectors = [
+                '[data-component]', '[x-data]'
+            ];
+            return;
+        }
+
         this.debug = options.debug === true;
         this.startTime = performance.now();
 
@@ -559,6 +610,9 @@ class TailwindCompiler {
 
     // Public API for other plugins to configure behavior
     addIgnoredClassPattern(pattern) {
+        if (!Array.isArray(this.ignoredClassPatterns)) {
+            this.ignoredClassPatterns = [];
+        }
         if (pattern instanceof RegExp) {
             this.ignoredClassPatterns.push(pattern);
         } else if (typeof pattern === 'string') {
@@ -567,12 +621,18 @@ class TailwindCompiler {
     }
 
     addIgnoredElementSelector(selector) {
+        if (!Array.isArray(this.ignoredElementSelectors)) {
+            this.ignoredElementSelectors = [];
+        }
         if (typeof selector === 'string') {
             this.ignoredElementSelectors.push(selector);
         }
     }
 
     addSignificantChangeSelector(selector) {
+        if (!Array.isArray(this.significantChangeSelectors)) {
+            this.significantChangeSelectors = [];
+        }
         if (typeof selector === 'string') {
             this.significantChangeSelectors.push(selector);
         }
@@ -924,6 +984,7 @@ TailwindCompiler.prototype.addCriticalBlockingStylesSync = function () {
 
 // Generate synchronous utilities (fallback method)
 TailwindCompiler.prototype.generateSynchronousUtilities = function () {
+    if (this.usesStaticPrerenderUtilities) return;
     try {
         // Always try to generate, even if cache exists, to catch any new classes
         const hasExistingStyles = this.styleElement.textContent && this.styleElement.textContent.trim();
@@ -2975,6 +3036,8 @@ TailwindCompiler.prototype.filterCriticalUtilities = function(criticalText, laye
 
 // Main compilation method
 TailwindCompiler.prototype.compile = async function () {
+    if (this.usesStaticPrerenderUtilities) return;
+
     const compileStart = performance.now();
 
     try {
@@ -3311,6 +3374,7 @@ TailwindCompiler.prototype.setupComponentLoadListener = function () {
 
 // Start processing with initial compilation and observer setup
 TailwindCompiler.prototype.startProcessing = async function () {
+    if (this.usesStaticPrerenderUtilities) return;
     try {
         // Start initial compilation immediately
         const initialCompilation = this.compile();
@@ -3397,7 +3461,7 @@ if ('PerformanceObserver' in window) {
 
 // Also handle DOMContentLoaded for any elements that might be added later
 document.addEventListener('DOMContentLoaded', () => {
-    if (!compiler.isCompiling) {
+    if (!compiler.usesStaticPrerenderUtilities && !compiler.isCompiling) {
         compiler.compile();
     }
 });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "mnfst",
-    "version": "0.5.38",
+    "version": "0.5.40",
     "private": false,
     "workspaces": [
         "templates/starter",
@@ -62,4 +62,4 @@
     "bugs": {
         "url": "https://github.com/andrewmatlock/manifest/issues"
     }
-}
+}