@very-simple/ajax 1.0.0-beta.6 → 1.0.0-beta.7

package/README.md

@@ -87,6 +87,19 @@ start({
 })
 ```
 
+`morphHeads`, `executeScripts` and `viewTransitions` also accept a callback
+receiving `{ from, to, isBackForward }` and returning a boolean. Combined with
+`data-ajax-state` this allows deciding per link, e.g. to skip morphing the
+`<head>` when loading a partial:
+
+```html
+<a href="/partial" data-ajax-state='{"isPartial": true}'>Partial</a>
+```
+
+```ts
+start({ morphHeads: ({ to }) => !to.state?.isPartial })
+```
+
 ### `visit(url, options?)`
 
 A lower-level API for triggering a visit programmatically, e.g. in

package/dist/index.d.ts

@@ -20,12 +20,12 @@ type MergeStrategy = 'replace' | 'morph' | 'before' | 'after' | 'prepend' | 'app
 interface Config {
     /** Strategy used to merge the swapped content into the current DOM. */
     merge?: MergeStrategy;
-    /** Morph the `<head>` instead of leaving it untouched. */
-    morphHeads?: boolean;
-    /** Re-execute `<script>` tags found in the swapped content. */
-    executeScripts?: boolean;
-    /** Wrap navigations in the View Transitions API, if supported. */
-    viewTransitions?: boolean;
+    /** Morph the `<head>` instead of leaving it untouched. A callback decides per visit. */
+    morphHeads?: Resolvable<boolean>;
+    /** Re-execute `<script>` tags found in the swapped content. A callback decides per visit. */
+    executeScripts?: Resolvable<boolean>;
+    /** Wrap navigations in the View Transitions API, if supported. A callback decides per visit. */
+    viewTransitions?: Resolvable<boolean>;
     /** Called instead of the default merge to render the new document. */
     render?: (newDocument: Document) => Promise<void> | void;
     /** Custom scroll handling, e.g. restoring position on back/forward visits. */
@@ -43,6 +43,12 @@ interface Config {
     /** Called before an element is removed from the DOM by a merge. */
     unmount?: (el: Element) => void;
 }
+/** A value, or a callback resolving it right before the swap. */
+type Resolvable<T> = T | ((info: {
+    from: PageState;
+    to: PageState;
+    isBackForward: boolean;
+}) => T);
 type ScrollPosition = {
     top: number;
 };
@@ -95,6 +101,6 @@ declare const scrollPositions: Map<string, ScrollPosition>;
  * Load a new page, merge the regions/bodies and add a new history entry
  * according to the history mode.
  */
-declare const visit: (url: string, { history: historyMode, isBackForward, autoFocus, request, state, regions, morphHeads, merge: mergeStrategy, executeScripts: shouldExecuteScripts, viewTransitions, loadingDelay, progressHideDelay, }?: VisitOptions) => Promise<void>;
+declare const visit: (url: string, { history: historyMode, isBackForward, autoFocus, request, state, regions, morphHeads, merge: mergeStrategy, executeScripts: executeScriptsOption, viewTransitions, loadingDelay, progressHideDelay, }?: VisitOptions) => Promise<void>;
 
-export { type AjaxState, type Config, type EventMap, type LoadingOptions, type MergeStrategy, type PageState, type ScrollBehavior, type ScrollPosition, type StartOptions, type VisitOptions, scrollPositions, start, visit };
+export { type AjaxState, type Config, type EventMap, type LoadingOptions, type MergeStrategy, type PageState, type Resolvable, type ScrollBehavior, type ScrollPosition, type StartOptions, type VisitOptions, scrollPositions, start, visit };

package/dist/index.js

@@ -231,7 +231,7 @@ var visit = async (url, {
   regions = config.regions,
   morphHeads = config.morphHeads,
   merge: mergeStrategy = config.merge,
-  executeScripts: shouldExecuteScripts = config.executeScripts,
+  executeScripts: executeScriptsOption = config.executeScripts,
   viewTransitions = config.viewTransitions,
   loadingDelay = config.loadingDelay,
   progressHideDelay = config.progressHideDelay
@@ -274,6 +274,10 @@ var visit = async (url, {
   const to = { url, state, document: newDocument };
   await emit2("before-swap", { from, to, isBackForward, signal });
   if (signal.aborted) return;
+  const resolve = (option) => typeof option === "function" ? option({ from, to, isBackForward }) : option;
+  const shouldMorphHeads = resolve(morphHeads);
+  const shouldExecuteScripts = resolve(executeScriptsOption);
+  const useViewTransitions = resolve(viewTransitions);
   const getMergeStrategy = (oldEl, newEl) => newEl.getAttribute(`${config.prefix}merge`) || oldEl.getAttribute(`${config.prefix}merge`) || mergeStrategy;
   let autoFocusEl;
   const hasMatchingRegions = regions?.some(
@@ -320,17 +324,17 @@ var visit = async (url, {
     if (position) window.scrollTo(position);
   };
   if (config.render) {
-    if (morphHeads) Idiomorph2.morph(document.head, newDocument.head);
+    if (shouldMorphHeads) Idiomorph2.morph(document.head, newDocument.head);
     await config.render(newDocument);
-  } else if (viewTransitions && document.startViewTransition) {
+  } else if (useViewTransitions && document.startViewTransition) {
     await document.startViewTransition(async () => {
-      if (morphHeads) Idiomorph2.morph(document.head, newDocument.head);
+      if (shouldMorphHeads) Idiomorph2.morph(document.head, newDocument.head);
       await mergeRegions();
       await emit2("after-swap", { from, to, isBackForward, signal });
       applyScrollBehavior();
     }).updateCallbackDone;
   } else {
-    if (morphHeads) Idiomorph2.morph(document.head, newDocument.head);
+    if (shouldMorphHeads) Idiomorph2.morph(document.head, newDocument.head);
     await mergeRegions();
     await emit2("after-swap", { from, to, isBackForward, signal });
     applyScrollBehavior();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@very-simple/ajax",
-  "version": "1.0.0-beta.6",
+  "version": "1.0.0-beta.7",
   "description": "A very simple turbolinks inspired ajax library",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",