arethesis 0.2.0 → 0.2.1

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.
Files changed (339) hide show
  1. package/CHANGELOG.md +34 -0
  2. package/README.md +3 -2
  3. package/dist/arethesis.js +2 -222
  4. package/dist/binding/data-binder.d.ts +8 -0
  5. package/dist/binding/data-binder.d.ts.map +1 -1
  6. package/dist/binding/data-binder.js +605 -0
  7. package/dist/binding/data-binder.js.map +1 -0
  8. package/dist/binding/types.d.ts +20 -0
  9. package/dist/binding/types.d.ts.map +1 -1
  10. package/dist/binding/validation-engine.js +160 -0
  11. package/dist/binding/validation-engine.js.map +1 -0
  12. package/dist/cdn/arethesis.min.js +2 -0
  13. package/dist/cdn/arethesis.min.js.map +1 -0
  14. package/dist/cdn/chunks/CdTL-MEv.min.js +3 -0
  15. package/dist/cdn/chunks/CdTL-MEv.min.js.map +1 -0
  16. package/dist/cdn/components.min.js +81 -0
  17. package/dist/cdn/components.min.js.map +1 -0
  18. package/dist/collab/index.d.ts +22 -0
  19. package/dist/collab/index.d.ts.map +1 -0
  20. package/dist/collab/index.js +23 -0
  21. package/dist/collab/index.js.map +1 -0
  22. package/dist/components/component.d.ts +17 -0
  23. package/dist/components/component.d.ts.map +1 -1
  24. package/dist/components/component.js +765 -0
  25. package/dist/components/component.js.map +1 -0
  26. package/dist/components/decorators.js +27 -0
  27. package/dist/components/decorators.js.map +1 -0
  28. package/dist/components/form-associated.d.ts +55 -0
  29. package/dist/components/form-associated.d.ts.map +1 -0
  30. package/dist/components/form-associated.js +180 -0
  31. package/dist/components/form-associated.js.map +1 -0
  32. package/dist/components/runtime.d.ts +2 -0
  33. package/dist/components/runtime.d.ts.map +1 -1
  34. package/dist/components/runtime.js +18 -0
  35. package/dist/components/runtime.js.map +1 -0
  36. package/dist/components/template-loader.js +90 -0
  37. package/dist/components/template-loader.js.map +1 -0
  38. package/dist/components.js +2 -2810
  39. package/dist/core/arethesis.d.ts +13 -9
  40. package/dist/core/arethesis.d.ts.map +1 -1
  41. package/dist/core/arethesis.js +249 -0
  42. package/dist/core/arethesis.js.map +1 -0
  43. package/dist/core/hooks.d.ts +19 -0
  44. package/dist/core/hooks.d.ts.map +1 -0
  45. package/dist/core/hooks.js +23 -0
  46. package/dist/core/hooks.js.map +1 -0
  47. package/dist/core/index.d.ts +57 -0
  48. package/dist/core/index.d.ts.map +1 -0
  49. package/dist/core/index.js +25 -0
  50. package/dist/data/list-view-registry.js +300 -0
  51. package/dist/data/list-view-registry.js.map +1 -0
  52. package/dist/data/object-store.js +280 -0
  53. package/dist/data/object-store.js.map +1 -0
  54. package/dist/data/optimistic-updates.js +168 -0
  55. package/dist/data/optimistic-updates.js.map +1 -0
  56. package/dist/data/persistence-manager.js +233 -0
  57. package/dist/data/persistence-manager.js.map +1 -0
  58. package/dist/defaults.d.ts +1 -0
  59. package/dist/defaults.d.ts.map +1 -0
  60. package/dist/defaults.js +17 -0
  61. package/dist/defaults.js.map +1 -0
  62. package/dist/http/auth-manager.js +260 -0
  63. package/dist/http/auth-manager.js.map +1 -0
  64. package/dist/http/http-client.d.ts +7 -0
  65. package/dist/http/http-client.d.ts.map +1 -1
  66. package/dist/http/http-client.js +501 -0
  67. package/dist/http/http-client.js.map +1 -0
  68. package/dist/http/http-error.js +53 -0
  69. package/dist/http/http-error.js.map +1 -0
  70. package/dist/http/mapping.js +64 -0
  71. package/dist/http/mapping.js.map +1 -0
  72. package/dist/index.d.ts +3 -58
  73. package/dist/index.d.ts.map +1 -1
  74. package/dist/index.js +55 -0
  75. package/dist/kit/calendar.d.ts +43 -0
  76. package/dist/kit/calendar.d.ts.map +1 -0
  77. package/dist/kit/calendar.js +423 -0
  78. package/dist/kit/calendar.js.map +1 -0
  79. package/dist/kit/cell-editor.js +191 -0
  80. package/dist/kit/cell-editor.js.map +1 -0
  81. package/dist/kit/chart.d.ts +2 -0
  82. package/dist/kit/chart.d.ts.map +1 -1
  83. package/dist/kit/chart.js +541 -0
  84. package/dist/kit/chart.js.map +1 -0
  85. package/dist/kit/combobox.d.ts +57 -0
  86. package/dist/kit/combobox.d.ts.map +1 -0
  87. package/dist/kit/combobox.js +379 -0
  88. package/dist/kit/combobox.js.map +1 -0
  89. package/dist/kit/command-palette.d.ts +2 -0
  90. package/dist/kit/command-palette.d.ts.map +1 -1
  91. package/dist/kit/command-palette.js +315 -0
  92. package/dist/kit/command-palette.js.map +1 -0
  93. package/dist/kit/data-table.d.ts +11 -0
  94. package/dist/kit/data-table.d.ts.map +1 -1
  95. package/dist/kit/data-table.js +373 -0
  96. package/dist/kit/data-table.js.map +1 -0
  97. package/dist/kit/dialog.d.ts +31 -0
  98. package/dist/kit/dialog.d.ts.map +1 -0
  99. package/dist/kit/dialog.js +157 -0
  100. package/dist/kit/dialog.js.map +1 -0
  101. package/dist/kit/elements/calendar.d.ts +3 -0
  102. package/dist/kit/elements/calendar.d.ts.map +1 -0
  103. package/dist/kit/elements/calendar.js +11 -0
  104. package/dist/kit/elements/calendar.js.map +1 -0
  105. package/dist/kit/elements/chart.d.ts +3 -0
  106. package/dist/kit/elements/chart.d.ts.map +1 -0
  107. package/dist/kit/elements/chart.js +11 -0
  108. package/dist/kit/elements/chart.js.map +1 -0
  109. package/dist/kit/elements/combobox.d.ts +3 -0
  110. package/dist/kit/elements/combobox.d.ts.map +1 -0
  111. package/dist/kit/elements/combobox.js +11 -0
  112. package/dist/kit/elements/combobox.js.map +1 -0
  113. package/dist/kit/elements/command-palette.d.ts +3 -0
  114. package/dist/kit/elements/command-palette.d.ts.map +1 -0
  115. package/dist/kit/elements/command-palette.js +11 -0
  116. package/dist/kit/elements/command-palette.js.map +1 -0
  117. package/dist/kit/elements/data-table.d.ts +3 -0
  118. package/dist/kit/elements/data-table.d.ts.map +1 -0
  119. package/dist/kit/elements/data-table.js +11 -0
  120. package/dist/kit/elements/data-table.js.map +1 -0
  121. package/dist/kit/elements/dialog.d.ts +4 -0
  122. package/dist/kit/elements/dialog.d.ts.map +1 -0
  123. package/dist/kit/elements/dialog.js +11 -0
  124. package/dist/kit/elements/dialog.js.map +1 -0
  125. package/dist/kit/elements/flex-view.d.ts +3 -0
  126. package/dist/kit/elements/flex-view.d.ts.map +1 -0
  127. package/dist/kit/elements/flex-view.js +11 -0
  128. package/dist/kit/elements/flex-view.js.map +1 -0
  129. package/dist/kit/elements/form.d.ts +3 -0
  130. package/dist/kit/elements/form.d.ts.map +1 -0
  131. package/dist/kit/elements/form.js +11 -0
  132. package/dist/kit/elements/form.js.map +1 -0
  133. package/dist/kit/elements/kanban.d.ts +3 -0
  134. package/dist/kit/elements/kanban.d.ts.map +1 -0
  135. package/dist/kit/elements/kanban.js +11 -0
  136. package/dist/kit/elements/kanban.js.map +1 -0
  137. package/dist/kit/elements/list.d.ts +3 -0
  138. package/dist/kit/elements/list.d.ts.map +1 -0
  139. package/dist/kit/elements/list.js +11 -0
  140. package/dist/kit/elements/list.js.map +1 -0
  141. package/dist/kit/elements/markdown-editor.d.ts +3 -0
  142. package/dist/kit/elements/markdown-editor.d.ts.map +1 -0
  143. package/dist/kit/elements/markdown-editor.js +11 -0
  144. package/dist/kit/elements/markdown-editor.js.map +1 -0
  145. package/dist/kit/elements/presence.d.ts +3 -0
  146. package/dist/kit/elements/presence.d.ts.map +1 -0
  147. package/dist/kit/elements/presence.js +11 -0
  148. package/dist/kit/elements/presence.js.map +1 -0
  149. package/dist/kit/elements/sheet.d.ts +3 -0
  150. package/dist/kit/elements/sheet.d.ts.map +1 -0
  151. package/dist/kit/elements/sheet.js +11 -0
  152. package/dist/kit/elements/sheet.js.map +1 -0
  153. package/dist/kit/elements/tabs.d.ts +3 -0
  154. package/dist/kit/elements/tabs.d.ts.map +1 -0
  155. package/dist/kit/elements/tabs.js +11 -0
  156. package/dist/kit/elements/tabs.js.map +1 -0
  157. package/dist/kit/elements/toast.d.ts +4 -0
  158. package/dist/kit/elements/toast.d.ts.map +1 -0
  159. package/dist/kit/elements/toast.js +11 -0
  160. package/dist/kit/elements/toast.js.map +1 -0
  161. package/dist/kit/elements/tree.d.ts +3 -0
  162. package/dist/kit/elements/tree.d.ts.map +1 -0
  163. package/dist/kit/elements/tree.js +11 -0
  164. package/dist/kit/elements/tree.js.map +1 -0
  165. package/dist/kit/flex-view.d.ts +2 -0
  166. package/dist/kit/flex-view.d.ts.map +1 -1
  167. package/dist/kit/flex-view.js +346 -0
  168. package/dist/kit/flex-view.js.map +1 -0
  169. package/dist/kit/form.d.ts +2 -0
  170. package/dist/kit/form.d.ts.map +1 -1
  171. package/dist/kit/form.js +211 -0
  172. package/dist/kit/form.js.map +1 -0
  173. package/dist/kit/index.d.ts +15 -15
  174. package/dist/kit/index.d.ts.map +1 -1
  175. package/dist/kit/index.js +40 -0
  176. package/dist/kit/internal/modal.d.ts +26 -0
  177. package/dist/kit/internal/modal.d.ts.map +1 -0
  178. package/dist/kit/internal/modal.js +59 -0
  179. package/dist/kit/internal/modal.js.map +1 -0
  180. package/dist/kit/kanban.d.ts +73 -0
  181. package/dist/kit/kanban.d.ts.map +1 -0
  182. package/dist/kit/kanban.js +404 -0
  183. package/dist/kit/kanban.js.map +1 -0
  184. package/dist/kit/list.d.ts +4 -0
  185. package/dist/kit/list.d.ts.map +1 -1
  186. package/dist/kit/list.js +106 -0
  187. package/dist/kit/list.js.map +1 -0
  188. package/dist/kit/markdown/highlight.js +106 -0
  189. package/dist/kit/markdown/highlight.js.map +1 -0
  190. package/dist/kit/markdown/render.js +260 -0
  191. package/dist/kit/markdown/render.js.map +1 -0
  192. package/dist/kit/markdown-editor.d.ts +2 -0
  193. package/dist/kit/markdown-editor.d.ts.map +1 -1
  194. package/dist/kit/markdown-editor.js +797 -0
  195. package/dist/kit/markdown-editor.js.map +1 -0
  196. package/dist/kit/presence.d.ts +36 -0
  197. package/dist/kit/presence.d.ts.map +1 -0
  198. package/dist/kit/presence.js +262 -0
  199. package/dist/kit/presence.js.map +1 -0
  200. package/dist/kit/sheet/formula.js +364 -0
  201. package/dist/kit/sheet/formula.js.map +1 -0
  202. package/dist/kit/sheet/model.js +136 -0
  203. package/dist/kit/sheet/model.js.map +1 -0
  204. package/dist/kit/sheet/sheet.d.ts +2 -0
  205. package/dist/kit/sheet/sheet.d.ts.map +1 -1
  206. package/dist/kit/sheet/sheet.js +676 -0
  207. package/dist/kit/sheet/sheet.js.map +1 -0
  208. package/dist/kit/tabs.d.ts +17 -0
  209. package/dist/kit/tabs.d.ts.map +1 -0
  210. package/dist/kit/tabs.js +192 -0
  211. package/dist/kit/tabs.js.map +1 -0
  212. package/dist/kit/theme-boot.generated.js +8 -0
  213. package/dist/kit/theme-boot.generated.js.map +1 -0
  214. package/dist/kit/theme.js +89 -0
  215. package/dist/kit/theme.js.map +1 -0
  216. package/dist/kit/toast.d.ts +46 -0
  217. package/dist/kit/toast.d.ts.map +1 -0
  218. package/dist/kit/toast.js +154 -0
  219. package/dist/kit/toast.js.map +1 -0
  220. package/dist/kit/tree.d.ts +41 -0
  221. package/dist/kit/tree.d.ts.map +1 -0
  222. package/dist/kit/tree.js +422 -0
  223. package/dist/kit/tree.js.map +1 -0
  224. package/dist/mixins/context-menu.d.ts.map +1 -1
  225. package/dist/mixins/context-menu.js +183 -0
  226. package/dist/mixins/context-menu.js.map +1 -0
  227. package/dist/mixins/draggable.d.ts.map +1 -1
  228. package/dist/mixins/draggable.js +140 -0
  229. package/dist/mixins/draggable.js.map +1 -0
  230. package/dist/mixins/dropdown.d.ts.map +1 -1
  231. package/dist/mixins/dropdown.js +216 -0
  232. package/dist/mixins/dropdown.js.map +1 -0
  233. package/dist/mixins/editable.d.ts.map +1 -1
  234. package/dist/mixins/editable.js +175 -0
  235. package/dist/mixins/editable.js.map +1 -0
  236. package/dist/mixins/grid-navigation.d.ts.map +1 -1
  237. package/dist/mixins/grid-navigation.js +194 -0
  238. package/dist/mixins/grid-navigation.js.map +1 -0
  239. package/dist/mixins/index.d.ts +6 -2
  240. package/dist/mixins/index.d.ts.map +1 -1
  241. package/dist/mixins/index.js +38 -0
  242. package/dist/mixins/index.js.map +1 -0
  243. package/dist/mixins/infinite-scroll.d.ts.map +1 -1
  244. package/dist/mixins/infinite-scroll.js +83 -0
  245. package/dist/mixins/infinite-scroll.js.map +1 -0
  246. package/dist/mixins/listbox.d.ts.map +1 -1
  247. package/dist/mixins/listbox.js +208 -0
  248. package/dist/mixins/listbox.js.map +1 -0
  249. package/dist/mixins/popup.d.ts +36 -0
  250. package/dist/mixins/popup.d.ts.map +1 -0
  251. package/dist/mixins/popup.js +113 -0
  252. package/dist/mixins/popup.js.map +1 -0
  253. package/dist/mixins/registry.d.ts +6 -0
  254. package/dist/mixins/registry.d.ts.map +1 -1
  255. package/dist/mixins/registry.js +167 -0
  256. package/dist/mixins/registry.js.map +1 -0
  257. package/dist/mixins/resizable.d.ts.map +1 -1
  258. package/dist/mixins/resizable.js +128 -0
  259. package/dist/mixins/resizable.js.map +1 -0
  260. package/dist/mixins/sortable.d.ts.map +1 -1
  261. package/dist/mixins/sortable.js +511 -0
  262. package/dist/mixins/sortable.js.map +1 -0
  263. package/dist/mixins/tooltip.d.ts.map +1 -1
  264. package/dist/mixins/tooltip.js +80 -0
  265. package/dist/mixins/tooltip.js.map +1 -0
  266. package/dist/mixins/utils.js +105 -0
  267. package/dist/mixins/utils.js.map +1 -0
  268. package/dist/plugins/async-validators.js +118 -0
  269. package/dist/plugins/async-validators.js.map +1 -0
  270. package/dist/plugins/builtins.d.ts +1 -1
  271. package/dist/plugins/builtins.d.ts.map +1 -1
  272. package/dist/plugins/builtins.js +20 -0
  273. package/dist/plugins/builtins.js.map +1 -0
  274. package/dist/plugins/date-utils.js +128 -0
  275. package/dist/plugins/date-utils.js.map +1 -0
  276. package/dist/plugins/plugin-manager.d.ts.map +1 -1
  277. package/dist/plugins/plugin-manager.js +99 -0
  278. package/dist/plugins/plugin-manager.js.map +1 -0
  279. package/dist/plugins/rich-text.js +365 -0
  280. package/dist/plugins/rich-text.js.map +1 -0
  281. package/dist/realtime/azure-pubsub-manager.js +273 -0
  282. package/dist/realtime/azure-pubsub-manager.js.map +1 -0
  283. package/dist/realtime/collab/anchors.js +19 -0
  284. package/dist/realtime/collab/anchors.js.map +1 -0
  285. package/dist/realtime/collab/collab-session.js +396 -0
  286. package/dist/realtime/collab/collab-session.js.map +1 -0
  287. package/dist/realtime/collab/cursor-overlay.js +187 -0
  288. package/dist/realtime/collab/cursor-overlay.js.map +1 -0
  289. package/dist/realtime/collab/textarea-adapter.js +125 -0
  290. package/dist/realtime/collab/textarea-adapter.js.map +1 -0
  291. package/dist/realtime/collab/undo-manager.js +148 -0
  292. package/dist/realtime/collab/undo-manager.js.map +1 -0
  293. package/dist/realtime/index.d.ts +11 -0
  294. package/dist/realtime/index.d.ts.map +1 -0
  295. package/dist/realtime/index.js +22 -0
  296. package/dist/realtime/index.js.map +1 -0
  297. package/dist/realtime/ot/client.js +74 -0
  298. package/dist/realtime/ot/client.js.map +1 -0
  299. package/dist/realtime/ot/server.js +292 -0
  300. package/dist/realtime/ot/server.js.map +1 -0
  301. package/dist/realtime/ot/text-operation.js +282 -0
  302. package/dist/realtime/ot/text-operation.js.map +1 -0
  303. package/dist/realtime/reconnect.js +58 -0
  304. package/dist/realtime/reconnect.js.map +1 -0
  305. package/dist/realtime/sse-manager.js +172 -0
  306. package/dist/realtime/sse-manager.js.map +1 -0
  307. package/dist/realtime/websocket-manager.js +180 -0
  308. package/dist/realtime/websocket-manager.js.map +1 -0
  309. package/dist/theme.css +178 -0
  310. package/dist/utils/backoff.js +30 -0
  311. package/dist/utils/backoff.js.map +1 -0
  312. package/dist/utils/dates.js +67 -0
  313. package/dist/utils/dates.js.map +1 -0
  314. package/dist/utils/dom.js +30 -0
  315. package/dist/utils/dom.js.map +1 -0
  316. package/dist/utils/emitter.js +40 -0
  317. package/dist/utils/emitter.js.map +1 -0
  318. package/dist/utils/fuzzy.d.ts +2 -0
  319. package/dist/utils/fuzzy.d.ts.map +1 -1
  320. package/dist/utils/fuzzy.js +95 -0
  321. package/dist/utils/fuzzy.js.map +1 -0
  322. package/dist/utils/path.js +99 -0
  323. package/dist/utils/path.js.map +1 -0
  324. package/dist/utils/sanitize.js +161 -0
  325. package/dist/utils/sanitize.js.map +1 -0
  326. package/dist/utils/url.js +44 -0
  327. package/dist/utils/url.js.map +1 -0
  328. package/dist/utils/virtual-window.d.ts +25 -0
  329. package/dist/utils/virtual-window.d.ts.map +1 -0
  330. package/dist/utils/virtual-window.js +19 -0
  331. package/dist/utils/virtual-window.js.map +1 -0
  332. package/dist/version.d.ts +1 -1
  333. package/dist/version.js +6 -0
  334. package/dist/version.js.map +1 -0
  335. package/package.json +61 -11
  336. package/dist/arethesis.js.map +0 -1
  337. package/dist/components.js.map +0 -1
  338. package/dist/fuzzy-Dnlbxdby.js +0 -5752
  339. package/dist/fuzzy-Dnlbxdby.js.map +0 -1
