ep_author_hover 11.0.26 → 11.0.28

package/.github/workflows/backend-tests.yml

@@ -29,7 +29,7 @@ jobs:
       - uses: actions/setup-node@v6
         name: Install Node.js
         with:
-          node-version: 22
+          node-version: 25
       - uses: pnpm/action-setup@v6
         name: Install pnpm
         with:

package/.github/workflows/frontend-tests.yml

@@ -19,7 +19,7 @@ jobs:
       - uses: actions/setup-node@v6
         name: Install Node.js
         with:
-          node-version: 22
+          node-version: 25
       - uses: pnpm/action-setup@v6
         name: Install pnpm
         with:

package/.github/workflows/npmpublish.yml

@@ -23,7 +23,7 @@ jobs:
           # OIDC trusted publishing needs npm >= 11.5.1, which requires
           # Node >= 20.17.0. setup-node's `20` resolves to the latest
           # 20.x, which satisfies that.
-          node-version: 20
+          node-version: 25
           registry-url: https://registry.npmjs.org/
       - name: Upgrade npm to >=11.5.1 (required for trusted publishing)
         run: npm install -g npm@latest

package/ep.json

@@ -1,12 +1,17 @@
 {
   "parts": [
-  {
-    "name": "ep_author_hover",
-    "hooks" : {
-      "eejsBlock_mySettings": "ep_author_hover/index"
-    },
-    "client_hooks" : {
-      "postAceInit":"ep_author_hover/static/js/index"
+    {
+      "name": "ep_author_hover",
+      "hooks": {
+        "loadSettings": "ep_author_hover/index",
+        "clientVars": "ep_author_hover/index",
+        "eejsBlock_mySettings": "ep_author_hover/index",
+        "eejsBlock_padSettings": "ep_author_hover/index"
+      },
+      "client_hooks": {
+        "postAceInit": "ep_author_hover/static/js/index",
+        "handleClientMessage_CLIENT_MESSAGE": "ep_author_hover/static/js/index:handleClientMessage_CLIENT_MESSAGE"
+      }
     }
-  }]
+  ]
 }

package/index.js

@@ -1,12 +1,29 @@
 'use strict';
 
-const {template} = require('ep_plugin_helpers');
-const settings = require('ep_etherpad-lite/node/utils/Settings');
-
-exports.eejsBlock_mySettings = template('ep_author_hover/templates/settings.ejs', {
-  vars: () => ({
-    checked: settings.ep_author_hover &&
-        settings.ep_author_hover.disabledByDefault === true
-      ? '' : 'checked',
-  }),
+const {padToggle} = require('ep_plugin_helpers/pad-toggle-server');
+
+// Parallel User Settings + Pad Wide Settings checkboxes for "Show Author on
+// Hover". Helper owns markup, storage, broadcast, enforce, and i18n wiring.
+const authorHoverToggle = padToggle({
+  pluginName: 'ep_author_hover',
+  settingId: 'author-hover',
+  l10nId: 'ep_author_hover.showHoverLabel',
+  defaultLabel: 'Show Author on Hover',
+  defaultEnabled: true,
 });
+
+// Older settings.json used `ep_author_hover.disabledByDefault: true` to flip
+// the checkbox off. Translate to the helper's `defaultEnabled` so existing
+// installs keep their current behavior after the conversion.
+exports.loadSettings = async (hookName, args) => {
+  const ps = args && args.settings && args.settings.ep_author_hover;
+  if (ps && typeof ps.defaultEnabled !== 'boolean' &&
+      typeof ps.disabledByDefault === 'boolean') {
+    ps.defaultEnabled = !ps.disabledByDefault;
+  }
+  return authorHoverToggle.loadSettings(hookName, args);
+};
+
+exports.clientVars = authorHoverToggle.clientVars;
+exports.eejsBlock_mySettings = authorHoverToggle.eejsBlock_mySettings;
+exports.eejsBlock_padSettings = authorHoverToggle.eejsBlock_padSettings;

package/package.json

@@ -6,7 +6,7 @@
   },
   "name": "ep_author_hover",
   "description": "Adds author names to span titles (shows on hover), works as authors change their name.  Hover includes author color and fast switching between author spans.  Hat tip to Martyn York for the initial work on this.",
-  "version": "11.0.26",
+  "version": "11.0.28",
   "repository": {
     "type": "git",
     "url": "https://github.com/ether/ep_author_hover.git"
@@ -28,6 +28,6 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "ep_plugin_helpers": "^0.5.0"
+    "ep_plugin_helpers": "^0.5.2"
   }
 }

