atv-rails 0.0.2 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 56a16b60a9e77c2d47522fde79c3014f0ebcab6e6e72f418f362d22cdb0e8a83
-  data.tar.gz: f51f3976b0484469e6c63eb4e13da56d9ff95e6ca5317177ebd64eee50c1ad99
+  metadata.gz: 90eed2550de006c017a7e04a41aa89ffe9d3d0e34740c9cb6d9fc5c17c418537
+  data.tar.gz: d4c9e9bb798ee12cd2eda572d1300deb897fad1eee53bfb949d28cd9f341f2c9
 SHA512:
-  metadata.gz: b744f9784980219fb4b2094b7b79c53509224cc10e4c4e4c5a244a4a6621d6ef3a597f8f784a10e775c7c43798761f9fce4d4dd0bc781d4e9fd359a87f8ce441
-  data.tar.gz: dad98bc4ce0092bcc113eb6f0a0fed8d6405fd3b6a98af76222f4013aaf6c8a61a06339d3fa546371db811f9052d1002d56cf6a25a7001cafcb5b0396dd98d8c
+  metadata.gz: 020f55905f8884bb5268f14d82a027a9c06aca7aaa71d652cf869f6d752779093183c489d0161565f575b79b08a496d44fd5a28f6142df4d8ac82ab541637714
+  data.tar.gz: fb0b1c821179e7f0a1588288d3be1be9ca1056c42ea65fdeacfb8e1e7617693a3a9c1183e8cfec2683fd17d90c3c0aca11408f2b8dfd7e7cc4b8022e976a36df

data/README.md

@@ -1,8 +1,8 @@
-# Atv::Rails
-Short description and motivation.
+# ATV
+JavaScript for Rails Curmudgeons.
 
 ## Usage
-How to use my plugin.
+TBD
 
 ## Installation
 Add this line to your application's Gemfile:

data/app/assets/javascripts/atv.js

