@meltemi/diagrams-canvas 1.9.0 → 1.10.0

package/README.md

@@ -47,8 +47,21 @@ A host that shares the diagram can show who else is in it with `presence` messag
 in `@meltemi/diagrams-editor`): the other people, each with a name, a colour and the ids they have
 selected. The canvas draws an outline in the person's colour around each of those and a tag with
 the name (always text, never markup) on a layer above the scene that is never selected, copied or
-exported and that nothing of is sent back. Each message replaces the last; a message with nobody,
-an empty canvas or another diagram clears it, and ids the diagram does not have are ignored.
+exported and that nothing of is sent back. A person may also have a `pointer` (`{ x, y }` in
+diagram units): the canvas draws a cursor in their colour with the name at its tail, which glides
+to the next point in 200 ms and keeps its size at every zoom. Each message replaces the last; a
+message with nobody, an empty canvas or another diagram clears it, and ids the diagram does not
+have, and pointers that are not two finite numbers, are ignored. Once a host has sent `presence`,
+the canvas tells it where the person's own pointer is with `presencePointer` messages (diagram
+units and the diagram's id, `null` when it leaves), at most every 50 ms.
+
+The Pointer tool (K, or its toggle before the grid's) draws a trail that fades in 800 ms and edits
+nothing, on every canvas, read-only ones included; the trail is no part of the document or of any
+export. In the colour of the person: the `me: { colour }` of the last `presence` message, else the
+render's `colors.accent`. A person's `laser` (`{ batch, points }`, at most 64 points `{ x, y, t }`,
+`t` in milliseconds since the batch's first point) is drawn once per `batch` as that person's trail,
+and the canvas posts the points of the person's own strokes with `presenceLaser` messages to a host
+that has sent `presence`, at most every 50 ms.
 
 Popovers, menus, side panels, tooltips and target outlines open and close with short transitions
 on the motion tokens of `canvas.css` (`--mdg-motion-fast`, `--mdg-motion`, `--mdg-motion-slow`,