cable_ready 4.5.0 → 5.0.0

data/app/assets/javascripts/cable_ready.umd.js

@@ -0,0 +1,1190 @@
+(function(global, factory) {
+  typeof exports === "object" && typeof module !== "undefined" ? factory(exports, require("morphdom")) : typeof define === "function" && define.amd ? define([ "exports", "morphdom" ], factory) : (global = typeof globalThis !== "undefined" ? globalThis : global || self, 
+  factory(global.CableReady = {}, global.morphdom));
+})(this, (function(exports, morphdom) {
+  "use strict";
+  var name = "cable_ready";
+  var version = "5.0.0";
+  var description = "CableReady helps you create great real-time user experiences by making it simple to trigger client-side DOM changes from server-side Ruby.";
+  var keywords = [ "ruby", "rails", "websockets", "actioncable", "cable", "ssr", "stimulus_reflex", "client-side", "dom" ];
+  var homepage = "https://cableready.stimulusreflex.com";
+  var bugs = "https://github.com/stimulusreflex/cable_ready/issues";
+  var repository = "https://github.com/stimulusreflex/cable_ready";
+  var license = "MIT";
+  var author = "Nathan Hopkins <natehop@gmail.com>";
+  var contributors = [ "Andrew Mason <andrewmcodes@protonmail.com>", "Julian Rubisch <julian@julianrubisch.at>", "Marco Roth <marco.roth@intergga.ch>", "Nathan Hopkins <natehop@gmail.com>" ];
+  var main = "./dist/cable_ready.js";
+  var module = "./dist/cable_ready.js";
+  var browser = "./dist/cable_ready.js";
+  var unpkg = "./dist/cable_ready.umd.js";
+  var umd = "./dist/cable_ready.umd.js";
+  var files = [ "dist/*", "javascript/*" ];
+  var scripts = {
+    lint: "yarn run format --check",
+    format: "yarn run prettier-standard ./javascript/**/*.js rollup.config.mjs",
+    build: "yarn rollup -c",
+    watch: "yarn rollup -wc",
+    test: "web-test-runner javascript/test/**/*.test.js",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs && cp ./docs/_redirects ./docs/.vitepress/dist",
+    "docs:preview": "vitepress preview docs"
+  };
+  var dependencies = {
+    morphdom: "2.6.1"
+  };
+  var devDependencies = {
+    "@open-wc/testing": "^3.1.7",
+    "@rollup/plugin-json": "^6.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.1",
+    "@rollup/plugin-terser": "^0.4.0",
+    "@web/dev-server-esbuild": "^0.3.3",
+    "@web/dev-server-rollup": "^0.3.21",
+    "@web/test-runner": "^0.15.1",
+    "prettier-standard": "^16.4.1",
+    rollup: "^3.19.1",
+    sinon: "^15.0.2",
+    vite: "^4.1.4",
+    vitepress: "^1.0.0-alpha.56",
+    "vitepress-plugin-search": "^1.0.4-alpha.19"
+  };
+  var packageInfo = {
+    name: name,
+    version: version,
+    description: description,
+    keywords: keywords,
+    homepage: homepage,
+    bugs: bugs,
+    repository: repository,
+    license: license,
+    author: author,
+    contributors: contributors,
+    main: main,
+    module: module,
+    browser: browser,
+    import: "./dist/cable_ready.js",
+    unpkg: unpkg,
+    umd: umd,
+    files: files,
+    scripts: scripts,
+    dependencies: dependencies,
+    devDependencies: devDependencies
+  };
+  const inputTags = {
+    INPUT: true,
+    TEXTAREA: true,
+    SELECT: true
+  };
+  const mutableTags = {
+    INPUT: true,
+    TEXTAREA: true,
+    OPTION: true
+  };
+  const textInputTypes = {
+    "datetime-local": true,
+    "select-multiple": true,
+    "select-one": true,
+    color: true,
+    date: true,
+    datetime: true,
+    email: true,
+    month: true,
+    number: true,
+    password: true,
+    range: true,
+    search: true,
+    tel: true,
+    text: true,
+    textarea: true,
+    time: true,
+    url: true,
+    week: true
+  };
+  let activeElement;
+  var ActiveElement = {
+    get element() {
+      return activeElement;
+    },
+    set(element) {
+      activeElement = element;
+    }
+  };
+  // Indicates if the passed element is considered a text input.
+  
+    const isTextInput = element => inputTags[element.tagName] && textInputTypes[element.type];
+  // Assigns focus to the appropriate element... preferring the explicitly passed selector
+  
+  // * selector - a CSS selector for the element that should have focus
+  
+    const assignFocus = selector => {
+    const element = selector && selector.nodeType === Node.ELEMENT_NODE ? selector : document.querySelector(selector);
+    const focusElement = element || ActiveElement.element;
+    if (focusElement && focusElement.focus) focusElement.focus();
+  };
+  // Dispatches an event on the passed element
+  
+  // * element - the element
+  // * name - the name of the event
+  // * detail - the event detail
+  
+    const dispatch = (element, name, detail = {}) => {
+    const init = {
+      bubbles: true,
+      cancelable: true,
+      detail: detail
+    };
+    const event = new CustomEvent(name, init);
+    element.dispatchEvent(event);
+    if (window.jQuery) window.jQuery(element).trigger(name, detail);
+  };
+  // Accepts an xPath query and returns the element found at that position in the DOM
+  
+    const xpathToElement = xpath => document.evaluate(xpath, document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue;
+  // Accepts an xPath query and returns all matching elements in the DOM
+  
+    const xpathToElementArray = (xpath, reverse = false) => {
+    const snapshotList = document.evaluate(xpath, document, null, XPathResult.ORDERED_NODE_SNAPSHOT_TYPE, null);
+    const snapshots = [];
+    for (let i = 0; i < snapshotList.snapshotLength; i++) {
+      snapshots.push(snapshotList.snapshotItem(i));
+    }
+    return reverse ? snapshots.reverse() : snapshots;
+  };
+  // Return an array with the class names to be used
+  
+  // * names - could be a string or an array of strings for multiple classes.
+  
+    const getClassNames = names => Array.from(names).flat()
+  // Perform operation for either the first or all of the elements returned by CSS selector
+  
+  // * operation - the instruction payload from perform
+  // * callback - the operation function to run for each element
+  
+  ;
+  const processElements = (operation, callback) => {
+    Array.from(operation.selectAll ? operation.element : [ operation.element ]).forEach(callback);
+  };
+  // convert string to kebab-case
+  // most other implementations (lodash) are focused on camelCase to kebab-case
+  // instead, this uses word token boundaries to produce readable URL slugs and keys
+  // this implementation will not support Emoji or other non-ASCII characters
+  
+    const kebabize = createCompounder((function(result, word, index) {
+    return result + (index ? "-" : "") + word.toLowerCase();
+  }));
+  function createCompounder(callback) {
+    return function(str) {
+      return words(str).reduce(callback, "");
+    };
+  }
+  const words = str => {
+    str = str == null ? "" : str;
+    return str.match(/([A-Z]{2,}|[0-9]+|[A-Z]?[a-z]+|[A-Z])/g) || [];
+  };
+  // Provide a standardized pipeline of checks and modifications to all operations based on provided options
+  // Currently skips execution if cancelled and implements an optional delay
+  
+    const operate = (operation, callback) => {
+    if (!operation.cancel) {
+      operation.delay ? setTimeout(callback, operation.delay) : callback();
+      return true;
+    }
+    return false;
+  };
+  // Dispatch life-cycle events with standardized naming
+    const before = (target, operation) => dispatch(target, `cable-ready:before-${kebabize(operation.operation)}`, operation);
+  const after = (target, operation) => dispatch(target, `cable-ready:after-${kebabize(operation.operation)}`, operation);
+  function debounce(fn, delay = 250) {
+    let timer;
+    return (...args) => {
+      const callback = () => fn.apply(this, args);
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(callback, delay);
+    };
+  }
+  function handleErrors(response) {
+    if (!response.ok) throw Error(response.statusText);
+    return response;
+  }
+  function safeScalar(val) {
+    if (val !== undefined && ![ "string", "number", "boolean" ].includes(typeof val)) console.warn(`Operation expects a string, number or boolean, but got ${val} (${typeof val})`);
+    return val != null ? val : "";
+  }
+  function safeString(str) {
+    if (str !== undefined && typeof str !== "string") console.warn(`Operation expects a string, but got ${str} (${typeof str})`);
+    return str != null ? String(str) : "";
+  }
+  function safeArray(arr) {
+    if (arr !== undefined && !Array.isArray(arr)) console.warn(`Operation expects an array, but got ${arr} (${typeof arr})`);
+    return arr != null ? Array.from(arr) : [];
+  }
+  function safeObject(obj) {
+    if (obj !== undefined && typeof obj !== "object") console.warn(`Operation expects an object, but got ${obj} (${typeof obj})`);
+    return obj != null ? Object(obj) : {};
+  }
+  function safeStringOrArray(elem) {
+    if (elem !== undefined && !Array.isArray(elem) && typeof elem !== "string") console.warn(`Operation expects an Array or a String, but got ${elem} (${typeof elem})`);
+    return elem == null ? "" : Array.isArray(elem) ? Array.from(elem) : String(elem);
+  }
+  function fragmentToString(fragment) {
+    return (new XMLSerializer).serializeToString(fragment);
+  }
+  // A proxy method to wrap a fetch call in error handling
+  
+  // * url - the URL to fetch
+  // * additionalHeaders - an object of additional headers passed to fetch
+  
+    async function graciouslyFetch(url, additionalHeaders) {
+    try {
+      const response = await fetch(url, {
+        headers: {
+          "X-REQUESTED-WITH": "XmlHttpRequest",
+          ...additionalHeaders
+        }
+      });
+      if (response == undefined) return;
+      handleErrors(response);
+      return response;
+    } catch (e) {
+      console.error(`Could not fetch ${url}`);
+    }
+  }
+  var utils =  Object.freeze({
+    __proto__: null,
+    after: after,
+    assignFocus: assignFocus,
+    before: before,
+    debounce: debounce,
+    dispatch: dispatch,
+    fragmentToString: fragmentToString,
+    getClassNames: getClassNames,
+    graciouslyFetch: graciouslyFetch,
+    handleErrors: handleErrors,
+    isTextInput: isTextInput,
+    kebabize: kebabize,
+    operate: operate,
+    processElements: processElements,
+    safeArray: safeArray,
+    safeObject: safeObject,
+    safeScalar: safeScalar,
+    safeString: safeString,
+    safeStringOrArray: safeStringOrArray,
+    xpathToElement: xpathToElement,
+    xpathToElementArray: xpathToElementArray
+  });
+  // Indicates whether or not we should morph an element via onBeforeElUpdated callback
+  // SEE: https://github.com/patrick-steele-idem/morphdom#morphdomfromnode-tonode-options--node
+  
+    const shouldMorph = operation => (fromEl, toEl) => !shouldMorphCallbacks.map((callback => typeof callback === "function" ? callback(operation, fromEl, toEl) : true)).includes(false)
+  // Execute any pluggable functions that modify elements after morphing via onElUpdated callback
+  
+  ;
+  const didMorph = operation => el => {
+    didMorphCallbacks.forEach((callback => {
+      if (typeof callback === "function") callback(operation, el);
+    }));
+  };
+  const verifyNotMutable = (detail, fromEl, toEl) => {
+    // Skip nodes that are equal:
+    // https://github.com/patrick-steele-idem/morphdom#can-i-make-morphdom-blaze-through-the-dom-tree-even-faster-yes
+    if (!mutableTags[fromEl.tagName] && fromEl.isEqualNode(toEl)) return false;
+    return true;
+  };
+  const verifyNotContentEditable = (detail, fromEl, toEl) => {
+    if (fromEl === ActiveElement.element && fromEl.isContentEditable) return false;
+    return true;
+  };
+  const verifyNotPermanent = (detail, fromEl, toEl) => {
+    const {permanentAttributeName: permanentAttributeName} = detail;
+    if (!permanentAttributeName) return true;
+    const permanent = fromEl.closest(`[${permanentAttributeName}]`);
+    // only morph attributes on the active non-permanent text input
+        if (!permanent && fromEl === ActiveElement.element && isTextInput(fromEl)) {
+      const ignore = {
+        value: true
+      };
+      Array.from(toEl.attributes).forEach((attribute => {
+        if (!ignore[attribute.name]) fromEl.setAttribute(attribute.name, attribute.value);
+      }));
+      return false;
+    }
+    return !permanent;
+  };
+  const shouldMorphCallbacks = [ verifyNotMutable, verifyNotPermanent, verifyNotContentEditable ];
+  const didMorphCallbacks = [];
+  var morph_callbacks =  Object.freeze({
+    __proto__: null,
+    didMorph: didMorph,
+    didMorphCallbacks: didMorphCallbacks,
+    shouldMorph: shouldMorph,
+    shouldMorphCallbacks: shouldMorphCallbacks,
+    verifyNotContentEditable: verifyNotContentEditable,
+    verifyNotMutable: verifyNotMutable,
+    verifyNotPermanent: verifyNotPermanent
+  });
+  var Operations = {
+    // DOM Mutations
+    append: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, focusSelector: focusSelector} = operation;
+          element.insertAdjacentHTML("beforeend", safeScalar(html));
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    graft: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {parent: parent, focusSelector: focusSelector} = operation;
+          const parentElement = document.querySelector(parent);
+          if (parentElement) {
+            parentElement.appendChild(element);
+            assignFocus(focusSelector);
+          }
+        }));
+        after(element, operation);
+      }));
+    },
+    innerHtml: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, focusSelector: focusSelector} = operation;
+          element.innerHTML = safeScalar(html);
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    insertAdjacentHtml: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, position: position, focusSelector: focusSelector} = operation;
+          element.insertAdjacentHTML(position || "beforeend", safeScalar(html));
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    insertAdjacentText: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {text: text, position: position, focusSelector: focusSelector} = operation;
+          element.insertAdjacentText(position || "beforeend", safeScalar(text));
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    outerHtml: operation => {
+      processElements(operation, (element => {
+        const parent = element.parentElement;
+        const idx = parent && Array.from(parent.children).indexOf(element);
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, focusSelector: focusSelector} = operation;
+          element.outerHTML = safeScalar(html);
+          assignFocus(focusSelector);
+        }));
+        after(parent ? parent.children[idx] : document.documentElement, operation);
+      }));
+    },
+    prepend: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, focusSelector: focusSelector} = operation;
+          element.insertAdjacentHTML("afterbegin", safeScalar(html));
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    remove: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {focusSelector: focusSelector} = operation;
+          element.remove();
+          assignFocus(focusSelector);
+        }));
+        after(document, operation);
+      }));
+    },
+    replace: operation => {
+      processElements(operation, (element => {
+        const parent = element.parentElement;
+        const idx = parent && Array.from(parent.children).indexOf(element);
+        before(element, operation);
+        operate(operation, (() => {
+          const {html: html, focusSelector: focusSelector} = operation;
+          element.outerHTML = safeScalar(html);
+          assignFocus(focusSelector);
+        }));
+        after(parent ? parent.children[idx] : document.documentElement, operation);
+      }));
+    },
+    textContent: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {text: text, focusSelector: focusSelector} = operation;
+          element.textContent = safeScalar(text);
+          assignFocus(focusSelector);
+        }));
+        after(element, operation);
+      }));
+    },
+    // Element Property Mutations
+    addCssClass: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name} = operation;
+          element.classList.add(...getClassNames([ safeStringOrArray(name) ]));
+        }));
+        after(element, operation);
+      }));
+    },
+    removeAttribute: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name} = operation;
+          element.removeAttribute(safeString(name));
+        }));
+        after(element, operation);
+      }));
+    },
+    removeCssClass: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name} = operation;
+          element.classList.remove(...getClassNames([ safeStringOrArray(name) ]));
+          if (element.classList.length === 0) element.removeAttribute("class");
+        }));
+        after(element, operation);
+      }));
+    },
+    setAttribute: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name, value: value} = operation;
+          element.setAttribute(safeString(name), safeScalar(value));
+        }));
+        after(element, operation);
+      }));
+    },
+    setDatasetProperty: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name, value: value} = operation;
+          element.dataset[safeString(name)] = safeScalar(value);
+        }));
+        after(element, operation);
+      }));
+    },
+    setProperty: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name, value: value} = operation;
+          if (name in element) element[safeString(name)] = safeScalar(value);
+        }));
+        after(element, operation);
+      }));
+    },
+    setStyle: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name, value: value} = operation;
+          element.style[safeString(name)] = safeScalar(value);
+        }));
+        after(element, operation);
+      }));
+    },
+    setStyles: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {styles: styles} = operation;
+          for (let [name, value] of Object.entries(styles)) element.style[safeString(name)] = safeScalar(value);
+        }));
+        after(element, operation);
+      }));
+    },
+    setValue: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {value: value} = operation;
+          element.value = safeScalar(value);
+        }));
+        after(element, operation);
+      }));
+    },
+    // DOM Events and Meta-Operations
+    dispatchEvent: operation => {
+      processElements(operation, (element => {
+        before(element, operation);
+        operate(operation, (() => {
+          const {name: name, detail: detail} = operation;
+          dispatch(element, safeString(name), safeObject(detail));
+        }));
+        after(element, operation);
+      }));
+    },
+    setMeta: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {name: name, content: content} = operation;
+        let meta = document.head.querySelector(`meta[name='${name}']`);
+        if (!meta) {
+          meta = document.createElement("meta");
+          meta.name = safeString(name);
+          document.head.appendChild(meta);
+        }
+        meta.content = safeScalar(content);
+      }));
+      after(document, operation);
+    },
+    setTitle: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {title: title} = operation;
+        document.title = safeScalar(title);
+      }));
+      after(document, operation);
+    },
+    // Browser Manipulations
+    clearStorage: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {type: type} = operation;
+        const storage = type === "session" ? sessionStorage : localStorage;
+        storage.clear();
+      }));
+      after(document, operation);
+    },
+    go: operation => {
+      before(window, operation);
+      operate(operation, (() => {
+        const {delta: delta} = operation;
+        history.go(delta);
+      }));
+      after(window, operation);
+    },
+    pushState: operation => {
+      before(window, operation);
+      operate(operation, (() => {
+        const {state: state, title: title, url: url} = operation;
+        history.pushState(safeObject(state), safeString(title), safeString(url));
+      }));
+      after(window, operation);
+    },
+    redirectTo: operation => {
+      before(window, operation);
+      operate(operation, (() => {
+        let {url: url, action: action, turbo: turbo} = operation;
+        action = action || "advance";
+        url = safeString(url);
+        if (turbo === undefined) turbo = true;
+        if (turbo) {
+          if (window.Turbo) window.Turbo.visit(url, {
+            action: action
+          });
+          if (window.Turbolinks) window.Turbolinks.visit(url, {
+            action: action
+          });
+          if (!window.Turbo && !window.Turbolinks) window.location.href = url;
+        } else {
+          window.location.href = url;
+        }
+      }));
+      after(window, operation);
+    },
+    reload: operation => {
+      before(window, operation);
+      operate(operation, (() => {
+        window.location.reload();
+      }));
+      after(window, operation);
+    },
+    removeStorageItem: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {key: key, type: type} = operation;
+        const storage = type === "session" ? sessionStorage : localStorage;
+        storage.removeItem(safeString(key));
+      }));
+      after(document, operation);
+    },
+    replaceState: operation => {
+      before(window, operation);
+      operate(operation, (() => {
+        const {state: state, title: title, url: url} = operation;
+        history.replaceState(safeObject(state), safeString(title), safeString(url));
+      }));
+      after(window, operation);
+    },
+    scrollIntoView: operation => {
+      const {element: element} = operation;
+      before(element, operation);
+      operate(operation, (() => {
+        element.scrollIntoView(operation);
+      }));
+      after(element, operation);
+    },
+    setCookie: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {cookie: cookie} = operation;
+        document.cookie = safeScalar(cookie);
+      }));
+      after(document, operation);
+    },
+    setFocus: operation => {
+      const {element: element} = operation;
+      before(element, operation);
+      operate(operation, (() => {
+        assignFocus(element);
+      }));
+      after(element, operation);
+    },
+    setStorageItem: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {key: key, value: value, type: type} = operation;
+        const storage = type === "session" ? sessionStorage : localStorage;
+        storage.setItem(safeString(key), safeScalar(value));
+      }));
+      after(document, operation);
+    },
+    // Notifications
+    consoleLog: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {message: message, level: level} = operation;
+        level && [ "warn", "info", "error" ].includes(level) ? console[level](message) : console.log(message);
+      }));
+      after(document, operation);
+    },
+    consoleTable: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {data: data, columns: columns} = operation;
+        console.table(data, safeArray(columns));
+      }));
+      after(document, operation);
+    },
+    notification: operation => {
+      before(document, operation);
+      operate(operation, (() => {
+        const {title: title, options: options} = operation;
+        Notification.requestPermission().then((result => {
+          operation.permission = result;
+          if (result === "granted") new Notification(safeString(title), safeObject(options));
+        }));
+      }));
+      after(document, operation);
+    },
+    // Morph operations
+    morph: operation => {
+      processElements(operation, (element => {
+        const {html: html} = operation;
+        const template = document.createElement("template");
+        template.innerHTML = String(safeScalar(html)).trim();
+        operation.content = template.content;
+        const parent = element.parentElement;
+        const idx = parent && Array.from(parent.children).indexOf(element);
+        before(element, operation);
+        operate(operation, (() => {
+          const {childrenOnly: childrenOnly, focusSelector: focusSelector} = operation;
+          morphdom(element, childrenOnly ? template.content : template.innerHTML, {
+            childrenOnly: !!childrenOnly,
+            onBeforeElUpdated: shouldMorph(operation),
+            onElUpdated: didMorph(operation)
+          });
+          assignFocus(focusSelector);
+        }));
+        after(parent ? parent.children[idx] : document.documentElement, operation);
+      }));
+    }
+  };
+  let operations = Operations;
+  const add = newOperations => {
+    operations = {
+      ...operations,
+      ...newOperations
+    };
+  };
+  const addOperations = operations => {
+    add(operations);
+  };
+  const addOperation = (name, operation) => {
+    const operations = {};
+    operations[name] = operation;
+    add(operations);
+  };
+  var OperationStore = {
+    get all() {
+      return operations;
+    }
+  };
+  let missingElement = "warn";
+  var MissingElement$1 = {
+    get behavior() {
+      return missingElement;
+    },
+    set(value) {
+      if ([ "warn", "ignore", "event", "exception" ].includes(value)) missingElement = value; else console.warn("Invalid 'onMissingElement' option. Defaulting to 'warn'.");
+    }
+  };
+  const perform = (operations, options = {
+    onMissingElement: MissingElement$1.behavior
+  }) => {
+    const batches = {};
+    operations.forEach((operation => {
+      if (!!operation.batch) batches[operation.batch] = batches[operation.batch] ? ++batches[operation.batch] : 1;
+    }));
+    operations.forEach((operation => {
+      const name = operation.operation;
+      try {
+        if (operation.selector) {
+          if (operation.xpath) {
+            operation.element = operation.selectAll ? xpathToElementArray(operation.selector) : xpathToElement(operation.selector);
+          } else {
+            operation.element = operation.selectAll ? document.querySelectorAll(operation.selector) : document.querySelector(operation.selector);
+          }
+        } else {
+          operation.element = document;
+        }
+        if (operation.element || options.onMissingElement !== "ignore") {
+          ActiveElement.set(document.activeElement);
+          const cableReadyOperation = OperationStore.all[name];
+          if (cableReadyOperation) {
+            cableReadyOperation(operation);
+            if (!!operation.batch && --batches[operation.batch] === 0) dispatch(document, "cable-ready:batch-complete", {
+              batch: operation.batch
+            });
+          } else {
+            console.error(`CableReady couldn't find the "${name}" operation. Make sure you use the camelized form when calling an operation method.`);
+          }
+        }
+      } catch (e) {
+        if (operation.element) {
+          console.error(`CableReady detected an error in ${name || "operation"}: ${e.message}. If you need to support older browsers make sure you've included the corresponding polyfills. https://docs.stimulusreflex.com/setup#polyfills-for-ie11.`);
+          console.error(e);
+        } else {
+          const warning = `CableReady ${name || ""} operation failed due to missing DOM element for selector: '${operation.selector}'`;
+          switch (options.onMissingElement) {
+           case "ignore":
+            break;
+
+           case "event":
+            dispatch(document, "cable-ready:missing-element", {
+              warning: warning,
+              operation: operation
+            });
+            break;
+
+           case "exception":
+            throw warning;
+
+           default:
+            console.warn(warning);
+          }
+        }
+      }
+    }));
+  };
+  const performAsync = (operations, options = {
+    onMissingElement: MissingElement$1.behavior
+  }) => new Promise(((resolve, reject) => {
+    try {
+      resolve(perform(operations, options));
+    } catch (err) {
+      reject(err);
+    }
+  }));
+  class SubscribingElement extends HTMLElement {
+    static get tagName() {
+      throw new Error("Implement the tagName() getter in the inheriting class");
+    }
+    static define() {
+      if (!customElements.get(this.tagName)) {
+        customElements.define(this.tagName, this);
+      }
+    }
+    disconnectedCallback() {
+      if (this.channel) this.channel.unsubscribe();
+    }
+    createSubscription(consumer, channel, receivedCallback) {
+      this.channel = consumer.subscriptions.create({
+        channel: channel,
+        identifier: this.identifier
+      }, {
+        received: receivedCallback
+      });
+    }
+    get preview() {
+      return document.documentElement.hasAttribute("data-turbolinks-preview") || document.documentElement.hasAttribute("data-turbo-preview");
+    }
+    get identifier() {
+      return this.getAttribute("identifier");
+    }
+  }
+  let consumer;
+  const BACKOFF = [ 25, 50, 75, 100, 200, 250, 500, 800, 1e3, 2e3 ];
+  const wait = ms => new Promise((resolve => setTimeout(resolve, ms)));
+  const getConsumerWithRetry = async (retry = 0) => {
+    if (consumer) return consumer;
+    if (retry >= BACKOFF.length) {
+      throw new Error("Couldn't obtain a Action Cable consumer within 5s");
+    }
+    await wait(BACKOFF[retry]);
+    return await getConsumerWithRetry(retry + 1);
+  };
+  var CableConsumer = {
+    setConsumer(value) {
+      consumer = value;
+    },
+    get consumer() {
+      return consumer;
+    },
+    async getConsumer() {
+      return await getConsumerWithRetry();
+    }
+  };
+  class StreamFromElement extends SubscribingElement {
+    static get tagName() {
+      return "cable-ready-stream-from";
+    }
+    async connectedCallback() {
+      if (this.preview) return;
+      const consumer = await CableConsumer.getConsumer();
+      if (consumer) {
+        this.createSubscription(consumer, "CableReady::Stream", this.performOperations.bind(this));
+      } else {
+        console.error("The `cable_ready_stream_from` helper cannot connect. You must initialize CableReady with an Action Cable consumer.");
+      }
+    }
+    performOperations(data) {
+      if (data.cableReady) perform(data.operations, {
+        onMissingElement: this.onMissingElement
+      });
+    }
+    get onMissingElement() {
+      const value = this.getAttribute("missing") || MissingElement$1.behavior;
+      // stream_from does not support raising exceptions on missing elements because there's no way to catch them
+            if ([ "warn", "ignore", "event" ].includes(value)) return value; else {
+        console.warn("Invalid 'missing' attribute. Defaulting to 'warn'.");
+        return "warn";
+      }
+    }
+  }
+  let debugging = false;
+  var Debug = {
+    get enabled() {
+      return debugging;
+    },
+    get disabled() {
+      return !debugging;
+    },
+    get value() {
+      return debugging;
+    },
+    set(value) {
+      debugging = !!value;
+    },
+    set debug(value) {
+      debugging = !!value;
+    }
+  };
+  const request = (data, blocks) => {
+    if (Debug.disabled) return;
+    console.log(`↑ Updatable request affecting ${blocks.length} element(s): `, {
+      elements: blocks.map((b => b.element)),
+      identifiers: blocks.map((b => b.element.getAttribute("identifier"))),
+      data: data
+    });
+  };
+  const cancel = (timestamp, reason) => {
+    if (Debug.disabled) return;
+    const duration = new Date - timestamp;
+    console.log(`❌ Updatable request canceled after ${duration}ms: ${reason}`);
+  };
+  const response = (timestamp, element, urls) => {
+    if (Debug.disabled) return;
+    const duration = new Date - timestamp;
+    console.log(`↓ Updatable response: All URLs fetched in ${duration}ms`, {
+      element: element,
+      urls: urls
+    });
+  };
+  const morphStart = (timestamp, element) => {
+    if (Debug.disabled) return;
+    const duration = new Date - timestamp;
+    console.log(`↻ Updatable morph: starting after ${duration}ms`, {
+      element: element
+    });
+  };
+  const morphEnd = (timestamp, element) => {
+    if (Debug.disabled) return;
+    const duration = new Date - timestamp;
+    console.log(`↺ Updatable morph: completed after ${duration}ms`, {
+      element: element
+    });
+  };
+  var Log = {
+    request: request,
+    cancel: cancel,
+    response: response,
+    morphStart: morphStart,
+    morphEnd: morphEnd
+  };
+  const template = `\n<style>\n  :host {\n    display: block;\n  }\n</style>\n<slot></slot>\n`;
+  class UpdatesForElement extends SubscribingElement {
+    static get tagName() {
+      return "cable-ready-updates-for";
+    }
+    constructor() {
+      super();
+      const shadowRoot = this.attachShadow({
+        mode: "open"
+      });
+      shadowRoot.innerHTML = template;
+    }
+    async connectedCallback() {
+      if (this.preview) return;
+      this.update = debounce(this.update.bind(this), this.debounce);
+      const consumer = await CableConsumer.getConsumer();
+      if (consumer) {
+        this.createSubscription(consumer, "CableReady::Stream", this.update);
+      } else {
+        console.error("The `cable_ready_updates_for` helper cannot connect. You must initialize CableReady with an Action Cable consumer.");
+      }
+    }
+    async update(data) {
+      this.lastUpdateTimestamp = new Date;
+      const blocks = Array.from(document.querySelectorAll(this.query), (element => new Block(element))).filter((block => block.shouldUpdate(data)));
+      Log.request(data, blocks);
+      if (blocks.length === 0) {
+        Log.cancel(this.lastUpdateTimestamp, "All elements filtered out");
+        return;
+      }
+      // first <cable-ready-updates-for> element in the DOM *at any given moment* updates all of the others
+            if (blocks[0].element !== this) {
+        Log.cancel(this.lastUpdateTimestamp, "Update already requested");
+        return;
+      }
+      // hold a reference to the active element so that it can be restored after the morph
+            ActiveElement.set(document.activeElement);
+      // store all retrieved HTML in an object keyed by URL to minimize fetch calls
+            this.html = {};
+      const uniqueUrls = [ ...new Set(blocks.map((block => block.url))) ];
+      await Promise.all(uniqueUrls.map((async url => {
+        if (!this.html.hasOwnProperty(url)) {
+          const response = await graciouslyFetch(url, {
+            "X-Cable-Ready": "update"
+          });
+          this.html[url] = await response.text();
+        }
+      })));
+      Log.response(this.lastUpdateTimestamp, this, uniqueUrls);
+      // track current block index for each URL; referred to as fragments
+            this.index = {};
+      blocks.forEach((block => {
+        // if the block's URL is not in the index, initialize it to 0; otherwise, increment it
+        this.index.hasOwnProperty(block.url) ? this.index[block.url]++ : this.index[block.url] = 0;
+        block.process(data, this.html, this.index, this.lastUpdateTimestamp);
+      }));
+    }
+    get query() {
+      return `${this.tagName}[identifier="${this.identifier}"]`;
+    }
+    get identifier() {
+      return this.getAttribute("identifier");
+    }
+    get debounce() {
+      return this.hasAttribute("debounce") ? parseInt(this.getAttribute("debounce")) : 20;
+    }
+  }
+  class Block {
+    constructor(element) {
+      this.element = element;
+    }
+    async process(data, html, index, startTimestamp) {
+      const blockIndex = index[this.url];
+      const template = document.createElement("template");
+      this.element.setAttribute("updating", "updating");
+      template.innerHTML = String(html[this.url]).trim();
+      await this.resolveTurboFrames(template.content);
+      const fragments = template.content.querySelectorAll(this.query);
+      if (fragments.length <= blockIndex) {
+        console.warn(`Update aborted due to insufficient number of elements. The offending url is ${this.url}.`);
+        return;
+      }
+      const operation = {
+        element: this.element,
+        html: fragments[blockIndex],
+        permanentAttributeName: "data-ignore-updates"
+      };
+      dispatch(this.element, "cable-ready:before-update", operation);
+      Log.morphStart(startTimestamp, this.element);
+      morphdom(this.element, fragments[blockIndex], {
+        childrenOnly: true,
+        onBeforeElUpdated: shouldMorph(operation),
+        onElUpdated: _ => {
+          this.element.removeAttribute("updating");
+          dispatch(this.element, "cable-ready:after-update", operation);
+          assignFocus(operation.focusSelector);
+        }
+      });
+      Log.morphEnd(startTimestamp, this.element);
+    }
+    async resolveTurboFrames(documentFragment) {
+      const reloadingTurboFrames = [ ...documentFragment.querySelectorAll('turbo-frame[src]:not([loading="lazy"])') ];
+      return Promise.all(reloadingTurboFrames.map((frame => new Promise((async resolve => {
+        const frameResponse = await graciouslyFetch(frame.getAttribute("src"), {
+          "Turbo-Frame": frame.id,
+          "X-Cable-Ready": "update"
+        });
+        const frameTemplate = document.createElement("template");
+        frameTemplate.innerHTML = await frameResponse.text();
+        // recurse here to get all nested eager loaded frames
+                await this.resolveTurboFrames(frameTemplate.content);
+        const selector = `turbo-frame#${frame.id}`;
+        const frameContent = frameTemplate.content.querySelector(selector);
+        const content = frameContent ? frameContent.innerHTML.trim() : "";
+        documentFragment.querySelector(selector).innerHTML = content;
+        resolve();
+      })))));
+    }
+    shouldUpdate(data) {
+      // if everything that could prevent an update is false, update this block
+      return !this.ignoresInnerUpdates && this.hasChangesSelectedForUpdate(data);
+    }
+    hasChangesSelectedForUpdate(data) {
+      // if there's an only attribute, only update if at least one of the attributes changed is in the allow list
+      const only = this.element.getAttribute("only");
+      return !(only && data.changed && !only.split(" ").some((attribute => data.changed.includes(attribute))));
+    }
+    get ignoresInnerUpdates() {
+      // don't update during a Reflex or Turbolinks redraw
+      return this.element.hasAttribute("ignore-inner-updates") && this.element.hasAttribute("performing-inner-update");
+    }
+    get url() {
+      return this.element.hasAttribute("url") ? this.element.getAttribute("url") : location.href;
+    }
+    get identifier() {
+      return this.element.identifier;
+    }
+    get query() {
+      return this.element.query;
+    }
+  }
+  const registerInnerUpdates = () => {
+    document.addEventListener("stimulus-reflex:before", (event => {
+      recursiveMarkUpdatesForElements(event.detail.element);
+    }));
+    document.addEventListener("stimulus-reflex:after", (event => {
+      setTimeout((() => {
+        recursiveUnmarkUpdatesForElements(event.detail.element);
+      }));
+    }));
+    document.addEventListener("turbo:submit-start", (event => {
+      recursiveMarkUpdatesForElements(event.target);
+    }));
+    document.addEventListener("turbo:submit-end", (event => {
+      setTimeout((() => {
+        recursiveUnmarkUpdatesForElements(event.target);
+      }));
+    }));
+    document.addEventListener("turbo-boost:command:start", (event => {
+      recursiveMarkUpdatesForElements(event.target);
+    }));
+    document.addEventListener("turbo-boost:command:finish", (event => {
+      setTimeout((() => {
+        recursiveUnmarkUpdatesForElements(event.target);
+      }));
+    }));
+    document.addEventListener("turbo-boost:command:error", (event => {
+      setTimeout((() => {
+        recursiveUnmarkUpdatesForElements(event.target);
+      }));
+    }));
+  };
+  const recursiveMarkUpdatesForElements = leaf => {
+    const closestUpdatesFor = leaf && leaf.parentElement && leaf.parentElement.closest("cable-ready-updates-for");
+    if (closestUpdatesFor) {
+      closestUpdatesFor.setAttribute("performing-inner-update", "");
+      recursiveMarkUpdatesForElements(closestUpdatesFor);
+    }
+  };
+  const recursiveUnmarkUpdatesForElements = leaf => {
+    const closestUpdatesFor = leaf && leaf.parentElement && leaf.parentElement.closest("cable-ready-updates-for");
+    if (closestUpdatesFor) {
+      closestUpdatesFor.removeAttribute("performing-inner-update");
+      recursiveUnmarkUpdatesForElements(closestUpdatesFor);
+    }
+  };
+  const defineElements = () => {
+    registerInnerUpdates();
+    StreamFromElement.define();
+    UpdatesForElement.define();
+  };
+  const initialize = (initializeOptions = {}) => {
+    const {consumer: consumer, onMissingElement: onMissingElement, debug: debug} = initializeOptions;
+    Debug.set(!!debug);
+    if (consumer) {
+      CableConsumer.setConsumer(consumer);
+    } else {
+      console.error("CableReady requires a reference to your Action Cable `consumer` for its helpers to function.\nEnsure that you have imported the `CableReady` package as well as `consumer` from your `channels` folder, then call `CableReady.initialize({ consumer })`.");
+    }
+    if (onMissingElement) {
+      MissingElement.set(onMissingElement);
+    }
+    defineElements();
+  };
+  const global = {
+    perform: perform,
+    performAsync: performAsync,
+    shouldMorphCallbacks: shouldMorphCallbacks,
+    didMorphCallbacks: didMorphCallbacks,
+    initialize: initialize,
+    addOperation: addOperation,
+    addOperations: addOperations,
+    version: packageInfo.version,
+    cable: CableConsumer,
+    get DOMOperations() {
+      console.warn("DEPRECATED: Please use `CableReady.operations` instead of `CableReady.DOMOperations`");
+      return OperationStore.all;
+    },
+    get operations() {
+      return OperationStore.all;
+    },
+    get consumer() {
+      return CableConsumer.consumer;
+    }
+  };
+  window.CableReady = global;
+  exports.MorphCallbacks = morph_callbacks;
+  exports.StreamFromElement = StreamFromElement;
+  exports.SubscribingElement = SubscribingElement;
+  exports.UpdatesForElement = UpdatesForElement;
+  exports.Utils = utils;
+  exports.default = global;
+  Object.defineProperty(exports, "__esModule", {
+    value: true
+  });
+}));