@@ -0,0 +1,664 @@
+/*global
+  console, document, MutationObserver
+*/
+/*jslint white*/
+
+//
+// ATV.js: Actions, Targets, Values
+//
+// Super vanilla JS / Lightweight alternative to stimulus without "class"
+// overhead and binding nonsense, just the actions, targets, and values
+// Also more forgiving with hyphens and underscores.
+
+// The MIT License (MIT)
+
+// Copyright (c) 2024 Timothy Breitkreutz
+
+// Permission is hereby granted, free of charge, to any person obtaining a copy
+// of this software and associated documentation files (the "Software"), to deal
+// in the Software without restriction, including without limitation the rights
+// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+// copies of the Software, and to permit persons to whom the Software is
+// furnished to do so, subject to the following conditions:
+
+// The above copyright notice and this permission notice shall be included in
+// all copies or substantial portions of the Software.
+
+// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+// THE SOFTWARE.
+
+const version = "0.1.9";
+
+// To dynamically load up the ATV javascripts if needed
+function importMap() {
+  return JSON.parse(
+    document.querySelector("script[type='importmap']").innerText
+  ).imports;
+}
+
+/* ----------------- HELPER FUNCTIONS ------------------ */
+
+/* Variant in the context of ATV means either dash-case or snake_case */
+const variantPattern = /[\-_]/;
+
+function pascalize(string) {
+  return string
+    .split(variantPattern)
+    .map((str) => str.charAt(0).toUpperCase() + str.slice(1))
+    .join("");
+}
+
+function dasherize(string) {
+  return string.replace(/_/g, "-");
+}
+
+const deCommaPattern = /,[\s+]/;
+
+/* The following methods returns combinations of the given list
+ * connected with dashes and underscores.  For many examples see
+ * test/system/unit_test.rb
+ */
+function allVariants(...words) {
+  const parts = words.filter((arg) => Boolean(arg));
+  if (parts.length === 0) {
+    return [];
+  }
+  return dashVariants(...parts).flatMap((string) => [string, `${string}s`]);
+}
+
+function dashVariants(firstWord, ...words) {
+  function dashOrUnderscore(input) {
+    const string = input || "";
+    if (variantPattern.test(string)) {
+      return [dasherize(string), string.replace(/-/g, "_")];
+    }
+    return [string];
+  }
+  const first = dashOrUnderscore(firstWord);
+  if (words.length < 1) {
+    return first;
+  }
+  return dashVariants(...words).flatMap((str2) =>
+    first.flatMap((str1) => [`${str1}-${str2}`, `${str1}_${str2}`])
+  );
+}
+
+/* Returns a list of selectors to use for given name list */
+function variantSelectors(container, ...words) {
+  return allVariants("data", ...words).flatMap((variant) =>
+    Array.from(container.querySelectorAll(`[${variant}]`)).map((element) => [
+      element,
+      variant
+    ])
+  );
+}
+
+/* JSON is parsed aggressively and relies on "try" */
+function errorReport(ex) {
+  if (ex?.message?.includes("JSON")) {
+    return;
+  }
+  console.error(`ATV: ${ex}`);
+}
+
+/*
+ * Gets all action declarations for an element, returns an array of structures.
+ */
+function actionsFor(prefix, element, onlyEvent = null) {
+  let result = [];
+  const paramSeparator = /[()]/;
+
+  // Parse a single action part, controller is passed in
+  // if derived from the attribute key
+  function parseAction(action, controller) {
+    let method;
+    let parameters = [];
+    let [event, rightSide] = action.split(/[\s]*[\-=]>[\s]*/);
+
+    // Figure out what to do with the part on the right of the "=> blah#blah"
+    if (rightSide) {
+      let [innerController, methodCall] = rightSide.split("#");
+      if (methodCall) {
+        controller = innerController;
+      } else {
+        methodCall = innerController;
+      }
+      method = methodCall;
+    } else {
+      method = event;
+    }
+    const [methodName, params] = method.split(paramSeparator);
+    if (params) {
+      method = methodName;
+      parameters = params.split(deCommaPattern);
+      try {
+        parameters = JSON.parse(`[${params}]`);
+      } catch (ex) {
+        errorReport(ex);
+      }
+      event = event.split("(")[0];
+    }
+    // Sometimes we only care about a given event name passed in.
+    if (onlyEvent && event !== onlyEvent) {
+      return;
+    }
+    if (!controller) {
+      controller = method;
+      method = event;
+    }
+    result.push({
+      controller: dasherize(controller),
+      event,
+      method,
+      parameters
+    });
+  }
+
+  // Split on commas as long as they are not inside parameter lists.
+  function actionSplit(string, callback) {
+    let paramDepth = 0;
+    let accumulator = [];
+    Array.from(string).forEach(function (char) {
+      if (char === "," && paramDepth === 0) {
+        callback(accumulator.join("").trim());
+        accumulator = [];
+        return;
+      }
+      accumulator.push(char);
+      if (char === "(") {
+        paramDepth += 1;
+      } else if (char === ")") {
+        paramDepth -= 1;
+      }
+    });
+    const last = accumulator.join("").trim();
+    if (paramDepth !== 0) {
+      console.error(`badly formed parameters: ${string}`);
+    }
+    if (last) {
+      callback(last);
+    }
+  }
+
+  element.getAttributeNames().forEach(function (name) {
+    const unqualified = new RegExp(`^data[_-]${prefix}[_-]?action[s]?`);
+    const qualified = new RegExp(
+      `^data[_-]${prefix}[_-]?(.*[^-_])[_-]?action[s]?`
+    );
+
+    let controller;
+    let matched = name.match(qualified);
+    if (matched) {
+      controller = matched[1];
+    } else {
+      controller = null;
+      matched = name.match(unqualified);
+    }
+    if (!matched) {
+      return;
+    }
+    let list = element.getAttribute(name);
+    if (list) {
+      try {
+        list = JSON.parse(list).join(",");
+      } catch (ex) {
+        errorReport(ex);
+      }
+      actionSplit(list, (action) => parseAction(action, controller));
+    }
+  });
+  return result;
+}
+
+function attributeKeysFor(element, type) {
+  if (!element || !element.getAttributeNames) {
+    return [];
+  }
+  const regex = new RegExp(`${type}s?$`, "i");
+  return element.getAttributeNames().filter((name) => regex.test(name));
+}
+
+// Returns a list of attributes for the type (controller, target, action, etc.)
+function attributesFor(element, type) {
+  return attributeKeysFor(element, type).map((name) =>
+    element.getAttribute(name)
+  );
+}
+
+const allControllerNames = new Set();
+const allTargets = new Map();
+let allControllers = new Map();
+
+// The three maps above all have the same structure: prefix
+// first (atv, etc.), then element, then a Map of those things.
+function findOrInitalize(map, prefix, element, initial = null) {
+  if (!map.has(prefix)) {
+    map.set(prefix, new Map());
+  }
+  if (!map.get(prefix).has(element)) {
+    map.get(prefix).set(element, initial ?? new Map());
+  }
+  return map.get(prefix).get(element);
+}
+
+/* Look for the controllers in the importmap or just try to load them */
+function withModule(name, callback) {
+  let importmapName = `${name}_atv`;
+  const map = importMap();
+  Object.keys(map).forEach(function (source) {
+    if (dasherize(source).includes(`/${name}-atv`)) {
+      importmapName = map[source]; // There should only be one
+    }
+  });
+  import(importmapName)
+    .then(function (module) {
+      callback(module);
+    })
+    .catch(function (ex) {
+      console.error(`Loading ${importmapName} failed:`, ex);
+    });
+}
+
+/* ----------------- Main Activation Function ------------------ */
+
+function activate(prefix = "atv") {
+  if (allControllers.has(prefix)) {
+    return;
+  }
+  const root = document.body;
+
+  // Provide selector for any controllers given a prefix
+
+  const controllersSelector = allVariants("data", prefix, "controller")
+    .map((selector) => `[${selector}]`)
+    .join(",");
+
+  // To allow for nesting controllers:
+  // skip if it's not the nearest enclosing controller
+  function outOfScope(element, root, name) {
+    if (!element || element.nodeType === "BODY") {
+      return true;
+    }
+    const closestRoot = element.closest(controllersSelector);
+    if (!closestRoot) {
+      return true;
+    }
+    let out = false;
+    attributesFor(closestRoot, "controller").forEach(function (attr) {
+      const list = attr.split(deCommaPattern).map((str) => dasherize(str));
+      if (list.includes(name)) {
+        out = !(closestRoot === root);
+      } else {
+        out = outOfScope(closestRoot.parentNode, root, name);
+      }
+    });
+    return out;
+  }
+
+  // Optional console output mainly for development
+  const quiet = !document.querySelector(`[data-${prefix}-report="true"]`);
+  function report(count, type, action) {
+    if (quiet || count < 1) {
+      return;
+    }
+    console.log(
+      [
+        [
+          "ATV:",
+          `(${prefix})`,
+          type,
+          `[${Number(allControllers.get(prefix)?.size)}]`
+        ].join(" "),
+        `${action}: ${count}`,
+        `v${version}`
+      ].join(" / ")
+    );
+  }
+
+  /* ----------------- Controller Factory ------------------ */
+
+  function createController(root, name) {
+    let actions;
+    let targets = {};
+    let values = {};
+    allControllerNames.add(name);
+
+    function getActions() {
+      return actions;
+    }
+
+    function registerActions(root) {
+      const controllers = findOrInitalize(allControllers, prefix, root);
+
+      let elements = new Set();
+      function collectElements(item) {
+        const [element] = item;
+        elements.add(element);
+      }
+      variantSelectors(root, prefix, name, "action").forEach(collectElements);
+      variantSelectors(root, prefix, "action").forEach(collectElements);
+
+      // Find each element that has this type of controller
+      Array.from(elements).forEach(function (element) {
+        // Get action definitions
+        const list = actionsFor(prefix, element);
+        // Collect the events
+        const eventNames = new Set(list.map((action) => action.event));
+        // Make one handler for each event type
+        eventNames.forEach(function (eventName) {
+          const firstForEvent = list.find(
+            (action) => action.event === eventName
+          );
+          if (firstForEvent?.controller !== name) {
+            return;
+          }
+
+          function invokeNext(event, actions) {
+            if (actions.length < 1) {
+              return;
+            }
+            const action = actions[0];
+            if (
+              action.event === eventName &&
+              !outOfScope(element, root, action.controller)
+            ) {
+              const callbacks = controllers.get(action.controller).getActions();
+              const callback = callbacks[action.method];
+              let result;
+              if (callback) {
+                try {
+                  result = callback(event.target, event, action.parameters);
+                } catch (error) {
+                  console.error(`ATV ${prefix}: ${eventName}->${name}`, error);
+                }
+                if (result === false) {
+                  event.stopPropagation();
+                  return;
+                }
+              }
+            }
+            if (actions.length > 1) {
+              return invokeNext(event, actions.slice(1));
+            }
+          }
+          element.addEventListener(eventName, (event) =>
+            invokeNext(event, list)
+          );
+        });
+      });
+    }
+
+    // Update the in-memory controller from the DOM
+    function refresh() {
+      function refreshTargets(root, middle) {
+        const addedTargets = {};
+        function collectionKeys(key) {
+          return [`all${pascalize(key)}`, `${key}s`];
+        }
+
+        variantSelectors(root.parentNode, prefix, name, "target").forEach(
+          function (item) {
+            const [element, variant] = item;
+            element
+              .getAttribute(variant)
+              .split(deCommaPattern)
+              .forEach(function (key) {
+                const [allKey, pluralKey] = collectionKeys(key);
+                if (
+                  targets[key] === element ||
+                  (targets[allKey] && targets[allKey].includes(element)) ||
+                  outOfScope(element, root, name)
+                ) {
+                  return;
+                }
+                if (targets[allKey]) {
+                  targets[allKey].push(element);
+                  targets[pluralKey].push(element);
+                } else if (targets[key]) {
+                  targets[allKey] = [targets[key], element];
+                  targets[pluralKey] = [targets[key], element];
+                  // delete targets[key];
+                } else {
+                  targets[key] = element;
+                }
+                if (!addedTargets[key]) {
+                  addedTargets[key] = [];
+                }
+                addedTargets[key].push(element);
+              });
+          }
+        );
+        middle();
+        // This part needs to happen after the controller "activate".
+        Object.keys(addedTargets).forEach(function (key) {
+          const connectedCallback = actions[`${key}TargetConnected`];
+          if (connectedCallback) {
+            addedTargets[key].forEach(connectedCallback);
+          }
+          const disconnectedCallback = actions[`${key}TargetDisconnected`];
+          if (disconnectedCallback) {
+            addedTargets[key].forEach(function (element) {
+              findOrInitalize(allTargets, prefix, element, []).push(
+                function () {
+                  const [allKey, pluralKey] = collectionKeys(key);
+                  let index = targets[allKey]?.indexOf(element);
+                  if (index) {
+                    targets[allKey].splice(index, 1);
+                  }
+                  index = targets[pluralKey]?.indexOf(element);
+                  if (index) {
+                    targets[pluralKey].splice(index, 1);
+                  }
+                  if (targets[key] === element) {
+                    if (targets[allKey]) {
+                      targets[key] = targets[allKey][0];
+                    } else {
+                      delete targets[allKey];
+                    }
+                  }
+                  disconnectedCallback(element);
+                }
+              );
+            });
+          }
+        });
+      }
+
+      function refreshValues(element) {
+        allVariants("data", prefix, name, "value").forEach(function (variant) {
+          const data = element.getAttribute(variant);
+          if (!data) {
+            return;
+          }
+          [data, `{${data}}`].forEach(function (json) {
+            try {
+              Object.assign(values, JSON.parse(json));
+            } catch (ex) {
+              errorReport(ex);
+            }
+          });
+        });
+      }
+
+      // Note that with module includes a promise return so this part finishes
+      // asynchronously.
+      withModule(name, function (module) {
+        refreshTargets(root, function () {
+          refreshValues(root);
+          const invoked = module.connect(
+            targets,
+            values,
+            root,
+            controllerBySelectorAndName
+          );
+          // Allow for returning an collection of actions or
+          // a function returning a collection of actions
+          if (typeof invoked === "function") {
+            actions = invoked();
+          } else {
+            actions = invoked;
+          }
+          registerActions(root);
+        });
+      });
+    }
+
+    /** The public controller object */
+    const controller = Object.freeze({
+      getActions,
+      refresh
+    });
+    return controller;
+  }
+
+  function registerControllers(root) {
+    findOrInitalize(allControllers, prefix, root);
+
+    attributesFor(root, "controller").forEach(function (attribute) {
+      attribute.split(deCommaPattern).forEach(function (controllerName) {
+        const name = dasherize(controllerName);
+        const controller =
+          allControllers.get(prefix).get(root).get(name) ||
+          createController(root, name);
+        controller.refresh();
+        allControllers.get(prefix).get(root).set(name, controller);
+      });
+    });
+  }
+
+  function updateControllers(root) {
+    let initialCount = 0;
+    if (allControllers?.has(prefix)) {
+      initialCount = Number(allControllers.get(prefix).size);
+    }
+    const elements = new Set();
+    if (root.matches(controllersSelector)) {
+      elements.add(root);
+    }
+    root
+      .querySelectorAll(controllersSelector)
+      .forEach((element) => elements.add(element));
+    elements.forEach(registerControllers);
+
+    if (allControllers.has(prefix)) {
+      report(
+        allControllers.get(prefix).size - initialCount,
+        "controllers",
+        "found"
+      );
+    }
+  }
+
+  updateControllers(root);
+
+  const observer = new MutationObserver(domWatcher);
+
+  /* --- Provided to client code to talk to other controllers --- */
+  function controllerBySelectorAndName(selector, name, callback) {
+    document.querySelectorAll(selector).forEach(function (element) {
+      let controller = findOrInitalize(allControllers, prefix, element)?.get(
+        name
+      );
+      if (controller) {
+        callback({
+          actions: controller.getActions()
+        });
+      }
+    });
+  }
+
+  /* ------------ React to DOM changes for this prefix --------------- */
+
+  function domWatcher(records, observer) {
+    function cleanup(node) {
+      // Hard reset
+      if (
+        node.nodeName === "BODY" ||
+        node.nodeName === "HTML" ||
+        node.nodeName === "#document"
+      ) {
+        observer.disconnect();
+        allControllers = new Map();
+        return;
+      }
+      // Inner DOM reset
+      function cleanTargets(element) {
+        if (element && element.children.length > 0) {
+          Array.from(element.children).forEach(cleanTargets);
+        }
+        const disconnectors = allTargets.get(prefix)?.get(element);
+        if (disconnectors) {
+          disconnectors.forEach((callback) => callback());
+          disconnectors.splice(0, disconnectors.length);
+        }
+      }
+      function cleanActions(element) {
+        const controllers = findOrInitalize(allControllers, prefix, element);
+        if (controllers) {
+          controllers.forEach(function (controller) {
+            const disconnect = controller.getActions().disconnect;
+            if (disconnect) {
+              disconnect();
+            }
+          });
+          allControllers.get(prefix).delete(element);
+        }
+      }
+      cleanTargets(node);
+      node.querySelectorAll(controllersSelector).forEach(cleanActions);
+      cleanActions(node);
+    }
+
+    function controllerFor(element, name) {
+      if (!element || element === document.body) {
+        return;
+      }
+      return (
+        findOrInitalize(allControllers, prefix, element)?.get(name) ||
+        controllerFor(element.parentNode, name)
+      );
+    }
+
+    function updateTargets(element) {
+      Array.from(allControllerNames).forEach(function (name) {
+        controllerFor(element, name)?.refresh();
+        variantSelectors(element, prefix, name, "target").forEach(
+          function (item) {
+            controllerFor(item[0], name)?.refresh();
+          }
+        );
+      });
+    }
+
+    function HTMLElements(node) {
+      return Boolean(node.classList);
+    }
+    records.forEach(function (mutation) {
+      if (mutation.type === "childList") {
+        Array.from(mutation.removedNodes)
+          .filter(HTMLElements)
+          .forEach((node) => cleanup(node));
+      }
+    });
+    records.forEach(function (mutation) {
+      if (mutation.type === "childList") {
+        Array.from(mutation.addedNodes)
+          .filter(HTMLElements)
+          .forEach(function (node) {
+            updateTargets(node);
+            updateControllers(node);
+          });
+      }
+    });
+  }
+
+  const config = { childList: true, subtree: true };
+  observer.observe(document, config);
+}
+
+export { activate, version };