@@ -0,0 +1,396 @@
1
+ import { OTClient } from "../ot/client.js";
2
+ import { TextOperation } from "../ot/text-operation.js";
3
+ import { Emitter } from "../../utils/emitter.js";
4
+ import { TextareaAdapter } from "./textarea-adapter.js";
5
+ import { CursorOverlay } from "./cursor-overlay.js";
6
+ import { UndoManager, caretAfter } from "./undo-manager.js";
7
+ import { mapRange, transformRange } from "./anchors.js";
8
+ // src/realtime/collab/collab-session.ts
9
+ /**
10
+ * CollabSession: real-time collaborative editing of one document over the
11
+ * WebSocketManager, using operational transformation.
12
+ *
13
+ * ```ts
14
+ * const session = app.collab.open('doc-42', textarea, { user: { name: 'Alice', color: '#e11d48' } });
15
+ * session.on('presence', cursors => renderAvatars(cursors));
16
+ * // later
17
+ * session.close();
18
+ * ```
19
+ *
20
+ * The server side is `CollabServer` (see `realtime/ot/server`).
21
+ *
22
+ * @module realtime/collab/collab-session
23
+ */
24
+ var CollabSession = class extends Emitter {
25
+ ws;
26
+ options;
27
+ docId;
28
+ channel;
29
+ client = null;
30
+ adapter;
31
+ overlay = null;
32
+ cursors = /* @__PURE__ */ new Map();
33
+ unsubscribe = null;
34
+ offOpen = null;
35
+ offStatus = null;
36
+ outstandingOpId = null;
37
+ opCounter = 0;
38
+ presenceTimer = null;
39
+ _status = "connecting";
40
+ /** The textarea's own readOnly, restored once the document has loaded. */
41
+ wasReadOnly = null;
42
+ history = null;
43
+ /** The content as of the last change, for computing undo steps. */
44
+ lastContent = "";
45
+ annotationMap = /* @__PURE__ */ new Map();
46
+ /** Annotation changes made while our own edits are in flight, sent once synchronized. */
47
+ pendingAnnotations = [];
48
+ clientId = null;
49
+ constructor(ws, docId, target, options = {}) {
50
+ super();
51
+ this.ws = ws;
52
+ this.options = options;
53
+ this.docId = docId;
54
+ this.channel = `doc:${docId}`;
55
+ this.adapter = target instanceof HTMLElement ? new TextareaAdapter(target) : target;
56
+ if (target instanceof HTMLTextAreaElement && options.cursors !== false) this.overlay = new CursorOverlay(target);
57
+ if (target instanceof HTMLElement) {
58
+ target.setAttribute("aria-busy", "true");
59
+ if (target instanceof HTMLTextAreaElement || target instanceof HTMLInputElement) {
60
+ this.wasReadOnly = target.readOnly;
61
+ target.readOnly = true;
62
+ }
63
+ }
64
+ this.adapter.attach((op) => this.handleLocalEdit(op), (selection) => this.queuePresence(selection));
65
+ if (options.undo) {
66
+ this.history = new UndoManager();
67
+ this.adapter.attachHistory?.(() => this.undo(), () => this.redo());
68
+ }
69
+ this.unsubscribe = ws.subscribe(this.channel, (message) => this.handleMessage(message));
70
+ this.offOpen = ws.onOpen(() => this.join());
71
+ this.offStatus = ws.onStatusChange((status) => {
72
+ if (status !== "open") this.setStatus("offline");
73
+ });
74
+ if (ws.isConnected) this.join();
75
+ else ws.connect();
76
+ }
77
+ get status() {
78
+ return this._status;
79
+ }
80
+ get content() {
81
+ return this.adapter.getValue();
82
+ }
83
+ get revision() {
84
+ return this.client?.revision ?? 0;
85
+ }
86
+ /** Remote collaborators. */
87
+ get peers() {
88
+ return Array.from(this.cursors.values());
89
+ }
90
+ /** Annotations (comments), in document order, with positions in the local document. */
91
+ get annotations() {
92
+ return [...this.annotationMap.values()].sort((a, b) => a.from - b.from || a.to - b.to);
93
+ }
94
+ /** Whether `undo()` / `redo()` would do anything (with `{ undo: true }`). */
95
+ get canUndo() {
96
+ return this.history?.canUndo ?? false;
97
+ }
98
+ get canRedo() {
99
+ return this.history?.canRedo ?? false;
100
+ }
101
+ /** Undo your last edit (needs `{ undo: true }`). Returns whether anything changed. */
102
+ undo() {
103
+ return this.applyHistory(this.history?.undo(this.adapter.getValue()) ?? null);
104
+ }
105
+ /** Redo your last undone edit (needs `{ undo: true }`). */
106
+ redo() {
107
+ return this.applyHistory(this.history?.redo(this.adapter.getValue()) ?? null);
108
+ }
109
+ applyHistory(op) {
110
+ if (!op || !this.client || !this.adapter.applyLocal) return false;
111
+ this.adapter.applyLocal(op, caretAfter(op));
112
+ this.commitLocal(op);
113
+ return true;
114
+ }
115
+ /**
116
+ * Comment on the text from `from` to `to` (local positions). The comment
117
+ * appears (in the `annotations` event) once the server has stored it.
118
+ * Returns its id.
119
+ */
120
+ annotate(from, to, body, id = `a-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`) {
121
+ this.sendAnnotation({
122
+ action: "add",
123
+ annotation: {
124
+ id,
125
+ from: Math.min(from, to),
126
+ to: Math.max(from, to),
127
+ body,
128
+ user: this.options.user,
129
+ createdAt: Date.now()
130
+ }
131
+ });
132
+ return id;
133
+ }
134
+ /** Change an annotation: its body, `resolved`, `replies`, or its range (local positions). */
135
+ updateAnnotation(id, changes) {
136
+ this.sendAnnotation({
137
+ action: "update",
138
+ annotation: {
139
+ ...changes,
140
+ id
141
+ }
142
+ });
143
+ }
144
+ removeAnnotation(id) {
145
+ this.sendAnnotation({
146
+ action: "remove",
147
+ annotation: { id }
148
+ });
149
+ }
150
+ sendAnnotation(payload) {
151
+ this.pendingAnnotations.push(payload);
152
+ this.flushAnnotations();
153
+ }
154
+ /**
155
+ * Positions only mean something at a revision. While our own edits are in
156
+ * flight, the local document is ahead of every server revision, so wait
157
+ * until they're acknowledged.
158
+ */
159
+ flushAnnotations() {
160
+ if (!this.client || this.client.state !== "synchronized" || !this.ws.isConnected) return;
161
+ for (const payload of this.pendingAnnotations.splice(0)) this.ws.send({
162
+ type: "collab:annotate",
163
+ channel: this.channel,
164
+ payload: {
165
+ ...payload,
166
+ revision: this.client.revision
167
+ }
168
+ });
169
+ }
170
+ toLocalRange(a) {
171
+ const client = this.client;
172
+ return client ? mapRange(a, (i, stickLeft) => client.transformIndex(i, stickLeft)) : a;
173
+ }
174
+ emitAnnotations() {
175
+ this.emit("annotations", this.annotations);
176
+ }
177
+ setStatus(status) {
178
+ if (status === this._status) return;
179
+ this._status = status;
180
+ this.emit("status", status);
181
+ }
182
+ join() {
183
+ this.setStatus("connecting");
184
+ this.ws.send({
185
+ type: "collab:join",
186
+ channel: this.channel,
187
+ payload: {
188
+ user: this.options.user,
189
+ revision: this.client?.revision
190
+ }
191
+ });
192
+ }
193
+ handleMessage(message) {
194
+ const payload = message.payload ?? {};
195
+ switch (message.type) {
196
+ case "collab:init":
197
+ this.handleInit(payload);
198
+ break;
199
+ case "collab:op":
200
+ if (!this.client || payload.clientId === this.clientId) return;
201
+ this.client.applyServer(TextOperation.fromJSON(payload.op));
202
+ this.updateStatus();
203
+ break;
204
+ case "collab:ack":
205
+ if (!this.client || payload.opId && payload.opId !== this.outstandingOpId) return;
206
+ this.outstandingOpId = null;
207
+ this.client.serverAck();
208
+ this.updateStatus();
209
+ break;
210
+ case "collab:presence": {
211
+ const id = String(payload.clientId ?? "");
212
+ if (!id || id === this.clientId) return;
213
+ const existing = this.cursors.get(id);
214
+ const selection = payload.selection;
215
+ this.cursors.set(id, {
216
+ clientId: id,
217
+ user: payload.user ?? existing?.user,
218
+ selection: selection ? this.toLocal(selection) : existing?.selection
219
+ });
220
+ this.emitPresence();
221
+ break;
222
+ }
223
+ case "collab:leave":
224
+ if (this.cursors.delete(String(payload.clientId))) this.emitPresence();
225
+ break;
226
+ case "collab:annotate": {
227
+ const { action, annotation } = payload;
228
+ if (!annotation?.id) return;
229
+ if (action === "remove") this.annotationMap.delete(annotation.id);
230
+ else this.annotationMap.set(annotation.id, this.toLocalRange(annotation));
231
+ this.emitAnnotations();
232
+ break;
233
+ }
234
+ case "collab:error": this.emit("error", { message: String(payload.message ?? "Collaboration error") });
235
+ }
236
+ }
237
+ handleInit(init) {
238
+ this.clientId = init.clientId;
239
+ if (!this.client || init.since === null || init.since === void 0 || !init.missed) {
240
+ this.client = new OTClient(init.revision, {
241
+ send: (revision, op) => this.sendOp(revision, op),
242
+ apply: (op) => this.applyRemote(op)
243
+ });
244
+ this.outstandingOpId = null;
245
+ this.lastContent = init.content;
246
+ this.history?.clear();
247
+ this.adapter.setValue(init.content);
248
+ this.emit("ready", {
249
+ content: init.content,
250
+ revision: init.revision
251
+ });
252
+ this.emit("change", {
253
+ content: init.content,
254
+ remote: true
255
+ });
256
+ } else {
257
+ for (const entry of init.missed) if (entry.opId && entry.opId === this.outstandingOpId) {
258
+ this.outstandingOpId = null;
259
+ this.client.serverAck();
260
+ } else this.client.applyServer(TextOperation.fromJSON(entry.op));
261
+ this.client.resend();
262
+ }
263
+ this.cursors.clear();
264
+ for (const peer of init.peers ?? []) this.cursors.set(peer.clientId, peer);
265
+ this.emitPresence();
266
+ this.annotationMap.clear();
267
+ for (const a of init.annotations ?? []) this.annotationMap.set(a.id, this.toLocalRange(a));
268
+ this.emitAnnotations();
269
+ if (this.adapter instanceof TextareaAdapter) {
270
+ this.adapter.element.removeAttribute("aria-busy");
271
+ if (this.wasReadOnly !== null) this.adapter.element.readOnly = this.wasReadOnly;
272
+ this.wasReadOnly = null;
273
+ }
274
+ this.updateStatus();
275
+ }
276
+ sendOp(revision, op) {
277
+ this.outstandingOpId = `${this.clientId ?? "c"}-${++this.opCounter}`;
278
+ this.ws.send({
279
+ type: "collab:op",
280
+ channel: this.channel,
281
+ payload: {
282
+ revision,
283
+ op: op.toJSON(),
284
+ opId: this.outstandingOpId
285
+ }
286
+ });
287
+ }
288
+ applyRemote(op) {
289
+ this.adapter.applyOperation(op);
290
+ this.lastContent = this.adapter.getValue();
291
+ this.history?.transform(op);
292
+ this.moveAnnotations(op);
293
+ for (const cursor of this.cursors.values()) if (cursor.selection) cursor.selection = {
294
+ anchor: op.transformIndex(cursor.selection.anchor),
295
+ head: op.transformIndex(cursor.selection.head)
296
+ };
297
+ this.emitPresence();
298
+ this.emit("change", {
299
+ content: this.adapter.getValue(),
300
+ remote: true
301
+ });
302
+ }
303
+ handleLocalEdit(op) {
304
+ if (!this.client) return;
305
+ this.history?.record(op, this.lastContent);
306
+ this.commitLocal(op);
307
+ }
308
+ /** A local edit (typed, or an undo/redo) that is already in the editor. */
309
+ commitLocal(op) {
310
+ if (!this.client) return;
311
+ this.lastContent = this.adapter.getValue();
312
+ this.client.applyClient(op);
313
+ for (const cursor of this.cursors.values()) if (cursor.selection) cursor.selection = {
314
+ anchor: op.transformIndex(cursor.selection.anchor),
315
+ head: op.transformIndex(cursor.selection.head)
316
+ };
317
+ this.moveAnnotations(op);
318
+ this.emitPresence();
319
+ this.updateStatus();
320
+ this.emit("change", {
321
+ content: this.adapter.getValue(),
322
+ remote: false
323
+ });
324
+ this.queuePresence(this.adapter.getSelection());
325
+ }
326
+ moveAnnotations(op) {
327
+ if (!this.annotationMap.size) return;
328
+ for (const [id, a] of this.annotationMap) this.annotationMap.set(id, transformRange(a, op));
329
+ this.emitAnnotations();
330
+ }
331
+ toLocal(selection) {
332
+ if (!this.client) return selection;
333
+ return {
334
+ anchor: this.client.transformIndex(selection.anchor),
335
+ head: this.client.transformIndex(selection.head)
336
+ };
337
+ }
338
+ queuePresence(selection) {
339
+ if (this.presenceTimer || !this.client) return;
340
+ this.presenceTimer = setTimeout(() => {
341
+ this.presenceTimer = null;
342
+ this.ws.send({
343
+ type: "collab:presence",
344
+ channel: this.channel,
345
+ payload: {
346
+ selection: this.adapter.getSelection() ?? selection,
347
+ user: this.options.user
348
+ }
349
+ });
350
+ }, this.options.presenceInterval ?? 50);
351
+ }
352
+ emitPresence() {
353
+ const peers = this.peers;
354
+ this.overlay?.update(peers);
355
+ this.emit("presence", peers);
356
+ }
357
+ updateStatus() {
358
+ if (!this.ws.isConnected) this.setStatus("offline");
359
+ else this.setStatus(this.client?.state === "synchronized" ? "synced" : "syncing");
360
+ this.flushAnnotations();
361
+ }
362
+ /** Leave the document and clean up. */
363
+ close() {
364
+ if (this.presenceTimer) clearTimeout(this.presenceTimer);
365
+ if (this.ws.isConnected) this.ws.send({
366
+ type: "collab:leave",
367
+ channel: this.channel
368
+ });
369
+ this.unsubscribe?.();
370
+ this.offOpen?.();
371
+ this.offStatus?.();
372
+ if (this.adapter instanceof TextareaAdapter && this.wasReadOnly !== null) {
373
+ this.adapter.element.readOnly = this.wasReadOnly;
374
+ this.adapter.element.removeAttribute("aria-busy");
375
+ }
376
+ this.adapter.destroy();
377
+ this.overlay?.destroy();
378
+ this.clear();
379
+ }
380
+ };
381
+ /** Opens collaboration sessions on a WebSocketManager. */
382
+ var CollabManager = class {
383
+ getWs;
384
+ constructor(getWs) {
385
+ this.getWs = getWs;
386
+ }
387
+ /** Start collaborating on `docId` in a textarea/input (or a custom adapter). */
388
+ open(docId, target, options = {}) {
389
+ const ws = this.getWs();
390
+ if (!ws) throw new Error("Collaboration needs a WebSocket: pass `websocket` to Arethesis.init().");
391
+ return new CollabSession(ws, docId, target, options);
392
+ }
393
+ };
394
+ export { CollabManager, CollabSession };
395
+
396
+ //# sourceMappingURL=collab-session.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"collab-session.js","names":[],"sources":["../../../src/realtime/collab/collab-session.ts"],"sourcesContent":["/**\n * CollabSession: real-time collaborative editing of one document over the\n * WebSocketManager, using operational transformation.\n *\n * ```ts\n * const session = app.collab.open('doc-42', textarea, { user: { name: 'Alice', color: '#e11d48' } });\n * session.on('presence', cursors => renderAvatars(cursors));\n * // later\n * session.close();\n * ```\n *\n * The server side is `CollabServer` (see `realtime/ot/server`).\n *\n * @module realtime/collab/collab-session\n */\n\nimport { OTClient } from '../ot/client';\nimport { TextOperation } from '../ot/text-operation';\nimport type { WebSocketManager } from '../websocket-manager';\nimport type { AnnotatePayload, CollabAnnotation, CollabMessage, CollabSelection, CollabUser, RemoteCursor } from '../types';\nimport { Emitter } from '../../utils/emitter';\nimport { TextareaAdapter, type EditorAdapter } from './textarea-adapter';\nimport { CursorOverlay } from './cursor-overlay';\nimport { caretAfter, UndoManager } from './undo-manager';\nimport { mapRange, transformRange } from './anchors';\n\nexport type CollabStatus = 'connecting' | 'synced' | 'syncing' | 'offline';\n\nexport interface CollabEvents extends Record<string, unknown> {\n /** The document content changed (locally or remotely). */\n change: { content: string; remote: boolean };\n /** Remote collaborators and their selections. */\n presence: RemoteCursor[];\n status: CollabStatus;\n error: { message: string };\n /** Initial content arrived. */\n ready: { content: string; revision: number };\n /** Annotations (comments) changed: added, edited, removed, or moved by edits. */\n annotations: CollabAnnotation[];\n}\n\nexport interface CollabOptions {\n user?: CollabUser;\n /** Draw remote cursors over a textarea. @default true */\n cursors?: boolean;\n /** Presence update throttle in ms. @default 50 */\n presenceInterval?: number;\n /**\n * Per-user undo and redo: Ctrl/Cmd+Z (and Shift+Z, or Y) revert only your\n * own edits, even after other people's. Replaces the browser's undo, which\n * doesn't know about remote edits. @default false\n */\n undo?: boolean;\n}\n\ninterface InitPayload {\n content: string;\n revision: number;\n clientId: string;\n peers?: RemoteCursor[];\n since?: number | null;\n missed?: Array<{ op: unknown; opId?: string }>;\n annotations?: CollabAnnotation[];\n}\n\nexport class CollabSession extends Emitter<CollabEvents> {\n readonly docId: string;\n readonly channel: string;\n private client: OTClient | null = null;\n private adapter: EditorAdapter;\n private overlay: CursorOverlay | null = null;\n private cursors = new Map<string, RemoteCursor>();\n private unsubscribe: (() => void) | null = null;\n private offOpen: (() => void) | null = null;\n private offStatus: (() => void) | null = null;\n private outstandingOpId: string | null = null;\n private opCounter = 0;\n private presenceTimer: ReturnType<typeof setTimeout> | null = null;\n private _status: CollabStatus = 'connecting';\n /** The textarea's own readOnly, restored once the document has loaded. */\n private wasReadOnly: boolean | null = null;\n private history: UndoManager | null = null;\n /** The content as of the last change, for computing undo steps. */\n private lastContent = '';\n private annotationMap = new Map<string, CollabAnnotation>();\n /** Annotation changes made while our own edits are in flight, sent once synchronized. */\n private pendingAnnotations: AnnotatePayload[] = [];\n clientId: string | null = null;\n\n constructor(\n private ws: WebSocketManager,\n docId: string,\n target: HTMLTextAreaElement | HTMLInputElement | EditorAdapter,\n private options: CollabOptions = {}\n ) {\n super();\n this.docId = docId;\n this.channel = `doc:${docId}`;\n this.adapter = target instanceof HTMLElement ? new TextareaAdapter(target) : target;\n if (target instanceof HTMLTextAreaElement && options.cursors !== false) this.overlay = new CursorOverlay(target);\n if (target instanceof HTMLElement) {\n target.setAttribute('aria-busy', 'true');\n // Typing before the document has loaded would be overwritten by it: wait.\n if (target instanceof HTMLTextAreaElement || target instanceof HTMLInputElement) {\n this.wasReadOnly = target.readOnly;\n target.readOnly = true;\n }\n }\n\n this.adapter.attach(\n op => this.handleLocalEdit(op),\n selection => this.queuePresence(selection),\n );\n if (options.undo) {\n this.history = new UndoManager();\n this.adapter.attachHistory?.(() => this.undo(), () => this.redo());\n }\n this.unsubscribe = ws.subscribe<CollabMessage>(this.channel, message => this.handleMessage(message));\n this.offOpen = ws.onOpen(() => this.join());\n this.offStatus = ws.onStatusChange(status => {\n if (status !== 'open') this.setStatus('offline');\n });\n if (ws.isConnected) this.join();\n else void ws.connect();\n }\n\n get status(): CollabStatus {\n return this._status;\n }\n\n get content(): string {\n return this.adapter.getValue();\n }\n\n get revision(): number {\n return this.client?.revision ?? 0;\n }\n\n /** Remote collaborators. */\n get peers(): RemoteCursor[] {\n return Array.from(this.cursors.values());\n }\n\n /** Annotations (comments), in document order, with positions in the local document. */\n get annotations(): CollabAnnotation[] {\n return [...this.annotationMap.values()].sort((a, b) => a.from - b.from || a.to - b.to);\n }\n\n /** Whether `undo()` / `redo()` would do anything (with `{ undo: true }`). */\n get canUndo(): boolean {\n return this.history?.canUndo ?? false;\n }\n\n get canRedo(): boolean {\n return this.history?.canRedo ?? false;\n }\n\n /** Undo your last edit (needs `{ undo: true }`). Returns whether anything changed. */\n undo(): boolean {\n return this.applyHistory(this.history?.undo(this.adapter.getValue()) ?? null);\n }\n\n /** Redo your last undone edit (needs `{ undo: true }`). */\n redo(): boolean {\n return this.applyHistory(this.history?.redo(this.adapter.getValue()) ?? null);\n }\n\n private applyHistory(op: TextOperation | null): boolean {\n if (!op || !this.client || !this.adapter.applyLocal) return false;\n this.adapter.applyLocal(op, caretAfter(op));\n this.commitLocal(op);\n return true;\n }\n\n /**\n * Comment on the text from `from` to `to` (local positions). The comment\n * appears (in the `annotations` event) once the server has stored it.\n * Returns its id.\n */\n annotate(from: number, to: number, body: string, id = `a-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`): string {\n this.sendAnnotation({ action: 'add', annotation: { id, from: Math.min(from, to), to: Math.max(from, to), body, user: this.options.user, createdAt: Date.now() } });\n return id;\n }\n\n /** Change an annotation: its body, `resolved`, `replies`, or its range (local positions). */\n updateAnnotation(id: string, changes: Partial<Omit<CollabAnnotation, 'id'>>): void {\n this.sendAnnotation({ action: 'update', annotation: { ...changes, id } });\n }\n\n removeAnnotation(id: string): void {\n this.sendAnnotation({ action: 'remove', annotation: { id } });\n }\n\n private sendAnnotation(payload: AnnotatePayload): void {\n this.pendingAnnotations.push(payload);\n this.flushAnnotations();\n }\n\n /**\n * Positions only mean something at a revision. While our own edits are in\n * flight, the local document is ahead of every server revision, so wait\n * until they're acknowledged.\n */\n private flushAnnotations(): void {\n if (!this.client || this.client.state !== 'synchronized' || !this.ws.isConnected) return;\n for (const payload of this.pendingAnnotations.splice(0)) {\n this.ws.send({ type: 'collab:annotate', channel: this.channel, payload: { ...payload, revision: this.client.revision } });\n }\n }\n\n private toLocalRange(a: CollabAnnotation): CollabAnnotation {\n const client = this.client;\n return client ? mapRange(a, (i, stickLeft) => client.transformIndex(i, stickLeft)) : a;\n }\n\n private emitAnnotations(): void {\n this.emit('annotations', this.annotations);\n }\n\n private setStatus(status: CollabStatus): void {\n if (status === this._status) return;\n this._status = status;\n this.emit('status', status);\n }\n\n private join(): void {\n this.setStatus('connecting');\n this.ws.send({ type: 'collab:join', channel: this.channel, payload: { user: this.options.user, revision: this.client?.revision } });\n }\n\n private handleMessage(message: CollabMessage): void {\n const payload = (message.payload ?? {}) as Record<string, unknown>;\n switch (message.type) {\n case 'collab:init':\n this.handleInit(payload as unknown as InitPayload);\n break;\n case 'collab:op':\n if (!this.client || payload.clientId === this.clientId) return;\n this.client.applyServer(TextOperation.fromJSON(payload.op));\n this.updateStatus();\n break;\n case 'collab:ack':\n if (!this.client || (payload.opId && payload.opId !== this.outstandingOpId)) return;\n this.outstandingOpId = null;\n this.client.serverAck();\n this.updateStatus();\n break;\n case 'collab:presence': {\n const id = String(payload.clientId ?? '');\n if (!id || id === this.clientId) return;\n const existing = this.cursors.get(id);\n const selection = payload.selection as CollabSelection | undefined;\n this.cursors.set(id, {\n clientId: id,\n user: (payload.user as CollabUser | undefined) ?? existing?.user,\n selection: selection ? this.toLocal(selection) : existing?.selection,\n });\n this.emitPresence();\n break;\n }\n case 'collab:leave':\n if (this.cursors.delete(String(payload.clientId))) this.emitPresence();\n break;\n case 'collab:annotate': {\n const { action, annotation } = payload as unknown as AnnotatePayload;\n if (!annotation?.id) return;\n if (action === 'remove') this.annotationMap.delete(annotation.id);\n else this.annotationMap.set(annotation.id, this.toLocalRange(annotation as CollabAnnotation));\n this.emitAnnotations();\n break;\n }\n case 'collab:error':\n this.emit('error', { message: String(payload.message ?? 'Collaboration error') });\n break;\n }\n }\n\n private handleInit(init: InitPayload): void {\n this.clientId = init.clientId;\n if (!this.client || init.since === null || init.since === undefined || !init.missed) {\n // First sync (or the server could not replay): take the server's document.\n this.client = new OTClient(init.revision, {\n send: (revision, op) => this.sendOp(revision, op),\n apply: op => this.applyRemote(op),\n });\n this.outstandingOpId = null;\n this.lastContent = init.content;\n this.history?.clear();\n this.adapter.setValue(init.content);\n this.emit('ready', { content: init.content, revision: init.revision });\n this.emit('change', { content: init.content, remote: true });\n } else {\n // Reconnected: replay what we missed; our own op in the list counts as an ack.\n for (const entry of init.missed) {\n if (entry.opId && entry.opId === this.outstandingOpId) {\n this.outstandingOpId = null;\n this.client.serverAck();\n } else {\n this.client.applyServer(TextOperation.fromJSON(entry.op));\n }\n }\n this.client.resend();\n }\n this.cursors.clear();\n for (const peer of init.peers ?? []) this.cursors.set(peer.clientId, peer);\n this.emitPresence();\n this.annotationMap.clear();\n for (const a of init.annotations ?? []) this.annotationMap.set(a.id, this.toLocalRange(a));\n this.emitAnnotations();\n if (this.adapter instanceof TextareaAdapter) {\n this.adapter.element.removeAttribute('aria-busy');\n if (this.wasReadOnly !== null) this.adapter.element.readOnly = this.wasReadOnly;\n this.wasReadOnly = null;\n }\n this.updateStatus();\n }\n\n private sendOp(revision: number, op: TextOperation): void {\n this.outstandingOpId = `${this.clientId ?? 'c'}-${++this.opCounter}`;\n this.ws.send({ type: 'collab:op', channel: this.channel, payload: { revision, op: op.toJSON(), opId: this.outstandingOpId } });\n }\n\n private applyRemote(op: TextOperation): void {\n this.adapter.applyOperation(op);\n this.lastContent = this.adapter.getValue();\n this.history?.transform(op);\n this.moveAnnotations(op);\n for (const cursor of this.cursors.values()) {\n if (cursor.selection) {\n cursor.selection = { anchor: op.transformIndex(cursor.selection.anchor), head: op.transformIndex(cursor.selection.head) };\n }\n }\n this.emitPresence();\n this.emit('change', { content: this.adapter.getValue(), remote: true });\n }\n\n private handleLocalEdit(op: TextOperation): void {\n if (!this.client) return; // not synced yet; the init will overwrite\n this.history?.record(op, this.lastContent);\n this.commitLocal(op);\n }\n\n /** A local edit (typed, or an undo/redo) that is already in the editor. */\n private commitLocal(op: TextOperation): void {\n if (!this.client) return;\n this.lastContent = this.adapter.getValue();\n this.client.applyClient(op);\n for (const cursor of this.cursors.values()) {\n if (cursor.selection) {\n cursor.selection = { anchor: op.transformIndex(cursor.selection.anchor), head: op.transformIndex(cursor.selection.head) };\n }\n }\n this.moveAnnotations(op);\n this.emitPresence();\n this.updateStatus();\n this.emit('change', { content: this.adapter.getValue(), remote: false });\n this.queuePresence(this.adapter.getSelection());\n }\n\n private moveAnnotations(op: TextOperation): void {\n if (!this.annotationMap.size) return;\n for (const [id, a] of this.annotationMap) this.annotationMap.set(id, transformRange(a, op));\n this.emitAnnotations();\n }\n\n private toLocal(selection: CollabSelection): CollabSelection {\n if (!this.client) return selection;\n return { anchor: this.client.transformIndex(selection.anchor), head: this.client.transformIndex(selection.head) };\n }\n\n private queuePresence(selection: CollabSelection): void {\n if (this.presenceTimer || !this.client) return;\n this.presenceTimer = setTimeout(() => {\n this.presenceTimer = null;\n this.ws.send({ type: 'collab:presence', channel: this.channel, payload: { selection: this.adapter.getSelection() ?? selection, user: this.options.user } });\n }, this.options.presenceInterval ?? 50);\n }\n\n private emitPresence(): void {\n const peers = this.peers;\n this.overlay?.update(peers);\n this.emit('presence', peers);\n }\n\n private updateStatus(): void {\n if (!this.ws.isConnected) this.setStatus('offline');\n else this.setStatus(this.client?.state === 'synchronized' ? 'synced' : 'syncing');\n this.flushAnnotations();\n }\n\n /** Leave the document and clean up. */\n close(): void {\n if (this.presenceTimer) clearTimeout(this.presenceTimer);\n if (this.ws.isConnected) this.ws.send({ type: 'collab:leave', channel: this.channel });\n this.unsubscribe?.();\n this.offOpen?.();\n this.offStatus?.();\n if (this.adapter instanceof TextareaAdapter && this.wasReadOnly !== null) {\n this.adapter.element.readOnly = this.wasReadOnly;\n this.adapter.element.removeAttribute('aria-busy');\n }\n this.adapter.destroy();\n this.overlay?.destroy();\n this.clear();\n }\n}\n\n/** Opens collaboration sessions on a WebSocketManager. */\nexport class CollabManager {\n constructor(private getWs: () => WebSocketManager | null) {}\n\n /** Start collaborating on `docId` in a textarea/input (or a custom adapter). */\n open(docId: string, target: HTMLTextAreaElement | HTMLInputElement | EditorAdapter, options: CollabOptions = {}): CollabSession {\n const ws = this.getWs();\n if (!ws) throw new Error('Collaboration needs a WebSocket: pass `websocket` to Arethesis.init().');\n return new CollabSession(ws, docId, target, options);\n }\n}\n"],"mappings":"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"}
@@ -0,0 +1,187 @@
1
+ // src/realtime/collab/cursor-overlay.ts
2
+ var MIRRORED = [
3
+ "boxSizing",
4
+ "width",
5
+ "height",
6
+ "overflowX",
7
+ "overflowY",
8
+ "borderTopWidth",
9
+ "borderRightWidth",
10
+ "borderBottomWidth",
11
+ "borderLeftWidth",
12
+ "paddingTop",
13
+ "paddingRight",
14
+ "paddingBottom",
15
+ "paddingLeft",
16
+ "fontStyle",
17
+ "fontVariant",
18
+ "fontWeight",
19
+ "fontStretch",
20
+ "fontSize",
21
+ "lineHeight",
22
+ "fontFamily",
23
+ "textAlign",
24
+ "textTransform",
25
+ "textIndent",
26
+ "letterSpacing",
27
+ "wordSpacing",
28
+ "tabSize",
29
+ "whiteSpace",
30
+ "wordBreak",
31
+ "overflowWrap"
32
+ ];
33
+ function mirrorOf(textarea) {
34
+ const mirror = document.createElement("div");
35
+ const style = getComputedStyle(textarea);
36
+ for (const prop of MIRRORED) mirror.style[prop] = style[prop];
37
+ Object.assign(mirror.style, {
38
+ position: "absolute",
39
+ visibility: "hidden",
40
+ top: "0",
41
+ left: "-9999px",
42
+ whiteSpace: textarea instanceof HTMLInputElement ? "pre" : "pre-wrap",
43
+ wordWrap: "break-word",
44
+ overflow: "hidden"
45
+ });
46
+ return {
47
+ mirror,
48
+ style
49
+ };
50
+ }
51
+ /** Pixel position of a character index inside a textarea, relative to its padding box. */
52
+ function caretCoordinates(textarea, index) {
53
+ const { mirror, style } = mirrorOf(textarea);
54
+ mirror.textContent = textarea.value.slice(0, index);
55
+ const marker = document.createElement("span");
56
+ marker.textContent = textarea.value.slice(index) || ".";
57
+ mirror.appendChild(marker);
58
+ document.body.appendChild(mirror);
59
+ const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2 || 16;
60
+ const result = {
61
+ top: marker.offsetTop + (parseFloat(style.borderTopWidth) || 0),
62
+ left: marker.offsetLeft + (parseFloat(style.borderLeftWidth) || 0),
63
+ height: lineHeight
64
+ };
65
+ mirror.remove();
66
+ return result;
67
+ }
68
+ /**
69
+ * The rectangles (one per visual line) covering the text from `from` to `to`
70
+ * in a textarea, relative to its border box, ignoring scrolling.
71
+ */
72
+ function rangeRects(textarea, from, to) {
73
+ const start = Math.max(0, Math.min(from, to));
74
+ const end = Math.min(textarea.value.length, Math.max(from, to));
75
+ if (start === end) return [];
76
+ const { mirror, style } = mirrorOf(textarea);
77
+ const span = document.createElement("span");
78
+ span.textContent = textarea.value.slice(start, end);
79
+ mirror.append(textarea.value.slice(0, start), span, textarea.value.slice(end) || ".");
80
+ document.body.appendChild(mirror);
81
+ const box = mirror.getBoundingClientRect();
82
+ const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2 || 16;
83
+ const rects = Array.from(span.getClientRects()).filter((r) => r.width > .5).map((r) => ({
84
+ top: r.top - box.top + (r.height - lineHeight) / 2,
85
+ left: r.left - box.left,
86
+ width: r.width,
87
+ height: lineHeight
88
+ }));
89
+ mirror.remove();
90
+ return rects;
91
+ }
92
+ var CursorOverlay = class {
93
+ textarea;
94
+ layer;
95
+ cursors = [];
96
+ controller = new AbortController();
97
+ frame = 0;
98
+ constructor(textarea) {
99
+ this.textarea = textarea;
100
+ const parent = textarea.parentElement ?? document.body;
101
+ if (getComputedStyle(parent).position === "static") parent.style.position = "relative";
102
+ this.layer = document.createElement("div");
103
+ this.layer.className = "collab-cursors";
104
+ this.layer.setAttribute("aria-hidden", "true");
105
+ Object.assign(this.layer.style, {
106
+ position: "absolute",
107
+ pointerEvents: "none",
108
+ overflow: "hidden",
109
+ inset: "0"
110
+ });
111
+ parent.appendChild(this.layer);
112
+ const { signal } = this.controller;
113
+ textarea.addEventListener("scroll", () => this.schedule(), {
114
+ signal,
115
+ passive: true
116
+ });
117
+ textarea.addEventListener("input", () => this.schedule(), { signal });
118
+ window.addEventListener("resize", () => this.schedule(), { signal });
119
+ }
120
+ update(cursors) {
121
+ this.cursors = cursors;
122
+ this.schedule();
123
+ }
124
+ schedule() {
125
+ if (this.frame) return;
126
+ this.frame = requestAnimationFrame(() => {
127
+ this.frame = 0;
128
+ this.render();
129
+ });
130
+ }
131
+ render() {
132
+ const ta = this.textarea;
133
+ const offsetTop = ta.offsetTop - ta.scrollTop;
134
+ const offsetLeft = ta.offsetLeft - ta.scrollLeft;
135
+ this.layer.replaceChildren();
136
+ for (const cursor of this.cursors) {
137
+ if (!cursor.selection) continue;
138
+ const color = cursor.user?.color ?? "#7c3aed";
139
+ for (const r of rangeRects(ta, cursor.selection.anchor, cursor.selection.head)) {
140
+ const highlight = document.createElement("div");
141
+ highlight.className = "collab-selection";
142
+ Object.assign(highlight.style, {
143
+ position: "absolute",
144
+ top: `${offsetTop + r.top}px`,
145
+ left: `${offsetLeft + r.left}px`,
146
+ width: `${r.width}px`,
147
+ height: `${r.height}px`,
148
+ background: color,
149
+ opacity: "0.22"
150
+ });
151
+ this.layer.appendChild(highlight);
152
+ }
153
+ const pos = caretCoordinates(ta, Math.min(cursor.selection.head, ta.value.length));
154
+ const caret = document.createElement("div");
155
+ caret.className = "collab-cursor";
156
+ Object.assign(caret.style, {
157
+ position: "absolute",
158
+ top: `${offsetTop + pos.top}px`,
159
+ left: `${offsetLeft + pos.left}px`,
160
+ height: `${pos.height}px`,
161
+ width: "2px",
162
+ background: color
163
+ });
164
+ const label = document.createElement("span");
165
+ label.className = "collab-cursor__label";
166
+ label.textContent = cursor.user?.name ?? "Guest";
167
+ Object.assign(label.style, {
168
+ position: "absolute",
169
+ bottom: "100%",
170
+ left: "0",
171
+ background: color,
172
+ color: "#fff",
173
+ whiteSpace: "nowrap"
174
+ });
175
+ caret.appendChild(label);
176
+ this.layer.appendChild(caret);
177
+ }
178
+ }
179
+ destroy() {
180
+ cancelAnimationFrame(this.frame);
181
+ this.controller.abort();
182
+ this.layer.remove();
183
+ }
184
+ };
185
+ export { CursorOverlay, caretCoordinates, rangeRects };
186
+
187
+ //# sourceMappingURL=cursor-overlay.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cursor-overlay.js","names":[],"sources":["../../../src/realtime/collab/cursor-overlay.ts"],"sourcesContent":["/**\n * Draws remote collaborators' carets and selections over a textarea, using a\n * hidden mirror element to measure where a character index lands on screen.\n * Selections are tinted with the collaborator's color, one rectangle per line.\n *\n * @module realtime/collab/cursor-overlay\n */\n\nimport type { RemoteCursor } from '../types';\n\nconst MIRRORED = [\n 'boxSizing', 'width', 'height', 'overflowX', 'overflowY', 'borderTopWidth', 'borderRightWidth',\n 'borderBottomWidth', 'borderLeftWidth', 'paddingTop', 'paddingRight', 'paddingBottom', 'paddingLeft',\n 'fontStyle', 'fontVariant', 'fontWeight', 'fontStretch', 'fontSize', 'lineHeight', 'fontFamily',\n 'textAlign', 'textTransform', 'textIndent', 'letterSpacing', 'wordSpacing', 'tabSize', 'whiteSpace', 'wordBreak', 'overflowWrap',\n] as const;\n\nfunction mirrorOf(textarea: HTMLTextAreaElement | HTMLInputElement): { mirror: HTMLDivElement; style: CSSStyleDeclaration } {\n const mirror = document.createElement('div');\n const style = getComputedStyle(textarea);\n for (const prop of MIRRORED) (mirror.style as unknown as Record<string, string>)[prop] = style[prop];\n Object.assign(mirror.style, { position: 'absolute', visibility: 'hidden', top: '0', left: '-9999px', whiteSpace: textarea instanceof HTMLInputElement ? 'pre' : 'pre-wrap', wordWrap: 'break-word', overflow: 'hidden' });\n return { mirror, style };\n}\n\n/** Pixel position of a character index inside a textarea, relative to its padding box. */\nexport function caretCoordinates(textarea: HTMLTextAreaElement | HTMLInputElement, index: number): { top: number; left: number; height: number } {\n const { mirror, style } = mirrorOf(textarea);\n mirror.textContent = textarea.value.slice(0, index);\n const marker = document.createElement('span');\n marker.textContent = textarea.value.slice(index) || '.';\n mirror.appendChild(marker);\n document.body.appendChild(mirror);\n const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2 || 16;\n const result = {\n top: marker.offsetTop + (parseFloat(style.borderTopWidth) || 0),\n left: marker.offsetLeft + (parseFloat(style.borderLeftWidth) || 0),\n height: lineHeight,\n };\n mirror.remove();\n return result;\n}\n\n/**\n * The rectangles (one per visual line) covering the text from `from` to `to`\n * in a textarea, relative to its border box, ignoring scrolling.\n */\nexport function rangeRects(textarea: HTMLTextAreaElement | HTMLInputElement, from: number, to: number): Array<{ top: number; left: number; width: number; height: number }> {\n const start = Math.max(0, Math.min(from, to));\n const end = Math.min(textarea.value.length, Math.max(from, to));\n if (start === end) return [];\n const { mirror, style } = mirrorOf(textarea);\n const span = document.createElement('span');\n span.textContent = textarea.value.slice(start, end);\n mirror.append(textarea.value.slice(0, start), span, textarea.value.slice(end) || '.');\n document.body.appendChild(mirror);\n const box = mirror.getBoundingClientRect();\n const lineHeight = parseFloat(style.lineHeight) || parseFloat(style.fontSize) * 1.2 || 16;\n const rects = Array.from(span.getClientRects())\n .filter(r => r.width > 0.5)\n .map(r => ({ top: r.top - box.top + (r.height - lineHeight) / 2, left: r.left - box.left, width: r.width, height: lineHeight }));\n mirror.remove();\n return rects;\n}\n\nexport class CursorOverlay {\n private layer: HTMLDivElement;\n private cursors: RemoteCursor[] = [];\n private controller = new AbortController();\n private frame = 0;\n\n constructor(private textarea: HTMLTextAreaElement | HTMLInputElement) {\n const parent = textarea.parentElement ?? document.body;\n if (getComputedStyle(parent).position === 'static') parent.style.position = 'relative';\n this.layer = document.createElement('div');\n this.layer.className = 'collab-cursors';\n this.layer.setAttribute('aria-hidden', 'true');\n Object.assign(this.layer.style, { position: 'absolute', pointerEvents: 'none', overflow: 'hidden', inset: '0' });\n parent.appendChild(this.layer);\n const { signal } = this.controller;\n textarea.addEventListener('scroll', () => this.schedule(), { signal, passive: true });\n textarea.addEventListener('input', () => this.schedule(), { signal });\n window.addEventListener('resize', () => this.schedule(), { signal });\n }\n\n update(cursors: RemoteCursor[]): void {\n this.cursors = cursors;\n this.schedule();\n }\n\n private schedule(): void {\n if (this.frame) return;\n this.frame = requestAnimationFrame(() => {\n this.frame = 0;\n this.render();\n });\n }\n\n private render(): void {\n const ta = this.textarea;\n const offsetTop = ta.offsetTop - ta.scrollTop;\n const offsetLeft = ta.offsetLeft - ta.scrollLeft;\n this.layer.replaceChildren();\n for (const cursor of this.cursors) {\n if (!cursor.selection) continue;\n const color = cursor.user?.color ?? '#7c3aed';\n for (const r of rangeRects(ta, cursor.selection.anchor, cursor.selection.head)) {\n const highlight = document.createElement('div');\n highlight.className = 'collab-selection';\n Object.assign(highlight.style, {\n position: 'absolute', top: `${offsetTop + r.top}px`, left: `${offsetLeft + r.left}px`,\n width: `${r.width}px`, height: `${r.height}px`, background: color, opacity: '0.22',\n });\n this.layer.appendChild(highlight);\n }\n const head = Math.min(cursor.selection.head, ta.value.length);\n const pos = caretCoordinates(ta, head);\n const caret = document.createElement('div');\n caret.className = 'collab-cursor';\n Object.assign(caret.style, {\n position: 'absolute', top: `${offsetTop + pos.top}px`, left: `${offsetLeft + pos.left}px`,\n height: `${pos.height}px`, width: '2px', background: color,\n });\n const label = document.createElement('span');\n label.className = 'collab-cursor__label';\n label.textContent = cursor.user?.name ?? 'Guest';\n Object.assign(label.style, { position: 'absolute', bottom: '100%', left: '0', background: color, color: '#fff', whiteSpace: 'nowrap' });\n caret.appendChild(label);\n this.layer.appendChild(caret);\n }\n }\n\n destroy(): void {\n cancelAnimationFrame(this.frame);\n this.controller.abort();\n this.layer.remove();\n }\n}\n"],"mappings":"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"}