Add window snapshotting

[cmsj]

No description provided.

[greptile-apps]

Greptile Summary

Adds asynchronous window snapshotting to the JavaScript-facing hs.window API.

• Captures windows through ScreenCaptureKit and resolves snapshots as HSImage values.
• Supports optional transparency preservation.
• Exposes both instance-level snapshot() and module-level snapshotForID() APIs.
• Validates IDs with an exact CGWindowID conversion, fixing the previously reported oversized-ID crash.
• Updates generated API metadata and TypeScript declarations.

Confidence Score: 5/5

The PR appears safe to merge, with the previously reported oversized-ID crash fully fixed and no new actionable issues found.

Both snapshot entry points now use a failable exact conversion before invoking ScreenCaptureKit, so integers outside the valid UInt32 window-ID range reject their promises rather than trapping, while all valid window IDs remain accepted.

Important Files Changed

Filename	Overview
Hammerspoon 2/Modules/hs.window/HSWindow.swift	Implements ScreenCaptureKit-based window capture and safely rejects invalid instance window IDs.
Hammerspoon 2/Modules/hs.window/HSWindowModule.swift	Adds the module-level snapshot API with exact integer-to-window-ID validation.
docs/api.json	Records the new snapshot APIs in generated API metadata.
docs/hammerspoon.d.ts	Adds TypeScript declarations for both window snapshot entry points.

_{Reviews (2): Last reviewed commit: "Prevent window snapshots from crashing t..." | Re-trigger Greptile}

[cmsj]

@greptile