@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 +16 -0
- package/dist/annotate/types.d.ts +4 -2
- package/dist/annotate/types.js +2 -0
- package/dist/check/page-source.js +1 -1
- package/dist/conformance/harness-source.js +1 -1
- package/dist/host/create-host.js +8 -0
- package/dist/host/types.d.ts +11 -0
- package/dist/react/frame.d.ts +6 -0
- package/dist/react/frame.js +6 -0
- package/dist/react/view.js +1 -0
- package/dist/shell/annotate.d.ts +13 -3
- package/dist/shell/annotate.js +60 -10
- package/docs/ADOPTING.md +23 -4
- package/docs/DECISIONS.md +105 -1
- package/docs/DESIGN.md +11 -8
- package/docs/THREAT_MODEL.md +33 -5
- package/package.json +1 -1
- package/src/annotate/types.ts +4 -2
- package/src/host/create-host.ts +8 -0
- package/src/host/types.ts +11 -0
- package/src/react/frame.tsx +12 -0
- package/src/react/view.tsx +1 -0
- package/src/shell/annotate.ts +61 -10
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,
|
package/dist/annotate/types.d.ts
CHANGED
|
@@ -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
|
-
*
|
|
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: {
|
package/dist/annotate/types.js
CHANGED
|
@@ -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 = {
|