react-smart-copy 1.8.1 → 1.10.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 CHANGED
@@ -20,11 +20,13 @@ Phone +91 98xxx xxxxx [Copy]
20
20
  ID PLT-29018 [Copy]
21
21
  ```
22
22
 
23
- - **~3.2 kB** for `useCopy`, **~5.4 kB** for everything copy (min + brotli), zero runtime dependencies
23
+ - **~3.5 kB** for `useCopy`, **~5.6 kB** for everything copy (min + brotli), zero runtime dependencies
24
24
  - Copy text, rich HTML (with plain-text fallback), PNG images, JSON, multi-format
25
25
  - **Paste** text, HTML and screenshots with `usePaste`: a Paste button or Ctrl/⌘+V, no permission prompt for keyboard paste
26
26
  - **`<CopyGroup>`**: only one row shows "Copied" at a time
27
27
  - **`useCopyInterceptor`**: control what Ctrl/⌘+C copies from your page — attribution, redaction, Excel-ready tables, no-copy zones
28
+ - **`react-smart-copy/table`**: copy rows that paste into Excel and Google Sheets as cells, and read pasted ranges back as typed records. Works with AG Grid, TanStack Table and any `<table>`
29
+ - **`react-smart-copy/structured`**: copy your own objects and paste them back as the same typed, validated objects in another tab or app, the way design tools do. Versioned, with migrations, and works with Zod, Valibot or ArkType
28
30
  - **`react-smart-copy/capture`**: copy an `<svg>` or any piece of your UI as a PNG
29
31
  - Every failure is a typed, classified error. Nothing silently no-ops
30
32
  - Unstyled. Works with Tailwind, CSS modules, CSS-in-JS, shadcn, MUI, Ant Design
@@ -40,7 +42,9 @@ This package only promises what browsers actually support.
40
42
  | Rich HTML | ✅ | Always paired with a required plain-text fallback. Degrades to text when `ClipboardItem` is missing |
41
43
  | Images | ✅ PNG only | `image/png` is the only format with reliable cross-browser write support. Convert with `canvas.toBlob(cb, 'image/png')` |
42
44
  | JSON | ✅ | Serialised to text. JSON is not a native clipboard format |
45
+ | Tables (Excel, Sheets, Docs) | ✅ | `react-smart-copy/table`: an HTML table plus tab-separated text in one entry. Pasting reads both back |
43
46
  | Several formats at once | ✅ | `kind: 'multi'`; each MIME type is checked with `ClipboardItem.supports()` first |
47
+ | Your app's own data (typed) | ✅ | `react-smart-copy/structured`: a web custom format, a custom type and an HTML envelope, so every browser and paste path gets one |
44
48
  | SVG (icons, charts, logos) | ✅ as PNG | `svgToPngBlob()` from `react-smart-copy/capture` rasterises natively, no dependency. Raw SVG is not a clipboard image format |
45
49
  | A section of your UI as an image | ✅ bring a rasteriser | Browsers have no "screenshot this element" API. `captureElement()` wraps one you choose (e.g. `modern-screenshot`) with limits and checks |
46
50
  | Files (PDF, DOCX, ZIP) | ❌ | Not writable to the system clipboard by any browser API |
@@ -161,6 +165,12 @@ copy({
161
165
  copy(() => editor.getValue()); // resolved at click time, always the latest value
162
166
  ```
163
167
 
168
+ A `multi` item can be marked `optional: true`: it is written only when `ClipboardItem.supports()`
169
+ confirms its type, and skipped otherwise instead of failing the copy. That is how a web custom
170
+ format (`"web application/vnd.acme.rows+json"`, Chromium) rides along with HTML and text that
171
+ every browser writes. Copy and drag events skip web custom formats, which only the async
172
+ Clipboard API can write.
173
+
164
174
  ### Copying an image, including a piece of your UI
165
175
 
166
176
  Pass a **function** that produces the Blob. It is called synchronously inside the click,
