@botiverse/porthole 0.14.11 → 0.14.12

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/CHANGELOG.md CHANGED
@@ -4,6 +4,22 @@
4
4
  section); the reasons for every change are in [docs/DECISIONS.md](docs/DECISIONS.md), by the
5
5
  P-numbers below.
6
6
 
7
+ ## 0.14.12
8
+
9
+ - **Annotations: the keyboard back on a marker (P134).** `annotations.focusMark(id)` (React:
10
+ `focusMark(id)` on the `ref`) moves the DOM focus to that mark's marker in the frame. It is for
11
+ one moment: after Escape closed your own view of that mark, once it is closed. It carries no
12
+ content and reports nothing; with no such marker it does nothing and throws nothing. An older
13
+ shell ignores it.
14
+ - **Annotations: a marker's name (P134).** It reads `1 comment on "Paragraph 3. Filler…"`: the words
15
+ it is on, in quotes, with no element's tag. `anchor.label` and everything you store are unchanged.
16
+ - **Key or pointer (P134).** `activated` is unchanged. Read `document.activeElement` on your own page
17
+ as it arrives: the frame there means the focus is in the frame. A hint: a page can still forge
18
+ `activated` while the person is in the frame, and a host that moves the keyboard into its view on
19
+ this gates what posts from that view itself (ADOPTING, THREAT_MODEL §7).
20
+ - **Security (P134):** the shell's move uses the platform's `focus`, kept before content runs (control
21
+ `marker-focus`). No CSP, sandbox, egress or gate changes; the focus guard is untouched.
22
+
7
23
  ## 0.14.11
8
24
 
9
25
  - **Annotations: markers are buttons (P133).** A marker is a real button in the frame's Tab order,
@@ -91,8 +91,8 @@ export interface AnnotationMark {
91
91
  * draws the bubble alone) at the end of a text anchor's paragraph (P133) and the top right of an
92
92
  * element. The person can click it, or reach it with the keyboard and press Enter or Space
93
93
  * (P133): the frame reports `activated`. Its accessible name says what it is, with the count and
94
- * `anchor.label`. The content can read the number; give one only where the page may know it. A
95
- * draft's is dropped (P107): its marker has no number.
94
+ * the words it is on, quoted, an element's tag left out (P134). The content can read the number;
95
+ * give one only where the page may know it. A draft's is dropped (P107): its marker has no number.
96
96
  */
97
97
  readonly count?: number;
98
98
  /**
@@ -234,6 +234,8 @@ export declare const ANNOTATE_METHODS: {
234
234
  readonly tracked: "porthole/annotate.tracked";
235
235
  /** Host → frame: take the page's text selection away, telling nothing back (P115). */
236
236
  readonly clearSelection: "porthole/annotate.clearSelection";
237
+ /** Host → frame: put the focus on one mark's marker (`{ id }`), telling nothing back (P134). */
238
+ readonly focusMark: "porthole/annotate.focusMark";
237
239
  };
238
240
  /** The most of each part of an anchor or report the host takes. */
239
241
  export declare const ANNOTATION_LIMITS: {
@@ -36,6 +36,8 @@ export const ANNOTATE_METHODS = {
36
36
  tracked: "porthole/annotate.tracked",
37
37
  /** Host → frame: take the page's text selection away, telling nothing back (P115). */
38
38
  clearSelection: "porthole/annotate.clearSelection",
39
+ /** Host → frame: put the focus on one mark's marker (`{ id }`), telling nothing back (P134). */
40
+ focusMark: "porthole/annotate.focusMark",
39
41
  };
40
42
  /** The most of each part of an anchor or report the host takes. */
41
43
  export const ANNOTATION_LIMITS = {