data/app/assets/javascripts/atv.min.js

@@ -0,0 +1,4 @@
+// @sbrew.com/atv@0.1.9 downloaded from https://ga.jspm.io/npm:@sbrew.com/atv@0.1.9/atv.js
+
+const t="0.1.9";function importMap(){return JSON.parse(document.querySelector("script[type='importmap']").innerText).imports}const e=/[\-_]/;function pascalize(t){return t.split(e).map((t=>t.charAt(0).toUpperCase()+t.slice(1))).join("")}function dasherize(t){return t.replace(/_/g,"-")}const n=/,[\s+]/;function allVariants(...t){const e=t.filter((t=>Boolean(t)));return e.length===0?[]:dashVariants(...e).flatMap((t=>[t,`${t}s`]))}function dashVariants(t,...n){function dashOrUnderscore(t){const n=t||"";return e.test(n)?[dasherize(n),n.replace(/-/g,"_")]:[n]}const r=dashOrUnderscore(t);return n.length<1?r:dashVariants(...n).flatMap((t=>r.flatMap((e=>[`${e}-${t}`,`${e}_${t}`]))))}function variantSelectors(t,...e){return allVariants("data",...e).flatMap((e=>Array.from(t.querySelectorAll(`[${e}]`)).map((t=>[t,e]))))}function errorReport(t){t?.message?.includes("JSON")||console.error(`ATV: ${t}`)}function actionsFor(t,e,r=null){let o=[];const c=/[()]/;function parseAction(t,e){let i;let a=[];let[s,l]=t.split(/[\s]*[\-=]>[\s]*/);if(l){let[t,n]=l.split("#");n?e=t:n=t;i=n}else i=s;const[f,u]=i.split(c);if(u){i=f;a=u.split(n);try{a=JSON.parse(`[${u}]`)}catch(t){errorReport(t)}s=s.split("(")[0]}if(!r||s===r){if(!e){e=i;i=s}o.push({controller:dasherize(e),event:s,method:i,parameters:a})}}function actionSplit(t,e){let n=0;let r=[];Array.from(t).forEach((function(t){if(t!==","||n!==0){r.push(t);t==="("?n+=1:t===")"&&(n-=1)}else{e(r.join("").trim());r=[]}}));const o=r.join("").trim();n!==0&&console.error(`badly formed parameters: ${t}`);o&&e(o)}e.getAttributeNames().forEach((function(n){const r=new RegExp(`^data[_-]${t}[_-]?action[s]?`);const o=new RegExp(`^data[_-]${t}[_-]?(.*[^-_])[_-]?action[s]?`);let c;let i=n.match(o);if(i)c=i[1];else{c=null;i=n.match(r)}if(!i)return;let a=e.getAttribute(n);if(a){try{a=JSON.parse(a).join(",")}catch(t){errorReport(t)}actionSplit(a,(t=>parseAction(t,c)))}}));return o}function attributeKeysFor(t,e){if(!t||!t.getAttributeNames)return[];const n=new RegExp(`${e}s?$`,"i");return t.getAttributeNames().filter((t=>n.test(t)))}function attributesFor(t,e){return attributeKeysFor(t,e).map((e=>t.getAttribute(e)))}const r=new Set;const o=new Map;let c=new Map;function findOrInitalize(t,e,n,r=null){t.has(e)||t.set(e,new Map);t.get(e).has(n)||t.get(e).set(n,r??new Map);return t.get(e).get(n)}function withModule(t,e){let n=`${t}_atv`;const r=importMap();Object.keys(r).forEach((function(e){dasherize(e).includes(`/${t}-atv`)&&(n=r[e])}));import(n).then((function(t){e(t)})).catch((function(t){console.error(`Loading ${n} failed:`,t)}))}function activate(e="atv"){if(c.has(e))return;const i=document.body;const a=allVariants("data",e,"controller").map((t=>`[${t}]`)).join(",");function outOfScope(t,e,r){if(!t||t.nodeType==="BODY")return true;const o=t.closest(a);if(!o)return true;let c=false;attributesFor(o,"controller").forEach((function(t){const i=t.split(n).map((t=>dasherize(t)));c=i.includes(r)?!(o===e):outOfScope(o.parentNode,e,r)}));return c}const s=!document.querySelector(`[data-${e}-report="true"]`);function report(n,r,o){s||n<1||console.log([["ATV:",`(${e})`,r,`[${Number(c.get(e)?.size)}]`].join(" "),`${o}: ${n}`,`v${t}`].join(" / "))}function createController(t,i){let a;let s={};let l={};r.add(i);function getActions(){return a}function registerActions(t){const n=findOrInitalize(c,e,t);let r=new Set;function collectElements(t){const[e]=t;r.add(e)}variantSelectors(t,e,i,"action").forEach(collectElements);variantSelectors(t,e,"action").forEach(collectElements);Array.from(r).forEach((function(r){const o=actionsFor(e,r);const c=new Set(o.map((t=>t.event)));c.forEach((function(c){const a=o.find((t=>t.event===c));a?.controller===i&&r.addEventListener(c,(t=>invokeNext(t,o)));function invokeNext(o,a){if(a.length<1)return;const s=a[0];if(s.event===c&&!outOfScope(r,t,s.controller)){const t=n.get(s.controller).getActions();const r=t[s.method];let a;if(r){try{a=r(o.target,o,s.parameters)}catch(t){console.error(`ATV ${e}: ${c}->${i}`,t)}if(a===false){o.stopPropagation();return}}}return a.length>1?invokeNext(o,a.slice(1)):void 0}}))}))}function refresh(){function refreshTargets(t,r){const c={};function collectionKeys(t){return[`all${pascalize(t)}`,`${t}s`]}variantSelectors(t.parentNode,e,i,"target").forEach((function(e){const[r,o]=e;r.getAttribute(o).split(n).forEach((function(e){const[n,o]=collectionKeys(e);if(!(s[e]===r||s[n]&&s[n].includes(r)||outOfScope(r,t,i))){if(s[n]){s[n].push(r);s[o].push(r)}else if(s[e]){s[n]=[s[e],r];s[o]=[s[e],r]}else s[e]=r;c[e]||(c[e]=[]);c[e].push(r)}}))}));r();Object.keys(c).forEach((function(t){const n=a[`${t}TargetConnected`];n&&c[t].forEach(n);const r=a[`${t}TargetDisconnected`];r&&c[t].forEach((function(n){findOrInitalize(o,e,n,[]).push((function(){const[e,o]=collectionKeys(t);let c=s[e]?.indexOf(n);c&&s[e].splice(c,1);c=s[o]?.indexOf(n);c&&s[o].splice(c,1);s[t]===n&&(s[e]?s[t]=s[e][0]:delete s[e]);r(n)}))}))}))}function refreshValues(t){allVariants("data",e,i,"value").forEach((function(e){const n=t.getAttribute(e);n&&[n,`{${n}}`].forEach((function(t){try{Object.assign(l,JSON.parse(t))}catch(t){errorReport(t)}}))}))}withModule(i,(function(e){refreshTargets(t,(function(){refreshValues(t);const n=e.connect(s,l,t,controllerBySelectorAndName);a=typeof n==="function"?n():n;registerActions(t)}))}))}const f=Object.freeze({getActions:getActions,refresh:refresh});return f}function registerControllers(t){findOrInitalize(c,e,t);attributesFor(t,"controller").forEach((function(r){r.split(n).forEach((function(n){const r=dasherize(n);const o=c.get(e).get(t).get(r)||createController(t,r);o.refresh();c.get(e).get(t).set(r,o)}))}))}function updateControllers(t){let n=0;c?.has(e)&&(n=Number(c.get(e).size));const r=new Set;t.matches(a)&&r.add(t);t.querySelectorAll(a).forEach((t=>r.add(t)));r.forEach(registerControllers);c.has(e)&&report(c.get(e).size-n,"controllers","found")}updateControllers(i);const l=new MutationObserver(domWatcher);function controllerBySelectorAndName(t,n,r){document.querySelectorAll(t).forEach((function(t){let o=findOrInitalize(c,e,t)?.get(n);o&&r({actions:o.getActions()})}))}function domWatcher(t,n){function cleanup(t){if(t.nodeName!=="BODY"&&t.nodeName!=="HTML"&&t.nodeName!=="#document"){cleanTargets(t);t.querySelectorAll(a).forEach(cleanActions);cleanActions(t)}else{n.disconnect();c=new Map}function cleanTargets(t){t&&t.children.length>0&&Array.from(t.children).forEach(cleanTargets);const n=o.get(e)?.get(t);if(n){n.forEach((t=>t()));n.splice(0,n.length)}}function cleanActions(t){const n=findOrInitalize(c,e,t);if(n){n.forEach((function(t){const e=t.getActions().disconnect;e&&e()}));c.get(e).delete(t)}}}function controllerFor(t,n){if(t&&t!==document.body)return findOrInitalize(c,e,t)?.get(n)||controllerFor(t.parentNode,n)}function updateTargets(t){Array.from(r).forEach((function(n){controllerFor(t,n)?.refresh();variantSelectors(t,e,n,"target").forEach((function(t){controllerFor(t[0],n)?.refresh()}))}))}function HTMLElements(t){return Boolean(t.classList)}t.forEach((function(t){t.type==="childList"&&Array.from(t.removedNodes).filter(HTMLElements).forEach((t=>cleanup(t)))}));t.forEach((function(t){t.type==="childList"&&Array.from(t.addedNodes).filter(HTMLElements).forEach((function(t){updateTargets(t);updateControllers(t)}))}))}const f={childList:true,subtree:true};l.observe(document,f)}export{activate,t as version};
+

