@zumer/snapdom 3.0.0 → 3.0.1-dev.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zumer/snapdom",
-  "version": "3.0.0",
+  "version": "3.0.1-dev.1",
   "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",
@@ -39,10 +39,11 @@
     "test:firefox": "BROWSER=firefox npx vitest run --browser.headless --reporter=verbose",
     "test:webkit": "BROWSER=webkit npx vitest run --browser.headless --reporter=verbose",
     "test:full": "npm run lint && npm run test:types && npm run test:release-checks && npm run test:bundle && BROWSER=all npx vitest run --browser.headless --reporter=dot",
-    "test:release-checks": "node --test scripts/release-checks.node.mjs",
+    "test:release-checks": "node --test scripts/release-checks.node.mjs scripts/benchmark-statistics.node.mjs",
     "report:cross": "node scripts/cross-report.mjs",
     "test:coverage": "npx vitest run --browser.headless --coverage",
-    "test:benchmark": "npx vitest bench --browser.headless --watch=false",
+    "test:benchmark": "node scripts/benchmark-stable.mjs",
+    "test:benchmark:legacy": "npx vitest bench --browser.headless --watch=false",
     "bench:realpage": "node scripts/realpage-bench.mjs",
     "test:pack": "node scripts/check-pack.mjs",
     "site": "npm run compile && node scripts/serve-site.mjs",
@@ -50,9 +51,10 @@
     "bump": "npx @zumerbox/bump && npx @zumerbox/changelog",
     "prepack": "npm run compile",
     "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": "REQUIRE_VISUAL=1 npm run test:full && npm run test:pack && npm run test:benchmark && 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;