helldots 0.7.0 → 0.9.0

package/dist/index.d.ts

@@ -323,6 +323,68 @@ export interface CommentOverlayOptions {
    * font or adding `crossorigin` to the `<link>`.
    */
   embedCrossOriginFonts?: boolean;
+  /**
+   * Narrows the screenshot renderer's computed-style enumeration to a
+   * curated allow-list instead of every property the browser exposes.
+   *
+   * The enumeration IS the render: it is ~91% of a capture's cost and it
+   * scales with element count, so on a page with a few thousand live nodes
+   * it is the difference between a capture that finishes and one that
+   * visibly stalls. Measured at ~2.7x off that phase.
+   *
+   * Off by default because the list is a fidelity contract, and no list can
+   * be complete for a page this library has never seen: a property it does
+   * not name is simply absent from the image. Turn it on for a heavy page,
+   * then look at a capture before trusting it — and report anything that
+   * comes out wrong, since the fix is one more entry in the list.
+   */
+  fastCapture?: boolean;
+  /**
+   * Renders embedded documents as blank instead of cloning their contents.
+   *
+   * An iframe's cost is invisible from the outside: the renderer walks into
+   * a same-origin frame and clones its whole document, so a page reporting
+   * 242 elements can be a capture of 9 245. Measured at 2374 ms against
+   * 82 ms on one 9 000-node embedded frame.
+   *
+   * The `<iframe>` element itself is kept — its box, its border and the
+   * space it occupies. Removing the element instead would slide everything
+   * below it up by the frame's height and misalign the crop.
+   *
+   * Nothing to gain on a cross-origin frame: the renderer cannot read it,
+   * so it is already blank in the output (it does not stall or wait on it
+   * either). This is for same-origin frames, where the trade is real —
+   * their content is what you lose.
+   */
+  skipIframeContent?: boolean;
+  /**
+   * Milliseconds a single remote asset may hold a capture up.
+   *
+   * The renderer re-fetches the page's images, fonts and `@import`s so it can
+   * inline them, and gives each one an `AbortController` set to 30 000 ms by
+   * default. A URL that never answers stalls the capture until that fires —
+   * the capture still succeeds, with that asset replaced by a transparent
+   * placeholder, but it waits first.
+   *
+   * The wait is **bounded, not multiplied**: measured at the same ~2x the
+   * timeout whether one asset is dead or ten, because they are waited on
+   * concurrently. It is 2x rather than 1x because this one number drives two
+   * waits in sequence on the same asset — first for the image already on the
+   * page to finish loading, then for the fetch that inlines it. Budget
+   * accordingly: 5000 here means roughly ten seconds.
+   *
+   * Left at the renderer's default because lowering it trades a slow capture
+   * for a silently incomplete one: an asset that was merely slow, rather than
+   * dead, is dropped and leaves a hole in the image with nothing to say so.
+   * Set it only if you have measured your own page and decided which way you
+   * want that to fail.
+   *
+   * Only a finite positive number is honoured. The two values a host would
+   * reach for to mean "no deadline" both do the opposite and are ignored: the
+   * renderer reads 0 as "never give up", and `Infinity` is coerced by
+   * `setTimeout` to 0, aborting every asset immediately.
+   */
+  captureTimeout?: number;
   /**
    * Identity used as the author of new comments and replies.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helldots",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Drop-in comment overlay for web apps — click anywhere to leave a comment anchored to that element, with an automatic screenshot and environment capture",
   "keywords": [
     "comments",
@@ -68,12 +68,13 @@
     "eslint-config-prettier": "^10.1.8",
     "globals": "^17.7.0",
     "jsdom": "^29.1.1",
+    "modern-screenshot": "^4.7.0",
     "nanoid": "^6.0.1",
     "prettier": "^3.9.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.9"
   },
-  "dependencies": {
+  "peerDependencies": {
     "modern-screenshot": "^4.7.0"
   }
 }