@inkbar/core 0.4.0 → 0.5.0

package/README.md

@@ -49,13 +49,15 @@ const json = doc.exportAnnotations('json')
 
 `file` can be a `File`, `Blob`, `Uint8Array`, a URL string, `{ url, key }` when the URL is signed and changes between loads, or `{ data, key }` for bytes you want to identify. `quads` is a list of quads in PDF user space.
 
+`exportAnnotations('json')` returns a [Gloss](https://gloss-format.org) document, an open JSON format for PDF annotations, and `importAnnotations` reads one. Gloss has no loupe, mask, pen pressure or free-text border colour, so Inkbar writes them under `custom.inkbar`. It writes a loupe as a circle and a mask as a circle or square, so other Gloss readers can still draw them. Inkbar leaves your own keys under `custom` as they are. In the store and the API, loupes, masks, `pressure` and `borderColor` keep their plain names.
+
 Writing annotations back into the PDF needs `@inkbar/engine`, which is not released yet. Until then `save()` rejects with `EngineUnavailable`. Persist `exportAnnotations('json')` instead and re-import it on the next open. `doc.key` stays the same between opens only when you open with a key: a URL string, `{ url, key }` or `{ data, key }`. A `File`, `Blob` or raw bytes get a new random key each time.
 
 The DOM layer (`@inkbar/core/dom`) provides the viewport, canvas renderer, text layer, overlay and tools for hosts without a framework package. Vue hosts should use [`@inkbar/vue`](https://github.com/inkbar/inkbar/tree/main/packages/vue), React hosts [`@inkbar/react`](https://github.com/inkbar/inkbar/tree/main/packages/react), Svelte hosts [`@inkbar/svelte`](https://github.com/inkbar/inkbar/tree/main/packages/svelte).
 
 ### Without a framework
 
-`createViewer` opens a document and renders it into an element, with a comment thread popover for notes and highlights and a suggested-redaction card. The toolbars are yours: build them from the controls below, which use the same markup as the framework packages, so `@inkbar/theme` styles them.
+`createViewer` opens a document and renders it into an element, with a comment thread popover for notes and highlights. The toolbars are yours: build them from the controls below, which use the same markup as the framework packages, so `@inkbar/theme` styles them.
 
 ```ts
 import {
@@ -101,7 +103,7 @@ viewer.open(lockedFile, { password }) // this password applies to this load only
 viewer.destroy()
 ```
 
-It takes the [`mountViewer` options](#mounting-a-viewer) except `container` and `document`, plus `source` and `assets` (both required), `password`, `defaults`, `history`, `onReady` and `onError`. Set `threads` or `suggestions` to `false` to leave that part out. `viewer.status`, `viewer.document`, `viewer.engine`, `viewer.viewport` and `viewer.tools` are readables; the last two change when the engine rebuilds. A password you pass to `open` replaces the `createViewer` one for that load. The controls are `createToolButton`, `createUndo`, `createRedo`, `createZoomIn`, `createZoomOut`, `createZoomSelect`, `createPageInput`, `createPageCount`, `createPrevPage` and `createNextPage`. Each one disables itself while no document is ready and lives as long as its viewer. Buttons show an icon from [`@inkbar/icons`](https://github.com/inkbar/inkbar/tree/main/packages/icons). Replace their children with your own icon and the accessible name stays; `createIcon` draws any `@inkbar/icons` icon for your own buttons. `createToolbar` gives one Tab stop to all its buttons, with arrow keys between them, and `createToolbarSeparator` divides groups of controls in it. An input, select or textarea you add keeps its arrow keys and its own `tabindex`: it is a Tab stop unless you give it `tabindex="-1"`.
+It takes the [`mountViewer` options](#mounting-a-viewer) except `container` and `document`, plus `source` and `assets` (both required), `password`, `defaults`, `history`, `onReady` and `onError`. Set `threads` to `false` to leave out the thread popover. `viewer.status`, `viewer.document`, `viewer.engine`, `viewer.viewport` and `viewer.tools` are readables; the last two change when the engine rebuilds. `viewer.activated` is a readable too: the id of the annotation the user last clicked or activated with Enter, or `null`. `viewer.setActivated(id)` activates one from your code without calling `onActivate`; it ignores an id the document doesn't have, and `setActivated(null)` clears it. A password you pass to `open` replaces the `createViewer` one for that load. The controls are `createToolButton`, `createUndo`, `createRedo`, `createZoomIn`, `createZoomOut`, `createZoomSelect`, `createPageInput`, `createPageCount`, `createPrevPage` and `createNextPage`. Each one disables itself while no document is ready and lives as long as its viewer. Buttons show an icon from [`@inkbar/icons`](https://github.com/inkbar/inkbar/tree/main/packages/icons). Replace their children with your own icon and the accessible name stays; `createIcon` draws any `@inkbar/icons` icon for your own buttons. `createToolbar` gives one Tab stop to all its buttons, with arrow keys between them, and `createToolbarSeparator` divides groups of controls in it. An input, select or textarea you add keeps its arrow keys and its own `tabindex`: it is a Tab stop unless you give it `tabindex="-1"`.
 
 `createViewer` reads the theme's colours from the element you pass, so that element needs to be in the page when you call it.
 
@@ -130,11 +132,14 @@ Options:
 - `gap`, `buffer` and `customAnnotations` are fixed for a build. Change them with `engine.rebuild`.
 - `toolOptions` holds the tools' options, such as the shape kind. Pass one from `createToolOptions()` and keep it to carry the options over to the next document; `createViewer` keeps one for its whole life. The tool style (colours, line style, text style) belongs to the document: each new document starts from the theme's defaults.
 - `signatures` is where saved signatures live (see [Signatures](#signatures)); `signatureFonts` lists the handwriting fonts a typed signature offers.
+- `decorateAnnotation(annotation)` returns your own `data`, `classes` and `description` for an annotation's element, or `undefined`. `{ data: { 'my-flag': 'on' } }` writes `data-my-flag="on"`, and `description` becomes the element's `aria-description`. Inkbar re-applies them whenever the annotations change. Call `engine.redecorate()` when they depend on anything else. Core's own attributes and `ink-` classes always win.
 - `onActivate(id)` fires when the user activates an annotation.
 - `onBuild(viewport, tools)` fires after every build, the first one included, before `mountViewer` returns. Subscribe to the new viewport and tool controller here.
 - `onPageMount(page, mount, host)` and `onPageUnmount(page)` fire as pages enter and leave the mounted range.
 - `onPageError(page, error)` reports a page whose canvas or text layer failed, and `onPageError(page, null)` once every failed layer renders again. Unmounting a failed page emits no `null`, so clear any per-page error in `onPageUnmount`.
 
+To open your own card next to an annotation, use `createPopover`: it anchors a panel to the annotation's element, follows it as pages mount and unmount, and calls your `onDismiss` on Escape or a press outside. `placePanel` positions a panel against any other rectangle.
+
 The viewport mounts pages synchronously, so a build's page callbacks fire before its `onBuild`. During a rebuild, `engine.viewport` and `engine.tools` still point at the destroyed objects while those callbacks run. Read the arguments instead, or wait for `onBuild`.
 
 ## Annotation changes
@@ -164,16 +169,22 @@ A callout's corner handles resize its text box: the tip and bend stay, and the p
 
 ## Limits of PDF import
 
-Inkbar reads the annotations embedded in a PDF through PDF.js, which passes on only part of each one. Import keeps `intent` (`/IT`) for every type. Three gaps remain, each a follow-up:
+Inkbar reads the annotations embedded in a PDF through PDF.js, which passes on only part of each one. Import keeps `intent` (`/IT`) for every type. Once the document is ready, Inkbar reads from the file itself the fields PDF.js leaves out: a FreeText's `callout`, `fringe`, `head` and font, and a note's icon. They arrive as one `replace` change with `reason: 'embedded'`. That change adds no undo step and keeps the undo history.
+
+Inkbar does not read callout, icon or font fields from encrypted PDFs, from annotations stored as direct objects, or from a file with a broken cross-reference table.
 
-- Read FreeText `/CL`, `/RD` and `/LE` from PDFs. A callout in a PDF imports with `intent: 'FreeTextCallout'` but without `callout`, `fringe` or `head`. PDF.js still paints it from the file's own appearance.
-- Read a note's `/Name` when the note has an appearance stream. PDF.js reports such notes as `NoIcon`, so they import with the default icon, `Note`.
-- Keep line endings Inkbar does not know. PDF.js turns them into `None`. Annotations loaded from JSON keep them.
+One gap remains:
+
+- Keep line endings Inkbar does not know on lines and polylines. PDF.js turns them into `None`. Annotations loaded from JSON keep them.
 
 ## Tools and keyboard
 
 `createToolController` from `@inkbar/core/dom` routes pointer and key events on the viewport to the active tool: `select-text`, `select`, `highlight`, `redact-area`, `sketch`, `draw`, `shape`, `freetext`, `signature` or `note`. Highlights, text redactions, notes and signatures can be made from the keyboard. Area redactions, sketches and drawings need a pointer.
 
+Most creation tools are one-shot: `shape`, `freetext`, `note`, `redact-area` and `signature` each make one thing, select it, then hand back to `select-text`. After a one-shot tool has made something, a press on empty page or `Escape` clears the selection and switches to `select-text` without making anything more. The press that closes a new text box, or a new note's popover, counts as that press too. Until then, what it made keeps its edit handles: drag it to move it, drag a handle to resize it, and the tool stays on. A press on another annotation switches to `select-text` and selects it, and a drag moves it. Removing what the tool made (`Delete`, undo, or a controlled host refusing the add) leaves the tool on for another go, and the selection moving to something else switches to `select-text`. Picking a tool again starts it afresh. While the tool waits for that press, the viewport carries `data-ink-made`. `draw`, `sketch` and `highlight` are sticky: they stay on until you pick another tool.
+
+A host tool says which it is with `kind: 'one-shot' | 'sticky'` (no `kind` is sticky). A one-shot tool adds and selects what it makes, then calls `ctx.made(ids)`; `ctx.done()` clears the selection and switches to `select-text` itself. Under a sticky tool, `ctx.made` does nothing. The controller's `active` readable reports every switch, including one a one-shot tool makes.
+
 | Where focus is               | Key                                 | Effect                                                                                              |
 | ---------------------------- | ----------------------------------- | --------------------------------------------------------------------------------------------------- |
 | Viewport, `highlight` tool   | `Enter`                             | Turns the text selection into a highlight                                                           |
@@ -213,7 +224,7 @@ The `shape` tool's `loupe` kind adds a loupe: a circle that shows the page under
 
 The `shape` tool's `mask` and `ovalMask` kinds add a mask: the page is dimmed everywhere outside a rectangle or an ellipse (`shape: 'rect' | 'ellipse'`), by `dim` (0 to 1, 0.5 by default) in black. A drag sizes it, with `Shift` for a square or circle, and a click places one 72 pt across. Like the loupe it needs a pointer: `Enter` places no mask. A page has one mask: adding a second replaces the first in the same undo step, and in a controlled store in the same `onChange`. The dimming is an SVG (`svg[data-ink-mask-layer]`) between the page and the annotation overlay that never takes the pointer; the mask annotation's own element is the shape, and only a thin band along its edge takes presses. Inside the shape the page works as usual: select text, highlight it, add shapes or notes. The style controls have nothing to change on a mask.
 
-With either select tool (`select-text` or `select`), a selected area redaction, text box, shape, loupe, mask, polyline, polygon or drawing shows four corner handles (`.ink-handle[data-handle="nw|ne|sw|se"]`), and a selected line shows one on each end (`data-handle="start|end"`). Dragging a corner resizes the annotation, scaling its points with it; `Shift` keeps its aspect ratio. Dragging a line end moves that end only. The store records a single update on release. Drag the annotation itself to move it, or any member of a multi-selection to move them all in one undo step. Text markup in the selection stays on its text unless it is the one you drag.
+With either select tool (`select-text` or `select`), or on what a one-shot tool just made, a selected area redaction, text box, shape, loupe, mask, polyline, polygon or drawing shows four corner handles (`.ink-handle[data-handle="nw|ne|sw|se"]`), and a selected line shows one on each end (`data-handle="start|end"`). Dragging a corner resizes the annotation, scaling its points with it; `Shift` keeps its aspect ratio. Dragging a line end moves that end only. The store records a single update on release. Drag the annotation itself to move it, or any member of a multi-selection to move them all in one undo step. Text markup in the selection stays on its text unless it is the one you drag.
 
 A press on text markup (a highlight, underline, strikeout or squiggly) does nothing at first. A click selects it; a drag selects the text under it, as a drag on the bare text would. Presses on every other annotation select it straight away.
 

package/dist/dom.d.mts

@@ -1,4 +1,4 @@
-import { $ as AnnotationDefaults, D as OpenOptions, E as InkStatus, Et as LineEnding, H as AnnotationStore, M as InkError, Nt as NoteAnnotation, Qt as TextMarkupAnnotation, T as InkDocument, Ut as RedactAnnotation, Xt as Suggestion, _ as StyleGroup, a as SignatureStore, at as Annotation, b as ToolStyle, cn as PdfAssets, dn as Quad, et as cssVariableDefaults, fn as Rect, g as ScopedToolStyle, i as SignatureOptions, j as DocumentSource, ln as Matrix, m as CurrentStyle, mt as ConfidenceBucket, o as SignatureTemplate, on as PageInfo, r as SignatureLibrary, tn as Readable, un as Point, v as StyleKey, vt as FreeTextAnnotation, y as StyleProps } from "./signatures-BHYKTwYE.mjs";
+import { D as OpenOptions, E as InkStatus, H as AnnotationStore, M as InkError, Rt as NoteAnnotation, T as InkDocument, _ as StyleGroup, a as SignatureStore, b as ToolStyle, cn as PageInfo, dn as Matrix, fn as Point, g as ScopedToolStyle, i as SignatureOptions, it as cssVariableDefaults, j as DocumentSource, jt as LineEnding, m as CurrentStyle, mn as Rect, o as SignatureTemplate, pn as Quad, r as SignatureLibrary, rn as Readable, rt as AnnotationDefaults, st as Annotation, tn as TextMarkupAnnotation, un as PdfAssets, v as StyleKey, y as StyleProps, yt as FreeTextAnnotation } from "./signatures-BwaXi7C8.mjs";
 import { IconNode } from "@inkbar/icons";
 //#region src/dom/transform.d.ts
 type ViewRotation = 0 | 90 | 180 | 270;
@@ -256,16 +256,38 @@ interface OverlayOptions {
   document?: InkDocument;
   /** Fixed device pixel ratio for loupes; `window.devicePixelRatio` when omitted. */
   devicePixelRatio?: number;
+  /**
+   * The app's own data attributes, classes and description for an annotation's element, read
+   * whenever the annotations change and on `redecorate`. Core's own attributes and `ink-`
+   * classes win over them.
+   */
+  decorate?: DecorateAnnotation;
+}
+/**
+ * Data attributes, classes and a description an app adds to an annotation's element, to style
+ * or find its own marks. Each `data` key is written as `data-<key>`.
+ */
+interface AnnotationDecoration {
+  /** Written as data-<key>; keys are lower-case kebab (/^[a-z][a-z0-9-]*$/). */
+  data?: Readonly<Record<string, string>>;
+  classes?: readonly string[];
+  /**
+   * Extra words screen readers announce after the element's label, such as "Needs review".
+   * Written as `aria-description`.
+   */
+  description?: string;
 }
+/** Returns the decoration for an annotation's element, or undefined for none. */
+type DecorateAnnotation = (annotation: Annotation) => AnnotationDecoration | undefined;
 interface Overlay {
   readonly element: HTMLElement;
   /** Repositions every element and redraws content for a new zoom or rotation. */
   update(transform: PageTransform): void;
   elementFor(id: string): HTMLElement | undefined;
+  /** Runs `decorate` again for every element, for when its output changed but no annotation did. */
+  redecorate(): void;
   destroy(): void;
 }
-/** The `data-confidence` bucket for a suggested redaction; undefined for everything else. */
-export declare function confidenceAttr(a: Annotation): 'low' | 'medium' | 'high' | undefined;
 export declare function createOverlay(opts: OverlayOptions): Overlay;
 //#endregion
 //#region src/dom/overlay-render.d.ts
@@ -287,6 +309,8 @@ interface PageMountOptions {
   store: AnnotationStore;
   onActivate?(id: string): void;
   isCustom?(a: Annotation): boolean;
+  /** The app's data attributes and classes for each annotation element (see `OverlayOptions`). */
+  decorate?: DecorateAnnotation;
   /** Defaults to `window.devicePixelRatio`. */
   devicePixelRatio?: number;
   /**
@@ -328,6 +352,11 @@ export declare function createToolOptions(tools?: readonly Tool[]): ToolOptions;
 type BuiltinToolId = 'select-text' | 'select' | 'highlight' | 'redact-area' | 'note' | 'shape' | 'freetext' | 'draw' | 'sketch' | 'signature';
 /** A built-in tool's id, or any id a host registers its own tool under. */
 type ToolId = BuiltinToolId | (string & {});
+/**
+ * A one-shot tool switches back to `select-text` once it has made something and the user moves
+ * on; a sticky tool stays on. A tool without a kind is sticky.
+ */
+type ToolKind = 'one-shot' | 'sticky';
 interface PageHit extends ViewportHit {
   /** Pointer position in user space. */
   user: Point;
@@ -356,9 +385,18 @@ interface ToolContext {
   };
   /** The signature templates the `signature` tool places. Without it, it places nothing. */
   signatures?: SignatureLibrary | undefined;
+  /**
+   * A one-shot tool reports what it just made, already added and selected. Does nothing under
+   * a sticky tool or with an empty list.
+   */
+  made(ids: readonly string[]): void;
+  /** Clears the selection and switches to `select-text`. */
+  done(): void;
 }
 interface Tool<O extends object = object> {
   id: ToolId;
+  /** Default sticky. */
+  kind?: ToolKind;
   cursor: string;
   /** Style group the tool creates into; select tools have none. */
   styleGroup?: StyleGroup;
@@ -395,8 +433,11 @@ interface ToolController {
   destroy(): void;
 }
 interface ToolControllerOptions {
-  /** The controller adds `options`; `toolStyle` defaults to one of the controller's own. */
-  ctx: Omit<ToolContext, 'toolStyle' | 'options'> & {
+  /**
+   * The controller adds `options`, `made` and `done`; `toolStyle` defaults to one of the
+   * controller's own.
+   */
+  ctx: Omit<ToolContext, 'toolStyle' | 'options' | 'made' | 'done'> & {
     toolStyle?: ToolStyle;
   };
   /** Default `'select-text'`. */
@@ -628,9 +669,11 @@ interface ColorMenuModel {
 }
 /**
  * What a colour menu shows for a style: the palette with the matching swatch checked, "No fill"
- * for `fill`, and the trigger's swatch. Shared by the bindings and the vanilla menu.
+ * for `fill`, and the trigger's swatch. Shared by the bindings and the vanilla menu. `fallback`
+ * is the colour new annotations get while the style leaves it unset: the trigger shows it
+ * rather than an empty swatch.
  */
-export declare function colorMenuModel(property: ColorProperty, current: CurrentStyle, supported: ReadonlySet<StyleKey>): ColorMenuModel;
+export declare function colorMenuModel(property: ColorProperty, current: CurrentStyle, supported: ReadonlySet<StyleKey>, fallback?: string): ColorMenuModel;
 /** A typed size as the menu stores it: a whole number of points within the range. */
 export declare function clampFontSize(size: number): number;
 type TextToggleKey = 'bold' | 'italic' | 'underline';
@@ -739,10 +782,6 @@ interface AnnotationSlotProps {
   locked: boolean;
   select: () => void;
   remove: () => void;
-  /** Turns a suggested redaction into the user's own. No-op for anything else. */
-  accept: () => void;
-  /** Removes a suggested redaction. No-op for anything else. */
-  dismiss: () => void;
 }
 /** The thread popover's accessible name: "Note thread" for a note, "Comment thread" for markup. */
 export declare function threadPopoverLabel(root: Pick<Annotation, 'type'>): string;
@@ -760,15 +799,6 @@ interface ThreadPopoverSlotProps {
   remove: () => void;
   close: () => void;
 }
-/** What a host-rendered suggestion card receives. */
-interface SuggestionCardSlotProps {
-  annotation: RedactAnnotation;
-  suggestion: Suggestion | undefined;
-  bucket: ConfidenceBucket | undefined;
-  accept: () => void;
-  dismiss: () => void;
-  close: () => void;
-}
 /** The signature controls' words, shared so every binding announces the same names. */
 export declare const SIGNATURE_LABELS: {
   /** The menu's group and main button. */
@@ -828,19 +858,30 @@ interface FreeTextEditor {
   /** Closes the editor, handing its text to `commit` (true) or calling `cancel` (false). */
   close(commit: boolean): void;
 }
+/**
+ * What closed an editor: Escape, a press outside it, focus leaving it, or a call to `close`
+ * (a redraw, the page unmounting, the box being removed, a tool switch).
+ */
+type EditorCloseReason = 'escape' | 'press' | 'focus' | 'api';
 interface FreeTextEditorOptions {
   transform: PageTransform;
   /**
    * The edited text and the box's rect, grown to fit it (`grownFreeText`), in user space.
    * `grown` is the growth alone, in CSS px (0 when the box kept its height), for a caller whose
-   * box may have moved or been resized while the editor was open.
+   * box may have moved or been resized while the editor was open. `how` says what closed it.
    */
-  commit(contents: string, rect: Rect, grown: number): void;
+  commit(contents: string, rect: Rect, grown: number, how: EditorCloseReason): void;
   cancel(): void;
+  /** Where to put the caret, a client point (a click on the box); at the end when absent. */
+  caret?: {
+    clientX: number;
+    clientY: number;
+  } | undefined;
 }
 /**
  * Opens an editor on `el`, the overlay element showing `a` (or a stand-in for a box not in the
- * store yet). `Escape` commits; a press outside the editor, or focus leaving it, commits too.
+ * store yet), with the caret at `opts.caret` or after the text. `Escape` commits; a press
+ * outside the editor, or focus leaving it, commits too.
  * Closing while the editor has focus hands focus to `el`. Keys typed in the
  * editor stop there, so no viewport or tool shortcut sees them. Opening a second editor on the
  * same element commits the first.
@@ -908,6 +949,54 @@ interface FocusReturn {
 }
 export declare function createFocusReturn(opts: FocusReturnOptions): FocusReturn;
 //#endregion
+//#region src/dom/viewer/popover.d.ts
+/** Options for `createPopover`. */
+interface PopoverOptions {
+  /** The viewer root (`[data-ink-root]`): anchors are looked up and focus returns inside it. */
+  root: HTMLElement;
+  /**
+   * Attributes for the panel, such as `class`, `aria-label` or the app's own `data-*` keys.
+   * `role` and `data-ink-popover` are always set by `createPopover`.
+   */
+  attrs: Record<string, string>;
+  /** Where focus goes when the panel hides: `createFocusReturn` over the same root. */
+  focusReturn: FocusReturn;
+  /**
+   * Called on Escape inside the panel or the viewer, and on a press outside the panel that will
+   * not activate another annotation. Hide the panel (or clear the activation) here.
+   */
+  onDismiss(): void;
+}
+/** A panel anchored to one annotation at a time; see `createPopover`. */
+interface Popover {
+  /** The panel element, on `<body>`. Fill it with the card's content. */
+  readonly panel: HTMLElement;
+  /** The anchored annotation's element, or null while it is not in the DOM (page unmounted). */
+  readonly anchor: HTMLElement | null;
+  /**
+   * Anchors the panel to annotation `id`. The panel shows whenever that annotation's element
+   * is in the DOM, and follows it when it is replaced.
+   */
+  show(id: string): void;
+  /** Hides the panel, then returns focus through `focusReturn`. */
+  hide(): void;
+  /** Removes the panel and its listeners. */
+  destroy(): void;
+}
+/**
+ * Positions `panel` (fixed) below the `anchor` rectangle, or above it when only that fits,
+ * kept inside the window. For panels anchored to something other than an annotation.
+ */
+export declare function placePanel(panel: HTMLElement, anchor: DOMRect): void;
+/**
+ * Creates a non-modal `role="dialog"` panel on `<body>`, marked `data-ink-popover` so the theme
+ * gives it its tokens, that an app anchors to an annotation with `show(id)` (for instance on
+ * `viewer.activated`). The panel follows the annotation's element as pages mount and unmount:
+ * it hides while the element is gone and comes back with it. Tab loops inside the panel, and
+ * Escape or a press outside calls `onDismiss`. Call `destroy` when done.
+ */
+export declare function createPopover(opts: PopoverOptions): Popover;
+//#endregion
 //#region src/dom/viewer-engine.d.ts
 interface MountViewerOptions {
   container: HTMLElement;
@@ -968,6 +1057,14 @@ interface MountViewerOptions {
   signatureFonts?: string[];
   /** Annotation content is rendered by the host (custom slots). Changing it needs `rebuild`. */
   customAnnotations?: boolean;
+  /**
+   * The app's own data attributes, classes and description for each annotation element, to
+   * style or find its marks: `{ data: { 'my-flag': 'on' } }` writes `data-my-flag="on"`.
+   * Decorations re-apply whenever the annotations change; when the function's output changes
+   * for another reason (app state it reads), call `redecorate()`. Core's attributes and `ink-`
+   * classes cannot be overridden.
+   */
+  decorateAnnotation?: DecorateAnnotation;
   onActivate?(id: string): void;
   /**
    * After every (re)build: subscribe to the new viewport and controller here. It fires inside
@@ -1017,6 +1114,11 @@ interface ViewerEngine {
     buffer?: number;
     customAnnotations?: boolean;
   }): void;
+  /**
+   * Runs `decorateAnnotation` again for every mounted annotation element, without re-rendering
+   * anything else. Call it when the decorations would change but no annotation did.
+   */
+  redecorate(): void;
   destroy(): void;
 }
 export declare function mountViewer(opts: MountViewerOptions): ViewerEngine;
@@ -1037,8 +1139,6 @@ interface CreateViewerOptions extends Omit<MountViewerOptions, 'container' | 'do
   history?: OpenOptions['history'];
   /** The thread popover for notes and text markup. Default true. */
   threads?: boolean;
-  /** Suggested-redaction card. Default true. */
-  suggestions?: boolean;
   onReady?(this: void, doc: InkDocument): void;
   onError?(this: void, error: InkError): void;
 }
@@ -1055,6 +1155,18 @@ interface Viewer {
    */
   readonly viewport: Readable<Viewport | null>;
   readonly tools: Readable<ToolController | null>;
+  /**
+   * The activated annotation's id: the one last clicked, or activated with Enter or Space.
+   * The note thread opens from it, and an app can anchor its own popover (`createPopover`) to
+   * it. `null` when none is, and again once that annotation is removed or the document closes.
+   */
+  readonly activated: Readable<string | null>;
+  /**
+   * Activates annotation `id`, or clears the activation with `null` (closing the thread
+   * popover). Unlike a click, it does not select the annotation or call `onActivate`. An id
+   * not in the open document's annotations is ignored.
+   */
+  setActivated(id: string | null): void;
   /**
    * Opens another document in place; the previous one is destroyed. Latest call wins.
    * `password` is used for this load only; without it, the constructor's `password` applies.
@@ -1123,6 +1235,8 @@ interface ColorMenuOptions {
    * colour whatever tool is active, and recolours the selection only when it is all in the group.
    */
   group?: StyleGroup;
+  /** The colour new annotations get while the style leaves it unset; the trigger shows it. */
+  fallback?: Readable<string | undefined>;
 }
 /** A button that opens a colour menu for one colour property of the selection or tool. */
 export declare function createColorMenu(viewer: Viewer, opts: ColorMenuOptions): HTMLButtonElement;
@@ -1156,6 +1270,8 @@ interface MenuOptions {
    * focusable one.
    */
   role?: 'menu' | 'dialog';
+  /** The element the panel lines up under. Default `trigger`; a split button passes itself. */
+  anchor?: HTMLElement;
   /**
    * Whether `target` belongs to a menu nested in this one (its panel sits outside this panel
    * in the DOM). Presses, focus and Escape inside it neither dismiss this menu nor close it.
@@ -1295,5 +1411,5 @@ export declare function createSignatureDialog(viewer: Viewer, opts?: SignatureDi
 export declare function createSignaturePreview(t: SignatureTemplate): HTMLElement;
 export declare function createSignatureMenu(viewer: Viewer, opts?: SignatureDialogOptions): HTMLElement;
 //#endregion
-export { type AnnotationSlotProps, type AnnotationState, type ArrowheadChoice, type BuiltinToolId, type ColorMenuModel, type ColorMenuOptions, type ColorMenuSwatch, type ColorProperty, type ColorTrigger, type CreateViewerOptions, type CssLayout, type CssLayoutInput, type CssPageBox, type CssRect, type CurrentStyle, type FocusReturn, type FocusReturnOptions, type FreeTextEditor, type FreeTextEditorOptions, type HighlightMenuItem, type HighlightMenuModel, type HighlightOptions, type LayoutMode, type LineStyleMenuItem, type LineStyleMenuModel, type LineStyleMenuSection, type MarkupKind, type Menu, type MenuOptions, type MountViewerOptions, type Overlay, type OverlayOptions, type PageHit, type PageLayer, type PageMount, type PageMountOptions, type PageRenderer, type PageRendererOptions, type PageTransform, type Palette, type ScopedToolStyle, type SelectionQuads, type ShapeKind, type ShapeMenuItem, type ShapeMenuModel, type ShapeOptions, type SignatureDialog, type SignatureDialogOptions, type SignatureDraft, type SignatureDraftState, type SignatureMenuItem, type SignatureMenuModel, type SignatureOptions, type SignaturePad, type SignatureTab, type StyleGroup, type StyleKey, type StyleProps, type SuggestionCardSlotProps, type TextAlignChoice, type TextAlignKey, type TextLayerHandle, type TextLayerOptions, type TextStyleMenuModel, type TextStyleToggle, type TextToggleKey, type ThreadPopoverSlotProps, type Tool, type ToolContext, type ToolController, type ToolControllerOptions, type ToolId, type ToolOptions, type ToolStyle, type ToolStyleTracker, type TypedSignatureOptions, type ViewRotation, type Viewer, type ViewerEngine, type Viewport, type ViewportHit, type ViewportKeysOptions, type ViewportOptions, type ZoomValue, cssVariableDefaults };
+export { type AnnotationDecoration, type AnnotationSlotProps, type AnnotationState, type ArrowheadChoice, type BuiltinToolId, type ColorMenuModel, type ColorMenuOptions, type ColorMenuSwatch, type ColorProperty, type ColorTrigger, type CreateViewerOptions, type CssLayout, type CssLayoutInput, type CssPageBox, type CssRect, type CurrentStyle, type DecorateAnnotation, type EditorCloseReason, type FocusReturn, type FocusReturnOptions, type FreeTextEditor, type FreeTextEditorOptions, type HighlightMenuItem, type HighlightMenuModel, type HighlightOptions, type LayoutMode, type LineStyleMenuItem, type LineStyleMenuModel, type LineStyleMenuSection, type MarkupKind, type Menu, type MenuOptions, type MountViewerOptions, type Overlay, type OverlayOptions, type PageHit, type PageLayer, type PageMount, type PageMountOptions, type PageRenderer, type PageRendererOptions, type PageTransform, type Palette, type Popover, type PopoverOptions, type ScopedToolStyle, type SelectionQuads, type ShapeKind, type ShapeMenuItem, type ShapeMenuModel, type ShapeOptions, type SignatureDialog, type SignatureDialogOptions, type SignatureDraft, type SignatureDraftState, type SignatureMenuItem, type SignatureMenuModel, type SignatureOptions, type SignaturePad, type SignatureTab, type StyleGroup, type StyleKey, type StyleProps, type TextAlignChoice, type TextAlignKey, type TextLayerHandle, type TextLayerOptions, type TextStyleMenuModel, type TextStyleToggle, type TextToggleKey, type ThreadPopoverSlotProps, type Tool, type ToolContext, type ToolController, type ToolControllerOptions, type ToolId, type ToolKind, type ToolOptions, type ToolStyle, type ToolStyleTracker, type TypedSignatureOptions, type ViewRotation, type Viewer, type ViewerEngine, type Viewport, type ViewportHit, type ViewportKeysOptions, type ViewportOptions, type ZoomValue, cssVariableDefaults };
 //# sourceMappingURL=dom.d.mts.map

package/dist/dom.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.mts","names":[],"sources":["../src/dom/transform.ts","../src/dom/layout.ts","../src/dom/viewport.ts","../src/dom/viewport-keys.ts","../src/dom/page-renderer.ts","../src/dom/text-layer.ts","../src/dom/selection.ts","../src/dom/overlay.ts","../src/dom/overlay-render.ts","../src/dom/page-mount.ts","../src/dom/tools/options.ts","../src/dom/tools/controller.ts","../src/dom/tools/freetext.ts","../src/dom/tools/highlight.ts","../src/dom/tools/note.ts","../src/dom/tools/redact-area.ts","../src/dom/tools/select.ts","../src/dom/tools/select-text.ts","../src/model/annotations/shape-geometry.ts","../src/dom/tools/shape.ts","../src/dom/tools/signature.ts","../src/dom/tools/index.ts","../src/dom/ui.ts","../src/dom/palette.ts","../src/dom/freetext-editor.ts","../src/dom/menu-keys.ts","../src/dom/annotation-element.ts","../src/dom/popover-focus.ts","../src/dom/viewer-engine.ts","../src/dom/viewer/create-viewer.ts","../src/dom/viewer/controls.ts","../src/dom/viewer/style-menu.ts","../src/dom/viewer/color-menu.ts","../src/dom/viewer/text-style-menu.ts","../src/dom/viewer/shape-menu.ts","../src/dom/viewer/highlight-menu.ts","../src/dom/shape-icons.ts","../src/dom/markup-icons.ts","../src/dom/viewer/menu.ts","../src/dom/signature-pad.ts","../src/dom/signature-draft.ts","../src/dom/viewer/signature-dialog.ts","../src/dom/viewer/signature-menu.ts"],"mappings":"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"}
+{"version":3,"file":"dom.d.mts","names":[],"sources":["../src/dom/transform.ts","../src/dom/layout.ts","../src/dom/viewport.ts","../src/dom/viewport-keys.ts","../src/dom/page-renderer.ts","../src/dom/text-layer.ts","../src/dom/selection.ts","../src/dom/overlay.ts","../src/dom/overlay-render.ts","../src/dom/page-mount.ts","../src/dom/tools/options.ts","../src/dom/tools/controller.ts","../src/dom/tools/freetext.ts","../src/dom/tools/highlight.ts","../src/dom/tools/note.ts","../src/dom/tools/redact-area.ts","../src/dom/tools/select.ts","../src/dom/tools/select-text.ts","../src/model/annotations/shape-geometry.ts","../src/dom/tools/shape.ts","../src/dom/tools/signature.ts","../src/dom/tools/index.ts","../src/dom/ui.ts","../src/dom/palette.ts","../src/dom/freetext-editor.ts","../src/dom/menu-keys.ts","../src/dom/annotation-element.ts","../src/dom/popover-focus.ts","../src/dom/viewer/popover.ts","../src/dom/viewer-engine.ts","../src/dom/viewer/create-viewer.ts","../src/dom/viewer/controls.ts","../src/dom/viewer/style-menu.ts","../src/dom/viewer/color-menu.ts","../src/dom/viewer/text-style-menu.ts","../src/dom/viewer/shape-menu.ts","../src/dom/viewer/highlight-menu.ts","../src/dom/shape-icons.ts","../src/dom/markup-icons.ts","../src/dom/viewer/menu.ts","../src/dom/signature-pad.ts","../src/dom/signature-draft.ts","../src/dom/viewer/signature-dialog.ts","../src/dom/viewer/signature-menu.ts"],"mappings":"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"}