feat(Dom2Image): update SnapDOM version to 2.24.0

[ArgoZhang]

Link issues

fixes #1093

Summary By Copilot

Regression?

• Yes
• No

Risk

• High
• Medium
• Low

Verification

• Manual (required)
• Automated

Packaging changes reviewed?

• Yes
• No
• N/A

☑️ Self Check before Merge

⚠️ Please check all items below before review. ⚠️

• Doc is updated/provided or not needed
• Demo is updated/provided or not needed
• Merge the latest code from the main branch

Summary by Sourcery

Update the embedded SnapDOM library to v2.24.0 and expand the Dom2Image options and service API to support richer font handling, output configuration, and improved DOM capture behavior.

New Features:

• Add configuration types for local font descriptors and font exclusion rules to the Dom2Image options.
• Expose additional Dom2Image options for output format, filenames, caching, layout reconciliation, placeholders, and proxy/fallback behavior.

Enhancements:

• Replace the previous SnapDOM implementation with the updated v2.24.0 version including performance and compatibility improvements.
• Improve IDom2ImageService and DefaultDom2ImageService XML documentation with bilingual comments.
• Fix the Dom2Image JavaScript stream helper to await the toBlob() result before returning.
• Add a dedicated DI extension method to register the Dom2Image service with clearer naming.

[sourcery-ai]

Sorry @ArgoZhang, your pull request is larger than the review limit of 150000 diff characters

[sourcery-ai]

Reviewer's Guide

Updates the embedded SnapDOM library to v2.24.0 and aligns the Blazor Dom2Image integration (options, service API, and JS glue) with the new SnapDOM features, including font embedding, caching, clipping, and download behavior fixes.

Sequence diagram for updated getStream SnapDOM integration

sequenceDiagram
    participant C# as Dom2ImageService
    participant JS as dom2image.js
    participant Snap as snapdom

    C#->>JS: getStream(selector, options)
    JS->>JS: document.querySelector(selector)
    JS->>Snap: snapdom(el, options || {})
    Snap-->>JS: result (snapdom capture object)
    JS->>Snap: result.toBlob()
    Snap-->>JS: Blob
    JS-->>C#: Blob

Loading

File-Level Changes

Change	Details	Files
Replace the old SnapDOM runtime with the upstream v2.24.0 implementation and adapt the dom2image.js glue code to use its async export APIs correctly.	Completely replace the previous snapdom.mjs contents with the upstream SnapDOM v2.24.0 build, including new modules for caching, font embedding, clipping, transforms, and memoized burst captures. Ensure the JS bridge getStream uses await result.toBlob() instead of the non-awaited call to match the new async API surface and prevent returning a pending Promise.	src/components/BootstrapBlazor.Dom2Image/wwwroot/lib/snapdom.mjs src/components/BootstrapBlazor.Dom2Image/wwwroot/dom2image.js
Expand Dom2ImageOptions and related C# types to expose the new SnapDOM configuration surface (fonts, caching, proxying, clipping, reconcile/burst, etc.) and improve XML documentation.	Introduce Dom2ImageLocalFont and Dom2ImageExcludeFonts classes to describe local fonts and font-exclusion rules that mirror SnapDOM’s font embedding options. Greatly extend Dom2ImageOptions with additional properties (Format, Filename, LocalFonts, IconFonts, ExcludeFonts, FontStylesheetDomains, UseProxy, FallbackURL, Cache, Reconcile, Burst, Invalidate, OuterTransforms, OuterShadows, Placeholders, ResolvePicturePlaceholders, Debug, etc.) and update existing property XML comments to bilingual zh/en descriptions matching SnapDOM semantics. Keep JSON serialization behavior controlled via JsonIgnore attributes, so only explicitly set options are serialized into the JS options object.	src/components/BootstrapBlazor.Dom2Image/Services/Dom2ImageOptions.cs
Improve the Blazor service surface and DI extension docs to be bilingual and aligned with Dom2Image semantics, without changing the runtime behavior.	Update IDom2ImageService method XML comments to bilingual zh/en summaries and remove redundant <returns> tags. Annotate DefaultDom2ImageService and BootstrapBlazorDom2ImageServiceExtensions with zh/en XML doc comments that better describe their role (default Html-to-image implementation and Dom2Image service registration).	src/components/BootstrapBlazor.Dom2Image/Services/IDom2ImageService.cs src/components/BootstrapBlazor.Dom2Image/Services/DefaultDom2ImageService.cs src/components/BootstrapBlazor.Dom2Image/Extensions/ServiceCollectionExtensions.cs

Assessment against linked issues

Issue	Objective	Addressed	Explanation
#1093	Update the bundled SnapDOM library (snapdom.mjs) used by Dom2Image to version 2.24.0.	✅

Possibly linked issues

• feat(Dom2Image): update SnapDOM version to 2.24.0 #1093: PR upgrades snapdom.mjs to v2.24.0 and adjusts Dom2Image options/services, fulfilling the SnapDOM version update request.

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[bb-auto]

Auto approved by bb-auto