data/lib/atv/engine.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module ATV
+  class Engine < ::Rails::Engine
+    JAVASCRIPTS = %w[atv.js atv.min.js].freeze
+
+    initializer "ATV.configure_rails_initialization" do
+      if Rails.application.config.respond_to?(:assets)
+        Rails.application.config.assets.precompile += JAVASCRIPTS
+      end
+    end
+  end
+end

data/lib/atv/version.rb

@@ -0,0 +1,3 @@
+module ATV
+  VERSION = "0.0.4"
+end

data/lib/atv-rails.rb

@@ -0,0 +1,5 @@
+module ATV
+end
+
+require "atv/version"
+require "atv/engine"

data/lib/generators/atv/USAGE

@@ -0,0 +1,14 @@
+Description:
+============
+    Generates a new ATV controller at the passed path.
+
+Examples:
+=========
+    bin/rails generate atv chat
+
+    creates: app/javascript/controllers/chat_atv.js
+
+
+    bin/rails generate stimulus nested/chat
+
+    creates: app/javascript/controllers/nested/chat_atv.js

data/lib/generators/atv/atv_generator.rb

@@ -0,0 +1,19 @@
+require "rails/generators/named_base"
+
+class AtvGenerator < Rails::Generators::NamedBase # :nodoc:
+  source_root File.expand_path("templates", __dir__)
+
+  def copy_view_files
+    @attribute = attribute_value(controller_name)
+    template "controller.js", "app/javascript/controllers/#{controller_name}_atv.js"
+  end
+
+  private
+    def controller_name
+      name.underscore.gsub(/_atv$/, "")
+    end
+
+    def attribute_value(controller_name)
+      controller_name.gsub(/\//, "--").gsub("_", "-")
+    end
+end

data/lib/generators/atv/templates/controller.js.tt

@@ -0,0 +1,13 @@
+function connect(targets, values, element, controllers) {
+  return (function() {
+    // Object contains named methods plus disconnect, and target backs.
+    return {
+      click: function(actor, event, params) {
+      },
+      disconnect: function() {
+      }
+    }
+  });
+};
+
+export { connect };

data/lib/tasks/atv.rake

@@ -0,0 +1,37 @@
+namespace :atv do
+  desc "Install ATV into this rails app"
+  task :install do
+    importmap_file = "config/importmap.rb"
+    pin_command = %(pin "@sbrew.com/atv", to: "atv.min.js")
+    installed = false
+
+    # Add importmap
+    if File.exist?(importmap_file)
+      if File.read(importmap_file).include?(pin_command)
+        puts "Importmap already pinned, no change"
+        installed = true
+      end
+    end
+    unless installed
+      File.open(importmap_file, "a") do |file|
+        file.puts(pin_command)
+      end
+    end
+
+    # Add to application.js
+    application_js_file = "app/javascript/application.js"
+    included = false
+
+    if File.exist?(application_js_file)
+      if File.read(application_js_file).match?(/import.*activate.*sbrew.*atv/)
+        puts "Javascript already included, no change"
+        included = true
+      end
+    end
+    unless included
+      File.open(application_js_file, "a") do |file|
+        file.puts %[import { activate } from "@sbrew.com/atv"; activate("atv");]
+      end
+    end
+  end
+end

metadata

@@ -1,30 +1,58 @@
 --- !ruby/object:Gem::Specification
 name: atv-rails
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.4
 platform: ruby
 authors:
 - Timothy Breitkreutz
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-23 00:00:00.000000000 Z
+date: 2025-01-01 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: railties
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 8.0.1
+        version: 7.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 8.0.1
-description: Functional alternative to Stimulus.js for Rails
+        version: 7.0.0
+- !ruby/object:Gem::Dependency
+  name: stimulus-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.0
+- !ruby/object:Gem::Dependency
+  name: importmap-rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.0
+description:
 email:
 - tim@sbrew.com
 executables: []
@@ -34,10 +62,15 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
-- lib/atv/rails.rb
-- lib/atv/rails/railtie.rb
-- lib/atv/rails/version.rb
-- lib/tasks/atv/rails_tasks.rake
+- app/assets/javascripts/atv.js
+- app/assets/javascripts/atv.min.js
+- lib/atv-rails.rb
+- lib/atv/engine.rb
+- lib/atv/version.rb
+- lib/generators/atv/USAGE
+- lib/generators/atv/atv_generator.rb
+- lib/generators/atv/templates/controller.js.tt
+- lib/tasks/atv.rake
 homepage: https://www.sbrew.com/atv
 licenses:
 - MIT
@@ -63,5 +96,5 @@ requirements: []
 rubygems_version: 3.5.22
 signing_key:
 specification_version: 4
-summary: Functional JavaScript for Rails
+summary: Functional JavaScript for Rails.
 test_files: []

data/lib/atv/rails/railtie.rb

@@ -1,6 +0,0 @@
-module Atv
-  module Rails
-    class Railtie < ::Rails::Railtie
-    end
-  end
-end

data/lib/atv/rails/version.rb

@@ -1,5 +0,0 @@
-module Atv
-  module Rails
-    VERSION = "0.0.2"
-  end
-end

data/lib/atv/rails.rb

@@ -1,8 +0,0 @@
-require "atv/rails/version"
-require "atv/rails/railtie"
-
-module Atv
-  module Rails
-    # Your code goes here...
-  end
-end

data/lib/tasks/atv/rails_tasks.rake

@@ -1,4 +0,0 @@
-# desc "Explaining what the task does"
-# task :atv_rails do
-#   # Task goes here
-# end