@zumer/snapdom 3.0.0-beta.1 → 3.0.1-dev.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zumer/snapdom",
-  "version": "3.0.0-beta.1",
+  "version": "3.0.1-dev.0",
   "description": "Browser capture engine for web interfaces. Reusable images and canvas, with plugins for HTML, context, PDF and recordings.",
   "type": "module",
   "main": "./dist/snapdom.js",
@@ -52,7 +52,8 @@
     "build": "npm pack",
     "release": "REQUIRE_VISUAL=1 npm run test:full && npm run test:pack && npm run build && echo \"\\n→ Review CHANGELOG.md, then: npm run release:push\"",
     "release:push": "git add CHANGELOG.md && git commit -m \"Bumped version\" && git push --follow-tags",
-    "publish:beta": "npm publish --tag beta"
+    "publish:beta": "npm publish --tag beta",
+    "publish:dev": "node scripts/publish-dev.mjs"
   },
   "repository": {
     "type": "git",

package/types/snapdom.d.ts

@@ -152,6 +152,16 @@ export interface SnapdomOptions {
    */
   reconcile?: boolean;
 
+  /**
+   * Whether a long capture may yield to the page. `true` (default) clones in one task, the
+   * fastest total. `false` hands the event loop a turn about every frame, so the page keeps
+   * painting and taking input while it captures. `'auto'` (experimental, may change) does the
+   * same only once a capture runs past 40 ms. When the captured element changes while a capture yields, the clone is
+   * redone in one task; a capture that is never memoized (frame-driven trees, function-valued
+   * callbacks, captureSelection) keeps what it read.
+   */
+  fast?: boolean | "auto";
+
   /**
    * Forces one fresh capture that is not served from the existing memo, and clears style
    * snapshots after application changes for which the browser exposes no signal, notably
@@ -342,6 +352,7 @@ export interface CaptureContext extends Omit<SnapdomOptions, "exclude" | "filter
     classCSS: string;
     fontsCSS: string;
     baseCSS: string;
+    /** Author rules for UA parts the clone cannot read: scrollbars, meter, progress, slider. */
     scrollbarCSS: string;
   } | null;