package/static/js/index.js

@@ -1,19 +1,35 @@
 'use strict';
 
-const padcookie = require('ep_etherpad-lite/static/js/pad_cookie').padcookie;
-import html10n from 'ep_etherpad-lite/static/js/vendors/html10n'
+// Sub-path import keeps the client bundle clean — the top-level
+// `ep_plugin_helpers` index pulls in server-only modules.
+const {padToggle} = require('ep_plugin_helpers/pad-toggle');
+import html10n from 'ep_etherpad-lite/static/js/vendors/html10n';
+
+// Same config as the server-side instance — must agree on pluginName,
+// settingId, l10nId, and defaultLabel so checkbox ids and clientVars line up.
+const authorHoverToggle = padToggle({
+  pluginName: 'ep_author_hover',
+  settingId: 'author-hover',
+  l10nId: 'ep_author_hover.showHoverLabel',
+  defaultLabel: 'Show Author on Hover',
+  defaultEnabled: true,
+});
+
+// Re-export so the helper sees pad-wide broadcasts and refreshes our state
+// when another user toggles the pad-wide checkbox.
+exports.handleClientMessage_CLIENT_MESSAGE = authorHoverToggle.handleClientMessage_CLIENT_MESSAGE;
 
 let timer = 0;
 
 const showAuthor = {
   enable: () => {
     $('iframe[name="ace_outer"]').contents().find('iframe')
-      .contents().find('#innerdocbody').on('mousemove',exports.showAuthor.hover);
+        .contents().find('#innerdocbody').on('mousemove', exports.showAuthor.hover);
   },
   disable: (context) => {
     context.ace.callWithAce((ace) => {
       const doc = ace.ace_getDocument();
-      $(doc).find('#innerdocbody').on('mousemove',null.bind(ace));
+      $(doc).find('#innerdocbody').on('mousemove', null.bind(ace));
     }, 'showAuthor', true);
   },
   hover: (span) => {
@@ -33,7 +49,7 @@ const showAuthor = {
       if (!authorId) { return; } // Default text isn't shown
       showAuthor.destroy(); // Destroy existing
       const authorNameAndColor =
-        showAuthor.authorNameAndColorFromAuthorId(authorId); // Get the authorName And Color
+          showAuthor.authorNameAndColorFromAuthorId(authorId);
       showAuthor.draw(span, authorNameAndColor.name, authorNameAndColor.color);
     }
   },
@@ -133,27 +149,17 @@ const showAuthor = {
 
 exports.postAceInit = (hookName, context) => {
   showAuthor.enable(context);
-  clientVars.plugins.plugins.ep_author_hover = {};
-  /* init */
-  if (padcookie.getPref('author-hover') === false) {
-    $('#options-author-hover').val();
-    $('#options-author-hover').prop('checked', false);
-    $('#options-author-hover').prop('checked', false);
-  } else {
-    $('#options-author-hover').prop('checked', true);
+  // Pre-existing public API: showAuthor.show() reads
+  // clientVars.plugins.plugins.ep_author_hover.enabled on every hover. Keep
+  // the field populated as the toggle changes so external integrations
+  // (and our own show() code) see the live state without rewiring.
+  if (!clientVars.plugins.plugins.ep_author_hover) {
+    clientVars.plugins.plugins.ep_author_hover = {};
   }
-
-  clientVars.plugins.plugins.ep_author_hover.enabled = !!$('#options-author-hover').is(':checked');
-
-  /* on click */
-  $('#options-author-hover').on('click', () => {
-    if ($('#options-author-hover').is(':checked')) {
-      clientVars.plugins.plugins.ep_author_hover.enabled = true;
-      padcookie.setPref('author-hover', true);
-    } else {
-      padcookie.setPref('author-hover', false);
-      clientVars.plugins.plugins.ep_author_hover.enabled = false;
-    }
+  authorHoverToggle.init({
+    onChange: (enabled) => {
+      clientVars.plugins.plugins.ep_author_hover.enabled = enabled;
+    },
   });
 };
 

package/templates/settings.ejs

@@ -1,6 +0,0 @@
-<p>
-    <input type="checkbox" id="options-author-hover" checked></input>
-    <label for="options-author-hover" data-l10n-id="ep_author_hover.showHoverLabel">
-      Show Author on Hover
-    </label>
-</p>