@pixelmatters/markup 1.29.0 → 1.30.0

package/README.md

@@ -37,9 +37,9 @@ CDN drop-in, no build step. Paste this just before `</body>`:
 ```html
 <script type="module">
   // Pin the exact version; esm.sh resolves it from npm
-  import { init } from 'https://esm.sh/@pixelmatters/markup@1.29.0'
+  import { init } from 'https://esm.sh/@pixelmatters/markup@1.30.0'
   // or
-  // import { init } from 'https://esm.run/@pixelmatters/markup@1.29.0'
+  // import { init } from 'https://esm.run/@pixelmatters/markup@1.30.0'
 
   init({
     apiUrl: 'https://your-deployment.convex.site',
@@ -50,14 +50,14 @@ CDN drop-in, no build step. Paste this just before `</body>`:
 </script>
 ```
 
-> **Why pin the version?** CDN URLs without a version (`@pixelmatters/markup`) resolve to whatever's `latest` on npm, so a future major release will break your page with no warning. Always pin (`@pixelmatters/markup@1.29.0`).
+> **Why pin the version?** CDN URLs without a version (`@pixelmatters/markup`) resolve to whatever's `latest` on npm, so a future major release will break your page with no warning. Always pin (`@pixelmatters/markup@1.30.0`).
 
 If your platform doesn't allow inline JS (some CMS / page-builder editors), use the auto-init form instead. Point a `<script src=…>` at the bundle and pass config via `data-*` attributes:
 
 ```html
 <script
   type="module"
-  src="https://esm.sh/@pixelmatters/markup@1.29.0"
+  src="https://esm.sh/@pixelmatters/markup@1.30.0"
   data-markup-widget="true"
   data-api-url="https://your-deployment.convex.site"
   data-api-key="markup_..."
@@ -255,15 +255,16 @@ close.
 
 ### Keyboard & mouse
 
-| Shortcut              | Action                                                                           |
-| --------------------- | -------------------------------------------------------------------------------- |
-| `c`                   | Start placing a markup (ignored while typing)                                    |
-| `@`                   | In a composer, open the member picker. `↑`/`↓` to move, `enter` or `tab` to pick |
-| `cmd/ctrl + enter`    | Post the comment being written                                                   |
-| `esc`                 | Cancel placement, dismiss the mention picker, or close the open popover / menu   |
-| `cmd/ctrl + .`        | Toggle HUD visibility                                                            |
-| `cmd/ctrl + click`    | Click the toolbar's comment button to hide the HUD with a hint toast             |
-| Drag a popover header | Move the open thread / new-thread popover; resets to the pin on reopen           |
+| Shortcut              | Action                                                                            |
+| --------------------- | --------------------------------------------------------------------------------- |
+| `c`                   | Start placing a markup (ignored while typing)                                     |
+| `@`                   | In a composer, open the member picker. `↑`/`↓` to move, `enter` or `tab` to pick  |
+| `cmd/ctrl + enter`    | Post the comment being written                                                    |
+| `enter`               | Send a reply. `shift + enter` adds a new line, as `enter` does on touch keyboards |
+| `esc`                 | Cancel placement, dismiss the mention picker, or close the open popover / menu    |
+| `cmd/ctrl + .`        | Toggle HUD visibility                                                             |
+| `cmd/ctrl + click`    | Click the toolbar's comment button to hide the HUD with a hint toast              |
+| Drag a popover header | Move the open thread / new-thread popover; resets to the pin on reopen            |
 
 ## Screenshots & privacy
 
@@ -401,7 +402,7 @@ to start from `anchorSource` and confirm it, not to trust it blindly.
 
 ## How it works
 
-- The widget mounts `<div id="markup-widget">` on `document.body` and attaches an open shadow root.
+- The widget mounts `<div id="markup-widget">` on `document.body` and attaches an open shadow root. It does so once the page is idle, or 2 s after `init()` on a page that never is, so `init()` returns before the element exists.
 - All UI lives in that shadow root, with `:host { all: initial }` blocking style inheritance.
 - The host element is `position: fixed; inset: 0; pointer-events: none`, so the widget paints over the entire viewport without blocking the host's clicks; only the toolbar and active popovers opt back in to pointer events.
 - Pins are anchored as `(x, y)` fractions of the document plus a CSS path from the nearest landmark (a stable `id`, `data-testid`, `main`, `form`, `table`, …) and the element's text. The path wins when it still resolves, relaxing from the top if a wrapper changed, and a match whose text differs is rejected; the fraction is the fallback so pins survive layout changes.
@@ -495,7 +496,7 @@ For a `<script>` tag drop-in (no bundler), use the inline ESM form and **pin the
 
 ```html
 <script type="module">
-  import { init } from 'https://esm.sh/@pixelmatters/markup@1.29.0'
+  import { init } from 'https://esm.sh/@pixelmatters/markup@1.30.0'
 
   init({
     apiUrl: '...',
@@ -511,7 +512,7 @@ If inline JS is disallowed (some CMS / page-builder editors), use the auto-init
 ```html
 <script
   type="module"
-  src="https://esm.sh/@pixelmatters/markup@1.29.0"
+  src="https://esm.sh/@pixelmatters/markup@1.30.0"
   data-markup-widget="true"
   data-api-url="..."
   data-api-key="..."

package/dist/widget.d.ts

@@ -132,9 +132,10 @@ export interface WidgetConfig {
     analytics?: boolean;
 }
 /**
- * Mounts the feedback widget on the page. Idempotent — calling init again
- * with the same config is a no-op; calling with different config tears down
- * the previous instance first. A host removed from the document by the page
+ * Mounts the feedback widget on the page once it is idle, or after
+ * `IDLE_MOUNT_TIMEOUT_MS` on a page that never is. Idempotent — calling init
+ * again with the same config is a no-op; calling with different config tears
+ * down the previous instance first. A host removed from the document by the page
  * (a body swap on navigation, say) is remounted even when the config matches.
  *
  * Returns a function that unmounts this instance and removes its host