@vettvangur/vanilla 0.0.3 → 0.0.5

package/dist/index.esm.js

@@ -416,11 +416,42 @@ function onDomReady(moduleMap, initCoreScriptsCallback, callback = null) {
  */
 function onPopstate(moduleMap, initCoreScriptsCallback, callback = null) {
   window.addEventListener('popstate', e => {
-    initCoreScripts(initCoreScriptsCallback);
-    lazyModules(moduleMap);
-    if (callback) {
-      callback(e);
-    }
+    setTimeout(() => {
+      initCoreScripts(initCoreScriptsCallback);
+      lazyModules(moduleMap);
+      if (callback) {
+        callback(e);
+      }
+    }, 0);
+  });
+}
+
+/**
+ * Handles the "pageshow" event to initialize core scripts and lazy load modules.
+ *
+ * This function listens for the "pageshow" event—which fires when a page is loaded from the bfcache
+ * or initially loaded. After a short delay, it calls the provided core scripts initialization callback
+ * and lazy loads modules using the supplied module map. An optional callback is executed with the event object.
+ *
+ * @function onPageShow
+ * @param {Map} moduleMap - The compiled module map for lazy loading.
+ * @param {Function} initCoreScriptsCallback - The callback function used to initialize core scripts.
+ * @param {Function} [callback] - An optional callback to execute during event handling.
+ *
+ * @example
+ * onPageShow(moduleMap, () => { console.log('Core scripts initialized'); }, (e) => {
+ *   console.log('Pageshow event triggered', e);
+ * });
+ */
+function onPageShow(moduleMap, initCoreScriptsCallback, callback = null) {
+  window.addEventListener('pageshow', e => {
+    setTimeout(() => {
+      initCoreScripts(initCoreScriptsCallback);
+      lazyModules(moduleMap);
+      if (callback) {
+        callback(e);
+      }
+    }, 0);
   });
 }
 
@@ -584,4 +615,4 @@ function clickOutside(callback) {
   });
 }
 
-export { capitalize, clickOutside, createModuleMap, dictionary, fetcher, flatten, getTemplate, initCoreScripts, isEmpty, lazyModules, loadEnvFiles, onDomReady, onHtmxAfterSettle, onHtmxAfterSwap, onHtmxBeforeSwap, onPopstate, preloadTimeout, regexr };
+export { capitalize, clickOutside, createModuleMap, dictionary, fetcher, flatten, getTemplate, initCoreScripts, isEmpty, lazyModules, loadEnvFiles, onDomReady, onHtmxAfterSettle, onHtmxAfterSwap, onHtmxBeforeSwap, onPageShow, onPopstate, preloadTimeout, regexr };

package/dist/types/index.d.ts

@@ -163,6 +163,24 @@ export function onDomReady(moduleMap: Map<any, any>, initCoreScriptsCallback: Fu
  * onPopstate(moduleMap, () => { console.log('Core scripts initialized'); }, () => { console.log('Popstate event triggered'); });
  */
 export function onPopstate(moduleMap: Map<any, any>, initCoreScriptsCallback: Function, callback?: Function): void;
+/**
+ * Handles the "pageshow" event to initialize core scripts and lazy load modules.
+ *
+ * This function listens for the "pageshow" event—which fires when a page is loaded from the bfcache
+ * or initially loaded. After a short delay, it calls the provided core scripts initialization callback
+ * and lazy loads modules using the supplied module map. An optional callback is executed with the event object.
+ *
+ * @function onPageShow
+ * @param {Map} moduleMap - The compiled module map for lazy loading.
+ * @param {Function} initCoreScriptsCallback - The callback function used to initialize core scripts.
+ * @param {Function} [callback] - An optional callback to execute during event handling.
+ *
+ * @example
+ * onPageShow(moduleMap, () => { console.log('Core scripts initialized'); }, (e) => {
+ *   console.log('Pageshow event triggered', e);
+ * });
+ */
+export function onPageShow(moduleMap: Map<any, any>, initCoreScriptsCallback: Function, callback?: Function): void;
 /**
  * Handles the `htmx:beforeSwap` event to perform actions before HTMX swaps.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vettvangur/vanilla",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Vettvangur | Vanilla JS Utility Library",
   "access": "private",
   "type": "module",