unpoly-rails 3.14.2 → 3.15.0

data/assets/unpoly/unpoly-migrate.js

@@ -6,11 +6,21 @@
 
 const u = up.util;
 up.migrate = (function () {
-    const config = new up.Config(() => ({
-        logLevel: 'warn'
+    const config = new up.Config('up.migrate.config', () => ({
+        logLevel: 'error'
     }));
-    function renamedProperty(object, oldKey, newKey, customWarning) {
-        const doWarn = u.memoize(() => customWarning ? warn(customWarning) : warn('Property { %s } has been renamed to { %s } (found in %o)', oldKey, newKey, object));
+    function renamedProperty(object, oldKey, newKey, { label, warning } = {}) {
+        const doWarn = u.memoize(function () {
+            if (warning) {
+                warn(warning);
+            }
+            else if (label) {
+                warn('Property %s.%s has been renamed to %s.%s', label, oldKey, label, newKey);
+            }
+            else {
+                warn('Property { %s } has been renamed to { %s } (found in %o)', oldKey, newKey, object);
+            }
+        });
         Object.defineProperty(object, oldKey, {
             configurable: true,
             get() {
@@ -23,11 +33,23 @@ up.migrate = (function () {
             }
         });
     }
-    function removedProperty(object, key, customWarning) {
-        const doWarn = u.memoize(() => customWarning ? warn(customWarning) : warn('Property { %s } has been removed without replacement (found in %o)', key, object));
-        let valueRef = [object[key]];
+    function removedProperty(object, key, { label, warning, value } = {}) {
+        var _a;
+        const doWarn = u.memoize(function () {
+            if (warning) {
+                warn(warning);
+            }
+            else if (label) {
+                warn('Property %s.%s has been removed without replacement', label, key);
+            }
+            else {
+                warn('Property { %s } has been removed without replacement (found in %o)', key, object);
+            }
+        });
+        let valueRef = [value !== null && value !== void 0 ? value : (_a = Object.getOwnPropertyDescriptor(object, key)) === null || _a === void 0 ? void 0 : _a.value];
         Object.defineProperty(object, key, {
             configurable: true,
+            enumerable: false,
             get() {
                 doWarn();
                 return valueRef[0];
@@ -39,21 +61,6 @@ up.migrate = (function () {
         });
         return valueRef;
     }
-    function forbiddenPropertyValue(object, key, forbiddenValue, errorMessage) {
-        let value = object[key];
-        Object.defineProperty(object, key, {
-            configurable: true,
-            get() {
-                return value;
-            },
-            set(newValue) {
-                if (newValue === forbiddenValue) {
-                    throw new Error(errorMessage);
-                }
-                value = newValue;
-            }
-        });
-    }
     function transformAttribute(oldAttr, ...args) {
         let transformer = u.extractCallback(args);
         let { scope } = u.extractOptions(args);
@@ -84,9 +91,17 @@ up.migrate = (function () {
             }
         });
     }
-    function fixKey(object, oldKey, newKey) {
+    function fixKey(object, oldKey, newKey, { label, detail } = {}) {
         if (u.isDefined(object[oldKey])) {
-            warn('Property { %s } has been renamed to { %s } (found in %o)', oldKey, newKey, object);
+            if (label && detail) {
+                warn('Property { %s } has been renamed to { %s } (found in %s for %o)', oldKey, newKey, label, detail);
+            }
+            else if (label) {
+                warn('Property { %s } has been renamed to { %s } (found in %s)', oldKey, newKey, label);
+            }
+            else {
+                warn('Property { %s } has been renamed to { %s } (found in %o)', oldKey, newKey, object);
+            }
             u.renameKey(object, oldKey, newKey);
         }
     }
@@ -229,7 +244,6 @@ up.migrate = (function () {
         renamedProperty,
         removedProperty,
         defineThrowingProps,
-        forbiddenPropertyValue,
         transformAttribute,
         renamedAttribute,
         removedAttribute,
@@ -262,14 +276,14 @@ up.Config.prototype.patch = function (patch) {
 /* 3 */
 /***/ (() => {
 
-up.migrate.renamedProperty(up.RenderJob.prototype, 'options', 'renderOptions', 'up.RenderJob: Property { options } has been renamed to { renderOptions }');
+up.migrate.renamedProperty(up.RenderJob.prototype, 'options', 'renderOptions', { warning: 'up.RenderJob: Property { options } has been renamed to { renderOptions }' });
 
 
 /***/ }),
 /* 4 */
 /***/ (() => {
 
-up.migrate.renamedProperty(up.RenderResult.prototype, 'options', 'renderOptions', 'up.RenderResult: Property { options } has been renamed to { renderOptions }');
+up.migrate.renamedProperty(up.RenderResult.prototype, 'options', 'renderOptions', { warning: 'up.RenderResult: Property { options } has been renamed to { renderOptions }' });
 
 
 /***/ }),
@@ -348,7 +362,10 @@ up.util.values = function (...args) {
     up.migrate.deprecated('up.util.values()', 'Object.values()');
     return Object.values(...args);
 };
-up.util.microtask = window.queueMicrotask;
+up.util.microtask = function (task) {
+    up.migrate.deprecated('up.util.microtask()', 'queueMicrotask()');
+    return Promise.resolve().then(task);
+};
 up.migrate.splitAtOr = function (value) {
     let parts = value.split(/\s+or\s+/);
     if (parts.length >= 2) {
@@ -363,6 +380,7 @@ up.migrate.splitAtOr = function (value) {
 /***/ (() => {
 
 class DeprecatedCannotCompile extends up.Error {
+    get [Symbol.toStringTag]() { return 'up.CannotCompile'; }
 }
 Object.defineProperty(up, 'CannotCompile', { get: function () {
         up.migrate.warn('The error up.CannotCompile is no longer thrown. Compiler errors now emit an "error" event on window, but no longer crash the render pass.');
@@ -436,11 +454,11 @@ up.element.toSelector = function (...args) {
     return up.fragment.toTarget(...args);
 };
 up.element.isAttached = function (element) {
-    up.migrate.deprecated('up.element.isAttached()', 'document.contains(element)');
+    up.migrate.deprecated('up.element.isAttached()', 'element.isConnected');
     return document.contains(element);
 };
 up.element.isDetached = function (element) {
-    up.migrate.deprecated('up.element.isDetached()', '!document.contains(element)');
+    up.migrate.deprecated('up.element.isDetached()', '!element.isConnected');
     return !up.element.isAttached(element);
 };
 
@@ -482,18 +500,22 @@ up.$off = function (...definitionArgs) {
 const u = up.util;
 const e = up.element;
 up.migrate.renamedPackage('syntax', 'script');
+up.script.config.patch(function (config) {
+    up.migrate.renamedProperty(config, 'callbackPolicy', 'evalCallbackPolicy', { warning: 'There is no setting up.script.config.callbackPolicy. Use up.script.config.evalCallbackPolicy instead.' });
+});
 up.migrate.postCompile = function (elements, compiler) {
     let keepValue;
     if (keepValue = compiler.keep) {
-        up.migrate.warn('The { keep: true } option for up.compiler() has been removed. Have the compiler set [up-keep] attribute instead.');
+        up.migrate.warn('The { keep } option for up.compiler() has been removed. Have the compiler set an [up-keep] attribute instead (found in compiler for "%s").', compiler.selector);
         const value = u.isString(keepValue) ? keepValue : '';
         for (let element of elements) {
             element.setAttribute('up-keep', value);
         }
     }
 };
-up.migrate.targetMacro = function (queryAttr, fixedResultAttrs, callback) {
+up.migrate.targetMacro = function (queryAttr, fixedResultAttrs, replacement) {
     up.macro(`[${queryAttr}]`, function (link) {
+        up.migrate.warn('Attribute [%s] has been deprecated. Use %s instead (found in %o).', queryAttr, replacement, link);
         let optionalTarget;
         const resultAttrs = u.copy(fixedResultAttrs);
         if ((optionalTarget = link.getAttribute(queryAttr))) {
@@ -504,7 +526,6 @@ up.migrate.targetMacro = function (queryAttr, fixedResultAttrs, callback) {
         }
         e.setMissingAttrs(link, resultAttrs);
         link.removeAttribute(queryAttr);
-        callback === null || callback === void 0 ? void 0 : callback();
     });
 };
 up.$compiler = function (...definitionArgs) {
@@ -547,10 +568,11 @@ up.hello = function (element, ...args) {
 /***/ (() => {
 
 up.form.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'fields', 'fieldSelectors');
-    up.migrate.renamedProperty(config, 'submitButtons', 'submitButtonSelectors');
-    up.migrate.renamedProperty(config, 'validateTargets', 'groupSelectors');
-    up.migrate.renamedProperty(config, 'observeDelay', 'watchInputDelay');
+    up.migrate.renamedProperty(config, 'fields', 'fieldSelectors', { label: 'up.form.config' });
+    up.migrate.renamedProperty(config, 'submitButtons', 'submitButtonSelectors', { label: 'up.form.config' });
+    up.migrate.renamedProperty(config, 'validateTargets', 'groupSelectors', { label: 'up.form.config' });
+    up.migrate.renamedProperty(config, 'observeDelay', 'watchInputDelay', { label: 'up.form.config' });
+    up.migrate.renamedProperty(config, 'genericButtonSelectors', 'anyButtonSelectors', { label: 'up.form.config' });
 });
 up.migrate.migratedFormGroupSelectors = function () {
     return up.form.config.groupSelectors.map((originalSelector) => {
@@ -591,16 +613,17 @@ const u = up.util;
 up.migrate.renamedPackage('flow', 'fragment');
 up.migrate.renamedPackage('dom', 'fragment');
 up.fragment.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'fallbacks', 'mainTargets');
+    up.migrate.renamedProperty(config, 'fallbacks', 'mainTargets', { label: 'up.fragment.config' });
 });
-up.migrate.handleResponseDocOptions = (docOptions) => up.migrate.fixKey(docOptions, 'html', 'document');
+const renderOptionsSource = (options) => ({ label: 'render options', detail: options.origin || options.url || options.target });
+up.migrate.handleResponseDocOptions = (docOptions) => up.migrate.fixKey(docOptions, 'html', 'document', renderOptionsSource(docOptions));
 up.fragment.config.patch(function (config) {
     let matchAroundOriginDeprecated = () => up.migrate.deprecated('up.fragment.config.matchAroundOrigin', 'up.fragment.config.match');
     Object.defineProperty(config, 'matchAroundOrigin', {
         configurable: true,
         get: function () {
             matchAroundOriginDeprecated();
-            return this.match === 'closest';
+            return this.match === 'region';
         },
         set: function (value) {
             matchAroundOriginDeprecated();
@@ -655,8 +678,8 @@ up.migrate.preprocessRenderOptions = function (options) {
         up.migrate.warn('Unpoly 3+ only aborts requests targeting the same fragment. Setting { solo: false } may no longer be necessary.');
         options.abort = false;
     }
-    up.migrate.fixKey(options, 'failOnFinished', 'onFailFinished');
-    up.migrate.fixKey(options, 'badResponseTime', 'lateDelay');
+    up.migrate.fixKey(options, 'failOnFinished', 'onFailFinished', renderOptionsSource(options));
+    up.migrate.fixKey(options, 'badResponseTime', 'lateDelay', renderOptionsSource(options));
     if (u.isString(options.reveal)) {
         up.migrate.deprecated(`Option { reveal: '${options.reveal}' }`, `{ scroll: '${options.reveal}' }`);
         options.scroll = options.reveal;
@@ -671,7 +694,7 @@ up.migrate.preprocessRenderOptions = function (options) {
     }
     if (options.resetScroll === true) {
         up.migrate.deprecated('Option { resetScroll: true }', "{ scroll: 'top' }");
-        options.scroll = 'reset';
+        options.scroll = 'top';
     }
     if (options.resetScroll === false) {
         up.migrate.deprecated('Option { resetScroll: false }', "{ scroll: false }");
@@ -686,7 +709,7 @@ up.migrate.preprocessRenderOptions = function (options) {
         options.scroll = false;
     }
     if (options.scroll === 'reset') {
-        up.migrate.deprecated("Option { scroll: 'reset'' }", "{ scroll: 'top' }");
+        up.migrate.deprecated("Option { scroll: 'reset' }", "{ scroll: 'top' }");
         options.scroll = 'top';
     }
 };
@@ -707,7 +730,8 @@ up.migrate.resolveOrigin = function (target, { origin } = {}) {
     return target.replace(pattern, function (variant) {
         if (variant === ':origin' || variant === '&') {
             if (variant === '&') {
-                up.migrate.deprecated("Origin shorthand '&'", ':origin');
+                let formHint = (origin === null || origin === void 0 ? void 0 : origin.form) ? "A form submission's :origin is now the button or changed field, not the form. To target the form, use form:has(:origin). " : '';
+                up.migrate.warn("Origin shorthand '&' has been deprecated. Use :origin instead. " + formHint + "Found in %s (origin %o).", target, origin);
             }
             if (origin) {
                 return up.fragment.toTarget(origin);
@@ -752,7 +776,7 @@ up.fragment.config.patch(function () {
 up.compiler('[up-keep]', function (element) {
     let selector = up.element.booleanOrStringAttr(element, 'up-keep');
     if (u.isString(selector) && /[.[#]/.test(selector)) {
-        up.migrate.warn('The [up-keep] attribute no longer supports a selector value. Elements will be matched by their derived target. You may prevent keeping with [up-on-keep="if(condition) event.preventDefault()"]. ');
+        up.migrate.warn('The [up-keep] attribute no longer supports a selector value (found in %o). Elements will be matched by their derived target. You may prevent keeping with [up-on-keep="if(condition) event.preventDefault()"].', element);
         element.addEventListener('up:fragment:keep', function (event) {
             if (event.target === element && !event.newFragment.matches(selector)) {
                 event.preventDefault();
@@ -778,7 +802,7 @@ if (document.querySelector('script[up-boot=manual]')) {
 /***/ (() => {
 
 up.history.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'popTargets', 'restoreTargets');
+    up.migrate.renamedProperty(config, 'popTargets', 'restoreTargets', { label: 'up.history.config' });
 });
 up.history.url = function () {
     up.migrate.deprecated('up.history.url()', 'up.history.location');
@@ -790,28 +814,31 @@ up.migrate.renamedEvent('up:history:restore', 'up:location:changed');
 up.migrate.renamedEvent('up:history:restored', 'up:location:changed');
 up.migrate.renamedEvent('up:history:replaced', 'up:location:changed');
 up.migrate.prepareLocationChangedEvent = function (event) {
-    up.migrate.renamedProperty(event, 'url', 'location');
+    up.migrate.renamedProperty(event, 'url', 'location', { warning: 'Property event.url of up:location:changed has been renamed to event.location' });
 };
 up.history.config.patch(function () {
-    this.updateMetaTagsValue = this.updateMetaTags;
-    this.updateMetaTagsSet = false;
     Object.defineProperty(this, 'updateMetaTags', {
         configurable: true,
         get() {
-            return this.updateMetaTagsValue;
+            return up.history.isEnabled('metaTags');
         },
         set(value) {
-            this.updateMetaTagsValue = value;
-            this.updateMetaTagsSet = true;
+            if (value) {
+                up.migrate.warn('up.history.config.updateMetaTags has been removed. Meta tags are updated by default.');
+                return;
+            }
+            up.migrate.deprecated('up.history.config.updateMetaTags = false', "an array of aspects without 'metaTags' in up.history.config.enabled");
+            let { enabled } = this;
+            if (enabled === true)
+                enabled = ['location', 'title', 'lang'];
+            if (up.util.isArray(enabled))
+                this.enabled = enabled.filter((aspect) => aspect !== 'metaTags');
         }
     });
 });
-up.on('up:framework:boot', function () {
-    if (!up.history.config.updateMetaTagsSet) {
-        up.migrate.warn('Meta tags in the <head> are now updated automatically. Configure up.history.config.updateMetaTags to remove this warning.');
-    }
-});
 up.migrate.warnOfHungryMetaTags = function (metaTags) {
+    if (!up.history.isEnabled('metaTags'))
+        return;
     let fullHungrySelector = up.radio.config.selector('hungrySelectors');
     let hungryMetaTags = up.util.filter(metaTags, (meta) => meta.matches(fullHungrySelector));
     if (hungryMetaTags.length) {
@@ -827,7 +854,7 @@ up.migrate.warnOfHungryMetaTags = function (metaTags) {
 up.migrate.renamedPackage('navigation', 'status');
 up.migrate.renamedPackage('feedback', 'status');
 up.status.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'navs', 'navSelectors');
+    up.migrate.renamedProperty(config, 'navs', 'navSelectors', { label: 'up.status.config' });
 });
 
 
@@ -836,65 +863,68 @@ up.status.config.patch(function (config) {
 /***/ (() => {
 
 const followSelectorFn = up.link.config.selectorFn('followSelectors');
+const submitSelectorFn = up.form.config.selectorFn('submitSelectors');
 const preloadSelectorFn = up.link.config.selectorFn('preloadSelectors');
-up.migrate.renamedAttribute('up-flavor', 'up-mode', { scope: followSelectorFn });
-up.migrate.renamedAttribute('up-closable', 'up-dismissible', { scope: followSelectorFn });
-up.migrate.renamedAttribute('up-dismissable', 'up-dismissible', { scope: followSelectorFn });
-up.migrate.removedAttribute('up-width', { scope: followSelectorFn, replacement: '[up-size] or [up-class]' });
-up.migrate.removedAttribute('up-height', { scope: followSelectorFn, replacement: '[up-size] or [up-class]' });
-up.migrate.renamedAttribute('up-history-visible', 'up-history', { scope: followSelectorFn });
-up.migrate.renamedAttribute('up-clear-cache', 'up-expire-cache', { scope: followSelectorFn });
+const layerOpenerSelectorFn = () => [followSelectorFn(), submitSelectorFn()].join();
+up.migrate.renamedAttribute('up-flavor', 'up-mode', { scope: layerOpenerSelectorFn });
+up.migrate.renamedAttribute('up-closable', 'up-dismissible', { scope: layerOpenerSelectorFn });
+up.migrate.renamedAttribute('up-dismissable', 'up-dismissible', { scope: layerOpenerSelectorFn });
+up.migrate.removedAttribute('up-width', { scope: layerOpenerSelectorFn, replacement: '[up-size] or [up-class]' });
+up.migrate.removedAttribute('up-height', { scope: layerOpenerSelectorFn, replacement: '[up-size] or [up-class]' });
+up.migrate.renamedAttribute('up-history-visible', 'up-history', { scope: layerOpenerSelectorFn });
+up.migrate.renamedAttribute('up-clear-cache', 'up-expire-cache', { scope: layerOpenerSelectorFn });
 up.migrate.renamedAttribute('up-bad-response-time', 'up-late-delay');
 up.migrate.transformAttribute('up-solo', function (link, solo) {
     switch (solo) {
         case '':
-            up.migrate.warn('Attribute [up-solo] has been replaced with [up-abort="all"]');
+            up.migrate.warn('Attribute [up-solo] has been replaced with [up-abort="all"] (found in %o)', link);
             link.setAttribute('up-abort', 'all');
             break;
         case 'true':
-            up.migrate.warn('Attribute [up-solo="true"] has been replaced with [up-abort="all"]');
+            up.migrate.warn('Attribute [up-solo="true"] has been replaced with [up-abort="all"] (found in %o)', link);
             link.setAttribute('up-abort', 'all');
             break;
         case 'false':
-            up.migrate.warn('Attribute [up-solo="false"] has been replaced with [up-abort="false"]');
+            up.migrate.warn('Attribute [up-solo="false"] has been replaced with [up-abort="false"] (found in %o)', link);
             up.migrate.warn('Unpoly 3+ only aborts requests targeting the same fragment. Setting [up-solo="false"] may no longer be necessary.');
             link.setAttribute('up-abort', 'false');
             break;
         default:
-            up.migrate.warn('Attribute [up-solo] has been renamed to [up-abort] and [up-abort] no longer accepts a URL pattern. Check if you can use [up-abort="target"] instead.');
+            up.migrate.warn('Attribute [up-solo] has been renamed to [up-abort] and [up-abort] no longer accepts a URL pattern (found in %o). Check if you can use [up-abort="target"] instead.', link);
             link.setAttribute('up-abort', 'target');
     }
 });
 up.migrate.transformAttribute('up-reveal', function (link, reveal) {
     switch (reveal) {
         case '':
-            up.migrate.warn('Attribute [up-reveal] has been replaced with [up-scroll="target"]');
+            up.migrate.warn('Attribute [up-reveal] has been replaced with [up-scroll="target"] (found in %o)', link);
             link.setAttribute('up-scroll', 'target');
             break;
         case 'true':
-            up.migrate.warn('Attribute [up-reveal="true"] has been replaced with [up-scroll="target"]');
+            up.migrate.warn('Attribute [up-reveal="true"] has been replaced with [up-scroll="target"] (found in %o)', link);
             link.setAttribute('up-scroll', 'target');
             break;
         case 'false':
-            up.migrate.warn('Attribute [up-reveal="false"] has been replaced with [up-scroll="false"]');
+            up.migrate.warn('Attribute [up-reveal="false"] has been replaced with [up-scroll="false"] (found in %o)', link);
             link.setAttribute('up-scroll', 'false');
             break;
         default:
-            up.migrate.warn('Attribute [up-reveal="%s"] has been replaced with [up-scroll="%s"]', reveal);
+            up.migrate.warn('Attribute [up-reveal="%s"] has been replaced with [up-scroll="%s"] (found in %o)', reveal, reveal, link);
+            link.setAttribute('up-scroll', reveal);
     }
 });
 up.migrate.transformAttribute('up-reset-scroll', function (link, resetScroll) {
     switch (resetScroll) {
         case '':
-            up.migrate.warn('Attribute [up-reset-scroll] has been replaced with [up-scroll="top"]');
+            up.migrate.warn('Attribute [up-reset-scroll] has been replaced with [up-scroll="top"] (found in %o)', link);
             link.setAttribute('up-scroll', 'top');
             break;
         case 'true':
-            up.migrate.warn('Attribute [up-reset-scroll="true"] has been replaced with [up-scroll="top"]');
+            up.migrate.warn('Attribute [up-reset-scroll="true"] has been replaced with [up-scroll="top"] (found in %o)', link);
             link.setAttribute('up-scroll', 'top');
             break;
         case 'false':
-            up.migrate.warn('Attribute [up-reset-scroll="false"] has been replaced with [up-scroll="false"]');
+            up.migrate.warn('Attribute [up-reset-scroll="false"] has been replaced with [up-scroll="false"] (found in %o)', link);
             link.setAttribute('up-scroll', 'false');
             break;
     }
@@ -902,25 +932,24 @@ up.migrate.transformAttribute('up-reset-scroll', function (link, resetScroll) {
 up.migrate.transformAttribute('up-restore-scroll', function (link, restoreScroll) {
     switch (restoreScroll) {
         case '':
-            up.migrate.warn('Attribute [up-restore-scroll] has been replaced with [up-scroll="restore"]');
+            up.migrate.warn('Attribute [up-restore-scroll] has been replaced with [up-scroll="restore"] (found in %o)', link);
             link.setAttribute('up-scroll', 'restore');
             break;
         case 'true':
-            up.migrate.warn('Attribute [up-restore-scroll="true"] has been replaced with [up-scroll="restore"]');
+            up.migrate.warn('Attribute [up-restore-scroll="true"] has been replaced with [up-scroll="restore"] (found in %o)', link);
             link.setAttribute('up-scroll', 'restore');
             break;
         case 'false':
-            up.migrate.warn('Attribute [up-restore-scroll="false"] has been replaced with [up-scroll="false"]');
+            up.migrate.warn('Attribute [up-restore-scroll="false"] has been replaced with [up-scroll="false"] (found in %o)', link);
             link.setAttribute('up-scroll', 'false');
             break;
     }
 });
-up.migrate.targetMacro('up-dash', { 'up-preload': '', 'up-instant': '' }, () => up.migrate.deprecated('[up-dash]', 'up.link.config.instantSelectors and up.link.config.preloadSelectors'));
+up.migrate.targetMacro('up-dash', { 'up-preload': '', 'up-instant': '' }, 'up.link.config.instantSelectors and up.link.config.preloadSelectors');
 up.migrate.renamedAttribute('up-delay', 'up-preload-delay', { scope: preloadSelectorFn });
 let preloadEnabledRef;
 up.link.config.patch(function (config) {
-    config.preloadEnabled = true;
-    preloadEnabledRef = up.migrate.removedProperty(config, 'preloadEnabled', 'The configuration up.link.config.preloadEnabled has been removed. To disable preloading, prevent up:link:preload instead.');
+    preloadEnabledRef = up.migrate.removedProperty(config, 'preloadEnabled', { value: true, warning: 'The configuration up.link.config.preloadEnabled has been removed. To disable preloading, prevent up:link:preload instead.' });
 });
 up.on('up:link:preload', function (event) {
     if (!preloadEnabledRef[0]) {
@@ -928,19 +957,25 @@ up.on('up:link:preload', function (event) {
     }
 });
 const LEGACY_UP_HREF_FOLLOW_SELECTOR = '[up-href]:not([up-follow], [up-poll], [up-defer], [up-expand])';
-up.link.config.patch(function (config) {
-    config.clickableSelectors.push(LEGACY_UP_HREF_FOLLOW_SELECTOR);
-    config.followSelectors.push(LEGACY_UP_HREF_FOLLOW_SELECTOR);
-});
-up.compiler(LEGACY_UP_HREF_FOLLOW_SELECTOR, function (element) {
+up.macro(LEGACY_UP_HREF_FOLLOW_SELECTOR, { priority: -50 }, function (element) {
+    if (up.link.isFollowable(element))
+        return;
     up.migrate.warn('Following links with only [up-href] has been deprecated. You must now also set an [up-follow] on the same link (found in %o).', element);
+    element.setAttribute('up-follow', '');
 });
-const LEGACY_UP_INSTANT_FOLLOW_INTENT_SELECTOR = `[up-instant]:is(a[href], ${LEGACY_UP_HREF_FOLLOW_SELECTOR})`;
+const LEGACY_UP_INSTANT_FOLLOW_INTENT_SELECTOR = 'a[href][up-instant]';
 up.link.config.patch(function (config) {
     config.followSelectors.push(LEGACY_UP_INSTANT_FOLLOW_INTENT_SELECTOR);
 });
-up.compiler(LEGACY_UP_HREF_FOLLOW_SELECTOR, function (element) {
-    up.migrate.warn('Following links with only [up-instant] has been deprecated. You must now also set an [up-follow] on the same link (found in %o).', element);
+function isFollowableWithoutLegacyInstant(element) {
+    let { followSelectors, noFollowSelectors } = up.link.config;
+    let modernFollowSelectors = followSelectors.filter((selector) => selector !== LEGACY_UP_INSTANT_FOLLOW_INTENT_SELECTOR);
+    return element.matches(up.element.unionSelector(modernFollowSelectors, noFollowSelectors));
+}
+up.compiler(LEGACY_UP_INSTANT_FOLLOW_INTENT_SELECTOR, function (element) {
+    if (up.link.isFollowable(element) && !isFollowableWithoutLegacyInstant(element)) {
+        up.migrate.warn('Following links with only [up-instant] has been deprecated. You must now also set an [up-follow] on the same link (found in %o).', element);
+    }
 });
 
 
@@ -948,12 +983,28 @@ up.compiler(LEGACY_UP_HREF_FOLLOW_SELECTOR, function (element) {
 /* 18 */
 /***/ (() => {
 
+function fixRenamedLayerKeys(object, source) {
+    up.migrate.fixKey(object, 'closable', 'dismissible', source);
+    up.migrate.fixKey(object, 'dismissable', 'dismissible', source);
+    up.migrate.fixKey(object, 'closeLabel', 'dismissLabel', source);
+    up.migrate.fixKey(object, 'dismissAriaLabel', 'dismissARIALabel', source);
+    up.migrate.fixKey(object, 'historyVisible', 'history', source);
+    splitPosition(object);
+}
+function splitPosition(object) {
+    if (!up.util.isString(object.position))
+        return;
+    const [position, align] = object.position.split('-');
+    if (align) {
+        up.migrate.warn('The position value %o is deprecated. Use %o instead.', object.position, { position, align });
+        object.position = position;
+        object.align = align;
+    }
+}
 up.migrate.handleLayerOptions = function (options) {
-    up.migrate.fixKey(options, 'flavor', 'mode');
-    up.migrate.fixKey(options, 'closable', 'dismissible');
-    up.migrate.fixKey(options, 'dismissable', 'dismissible');
-    up.migrate.fixKey(options, 'closeLabel', 'dismissLabel');
-    up.migrate.fixKey(options, 'dismissAriaLabel', 'dismissARIALabel');
+    const source = { label: 'layer options', detail: options.origin || options.url };
+    up.migrate.fixKey(options, 'flavor', 'mode', source);
+    fixRenamedLayerKeys(options, source);
     for (let dimensionKey of ['width', 'maxWidth', 'height']) {
         if (options[dimensionKey]) {
             up.migrate.warn(`Layer option { ${dimensionKey} } has been removed. Use { size } or { class } instead.`);
@@ -978,19 +1029,22 @@ up.migrate.handleLayerOptions = function (options) {
         options.layer = 'new';
     }
 };
-up.migrate.handleTetherOptions = function (options) {
-    const [position, align] = options.position.split('-');
-    if (align) {
-        up.migrate.warn('The position value %o is deprecated. Use %o instead.', options.position, { position, align });
-        options.position = position;
-        options.align = align;
-    }
-};
 up.migrate.registerLayerCloser = (layer) => layer.registerAttrCloser('up-close', (value, closeOptions) => {
     up.migrate.deprecated('[up-close]', '[up-dismiss]');
     layer.dismiss(value, closeOptions);
 });
-up.migrate.handleLayerConfig = (config) => up.migrate.fixKey(config, 'historyVisible', 'history');
+up.migrate.fixLayerConfigs = function () {
+    for (let [mode, modeConfig] of Object.entries(up.layer.config)) {
+        if (up.util.isOptions(modeConfig)) {
+            fixRenamedLayerKeys(modeConfig, { label: `up.layer.config.${mode}` });
+        }
+    }
+};
+up.on('up:framework:boot', up.migrate.fixLayerConfigs);
+up.migrate.handleLayerConfig = function (modeConfig) {
+    let [mode] = Object.entries(up.layer.config).find(([_mode, value]) => value === modeConfig);
+    fixRenamedLayerKeys(modeConfig, { label: `up.layer.config.${mode}` });
+};
 Object.defineProperty(up.Layer.prototype, 'historyVisible', { get: function () {
         up.migrate.deprecated('up.Layer#historyVisible', 'up.Layer#history');
         return this.history;
@@ -1001,6 +1055,16 @@ Object.defineProperty(up.Layer.prototype, 'historyVisible', { get: function () {
 /* 19 */
 /***/ (() => {
 
+up.motion.isEnabled = function () {
+    up.migrate.deprecated('up.motion.isEnabled()', 'up.motion.config.enabled');
+    return up.motion.config.enabled;
+};
+
+
+/***/ }),
+/* 20 */
+/***/ (() => {
+
 const FLAVORS_ERROR = new Error('up.modal.flavors has been removed without direct replacement. You may give new layers a { class } or modify layer elements on up:layer:open.');
 up.modal = {
     visit(url, options = {}) {
@@ -1008,12 +1072,12 @@ up.modal = {
         return up.layer.open(Object.assign(Object.assign({}, options), { url, mode: 'modal' }));
     },
     follow(link, options = {}) {
-        up.migrate.deprecated('up.modal.follow(link)', 'up.follow(link, { layer: "modal" })');
-        return up.follow(link, Object.assign(Object.assign({}, options), { layer: 'modal' }));
+        up.migrate.deprecated('up.modal.follow(link)', 'up.follow(link, { layer: "new modal" })');
+        return up.follow(link, Object.assign(Object.assign({}, options), { layer: 'new', mode: 'modal' }));
     },
     extract(target, html, options = {}) {
         up.migrate.deprecated('up.modal.extract(target, document)', 'up.layer.open({ document, mode: "modal" })');
-        return up.layer.open(Object.assign(Object.assign({}, options), { target, html, layer: 'modal' }));
+        return up.layer.open(Object.assign(Object.assign({}, options), { target, document: html, layer: 'new', mode: 'modal' }));
     },
     close(options = {}) {
         up.migrate.deprecated('up.modal.close()', 'up.layer.dismiss()');
@@ -1048,23 +1112,24 @@ up.modal = {
         throw FLAVORS_ERROR;
     }
 };
+Object.defineProperty(up.modal, 'config', { enumerable: false });
 up.migrate.renamedEvent('up:modal:open', 'up:layer:open');
 up.migrate.renamedEvent('up:modal:opened', 'up:layer:opened');
 up.migrate.renamedEvent('up:modal:close', 'up:layer:dismiss');
 up.migrate.renamedEvent('up:modal:closed', 'up:layer:dismissed');
-up.migrate.targetMacro('up-modal', { 'up-layer': 'new modal' }, () => up.migrate.deprecated('[up-modal]', '[up-layer="new modal"]'));
-up.migrate.targetMacro('up-drawer', { 'up-layer': 'new drawer' }, () => up.migrate.deprecated('[up-drawer]', '[up-layer="new drawer"]'));
+up.migrate.targetMacro('up-modal', { 'up-layer': 'new modal' }, '[up-layer="new modal"]');
+up.migrate.targetMacro('up-drawer', { 'up-layer': 'new drawer' }, '[up-layer="new drawer"]');
 
 
 /***/ }),
-/* 20 */
+/* 21 */
 /***/ (() => {
 
 up.popup = {
     attach(origin, options = {}) {
         origin = up.fragment.get(origin);
-        up.migrate.deprecated('up.popup.attach(origin)', "up.layer.open({ origin, layer: 'popup' })");
-        return up.layer.open(Object.assign(Object.assign({}, options), { origin, layer: 'popup' }));
+        up.migrate.deprecated('up.popup.attach(origin)', "up.layer.open({ origin, mode: 'popup' })");
+        return up.layer.open(Object.assign(Object.assign({}, options), { origin, layer: 'new', mode: 'popup' }));
     },
     close(options = {}) {
         up.migrate.deprecated('up.popup.close()', 'up.layer.dismiss()');
@@ -1097,25 +1162,26 @@ up.popup = {
         return up.layer.sync();
     }
 };
+Object.defineProperty(up.popup, 'config', { enumerable: false });
 up.migrate.renamedEvent('up:popup:open', 'up:layer:open');
 up.migrate.renamedEvent('up:popup:opened', 'up:layer:opened');
 up.migrate.renamedEvent('up:popup:close', 'up:layer:dismiss');
 up.migrate.renamedEvent('up:popup:closed', 'up:layer:dismissed');
-up.migrate.targetMacro('up-popup', { 'up-layer': 'new popup' }, () => up.migrate.deprecated('[up-popup]', '[up-layer="new popup"]'));
+up.migrate.targetMacro('up-popup', { 'up-layer': 'new popup' }, '[up-layer="new popup"]');
 
 
 /***/ }),
-/* 21 */
+/* 22 */
 /***/ (() => {
 
 up.macro('[up-tooltip]', function (opener) {
-    up.migrate.warn('[up-tooltip] has been deprecated. A [title] was set instead.');
+    up.migrate.warn('Attribute [up-tooltip] has been deprecated. Use a [title] attribute instead (found in %o).', opener);
     up.element.setMissingAttr(opener, 'title', opener.getAttribute('up-tooltip'));
 });
 
 
 /***/ }),
-/* 22 */
+/* 23 */
 /***/ (() => {
 
 up.migrate.clearCacheFromXHR = function (xhr) {
@@ -1137,7 +1203,7 @@ up.migrate.titleFromXHR = function (xhr) {
             return false;
         }
         else if (value[0] !== '"' && value[0] !== "'") {
-            up.migrate.warn('X-Up-Title must now be a JSON-encoded string');
+            up.migrate.warn('X-Up-Title must now be a JSON-encoded string (got %o)', value);
             return value;
         }
     }
@@ -1159,7 +1225,7 @@ up.protocol.config.patch(function () {
 
 
 /***/ }),
-/* 23 */
+/* 24 */
 /***/ (() => {
 
 const u = up.util;
@@ -1189,26 +1255,38 @@ up.network.config.patch(function (config) {
     });
 });
 up.network.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'maxRequests', 'concurrency');
-    up.migrate.renamedProperty(config, 'slowDelay', 'lateDelay');
-    up.migrate.renamedProperty(config, 'cacheExpiry', 'cacheExpireAge', 'The configuration up.network.config.cacheExpiry has been renamed to up.network.config.cacheExpireAge. Note that Unpoly 3+ automatically reloads cached content after rendering to ensure users always see fresh data ("cache revalidation"). Setting a custom expiry may no longer be necessary.');
-    up.migrate.renamedProperty(config, 'clearCache', 'expireCache');
-    up.migrate.forbiddenPropertyValue(config, 'cacheSize', 0, 'Disabling the cache with up.network.config.cacheSize = 0 is no longer supported. To disable automatic caching during navigation, set up.fragment.config.navigateOptions.cache = false instead.');
-    up.network.config.requestMetaKeys = [];
-    up.migrate.removedProperty(config, 'requestMetaKeys', 'The configuration up.network.config.requestMetaKeys has been removed. Servers that optimize responses based on request headers should instead set a Vary response header.');
+    up.migrate.renamedProperty(config, 'maxRequests', 'concurrency', { label: 'up.network.config' });
+    up.migrate.renamedProperty(config, 'slowDelay', 'lateDelay', { label: 'up.network.config' });
+    up.migrate.renamedProperty(config, 'cacheExpiry', 'cacheExpireAge', { warning: 'The configuration up.network.config.cacheExpiry has been renamed to up.network.config.cacheExpireAge. Note that Unpoly 3+ automatically reloads cached content after rendering to ensure users always see fresh data ("cache revalidation"). Setting a custom expiry may no longer be necessary.' });
+    up.migrate.renamedProperty(config, 'clearCache', 'expireCache', { label: 'up.network.config' });
+    let cacheSize = config.cacheSize;
+    Object.defineProperty(config, 'cacheSize', {
+        configurable: true,
+        get() {
+            return cacheSize;
+        },
+        set(newValue) {
+            if (newValue === 0) {
+                up.migrate.deprecated('up.network.config.cacheSize = 0', 'up.network.config.cacheEnabled = false');
+                config.cacheEnabled = false;
+            }
+            cacheSize = newValue;
+        }
+    });
+    up.migrate.removedProperty(config, 'requestMetaKeys', { value: [], warning: 'The configuration up.network.config.requestMetaKeys has been removed. Servers that optimize responses based on request headers should instead set a Vary response header.' });
 });
 up.migrate.handleRequestOptions = function (options) {
-    up.migrate.fixKey(options, 'clearCache', 'expireCache');
+    up.migrate.fixKey(options, 'clearCache', 'expireCache', { label: 'request options', detail: options.url });
     if (options.solo) {
         up.migrate.warn('The option up.request({ solo }) has been removed. Use up.network.abort() or up.fragment.abort() instead.');
     }
 };
 up.on('up:request:loaded', function (event) {
-    if (event.response.headers['X-Up-Expire-Cache'] === 'false') {
-        up.migrate.warn('The server can no longer override an { expireCache } option using an `X-Up-Expire-Cache: false` response header');
+    if (event.response.header('X-Up-Expire-Cache') === 'false') {
+        up.migrate.warn('The server can no longer prevent cache expiration with an `X-Up-Expire-Cache: false` response header. The header has no effect and can be removed.');
     }
-    if (event.response.headers['X-Up-Evict-Cache'] === 'false') {
-        up.migrate.warn('The server can no longer override an { evictCache } option using an `X-Up-Evict-Cache: false` response header');
+    if (event.response.header('X-Up-Evict-Cache') === 'false') {
+        up.migrate.warn('The server can no longer prevent cache eviction with an `X-Up-Evict-Cache: false` response header. The header has no effect and can be removed.');
     }
 });
 up.ajax = function (...args) {
@@ -1242,8 +1320,8 @@ up.Request.prototype.navigate = function () {
     up.migrate.deprecated('up.Request#navigate()', 'up.Request#loadPage()');
     this.loadPage();
 };
-up.migrate.renamedProperty(up.Request.prototype, 'preload', 'background');
-up.migrate.renamedProperty(up.Request.prototype, 'badResponseTime', 'lateDelay');
+up.migrate.renamedProperty(up.Request.prototype, 'preload', 'background', { warning: 'Property up.Request#preload has been renamed to up.Request#background' });
+up.migrate.renamedProperty(up.Request.prototype, 'badResponseTime', 'lateDelay', { warning: 'Property up.Request#badResponseTime has been renamed to up.Request#lateDelay' });
 up.Response.prototype.isSuccess = function () {
     up.migrate.deprecated('up.Response#isSuccess()', 'up.Response#ok');
     return this.ok;
@@ -1264,7 +1342,7 @@ const progressBarDefault = up.network.config.progressBar;
 up.network.config.patch(function (config) {
     config.progressBar = function () {
         if (mayHaveCustomIndicator()) {
-            up.migrate.warn('Disabled the default progress bar as may have built a custom loading indicator with your up:network:late listener. Please set up.network.config.progressBar to true or false.');
+            up.migrate.warn('Disabled the default progress bar as you may have built a custom loading indicator with your up:network:late listener. Please set up.network.config.progressBar to true or false.');
             return false;
         }
         else {
@@ -1273,28 +1351,27 @@ up.network.config.patch(function (config) {
     };
 });
 up.network.shouldReduceRequests = function () {
-    up.migrate('up.network.shouldReduceRequests() has been removed without replacement');
+    up.migrate.warn('up.network.shouldReduceRequests() has been removed without replacement');
     return false;
 };
 up.network.config.patch(function (config) {
-    up.migrate.removedProperty(config, 'badRTT');
-    up.migrate.removedProperty(config, 'badDownlink');
-    up.migrate.renamedProperty(config, 'badResponseTime', 'lateDelay');
+    up.migrate.removedProperty(config, 'badRTT', { label: 'up.network.config' });
+    up.migrate.removedProperty(config, 'badDownlink', { label: 'up.network.config' });
+    up.migrate.renamedProperty(config, 'badResponseTime', 'lateDelay', { label: 'up.network.config' });
 });
 
 
 /***/ }),
-/* 24 */
+/* 25 */
 /***/ (() => {
 
 const e = up.element;
 up.radio.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'hungry', 'hungrySelectors');
+    up.migrate.renamedProperty(config, 'hungry', 'hungrySelectors', { label: 'up.radio.config' });
 });
-up.radio.config.pollEnabled = true;
 let pollEnabledRef;
 up.radio.config.patch(function (config) {
-    pollEnabledRef = up.migrate.removedProperty(config, 'pollEnabled', 'The configuration up.radio.config.pollEnabled has been removed. To disable polling, prevent up:fragment:poll instead.');
+    pollEnabledRef = up.migrate.removedProperty(config, 'pollEnabled', { value: true, warning: 'The configuration up.radio.config.pollEnabled has been removed. To disable polling, prevent up:fragment:poll instead.' });
 });
 up.on('up:fragment:poll', function (event) {
     if (!pollEnabledRef[0]) {
@@ -1305,6 +1382,7 @@ up.compiler('[up-hungry][up-if-history]', function (element) {
     let ifHistory = e.booleanAttr(element, 'up-if-history');
     if (!ifHistory)
         return;
+    up.migrate.warn('Attribute [up-if-history] has been deprecated. Use [up-on-hungry="if (!renderOptions.history) event.preventDefault()"] instead (found in %o).', element);
     element.addEventListener('up:fragment:hungry', function (event) {
         if (!event.renderOptions.history) {
             event.preventDefault();
@@ -1314,17 +1392,17 @@ up.compiler('[up-hungry][up-if-history]', function (element) {
 
 
 /***/ }),
-/* 25 */
+/* 26 */
 /***/ (() => {
 
 up.migrate.renamedPackage('layout', 'viewport');
 up.viewport.config.patch(function (config) {
-    up.migrate.renamedProperty(config, 'viewports', 'viewportSelectors');
-    up.migrate.renamedProperty(config, 'fixedTop', 'fixedTopSelectors');
-    up.migrate.renamedProperty(config, 'fixedBottom', 'fixedBottomSelectors');
-    up.migrate.renamedProperty(config, 'anchoredRight', 'anchoredRightSelectors');
-    up.migrate.renamedProperty(config, 'snap', 'revealSnap');
-    up.migrate.removedProperty(config, 'scrollSpeed');
+    up.migrate.renamedProperty(config, 'viewports', 'viewportSelectors', { label: 'up.viewport.config' });
+    up.migrate.renamedProperty(config, 'fixedTop', 'fixedTopSelectors', { label: 'up.viewport.config' });
+    up.migrate.renamedProperty(config, 'fixedBottom', 'fixedBottomSelectors', { label: 'up.viewport.config' });
+    up.migrate.renamedProperty(config, 'anchoredRight', 'anchoredRightSelectors', { label: 'up.viewport.config' });
+    up.migrate.renamedProperty(config, 'snap', 'revealSnap', { label: 'up.viewport.config' });
+    up.migrate.removedProperty(config, 'scrollSpeed', { label: 'up.viewport.config' });
 });
 up.viewport.closest = function (...args) {
     up.migrate.deprecated('up.viewport.closest()', 'up.viewport.get()');
@@ -1395,6 +1473,7 @@ __webpack_require__(22);
 __webpack_require__(23);
 __webpack_require__(24);
 __webpack_require__(25);
+__webpack_require__(26);
 up.framework.stopExtension();
 
 })();