ep_author_hover 11.0.24 → 11.0.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/AGENTS.md +71 -0
- package/package.json +1 -1
package/AGENTS.md
ADDED
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Agent Guide — ep_author_hover
|
|
2
|
+
|
|
3
|
+
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.
|
|
4
|
+
|
|
5
|
+
## Tech stack
|
|
6
|
+
|
|
7
|
+
* Etherpad plugin framework (hooks declared in `ep.json`)
|
|
8
|
+
* EJS templates rendered server-side via `eejsBlock_*` hooks
|
|
9
|
+
* html10n for i18n (`locales/<lang>.json`, `data-l10n-id` in templates)
|
|
10
|
+
|
|
11
|
+
## Project structure
|
|
12
|
+
|
|
13
|
+
```
|
|
14
|
+
ep_author_hover/
|
|
15
|
+
├── AGENTS.md
|
|
16
|
+
├── CONTRIBUTING.md
|
|
17
|
+
├── ep.json
|
|
18
|
+
├── index.js
|
|
19
|
+
├── locales/
|
|
20
|
+
│ ├── ar.json
|
|
21
|
+
│ ├── be-tarask.json
|
|
22
|
+
│ ├── be.json
|
|
23
|
+
│ ├── blk.json
|
|
24
|
+
│ ├── bn.json
|
|
25
|
+
│ ├── ca.json
|
|
26
|
+
│ └── ...
|
|
27
|
+
├── package.json
|
|
28
|
+
├── static/
|
|
29
|
+
│ ├── js/
|
|
30
|
+
│ ├── tests/
|
|
31
|
+
├── templates/
|
|
32
|
+
│ ├── settings.ejs
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Helpers used
|
|
36
|
+
|
|
37
|
+
_None — `ep_plugin_helpers` is not a dependency. Adoption is part of the helpers-adoption sweep (Phase 4)._
|
|
38
|
+
|
|
39
|
+
|
|
40
|
+
## Helpers NOT used
|
|
41
|
+
|
|
42
|
+
_To be audited in the helpers-adoption sweep (Phase 4)._
|
|
43
|
+
|
|
44
|
+
|
|
45
|
+
## Running tests locally
|
|
46
|
+
|
|
47
|
+
`ep_author_hover` runs inside Etherpad's test harness. From an etherpad checkout that has installed this plugin via `pnpm run plugins i --path ../ep_author_hover`:
|
|
48
|
+
|
|
49
|
+
```bash
|
|
50
|
+
# Backend (Mocha) — harness boots its own server
|
|
51
|
+
pnpm --filter ep_etherpad-lite run test
|
|
52
|
+
|
|
53
|
+
# Playwright — needs `pnpm run dev` in a second terminal
|
|
54
|
+
pnpm --filter ep_etherpad-lite run test-ui
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
## Standing rules for agent edits
|
|
58
|
+
|
|
59
|
+
* PRs target `main`. Linear commits, no merge commits.
|
|
60
|
+
* Every bug fix includes a regression test in the same commit.
|
|
61
|
+
* All user-facing strings in `locales/`. No hardcoded English in templates.
|
|
62
|
+
* No hardcoded `aria-label` on icon-only controls — etherpad's html10n auto-populates `aria-label` from the localized string when (a) the element has a `data-l10n-id` and (b) no author-supplied `aria-label` is present. Adding a hardcoded English `aria-label` blocks that and leaves it untranslated. (See `etherpad-lite/src/static/js/vendors/html10n.ts:665-678`.)
|
|
63
|
+
* No nested interactive elements (no `<button>` inside `<a>`).
|
|
64
|
+
* LLM/Agent contributions are explicitly welcomed by maintainers.
|
|
65
|
+
|
|
66
|
+
## Quick reference: hooks declared in `ep.json`
|
|
67
|
+
|
|
68
|
+
* Server: `eejsBlock_mySettings`
|
|
69
|
+
* Client: `postAceInit`
|
|
70
|
+
|
|
71
|
+
When adding a hook, register it in both `ep.json` *and* the matching `exports.<hook> = ...` in the JS file.
|
package/package.json
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
},
|
|
7
7
|
"name": "ep_author_hover",
|
|
8
8
|
"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.",
|
|
9
|
-
"version": "11.0.
|
|
9
|
+
"version": "11.0.25",
|
|
10
10
|
"repository": {
|
|
11
11
|
"type": "git",
|
|
12
12
|
"url": "https://github.com/ether/ep_author_hover.git"
|