react-smart-copy 1.26.0 → 1.27.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +6 -3
- package/dist/capture.cjs +4 -4
- package/dist/capture.cjs.map +1 -1
- package/dist/capture.js +4 -4
- package/dist/capture.js.map +1 -1
- package/dist/chunks/clipboard-adapter-0haPt4jJ.js +217 -0
- package/dist/chunks/clipboard-adapter-0haPt4jJ.js.map +1 -0
- package/dist/chunks/clipboard-adapter-5bmjKbyK.cjs +222 -0
- package/dist/chunks/clipboard-adapter-5bmjKbyK.cjs.map +1 -0
- package/dist/chunks/{clipboard-adapter-CfaIbZpv.d.cts → clipboard-adapter-CUvmAcRE.d.cts} +10 -1
- package/dist/chunks/{clipboard-adapter-Chm6zq60.d.ts → clipboard-adapter-CdOzN135.d.ts} +10 -1
- package/dist/chunks/{contrast-C9d8QuaF.cjs → contrast-BatHkv8j.cjs} +2 -2
- package/dist/chunks/{contrast-C9d8QuaF.cjs.map → contrast-BatHkv8j.cjs.map} +1 -1
- package/dist/chunks/{contrast-DUaZq5SA.js → contrast-DnCunIr1.js} +2 -2
- package/dist/chunks/{contrast-DUaZq5SA.js.map → contrast-DnCunIr1.js.map} +1 -1
- package/dist/chunks/{core-t59Z4gdy.cjs → core-BRMlZOtj.cjs} +5 -5
- package/dist/chunks/{core-t59Z4gdy.cjs.map → core-BRMlZOtj.cjs.map} +1 -1
- package/dist/chunks/{core-D3GCO3yT.js → core-CnAFS4Wh.js} +5 -5
- package/dist/chunks/{core-D3GCO3yT.js.map → core-CnAFS4Wh.js.map} +1 -1
- package/dist/chunks/{deadline-j2hD7JKz.cjs → deadline-Cz6l-PDR.cjs} +14 -2
- package/dist/chunks/deadline-Cz6l-PDR.cjs.map +1 -0
- package/dist/chunks/{deadline-CbwnZ3Oq.js → deadline-DTAkra5B.js} +9 -3
- package/dist/chunks/deadline-DTAkra5B.js.map +1 -0
- package/dist/chunks/{errors-DFmEAC4E.cjs → errors-CF2EQNbc.cjs} +14 -2
- package/dist/chunks/errors-CF2EQNbc.cjs.map +1 -0
- package/dist/chunks/{errors-CT-FfUtU.js → errors-CGcMvbhJ.js} +9 -3
- package/dist/chunks/errors-CGcMvbhJ.js.map +1 -0
- package/dist/chunks/{field-B6SRWRbI.cjs → field-C8A5Yxln.cjs} +3 -3
- package/dist/chunks/{field-B6SRWRbI.cjs.map → field-C8A5Yxln.cjs.map} +1 -1
- package/dist/chunks/{field-DsRKkbav.js → field-CDCN9x0L.js} +3 -3
- package/dist/chunks/{field-DsRKkbav.js.map → field-CDCN9x0L.js.map} +1 -1
- package/dist/chunks/{index-CZ6HpdKm.d.cts → index-Ct2V52et.d.cts} +2 -2
- package/dist/chunks/{index-BidyqUMa.d.ts → index-U91G1nS9.d.ts} +2 -2
- package/dist/chunks/{limits-BP9R5wnr.js → limits-DvJZJn0V.js} +2 -2
- package/dist/chunks/{limits-BP9R5wnr.js.map → limits-DvJZJn0V.js.map} +1 -1
- package/dist/chunks/{limits-9wi1f6xT.cjs → limits-Vy-Xv26D.cjs} +2 -2
- package/dist/chunks/{limits-9wi1f6xT.cjs.map → limits-Vy-Xv26D.cjs.map} +1 -1
- package/dist/chunks/{paste-reader-BWQaYNaV.cjs → paste-reader-BL51Jt1y.cjs} +2 -2
- package/dist/chunks/{paste-reader-BWQaYNaV.cjs.map → paste-reader-BL51Jt1y.cjs.map} +1 -1
- package/dist/chunks/{paste-reader-D6uOTDBM.js → paste-reader-BpXOH_Px.js} +2 -2
- package/dist/chunks/{paste-reader-D6uOTDBM.js.map → paste-reader-BpXOH_Px.js.map} +1 -1
- package/dist/chunks/{payload-BrQWGwyx.js → payload-5uJedhwz.js} +2 -2
- package/dist/chunks/{payload-BrQWGwyx.js.map → payload-5uJedhwz.js.map} +1 -1
- package/dist/chunks/{payload-BWQ6sPtS.js → payload-DZnXoBmF.js} +3 -3
- package/dist/chunks/{payload-BWQ6sPtS.js.map → payload-DZnXoBmF.js.map} +1 -1
- package/dist/chunks/{payload-sBxkG7jH.cjs → payload-DjSSLonm.cjs} +2 -2
- package/dist/chunks/{payload-sBxkG7jH.cjs.map → payload-DjSSLonm.cjs.map} +1 -1
- package/dist/chunks/{payload-tTK6REua.cjs → payload-DzHhs6Ey.cjs} +3 -3
- package/dist/chunks/{payload-tTK6REua.cjs.map → payload-DzHhs6Ey.cjs.map} +1 -1
- package/dist/chunks/{share-nx7M4Z0t.cjs → share-Bu5u2ItX.cjs} +6 -6
- package/dist/chunks/{share-nx7M4Z0t.cjs.map → share-Bu5u2ItX.cjs.map} +1 -1
- package/dist/chunks/{share-CU91L4EK.js → share-CL72PUqq.js} +6 -6
- package/dist/chunks/{share-CU91L4EK.js.map → share-CL72PUqq.js.map} +1 -1
- package/dist/chunks/{share-DVR_DhHc.d.ts → share-DMqvWz32.d.ts} +2 -2
- package/dist/chunks/{share-hIwth7Dh.d.cts → share-DQFF73gt.d.cts} +2 -2
- package/dist/chunks/{url-BrhVUwn7.cjs → url-CL4YTCvM.cjs} +2 -2
- package/dist/chunks/{url-BrhVUwn7.cjs.map → url-CL4YTCvM.cjs.map} +1 -1
- package/dist/chunks/{url-COID0BLY.js → url-zB_krkuF.js} +2 -2
- package/dist/chunks/{url-COID0BLY.js.map → url-zB_krkuF.js.map} +1 -1
- package/dist/code.cjs +2 -2
- package/dist/code.js +2 -2
- package/dist/color.cjs +2 -2
- package/dist/color.js +2 -2
- package/dist/core.cjs +5 -5
- package/dist/core.d.cts +2 -2
- package/dist/core.d.ts +2 -2
- package/dist/core.js +5 -5
- package/dist/email.cjs +2 -2
- package/dist/email.js +2 -2
- package/dist/files.cjs +1 -1
- package/dist/files.js +1 -1
- package/dist/image.cjs +3 -3
- package/dist/image.cjs.map +1 -1
- package/dist/image.js +3 -3
- package/dist/image.js.map +1 -1
- package/dist/index.cjs +7 -7
- package/dist/index.d.cts +3 -3
- package/dist/index.d.ts +3 -3
- package/dist/index.js +7 -7
- package/dist/link.cjs +3 -3
- package/dist/link.js +3 -3
- package/dist/markdown.cjs +1 -1
- package/dist/markdown.js +1 -1
- package/dist/number.cjs +2 -2
- package/dist/number.js +2 -2
- package/dist/otp.cjs +1 -1
- package/dist/otp.js +1 -1
- package/dist/rich.cjs +3 -3
- package/dist/rich.js +3 -3
- package/dist/secrets.cjs +1 -1
- package/dist/secrets.js +1 -1
- package/dist/share.cjs +1 -1
- package/dist/share.d.cts +1 -1
- package/dist/share.d.ts +1 -1
- package/dist/share.js +1 -1
- package/dist/structured.cjs +2 -2
- package/dist/structured.js +2 -2
- package/dist/table.cjs +1 -1
- package/dist/table.js +1 -1
- package/dist/testing.cjs +2 -2
- package/dist/testing.d.cts +1 -1
- package/dist/testing.d.ts +1 -1
- package/dist/testing.js +2 -2
- package/package.json +8 -8
- package/dist/chunks/clipboard-adapter-CmKDTFdO.js +0 -97
- package/dist/chunks/clipboard-adapter-CmKDTFdO.js.map +0 -1
- package/dist/chunks/clipboard-adapter-UIFc_Qso.cjs +0 -102
- package/dist/chunks/clipboard-adapter-UIFc_Qso.cjs.map +0 -1
- package/dist/chunks/deadline-CbwnZ3Oq.js.map +0 -1
- package/dist/chunks/deadline-j2hD7JKz.cjs.map +0 -1
- package/dist/chunks/errors-CT-FfUtU.js.map +0 -1
- package/dist/chunks/errors-DFmEAC4E.cjs.map +0 -1
package/README.md
CHANGED
|
@@ -23,7 +23,7 @@ Phone +91 98xxx xxxxx [Copy]
|
|
|
23
23
|
ID PLT-29018 [Copy]
|
|
24
24
|
```
|
|
25
25
|
|
|
26
|
-
- **Small.** About
|
|
26
|
+
- **Small.** About 4.2 kB for `useCopy` (min + brotli), zero runtime dependencies, and every
|
|
27
27
|
module is a separate entry point that shares one copy of the core.
|
|
28
28
|
- **Honest.** Every failure is a typed, classified error. Nothing silently does nothing.
|
|
29
29
|
- **Accessible.** Real buttons, accessible names, polite announcements, reduced motion, and
|
|
@@ -46,6 +46,9 @@ without it, in browsers and in Node.js 18 or later.
|
|
|
46
46
|
|
|
47
47
|
## Quick start
|
|
48
48
|
|
|
49
|
+
Coming from `react-copy-to-clipboard`, `copy-to-clipboard` or `navigator.clipboard`? See
|
|
50
|
+
[Migrating](https://suprabhat02.github.io/react-smart-copy/start/migrating/).
|
|
51
|
+
|
|
49
52
|
A copy button, with everything around it:
|
|
50
53
|
|
|
51
54
|
```tsx
|
|
@@ -135,8 +138,8 @@ Sizes are minified and brotli-compressed, for everything the entry point exports
|
|
|
135
138
|
|
|
136
139
|
| Entry point | What it is for | Size |
|
|
137
140
|
| --- | --- | --- |
|
|
138
|
-
| [`react-smart-copy`](https://suprabhat02.github.io/react-smart-copy/start/introduction/) | React hooks and components: `useCopy`, `usePaste`, `CopyField`, `PasteField`, `CopyGroup`, `useCopyInterceptor`, `useDragCopy`, `useShare`, `useOtpField`, `useClipboardPermission` | from
|
|
139
|
-
| [`/core`](https://suprabhat02.github.io/react-smart-copy/guides/without-react/) | The framework-agnostic machines and adapters |
|
|
141
|
+
| [`react-smart-copy`](https://suprabhat02.github.io/react-smart-copy/start/introduction/) | React hooks and components: `useCopy`, `usePaste`, `CopyField`, `PasteField`, `CopyGroup`, `useCopyInterceptor`, `useDragCopy`, `useShare`, `useOtpField`, `useClipboardPermission` | from 4.2 kB |
|
|
142
|
+
| [`/core`](https://suprabhat02.github.io/react-smart-copy/guides/without-react/) | The framework-agnostic machines and adapters | 9.3 kB |
|
|
140
143
|
| [`/capture`](https://suprabhat02.github.io/react-smart-copy/copy/capture/) | Copy an `<svg>` or a piece of your UI as a PNG | 3.4 kB |
|
|
141
144
|
| [`/table`](https://suprabhat02.github.io/react-smart-copy/modules/tables/) | Ranges that paste into Excel and Google Sheets as cells, and back as typed records | 5.6 kB |
|
|
142
145
|
| [`/structured`](https://suprabhat02.github.io/react-smart-copy/modules/structured/) | Your own typed, versioned, validated objects on the clipboard | 3.5 kB |
|
package/dist/capture.cjs
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
4
|
-
const require_payload = require("./chunks/payload-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
|
+
const require_payload = require("./chunks/payload-DjSSLonm.cjs");
|
|
5
5
|
const require_mime = require("./chunks/mime--LB7kdqG.cjs");
|
|
6
|
-
const require_deadline = require("./chunks/deadline-
|
|
6
|
+
const require_deadline = require("./chunks/deadline-Cz6l-PDR.cjs");
|
|
7
7
|
//#region src/capture/environment.ts
|
|
8
8
|
function loadImage(url) {
|
|
9
9
|
return new Promise((resolve, reject) => {
|
|
@@ -119,7 +119,7 @@ function assertPixelBudget(width, height, maxPixels) {
|
|
|
119
119
|
//#region src/capture/render.ts
|
|
120
120
|
/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */
|
|
121
121
|
function classifyCaptureError(cause, label) {
|
|
122
|
-
return require_errors.isCopyFailure(cause) ? cause :
|
|
122
|
+
return require_errors.isCopyFailure(cause) ? cause : require_deadline.blobFailure(label, cause);
|
|
123
123
|
}
|
|
124
124
|
/**
|
|
125
125
|
* Decodes an image Blob and re-encodes it as PNG at `target` (or its natural
|
package/dist/capture.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capture.cjs","names":["copyFailure","copyFailure","isCopyFailure","copyFailure","withDeadline","sniffImageType","IMAGE_MIME_TYPE","copyFailure","SVG_MIME_TYPE","copyFailure","isBlob","withDeadline"],"sources":["../src/capture/environment.ts","../src/capture/options.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** A decoded image, ready to be drawn. `source` is platform-specific (an `HTMLImageElement` in browsers). */\nexport interface DecodedImage {\n readonly source: unknown;\n readonly width: number;\n readonly height: number;\n}\n\nexport interface PngTarget {\n /** Integer pixel size of the output. */\n readonly width: number;\n readonly height: number;\n /** CSS colour painted under the image, or `null` for transparency. */\n readonly background: string | null;\n}\n\n/**\n * Everything capture needs from the platform. The default uses the DOM;\n * inject your own for workers (OffscreenCanvas), native shells or tests.\n */\nexport interface CaptureEnvironment {\n readonly createObjectURL: (blob: Blob) => string;\n readonly revokeObjectURL: (url: string) => void;\n /** Serialises an `<svg>` element to markup. */\n readonly serializeSvg: (node: Element) => string;\n /** Decodes an image from a `blob:` or `data:` URL. */\n readonly loadImage: (url: string) => Promise<DecodedImage>;\n /** Draws the image scaled to `target` and encodes it as PNG. */\n readonly encodePng: (image: DecodedImage, target: PngTarget) => Promise<Blob>;\n}\n\nfunction loadImage(url: string): Promise<DecodedImage> {\n return new Promise((resolve, reject) => {\n const image = new Image();\n image.decoding = 'async';\n image.onload = () => {\n resolve({ source: image, width: image.naturalWidth, height: image.naturalHeight });\n };\n image.onerror = () => {\n reject(copyFailure('blob-generation-failed', 'The image could not be decoded.'));\n };\n image.src = url;\n });\n}\n\nfunction encodePng(image: DecodedImage, target: PngTarget): Promise<Blob> {\n return new Promise((resolve, reject) => {\n const canvas = document.createElement('canvas');\n canvas.width = target.width;\n canvas.height = target.height;\n const context = canvas.getContext('2d');\n if (!context) {\n reject(copyFailure('unsupported', 'Canvas 2D rendering is not available.'));\n return;\n }\n if (target.background !== null) {\n context.fillStyle = target.background;\n context.fillRect(0, 0, target.width, target.height);\n }\n context.drawImage(image.source as CanvasImageSource, 0, 0, target.width, target.height);\n // Throws SecurityError synchronously for tainted canvases; the executor turns that into a rejection.\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing (canvas too large?).'));\n }, 'image/png');\n });\n}\n\n/** The DOM-backed environment, or `null` outside a browser. */\nexport function getDefaultCaptureEnvironment(): CaptureEnvironment | null {\n if (\n typeof document === 'undefined' ||\n typeof Image !== 'function' ||\n typeof XMLSerializer !== 'function' ||\n typeof URL.createObjectURL !== 'function'\n ) {\n return null;\n }\n return {\n createObjectURL: (blob) => URL.createObjectURL(blob),\n revokeObjectURL: (url) => {\n URL.revokeObjectURL(url);\n },\n serializeSvg: (node) => new XMLSerializer().serializeToString(node),\n loadImage,\n encodePng,\n };\n}\n\nexport function resolveCaptureEnvironment(environment: CaptureEnvironment | undefined): CaptureEnvironment {\n const resolved = environment ?? getDefaultCaptureEnvironment();\n if (!resolved) {\n throw copyFailure('unsupported', 'Image capture needs a browser environment (document, Image, canvas).');\n }\n return resolved;\n}\n","import { copyFailure } from '../core/errors';\nimport type { CaptureEnvironment } from './environment';\n\nexport const DEFAULT_CAPTURE_SCALE = 2;\nexport const MAX_CAPTURE_SCALE = 10;\n/** 4096 × 4096: the canvas area limit of Safari/iOS, the strictest mainstream engine. */\nexport const DEFAULT_MAX_PIXELS = 16_777_216;\nexport const DEFAULT_CAPTURE_TIMEOUT_MS = 15_000;\n\nexport interface RenderOptions {\n /** Output width in CSS px (before `scale`). Omit to use the intrinsic size; set one side to keep the aspect ratio. */\n readonly width?: number;\n /** Output height in CSS px (before `scale`). */\n readonly height?: number;\n /** Pixel density multiplier, e.g. `window.devicePixelRatio`. Default 2 (crisp on HiDPI). Max 10. */\n readonly scale?: number;\n /** CSS colour under the image. Default `null` (transparent). */\n readonly background?: string | null;\n /** Refuse outputs larger than this many pixels (memory / DoS guard). Default 16 777 216. */\n readonly maxPixels?: number;\n /** Give up after this long. Default 15 000 ms. `Infinity` disables. */\n readonly timeoutMs?: number;\n /** Cancel the capture. */\n readonly signal?: AbortSignal;\n /** Platform hooks. Defaults to the DOM. */\n readonly environment?: CaptureEnvironment;\n}\n\nexport interface RenderSettings {\n readonly scale: number;\n readonly background: string | null;\n readonly maxPixels: number;\n readonly timeoutMs: number;\n}\n\nexport interface Size {\n readonly width: number;\n readonly height: number;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nconst isPositiveFinite = (value: number): boolean => Number.isFinite(value) && value > 0;\n\nexport function resolveRenderSettings(options: RenderOptions): RenderSettings {\n const scale = options.scale ?? DEFAULT_CAPTURE_SCALE;\n if (!isPositiveFinite(scale) || scale > MAX_CAPTURE_SCALE) {\n throw invalid(`\\`scale\\` must be > 0 and <= ${String(MAX_CAPTURE_SCALE)} (received ${String(scale)}).`);\n }\n const maxPixels = options.maxPixels ?? DEFAULT_MAX_PIXELS;\n if (!Number.isInteger(maxPixels) || maxPixels <= 0) {\n throw invalid(`\\`maxPixels\\` must be a positive integer (received ${String(maxPixels)}).`);\n }\n const timeoutMs = options.timeoutMs ?? DEFAULT_CAPTURE_TIMEOUT_MS;\n if (timeoutMs !== Infinity && !isPositiveFinite(timeoutMs)) {\n throw invalid(`\\`timeoutMs\\` must be > 0 or Infinity (received ${String(timeoutMs)}).`);\n }\n return { scale, background: options.background ?? null, maxPixels, timeoutMs };\n}\n\n/** Combines explicit `width`/`height` with an intrinsic size, keeping the aspect ratio when only one is set. */\nexport function resolveSize(intrinsic: Size | null, width: number | undefined, height: number | undefined): Size {\n for (const [name, value] of [\n ['width', width],\n ['height', height],\n ] as const) {\n if (value !== undefined && !isPositiveFinite(value)) {\n throw invalid(`\\`${name}\\` must be a positive number (received ${String(value)}).`);\n }\n }\n if (width !== undefined && height !== undefined) return { width, height };\n if (intrinsic === null) {\n throw invalid('The size to render is unknown: pass `width` and `height`, or give the source a size.');\n }\n if (width !== undefined) return { width, height: (width * intrinsic.height) / intrinsic.width };\n if (height !== undefined) return { width: (height * intrinsic.width) / intrinsic.height, height };\n return intrinsic;\n}\n\n/** Integer pixel size after scaling. Throws `too-large` past `maxPixels`. */\nexport function toPixelSize(size: Size, settings: Pick<RenderSettings, 'scale' | 'maxPixels'>): Size {\n const width = Math.max(1, Math.round(size.width * settings.scale));\n const height = Math.max(1, Math.round(size.height * settings.scale));\n assertPixelBudget(width, height, settings.maxPixels);\n return { width, height };\n}\n\nexport function assertPixelBudget(width: number, height: number, maxPixels: number): void {\n if (width * height > maxPixels) {\n throw copyFailure(\n 'too-large',\n `A ${String(width)}×${String(height)} image exceeds the ${String(maxPixels)}-pixel limit. Lower \\`scale\\` or raise \\`maxPixels\\`.`,\n );\n }\n}\n","import { copyFailure, isCopyFailure } from '../core/errors';\nimport { IMAGE_MIME_TYPE } from '../core/payload';\nimport { sniffImageType } from '../core/mime';\nimport { withDeadline } from './deadline';\nimport type { CaptureEnvironment } from './environment';\nimport { assertPixelBudget, type RenderSettings, type Size } from './options';\n\n/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */\nexport function classifyCaptureError(cause: unknown, label: string): unknown {\n return isCopyFailure(cause) ? cause : copyFailure('blob-generation-failed', `${label} failed.`, cause);\n}\n\n/**\n * Decodes an image Blob and re-encodes it as PNG at `target` (or its natural\n * size), within the deadline. The object URL is always revoked.\n */\nexport async function drawBlobToPng(\n blob: Blob,\n target: Size | null,\n settings: RenderSettings,\n environment: CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const url = environment.createObjectURL(blob);\n try {\n return await withDeadline(\n async () => {\n const image = await environment.loadImage(url);\n const size = target ?? { width: image.width, height: image.height };\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return environment.encodePng(image, { ...size, background: settings.background });\n },\n { timeoutMs: settings.timeoutMs, signal, label },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, label);\n } finally {\n environment.revokeObjectURL(url);\n }\n}\n\n/** Width and height from a PNG's IHDR chunk, read from the first 24 bytes only. */\nexport async function readPngSize(blob: Blob): Promise<Size | null> {\n const bytes = new Uint8Array(await blob.slice(0, 24).arrayBuffer());\n if (bytes.length < 24) return null;\n const view = new DataView(bytes.buffer);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/**\n * Guarantees the clipboard-safe result: a real PNG (verified by its bytes),\n * typed `image/png`, within the pixel budget. Other raster formats are re-encoded.\n */\nexport async function ensurePng(\n blob: Blob,\n settings: RenderSettings,\n environment: () => CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const actual = await sniffImageType(blob);\n if (actual === null) {\n throw copyFailure('blob-generation-failed', `${label} did not produce an image.`);\n }\n if (actual !== IMAGE_MIME_TYPE) {\n return drawBlobToPng(blob, null, settings, environment(), signal, label);\n }\n const size = await readPngSize(blob);\n if (size === null) throw copyFailure('blob-generation-failed', `${label} produced a truncated PNG.`);\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return blob.type === IMAGE_MIME_TYPE ? blob : blob.slice(0, blob.size, IMAGE_MIME_TYPE);\n}\n","import { copyFailure } from '../core/errors';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { resolveCaptureEnvironment } from './environment';\nimport { drawBlobToPng } from './render';\nimport { resolveRenderSettings, resolveSize, toPixelSize, type RenderOptions, type Size } from './options';\n\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n/** Refuse absurd markup before handing it to the image decoder. 10 M characters. */\nexport const DEFAULT_MAX_SVG_LENGTH = 10_000_000;\n\nexport interface SvgToPngOptions extends RenderOptions {\n /** Max markup length in characters. Default 10 000 000. */\n readonly maxLength?: number;\n}\n\n// Both patterns are linear-time: untrusted markup must not be able to trigger catastrophic backtracking.\nconst SVG_OPEN = /<svg\\b/i;\nconst LENGTH = /^(\\d+(?:\\.\\d+)?|\\.\\d+)(?:px)?$/i;\n\n/** The first `<svg …>` tag, found with two linear scans. */\nfunction findRootTag(markup: string): string | null {\n const start = markup.search(SVG_OPEN);\n if (start === -1) return null;\n const end = markup.indexOf('>', start);\n return end === -1 ? null : markup.slice(start, end + 1);\n}\n\n// Pre-compiled attribute patterns for the three attributes we ever read.\n// Compiling at module load time and with fixed literal names eliminates any\n// risk of ReDoS from runtime-constructed RegExps.\nconst ATTR_PATTERNS: Readonly<Record<string, RegExp>> = /* @__PURE__ */ Object.freeze({\n width: /\\swidth\\s*=\\s*([\"'])(.*?)\\1/i,\n height: /\\sheight\\s*=\\s*([\"'])(.*?)\\1/i,\n viewBox: /\\sviewBox\\s*=\\s*([\"'])(.*?)\\1/i,\n xmlns: /\\sxmlns\\s*=\\s*([\"'])(.*?)\\1/i,\n});\n\nfunction readAttribute(tag: string, name: keyof typeof ATTR_PATTERNS): string | null {\n const pattern = ATTR_PATTERNS[name];\n /* c8 ignore next -- TypeScript enforces name is a key of ATTR_PATTERNS; guard is for JS callers only */\n if (!pattern) return null;\n const match = pattern.exec(tag);\n return match === null ? null : String(match[2]);\n}\n\nfunction parseLength(value: string | null): number | null {\n if (value === null) return null;\n const match = LENGTH.exec(value.trim());\n const number = match ? Number(match[1]) : NaN;\n return number > 0 ? number : null;\n}\n\n/** Intrinsic size from the root tag: `width`/`height` in px, else the `viewBox`. */\nexport function readSvgSize(markup: string): Size | null {\n const tag = findRootTag(markup);\n if (tag === null) return null;\n const width = parseLength(readAttribute(tag, 'width'));\n const height = parseLength(readAttribute(tag, 'height'));\n if (width !== null && height !== null) return { width, height };\n\n const raw = readAttribute(tag, 'viewBox');\n const viewBox = raw != null ? raw.trim().split(/[\\s,]+/).map(Number) : [];\n const [, , boxWidth = NaN, boxHeight = NaN] = viewBox;\n if (viewBox.length !== 4 || !(boxWidth > 0) || !(boxHeight > 0)) return null;\n if (width !== null) return { width, height: (width * boxHeight) / boxWidth };\n if (height !== null) return { width: (height * boxWidth) / boxHeight, height };\n return { width: boxWidth, height: boxHeight };\n}\n\n/** Adds the SVG namespace when missing; `<img>` refuses to decode SVG without it. */\nexport function ensureSvgNamespace(markup: string): string {\n const tag = findRootTag(markup);\n if (tag === null) throw copyFailure('invalid-payload', 'The markup has no <svg> root element.');\n if (readAttribute(tag, 'xmlns') !== null) return markup;\n return markup.replace(SVG_OPEN, `<svg xmlns=\"${SVG_NAMESPACE}\"`);\n}\n\nconst isSvgElement = (value: Element): boolean => value.localName === 'svg';\n\n/**\n * Rasterises SVG (an `<svg>` element or markup) to a PNG Blob, ready for\n * `copy({ kind: 'image', blob })`.\n *\n * Security: the SVG is decoded as an *image*, where browsers disable scripts,\n * event handlers and external resource loading, and it is never inserted into\n * the document. Size is capped in characters and pixels.\n */\nexport async function svgToPngBlob(source: Element | string, options: SvgToPngOptions = {}): Promise<Blob> {\n const environment = resolveCaptureEnvironment(options.environment);\n const settings = resolveRenderSettings(options);\n const maxLength = options.maxLength ?? DEFAULT_MAX_SVG_LENGTH;\n\n let intrinsic: Size | null = null;\n let markup: string;\n if (typeof source === 'string') {\n markup = source;\n } else {\n if (!isSvgElement(source)) throw copyFailure('invalid-payload', `Expected an <svg> element, got <${source.localName}>.`);\n const rect = source.getBoundingClientRect();\n if (rect.width > 0 && rect.height > 0) intrinsic = { width: rect.width, height: rect.height };\n markup = environment.serializeSvg(source);\n }\n\n if (markup.length > maxLength) {\n throw copyFailure('too-large', `The SVG markup exceeds ${String(maxLength)} characters.`);\n }\n const prepared = ensureSvgNamespace(markup);\n const size = resolveSize(intrinsic ?? readSvgSize(prepared), options.width, options.height);\n const target = toPixelSize(size, settings);\n\n const blob = new Blob([prepared], { type: SVG_MIME_TYPE });\n return drawBlobToPng(blob, target, settings, environment, options.signal, 'SVG rasterisation');\n}\n","import { copyFailure } from '../core/errors';\nimport type { OperationContext } from '../core/machine-shared';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { isBlob, type ImagePayload } from '../core/payload';\nimport { withDeadline } from './deadline';\nimport { resolveCaptureEnvironment, type CaptureEnvironment } from './environment';\nimport {\n resolveRenderSettings,\n resolveSize,\n toPixelSize,\n type RenderOptions,\n type RenderSettings,\n type Size,\n} from './options';\nimport { classifyCaptureError, ensurePng } from './render';\nimport { svgToPngBlob } from './svg';\n\n/** Anything with `canvas.toBlob()`: `HTMLCanvasElement`, or a compatible object. */\nexport interface CanvasLike {\n toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void;\n}\n\n/**\n * What a rasteriser may return: a Blob (any raster format), a canvas, or a\n * base64 `data:image/…` URL. Network URLs are refused (never fetched).\n */\nexport type RasterizeOutput = Blob | CanvasLike | string;\n\nexport interface RasterizeContext {\n /** Pixel density to render at. */\n readonly scale: number;\n /** CSS size of the element (or the requested size). */\n readonly width: number;\n readonly height: number;\n readonly backgroundColor: string | null;\n /** Fires on timeout or caller abort: stop work early if you can. */\n readonly signal: AbortSignal;\n}\n\n/**\n * Turns a DOM node into pixels. Bring your own engine, e.g.\n * `(node, { scale }) => domToBlob(node, { scale })` from `modern-screenshot`.\n */\nexport type Rasterizer = (node: Element, context: RasterizeContext) => PromiseLike<RasterizeOutput> | RasterizeOutput;\n\nexport interface CaptureElementOptions extends RenderOptions {\n /** Required for HTML elements. `<svg>` elements are rasterised natively when omitted. */\n readonly rasterize?: Rasterizer;\n}\n\nconst LABEL = 'Element capture';\nconst DATA_URL = /^data:(image\\/[a-z0-9.+-]+)((?:;[a-z0-9-]+=[a-z0-9.+-]+)*)(;base64)?,/i;\n\nfunction decodeBase64(payload: string, type: string): Blob {\n let binary: string;\n try {\n binary = atob(payload);\n } catch (cause) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned malformed base64.', cause);\n }\n const bytes = new Uint8Array(binary.length);\n for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);\n return new Blob([bytes], { type });\n}\n\nfunction canvasToBlob(canvas: CanvasLike): Promise<Blob> {\n return new Promise((resolve, reject) => {\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing.'));\n }, 'image/png');\n });\n}\n\nconst isCanvasLike = (value: unknown): value is CanvasLike =>\n typeof value === 'object' && value !== null && typeof (value as { toBlob?: unknown }).toBlob === 'function';\n\nasync function toPng(\n output: unknown,\n options: CaptureElementOptions,\n settings: RenderSettings,\n size: Size,\n signal: AbortSignal,\n): Promise<Blob> {\n const environment = (): CaptureEnvironment => resolveCaptureEnvironment(options.environment);\n\n if (isBlob(output)) return ensurePng(output, settings, environment, signal, LABEL);\n if (isCanvasLike(output)) return ensurePng(await canvasToBlob(output), settings, environment, signal, LABEL);\n if (typeof output !== 'string') {\n throw copyFailure('blob-generation-failed', 'The rasteriser must return a Blob, a canvas or a data:image URL.');\n }\n\n const match = DATA_URL.exec(output);\n if (match === null) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned a string that is not a data:image URL.');\n }\n const type = String(match[1]).toLowerCase();\n const base64 = match[3] !== undefined;\n const body = output.slice(match[0].length);\n\n if (type === SVG_MIME_TYPE) {\n // e.g. modern-screenshot's domToSvg: rasterise it natively at the element's size.\n const markup = base64 ? await decodeBase64(body, type).text() : decodeURIComponent(body);\n return svgToPngBlob(markup, {\n ...settings,\n width: size.width,\n height: size.height,\n signal,\n environment: environment(),\n });\n }\n if (!base64) throw copyFailure('blob-generation-failed', 'Raster data URLs must be base64-encoded.');\n return ensurePng(decodeBase64(body, type), settings, environment, signal, LABEL);\n}\n\n/**\n * Captures an element as a PNG Blob, ready for `copy({ kind: 'image', blob })`.\n * Output is verified to be a real PNG within `maxPixels`, or a classified\n * `CopyFailure` is thrown (`invalid-payload`, `unsupported`, `too-large`,\n * `timeout`, `aborted`, `blob-generation-failed`).\n */\nexport async function captureElement(node: Element | null | undefined, options: CaptureElementOptions = {}): Promise<Blob> {\n if (!node) throw copyFailure('invalid-payload', 'There is no element to capture (is the ref attached yet?).');\n\n const { rasterize } = options;\n if (!rasterize) {\n if (node.localName === 'svg') return svgToPngBlob(node, options);\n throw copyFailure(\n 'unsupported',\n 'Capturing HTML needs a `rasterize` function, e.g. `domToBlob` from modern-screenshot. Only <svg> works without one.',\n );\n }\n\n const settings = resolveRenderSettings(options);\n const rect = node.getBoundingClientRect();\n const intrinsic = rect.width > 0 && rect.height > 0 ? { width: rect.width, height: rect.height } : null;\n const size = resolveSize(intrinsic, options.width, options.height);\n toPixelSize(size, settings); // Refuse before rendering anything.\n\n try {\n return await withDeadline(\n async (signal) => {\n const output = await rasterize(node, {\n scale: settings.scale,\n width: size.width,\n height: size.height,\n backgroundColor: settings.background,\n signal,\n });\n return toPng(output, options, settings, size, signal);\n },\n { timeoutMs: settings.timeoutMs, signal: options.signal, label: LABEL },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, LABEL);\n }\n}\n\n/**\n * A lazy `BlobSource` for `copy()`. Resolving the element at click time and\n * starting inside the gesture keeps Safari happy. Rasterising stops when the\n * copy is reset or its component unmounts, or when `options.signal` aborts.\n *\n * @example copy({ kind: 'image', blob: captureSource(() => cardRef.current, { rasterize }) })\n */\nexport function captureSource(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): (context?: OperationContext) => Promise<Blob> {\n return (context) => {\n const a = options.signal;\n const b = context?.signal;\n if (!a || !b) {\n const signal = a ?? b;\n return captureElement(getNode(), signal ? { ...options, signal } : options);\n }\n const any = (AbortSignal as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n if (typeof any === 'function') return captureElement(getNode(), { ...options, signal: any([a, b]) });\n\n // Older browsers: forward both, and detach once settled so a long-lived\n // caller signal doesn't accumulate a listener per copy.\n const controller = new AbortController();\n const onAbortA = (): void => {\n controller.abort(a.reason);\n };\n const onAbortB = (): void => {\n controller.abort(b.reason);\n };\n if (a.aborted) onAbortA();\n else if (b.aborted) onAbortB();\n a.addEventListener('abort', onAbortA);\n b.addEventListener('abort', onAbortB);\n return captureElement(getNode(), { ...options, signal: controller.signal }).finally(() => {\n a.removeEventListener('abort', onAbortA);\n b.removeEventListener('abort', onAbortB);\n });\n };\n}\n\n/** Shorthand for `{ kind: 'image', blob: captureSource(getNode, options) }`. */\nexport function captureImage(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): ImagePayload {\n return { kind: 'image', blob: captureSource(getNode, options) };\n}\n"],"mappings":";;;;;;;AAgCA,SAAS,UAAU,KAAoC;CACrD,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,QAAQ,IAAI,MAAM;EACxB,MAAM,WAAW;EACjB,MAAM,eAAe;GACnB,QAAQ;IAAE,QAAQ;IAAO,OAAO,MAAM;IAAc,QAAQ,MAAM;GAAc,CAAC;EACnF;EACA,MAAM,gBAAgB;GACpB,OAAOA,eAAAA,YAAY,0BAA0B,iCAAiC,CAAC;EACjF;EACA,MAAM,MAAM;CACd,CAAC;AACH;AAEA,SAAS,UAAU,OAAqB,QAAkC;CACxE,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,MAAM,SAAS,SAAS,cAAc,QAAQ;EAC9C,OAAO,QAAQ,OAAO;EACtB,OAAO,SAAS,OAAO;EACvB,MAAM,UAAU,OAAO,WAAW,IAAI;EACtC,IAAI,CAAC,SAAS;GACZ,OAAOA,eAAAA,YAAY,eAAe,uCAAuC,CAAC;GAC1E;EACF;EACA,IAAI,OAAO,eAAe,MAAM;GAC9B,QAAQ,YAAY,OAAO;GAC3B,QAAQ,SAAS,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM;EACpD;EACA,QAAQ,UAAU,MAAM,QAA6B,GAAG,GAAG,OAAO,OAAO,OAAO,MAAM;EAEtF,OAAO,QAAQ,SAAS;GACtB,IAAI,MAAM,QAAQ,IAAI;QACjB,OAAOA,eAAAA,YAAY,0BAA0B,uDAAuD,CAAC;EAC5G,GAAG,WAAW;CAChB,CAAC;AACH;;AAGA,SAAgB,+BAA0D;CACxE,IACE,OAAO,aAAa,eACpB,OAAO,UAAU,cACjB,OAAO,kBAAkB,cACzB,OAAO,IAAI,oBAAoB,YAE/B,OAAO;CAET,OAAO;EACL,kBAAkB,SAAS,IAAI,gBAAgB,IAAI;EACnD,kBAAkB,QAAQ;GACxB,IAAI,gBAAgB,GAAG;EACzB;EACA,eAAe,SAAS,IAAI,cAAc,CAAC,CAAC,kBAAkB,IAAI;EAClE;EACA;CACF;AACF;AAEA,SAAgB,0BAA0B,aAAiE;CACzG,MAAM,WAAW,eAAe,6BAA6B;CAC7D,IAAI,CAAC,UACH,MAAMA,eAAAA,YAAY,eAAe,sEAAsE;CAEzG,OAAO;AACT;;;AC7FA,MAAa,wBAAwB;AACrC,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;AAClC,MAAa,6BAA6B;AAiC1C,MAAM,WAAW,YAAoBC,eAAAA,YAAY,mBAAmB,OAAO;AAE3E,MAAM,oBAAoB,UAA2B,OAAO,SAAS,KAAK,KAAK,QAAQ;AAEvF,SAAgB,sBAAsB,SAAwC;CAC5E,MAAM,QAAQ,QAAQ,SAAA;CACtB,IAAI,CAAC,iBAAiB,KAAK,KAAK,QAAA,IAC9B,MAAM,QAAQ,gCAAgC,OAAA,EAAwB,EAAE,aAAa,OAAO,KAAK,EAAE,GAAG;CAExG,MAAM,YAAY,QAAQ,aAAA;CAC1B,IAAI,CAAC,OAAO,UAAU,SAAS,KAAK,aAAa,GAC/C,MAAM,QAAQ,sDAAsD,OAAO,SAAS,EAAE,GAAG;CAE3F,MAAM,YAAY,QAAQ,aAAA;CAC1B,IAAI,cAAc,YAAY,CAAC,iBAAiB,SAAS,GACvD,MAAM,QAAQ,mDAAmD,OAAO,SAAS,EAAE,GAAG;CAExF,OAAO;EAAE;EAAO,YAAY,QAAQ,cAAc;EAAM;EAAW;CAAU;AAC/E;;AAGA,SAAgB,YAAY,WAAwB,OAA2B,QAAkC;CAC/G,KAAK,MAAM,CAAC,MAAM,UAAU,CAC1B,CAAC,SAAS,KAAK,GACf,CAAC,UAAU,MAAM,CACnB,GACE,IAAI,UAAU,KAAA,KAAa,CAAC,iBAAiB,KAAK,GAChD,MAAM,QAAQ,KAAK,KAAK,yCAAyC,OAAO,KAAK,EAAE,GAAG;CAGtF,IAAI,UAAU,KAAA,KAAa,WAAW,KAAA,GAAW,OAAO;EAAE;EAAO;CAAO;CACxE,IAAI,cAAc,MAChB,MAAM,QAAQ,sFAAsF;CAEtG,IAAI,UAAU,KAAA,GAAW,OAAO;EAAE;EAAO,QAAS,QAAQ,UAAU,SAAU,UAAU;CAAM;CAC9F,IAAI,WAAW,KAAA,GAAW,OAAO;EAAE,OAAQ,SAAS,UAAU,QAAS,UAAU;EAAQ;CAAO;CAChG,OAAO;AACT;;AAGA,SAAgB,YAAY,MAAY,UAA6D;CACnG,MAAM,QAAQ,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,QAAQ,SAAS,KAAK,CAAC;CACjE,MAAM,SAAS,KAAK,IAAI,GAAG,KAAK,MAAM,KAAK,SAAS,SAAS,KAAK,CAAC;CACnE,kBAAkB,OAAO,QAAQ,SAAS,SAAS;CACnD,OAAO;EAAE;EAAO;CAAO;AACzB;AAEA,SAAgB,kBAAkB,OAAe,QAAgB,WAAyB;CACxF,IAAI,QAAQ,SAAS,WACnB,MAAMA,eAAAA,YACJ,aACA,KAAK,OAAO,KAAK,EAAE,GAAG,OAAO,MAAM,EAAE,qBAAqB,OAAO,SAAS,EAAE,sDAC9E;AAEJ;;;;ACtFA,SAAgB,qBAAqB,OAAgB,OAAwB;CAC3E,OAAOC,eAAAA,cAAc,KAAK,IAAI,QAAQC,eAAAA,YAAY,0BAA0B,GAAG,MAAM,WAAW,KAAK;AACvG;;;;;AAMA,eAAsB,cACpB,MACA,QACA,UACA,aACA,QACA,OACe;CACf,MAAM,MAAM,YAAY,gBAAgB,IAAI;CAC5C,IAAI;EACF,OAAO,MAAMC,iBAAAA,aACX,YAAY;GACV,MAAM,QAAQ,MAAM,YAAY,UAAU,GAAG;GAC7C,MAAM,OAAO,UAAU;IAAE,OAAO,MAAM;IAAO,QAAQ,MAAM;GAAO;GAClE,kBAAkB,KAAK,OAAO,KAAK,QAAQ,SAAS,SAAS;GAC7D,OAAO,YAAY,UAAU,OAAO;IAAE,GAAG;IAAM,YAAY,SAAS;GAAW,CAAC;EAClF,GACA;GAAE,WAAW,SAAS;GAAW;GAAQ;EAAM,CACjD;CACF,SAAS,OAAO;EACd,MAAM,qBAAqB,OAAO,KAAK;CACzC,UAAU;EACR,YAAY,gBAAgB,GAAG;CACjC;AACF;;AAGA,eAAsB,YAAY,MAAkC;CAClE,MAAM,QAAQ,IAAI,WAAW,MAAM,KAAK,MAAM,GAAG,EAAE,CAAC,CAAC,YAAY,CAAC;CAClE,IAAI,MAAM,SAAS,IAAI,OAAO;CAC9B,MAAM,OAAO,IAAI,SAAS,MAAM,MAAM;CACtC,OAAO;EAAE,OAAO,KAAK,UAAU,EAAE;EAAG,QAAQ,KAAK,UAAU,EAAE;CAAE;AACjE;;;;;AAMA,eAAsB,UACpB,MACA,UACA,aACA,QACA,OACe;CACf,MAAM,SAAS,MAAMC,aAAAA,eAAe,IAAI;CACxC,IAAI,WAAW,MACb,MAAMF,eAAAA,YAAY,0BAA0B,GAAG,MAAM,2BAA2B;CAElF,IAAI,WAAA,aACF,OAAO,cAAc,MAAM,MAAM,UAAU,YAAY,GAAG,QAAQ,KAAK;CAEzE,MAAM,OAAO,MAAM,YAAY,IAAI;CACnC,IAAI,SAAS,MAAM,MAAMA,eAAAA,YAAY,0BAA0B,GAAG,MAAM,2BAA2B;CACnG,kBAAkB,KAAK,OAAO,KAAK,QAAQ,SAAS,SAAS;CAC7D,OAAO,KAAK,SAAA,cAA2B,OAAO,KAAK,MAAM,GAAG,KAAK,MAAMG,gBAAAA,eAAe;AACxF;;;AClEA,MAAa,gBAAgB;;AAE7B,MAAa,yBAAyB;AAQtC,MAAM,WAAW;AACjB,MAAM,SAAS;;AAGf,SAAS,YAAY,QAA+B;CAClD,MAAM,QAAQ,OAAO,OAAO,QAAQ;CACpC,IAAI,UAAU,IAAI,OAAO;CACzB,MAAM,MAAM,OAAO,QAAQ,KAAK,KAAK;CACrC,OAAO,QAAQ,KAAK,OAAO,OAAO,MAAM,OAAO,MAAM,CAAC;AACxD;AAKA,MAAM,gBAAkE,uBAAO,OAAO;CACpF,OAAO;CACP,QAAQ;CACR,SAAS;CACT,OAAO;AACT,CAAC;AAED,SAAS,cAAc,KAAa,MAAiD;CACnF,MAAM,UAAU,cAAc;;CAE9B,IAAI,CAAC,SAAS,OAAO;CACrB,MAAM,QAAQ,QAAQ,KAAK,GAAG;CAC9B,OAAO,UAAU,OAAO,OAAO,OAAO,MAAM,EAAE;AAChD;AAEA,SAAS,YAAY,OAAqC;CACxD,IAAI,UAAU,MAAM,OAAO;CAC3B,MAAM,QAAQ,OAAO,KAAK,MAAM,KAAK,CAAC;CACtC,MAAM,SAAS,QAAQ,OAAO,MAAM,EAAE,IAAI;CAC1C,OAAO,SAAS,IAAI,SAAS;AAC/B;;AAGA,SAAgB,YAAY,QAA6B;CACvD,MAAM,MAAM,YAAY,MAAM;CAC9B,IAAI,QAAQ,MAAM,OAAO;CACzB,MAAM,QAAQ,YAAY,cAAc,KAAK,OAAO,CAAC;CACrD,MAAM,SAAS,YAAY,cAAc,KAAK,QAAQ,CAAC;CACvD,IAAI,UAAU,QAAQ,WAAW,MAAM,OAAO;EAAE;EAAO;CAAO;CAE9D,MAAM,MAAM,cAAc,KAAK,SAAS;CACxC,MAAM,UAAU,OAAO,OAAO,IAAI,KAAK,CAAC,CAAC,MAAM,QAAQ,CAAC,CAAC,IAAI,MAAM,IAAI,CAAC;CACxE,MAAM,KAAK,WAAW,KAAK,YAAY,OAAO;CAC9C,IAAI,QAAQ,WAAW,KAAK,EAAE,WAAW,MAAM,EAAE,YAAY,IAAI,OAAO;CACxE,IAAI,UAAU,MAAM,OAAO;EAAE;EAAO,QAAS,QAAQ,YAAa;CAAS;CAC3E,IAAI,WAAW,MAAM,OAAO;EAAE,OAAQ,SAAS,WAAY;EAAW;CAAO;CAC7E,OAAO;EAAE,OAAO;EAAU,QAAQ;CAAU;AAC9C;;AAGA,SAAgB,mBAAmB,QAAwB;CACzD,MAAM,MAAM,YAAY,MAAM;CAC9B,IAAI,QAAQ,MAAM,MAAMC,eAAAA,YAAY,mBAAmB,uCAAuC;CAC9F,IAAI,cAAc,KAAK,OAAO,MAAM,MAAM,OAAO;CACjD,OAAO,OAAO,QAAQ,UAAU,eAAe,cAAc,EAAE;AACjE;AAEA,MAAM,gBAAgB,UAA4B,MAAM,cAAc;;;;;;;;;AAUtE,eAAsB,aAAa,QAA0B,UAA2B,CAAC,GAAkB;CACzG,MAAM,cAAc,0BAA0B,QAAQ,WAAW;CACjE,MAAM,WAAW,sBAAsB,OAAO;CAC9C,MAAM,YAAY,QAAQ,aAAA;CAE1B,IAAI,YAAyB;CAC7B,IAAI;CACJ,IAAI,OAAO,WAAW,UACpB,SAAS;MACJ;EACL,IAAI,CAAC,aAAa,MAAM,GAAG,MAAMA,eAAAA,YAAY,mBAAmB,mCAAmC,OAAO,UAAU,GAAG;EACvH,MAAM,OAAO,OAAO,sBAAsB;EAC1C,IAAI,KAAK,QAAQ,KAAK,KAAK,SAAS,GAAG,YAAY;GAAE,OAAO,KAAK;GAAO,QAAQ,KAAK;EAAO;EAC5F,SAAS,YAAY,aAAa,MAAM;CAC1C;CAEA,IAAI,OAAO,SAAS,WAClB,MAAMA,eAAAA,YAAY,aAAa,0BAA0B,OAAO,SAAS,EAAE,aAAa;CAE1F,MAAM,WAAW,mBAAmB,MAAM;CAE1C,MAAM,SAAS,YADF,YAAY,aAAa,YAAY,QAAQ,GAAG,QAAQ,OAAO,QAAQ,MACzD,GAAM,QAAQ;CAGzC,OAAO,cAAc,IADJ,KAAK,CAAC,QAAQ,GAAG,EAAE,MAAMC,aAAAA,cAAc,CACnC,GAAM,QAAQ,UAAU,aAAa,QAAQ,QAAQ,mBAAmB;AAC/F;;;AC9DA,MAAM,QAAQ;AACd,MAAM,WAAW;AAEjB,SAAS,aAAa,SAAiB,MAAoB;CACzD,IAAI;CACJ,IAAI;EACF,SAAS,KAAK,OAAO;CACvB,SAAS,OAAO;EACd,MAAMC,eAAAA,YAAY,0BAA0B,6CAA6C,KAAK;CAChG;CACA,MAAM,QAAQ,IAAI,WAAW,OAAO,MAAM;CAC1C,KAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS,MAAM,SAAS,OAAO,WAAW,KAAK;CAC1F,OAAO,IAAI,KAAK,CAAC,KAAK,GAAG,EAAE,KAAK,CAAC;AACnC;AAEA,SAAS,aAAa,QAAmC;CACvD,OAAO,IAAI,SAAS,SAAS,WAAW;EACtC,OAAO,QAAQ,SAAS;GACtB,IAAI,MAAM,QAAQ,IAAI;QACjB,OAAOA,eAAAA,YAAY,0BAA0B,mCAAmC,CAAC;EACxF,GAAG,WAAW;CAChB,CAAC;AACH;AAEA,MAAM,gBAAgB,UACpB,OAAO,UAAU,YAAY,UAAU,QAAQ,OAAQ,MAA+B,WAAW;AAEnG,eAAe,MACb,QACA,SACA,UACA,MACA,QACe;CACf,MAAM,oBAAwC,0BAA0B,QAAQ,WAAW;CAE3F,IAAIC,gBAAAA,OAAO,MAAM,GAAG,OAAO,UAAU,QAAQ,UAAU,aAAa,QAAQ,KAAK;CACjF,IAAI,aAAa,MAAM,GAAG,OAAO,UAAU,MAAM,aAAa,MAAM,GAAG,UAAU,aAAa,QAAQ,KAAK;CAC3G,IAAI,OAAO,WAAW,UACpB,MAAMD,eAAAA,YAAY,0BAA0B,kEAAkE;CAGhH,MAAM,QAAQ,SAAS,KAAK,MAAM;CAClC,IAAI,UAAU,MACZ,MAAMA,eAAAA,YAAY,0BAA0B,gEAAgE;CAE9G,MAAM,OAAO,OAAO,MAAM,EAAE,CAAC,CAAC,YAAY;CAC1C,MAAM,SAAS,MAAM,OAAO,KAAA;CAC5B,MAAM,OAAO,OAAO,MAAM,MAAM,EAAE,CAAC,MAAM;CAEzC,IAAI,SAAA,iBAGF,OAAO,aADQ,SAAS,MAAM,aAAa,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,mBAAmB,IAAI,GAC3D;EAC1B,GAAG;EACH,OAAO,KAAK;EACZ,QAAQ,KAAK;EACb;EACA,aAAa,YAAY;CAC3B,CAAC;CAEH,IAAI,CAAC,QAAQ,MAAMA,eAAAA,YAAY,0BAA0B,0CAA0C;CACnG,OAAO,UAAU,aAAa,MAAM,IAAI,GAAG,UAAU,aAAa,QAAQ,KAAK;AACjF;;;;;;;AAQA,eAAsB,eAAe,MAAkC,UAAiC,CAAC,GAAkB;CACzH,IAAI,CAAC,MAAM,MAAMA,eAAAA,YAAY,mBAAmB,4DAA4D;CAE5G,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW;EACd,IAAI,KAAK,cAAc,OAAO,OAAO,aAAa,MAAM,OAAO;EAC/D,MAAMA,eAAAA,YACJ,eACA,qHACF;CACF;CAEA,MAAM,WAAW,sBAAsB,OAAO;CAC9C,MAAM,OAAO,KAAK,sBAAsB;CAExC,MAAM,OAAO,YADK,KAAK,QAAQ,KAAK,KAAK,SAAS,IAAI;EAAE,OAAO,KAAK;EAAO,QAAQ,KAAK;CAAO,IAAI,MAC/D,QAAQ,OAAO,QAAQ,MAAM;CACjE,YAAY,MAAM,QAAQ;CAE1B,IAAI;EACF,OAAO,MAAME,iBAAAA,aACX,OAAO,WAAW;GAQhB,OAAO,MAAM,MAPQ,UAAU,MAAM;IACnC,OAAO,SAAS;IAChB,OAAO,KAAK;IACZ,QAAQ,KAAK;IACb,iBAAiB,SAAS;IAC1B;GACF,CAAC,GACoB,SAAS,UAAU,MAAM,MAAM;EACtD,GACA;GAAE,WAAW,SAAS;GAAW,QAAQ,QAAQ;GAAQ,OAAO;EAAM,CACxE;CACF,SAAS,OAAO;EACd,MAAM,qBAAqB,OAAO,KAAK;CACzC;AACF;;;;;;;;AASA,SAAgB,cACd,SACA,UAAiC,CAAC,GACa;CAC/C,QAAQ,YAAY;EAClB,MAAM,IAAI,QAAQ;EAClB,MAAM,IAAI,SAAS;EACnB,IAAI,CAAC,KAAK,CAAC,GAAG;GACZ,MAAM,SAAS,KAAK;GACpB,OAAO,eAAe,QAAQ,GAAG,SAAS;IAAE,GAAG;IAAS;GAAO,IAAI,OAAO;EAC5E;EACA,MAAM,MAAO,YAAkE;EAC/E,IAAI,OAAO,QAAQ,YAAY,OAAO,eAAe,QAAQ,GAAG;GAAE,GAAG;GAAS,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC;EAAE,CAAC;EAInG,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,iBAAuB;GAC3B,WAAW,MAAM,EAAE,MAAM;EAC3B;EACA,MAAM,iBAAuB;GAC3B,WAAW,MAAM,EAAE,MAAM;EAC3B;EACA,IAAI,EAAE,SAAS,SAAS;OACnB,IAAI,EAAE,SAAS,SAAS;EAC7B,EAAE,iBAAiB,SAAS,QAAQ;EACpC,EAAE,iBAAiB,SAAS,QAAQ;EACpC,OAAO,eAAe,QAAQ,GAAG;GAAE,GAAG;GAAS,QAAQ,WAAW;EAAO,CAAC,CAAC,CAAC,cAAc;GACxF,EAAE,oBAAoB,SAAS,QAAQ;GACvC,EAAE,oBAAoB,SAAS,QAAQ;EACzC,CAAC;CACH;AACF;;AAGA,SAAgB,aACd,SACA,UAAiC,CAAC,GACpB;CACd,OAAO;EAAE,MAAM;EAAS,MAAM,cAAc,SAAS,OAAO;CAAE;AAChE"}
|
|
1
|
+
{"version":3,"file":"capture.cjs","names":["copyFailure","copyFailure","isCopyFailure","blobFailure","withDeadline","sniffImageType","copyFailure","IMAGE_MIME_TYPE","copyFailure","SVG_MIME_TYPE","copyFailure","isBlob","withDeadline"],"sources":["../src/capture/environment.ts","../src/capture/options.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** A decoded image, ready to be drawn. `source` is platform-specific (an `HTMLImageElement` in browsers). */\nexport interface DecodedImage {\n readonly source: unknown;\n readonly width: number;\n readonly height: number;\n}\n\nexport interface PngTarget {\n /** Integer pixel size of the output. */\n readonly width: number;\n readonly height: number;\n /** CSS colour painted under the image, or `null` for transparency. */\n readonly background: string | null;\n}\n\n/**\n * Everything capture needs from the platform. The default uses the DOM;\n * inject your own for workers (OffscreenCanvas), native shells or tests.\n */\nexport interface CaptureEnvironment {\n readonly createObjectURL: (blob: Blob) => string;\n readonly revokeObjectURL: (url: string) => void;\n /** Serialises an `<svg>` element to markup. */\n readonly serializeSvg: (node: Element) => string;\n /** Decodes an image from a `blob:` or `data:` URL. */\n readonly loadImage: (url: string) => Promise<DecodedImage>;\n /** Draws the image scaled to `target` and encodes it as PNG. */\n readonly encodePng: (image: DecodedImage, target: PngTarget) => Promise<Blob>;\n}\n\nfunction loadImage(url: string): Promise<DecodedImage> {\n return new Promise((resolve, reject) => {\n const image = new Image();\n image.decoding = 'async';\n image.onload = () => {\n resolve({ source: image, width: image.naturalWidth, height: image.naturalHeight });\n };\n image.onerror = () => {\n reject(copyFailure('blob-generation-failed', 'The image could not be decoded.'));\n };\n image.src = url;\n });\n}\n\nfunction encodePng(image: DecodedImage, target: PngTarget): Promise<Blob> {\n return new Promise((resolve, reject) => {\n const canvas = document.createElement('canvas');\n canvas.width = target.width;\n canvas.height = target.height;\n const context = canvas.getContext('2d');\n if (!context) {\n reject(copyFailure('unsupported', 'Canvas 2D rendering is not available.'));\n return;\n }\n if (target.background !== null) {\n context.fillStyle = target.background;\n context.fillRect(0, 0, target.width, target.height);\n }\n context.drawImage(image.source as CanvasImageSource, 0, 0, target.width, target.height);\n // Throws SecurityError synchronously for tainted canvases; the executor turns that into a rejection.\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing (canvas too large?).'));\n }, 'image/png');\n });\n}\n\n/** The DOM-backed environment, or `null` outside a browser. */\nexport function getDefaultCaptureEnvironment(): CaptureEnvironment | null {\n if (\n typeof document === 'undefined' ||\n typeof Image !== 'function' ||\n typeof XMLSerializer !== 'function' ||\n typeof URL.createObjectURL !== 'function'\n ) {\n return null;\n }\n return {\n createObjectURL: (blob) => URL.createObjectURL(blob),\n revokeObjectURL: (url) => {\n URL.revokeObjectURL(url);\n },\n serializeSvg: (node) => new XMLSerializer().serializeToString(node),\n loadImage,\n encodePng,\n };\n}\n\nexport function resolveCaptureEnvironment(environment: CaptureEnvironment | undefined): CaptureEnvironment {\n const resolved = environment ?? getDefaultCaptureEnvironment();\n if (!resolved) {\n throw copyFailure('unsupported', 'Image capture needs a browser environment (document, Image, canvas).');\n }\n return resolved;\n}\n","import { copyFailure } from '../core/errors';\nimport type { CaptureEnvironment } from './environment';\n\nexport const DEFAULT_CAPTURE_SCALE = 2;\nexport const MAX_CAPTURE_SCALE = 10;\n/** 4096 × 4096: the canvas area limit of Safari/iOS, the strictest mainstream engine. */\nexport const DEFAULT_MAX_PIXELS = 16_777_216;\nexport const DEFAULT_CAPTURE_TIMEOUT_MS = 15_000;\n\nexport interface RenderOptions {\n /** Output width in CSS px (before `scale`). Omit to use the intrinsic size; set one side to keep the aspect ratio. */\n readonly width?: number;\n /** Output height in CSS px (before `scale`). */\n readonly height?: number;\n /** Pixel density multiplier, e.g. `window.devicePixelRatio`. Default 2 (crisp on HiDPI). Max 10. */\n readonly scale?: number;\n /** CSS colour under the image. Default `null` (transparent). */\n readonly background?: string | null;\n /** Refuse outputs larger than this many pixels (memory / DoS guard). Default 16 777 216. */\n readonly maxPixels?: number;\n /** Give up after this long. Default 15 000 ms. `Infinity` disables. */\n readonly timeoutMs?: number;\n /** Cancel the capture. */\n readonly signal?: AbortSignal;\n /** Platform hooks. Defaults to the DOM. */\n readonly environment?: CaptureEnvironment;\n}\n\nexport interface RenderSettings {\n readonly scale: number;\n readonly background: string | null;\n readonly maxPixels: number;\n readonly timeoutMs: number;\n}\n\nexport interface Size {\n readonly width: number;\n readonly height: number;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nconst isPositiveFinite = (value: number): boolean => Number.isFinite(value) && value > 0;\n\nexport function resolveRenderSettings(options: RenderOptions): RenderSettings {\n const scale = options.scale ?? DEFAULT_CAPTURE_SCALE;\n if (!isPositiveFinite(scale) || scale > MAX_CAPTURE_SCALE) {\n throw invalid(`\\`scale\\` must be > 0 and <= ${String(MAX_CAPTURE_SCALE)} (received ${String(scale)}).`);\n }\n const maxPixels = options.maxPixels ?? DEFAULT_MAX_PIXELS;\n if (!Number.isInteger(maxPixels) || maxPixels <= 0) {\n throw invalid(`\\`maxPixels\\` must be a positive integer (received ${String(maxPixels)}).`);\n }\n const timeoutMs = options.timeoutMs ?? DEFAULT_CAPTURE_TIMEOUT_MS;\n if (timeoutMs !== Infinity && !isPositiveFinite(timeoutMs)) {\n throw invalid(`\\`timeoutMs\\` must be > 0 or Infinity (received ${String(timeoutMs)}).`);\n }\n return { scale, background: options.background ?? null, maxPixels, timeoutMs };\n}\n\n/** Combines explicit `width`/`height` with an intrinsic size, keeping the aspect ratio when only one is set. */\nexport function resolveSize(intrinsic: Size | null, width: number | undefined, height: number | undefined): Size {\n for (const [name, value] of [\n ['width', width],\n ['height', height],\n ] as const) {\n if (value !== undefined && !isPositiveFinite(value)) {\n throw invalid(`\\`${name}\\` must be a positive number (received ${String(value)}).`);\n }\n }\n if (width !== undefined && height !== undefined) return { width, height };\n if (intrinsic === null) {\n throw invalid('The size to render is unknown: pass `width` and `height`, or give the source a size.');\n }\n if (width !== undefined) return { width, height: (width * intrinsic.height) / intrinsic.width };\n if (height !== undefined) return { width: (height * intrinsic.width) / intrinsic.height, height };\n return intrinsic;\n}\n\n/** Integer pixel size after scaling. Throws `too-large` past `maxPixels`. */\nexport function toPixelSize(size: Size, settings: Pick<RenderSettings, 'scale' | 'maxPixels'>): Size {\n const width = Math.max(1, Math.round(size.width * settings.scale));\n const height = Math.max(1, Math.round(size.height * settings.scale));\n assertPixelBudget(width, height, settings.maxPixels);\n return { width, height };\n}\n\nexport function assertPixelBudget(width: number, height: number, maxPixels: number): void {\n if (width * height > maxPixels) {\n throw copyFailure(\n 'too-large',\n `A ${String(width)}×${String(height)} image exceeds the ${String(maxPixels)}-pixel limit. Lower \\`scale\\` or raise \\`maxPixels\\`.`,\n );\n }\n}\n","import { blobFailure } from '../core/blob-failure';\nimport { copyFailure, isCopyFailure } from '../core/errors';\nimport { IMAGE_MIME_TYPE } from '../core/payload';\nimport { sniffImageType } from '../core/mime';\nimport { withDeadline } from './deadline';\nimport type { CaptureEnvironment } from './environment';\nimport { assertPixelBudget, type RenderSettings, type Size } from './options';\n\n/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */\nexport function classifyCaptureError(cause: unknown, label: string): unknown {\n return isCopyFailure(cause) ? cause : blobFailure(label, cause);\n}\n\n/**\n * Decodes an image Blob and re-encodes it as PNG at `target` (or its natural\n * size), within the deadline. The object URL is always revoked.\n */\nexport async function drawBlobToPng(\n blob: Blob,\n target: Size | null,\n settings: RenderSettings,\n environment: CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const url = environment.createObjectURL(blob);\n try {\n return await withDeadline(\n async () => {\n const image = await environment.loadImage(url);\n const size = target ?? { width: image.width, height: image.height };\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return environment.encodePng(image, { ...size, background: settings.background });\n },\n { timeoutMs: settings.timeoutMs, signal, label },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, label);\n } finally {\n environment.revokeObjectURL(url);\n }\n}\n\n/** Width and height from a PNG's IHDR chunk, read from the first 24 bytes only. */\nexport async function readPngSize(blob: Blob): Promise<Size | null> {\n const bytes = new Uint8Array(await blob.slice(0, 24).arrayBuffer());\n if (bytes.length < 24) return null;\n const view = new DataView(bytes.buffer);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/**\n * Guarantees the clipboard-safe result: a real PNG (verified by its bytes),\n * typed `image/png`, within the pixel budget. Other raster formats are re-encoded.\n */\nexport async function ensurePng(\n blob: Blob,\n settings: RenderSettings,\n environment: () => CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const actual = await sniffImageType(blob);\n if (actual === null) {\n throw copyFailure('blob-generation-failed', `${label} did not produce an image.`);\n }\n if (actual !== IMAGE_MIME_TYPE) {\n return drawBlobToPng(blob, null, settings, environment(), signal, label);\n }\n const size = await readPngSize(blob);\n if (size === null) throw copyFailure('blob-generation-failed', `${label} produced a truncated PNG.`);\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return blob.type === IMAGE_MIME_TYPE ? blob : blob.slice(0, blob.size, IMAGE_MIME_TYPE);\n}\n","import { copyFailure } from '../core/errors';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { resolveCaptureEnvironment } from './environment';\nimport { drawBlobToPng } from './render';\nimport { resolveRenderSettings, resolveSize, toPixelSize, type RenderOptions, type Size } from './options';\n\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n/** Refuse absurd markup before handing it to the image decoder. 10 M characters. */\nexport const DEFAULT_MAX_SVG_LENGTH = 10_000_000;\n\nexport interface SvgToPngOptions extends RenderOptions {\n /** Max markup length in characters. Default 10 000 000. */\n readonly maxLength?: number;\n}\n\n// Both patterns are linear-time: untrusted markup must not be able to trigger catastrophic backtracking.\nconst SVG_OPEN = /<svg\\b/i;\nconst LENGTH = /^(\\d+(?:\\.\\d+)?|\\.\\d+)(?:px)?$/i;\n\n/** The first `<svg …>` tag, found with two linear scans. */\nfunction findRootTag(markup: string): string | null {\n const start = markup.search(SVG_OPEN);\n if (start === -1) return null;\n const end = markup.indexOf('>', start);\n return end === -1 ? null : markup.slice(start, end + 1);\n}\n\n// Pre-compiled attribute patterns for the three attributes we ever read.\n// Compiling at module load time and with fixed literal names eliminates any\n// risk of ReDoS from runtime-constructed RegExps.\nconst ATTR_PATTERNS: Readonly<Record<string, RegExp>> = /* @__PURE__ */ Object.freeze({\n width: /\\swidth\\s*=\\s*([\"'])(.*?)\\1/i,\n height: /\\sheight\\s*=\\s*([\"'])(.*?)\\1/i,\n viewBox: /\\sviewBox\\s*=\\s*([\"'])(.*?)\\1/i,\n xmlns: /\\sxmlns\\s*=\\s*([\"'])(.*?)\\1/i,\n});\n\nfunction readAttribute(tag: string, name: keyof typeof ATTR_PATTERNS): string | null {\n const pattern = ATTR_PATTERNS[name];\n /* c8 ignore next -- TypeScript enforces name is a key of ATTR_PATTERNS; guard is for JS callers only */\n if (!pattern) return null;\n const match = pattern.exec(tag);\n return match === null ? null : String(match[2]);\n}\n\nfunction parseLength(value: string | null): number | null {\n if (value === null) return null;\n const match = LENGTH.exec(value.trim());\n const number = match ? Number(match[1]) : NaN;\n return number > 0 ? number : null;\n}\n\n/** Intrinsic size from the root tag: `width`/`height` in px, else the `viewBox`. */\nexport function readSvgSize(markup: string): Size | null {\n const tag = findRootTag(markup);\n if (tag === null) return null;\n const width = parseLength(readAttribute(tag, 'width'));\n const height = parseLength(readAttribute(tag, 'height'));\n if (width !== null && height !== null) return { width, height };\n\n const raw = readAttribute(tag, 'viewBox');\n const viewBox = raw != null ? raw.trim().split(/[\\s,]+/).map(Number) : [];\n const [, , boxWidth = NaN, boxHeight = NaN] = viewBox;\n if (viewBox.length !== 4 || !(boxWidth > 0) || !(boxHeight > 0)) return null;\n if (width !== null) return { width, height: (width * boxHeight) / boxWidth };\n if (height !== null) return { width: (height * boxWidth) / boxHeight, height };\n return { width: boxWidth, height: boxHeight };\n}\n\n/** Adds the SVG namespace when missing; `<img>` refuses to decode SVG without it. */\nexport function ensureSvgNamespace(markup: string): string {\n const tag = findRootTag(markup);\n if (tag === null) throw copyFailure('invalid-payload', 'The markup has no <svg> root element.');\n if (readAttribute(tag, 'xmlns') !== null) return markup;\n return markup.replace(SVG_OPEN, `<svg xmlns=\"${SVG_NAMESPACE}\"`);\n}\n\nconst isSvgElement = (value: Element): boolean => value.localName === 'svg';\n\n/**\n * Rasterises SVG (an `<svg>` element or markup) to a PNG Blob, ready for\n * `copy({ kind: 'image', blob })`.\n *\n * Security: the SVG is decoded as an *image*, where browsers disable scripts,\n * event handlers and external resource loading, and it is never inserted into\n * the document. Size is capped in characters and pixels.\n */\nexport async function svgToPngBlob(source: Element | string, options: SvgToPngOptions = {}): Promise<Blob> {\n const environment = resolveCaptureEnvironment(options.environment);\n const settings = resolveRenderSettings(options);\n const maxLength = options.maxLength ?? DEFAULT_MAX_SVG_LENGTH;\n\n let intrinsic: Size | null = null;\n let markup: string;\n if (typeof source === 'string') {\n markup = source;\n } else {\n if (!isSvgElement(source)) throw copyFailure('invalid-payload', `Expected an <svg> element, got <${source.localName}>.`);\n const rect = source.getBoundingClientRect();\n if (rect.width > 0 && rect.height > 0) intrinsic = { width: rect.width, height: rect.height };\n markup = environment.serializeSvg(source);\n }\n\n if (markup.length > maxLength) {\n throw copyFailure('too-large', `The SVG markup exceeds ${String(maxLength)} characters.`);\n }\n const prepared = ensureSvgNamespace(markup);\n const size = resolveSize(intrinsic ?? readSvgSize(prepared), options.width, options.height);\n const target = toPixelSize(size, settings);\n\n const blob = new Blob([prepared], { type: SVG_MIME_TYPE });\n return drawBlobToPng(blob, target, settings, environment, options.signal, 'SVG rasterisation');\n}\n","import { copyFailure } from '../core/errors';\nimport type { OperationContext } from '../core/machine-shared';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { isBlob, type ImagePayload } from '../core/payload';\nimport { withDeadline } from './deadline';\nimport { resolveCaptureEnvironment, type CaptureEnvironment } from './environment';\nimport {\n resolveRenderSettings,\n resolveSize,\n toPixelSize,\n type RenderOptions,\n type RenderSettings,\n type Size,\n} from './options';\nimport { classifyCaptureError, ensurePng } from './render';\nimport { svgToPngBlob } from './svg';\n\n/** Anything with `canvas.toBlob()`: `HTMLCanvasElement`, or a compatible object. */\nexport interface CanvasLike {\n toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void;\n}\n\n/**\n * What a rasteriser may return: a Blob (any raster format), a canvas, or a\n * base64 `data:image/…` URL. Network URLs are refused (never fetched).\n */\nexport type RasterizeOutput = Blob | CanvasLike | string;\n\nexport interface RasterizeContext {\n /** Pixel density to render at. */\n readonly scale: number;\n /** CSS size of the element (or the requested size). */\n readonly width: number;\n readonly height: number;\n readonly backgroundColor: string | null;\n /** Fires on timeout or caller abort: stop work early if you can. */\n readonly signal: AbortSignal;\n}\n\n/**\n * Turns a DOM node into pixels. Bring your own engine, e.g.\n * `(node, { scale }) => domToBlob(node, { scale })` from `modern-screenshot`.\n */\nexport type Rasterizer = (node: Element, context: RasterizeContext) => PromiseLike<RasterizeOutput> | RasterizeOutput;\n\nexport interface CaptureElementOptions extends RenderOptions {\n /** Required for HTML elements. `<svg>` elements are rasterised natively when omitted. */\n readonly rasterize?: Rasterizer;\n}\n\nconst LABEL = 'Element capture';\nconst DATA_URL = /^data:(image\\/[a-z0-9.+-]+)((?:;[a-z0-9-]+=[a-z0-9.+-]+)*)(;base64)?,/i;\n\nfunction decodeBase64(payload: string, type: string): Blob {\n let binary: string;\n try {\n binary = atob(payload);\n } catch (cause) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned malformed base64.', cause);\n }\n const bytes = new Uint8Array(binary.length);\n for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);\n return new Blob([bytes], { type });\n}\n\nfunction canvasToBlob(canvas: CanvasLike): Promise<Blob> {\n return new Promise((resolve, reject) => {\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing.'));\n }, 'image/png');\n });\n}\n\nconst isCanvasLike = (value: unknown): value is CanvasLike =>\n typeof value === 'object' && value !== null && typeof (value as { toBlob?: unknown }).toBlob === 'function';\n\nasync function toPng(\n output: unknown,\n options: CaptureElementOptions,\n settings: RenderSettings,\n size: Size,\n signal: AbortSignal,\n): Promise<Blob> {\n const environment = (): CaptureEnvironment => resolveCaptureEnvironment(options.environment);\n\n if (isBlob(output)) return ensurePng(output, settings, environment, signal, LABEL);\n if (isCanvasLike(output)) return ensurePng(await canvasToBlob(output), settings, environment, signal, LABEL);\n if (typeof output !== 'string') {\n throw copyFailure('blob-generation-failed', 'The rasteriser must return a Blob, a canvas or a data:image URL.');\n }\n\n const match = DATA_URL.exec(output);\n if (match === null) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned a string that is not a data:image URL.');\n }\n const type = String(match[1]).toLowerCase();\n const base64 = match[3] !== undefined;\n const body = output.slice(match[0].length);\n\n if (type === SVG_MIME_TYPE) {\n // e.g. modern-screenshot's domToSvg: rasterise it natively at the element's size.\n const markup = base64 ? await decodeBase64(body, type).text() : decodeURIComponent(body);\n return svgToPngBlob(markup, {\n ...settings,\n width: size.width,\n height: size.height,\n signal,\n environment: environment(),\n });\n }\n if (!base64) throw copyFailure('blob-generation-failed', 'Raster data URLs must be base64-encoded.');\n return ensurePng(decodeBase64(body, type), settings, environment, signal, LABEL);\n}\n\n/**\n * Captures an element as a PNG Blob, ready for `copy({ kind: 'image', blob })`.\n * Output is verified to be a real PNG within `maxPixels`, or a classified\n * `CopyFailure` is thrown (`invalid-payload`, `unsupported`, `too-large`,\n * `timeout`, `aborted`, `blob-generation-failed`).\n */\nexport async function captureElement(node: Element | null | undefined, options: CaptureElementOptions = {}): Promise<Blob> {\n if (!node) throw copyFailure('invalid-payload', 'There is no element to capture (is the ref attached yet?).');\n\n const { rasterize } = options;\n if (!rasterize) {\n if (node.localName === 'svg') return svgToPngBlob(node, options);\n throw copyFailure(\n 'unsupported',\n 'Capturing HTML needs a `rasterize` function, e.g. `domToBlob` from modern-screenshot. Only <svg> works without one.',\n );\n }\n\n const settings = resolveRenderSettings(options);\n const rect = node.getBoundingClientRect();\n const intrinsic = rect.width > 0 && rect.height > 0 ? { width: rect.width, height: rect.height } : null;\n const size = resolveSize(intrinsic, options.width, options.height);\n toPixelSize(size, settings); // Refuse before rendering anything.\n\n try {\n return await withDeadline(\n async (signal) => {\n const output = await rasterize(node, {\n scale: settings.scale,\n width: size.width,\n height: size.height,\n backgroundColor: settings.background,\n signal,\n });\n return toPng(output, options, settings, size, signal);\n },\n { timeoutMs: settings.timeoutMs, signal: options.signal, label: LABEL },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, LABEL);\n }\n}\n\n/**\n * A lazy `BlobSource` for `copy()`. Resolving the element at click time and\n * starting inside the gesture keeps Safari happy. Rasterising stops when the\n * copy is reset or its component unmounts, or when `options.signal` aborts.\n *\n * @example copy({ kind: 'image', blob: captureSource(() => cardRef.current, { rasterize }) })\n */\nexport function captureSource(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): (context?: OperationContext) => Promise<Blob> {\n return (context) => {\n const a = options.signal;\n const b = context?.signal;\n if (!a || !b) {\n const signal = a ?? b;\n return captureElement(getNode(), signal ? { ...options, signal } : options);\n }\n const any = (AbortSignal as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n if (typeof any === 'function') return captureElement(getNode(), { ...options, signal: any([a, b]) });\n\n // Older browsers: forward both, and detach once settled so a long-lived\n // caller signal doesn't accumulate a listener per copy.\n const controller = new AbortController();\n const onAbortA = (): void => {\n controller.abort(a.reason);\n };\n const onAbortB = (): void => {\n controller.abort(b.reason);\n };\n if (a.aborted) onAbortA();\n else if (b.aborted) onAbortB();\n a.addEventListener('abort', onAbortA);\n b.addEventListener('abort', onAbortB);\n return captureElement(getNode(), { ...options, signal: controller.signal }).finally(() => {\n a.removeEventListener('abort', onAbortA);\n b.removeEventListener('abort', onAbortB);\n });\n };\n}\n\n/** Shorthand for `{ kind: 'image', blob: captureSource(getNode, options) }`. */\nexport function captureImage(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): ImagePayload {\n return { kind: 'image', blob: captureSource(getNode, options) };\n}\n"],"mappings":"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"}
|
package/dist/capture.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure, o as isCopyFailure } from "./chunks/errors-
|
|
3
|
-
import { n as isBlob, t as IMAGE_MIME_TYPE } from "./chunks/payload-
|
|
2
|
+
import { n as copyFailure, o as isCopyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
|
+
import { n as isBlob, t as IMAGE_MIME_TYPE } from "./chunks/payload-5uJedhwz.js";
|
|
4
4
|
import { l as sniffImageType, t as SVG_MIME_TYPE } from "./chunks/mime-aa-HA2dm.js";
|
|
5
|
-
import { t as withDeadline } from "./chunks/deadline-
|
|
5
|
+
import { n as blobFailure, t as withDeadline } from "./chunks/deadline-DTAkra5B.js";
|
|
6
6
|
//#region src/capture/environment.ts
|
|
7
7
|
function loadImage(url) {
|
|
8
8
|
return new Promise((resolve, reject) => {
|
|
@@ -118,7 +118,7 @@ function assertPixelBudget(width, height, maxPixels) {
|
|
|
118
118
|
//#region src/capture/render.ts
|
|
119
119
|
/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */
|
|
120
120
|
function classifyCaptureError(cause, label) {
|
|
121
|
-
return isCopyFailure(cause) ? cause :
|
|
121
|
+
return isCopyFailure(cause) ? cause : blobFailure(label, cause);
|
|
122
122
|
}
|
|
123
123
|
/**
|
|
124
124
|
* Decodes an image Blob and re-encodes it as PNG at `target` (or its natural
|
package/dist/capture.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"capture.js","names":[],"sources":["../src/capture/environment.ts","../src/capture/options.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** A decoded image, ready to be drawn. `source` is platform-specific (an `HTMLImageElement` in browsers). */\nexport interface DecodedImage {\n readonly source: unknown;\n readonly width: number;\n readonly height: number;\n}\n\nexport interface PngTarget {\n /** Integer pixel size of the output. */\n readonly width: number;\n readonly height: number;\n /** CSS colour painted under the image, or `null` for transparency. */\n readonly background: string | null;\n}\n\n/**\n * Everything capture needs from the platform. The default uses the DOM;\n * inject your own for workers (OffscreenCanvas), native shells or tests.\n */\nexport interface CaptureEnvironment {\n readonly createObjectURL: (blob: Blob) => string;\n readonly revokeObjectURL: (url: string) => void;\n /** Serialises an `<svg>` element to markup. */\n readonly serializeSvg: (node: Element) => string;\n /** Decodes an image from a `blob:` or `data:` URL. */\n readonly loadImage: (url: string) => Promise<DecodedImage>;\n /** Draws the image scaled to `target` and encodes it as PNG. */\n readonly encodePng: (image: DecodedImage, target: PngTarget) => Promise<Blob>;\n}\n\nfunction loadImage(url: string): Promise<DecodedImage> {\n return new Promise((resolve, reject) => {\n const image = new Image();\n image.decoding = 'async';\n image.onload = () => {\n resolve({ source: image, width: image.naturalWidth, height: image.naturalHeight });\n };\n image.onerror = () => {\n reject(copyFailure('blob-generation-failed', 'The image could not be decoded.'));\n };\n image.src = url;\n });\n}\n\nfunction encodePng(image: DecodedImage, target: PngTarget): Promise<Blob> {\n return new Promise((resolve, reject) => {\n const canvas = document.createElement('canvas');\n canvas.width = target.width;\n canvas.height = target.height;\n const context = canvas.getContext('2d');\n if (!context) {\n reject(copyFailure('unsupported', 'Canvas 2D rendering is not available.'));\n return;\n }\n if (target.background !== null) {\n context.fillStyle = target.background;\n context.fillRect(0, 0, target.width, target.height);\n }\n context.drawImage(image.source as CanvasImageSource, 0, 0, target.width, target.height);\n // Throws SecurityError synchronously for tainted canvases; the executor turns that into a rejection.\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing (canvas too large?).'));\n }, 'image/png');\n });\n}\n\n/** The DOM-backed environment, or `null` outside a browser. */\nexport function getDefaultCaptureEnvironment(): CaptureEnvironment | null {\n if (\n typeof document === 'undefined' ||\n typeof Image !== 'function' ||\n typeof XMLSerializer !== 'function' ||\n typeof URL.createObjectURL !== 'function'\n ) {\n return null;\n }\n return {\n createObjectURL: (blob) => URL.createObjectURL(blob),\n revokeObjectURL: (url) => {\n URL.revokeObjectURL(url);\n },\n serializeSvg: (node) => new XMLSerializer().serializeToString(node),\n loadImage,\n encodePng,\n };\n}\n\nexport function resolveCaptureEnvironment(environment: CaptureEnvironment | undefined): CaptureEnvironment {\n const resolved = environment ?? getDefaultCaptureEnvironment();\n if (!resolved) {\n throw copyFailure('unsupported', 'Image capture needs a browser environment (document, Image, canvas).');\n }\n return resolved;\n}\n","import { copyFailure } from '../core/errors';\nimport type { CaptureEnvironment } from './environment';\n\nexport const DEFAULT_CAPTURE_SCALE = 2;\nexport const MAX_CAPTURE_SCALE = 10;\n/** 4096 × 4096: the canvas area limit of Safari/iOS, the strictest mainstream engine. */\nexport const DEFAULT_MAX_PIXELS = 16_777_216;\nexport const DEFAULT_CAPTURE_TIMEOUT_MS = 15_000;\n\nexport interface RenderOptions {\n /** Output width in CSS px (before `scale`). Omit to use the intrinsic size; set one side to keep the aspect ratio. */\n readonly width?: number;\n /** Output height in CSS px (before `scale`). */\n readonly height?: number;\n /** Pixel density multiplier, e.g. `window.devicePixelRatio`. Default 2 (crisp on HiDPI). Max 10. */\n readonly scale?: number;\n /** CSS colour under the image. Default `null` (transparent). */\n readonly background?: string | null;\n /** Refuse outputs larger than this many pixels (memory / DoS guard). Default 16 777 216. */\n readonly maxPixels?: number;\n /** Give up after this long. Default 15 000 ms. `Infinity` disables. */\n readonly timeoutMs?: number;\n /** Cancel the capture. */\n readonly signal?: AbortSignal;\n /** Platform hooks. Defaults to the DOM. */\n readonly environment?: CaptureEnvironment;\n}\n\nexport interface RenderSettings {\n readonly scale: number;\n readonly background: string | null;\n readonly maxPixels: number;\n readonly timeoutMs: number;\n}\n\nexport interface Size {\n readonly width: number;\n readonly height: number;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nconst isPositiveFinite = (value: number): boolean => Number.isFinite(value) && value > 0;\n\nexport function resolveRenderSettings(options: RenderOptions): RenderSettings {\n const scale = options.scale ?? DEFAULT_CAPTURE_SCALE;\n if (!isPositiveFinite(scale) || scale > MAX_CAPTURE_SCALE) {\n throw invalid(`\\`scale\\` must be > 0 and <= ${String(MAX_CAPTURE_SCALE)} (received ${String(scale)}).`);\n }\n const maxPixels = options.maxPixels ?? DEFAULT_MAX_PIXELS;\n if (!Number.isInteger(maxPixels) || maxPixels <= 0) {\n throw invalid(`\\`maxPixels\\` must be a positive integer (received ${String(maxPixels)}).`);\n }\n const timeoutMs = options.timeoutMs ?? DEFAULT_CAPTURE_TIMEOUT_MS;\n if (timeoutMs !== Infinity && !isPositiveFinite(timeoutMs)) {\n throw invalid(`\\`timeoutMs\\` must be > 0 or Infinity (received ${String(timeoutMs)}).`);\n }\n return { scale, background: options.background ?? null, maxPixels, timeoutMs };\n}\n\n/** Combines explicit `width`/`height` with an intrinsic size, keeping the aspect ratio when only one is set. */\nexport function resolveSize(intrinsic: Size | null, width: number | undefined, height: number | undefined): Size {\n for (const [name, value] of [\n ['width', width],\n ['height', height],\n ] as const) {\n if (value !== undefined && !isPositiveFinite(value)) {\n throw invalid(`\\`${name}\\` must be a positive number (received ${String(value)}).`);\n }\n }\n if (width !== undefined && height !== undefined) return { width, height };\n if (intrinsic === null) {\n throw invalid('The size to render is unknown: pass `width` and `height`, or give the source a size.');\n }\n if (width !== undefined) return { width, height: (width * intrinsic.height) / intrinsic.width };\n if (height !== undefined) return { width: (height * intrinsic.width) / intrinsic.height, height };\n return intrinsic;\n}\n\n/** Integer pixel size after scaling. Throws `too-large` past `maxPixels`. */\nexport function toPixelSize(size: Size, settings: Pick<RenderSettings, 'scale' | 'maxPixels'>): Size {\n const width = Math.max(1, Math.round(size.width * settings.scale));\n const height = Math.max(1, Math.round(size.height * settings.scale));\n assertPixelBudget(width, height, settings.maxPixels);\n return { width, height };\n}\n\nexport function assertPixelBudget(width: number, height: number, maxPixels: number): void {\n if (width * height > maxPixels) {\n throw copyFailure(\n 'too-large',\n `A ${String(width)}×${String(height)} image exceeds the ${String(maxPixels)}-pixel limit. Lower \\`scale\\` or raise \\`maxPixels\\`.`,\n );\n }\n}\n","import { copyFailure, isCopyFailure } from '../core/errors';\nimport { IMAGE_MIME_TYPE } from '../core/payload';\nimport { sniffImageType } from '../core/mime';\nimport { withDeadline } from './deadline';\nimport type { CaptureEnvironment } from './environment';\nimport { assertPixelBudget, type RenderSettings, type Size } from './options';\n\n/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */\nexport function classifyCaptureError(cause: unknown, label: string): unknown {\n return isCopyFailure(cause) ? cause : copyFailure('blob-generation-failed', `${label} failed.`, cause);\n}\n\n/**\n * Decodes an image Blob and re-encodes it as PNG at `target` (or its natural\n * size), within the deadline. The object URL is always revoked.\n */\nexport async function drawBlobToPng(\n blob: Blob,\n target: Size | null,\n settings: RenderSettings,\n environment: CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const url = environment.createObjectURL(blob);\n try {\n return await withDeadline(\n async () => {\n const image = await environment.loadImage(url);\n const size = target ?? { width: image.width, height: image.height };\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return environment.encodePng(image, { ...size, background: settings.background });\n },\n { timeoutMs: settings.timeoutMs, signal, label },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, label);\n } finally {\n environment.revokeObjectURL(url);\n }\n}\n\n/** Width and height from a PNG's IHDR chunk, read from the first 24 bytes only. */\nexport async function readPngSize(blob: Blob): Promise<Size | null> {\n const bytes = new Uint8Array(await blob.slice(0, 24).arrayBuffer());\n if (bytes.length < 24) return null;\n const view = new DataView(bytes.buffer);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/**\n * Guarantees the clipboard-safe result: a real PNG (verified by its bytes),\n * typed `image/png`, within the pixel budget. Other raster formats are re-encoded.\n */\nexport async function ensurePng(\n blob: Blob,\n settings: RenderSettings,\n environment: () => CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const actual = await sniffImageType(blob);\n if (actual === null) {\n throw copyFailure('blob-generation-failed', `${label} did not produce an image.`);\n }\n if (actual !== IMAGE_MIME_TYPE) {\n return drawBlobToPng(blob, null, settings, environment(), signal, label);\n }\n const size = await readPngSize(blob);\n if (size === null) throw copyFailure('blob-generation-failed', `${label} produced a truncated PNG.`);\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return blob.type === IMAGE_MIME_TYPE ? blob : blob.slice(0, blob.size, IMAGE_MIME_TYPE);\n}\n","import { copyFailure } from '../core/errors';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { resolveCaptureEnvironment } from './environment';\nimport { drawBlobToPng } from './render';\nimport { resolveRenderSettings, resolveSize, toPixelSize, type RenderOptions, type Size } from './options';\n\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n/** Refuse absurd markup before handing it to the image decoder. 10 M characters. */\nexport const DEFAULT_MAX_SVG_LENGTH = 10_000_000;\n\nexport interface SvgToPngOptions extends RenderOptions {\n /** Max markup length in characters. Default 10 000 000. */\n readonly maxLength?: number;\n}\n\n// Both patterns are linear-time: untrusted markup must not be able to trigger catastrophic backtracking.\nconst SVG_OPEN = /<svg\\b/i;\nconst LENGTH = /^(\\d+(?:\\.\\d+)?|\\.\\d+)(?:px)?$/i;\n\n/** The first `<svg …>` tag, found with two linear scans. */\nfunction findRootTag(markup: string): string | null {\n const start = markup.search(SVG_OPEN);\n if (start === -1) return null;\n const end = markup.indexOf('>', start);\n return end === -1 ? null : markup.slice(start, end + 1);\n}\n\n// Pre-compiled attribute patterns for the three attributes we ever read.\n// Compiling at module load time and with fixed literal names eliminates any\n// risk of ReDoS from runtime-constructed RegExps.\nconst ATTR_PATTERNS: Readonly<Record<string, RegExp>> = /* @__PURE__ */ Object.freeze({\n width: /\\swidth\\s*=\\s*([\"'])(.*?)\\1/i,\n height: /\\sheight\\s*=\\s*([\"'])(.*?)\\1/i,\n viewBox: /\\sviewBox\\s*=\\s*([\"'])(.*?)\\1/i,\n xmlns: /\\sxmlns\\s*=\\s*([\"'])(.*?)\\1/i,\n});\n\nfunction readAttribute(tag: string, name: keyof typeof ATTR_PATTERNS): string | null {\n const pattern = ATTR_PATTERNS[name];\n /* c8 ignore next -- TypeScript enforces name is a key of ATTR_PATTERNS; guard is for JS callers only */\n if (!pattern) return null;\n const match = pattern.exec(tag);\n return match === null ? null : String(match[2]);\n}\n\nfunction parseLength(value: string | null): number | null {\n if (value === null) return null;\n const match = LENGTH.exec(value.trim());\n const number = match ? Number(match[1]) : NaN;\n return number > 0 ? number : null;\n}\n\n/** Intrinsic size from the root tag: `width`/`height` in px, else the `viewBox`. */\nexport function readSvgSize(markup: string): Size | null {\n const tag = findRootTag(markup);\n if (tag === null) return null;\n const width = parseLength(readAttribute(tag, 'width'));\n const height = parseLength(readAttribute(tag, 'height'));\n if (width !== null && height !== null) return { width, height };\n\n const raw = readAttribute(tag, 'viewBox');\n const viewBox = raw != null ? raw.trim().split(/[\\s,]+/).map(Number) : [];\n const [, , boxWidth = NaN, boxHeight = NaN] = viewBox;\n if (viewBox.length !== 4 || !(boxWidth > 0) || !(boxHeight > 0)) return null;\n if (width !== null) return { width, height: (width * boxHeight) / boxWidth };\n if (height !== null) return { width: (height * boxWidth) / boxHeight, height };\n return { width: boxWidth, height: boxHeight };\n}\n\n/** Adds the SVG namespace when missing; `<img>` refuses to decode SVG without it. */\nexport function ensureSvgNamespace(markup: string): string {\n const tag = findRootTag(markup);\n if (tag === null) throw copyFailure('invalid-payload', 'The markup has no <svg> root element.');\n if (readAttribute(tag, 'xmlns') !== null) return markup;\n return markup.replace(SVG_OPEN, `<svg xmlns=\"${SVG_NAMESPACE}\"`);\n}\n\nconst isSvgElement = (value: Element): boolean => value.localName === 'svg';\n\n/**\n * Rasterises SVG (an `<svg>` element or markup) to a PNG Blob, ready for\n * `copy({ kind: 'image', blob })`.\n *\n * Security: the SVG is decoded as an *image*, where browsers disable scripts,\n * event handlers and external resource loading, and it is never inserted into\n * the document. Size is capped in characters and pixels.\n */\nexport async function svgToPngBlob(source: Element | string, options: SvgToPngOptions = {}): Promise<Blob> {\n const environment = resolveCaptureEnvironment(options.environment);\n const settings = resolveRenderSettings(options);\n const maxLength = options.maxLength ?? DEFAULT_MAX_SVG_LENGTH;\n\n let intrinsic: Size | null = null;\n let markup: string;\n if (typeof source === 'string') {\n markup = source;\n } else {\n if (!isSvgElement(source)) throw copyFailure('invalid-payload', `Expected an <svg> element, got <${source.localName}>.`);\n const rect = source.getBoundingClientRect();\n if (rect.width > 0 && rect.height > 0) intrinsic = { width: rect.width, height: rect.height };\n markup = environment.serializeSvg(source);\n }\n\n if (markup.length > maxLength) {\n throw copyFailure('too-large', `The SVG markup exceeds ${String(maxLength)} characters.`);\n }\n const prepared = ensureSvgNamespace(markup);\n const size = resolveSize(intrinsic ?? readSvgSize(prepared), options.width, options.height);\n const target = toPixelSize(size, settings);\n\n const blob = new Blob([prepared], { type: SVG_MIME_TYPE });\n return drawBlobToPng(blob, target, settings, environment, options.signal, 'SVG rasterisation');\n}\n","import { copyFailure } from '../core/errors';\nimport type { OperationContext } from '../core/machine-shared';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { isBlob, type ImagePayload } from '../core/payload';\nimport { withDeadline } from './deadline';\nimport { resolveCaptureEnvironment, type CaptureEnvironment } from './environment';\nimport {\n resolveRenderSettings,\n resolveSize,\n toPixelSize,\n type RenderOptions,\n type RenderSettings,\n type Size,\n} from './options';\nimport { classifyCaptureError, ensurePng } from './render';\nimport { svgToPngBlob } from './svg';\n\n/** Anything with `canvas.toBlob()`: `HTMLCanvasElement`, or a compatible object. */\nexport interface CanvasLike {\n toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void;\n}\n\n/**\n * What a rasteriser may return: a Blob (any raster format), a canvas, or a\n * base64 `data:image/…` URL. Network URLs are refused (never fetched).\n */\nexport type RasterizeOutput = Blob | CanvasLike | string;\n\nexport interface RasterizeContext {\n /** Pixel density to render at. */\n readonly scale: number;\n /** CSS size of the element (or the requested size). */\n readonly width: number;\n readonly height: number;\n readonly backgroundColor: string | null;\n /** Fires on timeout or caller abort: stop work early if you can. */\n readonly signal: AbortSignal;\n}\n\n/**\n * Turns a DOM node into pixels. Bring your own engine, e.g.\n * `(node, { scale }) => domToBlob(node, { scale })` from `modern-screenshot`.\n */\nexport type Rasterizer = (node: Element, context: RasterizeContext) => PromiseLike<RasterizeOutput> | RasterizeOutput;\n\nexport interface CaptureElementOptions extends RenderOptions {\n /** Required for HTML elements. `<svg>` elements are rasterised natively when omitted. */\n readonly rasterize?: Rasterizer;\n}\n\nconst LABEL = 'Element capture';\nconst DATA_URL = /^data:(image\\/[a-z0-9.+-]+)((?:;[a-z0-9-]+=[a-z0-9.+-]+)*)(;base64)?,/i;\n\nfunction decodeBase64(payload: string, type: string): Blob {\n let binary: string;\n try {\n binary = atob(payload);\n } catch (cause) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned malformed base64.', cause);\n }\n const bytes = new Uint8Array(binary.length);\n for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);\n return new Blob([bytes], { type });\n}\n\nfunction canvasToBlob(canvas: CanvasLike): Promise<Blob> {\n return new Promise((resolve, reject) => {\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing.'));\n }, 'image/png');\n });\n}\n\nconst isCanvasLike = (value: unknown): value is CanvasLike =>\n typeof value === 'object' && value !== null && typeof (value as { toBlob?: unknown }).toBlob === 'function';\n\nasync function toPng(\n output: unknown,\n options: CaptureElementOptions,\n settings: RenderSettings,\n size: Size,\n signal: AbortSignal,\n): Promise<Blob> {\n const environment = (): CaptureEnvironment => resolveCaptureEnvironment(options.environment);\n\n if (isBlob(output)) return ensurePng(output, settings, environment, signal, LABEL);\n if (isCanvasLike(output)) return ensurePng(await canvasToBlob(output), settings, environment, signal, LABEL);\n if (typeof output !== 'string') {\n throw copyFailure('blob-generation-failed', 'The rasteriser must return a Blob, a canvas or a data:image URL.');\n }\n\n const match = DATA_URL.exec(output);\n if (match === null) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned a string that is not a data:image URL.');\n }\n const type = String(match[1]).toLowerCase();\n const base64 = match[3] !== undefined;\n const body = output.slice(match[0].length);\n\n if (type === SVG_MIME_TYPE) {\n // e.g. modern-screenshot's domToSvg: rasterise it natively at the element's size.\n const markup = base64 ? await decodeBase64(body, type).text() : decodeURIComponent(body);\n return svgToPngBlob(markup, {\n ...settings,\n width: size.width,\n height: size.height,\n signal,\n environment: environment(),\n });\n }\n if (!base64) throw copyFailure('blob-generation-failed', 'Raster data URLs must be base64-encoded.');\n return ensurePng(decodeBase64(body, type), settings, environment, signal, LABEL);\n}\n\n/**\n * Captures an element as a PNG Blob, ready for `copy({ kind: 'image', blob })`.\n * Output is verified to be a real PNG within `maxPixels`, or a classified\n * `CopyFailure` is thrown (`invalid-payload`, `unsupported`, `too-large`,\n * `timeout`, `aborted`, `blob-generation-failed`).\n */\nexport async function captureElement(node: Element | null | undefined, options: CaptureElementOptions = {}): Promise<Blob> {\n if (!node) throw copyFailure('invalid-payload', 'There is no element to capture (is the ref attached yet?).');\n\n const { rasterize } = options;\n if (!rasterize) {\n if (node.localName === 'svg') return svgToPngBlob(node, options);\n throw copyFailure(\n 'unsupported',\n 'Capturing HTML needs a `rasterize` function, e.g. `domToBlob` from modern-screenshot. Only <svg> works without one.',\n );\n }\n\n const settings = resolveRenderSettings(options);\n const rect = node.getBoundingClientRect();\n const intrinsic = rect.width > 0 && rect.height > 0 ? { width: rect.width, height: rect.height } : null;\n const size = resolveSize(intrinsic, options.width, options.height);\n toPixelSize(size, settings); // Refuse before rendering anything.\n\n try {\n return await withDeadline(\n async (signal) => {\n const output = await rasterize(node, {\n scale: settings.scale,\n width: size.width,\n height: size.height,\n backgroundColor: settings.background,\n signal,\n });\n return toPng(output, options, settings, size, signal);\n },\n { timeoutMs: settings.timeoutMs, signal: options.signal, label: LABEL },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, LABEL);\n }\n}\n\n/**\n * A lazy `BlobSource` for `copy()`. Resolving the element at click time and\n * starting inside the gesture keeps Safari happy. Rasterising stops when the\n * copy is reset or its component unmounts, or when `options.signal` aborts.\n *\n * @example copy({ kind: 'image', blob: captureSource(() => cardRef.current, { rasterize }) })\n */\nexport function captureSource(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): (context?: OperationContext) => Promise<Blob> {\n return (context) => {\n const a = options.signal;\n const b = context?.signal;\n if (!a || !b) {\n const signal = a ?? b;\n return captureElement(getNode(), signal ? { ...options, signal } : options);\n }\n const any = (AbortSignal as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n if (typeof any === 'function') return captureElement(getNode(), { ...options, signal: any([a, b]) });\n\n // Older browsers: forward both, and detach once settled so a long-lived\n // caller signal doesn't accumulate a listener per copy.\n const controller = new AbortController();\n const onAbortA = (): void => {\n controller.abort(a.reason);\n };\n const onAbortB = (): void => {\n controller.abort(b.reason);\n };\n if (a.aborted) onAbortA();\n else if (b.aborted) onAbortB();\n a.addEventListener('abort', onAbortA);\n b.addEventListener('abort', onAbortB);\n return captureElement(getNode(), { ...options, signal: controller.signal }).finally(() => {\n a.removeEventListener('abort', onAbortA);\n b.removeEventListener('abort', onAbortB);\n });\n };\n}\n\n/** Shorthand for `{ kind: 'image', blob: captureSource(getNode, options) }`. */\nexport function captureImage(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): ImagePayload {\n return { kind: 'image', blob: captureSource(getNode, options) };\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"capture.js","names":[],"sources":["../src/capture/environment.ts","../src/capture/options.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** A decoded image, ready to be drawn. `source` is platform-specific (an `HTMLImageElement` in browsers). */\nexport interface DecodedImage {\n readonly source: unknown;\n readonly width: number;\n readonly height: number;\n}\n\nexport interface PngTarget {\n /** Integer pixel size of the output. */\n readonly width: number;\n readonly height: number;\n /** CSS colour painted under the image, or `null` for transparency. */\n readonly background: string | null;\n}\n\n/**\n * Everything capture needs from the platform. The default uses the DOM;\n * inject your own for workers (OffscreenCanvas), native shells or tests.\n */\nexport interface CaptureEnvironment {\n readonly createObjectURL: (blob: Blob) => string;\n readonly revokeObjectURL: (url: string) => void;\n /** Serialises an `<svg>` element to markup. */\n readonly serializeSvg: (node: Element) => string;\n /** Decodes an image from a `blob:` or `data:` URL. */\n readonly loadImage: (url: string) => Promise<DecodedImage>;\n /** Draws the image scaled to `target` and encodes it as PNG. */\n readonly encodePng: (image: DecodedImage, target: PngTarget) => Promise<Blob>;\n}\n\nfunction loadImage(url: string): Promise<DecodedImage> {\n return new Promise((resolve, reject) => {\n const image = new Image();\n image.decoding = 'async';\n image.onload = () => {\n resolve({ source: image, width: image.naturalWidth, height: image.naturalHeight });\n };\n image.onerror = () => {\n reject(copyFailure('blob-generation-failed', 'The image could not be decoded.'));\n };\n image.src = url;\n });\n}\n\nfunction encodePng(image: DecodedImage, target: PngTarget): Promise<Blob> {\n return new Promise((resolve, reject) => {\n const canvas = document.createElement('canvas');\n canvas.width = target.width;\n canvas.height = target.height;\n const context = canvas.getContext('2d');\n if (!context) {\n reject(copyFailure('unsupported', 'Canvas 2D rendering is not available.'));\n return;\n }\n if (target.background !== null) {\n context.fillStyle = target.background;\n context.fillRect(0, 0, target.width, target.height);\n }\n context.drawImage(image.source as CanvasImageSource, 0, 0, target.width, target.height);\n // Throws SecurityError synchronously for tainted canvases; the executor turns that into a rejection.\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing (canvas too large?).'));\n }, 'image/png');\n });\n}\n\n/** The DOM-backed environment, or `null` outside a browser. */\nexport function getDefaultCaptureEnvironment(): CaptureEnvironment | null {\n if (\n typeof document === 'undefined' ||\n typeof Image !== 'function' ||\n typeof XMLSerializer !== 'function' ||\n typeof URL.createObjectURL !== 'function'\n ) {\n return null;\n }\n return {\n createObjectURL: (blob) => URL.createObjectURL(blob),\n revokeObjectURL: (url) => {\n URL.revokeObjectURL(url);\n },\n serializeSvg: (node) => new XMLSerializer().serializeToString(node),\n loadImage,\n encodePng,\n };\n}\n\nexport function resolveCaptureEnvironment(environment: CaptureEnvironment | undefined): CaptureEnvironment {\n const resolved = environment ?? getDefaultCaptureEnvironment();\n if (!resolved) {\n throw copyFailure('unsupported', 'Image capture needs a browser environment (document, Image, canvas).');\n }\n return resolved;\n}\n","import { copyFailure } from '../core/errors';\nimport type { CaptureEnvironment } from './environment';\n\nexport const DEFAULT_CAPTURE_SCALE = 2;\nexport const MAX_CAPTURE_SCALE = 10;\n/** 4096 × 4096: the canvas area limit of Safari/iOS, the strictest mainstream engine. */\nexport const DEFAULT_MAX_PIXELS = 16_777_216;\nexport const DEFAULT_CAPTURE_TIMEOUT_MS = 15_000;\n\nexport interface RenderOptions {\n /** Output width in CSS px (before `scale`). Omit to use the intrinsic size; set one side to keep the aspect ratio. */\n readonly width?: number;\n /** Output height in CSS px (before `scale`). */\n readonly height?: number;\n /** Pixel density multiplier, e.g. `window.devicePixelRatio`. Default 2 (crisp on HiDPI). Max 10. */\n readonly scale?: number;\n /** CSS colour under the image. Default `null` (transparent). */\n readonly background?: string | null;\n /** Refuse outputs larger than this many pixels (memory / DoS guard). Default 16 777 216. */\n readonly maxPixels?: number;\n /** Give up after this long. Default 15 000 ms. `Infinity` disables. */\n readonly timeoutMs?: number;\n /** Cancel the capture. */\n readonly signal?: AbortSignal;\n /** Platform hooks. Defaults to the DOM. */\n readonly environment?: CaptureEnvironment;\n}\n\nexport interface RenderSettings {\n readonly scale: number;\n readonly background: string | null;\n readonly maxPixels: number;\n readonly timeoutMs: number;\n}\n\nexport interface Size {\n readonly width: number;\n readonly height: number;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nconst isPositiveFinite = (value: number): boolean => Number.isFinite(value) && value > 0;\n\nexport function resolveRenderSettings(options: RenderOptions): RenderSettings {\n const scale = options.scale ?? DEFAULT_CAPTURE_SCALE;\n if (!isPositiveFinite(scale) || scale > MAX_CAPTURE_SCALE) {\n throw invalid(`\\`scale\\` must be > 0 and <= ${String(MAX_CAPTURE_SCALE)} (received ${String(scale)}).`);\n }\n const maxPixels = options.maxPixels ?? DEFAULT_MAX_PIXELS;\n if (!Number.isInteger(maxPixels) || maxPixels <= 0) {\n throw invalid(`\\`maxPixels\\` must be a positive integer (received ${String(maxPixels)}).`);\n }\n const timeoutMs = options.timeoutMs ?? DEFAULT_CAPTURE_TIMEOUT_MS;\n if (timeoutMs !== Infinity && !isPositiveFinite(timeoutMs)) {\n throw invalid(`\\`timeoutMs\\` must be > 0 or Infinity (received ${String(timeoutMs)}).`);\n }\n return { scale, background: options.background ?? null, maxPixels, timeoutMs };\n}\n\n/** Combines explicit `width`/`height` with an intrinsic size, keeping the aspect ratio when only one is set. */\nexport function resolveSize(intrinsic: Size | null, width: number | undefined, height: number | undefined): Size {\n for (const [name, value] of [\n ['width', width],\n ['height', height],\n ] as const) {\n if (value !== undefined && !isPositiveFinite(value)) {\n throw invalid(`\\`${name}\\` must be a positive number (received ${String(value)}).`);\n }\n }\n if (width !== undefined && height !== undefined) return { width, height };\n if (intrinsic === null) {\n throw invalid('The size to render is unknown: pass `width` and `height`, or give the source a size.');\n }\n if (width !== undefined) return { width, height: (width * intrinsic.height) / intrinsic.width };\n if (height !== undefined) return { width: (height * intrinsic.width) / intrinsic.height, height };\n return intrinsic;\n}\n\n/** Integer pixel size after scaling. Throws `too-large` past `maxPixels`. */\nexport function toPixelSize(size: Size, settings: Pick<RenderSettings, 'scale' | 'maxPixels'>): Size {\n const width = Math.max(1, Math.round(size.width * settings.scale));\n const height = Math.max(1, Math.round(size.height * settings.scale));\n assertPixelBudget(width, height, settings.maxPixels);\n return { width, height };\n}\n\nexport function assertPixelBudget(width: number, height: number, maxPixels: number): void {\n if (width * height > maxPixels) {\n throw copyFailure(\n 'too-large',\n `A ${String(width)}×${String(height)} image exceeds the ${String(maxPixels)}-pixel limit. Lower \\`scale\\` or raise \\`maxPixels\\`.`,\n );\n }\n}\n","import { blobFailure } from '../core/blob-failure';\nimport { copyFailure, isCopyFailure } from '../core/errors';\nimport { IMAGE_MIME_TYPE } from '../core/payload';\nimport { sniffImageType } from '../core/mime';\nimport { withDeadline } from './deadline';\nimport type { CaptureEnvironment } from './environment';\nimport { assertPixelBudget, type RenderSettings, type Size } from './options';\n\n/** Maps anything unexpected to `blob-generation-failed`, keeping already-classified failures. */\nexport function classifyCaptureError(cause: unknown, label: string): unknown {\n return isCopyFailure(cause) ? cause : blobFailure(label, cause);\n}\n\n/**\n * Decodes an image Blob and re-encodes it as PNG at `target` (or its natural\n * size), within the deadline. The object URL is always revoked.\n */\nexport async function drawBlobToPng(\n blob: Blob,\n target: Size | null,\n settings: RenderSettings,\n environment: CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const url = environment.createObjectURL(blob);\n try {\n return await withDeadline(\n async () => {\n const image = await environment.loadImage(url);\n const size = target ?? { width: image.width, height: image.height };\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return environment.encodePng(image, { ...size, background: settings.background });\n },\n { timeoutMs: settings.timeoutMs, signal, label },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, label);\n } finally {\n environment.revokeObjectURL(url);\n }\n}\n\n/** Width and height from a PNG's IHDR chunk, read from the first 24 bytes only. */\nexport async function readPngSize(blob: Blob): Promise<Size | null> {\n const bytes = new Uint8Array(await blob.slice(0, 24).arrayBuffer());\n if (bytes.length < 24) return null;\n const view = new DataView(bytes.buffer);\n return { width: view.getUint32(16), height: view.getUint32(20) };\n}\n\n/**\n * Guarantees the clipboard-safe result: a real PNG (verified by its bytes),\n * typed `image/png`, within the pixel budget. Other raster formats are re-encoded.\n */\nexport async function ensurePng(\n blob: Blob,\n settings: RenderSettings,\n environment: () => CaptureEnvironment,\n signal: AbortSignal | undefined,\n label: string,\n): Promise<Blob> {\n const actual = await sniffImageType(blob);\n if (actual === null) {\n throw copyFailure('blob-generation-failed', `${label} did not produce an image.`);\n }\n if (actual !== IMAGE_MIME_TYPE) {\n return drawBlobToPng(blob, null, settings, environment(), signal, label);\n }\n const size = await readPngSize(blob);\n if (size === null) throw copyFailure('blob-generation-failed', `${label} produced a truncated PNG.`);\n assertPixelBudget(size.width, size.height, settings.maxPixels);\n return blob.type === IMAGE_MIME_TYPE ? blob : blob.slice(0, blob.size, IMAGE_MIME_TYPE);\n}\n","import { copyFailure } from '../core/errors';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { resolveCaptureEnvironment } from './environment';\nimport { drawBlobToPng } from './render';\nimport { resolveRenderSettings, resolveSize, toPixelSize, type RenderOptions, type Size } from './options';\n\nexport const SVG_NAMESPACE = 'http://www.w3.org/2000/svg';\n/** Refuse absurd markup before handing it to the image decoder. 10 M characters. */\nexport const DEFAULT_MAX_SVG_LENGTH = 10_000_000;\n\nexport interface SvgToPngOptions extends RenderOptions {\n /** Max markup length in characters. Default 10 000 000. */\n readonly maxLength?: number;\n}\n\n// Both patterns are linear-time: untrusted markup must not be able to trigger catastrophic backtracking.\nconst SVG_OPEN = /<svg\\b/i;\nconst LENGTH = /^(\\d+(?:\\.\\d+)?|\\.\\d+)(?:px)?$/i;\n\n/** The first `<svg …>` tag, found with two linear scans. */\nfunction findRootTag(markup: string): string | null {\n const start = markup.search(SVG_OPEN);\n if (start === -1) return null;\n const end = markup.indexOf('>', start);\n return end === -1 ? null : markup.slice(start, end + 1);\n}\n\n// Pre-compiled attribute patterns for the three attributes we ever read.\n// Compiling at module load time and with fixed literal names eliminates any\n// risk of ReDoS from runtime-constructed RegExps.\nconst ATTR_PATTERNS: Readonly<Record<string, RegExp>> = /* @__PURE__ */ Object.freeze({\n width: /\\swidth\\s*=\\s*([\"'])(.*?)\\1/i,\n height: /\\sheight\\s*=\\s*([\"'])(.*?)\\1/i,\n viewBox: /\\sviewBox\\s*=\\s*([\"'])(.*?)\\1/i,\n xmlns: /\\sxmlns\\s*=\\s*([\"'])(.*?)\\1/i,\n});\n\nfunction readAttribute(tag: string, name: keyof typeof ATTR_PATTERNS): string | null {\n const pattern = ATTR_PATTERNS[name];\n /* c8 ignore next -- TypeScript enforces name is a key of ATTR_PATTERNS; guard is for JS callers only */\n if (!pattern) return null;\n const match = pattern.exec(tag);\n return match === null ? null : String(match[2]);\n}\n\nfunction parseLength(value: string | null): number | null {\n if (value === null) return null;\n const match = LENGTH.exec(value.trim());\n const number = match ? Number(match[1]) : NaN;\n return number > 0 ? number : null;\n}\n\n/** Intrinsic size from the root tag: `width`/`height` in px, else the `viewBox`. */\nexport function readSvgSize(markup: string): Size | null {\n const tag = findRootTag(markup);\n if (tag === null) return null;\n const width = parseLength(readAttribute(tag, 'width'));\n const height = parseLength(readAttribute(tag, 'height'));\n if (width !== null && height !== null) return { width, height };\n\n const raw = readAttribute(tag, 'viewBox');\n const viewBox = raw != null ? raw.trim().split(/[\\s,]+/).map(Number) : [];\n const [, , boxWidth = NaN, boxHeight = NaN] = viewBox;\n if (viewBox.length !== 4 || !(boxWidth > 0) || !(boxHeight > 0)) return null;\n if (width !== null) return { width, height: (width * boxHeight) / boxWidth };\n if (height !== null) return { width: (height * boxWidth) / boxHeight, height };\n return { width: boxWidth, height: boxHeight };\n}\n\n/** Adds the SVG namespace when missing; `<img>` refuses to decode SVG without it. */\nexport function ensureSvgNamespace(markup: string): string {\n const tag = findRootTag(markup);\n if (tag === null) throw copyFailure('invalid-payload', 'The markup has no <svg> root element.');\n if (readAttribute(tag, 'xmlns') !== null) return markup;\n return markup.replace(SVG_OPEN, `<svg xmlns=\"${SVG_NAMESPACE}\"`);\n}\n\nconst isSvgElement = (value: Element): boolean => value.localName === 'svg';\n\n/**\n * Rasterises SVG (an `<svg>` element or markup) to a PNG Blob, ready for\n * `copy({ kind: 'image', blob })`.\n *\n * Security: the SVG is decoded as an *image*, where browsers disable scripts,\n * event handlers and external resource loading, and it is never inserted into\n * the document. Size is capped in characters and pixels.\n */\nexport async function svgToPngBlob(source: Element | string, options: SvgToPngOptions = {}): Promise<Blob> {\n const environment = resolveCaptureEnvironment(options.environment);\n const settings = resolveRenderSettings(options);\n const maxLength = options.maxLength ?? DEFAULT_MAX_SVG_LENGTH;\n\n let intrinsic: Size | null = null;\n let markup: string;\n if (typeof source === 'string') {\n markup = source;\n } else {\n if (!isSvgElement(source)) throw copyFailure('invalid-payload', `Expected an <svg> element, got <${source.localName}>.`);\n const rect = source.getBoundingClientRect();\n if (rect.width > 0 && rect.height > 0) intrinsic = { width: rect.width, height: rect.height };\n markup = environment.serializeSvg(source);\n }\n\n if (markup.length > maxLength) {\n throw copyFailure('too-large', `The SVG markup exceeds ${String(maxLength)} characters.`);\n }\n const prepared = ensureSvgNamespace(markup);\n const size = resolveSize(intrinsic ?? readSvgSize(prepared), options.width, options.height);\n const target = toPixelSize(size, settings);\n\n const blob = new Blob([prepared], { type: SVG_MIME_TYPE });\n return drawBlobToPng(blob, target, settings, environment, options.signal, 'SVG rasterisation');\n}\n","import { copyFailure } from '../core/errors';\nimport type { OperationContext } from '../core/machine-shared';\nimport { SVG_MIME_TYPE } from '../core/mime';\nimport { isBlob, type ImagePayload } from '../core/payload';\nimport { withDeadline } from './deadline';\nimport { resolveCaptureEnvironment, type CaptureEnvironment } from './environment';\nimport {\n resolveRenderSettings,\n resolveSize,\n toPixelSize,\n type RenderOptions,\n type RenderSettings,\n type Size,\n} from './options';\nimport { classifyCaptureError, ensurePng } from './render';\nimport { svgToPngBlob } from './svg';\n\n/** Anything with `canvas.toBlob()`: `HTMLCanvasElement`, or a compatible object. */\nexport interface CanvasLike {\n toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void;\n}\n\n/**\n * What a rasteriser may return: a Blob (any raster format), a canvas, or a\n * base64 `data:image/…` URL. Network URLs are refused (never fetched).\n */\nexport type RasterizeOutput = Blob | CanvasLike | string;\n\nexport interface RasterizeContext {\n /** Pixel density to render at. */\n readonly scale: number;\n /** CSS size of the element (or the requested size). */\n readonly width: number;\n readonly height: number;\n readonly backgroundColor: string | null;\n /** Fires on timeout or caller abort: stop work early if you can. */\n readonly signal: AbortSignal;\n}\n\n/**\n * Turns a DOM node into pixels. Bring your own engine, e.g.\n * `(node, { scale }) => domToBlob(node, { scale })` from `modern-screenshot`.\n */\nexport type Rasterizer = (node: Element, context: RasterizeContext) => PromiseLike<RasterizeOutput> | RasterizeOutput;\n\nexport interface CaptureElementOptions extends RenderOptions {\n /** Required for HTML elements. `<svg>` elements are rasterised natively when omitted. */\n readonly rasterize?: Rasterizer;\n}\n\nconst LABEL = 'Element capture';\nconst DATA_URL = /^data:(image\\/[a-z0-9.+-]+)((?:;[a-z0-9-]+=[a-z0-9.+-]+)*)(;base64)?,/i;\n\nfunction decodeBase64(payload: string, type: string): Blob {\n let binary: string;\n try {\n binary = atob(payload);\n } catch (cause) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned malformed base64.', cause);\n }\n const bytes = new Uint8Array(binary.length);\n for (let index = 0; index < binary.length; index++) bytes[index] = binary.charCodeAt(index);\n return new Blob([bytes], { type });\n}\n\nfunction canvasToBlob(canvas: CanvasLike): Promise<Blob> {\n return new Promise((resolve, reject) => {\n canvas.toBlob((blob) => {\n if (blob) resolve(blob);\n else reject(copyFailure('blob-generation-failed', 'canvas.toBlob() produced nothing.'));\n }, 'image/png');\n });\n}\n\nconst isCanvasLike = (value: unknown): value is CanvasLike =>\n typeof value === 'object' && value !== null && typeof (value as { toBlob?: unknown }).toBlob === 'function';\n\nasync function toPng(\n output: unknown,\n options: CaptureElementOptions,\n settings: RenderSettings,\n size: Size,\n signal: AbortSignal,\n): Promise<Blob> {\n const environment = (): CaptureEnvironment => resolveCaptureEnvironment(options.environment);\n\n if (isBlob(output)) return ensurePng(output, settings, environment, signal, LABEL);\n if (isCanvasLike(output)) return ensurePng(await canvasToBlob(output), settings, environment, signal, LABEL);\n if (typeof output !== 'string') {\n throw copyFailure('blob-generation-failed', 'The rasteriser must return a Blob, a canvas or a data:image URL.');\n }\n\n const match = DATA_URL.exec(output);\n if (match === null) {\n throw copyFailure('blob-generation-failed', 'The rasteriser returned a string that is not a data:image URL.');\n }\n const type = String(match[1]).toLowerCase();\n const base64 = match[3] !== undefined;\n const body = output.slice(match[0].length);\n\n if (type === SVG_MIME_TYPE) {\n // e.g. modern-screenshot's domToSvg: rasterise it natively at the element's size.\n const markup = base64 ? await decodeBase64(body, type).text() : decodeURIComponent(body);\n return svgToPngBlob(markup, {\n ...settings,\n width: size.width,\n height: size.height,\n signal,\n environment: environment(),\n });\n }\n if (!base64) throw copyFailure('blob-generation-failed', 'Raster data URLs must be base64-encoded.');\n return ensurePng(decodeBase64(body, type), settings, environment, signal, LABEL);\n}\n\n/**\n * Captures an element as a PNG Blob, ready for `copy({ kind: 'image', blob })`.\n * Output is verified to be a real PNG within `maxPixels`, or a classified\n * `CopyFailure` is thrown (`invalid-payload`, `unsupported`, `too-large`,\n * `timeout`, `aborted`, `blob-generation-failed`).\n */\nexport async function captureElement(node: Element | null | undefined, options: CaptureElementOptions = {}): Promise<Blob> {\n if (!node) throw copyFailure('invalid-payload', 'There is no element to capture (is the ref attached yet?).');\n\n const { rasterize } = options;\n if (!rasterize) {\n if (node.localName === 'svg') return svgToPngBlob(node, options);\n throw copyFailure(\n 'unsupported',\n 'Capturing HTML needs a `rasterize` function, e.g. `domToBlob` from modern-screenshot. Only <svg> works without one.',\n );\n }\n\n const settings = resolveRenderSettings(options);\n const rect = node.getBoundingClientRect();\n const intrinsic = rect.width > 0 && rect.height > 0 ? { width: rect.width, height: rect.height } : null;\n const size = resolveSize(intrinsic, options.width, options.height);\n toPixelSize(size, settings); // Refuse before rendering anything.\n\n try {\n return await withDeadline(\n async (signal) => {\n const output = await rasterize(node, {\n scale: settings.scale,\n width: size.width,\n height: size.height,\n backgroundColor: settings.background,\n signal,\n });\n return toPng(output, options, settings, size, signal);\n },\n { timeoutMs: settings.timeoutMs, signal: options.signal, label: LABEL },\n );\n } catch (cause) {\n throw classifyCaptureError(cause, LABEL);\n }\n}\n\n/**\n * A lazy `BlobSource` for `copy()`. Resolving the element at click time and\n * starting inside the gesture keeps Safari happy. Rasterising stops when the\n * copy is reset or its component unmounts, or when `options.signal` aborts.\n *\n * @example copy({ kind: 'image', blob: captureSource(() => cardRef.current, { rasterize }) })\n */\nexport function captureSource(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): (context?: OperationContext) => Promise<Blob> {\n return (context) => {\n const a = options.signal;\n const b = context?.signal;\n if (!a || !b) {\n const signal = a ?? b;\n return captureElement(getNode(), signal ? { ...options, signal } : options);\n }\n const any = (AbortSignal as { any?: (signals: AbortSignal[]) => AbortSignal }).any;\n if (typeof any === 'function') return captureElement(getNode(), { ...options, signal: any([a, b]) });\n\n // Older browsers: forward both, and detach once settled so a long-lived\n // caller signal doesn't accumulate a listener per copy.\n const controller = new AbortController();\n const onAbortA = (): void => {\n controller.abort(a.reason);\n };\n const onAbortB = (): void => {\n controller.abort(b.reason);\n };\n if (a.aborted) onAbortA();\n else if (b.aborted) onAbortB();\n a.addEventListener('abort', onAbortA);\n b.addEventListener('abort', onAbortB);\n return captureElement(getNode(), { ...options, signal: controller.signal }).finally(() => {\n a.removeEventListener('abort', onAbortA);\n b.removeEventListener('abort', onAbortB);\n });\n };\n}\n\n/** Shorthand for `{ kind: 'image', blob: captureSource(getNode, options) }`. */\nexport function captureImage(\n getNode: () => Element | null | undefined,\n options: CaptureElementOptions = {},\n): ImagePayload {\n return { kind: 'image', blob: captureSource(getNode, options) };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,217 @@
|
|
|
1
|
+
|
|
2
|
+
import { r as createCopyError, t as CopyFailure } from "./errors-CGcMvbhJ.js";
|
|
3
|
+
import { i as serializeJson, n as isBlob, t as IMAGE_MIME_TYPE } from "./payload-5uJedhwz.js";
|
|
4
|
+
import { i as isWebCustomFormat } from "./mime-aa-HA2dm.js";
|
|
5
|
+
//#region src/core/legacy-copy.ts
|
|
6
|
+
/**
|
|
7
|
+
* The copy that works where the async Clipboard API does not: plain HTTP pages (intranets,
|
|
8
|
+
* internal tools on an IP address) and webviews without `navigator.clipboard`.
|
|
9
|
+
*
|
|
10
|
+
* `document.execCommand('copy')` fires a `copy` event whose `clipboardData` takes any text
|
|
11
|
+
* format, so the payload is written exactly, as text and HTML alike. Nothing is shown and
|
|
12
|
+
* nothing moves: the selection the command needs is made on a node outside the layout, and
|
|
13
|
+
* the user's own selection and focus are put back before the function returns. It runs
|
|
14
|
+
* synchronously, inside the user's gesture. Internal: not part of the public API.
|
|
15
|
+
*/
|
|
16
|
+
/** What can travel through a copy event: every text format, no images, no blobs, no web custom formats. */
|
|
17
|
+
function legacyEntries(payload) {
|
|
18
|
+
switch (payload.kind) {
|
|
19
|
+
case "text": return [["text/plain", payload.value]];
|
|
20
|
+
case "json": return [["text/plain", serializeJson(payload)]];
|
|
21
|
+
case "html": return [["text/html", payload.html], ["text/plain", payload.text]];
|
|
22
|
+
case "image": return null;
|
|
23
|
+
case "multi": {
|
|
24
|
+
const entries = [];
|
|
25
|
+
for (const { mimeType, data, optional } of payload.items) if (typeof data === "string" && !isWebCustomFormat(mimeType)) entries.push([mimeType, data]);
|
|
26
|
+
else if (optional !== true) return null;
|
|
27
|
+
return entries.length > 0 ? entries : null;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
}
|
|
31
|
+
function saveFocus(doc) {
|
|
32
|
+
const element = doc.activeElement;
|
|
33
|
+
if (!element || element === doc.body) return null;
|
|
34
|
+
try {
|
|
35
|
+
const { selectionStart: start, selectionEnd: end, selectionDirection: direction } = element;
|
|
36
|
+
return [element, typeof start === "number" && typeof end === "number" ? [
|
|
37
|
+
start,
|
|
38
|
+
end,
|
|
39
|
+
direction ?? "none"
|
|
40
|
+
] : null];
|
|
41
|
+
} catch {
|
|
42
|
+
return [element, null];
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
function restoreFocus(doc, saved) {
|
|
46
|
+
if (!saved?.[0].isConnected) return;
|
|
47
|
+
const [element, range] = saved;
|
|
48
|
+
if (doc.activeElement !== element) element.focus({ preventScroll: true });
|
|
49
|
+
if (range) element.setSelectionRange(...range);
|
|
50
|
+
}
|
|
51
|
+
/**
|
|
52
|
+
* Writes `entries` through `execCommand('copy')`. Returns whether the browser took them;
|
|
53
|
+
* `false` leaves the clipboard as it was (the caller reports its own, classified error).
|
|
54
|
+
*/
|
|
55
|
+
function legacyCopy(doc, entries) {
|
|
56
|
+
if (typeof doc.execCommand !== "function" || !doc.body) return false;
|
|
57
|
+
const plain = entries.find(([format]) => format === "text/plain")?.[1];
|
|
58
|
+
const seen = { written: false };
|
|
59
|
+
const onCopy = (event) => {
|
|
60
|
+
const data = event.clipboardData;
|
|
61
|
+
if (!data) return;
|
|
62
|
+
event.preventDefault();
|
|
63
|
+
event.stopImmediatePropagation();
|
|
64
|
+
try {
|
|
65
|
+
for (const [format, value] of entries) data.setData(format, value);
|
|
66
|
+
seen.written = true;
|
|
67
|
+
} catch {}
|
|
68
|
+
};
|
|
69
|
+
const focus = saveFocus(doc);
|
|
70
|
+
const selection = doc.getSelection();
|
|
71
|
+
const ranges = [];
|
|
72
|
+
if (selection) for (let index = 0; index < selection.rangeCount; index += 1) ranges.push(selection.getRangeAt(index));
|
|
73
|
+
const holder = doc.createElement("span");
|
|
74
|
+
holder.textContent = plain === void 0 || plain === "" ? "\xA0" : plain;
|
|
75
|
+
holder.setAttribute("aria-hidden", "true");
|
|
76
|
+
holder.style.cssText = "position:fixed;top:0;left:0;clip-path:inset(50%);white-space:pre;user-select:text;-webkit-user-select:text";
|
|
77
|
+
doc.addEventListener("copy", onCopy, true);
|
|
78
|
+
doc.body.append(holder);
|
|
79
|
+
try {
|
|
80
|
+
if (selection) {
|
|
81
|
+
const range = doc.createRange();
|
|
82
|
+
range.selectNodeContents(holder);
|
|
83
|
+
selection.removeAllRanges();
|
|
84
|
+
selection.addRange(range);
|
|
85
|
+
}
|
|
86
|
+
doc.execCommand("copy");
|
|
87
|
+
} catch {} finally {
|
|
88
|
+
doc.removeEventListener("copy", onCopy, true);
|
|
89
|
+
holder.remove();
|
|
90
|
+
if (selection) {
|
|
91
|
+
selection.removeAllRanges();
|
|
92
|
+
for (const range of ranges) selection.addRange(range);
|
|
93
|
+
}
|
|
94
|
+
restoreFocus(doc, focus);
|
|
95
|
+
}
|
|
96
|
+
return seen.written;
|
|
97
|
+
}
|
|
98
|
+
//#endregion
|
|
99
|
+
//#region src/core/clipboard-adapter.ts
|
|
100
|
+
const fail = (type, message, cause) => new CopyFailure(createCopyError(type, message, cause));
|
|
101
|
+
const noop = () => void 0;
|
|
102
|
+
function defaultEnvironment() {
|
|
103
|
+
return typeof window === "undefined" ? void 0 : window;
|
|
104
|
+
}
|
|
105
|
+
function getRichClipboard(env, clipboard) {
|
|
106
|
+
const Item = env.ClipboardItem;
|
|
107
|
+
if (!Item || typeof clipboard.write !== "function") return null;
|
|
108
|
+
return {
|
|
109
|
+
Item,
|
|
110
|
+
write: clipboard.write.bind(clipboard)
|
|
111
|
+
};
|
|
112
|
+
}
|
|
113
|
+
function isTypeSupported(Item, type) {
|
|
114
|
+
return typeof Item.supports !== "function" || Item.supports(type);
|
|
115
|
+
}
|
|
116
|
+
async function resolveImageBlob(source, context) {
|
|
117
|
+
let blob;
|
|
118
|
+
try {
|
|
119
|
+
blob = await (typeof source === "function" ? source(context ?? { signal: new AbortController().signal }) : source);
|
|
120
|
+
} catch (cause) {
|
|
121
|
+
if (context?.signal.aborted) throw fail("aborted", "The image copy was cancelled.", cause);
|
|
122
|
+
throw fail("blob-generation-failed", "The image source threw or rejected while producing a Blob.", cause);
|
|
123
|
+
}
|
|
124
|
+
if (!isBlob(blob)) throw fail("blob-generation-failed", "The image source did not produce a Blob.");
|
|
125
|
+
if (blob.type !== "image/png") throw fail("unsupported-format", `Only ${IMAGE_MIME_TYPE} can be written to the clipboard (received "${blob.type || "unknown"}"). Convert with canvas.toBlob(cb, "${IMAGE_MIME_TYPE}").`);
|
|
126
|
+
return blob;
|
|
127
|
+
}
|
|
128
|
+
async function writeImage(rich, source, context) {
|
|
129
|
+
if (!isTypeSupported(rich.Item, "image/png")) throw fail("unsupported-format", `This browser cannot write ${IMAGE_MIME_TYPE} to the clipboard.`);
|
|
130
|
+
const blob = resolveImageBlob(source, context);
|
|
131
|
+
blob.catch(noop);
|
|
132
|
+
try {
|
|
133
|
+
await rich.write([new rich.Item({ [IMAGE_MIME_TYPE]: blob })]);
|
|
134
|
+
} catch (error) {
|
|
135
|
+
throw await blob.then(noop, (inner) => inner) ?? error;
|
|
136
|
+
}
|
|
137
|
+
await blob;
|
|
138
|
+
}
|
|
139
|
+
async function writeToClipboard(payload, env, settings, context) {
|
|
140
|
+
if (!env) throw fail("unsupported", "No browser environment: the clipboard only exists in the browser.");
|
|
141
|
+
/** Without the async API: the copy command if it can carry this payload, else `failure`. */
|
|
142
|
+
const legacy = (failure) => {
|
|
143
|
+
const entries = settings.legacyFallback && env.document ? legacyEntries(payload) : null;
|
|
144
|
+
if (entries && legacyCopy(env.document, entries)) return;
|
|
145
|
+
throw failure;
|
|
146
|
+
};
|
|
147
|
+
if (env.isSecureContext === false) {
|
|
148
|
+
legacy(fail("insecure-context", "The Clipboard API requires a secure context (HTTPS or localhost)."));
|
|
149
|
+
return;
|
|
150
|
+
}
|
|
151
|
+
const clipboard = env.navigator?.clipboard;
|
|
152
|
+
if (!clipboard) {
|
|
153
|
+
legacy(fail("unsupported", "navigator.clipboard is not available in this browser."));
|
|
154
|
+
return;
|
|
155
|
+
}
|
|
156
|
+
switch (payload.kind) {
|
|
157
|
+
case "text":
|
|
158
|
+
case "json": {
|
|
159
|
+
const text = payload.kind === "text" ? payload.value : serializeJson(payload);
|
|
160
|
+
if (typeof clipboard.writeText === "function") return clipboard.writeText(text);
|
|
161
|
+
legacy(fail("unsupported", "navigator.clipboard.writeText() is not available."));
|
|
162
|
+
return;
|
|
163
|
+
}
|
|
164
|
+
case "html": {
|
|
165
|
+
const rich = getRichClipboard(env, clipboard);
|
|
166
|
+
if (!rich || !isTypeSupported(rich.Item, "text/html")) {
|
|
167
|
+
const failure = fail("unsupported-format", "Rich HTML copy requires ClipboardItem and navigator.clipboard.write().");
|
|
168
|
+
try {
|
|
169
|
+
legacy(failure);
|
|
170
|
+
return;
|
|
171
|
+
} catch {
|
|
172
|
+
if (settings.degradeHtmlToText && typeof clipboard.writeText === "function") return clipboard.writeText(payload.text);
|
|
173
|
+
throw failure;
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return rich.write([new rich.Item({
|
|
177
|
+
"text/html": new Blob([payload.html], { type: "text/html" }),
|
|
178
|
+
"text/plain": new Blob([payload.text], { type: "text/plain" })
|
|
179
|
+
})]);
|
|
180
|
+
}
|
|
181
|
+
case "image": {
|
|
182
|
+
const rich = getRichClipboard(env, clipboard);
|
|
183
|
+
if (!rich) throw fail("unsupported-format", "Image copy requires ClipboardItem and navigator.clipboard.write().");
|
|
184
|
+
return writeImage(rich, payload.blob, context);
|
|
185
|
+
}
|
|
186
|
+
case "multi": {
|
|
187
|
+
const rich = getRichClipboard(env, clipboard);
|
|
188
|
+
if (!rich) {
|
|
189
|
+
legacy(fail("unsupported-format", "Multi-format copy requires ClipboardItem and navigator.clipboard.write()."));
|
|
190
|
+
return;
|
|
191
|
+
}
|
|
192
|
+
const record = Object.create(null);
|
|
193
|
+
let written = 0;
|
|
194
|
+
for (const { mimeType, data, optional } of payload.items) {
|
|
195
|
+
if (optional === true && !(typeof rich.Item.supports === "function" && rich.Item.supports(mimeType))) continue;
|
|
196
|
+
if (!isTypeSupported(rich.Item, mimeType)) throw fail("unsupported-format", `This browser cannot write "${mimeType}" to the clipboard.`);
|
|
197
|
+
record[mimeType] = typeof data === "string" ? new Blob([data], { type: mimeType }) : data;
|
|
198
|
+
written += 1;
|
|
199
|
+
}
|
|
200
|
+
if (written === 0) throw fail("unsupported-format", "This browser can write none of the payload types.");
|
|
201
|
+
return rich.write([new rich.Item(record)]);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
/** The default adapter: async Clipboard API with feature detection and honest errors. */
|
|
206
|
+
function createBrowserClipboardAdapter(options = {}) {
|
|
207
|
+
const getEnvironment = options.getEnvironment ?? defaultEnvironment;
|
|
208
|
+
const settings = {
|
|
209
|
+
degradeHtmlToText: options.degradeHtmlToText ?? true,
|
|
210
|
+
legacyFallback: options.legacyFallback ?? true
|
|
211
|
+
};
|
|
212
|
+
return { write: (payload, context) => writeToClipboard(payload, getEnvironment(), settings, context) };
|
|
213
|
+
}
|
|
214
|
+
//#endregion
|
|
215
|
+
export { createBrowserClipboardAdapter as t };
|
|
216
|
+
|
|
217
|
+
//# sourceMappingURL=clipboard-adapter-0haPt4jJ.js.map
|