@weatherboard/annotation 0.4.0 → 0.7.0

package/dist/selection.d.cts

@@ -0,0 +1,27 @@
+/** Host-neutral authored-content selection. No capture token, transport or production arming. */
+export interface RelativePoint {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TextSelectionAnchor {
+    path: string;
+    start: number;
+    end: number;
+    quote: string;
+    prefix: string;
+    suffix: string;
+}
+export type TextPlacement = {
+    state: "exact";
+    range: Range;
+} | {
+    state: "missing" | "ambiguous" | "stale";
+    reason: string;
+};
+export declare function relativePoint(box: Pick<DOMRect, "left" | "top" | "width" | "height">, x: number, y: number): RelativePoint | null;
+export declare function captureTextSelection(scope: Element, selection: Selection | null): TextSelectionAnchor | null;
+/** A snapshot resolver batches DOM traversal for all annotations in one frame. */
+export declare function prepareTextSelections(scope: Element): (anchor: TextSelectionAnchor, unchanged: boolean) => TextPlacement;
+export declare function resolveTextSelection(scope: Element, anchor: TextSelectionAnchor, unchanged: boolean): TextPlacement;

package/dist/selection.d.mts

@@ -0,0 +1,27 @@
+/** Host-neutral authored-content selection. No capture token, transport or production arming. */
+export interface RelativePoint {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TextSelectionAnchor {
+    path: string;
+    start: number;
+    end: number;
+    quote: string;
+    prefix: string;
+    suffix: string;
+}
+export type TextPlacement = {
+    state: "exact";
+    range: Range;
+} | {
+    state: "missing" | "ambiguous" | "stale";
+    reason: string;
+};
+export declare function relativePoint(box: Pick<DOMRect, "left" | "top" | "width" | "height">, x: number, y: number): RelativePoint | null;
+export declare function captureTextSelection(scope: Element, selection: Selection | null): TextSelectionAnchor | null;
+/** A snapshot resolver batches DOM traversal for all annotations in one frame. */
+export declare function prepareTextSelections(scope: Element): (anchor: TextSelectionAnchor, unchanged: boolean) => TextPlacement;
+export declare function resolveTextSelection(scope: Element, anchor: TextSelectionAnchor, unchanged: boolean): TextPlacement;

package/dist/selection.d.ts

@@ -0,0 +1,27 @@
+/** Host-neutral authored-content selection. No capture token, transport or production arming. */
+export interface RelativePoint {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export interface TextSelectionAnchor {
+    path: string;
+    start: number;
+    end: number;
+    quote: string;
+    prefix: string;
+    suffix: string;
+}
+export type TextPlacement = {
+    state: "exact";
+    range: Range;
+} | {
+    state: "missing" | "ambiguous" | "stale";
+    reason: string;
+};
+export declare function relativePoint(box: Pick<DOMRect, "left" | "top" | "width" | "height">, x: number, y: number): RelativePoint | null;
+export declare function captureTextSelection(scope: Element, selection: Selection | null): TextSelectionAnchor | null;
+/** A snapshot resolver batches DOM traversal for all annotations in one frame. */
+export declare function prepareTextSelections(scope: Element): (anchor: TextSelectionAnchor, unchanged: boolean) => TextPlacement;
+export declare function resolveTextSelection(scope: Element, anchor: TextSelectionAnchor, unchanged: boolean): TextPlacement;

package/dist/selection.mjs

@@ -0,0 +1,5 @@
+function A(e,t,i){return![e.left,e.top,e.width,e.height,t,i].every(Number.isFinite)||e.width<=0||e.height<=0||t<e.left||t>e.left+e.width||i<e.top||i>e.top+e.height?null:{x:(t-e.left)/e.width,y:(i-e.top)/e.height,width:e.width,height:e.height}}function M(e,t){let i=Array.from(e.querySelectorAll("[data-annotation-text]")).filter(u=>t==="slide"||u.dataset.annotationText===t);if(t!=="slide"&&i.length!==1)return null;let o=[],n="",a=null,f=0;for(let u of i){let d=e.ownerDocument.createTreeWalker(u,4),r=[],l=d.nextNode();for(;l;){if(++f>1e4)return null;l.parentElement?.closest("[data-annotation-text]")===u&&r.push(l),l=d.nextNode()}n.length&&r.length&&t==="slide"&&(n+=`
+`,o.push({node:r[0],offset:0}));for(let s of r){for(let c=0;c<s.data.length;c++){let x=s.data[c];if(o.push({node:s,offset:c}),n+=x==="\r"?`
+`:x,x==="\r"&&s.data[c+1]===`
+`&&c++,n.length>25e4)return null}a={node:s,offset:s.data.length}}}return{text:n,positions:o,end:a}}function T(e,t,i){if(e.end?.node===t&&e.end.offset===i)return e.text.length;let o=e.positions.findIndex(n=>n.node===t&&n.offset===i);if(o>=0)return o;if(t.nodeType===3&&i===t.textContent?.length){for(let n=e.positions.length-1;n>=0;n--)if(e.positions[n]?.node===t)return n+1}return null}function P(e,t){if(!t||t.isCollapsed||t.rangeCount!==1)return null;let i=t.getRangeAt(0);if(!e.contains(i.startContainer)||!e.contains(i.endContainer))return null;let o=(c,x,g)=>{if(c.nodeType===3)return{node:c,offset:x};let m=c.childNodes[g?x-1:x];if(!m)return null;let h=m;for(;g?h.lastChild:h.firstChild;)h=g?h.lastChild:h.firstChild;return h.nodeType===3?{node:h,offset:g?h.textContent.length:0}:null},n=o(i.startContainer,i.startOffset,!1),a=o(i.endContainer,i.endOffset,!0);if(!n||!a)return null;let f=n.node.parentElement?.closest("[data-annotation-text]"),u=a.node.parentElement?.closest("[data-annotation-text]");if(!f||!u)return null;let d=f===u?f.dataset.annotationText:"slide",r=M(e,d);if(!r)return null;let l=T(r,n.node,n.offset),s=T(r,a.node,a.offset);return l===null||s===null||l>=s||s-l>1024?null:{path:d,start:l,end:s,quote:r.text.slice(l,s),prefix:r.text.slice(Math.max(0,l-128),l),suffix:r.text.slice(s,s+128)}}function p(e,t,i,o){let n=t.positions[i],a=o===t.text.length?t.end:t.positions[o];if(!n||!a)return null;let f=e.ownerDocument.createRange();return f.setStart(n.node,n.offset),f.setEnd(a.node,a.offset),f}function E(e){let t=new Map,i=n=>(t.has(n)||t.set(n,M(e,n)),t.get(n)??null),o=Array.from(new Set(Array.from(e.querySelectorAll("[data-annotation-text]"),n=>n.dataset.annotationText)));return(n,a)=>w(e,n,a,i,o)}function S(e,t,i){return E(e)(t,i)}function w(e,t,i,o,n){if(!t.quote.length)return{state:"missing",reason:"No selected text was recorded."};let a=o(t.path);if(i&&a?.text.slice(t.start,t.end)===t.quote){let d=p(e,a,t.start,t.end);if(d)return{state:"exact",range:d}}let f=t.path==="slide"?["slide"]:n,u=[];for(let d of f){let r=o(d);if(!r)continue;let l=r.text.indexOf(t.quote);for(;l>=0;){if(r.text.slice(Math.max(0,l-t.prefix.length),l)===t.prefix&&r.text.slice(l+t.quote.length,l+t.quote.length+t.suffix.length)===t.suffix){let s=p(e,r,l,l+t.quote.length);if(s&&u.push(s),u.length>1)return{state:"ambiguous",reason:"This text matches more than one location."}}l=r.text.indexOf(t.quote,l+1)}}return u[0]?{state:"exact",range:u[0]}:{state:"stale",reason:"The selected text has changed. The original quote is retained."}}export{P as captureTextSelection,E as prepareTextSelections,A as relativePoint,S as resolveTextSelection};
+//# sourceMappingURL=selection.mjs.map

package/dist/selection.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/selection.ts"],
+  "sourcesContent": ["/** Host-neutral authored-content selection. No capture token, transport or production arming. */\nexport interface RelativePoint { x: number; y: number; width: number; height: number }\nexport interface TextSelectionAnchor {\n  path: string; start: number; end: number; quote: string; prefix: string; suffix: string;\n}\nexport type TextPlacement =\n  | { state: \"exact\"; range: Range }\n  | { state: \"missing\" | \"ambiguous\" | \"stale\"; reason: string };\ninterface Position { node: Text; offset: number }\ninterface TextMap { text: string; positions: Position[]; end: Position | null }\nconst MAX_NODES = 10000;\nconst MAX_TEXT = 250000;\n\nexport function relativePoint(box: Pick<DOMRect, \"left\" | \"top\" | \"width\" | \"height\">, x: number, y: number): RelativePoint | null {\n  if (![box.left, box.top, box.width, box.height, x, y].every(Number.isFinite) || box.width <= 0 || box.height <= 0 ||\n      x < box.left || x > box.left + box.width || y < box.top || y > box.top + box.height) return null;\n  return { x: (x - box.left) / box.width, y: (y - box.top) / box.height, width: box.width, height: box.height };\n}\n\n/** Maps original UTF-16 offsets, folding CRLF as HTML does. Newlines separate authored fields. */\nfunction textMap(scope: Element, path: string): TextMap | null {\n  const fields = Array.from(scope.querySelectorAll<HTMLElement>(\"[data-annotation-text]\"))\n    .filter((field) => path === \"slide\" || field.dataset.annotationText === path);\n  if (path !== \"slide\" && fields.length !== 1) return null;\n  const positions: Position[] = [];\n  let text = \"\";\n  let end: Position | null = null;\n  let nodes = 0;\n  for (const field of fields) {\n    const walker = scope.ownerDocument.createTreeWalker(field, 4);\n    const fieldNodes: Text[] = [];\n    let next = walker.nextNode();\n    while (next) {\n      if (++nodes > MAX_NODES) return null;\n      if (next.parentElement?.closest(\"[data-annotation-text]\") === field) fieldNodes.push(next as Text);\n      next = walker.nextNode();\n    }\n    if (text.length && fieldNodes.length && path === \"slide\") {\n      text += \"\\n\";\n      positions.push({ node: fieldNodes[0]!, offset: 0 });\n    }\n    for (const node of fieldNodes) {\n      for (let offset = 0; offset < node.data.length; offset++) {\n        const character = node.data[offset]!;\n        positions.push({ node, offset });\n        text += character === \"\\r\" ? \"\\n\" : character;\n        if (character === \"\\r\" && node.data[offset + 1] === \"\\n\") offset++;\n        if (text.length > MAX_TEXT) return null;\n      }\n      end = { node, offset: node.data.length };\n    }\n  }\n  return { text, positions, end };\n}\nfunction offsetAt(map: TextMap, node: Node, offset: number): number | null {\n  if (map.end?.node === node && map.end.offset === offset) return map.text.length;\n  const found = map.positions.findIndex((position) => position.node === node && position.offset === offset);\n  if (found >= 0) return found;\n  // Selection can end exactly after a text node before the next field.\n  if (node.nodeType === 3 && offset === node.textContent?.length) {\n    for (let i = map.positions.length - 1; i >= 0; i--) if (map.positions[i]?.node === node) return i + 1;\n  }\n  return null;\n}\n\nexport function captureTextSelection(scope: Element, selection: Selection | null): TextSelectionAnchor | null {\n  if (!selection || selection.isCollapsed || selection.rangeCount !== 1) return null;\n  const range = selection.getRangeAt(0);\n  if (!scope.contains(range.startContainer) || !scope.contains(range.endContainer)) return null;\n  // Browser selection may use element boundaries (select-all, keyboard), not\n  // just text nodes. Resolve those boundaries to the authored text they enclose.\n  const boundary = (node: Node, offset: number, ending: boolean): Position | null => {\n    if (node.nodeType === 3) return { node: node as Text, offset };\n    const child = node.childNodes[ending ? offset - 1 : offset];\n    if (!child) return null;\n    let leaf: Node = child;\n    while (ending ? leaf.lastChild : leaf.firstChild) leaf = (ending ? leaf.lastChild : leaf.firstChild)!;\n    return leaf.nodeType === 3 ? { node: leaf as Text, offset: ending ? leaf.textContent!.length : 0 } : null;\n  };\n  const a = boundary(range.startContainer, range.startOffset, false);\n  const b = boundary(range.endContainer, range.endOffset, true);\n  if (!a || !b) return null;\n  const first = a.node.parentElement?.closest<HTMLElement>(\"[data-annotation-text]\");\n  const last = b.node.parentElement?.closest<HTMLElement>(\"[data-annotation-text]\");\n  if (!first || !last) return null;\n  const path = first === last ? first.dataset.annotationText! : \"slide\";\n  const map = textMap(scope, path);\n  if (!map) return null;\n  const start = offsetAt(map, a.node, a.offset);\n  const end = offsetAt(map, b.node, b.offset);\n  if (start === null || end === null || start >= end || end - start > 1024) return null;\n  return { path, start, end, quote: map.text.slice(start, end),\n    prefix: map.text.slice(Math.max(0, start - 128), start), suffix: map.text.slice(end, end + 128) };\n}\n\nfunction rangeAt(scope: Element, map: TextMap, start: number, end: number): Range | null {\n  const a = map.positions[start];\n  const b = end === map.text.length ? map.end : map.positions[end];\n  if (!a || !b) return null;\n  const range = scope.ownerDocument.createRange();\n  range.setStart(a.node, a.offset);\n  range.setEnd(b.node, b.offset);\n  return range;\n}\n/** A snapshot resolver batches DOM traversal for all annotations in one frame. */\nexport function prepareTextSelections(scope: Element): (anchor: TextSelectionAnchor, unchanged: boolean) => TextPlacement {\n  const maps = new Map<string, TextMap | null>();\n  const getMap = (path: string) => {\n    if (!maps.has(path)) maps.set(path, textMap(scope, path));\n    return maps.get(path) ?? null;\n  };\n  const authoredPaths = Array.from(new Set(Array.from(scope.querySelectorAll<HTMLElement>(\"[data-annotation-text]\"), field => field.dataset.annotationText!)));\n  return (anchor, unchanged) => resolvePrepared(scope, anchor, unchanged, getMap, authoredPaths);\n}\nexport function resolveTextSelection(scope: Element, anchor: TextSelectionAnchor, unchanged: boolean): TextPlacement {\n  return prepareTextSelections(scope)(anchor, unchanged);\n}\nfunction resolvePrepared(scope: Element, anchor: TextSelectionAnchor, unchanged: boolean, getMap: (path: string) => TextMap | null, authoredPaths: string[]): TextPlacement {\n  if (!anchor.quote.length) return { state: \"missing\", reason: \"No selected text was recorded.\" };\n  const original = getMap(anchor.path);\n  if (unchanged && original?.text.slice(anchor.start, anchor.end) === anchor.quote) {\n    const range = rangeAt(scope, original, anchor.start, anchor.end);\n    if (range) return { state: \"exact\", range };\n  }\n  // Positional field paths are valid only at the captured revision. Search all\n  // authored fields after edits; two identical matches must remain ambiguous.\n  const paths = anchor.path === \"slide\" ? [\"slide\"] : authoredPaths;\n  const matches: Range[] = [];\n  for (const path of paths) {\n    const map = getMap(path);\n    if (!map) continue;\n    let index = map.text.indexOf(anchor.quote);\n    while (index >= 0) {\n      if (map.text.slice(Math.max(0, index - anchor.prefix.length), index) === anchor.prefix &&\n          map.text.slice(index + anchor.quote.length, index + anchor.quote.length + anchor.suffix.length) === anchor.suffix) {\n        const range = rangeAt(scope, map, index, index + anchor.quote.length);\n        if (range) matches.push(range);\n        if (matches.length > 1) return { state: \"ambiguous\", reason: \"This text matches more than one location.\" };\n      }\n      index = map.text.indexOf(anchor.quote, index + 1);\n    }\n  }\n  if (matches[0]) return { state: \"exact\", range: matches[0] };\n  return { state: \"stale\", reason: \"The selected text has changed. The original quote is retained.\" };\n}\n"],
+  "mappings": "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",
+  "names": ["relativePoint", "box", "x", "y", "textMap", "scope", "path", "fields", "field", "positions", "text", "end", "nodes", "walker", "fieldNodes", "next", "node", "offset", "character", "offsetAt", "map", "found", "position", "i", "captureTextSelection", "selection", "range", "boundary", "ending", "child", "leaf", "a", "b", "first", "last", "start", "rangeAt", "prepareTextSelections", "maps", "getMap", "authoredPaths", "anchor", "unchanged", "resolvePrepared", "resolveTextSelection", "original", "paths", "matches", "index"]
+}

package/dist/session.d.cts

@@ -0,0 +1,17 @@
+/** Per-tab state. None of these values are cookies or sent by the browser. */
+export declare const CAPTURE_TOKEN_STORAGE_KEY = "ai.annotation.capture";
+export declare const READ_TOKEN_STORAGE_KEY = "ai.annotation.read";
+export declare const REVIEW_RUN_STORAGE_KEY = "ai.annotation.run";
+/** A credential-free record that an annotation deep link was opened. */
+export declare const ANNOTATION_ATTEMPT_STORAGE_KEY = "ai.annotation.attempt";
+export declare const ANNOTATION_ATTEMPT_GLOBAL = "__weatherboardAnnotationAttemptV1";
+export declare const ANNOTATION_STARTUP_STATUS_ID = "ai-annotation-startup-status";
+/** Small enough to remain in the root entry point for Done's full teardown. */
+export declare function clearAnnotationBootstrap(win: Window | null, storage: Pick<Storage, "removeItem"> | null, doc?: Document): void;
+/**
+ * A credential-free note that the shortcut asked to open the toolbar but had
+ * to re-arm first (A-2384). The value is the request time in epoch ms; the
+ * next armed mount in this tab opens the toolbar once if it is fresh.
+ */
+export declare const ANNOTATION_OPEN_INTENT_STORAGE_KEY = "ai.annotation.open";
+export declare const OPEN_INTENT_TTL_MS: number;

package/dist/session.d.mts

@@ -0,0 +1,17 @@
+/** Per-tab state. None of these values are cookies or sent by the browser. */
+export declare const CAPTURE_TOKEN_STORAGE_KEY = "ai.annotation.capture";
+export declare const READ_TOKEN_STORAGE_KEY = "ai.annotation.read";
+export declare const REVIEW_RUN_STORAGE_KEY = "ai.annotation.run";
+/** A credential-free record that an annotation deep link was opened. */
+export declare const ANNOTATION_ATTEMPT_STORAGE_KEY = "ai.annotation.attempt";
+export declare const ANNOTATION_ATTEMPT_GLOBAL = "__weatherboardAnnotationAttemptV1";
+export declare const ANNOTATION_STARTUP_STATUS_ID = "ai-annotation-startup-status";
+/** Small enough to remain in the root entry point for Done's full teardown. */
+export declare function clearAnnotationBootstrap(win: Window | null, storage: Pick<Storage, "removeItem"> | null, doc?: Document): void;
+/**
+ * A credential-free note that the shortcut asked to open the toolbar but had
+ * to re-arm first (A-2384). The value is the request time in epoch ms; the
+ * next armed mount in this tab opens the toolbar once if it is fresh.
+ */
+export declare const ANNOTATION_OPEN_INTENT_STORAGE_KEY = "ai.annotation.open";
+export declare const OPEN_INTENT_TTL_MS: number;

package/dist/session.d.ts

@@ -0,0 +1,17 @@
+/** Per-tab state. None of these values are cookies or sent by the browser. */
+export declare const CAPTURE_TOKEN_STORAGE_KEY = "ai.annotation.capture";
+export declare const READ_TOKEN_STORAGE_KEY = "ai.annotation.read";
+export declare const REVIEW_RUN_STORAGE_KEY = "ai.annotation.run";
+/** A credential-free record that an annotation deep link was opened. */
+export declare const ANNOTATION_ATTEMPT_STORAGE_KEY = "ai.annotation.attempt";
+export declare const ANNOTATION_ATTEMPT_GLOBAL = "__weatherboardAnnotationAttemptV1";
+export declare const ANNOTATION_STARTUP_STATUS_ID = "ai-annotation-startup-status";
+/** Small enough to remain in the root entry point for Done's full teardown. */
+export declare function clearAnnotationBootstrap(win: Window | null, storage: Pick<Storage, "removeItem"> | null, doc?: Document): void;
+/**
+ * A credential-free note that the shortcut asked to open the toolbar but had
+ * to re-arm first (A-2384). The value is the request time in epoch ms; the
+ * next armed mount in this tab opens the toolbar once if it is fresh.
+ */
+export declare const ANNOTATION_OPEN_INTENT_STORAGE_KEY = "ai.annotation.open";
+export declare const OPEN_INTENT_TTL_MS: number;

package/dist/shortcut.d.cts

@@ -0,0 +1,52 @@
+import type { BuildInfo } from "./protocol.cjs";
+/**
+ * The in-app shortcut's pre-arm half (A-2384).
+ *
+ * WHY THIS LIVES IN `./bootstrap` AND NOT IN `mountAnnotation`
+ * A host loads the toolbar behind a dynamic `import()` that only an armed page
+ * reaches (ADOPTING.md, step 6). On an ordinary staging page there is no
+ * marker, so nothing from the index entry point is loaded, and a listener
+ * there cannot hear the chord. This one is installed by the small, statically
+ * imported entry point on every annotatable page, armed or not.
+ *
+ * ONE DECISION, MADE BY WHOEVER IS MOUNTED
+ * The mounted toolbar's own listener toggles the toolbar when the page is armed
+ * with a fresh token, and calls `preventDefault()`. This listener waits for the
+ * dispatch to finish and re-arms only if nothing claimed the chord: no toolbar
+ * loaded, a toolbar whose token is missing or within five minutes of expiry,
+ * or a toolbar the reviewer ended with Done. So the two listeners cannot both
+ * act, and freshness is judged in exactly one place.
+ *
+ * WHAT RE-ARMING IS
+ * A top-level navigation to Studio's `/annotate/arm`, which checks the signed-in
+ * reviewer, mints the tokens and redirects back to the return path with them in
+ * the query; the host's middleware arms on that request and the bootstrap
+ * script strips the query. The only thing this side carries is a return path
+ * with every annotation parameter removed, plus a credential-free open intent
+ * in session storage so the armed mount on return opens the toolbar.
+ *
+ * PRODUCTION
+ * `isAnnotatableBuild` refuses production at install: no listener is added.
+ */
+/** The default chord: Command or Control, Shift and the full stop. */
+export declare const DEFAULT_HOTKEY = "Mod+Shift+Period";
+/** Exact modifiers and a KeyboardEvent code or key, such as Mod+Shift+Period. */
+export declare function matchesHotkey(event: Pick<KeyboardEvent, "key" | "code" | "metaKey" | "ctrlKey" | "shiftKey" | "altKey" | "repeat">, chord: string): boolean;
+export interface AnnotationShortcutOptions {
+    /** The same build the mount is given. Production installs nothing. */
+    build: Pick<BuildInfo, "env">;
+    /**
+     * Studio's arm endpoint for this product's staging target, for example
+     * `https://studio.example/annotate/arm?product=<product-id>&target=staging`. Absolute
+     * http(s), and carrying no `return`: the shortcut adds it.
+     */
+    armUrl: string;
+    /** The chord. The mount must be given the same one. */
+    hotkey: string;
+    /** Defaults to the ambient `document`. */
+    doc?: Document;
+}
+/** The URL the chord navigates to: `armUrl` plus a token-free return path. */
+export declare function annotationArmUrl(armUrl: string, current: string): string;
+/** Install the pre-arm listener. Returns its removal. */
+export declare function installAnnotationShortcut(options: AnnotationShortcutOptions): () => void;

package/dist/shortcut.d.mts

@@ -0,0 +1,52 @@
+import type { BuildInfo } from "./protocol.mjs";
+/**
+ * The in-app shortcut's pre-arm half (A-2384).
+ *
+ * WHY THIS LIVES IN `./bootstrap` AND NOT IN `mountAnnotation`
+ * A host loads the toolbar behind a dynamic `import()` that only an armed page
+ * reaches (ADOPTING.md, step 6). On an ordinary staging page there is no
+ * marker, so nothing from the index entry point is loaded, and a listener
+ * there cannot hear the chord. This one is installed by the small, statically
+ * imported entry point on every annotatable page, armed or not.
+ *
+ * ONE DECISION, MADE BY WHOEVER IS MOUNTED
+ * The mounted toolbar's own listener toggles the toolbar when the page is armed
+ * with a fresh token, and calls `preventDefault()`. This listener waits for the
+ * dispatch to finish and re-arms only if nothing claimed the chord: no toolbar
+ * loaded, a toolbar whose token is missing or within five minutes of expiry,
+ * or a toolbar the reviewer ended with Done. So the two listeners cannot both
+ * act, and freshness is judged in exactly one place.
+ *
+ * WHAT RE-ARMING IS
+ * A top-level navigation to Studio's `/annotate/arm`, which checks the signed-in
+ * reviewer, mints the tokens and redirects back to the return path with them in
+ * the query; the host's middleware arms on that request and the bootstrap
+ * script strips the query. The only thing this side carries is a return path
+ * with every annotation parameter removed, plus a credential-free open intent
+ * in session storage so the armed mount on return opens the toolbar.
+ *
+ * PRODUCTION
+ * `isAnnotatableBuild` refuses production at install: no listener is added.
+ */
+/** The default chord: Command or Control, Shift and the full stop. */
+export declare const DEFAULT_HOTKEY = "Mod+Shift+Period";
+/** Exact modifiers and a KeyboardEvent code or key, such as Mod+Shift+Period. */
+export declare function matchesHotkey(event: Pick<KeyboardEvent, "key" | "code" | "metaKey" | "ctrlKey" | "shiftKey" | "altKey" | "repeat">, chord: string): boolean;
+export interface AnnotationShortcutOptions {
+    /** The same build the mount is given. Production installs nothing. */
+    build: Pick<BuildInfo, "env">;
+    /**
+     * Studio's arm endpoint for this product's staging target, for example
+     * `https://studio.example/annotate/arm?product=<product-id>&target=staging`. Absolute
+     * http(s), and carrying no `return`: the shortcut adds it.
+     */
+    armUrl: string;
+    /** The chord. The mount must be given the same one. */
+    hotkey: string;
+    /** Defaults to the ambient `document`. */
+    doc?: Document;
+}
+/** The URL the chord navigates to: `armUrl` plus a token-free return path. */
+export declare function annotationArmUrl(armUrl: string, current: string): string;
+/** Install the pre-arm listener. Returns its removal. */
+export declare function installAnnotationShortcut(options: AnnotationShortcutOptions): () => void;

package/dist/shortcut.d.ts

@@ -0,0 +1,52 @@
+import type { BuildInfo } from "./protocol.js";
+/**
+ * The in-app shortcut's pre-arm half (A-2384).
+ *
+ * WHY THIS LIVES IN `./bootstrap` AND NOT IN `mountAnnotation`
+ * A host loads the toolbar behind a dynamic `import()` that only an armed page
+ * reaches (ADOPTING.md, step 6). On an ordinary staging page there is no
+ * marker, so nothing from the index entry point is loaded, and a listener
+ * there cannot hear the chord. This one is installed by the small, statically
+ * imported entry point on every annotatable page, armed or not.
+ *
+ * ONE DECISION, MADE BY WHOEVER IS MOUNTED
+ * The mounted toolbar's own listener toggles the toolbar when the page is armed
+ * with a fresh token, and calls `preventDefault()`. This listener waits for the
+ * dispatch to finish and re-arms only if nothing claimed the chord: no toolbar
+ * loaded, a toolbar whose token is missing or within five minutes of expiry,
+ * or a toolbar the reviewer ended with Done. So the two listeners cannot both
+ * act, and freshness is judged in exactly one place.
+ *
+ * WHAT RE-ARMING IS
+ * A top-level navigation to Studio's `/annotate/arm`, which checks the signed-in
+ * reviewer, mints the tokens and redirects back to the return path with them in
+ * the query; the host's middleware arms on that request and the bootstrap
+ * script strips the query. The only thing this side carries is a return path
+ * with every annotation parameter removed, plus a credential-free open intent
+ * in session storage so the armed mount on return opens the toolbar.
+ *
+ * PRODUCTION
+ * `isAnnotatableBuild` refuses production at install: no listener is added.
+ */
+/** The default chord: Command or Control, Shift and the full stop. */
+export declare const DEFAULT_HOTKEY = "Mod+Shift+Period";
+/** Exact modifiers and a KeyboardEvent code or key, such as Mod+Shift+Period. */
+export declare function matchesHotkey(event: Pick<KeyboardEvent, "key" | "code" | "metaKey" | "ctrlKey" | "shiftKey" | "altKey" | "repeat">, chord: string): boolean;
+export interface AnnotationShortcutOptions {
+    /** The same build the mount is given. Production installs nothing. */
+    build: Pick<BuildInfo, "env">;
+    /**
+     * Studio's arm endpoint for this product's staging target, for example
+     * `https://studio.example/annotate/arm?product=<product-id>&target=staging`. Absolute
+     * http(s), and carrying no `return`: the shortcut adds it.
+     */
+    armUrl: string;
+    /** The chord. The mount must be given the same one. */
+    hotkey: string;
+    /** Defaults to the ambient `document`. */
+    doc?: Document;
+}
+/** The URL the chord navigates to: `armUrl` plus a token-free return path. */
+export declare function annotationArmUrl(armUrl: string, current: string): string;
+/** Install the pre-arm listener. Returns its removal. */
+export declare function installAnnotationShortcut(options: AnnotationShortcutOptions): () => void;

package/dist/toolbar.d.cts

@@ -1,6 +1,7 @@
 import type { AnnotationSdk, AnnotationSdkOptions, CommentCollector } from "./sdk.cjs";
 import { type Arming } from "./arming.cjs";
 import type { EgressOutcome } from "./transport.cjs";
+export { DEFAULT_HOTKEY, matchesHotkey } from "./shortcut.cjs";
 /**
  * The toolbar and the post-it (A-240).
  *
@@ -131,6 +132,8 @@ export interface AnnotationToolbarOptions {
      * Unarmed, NOTHING IS APPENDED TO THE DOCUMENT. Not hidden: absent.
      */
     armed?: boolean;
+    /** Keep the toolbar detached until the host's chord is pressed. */
+    dormant?: boolean;
     doc?: Document;
     /** Only for the viewport clamp, so a fake one is two numbers. */
     win?: Pick<Window, "innerWidth" | "innerHeight">;
@@ -149,11 +152,21 @@ export interface AnnotationToolbar {
     showResult: (outcome: EgressOutcome, retry: () => void) => void;
     /** Whether the panel is open. For tests and for the mounting app. */
     isExpanded: () => boolean;
+    setVisible: (visible: boolean) => void;
+    isVisible: () => boolean;
     destroy: () => void;
 }
 export declare function createAnnotationToolbar(options?: AnnotationToolbarOptions): AnnotationToolbar;
 export interface MountAnnotationOptions extends AnnotationSdkOptions {
     toolbar?: AnnotationToolbarOptions;
+    /**
+     * Opt-in (A-2384). A chord such as `DEFAULT_HOTKEY` starts an armed toolbar
+     * hidden until it is pressed; absent or null keeps the immediate toolbar every
+     * mount before 0.7.0 had. Mod means Meta on macOS and Control elsewhere.
+     * Re-arming is not this listener's: with no fresh token it leaves the chord
+     * unclaimed, and `installAnnotationShortcut` (from `./bootstrap`) re-arms.
+     */
+    hotkey?: string | null;
     /**
      * The arming decision, from `readArming()` (A-241).
      *

package/dist/toolbar.d.mts

@@ -1,6 +1,7 @@
 import type { AnnotationSdk, AnnotationSdkOptions, CommentCollector } from "./sdk.mjs";
 import { type Arming } from "./arming.mjs";
 import type { EgressOutcome } from "./transport.mjs";
+export { DEFAULT_HOTKEY, matchesHotkey } from "./shortcut.mjs";
 /**
  * The toolbar and the post-it (A-240).
  *
@@ -131,6 +132,8 @@ export interface AnnotationToolbarOptions {
      * Unarmed, NOTHING IS APPENDED TO THE DOCUMENT. Not hidden: absent.
      */
     armed?: boolean;
+    /** Keep the toolbar detached until the host's chord is pressed. */
+    dormant?: boolean;
     doc?: Document;
     /** Only for the viewport clamp, so a fake one is two numbers. */
     win?: Pick<Window, "innerWidth" | "innerHeight">;
@@ -149,11 +152,21 @@ export interface AnnotationToolbar {
     showResult: (outcome: EgressOutcome, retry: () => void) => void;
     /** Whether the panel is open. For tests and for the mounting app. */
     isExpanded: () => boolean;
+    setVisible: (visible: boolean) => void;
+    isVisible: () => boolean;
     destroy: () => void;
 }
 export declare function createAnnotationToolbar(options?: AnnotationToolbarOptions): AnnotationToolbar;
 export interface MountAnnotationOptions extends AnnotationSdkOptions {
     toolbar?: AnnotationToolbarOptions;
+    /**
+     * Opt-in (A-2384). A chord such as `DEFAULT_HOTKEY` starts an armed toolbar
+     * hidden until it is pressed; absent or null keeps the immediate toolbar every
+     * mount before 0.7.0 had. Mod means Meta on macOS and Control elsewhere.
+     * Re-arming is not this listener's: with no fresh token it leaves the chord
+     * unclaimed, and `installAnnotationShortcut` (from `./bootstrap`) re-arms.
+     */
+    hotkey?: string | null;
     /**
      * The arming decision, from `readArming()` (A-241).
      *

package/dist/toolbar.d.ts

@@ -1,6 +1,7 @@
 import type { AnnotationSdk, AnnotationSdkOptions, CommentCollector } from "./sdk.js";
 import { type Arming } from "./arming.js";
 import type { EgressOutcome } from "./transport.js";
+export { DEFAULT_HOTKEY, matchesHotkey } from "./shortcut.js";
 /**
  * The toolbar and the post-it (A-240).
  *
@@ -131,6 +132,8 @@ export interface AnnotationToolbarOptions {
      * Unarmed, NOTHING IS APPENDED TO THE DOCUMENT. Not hidden: absent.
      */
     armed?: boolean;
+    /** Keep the toolbar detached until the host's chord is pressed. */
+    dormant?: boolean;
     doc?: Document;
     /** Only for the viewport clamp, so a fake one is two numbers. */
     win?: Pick<Window, "innerWidth" | "innerHeight">;
@@ -149,11 +152,21 @@ export interface AnnotationToolbar {
     showResult: (outcome: EgressOutcome, retry: () => void) => void;
     /** Whether the panel is open. For tests and for the mounting app. */
     isExpanded: () => boolean;
+    setVisible: (visible: boolean) => void;
+    isVisible: () => boolean;
     destroy: () => void;
 }
 export declare function createAnnotationToolbar(options?: AnnotationToolbarOptions): AnnotationToolbar;
 export interface MountAnnotationOptions extends AnnotationSdkOptions {
     toolbar?: AnnotationToolbarOptions;
+    /**
+     * Opt-in (A-2384). A chord such as `DEFAULT_HOTKEY` starts an armed toolbar
+     * hidden until it is pressed; absent or null keeps the immediate toolbar every
+     * mount before 0.7.0 had. Mod means Meta on macOS and Control elsewhere.
+     * Re-arming is not this listener's: with no fresh token it leaves the chord
+     * unclaimed, and `installAnnotationShortcut` (from `./bootstrap`) re-arms.
+     */
+    hotkey?: string | null;
     /**
      * The arming decision, from `readArming()` (A-241).
      *

package/dist/transport.d.cts

@@ -49,6 +49,11 @@ export type FrameMessageKind = FrameToParent["type"];
  * successful send and never a failed one.
  */
 export interface SendReceipt {
+    /**
+     * Durable console status for this capture's workflow. This is an opaque URL
+     * supplied by the console, not a client-derived run identifier.
+     */
+    progressUrl?: string;
     /**
      * The issue this capture became, when the far end names one.
      *
@@ -57,6 +62,11 @@ export interface SendReceipt {
      * crossing the network boundary is put through before it gets to be one.
      */
     issueUrl?: string;
+    saved?: {
+        feedbackId: string;
+        recoveryUrl?: string;
+        message: string;
+    };
 }
 /**
  * A URL from the network that is safe to put in somebody else's page (A-240).

package/dist/transport.d.mts

@@ -49,6 +49,11 @@ export type FrameMessageKind = FrameToParent["type"];
  * successful send and never a failed one.
  */
 export interface SendReceipt {
+    /**
+     * Durable console status for this capture's workflow. This is an opaque URL
+     * supplied by the console, not a client-derived run identifier.
+     */
+    progressUrl?: string;
     /**
      * The issue this capture became, when the far end names one.
      *
@@ -57,6 +62,11 @@ export interface SendReceipt {
      * crossing the network boundary is put through before it gets to be one.
      */
     issueUrl?: string;
+    saved?: {
+        feedbackId: string;
+        recoveryUrl?: string;
+        message: string;
+    };
 }
 /**
  * A URL from the network that is safe to put in somebody else's page (A-240).

package/dist/transport.d.ts

@@ -49,6 +49,11 @@ export type FrameMessageKind = FrameToParent["type"];
  * successful send and never a failed one.
  */
 export interface SendReceipt {
+    /**
+     * Durable console status for this capture's workflow. This is an opaque URL
+     * supplied by the console, not a client-derived run identifier.
+     */
+    progressUrl?: string;
     /**
      * The issue this capture became, when the far end names one.
      *
@@ -57,6 +62,11 @@ export interface SendReceipt {
      * crossing the network boundary is put through before it gets to be one.
      */
     issueUrl?: string;
+    saved?: {
+        feedbackId: string;
+        recoveryUrl?: string;
+        message: string;
+    };
 }
 /**
  * A URL from the network that is safe to put in somebody else's page (A-240).