@@ -406,6 +416,196 @@ const { unsubscribe } = registerDragCopy(element, () => ({
406
416
  > `useDragCopy` writes to the `DataTransfer` when the user drags an element. Use them
407
417
  > together if your UI supports both flows.
408
418
 
419
+ ## Tables: Excel, Google Sheets, AG Grid, TanStack
420
+
421
+ `react-smart-copy/table` copies rows so they land as cells in Excel, Google Sheets, Numbers
422
+ and LibreOffice, and as a real table in Docs, Word, Notion and mail. It also reads ranges
423
+ pasted from those apps back into rows and typed records. It has no dependencies, works
424
+ without React, and tree-shakes to what you use (about 1.9 kB for copying).
425
+
426
+ ```tsx
427
+ import { useCopy } from "react-smart-copy";
428
+ import { fromRows, tablePayload } from "react-smart-copy/table";
429
+
430
+ function CopyInvoices({ invoices }: { invoices: Invoice[] }) {
431
+ const { copy, status } = useCopy();
432
+ return (
433
+ <button
434
+ type="button"
435
+ onClick={() =>
436
+ void copy(() =>
437
+ tablePayload(
438
+ fromRows(invoices, [
439
+ { header: "Invoice", value: "id" },
440
+ { header: "Amount", value: "amount" }, // stays a number in Excel
441
+ { header: "Due", value: (row) => row.due.toLocaleDateString() },
442
+ ]),
443
+ ),
444
+ )
445
+ }
446
+ >
447
+ {status === "copied" ? "Copied" : "Copy as table"}
448
+ </button>
449
+ );
450
+ }
451
+ ```
452
+
453
+ `tablePayload` returns an ordinary `html` payload: an HTML `<table>` with tab-separated text
454
+ as its fallback. That means it works everywhere a payload does: `copy()`, `useCopyInterceptor`
455
+ transforms and `useDragCopy` sources. Where rich copy is unavailable, the plain-text fallback
456
+ still pastes into cells.
457
+
458
+ **What survives the trip.** Cells keep their types. Numbers, bigints, booleans and dates stay
459
+ values the spreadsheet can calculate with, while strings are marked as text so Excel keeps
460
+ `00123`, `1/2` and `1E5` as written (`preserveText`). Tabs, quotes and line breaks inside cells
461
+ are quoted the way Excel quotes them. A one-column table ending in an empty cell keeps that
462
+ row. Use `formatCell` for your own number or date formats.
463
+
464
+ **Formula injection is off by default.** A text cell starting with `=`, `+`, `-`, `@`, a tab or
465
+ a line break (or their full-width forms) would run as a formula when pasted. Following OWASP's
466
+ CSV Injection guidance, such cells get a leading `'`, which spreadsheets read as "this is text".
467
+ Typed numbers are never touched, so `-5` passed as a number stays a number. Rich editors show
468
+ that apostrophe, so pass `formulaGuard: false` only for data you trust.
469
+
470
+ ### From your grid
471
+
472
+ ```tsx
473
+ import { fromAgGrid, fromTanStackTable, fromTableElement } from "react-smart-copy/table";
474
+
475
+ // AG Grid v31+ (Community or Enterprise): selected rows in on-screen order.
476
+ copy(() => tablePayload(fromAgGrid(gridRef.current!.api, { rows: "selected" })));
477
+
478
+ // TanStack Table v8 or v9, in any framework adapter, and libraries built on it
479
+ // such as Material React Table and Mantine React Table.
480
+ copy(() => tablePayload(fromTanStackTable(table, { rows: "selected" })));
481
+
482
+ // Any library that renders a real <table>.
483
+ copy(() => tablePayload(fromTableElement(containerRef.current!)));
484
+ ```
485
+
486
+ | Adapter | Rows | Columns and values |
487
+ | ------------------- | -------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- |
488
+ | `fromAgGrid` | `displayed` (default), `selected`, `filtered`, `all`, or row nodes | Displayed columns minus the selection and row-number columns. `values: "auto"` keeps numbers raw and formats the rest |
489
+ | `fromTanStackTable` | `visible` (default: what `getRowModel()` renders), `selected`, or rows | Visible columns that hold data; display columns such as checkboxes are skipped. `header` and `value` overrides |
490
+ | `fromTableElement` | Every visible row of the first table | Merged cells, `<br>` line breaks, hidden rows and cells handled |
491
+ | `fromRows` | Your objects | You choose: a property (type-checked to hold a cell) or a function |
492
+
493
+ AG Grid ships clipboard support only in Enterprise. This gives Community grids Excel-ready
494
+ copy; for Ctrl/⌘+C, call it from `onCellKeyDown`:
495
+
496
+ ```tsx
497
+ onCellKeyDown={(event) => {
498
+ const key = event.event as KeyboardEvent | null;
499
+ if (!key || !(key.ctrlKey || key.metaKey) || key.key.toLowerCase() !== "c") return;
500
+ const selected = event.api.getSelectedNodes().length > 0;
501
+ void copy(() => tablePayload(fromAgGrid(event.api, selected ? { rows: "selected" } : { rows: [event.node] })));
502
+ }}
503
+ ```
504
+
505
+ ### Pasting a range from Excel or Google Sheets
506
+
507
+ ```tsx
508
+ import { usePaste } from "react-smart-copy";
509
+ import { parseTable, toRecords } from "react-smart-copy/table";
510
+
511
+ const { targetProps } = usePaste<HTMLDivElement>({
512
+ accept: ["html", "text"], // the HTML flavour keeps merged cells and line breaks exact
513
+ onPaste: (result) => {
514
+ const table = parseTable(result, { headers: true });
515
+ if (!table) return;
516
+ const { records, missing, errors } = toRecords(table, {
517
+ email: { header: ["Email", "E-mail"], required: true },
518
+ seats: { header: "Seats", parse: (text) => Number.parseInt(text, 10) },
519
+ });
520
+ // records: { email: string | undefined; seats: number | undefined }[]
521
+ },
522
+ });
523
+ ```
524
+
525
+ `parseTable` reads the HTML flavour when it holds a table (Excel, Google Sheets, Word and web
526
+ pages all write one) and falls back to tab-separated text, which is also what it uses on the
527
+ server. Pasted HTML is parsed in an inert document: scripts never run and nothing is fetched.
528
+ Every limit is explicit: `maxRows` (100,000), `maxColumns` (16,384, Excel's own), `maxCells`
529
+ (1,000,000) and `maxLength` (32 MiB). Content beyond them sets `truncated: true` instead of
530
+ being dropped silently, and merged cells are counted too, so a tiny document can't claim
531
+ millions of cells. `toRecords` matches headers ignoring case, spacing and full-width forms,
532
+ reports `missing` required columns and every cell whose `parse` threw, and never stops at the
533
+ first bad row.
534
+
535
+ ## Structured data: copy objects, paste typed objects
536
+
537
+ `react-smart-copy/structured` puts your app's own data on the clipboard: invoice rows, a
538
+ dashboard widget, a form's configuration, a set of shapes. Paste it in another tab, another
539
+ window or another of your apps and you get the same typed objects back, validated against
540
+ your schema. Text editors, chat and mail get readable text and HTML instead. No dependencies,
541
+ about 1.9 kB for the copy side.
542
+
543
+ ```tsx
544
+ import { z } from "zod"; // or Valibot, ArkType, any Standard Schema, or a plain function
545
+ import { useCopy, usePaste } from "react-smart-copy";
546
+ import { clipAccept, clipPayload, defineClipFormat, readClip } from "react-smart-copy/structured";
547
+
548
+ // Define each format once and share it between the copying and the pasting code.
549
+ export const InvoiceRows = defineClipFormat({
550
+ id: "acme.invoice-rows", // namespaced, stable: it names the clipboard type
551
+ version: 2,
552
+ schema: z.array(z.object({ id: z.string(), amount: z.number(), issued: z.coerce.date() })),
553
+ migrate: { 1: (rows) => upgradeFromV1(rows) }, // data from older deployments still pastes
554
+ text: (rows) => rows.map((row) => `${row.id}\t${row.amount}`).join("\n"),
555
+ });
556
+
557
+ function CopyRows({ rows }: { rows: Invoice[] }) {
558
+ const { copy } = useCopy();
559
+ return <button onClick={() => void copy(() => clipPayload(InvoiceRows, rows))}>Copy rows</button>;
560
+ }
561
+
562
+ function PasteRows({ onRows }: { onRows: (rows: Invoice[]) => void }) {
563
+ const { paste, targetProps } = usePaste<HTMLDivElement>({
564
+ accept: [...clipAccept(InvoiceRows), "text"],
565
+ onPaste: async (result) => {
566
+ const clip = await readClip(result, InvoiceRows);
567
+ switch (clip.status) {
568
+ case "ok": return onRows(clip.value); // typed, validated, migrated
569
+ case "invalid": return report(clip.issues); // [{ message, path }]
570
+ case "unsupported-version": return askToReload(); // written by a newer deployment
571
+ case "absent": return; // not ours: handle result.text if you like
572
+ }
573
+ },
574
+ });
575
+ return <div {...targetProps} tabIndex={0}>Paste rows here <button onClick={() => void paste()}>Paste</button></div>;
576
+ }
577
+ ```
578
+
579
+ `clipPayload` works everywhere a payload does: `copy()`, a `useCopyInterceptor` transform (so
580
+ Ctrl/⌘+C on selected rows copies the objects) and a `useDragCopy` source. `readClip` reads from a
581
+ `PasteResult` (paste button, Ctrl/⌘+V, drops, `PasteField`), a raw `DataTransfer` or a payload.
582
+ Use `readClipSync` when you need the answer synchronously and your schema is synchronous.
583
+
584
+ **Why three carriers.** No single clipboard entry survives every path in every browser, so each
585
+ copy writes three and `readClip` takes the first that holds this format:
586
+
587
+ | Carrier | Written by | Read back by |
588
+ | ------- | ---------- | ------------ |
589
+ | `web application/vnd.<id>+json` | `copy()` in Chromium | the paste button (`clipboard.read()`), also across origins. Hidden from paste events |
590
+ | `application/vnd.<id>+json` | copy interceptor, drag | Ctrl/⌘+V and drops. Hidden from `clipboard.read()` |
591
+ | hidden envelope in `text/html` | every path | every path, every browser, including Safari and Firefox |
592
+
593
+ **Security.** The clipboard is untrusted input: any page or app can put any format on it, so
594
+ the data is never trusted, only checked.
595
+
596
+ - Each carrier is size-checked (`maxBytes`, default 8 MiB) before it is parsed or decoded
597
+ - Own `__proto__` keys are dropped while parsing, so merging pasted data can't swap a prototype
598
+ - Migrations run on untrusted data, then the schema validates the result; nothing unvalidated reaches `clip.value`
599
+ - The HTML carrier is found with a strict token match on a closed alphabet (`id;base64url`): no HTML parsing, no DOM
600
+ - Reading never throws for clipboard content: every outcome is a result
601
+ - The data is **not authenticated**. Validate it as you would a form submission, and check permissions server-side
602
+ - The HTML envelope travels wherever the HTML is pasted (a mail, a document), hidden but readable. Copy only what the user may share, or set `embedInHtml: false` (keyboard paste in Chromium and drops still work through the custom type)
603
+
604
+ **Copying is strict too.** The data must survive `JSON.stringify` unchanged: `NaN`, `Infinity`,
605
+ `BigInt`, `Map`, `Set`, functions and symbols throw an `invalid-payload` error naming the key
606
+ instead of turning silently into `null` or `{}`. Dates become ISO strings, so read them back with a
607
+ coercing schema (`z.coerce.date()`), or convert in `encode`.
608
+
409
609
  ## Only one "Copied" at a time
410
610
 
411
611
  Wrap a table or list in `<CopyGroup>`. A new successful copy returns the previously copied
@@ -499,6 +699,8 @@ Custom adapters resolve without `imageFiles` (`PasteReadResult`); the machine de
499
699
  - `accept` defaults to `['text']`. Ask for `'html'`, `'image'`, exact types like `'application/pdf'`, or `'image/*'` explicitly
500
700
  - Images are verified from their bytes (PNG, JPEG, GIF, WebP, AVIF, BMP); a "PNG" that isn't one is dropped
501
701
  - SVG is never matched by a wildcard, it must be listed exactly as `'image/svg+xml'` (it is scriptable XML)
702
+ - Application data is never matched by a wildcard either: web custom formats (`'web application/vnd.acme.rows+json'`)
703
+ and `+json` types must be listed exactly, and arrive as strings. `clipAccept()` lists them for you
502
704
  - `maxBytes` (default 32 MiB) and `maxItems` (default 32) are enforced before anything is decoded.
503
705
  `maxBytes` counts UTF-8 bytes on every path, so `'日本'` costs 6 bytes whether it arrives
504
706
  from a paste event, `readText()` or `read()`
@@ -835,7 +1037,8 @@ Plain text works wherever `navigator.clipboard.writeText` exists: Chromium 66+,
835
1037
  Safari 13.1+. Rich HTML, PNG images and multi-format need `ClipboardItem`: Chromium 86+,
836
1038
  Safari 13.1+, Firefox 127+. Keyboard paste (`targetProps`, `listenOnDocument`) and drag-and-drop
837
1039
  (`dropTargetProps`, `PasteField.Zone`) work in every modern browser. The Paste button needs `navigator.clipboard.readText` (Chromium 66+, Safari 13.1+,
838
- Firefox 125+) or `read()` for images (Chromium 86+, Safari 13.1+, Firefox 127+). Check MDN for
1040
+ Firefox 125+) or `read()` for images (Chromium 86+, Safari 13.1+, Firefox 127+). Web custom formats
1041
+ (`react-smart-copy/structured`'s first carrier) need Chromium 104+; elsewhere the HTML carrier is used. Check MDN for
839
1042
  embedded webviews. Where a capability is missing you get a typed error, never a silent success.
840
1043
 
841
1044
  ## Roadmap
@@ -846,9 +1049,11 @@ embedded webviews. Where a capability is missing you get a typed error, never a
846
1049
  - ~~**1.2** Paste `retry()`, cancellation with `AbortSignal`, `PasteField.Preview`~~ shipped
847
1050
  - ~~**1.3** `onReset` / `onCancel` callbacks, UTF-8 `maxBytes` on every paste path, `PasteResult.imageFiles`~~ shipped
848
1051
  - ~~**1.4** Drag-and-drop through the paste pipeline: `dropTargetProps`, `isDragOver`, droppable `PasteField.Zone`~~ shipped
849
- - ~~**1.5** `react-smart-copy/testing` — mock adapters and result builders so consumer tests stay green across releases~~ shipped
1052
+ - ~~**1.6** `react-smart-copy/testing` — mock adapters and result builders so consumer tests stay green across releases~~ shipped
850
1053
  - ~~**1.7** `useCopyInterceptor` / `registerCopyInterceptor` — attribution, redaction and no-copy zones for native Ctrl/⌘+C~~ shipped
851
1054
  - ~~**1.8** `useDragCopy` / `registerDragCopy` — populate `DataTransfer` on drag-start; no Clipboard API needed~~ shipped
1055
+ - ~~**1.9** `react-smart-copy/table` — Excel- and Sheets-ready copy and paste, AG Grid and TanStack Table adapters, typed record import~~ shipped
1056
+ - **1.10** `react-smart-copy/structured` — typed, versioned, validated application data on the clipboard
852
1057
 
853
1058
  Full history: [CHANGELOG.md](./CHANGELOG.md) or the [Releases page](https://suprabhat02.github.io/react-smart-copy/#releases).
854
1059
 
@@ -856,7 +1061,7 @@ Full history: [CHANGELOG.md](./CHANGELOG.md) or the [Releases page](https://supr
856
1061
 
857
1062
  ```bash
858
1063
  npm install
859
- npm run verify # lint, types, 638 tests at 100% coverage, build, publint + attw, size budgets
1064
+ npm run verify # lint, types, 988 tests at 100% coverage, build, publint + attw, size budgets
860
1065
  npm run changeset # describe your change for the changelog
861
1066
  npm run site:preview # docs site at http://localhost:3000
862
1067
  ```
@@ -1 +1 @@
1
- {"version":3,"file":"capture.cjs","names":[],"sources":["../src/core/errors.ts","../src/capture/environment.ts","../src/capture/options.ts","../src/core/mime.ts","../src/core/payload.ts","../src/capture/deadline.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import type { PasteSource } from './paste-reader';\n\n/**\n * Every way a clipboard operation can fail, as a closed union.\n *\n * `CopyError.message` is developer-facing (logs, telemetry). For user-facing\n * text use {@link describeCopyError} / {@link describePasteError}, or map\n * `type` through your own i18n layer.\n */\nexport type CopyErrorType =\n /** No Clipboard API (old browser, server, locked-down webview). Not retryable. */\n | 'unsupported'\n /** Page is not served over HTTPS/localhost. Not retryable. */\n | 'insecure-context'\n /** Browser or user blocked the operation. Also what Safari reports for a missing user gesture. */\n | 'permission-denied'\n /** The document lost focus mid-operation (Chromium). Retrying after refocus usually works. */\n | 'not-focused'\n /** Empty or malformed payload, or a lazy source that threw. Caught before touching the clipboard. */\n | 'invalid-payload'\n /** The browser cannot handle this MIME type (e.g. non-PNG image, HTML without ClipboardItem). */\n | 'unsupported-format'\n /** A lazy image source (or capture) threw, rejected or did not produce a Blob. */\n | 'blob-generation-failed'\n /** `retry()` was called after `maxRetries` was reached. Terminal. */\n | 'max-retries-exceeded'\n /** Paste: the clipboard held nothing matching `accept`. */\n | 'no-content'\n /** Content exceeded a configured safety limit (bytes, items or pixels). Not retryable. */\n | 'too-large'\n /** An operation did not settle within its deadline. Retryable. */\n | 'timeout'\n /** The caller aborted the operation through an `AbortSignal`. Not retryable. */\n | 'aborted'\n /** Anything the platform threw that we could not classify. */\n | 'unknown';\n\n/** Which clipboard direction failed; only changes developer-facing messages. */\nexport type ClipboardOperation = 'write' | 'read';\n\nexport interface CopyError {\n readonly type: CopyErrorType;\n readonly message: string;\n readonly cause?: unknown;\n}\n\nexport function createCopyError(type: CopyErrorType, message: string, cause?: unknown): CopyError {\n return cause === undefined ? { type, message } : { type, message, cause };\n}\n\nconst RETRYABLE_ERRORS: ReadonlySet<CopyErrorType> = /* @__PURE__ */ new Set<CopyErrorType>([\n 'permission-denied',\n 'not-focused',\n 'blob-generation-failed',\n 'timeout',\n 'unknown',\n]);\n\n/** Whether retrying the same payload could plausibly succeed. */\nexport function isRetryableError(error: CopyError): boolean {\n return RETRYABLE_ERRORS.has(error.type);\n}\n\n/**\n * Branded (not `instanceof`) so failures stay recognisable even when the core\n * is bundled twice, e.g. `react-smart-copy` and `react-smart-copy/core` together.\n */\nconst COPY_FAILURE_BRAND = Symbol.for('react-smart-copy.CopyFailure');\n\n/** Error thrown by adapters to carry a fully classified {@link CopyError}. */\nexport class CopyFailure extends Error {\n readonly copyError: CopyError;\n readonly [COPY_FAILURE_BRAND] = true;\n\n constructor(copyError: CopyError) {\n super(copyError.message);\n this.name = 'CopyFailure';\n this.copyError = copyError;\n }\n}\n\nexport function isCopyFailure(value: unknown): value is CopyFailure {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as Record<PropertyKey, unknown>)[COPY_FAILURE_BRAND] === true\n );\n}\n\n/** Shorthand for throwing a classified failure. */\nexport function copyFailure(type: CopyErrorType, message: string, cause?: unknown): CopyFailure {\n return new CopyFailure(createCopyError(type, message, cause));\n}\n\nfunction readString(value: unknown, key: string): string | undefined {\n if (typeof value !== 'object' || value === null) return undefined;\n const field = (value as Record<string, unknown>)[key];\n return typeof field === 'string' ? field : undefined;\n}\n\n/**\n * Classifies anything thrown by the platform or an adapter into a {@link CopyError}.\n * `operation` only tailors the developer-facing message.\n */\nexport function toCopyError(cause: unknown, operation: ClipboardOperation = 'write'): CopyError {\n if (isCopyFailure(cause)) return cause.copyError;\n\n const name = readString(cause, 'name');\n const message = readString(cause, 'message') ?? '';\n const verb = operation === 'read' ? 'read' : 'write';\n\n switch (name) {\n case 'NotAllowedError':\n return /focus/i.test(message)\n ? createCopyError('not-focused', `The document was not focused during the clipboard ${verb}.`, cause)\n : createCopyError('permission-denied', `Clipboard ${verb} permission was denied.`, cause);\n case 'SecurityError':\n return createCopyError('insecure-context', 'The clipboard is blocked in this context.', cause);\n case 'NotSupportedError':\n case 'DataError':\n return createCopyError('unsupported-format', 'The browser rejected this clipboard format.', cause);\n case 'AbortError':\n return createCopyError('aborted', `The clipboard ${verb} was aborted.`, cause);\n case 'TimeoutError':\n return createCopyError('timeout', `The clipboard ${verb} timed out.`, cause);\n default:\n return createCopyError('unknown', message || `The clipboard ${verb} failed for an unknown reason.`, cause);\n }\n}\n\nconst COPY_DESCRIPTIONS: Readonly<Record<CopyErrorType, string>> = {\n unsupported: \"Copying isn't supported in this browser.\",\n 'insecure-context': 'Copying requires a secure (HTTPS) connection.',\n 'permission-denied': 'Clipboard access was blocked. Allow it and try again.',\n 'not-focused': 'The page lost focus while copying. Try again.',\n 'invalid-payload': 'There is nothing to copy.',\n 'unsupported-format': \"This content can't be copied in this browser.\",\n 'blob-generation-failed': \"The image couldn't be prepared for copying.\",\n 'max-retries-exceeded': 'Copying failed after several attempts.',\n 'no-content': 'There is nothing to copy.',\n 'too-large': 'This content is too large to copy.',\n timeout: 'Copying took too long. Try again.',\n aborted: 'Copying was cancelled.',\n unknown: \"Couldn't copy to the clipboard. Try again.\",\n};\n\nconst PASTE_DESCRIPTIONS: Readonly<Record<CopyErrorType, string>> = {\n unsupported: \"Pasting isn't supported in this browser.\",\n 'insecure-context': 'Pasting requires a secure (HTTPS) connection.',\n 'permission-denied': 'Clipboard access was blocked. Allow it and try again.',\n 'not-focused': 'The page lost focus while pasting. Try again.',\n 'invalid-payload': \"The clipboard content couldn't be read.\",\n 'unsupported-format': \"This clipboard content isn't supported here.\",\n 'blob-generation-failed': \"The pasted image couldn't be read.\",\n 'max-retries-exceeded': 'Pasting failed after several attempts.',\n 'no-content': \"The clipboard doesn't contain anything that can be pasted here.\",\n 'too-large': 'The clipboard content is too large to paste.',\n timeout: 'Pasting took too long. Try again.',\n aborted: 'Pasting was cancelled.',\n unknown: \"Couldn't read the clipboard. Try again.\",\n};\n\n/** Default English, user-facing sentence for a copy error. Replace for i18n. */\nexport function describeCopyError(error: CopyError): string {\n return COPY_DESCRIPTIONS[error.type];\n}\n\n/** Drops can only fail in these ways; the rest of the paste wording would mention the clipboard. */\nconst DROP_DESCRIPTIONS: Readonly<Partial<Record<CopyErrorType, string>>> = {\n 'invalid-payload': \"The dropped content couldn't be read.\",\n 'no-content': 'Nothing that was dropped can be used here.',\n 'too-large': 'The dropped content is too large.',\n unknown: \"Couldn't read the dropped content. Try again.\",\n};\n\n/**\n * Default English, user-facing sentence for a paste error. Pass the error\n * state's `source` to word drag-and-drop failures as drops. Replace for i18n.\n */\nexport function describePasteError(error: CopyError, source?: PasteSource): string {\n return (source === 'drop' ? DROP_DESCRIPTIONS[error.type] : undefined) ?? PASTE_DESCRIPTIONS[error.type];\n}\n","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","/**\n * MIME helpers shared by paste and capture. Everything that comes from the\n * clipboard is untrusted input, so types are normalised and validated before\n * they are compared, and image types are confirmed from the bytes themselves.\n */\n\n/** RFC 6838 token shape, lower-cased. Parameters (`;charset=…`) are stripped first. */\nconst MIME_SHAPE = /^[a-z0-9][a-z0-9!#$&^_.+-]{0,126}\\/[a-z0-9][a-z0-9!#$&^_.+-]{0,126}$/;\n\n/** SVG is XML that can carry scripts; it is never matched by a wildcard. */\nexport const SVG_MIME_TYPE = 'image/svg+xml';\n\n/** Lower-cased `type/subtype` without parameters, or `null` if it is not a valid MIME type. */\nexport function normalizeMimeType(value: string): string | null {\n const separator = value.indexOf(';');\n const base = (separator === -1 ? value : value.slice(0, separator)).trim().toLowerCase();\n return MIME_SHAPE.test(base) ? base : null;\n}\n\n/**\n * Does `mimeType` (already normalised) match `pattern` (`type/subtype`, `type/*` or `*\\/*`)?\n * Wildcards never match `image/svg+xml`: accepting SVG must be explicit.\n */\nexport function matchesMimePattern(mimeType: string, pattern: string): boolean {\n if (pattern === mimeType) return true;\n if (mimeType === SVG_MIME_TYPE) return false;\n if (pattern === '*/*') return true;\n return pattern.endsWith('/*') && mimeType.startsWith(pattern.slice(0, -1));\n}\n\n/** Types whose clipboard data is text and is therefore surfaced as a `string`. */\nexport function isTextualMimeType(mimeType: string): boolean {\n return (\n mimeType.startsWith('text/') ||\n mimeType === SVG_MIME_TYPE ||\n mimeType === 'application/json' ||\n mimeType === 'application/xml'\n );\n}\n\n/** Raster image formats recognised from their leading bytes. */\nexport type RasterImageMimeType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'image/bmp' | 'image/avif';\n\nconst SNIFF_BYTES = 16;\n\nfunction startsWith(bytes: Uint8Array, signature: readonly number[], offset = 0): boolean {\n return signature.every((byte, index) => bytes[offset + index] === byte);\n}\n\nconst ascii = (text: string): number[] => Array.from(text, (char) => char.charCodeAt(0));\n\nconst PNG = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\nconst JPEG = [0xff, 0xd8, 0xff];\nconst GIF = ascii('GIF8');\nconst RIFF = ascii('RIFF');\nconst WEBP = ascii('WEBP');\nconst BMP = ascii('BM');\nconst FTYP_AVIF = ascii('ftypavif');\nconst FTYP_AVIS = ascii('ftypavis');\n\n/** Identifies a raster image from its magic bytes, ignoring whatever type the Blob claims. */\nexport function sniffImageBytes(bytes: Uint8Array): RasterImageMimeType | null {\n if (startsWith(bytes, PNG)) return 'image/png';\n if (startsWith(bytes, JPEG)) return 'image/jpeg';\n if (startsWith(bytes, GIF)) return 'image/gif';\n if (startsWith(bytes, RIFF) && startsWith(bytes, WEBP, 8)) return 'image/webp';\n if (startsWith(bytes, FTYP_AVIF, 4) || startsWith(bytes, FTYP_AVIS, 4)) return 'image/avif';\n if (startsWith(bytes, BMP)) return 'image/bmp';\n return null;\n}\n\n/** Reads only the first bytes of a Blob, so sniffing a 20 MB screenshot stays cheap. */\nexport async function sniffImageType(blob: Blob): Promise<RasterImageMimeType | null> {\n const head = await blob.slice(0, SNIFF_BYTES).arrayBuffer();\n return sniffImageBytes(new Uint8Array(head));\n}\n","import { CopyFailure, createCopyError, type CopyError } from './errors';\nimport type { OperationContext } from './machine-shared';\n\n/** The only image MIME type with reliable cross-browser clipboard write support. */\nexport const IMAGE_MIME_TYPE = 'image/png';\n\n/**\n * An image as a Blob, a promise of one, or a function producing one.\n * Prefer the function form: it is invoked synchronously inside the user\n * gesture, which Safari requires for async image generation. The browser\n * adapter always passes an `OperationContext`: stop work once\n * `context.signal` aborts (reset, superseded, unmount). Optional in the type\n * so adapters that call sources themselves keep compiling.\n */\nexport type BlobSource = Blob | PromiseLike<Blob> | ((context?: OperationContext) => Blob | PromiseLike<Blob>);\n\nexport interface TextPayload {\n readonly kind: 'text';\n readonly value: string;\n}\n\nexport interface HtmlPayload {\n readonly kind: 'html';\n readonly html: string;\n /** Required plain-text fallback for targets that don't understand HTML. */\n readonly text: string;\n}\n\nexport interface ImagePayload {\n readonly kind: 'image';\n readonly blob: BlobSource;\n}\n\nexport interface JsonPayload {\n readonly kind: 'json';\n readonly value: unknown;\n /** `true` = 2-space indent, a number = that indent, falsy = compact. */\n readonly pretty?: boolean | number;\n}\n\nexport interface MultiPayloadItem {\n readonly mimeType: string;\n readonly data: string | Blob;\n}\n\nexport interface MultiPayload {\n readonly kind: 'multi';\n readonly items: readonly MultiPayloadItem[];\n}\n\nexport type CopyPayload = TextPayload | HtmlPayload | ImagePayload | JsonPayload | MultiPayload;\nexport type CopyPayloadKind = CopyPayload['kind'];\n\n/** A payload, or a bare string as shorthand for `{ kind: 'text' }`. */\nexport type CopyInput = string | CopyPayload;\n\n/**\n * What `copy()` accepts. The function form is resolved synchronously at copy\n * time, so it always reads the latest value without re-rendering.\n */\nexport type CopySource = CopyInput | (() => CopyInput);\n\nexport function normalizePayload(input: CopyInput): CopyPayload {\n return typeof input === 'string' ? { kind: 'text', value: input } : input;\n}\n\nexport function isBlob(value: unknown): value is Blob {\n if (typeof Blob !== 'undefined' && value instanceof Blob) return true;\n const tag = Object.prototype.toString.call(value);\n return tag === '[object Blob]' || tag === '[object File]';\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n return (\n (typeof value === 'object' || typeof value === 'function') &&\n value !== null &&\n typeof (value as { then?: unknown }).then === 'function'\n );\n}\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/**\n * Structural validation. Typed callers can't produce most of these states,\n * but plain-JS callers and runtime data can, so the check is always on.\n */\nexport function validatePayload(payload: unknown): CopyError | null {\n if (typeof payload !== 'object' || payload === null) {\n return invalid('Copy input must be a string or a payload object.');\n }\n const candidate = payload as Record<string, unknown>;\n\n switch (candidate['kind']) {\n case 'text':\n return typeof candidate['value'] === 'string' && candidate['value'].length > 0\n ? null\n : invalid('Text payload must be a non-empty string.');\n case 'html':\n if (typeof candidate['html'] !== 'string' || candidate['html'].length === 0) {\n return invalid('HTML payload requires a non-empty `html` string.');\n }\n return typeof candidate['text'] === 'string' && candidate['text'].length > 0\n ? null\n : invalid('HTML payload requires a non-empty plain-text `text` fallback.');\n case 'image': {\n const source = candidate['blob'];\n return isBlob(source) || typeof source === 'function' || isThenable(source)\n ? null\n : invalid('Image payload requires a Blob, a Promise<Blob> or a function returning one.');\n }\n case 'json':\n return candidate['value'] === undefined ? invalid('JSON payload value is undefined.') : null;\n case 'multi': {\n const items = candidate['items'];\n if (!Array.isArray(items) || items.length === 0) {\n return invalid('Multi payload requires at least one item.');\n }\n const seen = new Set<string>();\n for (const item of items as unknown[]) {\n const entry = (typeof item === 'object' && item !== null ? item : {}) as Record<string, unknown>;\n const mimeType = entry['mimeType'];\n const data = entry['data'];\n if (typeof mimeType !== 'string' || mimeType.length === 0) {\n return invalid('Every multi item needs a non-empty `mimeType`.');\n }\n if (seen.has(mimeType)) return invalid(`Duplicate MIME type \"${mimeType}\" in multi payload.`);\n seen.add(mimeType);\n if (typeof data !== 'string' && !isBlob(data)) {\n return invalid(`Multi item \"${mimeType}\" must contain a string or a Blob.`);\n }\n }\n return null;\n }\n default:\n return invalid(`Unknown payload kind: ${String(candidate['kind'])}.`);\n }\n}\n\n/** Serialises a JSON payload, throwing a classified failure instead of a raw TypeError. */\nexport function serializeJson(payload: JsonPayload): string {\n const indent =\n payload.pretty === true ? 2 : typeof payload.pretty === 'number' ? payload.pretty : undefined;\n // Typed as `string` by lib.d.ts, but returns undefined for functions, symbols and undefined.\n let text: unknown;\n try {\n text = JSON.stringify(payload.value, null, indent);\n } catch (cause) {\n throw new CopyFailure(\n createCopyError('invalid-payload', 'JSON payload could not be serialised (circular reference or BigInt?).', cause),\n );\n }\n if (typeof text !== 'string') {\n throw new CopyFailure(\n createCopyError('invalid-payload', 'JSON payload serialised to nothing (functions, symbols and undefined are not JSON).'),\n );\n }\n return text;\n}\n","import { copyFailure, type CopyFailure } from '../core/errors';\n\nexport interface DeadlineOptions {\n readonly timeoutMs: number;\n readonly signal?: AbortSignal | undefined;\n /** Used in messages: \"<label> timed out\". */\n readonly label: string;\n}\n\n/**\n * Runs `task` with a timeout and an optional caller `AbortSignal`. The task\n * receives a signal that fires on either, so cooperative work can stop early.\n * Rejects with classified `timeout` / `aborted` failures.\n */\nexport function withDeadline<T>(task: (signal: AbortSignal) => PromiseLike<T> | T, options: DeadlineOptions): Promise<T> {\n const { timeoutMs, label } = options;\n const external = options.signal;\n if (external?.aborted) {\n return Promise.reject(copyFailure('aborted', `${label} was aborted.`, external.reason));\n }\n\n const controller = new AbortController();\n return new Promise<T>((resolve, reject) => {\n const finish = (abort: boolean): void => {\n clearTimeout(timer);\n external?.removeEventListener('abort', onAbort);\n // Always signal downstream cooperative work to stop — whether we timed\n // out, were aborted, or resolved successfully. Without this, a task\n // that started a long operation keeps that operation alive after we've\n // already resolved, leaking resources until GC.\n /* c8 ignore next -- abort=false path is never used; kept for future API flexibility */\n if (abort) controller.abort();\n };\n const fail = (failure: CopyFailure): void => {\n finish(true);\n reject(failure);\n };\n const onAbort = (): void => {\n fail(copyFailure('aborted', `${label} was aborted.`, (external as AbortSignal).reason));\n };\n const timer =\n timeoutMs === Infinity\n ? undefined\n : setTimeout(() => {\n fail(copyFailure('timeout', `${label} timed out after ${String(timeoutMs)} ms.`));\n }, timeoutMs);\n external?.addEventListener('abort', onAbort, { once: true });\n\n new Promise<T>((run) => {\n run(task(controller.signal));\n }).then(\n (value) => {\n finish(true);\n resolve(value);\n },\n (cause: unknown) => {\n finish(true);\n // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- classified by the caller\n reject(cause);\n },\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":";;AA8CA,SAAgB,gBAAgB,MAAqB,SAAiB,OAA4B;CAChG,OAAO,UAAU,KAAA,IAAY;EAAE;EAAM;CAAQ,IAAI;EAAE;EAAM;EAAS;CAAM;AAC1E;;;;;AAmBA,MAAM,qBAAqB,OAAO,IAAI,8BAA8B;;AAGpE,IAAa,cAAb,cAAiC,MAAM;CAIrC,YAAY,WAAsB;EAChC,MAAM,UAAU,OAAO;EAHzB,KAAU,sBAAsB;EAI9B,KAAK,OAAO;EACZ,KAAK,YAAY;CACnB;AACF;AAEA,SAAgB,cAAc,OAAsC;CAClE,OACE,OAAO,UAAU,YACjB,UAAU,QACT,MAAuC,wBAAwB;AAEpE;;AAGA,SAAgB,YAAY,MAAqB,SAAiB,OAA8B;CAC9F,OAAO,IAAI,YAAY,gBAAgB,MAAM,SAAS,KAAK,CAAC;AAC9D;;;AC5DA,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,OAAO,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,OAAO,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,OAAO,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,MAAM,YAAY,eAAe,sEAAsE;CAEzG,OAAO;AACT;;;AC7FA,MAAa,wBAAwB;AACrC,MAAa,oBAAoB;;AAEjC,MAAa,qBAAqB;AAClC,MAAa,6BAA6B;AAiC1C,MAAM,WAAW,YAAoB,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,MAAM,YACJ,aACA,KAAK,OAAO,KAAK,EAAE,GAAG,OAAO,MAAM,EAAE,qBAAqB,OAAO,SAAS,EAAE,sDAC9E;AAEJ;;;;ACpFA,MAAa,gBAAgB;AAiC7B,MAAM,cAAc;AAEpB,SAAS,WAAW,OAAmB,WAA8B,SAAS,GAAY;CACxF,OAAO,UAAU,OAAO,MAAM,UAAU,MAAM,SAAS,WAAW,IAAI;AACxE;AAEA,MAAM,SAAS,SAA2B,MAAM,KAAK,OAAO,SAAS,KAAK,WAAW,CAAC,CAAC;AAEvF,MAAM,MAAM;CAAC;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;CAAM;AAAI;AAC3D,MAAM,OAAO;CAAC;CAAM;CAAM;AAAI;AAC9B,MAAM,MAAM,MAAM,MAAM;AACxB,MAAM,OAAO,MAAM,MAAM;AACzB,MAAM,OAAO,MAAM,MAAM;AACzB,MAAM,MAAM,MAAM,IAAI;AACtB,MAAM,YAAY,MAAM,UAAU;AAClC,MAAM,YAAY,MAAM,UAAU;;AAGlC,SAAgB,gBAAgB,OAA+C;CAC7E,IAAI,WAAW,OAAO,GAAG,GAAG,OAAO;CACnC,IAAI,WAAW,OAAO,IAAI,GAAG,OAAO;CACpC,IAAI,WAAW,OAAO,GAAG,GAAG,OAAO;CACnC,IAAI,WAAW,OAAO,IAAI,KAAK,WAAW,OAAO,MAAM,CAAC,GAAG,OAAO;CAClE,IAAI,WAAW,OAAO,WAAW,CAAC,KAAK,WAAW,OAAO,WAAW,CAAC,GAAG,OAAO;CAC/E,IAAI,WAAW,OAAO,GAAG,GAAG,OAAO;CACnC,OAAO;AACT;;AAGA,eAAsB,eAAe,MAAiD;CACpF,MAAM,OAAO,MAAM,KAAK,MAAM,GAAG,WAAW,CAAC,CAAC,YAAY;CAC1D,OAAO,gBAAgB,IAAI,WAAW,IAAI,CAAC;AAC7C;;;;ACvEA,MAAa,kBAAkB;AA8D/B,SAAgB,OAAO,OAA+B;CACpD,IAAI,OAAO,SAAS,eAAe,iBAAiB,MAAM,OAAO;CACjE,MAAM,MAAM,OAAO,UAAU,SAAS,KAAK,KAAK;CAChD,OAAO,QAAQ,mBAAmB,QAAQ;AAC5C;;;;;;;;ACxDA,SAAgB,aAAgB,MAAmD,SAAsC;CACvH,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,WAAW,QAAQ;CACzB,IAAI,UAAU,SACZ,OAAO,QAAQ,OAAO,YAAY,WAAW,GAAG,MAAM,gBAAgB,SAAS,MAAM,CAAC;CAGxF,MAAM,aAAa,IAAI,gBAAgB;CACvC,OAAO,IAAI,SAAY,SAAS,WAAW;EACzC,MAAM,UAAU,UAAyB;GACvC,aAAa,KAAK;GAClB,UAAU,oBAAoB,SAAS,OAAO;;GAM9C,IAAI,OAAO,WAAW,MAAM;EAC9B;EACA,MAAM,QAAQ,YAA+B;GAC3C,OAAO,IAAI;GACX,OAAO,OAAO;EAChB;EACA,MAAM,gBAAsB;GAC1B,KAAK,YAAY,WAAW,GAAG,MAAM,gBAAiB,SAAyB,MAAM,CAAC;EACxF;EACA,MAAM,QACJ,cAAc,WACV,KAAA,IACA,iBAAiB;GACf,KAAK,YAAY,WAAW,GAAG,MAAM,mBAAmB,OAAO,SAAS,EAAE,KAAK,CAAC;EAClF,GAAG,SAAS;EAClB,UAAU,iBAAiB,SAAS,SAAS,EAAE,MAAM,KAAK,CAAC;EAE3D,IAAI,SAAY,QAAQ;GACtB,IAAI,KAAK,WAAW,MAAM,CAAC;EAC7B,CAAC,CAAC,CAAC,MACA,UAAU;GACT,OAAO,IAAI;GACX,QAAQ,KAAK;EACf,IACC,UAAmB;GAClB,OAAO,IAAI;GAEX,OAAO,KAAK;EACd,CACF;CACF,CAAC;AACH;;;;ACtDA,SAAgB,qBAAqB,OAAgB,OAAwB;CAC3E,OAAO,cAAc,KAAK,IAAI,QAAQ,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,MAAM,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,MAAM,eAAe,IAAI;CACxC,IAAI,WAAW,MACb,MAAM,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,MAAM,YAAY,0BAA0B,GAAG,MAAM,2BAA2B;CACnG,kBAAkB,KAAK,OAAO,KAAK,QAAQ,SAAS,SAAS;CAC7D,OAAO,KAAK,SAAA,cAA2B,OAAO,KAAK,MAAM,GAAG,KAAK,MAAM,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,MAAM,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,MAAM,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,MAAM,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,MAAM,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,MAAM,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,OAAO,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,IAAI,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,MAAM,YAAY,0BAA0B,kEAAkE;CAGhH,MAAM,QAAQ,SAAS,KAAK,MAAM;CAClC,IAAI,UAAU,MACZ,MAAM,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,MAAM,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,MAAM,YAAY,mBAAmB,4DAA4D;CAE5G,MAAM,EAAE,cAAc;CACtB,IAAI,CAAC,WAAW;EACd,IAAI,KAAK,cAAc,OAAO,OAAO,aAAa,MAAM,OAAO;EAC/D,MAAM,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,MAAM,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":[],"sources":["../src/core/errors.ts","../src/capture/environment.ts","../src/capture/options.ts","../src/core/mime.ts","../src/core/payload.ts","../src/capture/deadline.ts","../src/capture/render.ts","../src/capture/svg.ts","../src/capture/element.ts"],"sourcesContent":["import type { PasteSource } from './paste-reader';\n\n/**\n * Every way a clipboard operation can fail, as a closed union.\n *\n * `CopyError.message` is developer-facing (logs, telemetry). For user-facing\n * text use {@link describeCopyError} / {@link describePasteError}, or map\n * `type` through your own i18n layer.\n */\nexport type CopyErrorType =\n /** No Clipboard API (old browser, server, locked-down webview). Not retryable. */\n | 'unsupported'\n /** Page is not served over HTTPS/localhost. Not retryable. */\n | 'insecure-context'\n /** Browser or user blocked the operation. Also what Safari reports for a missing user gesture. */\n | 'permission-denied'\n /** The document lost focus mid-operation (Chromium). Retrying after refocus usually works. */\n | 'not-focused'\n /** Empty or malformed payload, or a lazy source that threw. Caught before touching the clipboard. */\n | 'invalid-payload'\n /** The browser cannot handle this MIME type (e.g. non-PNG image, HTML without ClipboardItem). */\n | 'unsupported-format'\n /** A lazy image source (or capture) threw, rejected or did not produce a Blob. */\n | 'blob-generation-failed'\n /** `retry()` was called after `maxRetries` was reached. Terminal. */\n | 'max-retries-exceeded'\n /** Paste: the clipboard held nothing matching `accept`. */\n | 'no-content'\n /** Content exceeded a configured safety limit (bytes, items or pixels). Not retryable. */\n | 'too-large'\n /** An operation did not settle within its deadline. Retryable. */\n | 'timeout'\n /** The caller aborted the operation through an `AbortSignal`. Not retryable. */\n | 'aborted'\n /** Anything the platform threw that we could not classify. */\n | 'unknown';\n\n/** Which clipboard direction failed; only changes developer-facing messages. */\nexport type ClipboardOperation = 'write' | 'read';\n\nexport interface CopyError {\n readonly type: CopyErrorType;\n readonly message: string;\n readonly cause?: unknown;\n}\n\nexport function createCopyError(type: CopyErrorType, message: string, cause?: unknown): CopyError {\n return cause === undefined ? { type, message } : { type, message, cause };\n}\n\nconst RETRYABLE_ERRORS: ReadonlySet<CopyErrorType> = /* @__PURE__ */ new Set<CopyErrorType>([\n 'permission-denied',\n 'not-focused',\n 'blob-generation-failed',\n 'timeout',\n 'unknown',\n]);\n\n/** Whether retrying the same payload could plausibly succeed. */\nexport function isRetryableError(error: CopyError): boolean {\n return RETRYABLE_ERRORS.has(error.type);\n}\n\n/**\n * Branded (not `instanceof`) so failures stay recognisable even when the core\n * is bundled twice, e.g. `react-smart-copy` and `react-smart-copy/core` together.\n */\nconst COPY_FAILURE_BRAND = Symbol.for('react-smart-copy.CopyFailure');\n\n/** Error thrown by adapters to carry a fully classified {@link CopyError}. */\nexport class CopyFailure extends Error {\n readonly copyError: CopyError;\n readonly [COPY_FAILURE_BRAND] = true;\n\n constructor(copyError: CopyError) {\n super(copyError.message);\n this.name = 'CopyFailure';\n this.copyError = copyError;\n }\n}\n\nexport function isCopyFailure(value: unknown): value is CopyFailure {\n return (\n typeof value === 'object' &&\n value !== null &&\n (value as Record<PropertyKey, unknown>)[COPY_FAILURE_BRAND] === true\n );\n}\n\n/** Shorthand for throwing a classified failure. */\nexport function copyFailure(type: CopyErrorType, message: string, cause?: unknown): CopyFailure {\n return new CopyFailure(createCopyError(type, message, cause));\n}\n\nfunction readString(value: unknown, key: string): string | undefined {\n if (typeof value !== 'object' || value === null) return undefined;\n const field = (value as Record<string, unknown>)[key];\n return typeof field === 'string' ? field : undefined;\n}\n\n/**\n * Classifies anything thrown by the platform or an adapter into a {@link CopyError}.\n * `operation` only tailors the developer-facing message.\n */\nexport function toCopyError(cause: unknown, operation: ClipboardOperation = 'write'): CopyError {\n if (isCopyFailure(cause)) return cause.copyError;\n\n const name = readString(cause, 'name');\n const message = readString(cause, 'message') ?? '';\n const verb = operation === 'read' ? 'read' : 'write';\n\n switch (name) {\n case 'NotAllowedError':\n return /focus/i.test(message)\n ? createCopyError('not-focused', `The document was not focused during the clipboard ${verb}.`, cause)\n : createCopyError('permission-denied', `Clipboard ${verb} permission was denied.`, cause);\n case 'SecurityError':\n return createCopyError('insecure-context', 'The clipboard is blocked in this context.', cause);\n case 'NotSupportedError':\n case 'DataError':\n return createCopyError('unsupported-format', 'The browser rejected this clipboard format.', cause);\n case 'AbortError':\n return createCopyError('aborted', `The clipboard ${verb} was aborted.`, cause);\n case 'TimeoutError':\n return createCopyError('timeout', `The clipboard ${verb} timed out.`, cause);\n default:\n return createCopyError('unknown', message || `The clipboard ${verb} failed for an unknown reason.`, cause);\n }\n}\n\nconst COPY_DESCRIPTIONS: Readonly<Record<CopyErrorType, string>> = {\n unsupported: \"Copying isn't supported in this browser.\",\n 'insecure-context': 'Copying requires a secure (HTTPS) connection.',\n 'permission-denied': 'Clipboard access was blocked. Allow it and try again.',\n 'not-focused': 'The page lost focus while copying. Try again.',\n 'invalid-payload': 'There is nothing to copy.',\n 'unsupported-format': \"This content can't be copied in this browser.\",\n 'blob-generation-failed': \"The image couldn't be prepared for copying.\",\n 'max-retries-exceeded': 'Copying failed after several attempts.',\n 'no-content': 'There is nothing to copy.',\n 'too-large': 'This content is too large to copy.',\n timeout: 'Copying took too long. Try again.',\n aborted: 'Copying was cancelled.',\n unknown: \"Couldn't copy to the clipboard. Try again.\",\n};\n\nconst PASTE_DESCRIPTIONS: Readonly<Record<CopyErrorType, string>> = {\n unsupported: \"Pasting isn't supported in this browser.\",\n 'insecure-context': 'Pasting requires a secure (HTTPS) connection.',\n 'permission-denied': 'Clipboard access was blocked. Allow it and try again.',\n 'not-focused': 'The page lost focus while pasting. Try again.',\n 'invalid-payload': \"The clipboard content couldn't be read.\",\n 'unsupported-format': \"This clipboard content isn't supported here.\",\n 'blob-generation-failed': \"The pasted image couldn't be read.\",\n 'max-retries-exceeded': 'Pasting failed after several attempts.',\n 'no-content': \"The clipboard doesn't contain anything that can be pasted here.\",\n 'too-large': 'The clipboard content is too large to paste.',\n timeout: 'Pasting took too long. Try again.',\n aborted: 'Pasting was cancelled.',\n unknown: \"Couldn't read the clipboard. Try again.\",\n};\n\n/** Default English, user-facing sentence for a copy error. Replace for i18n. */\nexport function describeCopyError(error: CopyError): string {\n return COPY_DESCRIPTIONS[error.type];\n}\n\n/** Drops can only fail in these ways; the rest of the paste wording would mention the clipboard. */\nconst DROP_DESCRIPTIONS: Readonly<Partial<Record<CopyErrorType, string>>> = {\n 'invalid-payload': \"The dropped content couldn't be read.\",\n 'no-content': 'Nothing that was dropped can be used here.',\n 'too-large': 'The dropped content is too large.',\n unknown: \"Couldn't read the dropped content. Try again.\",\n};\n\n/**\n * Default English, user-facing sentence for a paste error. Pass the error\n * state's `source` to word drag-and-drop failures as drops. Replace for i18n.\n */\nexport function describePasteError(error: CopyError, source?: PasteSource): string {\n return (source === 'drop' ? DROP_DESCRIPTIONS[error.type] : undefined) ?? PASTE_DESCRIPTIONS[error.type];\n}\n","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","/**\n * MIME helpers shared by paste and capture. Everything that comes from the\n * clipboard is untrusted input, so types are normalised and validated before\n * they are compared, and image types are confirmed from the bytes themselves.\n */\n\n/** RFC 6838 token shape, lower-cased. Parameters (`;charset=…`) are stripped first. */\nconst MIME_SHAPE = /^[a-z0-9][a-z0-9!#$&^_.+-]{0,126}\\/[a-z0-9][a-z0-9!#$&^_.+-]{0,126}$/;\n\n/** SVG is XML that can carry scripts; it is never matched by a wildcard. */\nexport const SVG_MIME_TYPE = 'image/svg+xml';\n\n/** Lower-cased `type/subtype` without parameters, or `null` if it is not a valid MIME type. */\nexport function normalizeMimeType(value: string): string | null {\n const separator = value.indexOf(';');\n const base = (separator === -1 ? value : value.slice(0, separator)).trim().toLowerCase();\n return MIME_SHAPE.test(base) ? base : null;\n}\n\n/** Prefix of the async Clipboard API's web custom formats (`web application/vnd.acme+json`). */\nexport const WEB_CUSTOM_FORMAT_PREFIX = 'web ';\n\n/** Whether a clipboard type is a web custom format (`web type/subtype`). */\nexport function isWebCustomFormat(type: string): boolean {\n return type.slice(0, 4).toLowerCase() === WEB_CUSTOM_FORMAT_PREFIX;\n}\n\n/**\n * Like {@link normalizeMimeType}, but also accepts web custom formats\n * (`web type/subtype`), returned as `web ` + the normalised MIME type.\n */\nexport function normalizeClipboardType(value: string): string | null {\n if (!isWebCustomFormat(value)) return normalizeMimeType(value);\n const inner = normalizeMimeType(value.slice(4));\n return inner === null ? null : WEB_CUSTOM_FORMAT_PREFIX + inner;\n}\n\n/**\n * Types a wildcard never matches, so accepting them must be explicit:\n * `image/svg+xml` (scriptable XML), web custom formats and structured `+json` types\n * (application-specific data that only the app that defined them should read).\n */\nfunction requiresExactMatch(mimeType: string): boolean {\n return mimeType === SVG_MIME_TYPE || isWebCustomFormat(mimeType) || mimeType.endsWith('+json');\n}\n\n/**\n * Does `mimeType` (already normalised) match `pattern` (`type/subtype`, `type/*` or `*\\/*`)?\n * Wildcards never match `image/svg+xml`, web custom formats or `+json` types: those must be listed exactly.\n */\nexport function matchesMimePattern(mimeType: string, pattern: string): boolean {\n if (pattern === mimeType) return true;\n if (requiresExactMatch(mimeType)) return false;\n if (pattern === '*/*') return true;\n return pattern.endsWith('/*') && mimeType.startsWith(pattern.slice(0, -1));\n}\n\n/** Types whose clipboard data is text and is therefore surfaced as a `string`. */\nexport function isTextualMimeType(mimeType: string): boolean {\n const type = isWebCustomFormat(mimeType) ? mimeType.slice(4) : mimeType;\n return (\n type.startsWith('text/') ||\n type === SVG_MIME_TYPE ||\n type === 'application/json' ||\n type === 'application/xml' ||\n type.endsWith('+json')\n );\n}\n\n/** Raster image formats recognised from their leading bytes. */\nexport type RasterImageMimeType = 'image/png' | 'image/jpeg' | 'image/gif' | 'image/webp' | 'image/bmp' | 'image/avif';\n\nconst SNIFF_BYTES = 16;\n\nfunction startsWith(bytes: Uint8Array, signature: readonly number[], offset = 0): boolean {\n return signature.every((byte, index) => bytes[offset + index] === byte);\n}\n\nconst ascii = (text: string): number[] => Array.from(text, (char) => char.charCodeAt(0));\n\nconst PNG = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];\nconst JPEG = [0xff, 0xd8, 0xff];\nconst GIF = ascii('GIF8');\nconst RIFF = ascii('RIFF');\nconst WEBP = ascii('WEBP');\nconst BMP = ascii('BM');\nconst FTYP_AVIF = ascii('ftypavif');\nconst FTYP_AVIS = ascii('ftypavis');\n\n/** Identifies a raster image from its magic bytes, ignoring whatever type the Blob claims. */\nexport function sniffImageBytes(bytes: Uint8Array): RasterImageMimeType | null {\n if (startsWith(bytes, PNG)) return 'image/png';\n if (startsWith(bytes, JPEG)) return 'image/jpeg';\n if (startsWith(bytes, GIF)) return 'image/gif';\n if (startsWith(bytes, RIFF) && startsWith(bytes, WEBP, 8)) return 'image/webp';\n if (startsWith(bytes, FTYP_AVIF, 4) || startsWith(bytes, FTYP_AVIS, 4)) return 'image/avif';\n if (startsWith(bytes, BMP)) return 'image/bmp';\n return null;\n}\n\n/** Reads only the first bytes of a Blob, so sniffing a 20 MB screenshot stays cheap. */\nexport async function sniffImageType(blob: Blob): Promise<RasterImageMimeType | null> {\n const head = await blob.slice(0, SNIFF_BYTES).arrayBuffer();\n return sniffImageBytes(new Uint8Array(head));\n}\n","import { CopyFailure, createCopyError, type CopyError } from './errors';\nimport type { OperationContext } from './machine-shared';\n\n/** The only image MIME type with reliable cross-browser clipboard write support. */\nexport const IMAGE_MIME_TYPE = 'image/png';\n\n/**\n * An image as a Blob, a promise of one, or a function producing one.\n * Prefer the function form: it is invoked synchronously inside the user\n * gesture, which Safari requires for async image generation. The browser\n * adapter always passes an `OperationContext`: stop work once\n * `context.signal` aborts (reset, superseded, unmount). Optional in the type\n * so adapters that call sources themselves keep compiling.\n */\nexport type BlobSource = Blob | PromiseLike<Blob> | ((context?: OperationContext) => Blob | PromiseLike<Blob>);\n\nexport interface TextPayload {\n readonly kind: 'text';\n readonly value: string;\n}\n\nexport interface HtmlPayload {\n readonly kind: 'html';\n readonly html: string;\n /** Required plain-text fallback for targets that don't understand HTML. */\n readonly text: string;\n}\n\nexport interface ImagePayload {\n readonly kind: 'image';\n readonly blob: BlobSource;\n}\n\nexport interface JsonPayload {\n readonly kind: 'json';\n readonly value: unknown;\n /** `true` = 2-space indent, a number = that indent, falsy = compact. */\n readonly pretty?: boolean | number;\n}\n\nexport interface MultiPayloadItem {\n /**\n * The MIME type, or a web custom format (`web application/vnd.acme+json`).\n * Web custom formats are only written by the async Clipboard API; copy and drag\n * events skip them.\n */\n readonly mimeType: string;\n readonly data: string | Blob;\n /**\n * Skip this item, instead of failing the copy, when the browser cannot write its type.\n * An optional item is only written when `ClipboardItem.supports()` confirms the type.\n * At least one item must be written.\n */\n readonly optional?: boolean;\n}\n\nexport interface MultiPayload {\n readonly kind: 'multi';\n readonly items: readonly MultiPayloadItem[];\n}\n\nexport type CopyPayload = TextPayload | HtmlPayload | ImagePayload | JsonPayload | MultiPayload;\nexport type CopyPayloadKind = CopyPayload['kind'];\n\n/** A payload, or a bare string as shorthand for `{ kind: 'text' }`. */\nexport type CopyInput = string | CopyPayload;\n\n/**\n * What `copy()` accepts. The function form is resolved synchronously at copy\n * time, so it always reads the latest value without re-rendering.\n */\nexport type CopySource = CopyInput | (() => CopyInput);\n\nexport function normalizePayload(input: CopyInput): CopyPayload {\n return typeof input === 'string' ? { kind: 'text', value: input } : input;\n}\n\nexport function isBlob(value: unknown): value is Blob {\n if (typeof Blob !== 'undefined' && value instanceof Blob) return true;\n const tag = Object.prototype.toString.call(value);\n return tag === '[object Blob]' || tag === '[object File]';\n}\n\nfunction isThenable(value: unknown): value is PromiseLike<unknown> {\n return (\n (typeof value === 'object' || typeof value === 'function') &&\n value !== null &&\n typeof (value as { then?: unknown }).then === 'function'\n );\n}\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/**\n * Structural validation. Typed callers can't produce most of these states,\n * but plain-JS callers and runtime data can, so the check is always on.\n */\nexport function validatePayload(payload: unknown): CopyError | null {\n if (typeof payload !== 'object' || payload === null) {\n return invalid('Copy input must be a string or a payload object.');\n }\n const candidate = payload as Record<string, unknown>;\n\n switch (candidate['kind']) {\n case 'text':\n return typeof candidate['value'] === 'string' && candidate['value'].length > 0\n ? null\n : invalid('Text payload must be a non-empty string.');\n case 'html':\n if (typeof candidate['html'] !== 'string' || candidate['html'].length === 0) {\n return invalid('HTML payload requires a non-empty `html` string.');\n }\n return typeof candidate['text'] === 'string' && candidate['text'].length > 0\n ? null\n : invalid('HTML payload requires a non-empty plain-text `text` fallback.');\n case 'image': {\n const source = candidate['blob'];\n return isBlob(source) || typeof source === 'function' || isThenable(source)\n ? null\n : invalid('Image payload requires a Blob, a Promise<Blob> or a function returning one.');\n }\n case 'json':\n return candidate['value'] === undefined ? invalid('JSON payload value is undefined.') : null;\n case 'multi': {\n const items = candidate['items'];\n if (!Array.isArray(items) || items.length === 0) {\n return invalid('Multi payload requires at least one item.');\n }\n const seen = new Set<string>();\n for (const item of items as unknown[]) {\n const entry = (typeof item === 'object' && item !== null ? item : {}) as Record<string, unknown>;\n const mimeType = entry['mimeType'];\n const data = entry['data'];\n if (typeof mimeType !== 'string' || mimeType.length === 0) {\n return invalid('Every multi item needs a non-empty `mimeType`.');\n }\n if (seen.has(mimeType)) return invalid(`Duplicate MIME type \"${mimeType}\" in multi payload.`);\n seen.add(mimeType);\n if (typeof data !== 'string' && !isBlob(data)) {\n return invalid(`Multi item \"${mimeType}\" must contain a string or a Blob.`);\n }\n }\n return null;\n }\n default:\n return invalid(`Unknown payload kind: ${String(candidate['kind'])}.`);\n }\n}\n\n/** Serialises a JSON payload, throwing a classified failure instead of a raw TypeError. */\nexport function serializeJson(payload: JsonPayload): string {\n const indent =\n payload.pretty === true ? 2 : typeof payload.pretty === 'number' ? payload.pretty : undefined;\n // Typed as `string` by lib.d.ts, but returns undefined for functions, symbols and undefined.\n let text: unknown;\n try {\n text = JSON.stringify(payload.value, null, indent);\n } catch (cause) {\n throw new CopyFailure(\n createCopyError('invalid-payload', 'JSON payload could not be serialised (circular reference or BigInt?).', cause),\n );\n }\n if (typeof text !== 'string') {\n throw new CopyFailure(\n createCopyError('invalid-payload', 'JSON payload serialised to nothing (functions, symbols and undefined are not JSON).'),\n );\n }\n return text;\n}\n","import { copyFailure, type CopyFailure } from '../core/errors';\n\nexport interface DeadlineOptions {\n readonly timeoutMs: number;\n readonly signal?: AbortSignal | undefined;\n /** Used in messages: \"<label> timed out\". */\n readonly label: string;\n}\n\n/**\n * Runs `task` with a timeout and an optional caller `AbortSignal`. The task\n * receives a signal that fires on either, so cooperative work can stop early.\n * Rejects with classified `timeout` / `aborted` failures.\n */\nexport function withDeadline<T>(task: (signal: AbortSignal) => PromiseLike<T> | T, options: DeadlineOptions): Promise<T> {\n const { timeoutMs, label } = options;\n const external = options.signal;\n if (external?.aborted) {\n return Promise.reject(copyFailure('aborted', `${label} was aborted.`, external.reason));\n }\n\n const controller = new AbortController();\n return new Promise<T>((resolve, reject) => {\n const finish = (abort: boolean): void => {\n clearTimeout(timer);\n external?.removeEventListener('abort', onAbort);\n // Always signal downstream cooperative work to stop — whether we timed\n // out, were aborted, or resolved successfully. Without this, a task\n // that started a long operation keeps that operation alive after we've\n // already resolved, leaking resources until GC.\n /* c8 ignore next -- abort=false path is never used; kept for future API flexibility */\n if (abort) controller.abort();\n };\n const fail = (failure: CopyFailure): void => {\n finish(true);\n reject(failure);\n };\n const onAbort = (): void => {\n fail(copyFailure('aborted', `${label} was aborted.`, (external as AbortSignal).reason));\n };\n const timer =\n timeoutMs === Infinity\n ? undefined\n : setTimeout(() => {\n fail(copyFailure('timeout', `${label} timed out after ${String(timeoutMs)} ms.`));\n }, timeoutMs);\n external?.addEventListener('abort', onAbort, { once: true });\n\n new Promise<T>((run) => {\n run(task(controller.signal));\n }).then(\n (value) => {\n finish(true);\n resolve(value);\n },\n (cause: unknown) => {\n finish(true);\n // eslint-disable-next-line @typescript-eslint/prefer-promise-reject-errors -- classified by the caller\n reject(cause);\n },\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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"}