react-smart-copy 1.26.0 → 1.26.1
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/dist/capture.cjs +4 -4
- package/dist/capture.cjs.map +1 -1
- package/dist/capture.js +4 -4
- package/dist/capture.js.map +1 -1
- package/dist/chunks/{clipboard-adapter-UIFc_Qso.cjs → clipboard-adapter-Bpuf5GmB.cjs} +3 -3
- package/dist/chunks/{clipboard-adapter-UIFc_Qso.cjs.map → clipboard-adapter-Bpuf5GmB.cjs.map} +1 -1
- package/dist/chunks/{clipboard-adapter-CmKDTFdO.js → clipboard-adapter-DyCmyZV9.js} +3 -3
- package/dist/chunks/{clipboard-adapter-CmKDTFdO.js.map → clipboard-adapter-DyCmyZV9.js.map} +1 -1
- package/dist/chunks/{contrast-C9d8QuaF.cjs → contrast-BatHkv8j.cjs} +2 -2
- package/dist/chunks/{contrast-C9d8QuaF.cjs.map → contrast-BatHkv8j.cjs.map} +1 -1
- package/dist/chunks/{contrast-DUaZq5SA.js → contrast-DnCunIr1.js} +2 -2
- package/dist/chunks/{contrast-DUaZq5SA.js.map → contrast-DnCunIr1.js.map} +1 -1
- package/dist/chunks/{core-D3GCO3yT.js → core-88XdCKaH.js} +5 -5
- package/dist/chunks/{core-D3GCO3yT.js.map → core-88XdCKaH.js.map} +1 -1
- package/dist/chunks/{core-t59Z4gdy.cjs → core-DF6jiigD.cjs} +5 -5
- package/dist/chunks/{core-t59Z4gdy.cjs.map → core-DF6jiigD.cjs.map} +1 -1
- package/dist/chunks/{deadline-j2hD7JKz.cjs → deadline-Cz6l-PDR.cjs} +14 -2
- package/dist/chunks/deadline-Cz6l-PDR.cjs.map +1 -0
- package/dist/chunks/{deadline-CbwnZ3Oq.js → deadline-DTAkra5B.js} +9 -3
- package/dist/chunks/deadline-DTAkra5B.js.map +1 -0
- package/dist/chunks/{errors-DFmEAC4E.cjs → errors-CF2EQNbc.cjs} +14 -2
- package/dist/chunks/errors-CF2EQNbc.cjs.map +1 -0
- package/dist/chunks/{errors-CT-FfUtU.js → errors-CGcMvbhJ.js} +9 -3
- package/dist/chunks/errors-CGcMvbhJ.js.map +1 -0
- package/dist/chunks/{field-B6SRWRbI.cjs → field-C8A5Yxln.cjs} +3 -3
- package/dist/chunks/{field-B6SRWRbI.cjs.map → field-C8A5Yxln.cjs.map} +1 -1
- package/dist/chunks/{field-DsRKkbav.js → field-CDCN9x0L.js} +3 -3
- package/dist/chunks/{field-DsRKkbav.js.map → field-CDCN9x0L.js.map} +1 -1
- package/dist/chunks/{limits-BP9R5wnr.js → limits-DvJZJn0V.js} +2 -2
- package/dist/chunks/{limits-BP9R5wnr.js.map → limits-DvJZJn0V.js.map} +1 -1
- package/dist/chunks/{limits-9wi1f6xT.cjs → limits-Vy-Xv26D.cjs} +2 -2
- package/dist/chunks/{limits-9wi1f6xT.cjs.map → limits-Vy-Xv26D.cjs.map} +1 -1
- package/dist/chunks/{paste-reader-BWQaYNaV.cjs → paste-reader-BL51Jt1y.cjs} +2 -2
- package/dist/chunks/{paste-reader-BWQaYNaV.cjs.map → paste-reader-BL51Jt1y.cjs.map} +1 -1
- package/dist/chunks/{paste-reader-D6uOTDBM.js → paste-reader-BpXOH_Px.js} +2 -2
- package/dist/chunks/{paste-reader-D6uOTDBM.js.map → paste-reader-BpXOH_Px.js.map} +1 -1
- package/dist/chunks/{payload-BrQWGwyx.js → payload-5uJedhwz.js} +2 -2
- package/dist/chunks/{payload-BrQWGwyx.js.map → payload-5uJedhwz.js.map} +1 -1
- package/dist/chunks/{payload-BWQ6sPtS.js → payload-DZnXoBmF.js} +3 -3
- package/dist/chunks/{payload-BWQ6sPtS.js.map → payload-DZnXoBmF.js.map} +1 -1
- package/dist/chunks/{payload-sBxkG7jH.cjs → payload-DjSSLonm.cjs} +2 -2
- package/dist/chunks/{payload-sBxkG7jH.cjs.map → payload-DjSSLonm.cjs.map} +1 -1
- package/dist/chunks/{payload-tTK6REua.cjs → payload-DzHhs6Ey.cjs} +3 -3
- package/dist/chunks/{payload-tTK6REua.cjs.map → payload-DzHhs6Ey.cjs.map} +1 -1
- package/dist/chunks/{share-nx7M4Z0t.cjs → share-Bk6MPmJg.cjs} +6 -6
- package/dist/chunks/{share-nx7M4Z0t.cjs.map → share-Bk6MPmJg.cjs.map} +1 -1
- package/dist/chunks/{share-CU91L4EK.js → share-tdlNQeje.js} +6 -6
- package/dist/chunks/{share-CU91L4EK.js.map → share-tdlNQeje.js.map} +1 -1
- package/dist/chunks/{url-BrhVUwn7.cjs → url-CL4YTCvM.cjs} +2 -2
- package/dist/chunks/{url-BrhVUwn7.cjs.map → url-CL4YTCvM.cjs.map} +1 -1
- package/dist/chunks/{url-COID0BLY.js → url-zB_krkuF.js} +2 -2
- package/dist/chunks/{url-COID0BLY.js.map → url-zB_krkuF.js.map} +1 -1
- package/dist/code.cjs +2 -2
- package/dist/code.js +2 -2
- package/dist/color.cjs +2 -2
- package/dist/color.js +2 -2
- package/dist/core.cjs +5 -5
- package/dist/core.js +5 -5
- package/dist/email.cjs +2 -2
- package/dist/email.js +2 -2
- package/dist/files.cjs +1 -1
- package/dist/files.js +1 -1
- package/dist/image.cjs +3 -3
- package/dist/image.cjs.map +1 -1
- package/dist/image.js +3 -3
- package/dist/image.js.map +1 -1
- package/dist/index.cjs +7 -7
- package/dist/index.js +7 -7
- package/dist/link.cjs +3 -3
- package/dist/link.js +3 -3
- package/dist/markdown.cjs +1 -1
- package/dist/markdown.js +1 -1
- package/dist/number.cjs +2 -2
- package/dist/number.js +2 -2
- package/dist/otp.cjs +1 -1
- package/dist/otp.js +1 -1
- package/dist/rich.cjs +3 -3
- package/dist/rich.js +3 -3
- package/dist/secrets.cjs +1 -1
- package/dist/secrets.js +1 -1
- package/dist/share.cjs +1 -1
- package/dist/share.js +1 -1
- package/dist/structured.cjs +2 -2
- package/dist/structured.js +2 -2
- package/dist/table.cjs +1 -1
- package/dist/table.js +1 -1
- package/dist/testing.cjs +2 -2
- package/dist/testing.js +2 -2
- package/package.json +1 -1
- package/dist/chunks/deadline-CbwnZ3Oq.js.map +0 -1
- package/dist/chunks/deadline-j2hD7JKz.cjs.map +0 -1
- package/dist/chunks/errors-CT-FfUtU.js.map +0 -1
- package/dist/chunks/errors-DFmEAC4E.cjs.map +0 -1
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"share-nx7M4Z0t.cjs","names":["createCopyError","linkUrlResolver","toCopyError","cleanTitle","linkPayload","normalizePayload","validatePayload","createBrowserClipboardAdapter","describeCopyError"],"sources":["../../src/share/share.ts"],"sourcesContent":["import { createBrowserClipboardAdapter, type ClipboardAdapter } from '../core/clipboard-adapter';\nimport { createCopyError, describeCopyError, toCopyError, type CopyError, type CopyErrorType } from '../core/errors';\nimport { normalizePayload, validatePayload, type CopyInput, type CopyPayload } from '../core/payload';\nimport { cleanTitle, DEFAULT_LINK_TITLE_LENGTH, linkPayload } from '../link/payload';\nimport { linkUrlResolver, type LinkUrlOptions } from '../link/url';\n\n/** What to share: a link, a message, files, or any mix of them. */\nexport interface ShareContent {\n /** Validated like every link in this package: allowed schemes only, credentials removed. */\n readonly url?: string | URL;\n readonly title?: string;\n /** A message to share alongside (or instead of) the link. */\n readonly text?: string;\n /** Files for the share sheet, where the browser can share them (`navigator.canShare({ files })`). Never copied. */\n readonly files?: readonly File[];\n}\n\n/** The content after validation: what the share sheet or the clipboard receives. */\nexport interface ResolvedShare {\n readonly url: string | null;\n /** Cleaned of hidden characters; `null` when there is none. */\n readonly title: string | null;\n readonly text: string | null;\n readonly files: readonly File[];\n}\n\n/**\n * How to share:\n * - `auto` (default): the share sheet on phones and tablets, where people expect it; copy elsewhere.\n * - `native`: the share sheet wherever the browser has one (also desktop Safari, Edge and Chrome on Windows and macOS).\n * - `copy`: always copy.\n */\nexport type ShareMode = 'auto' | 'native' | 'copy';\n\nexport type ShareMethod = 'native' | 'copy';\n\n/** Structural view of what sharing needs from the browser; `window` by default. */\nexport interface ShareEnvironment {\n readonly navigator?: {\n readonly share?: (data: ShareData) => Promise<void>;\n readonly canShare?: (data: ShareData) => boolean;\n };\n readonly matchMedia?: (query: string) => { readonly matches: boolean };\n}\n\nexport interface ShareOptions extends LinkUrlOptions {\n /** Default `\"auto\"`. */\n readonly mode?: ShareMode;\n /** When the share sheet fails for a reason other than the user closing it, copy instead. Default `true`. */\n readonly fallback?: boolean;\n /**\n * What to copy. Default: a titled link (`linkPayload`) when there is a URL,\n * otherwise the text. Return a string or any copy payload.\n */\n readonly copy?: (content: ResolvedShare) => CopyInput;\n /** Default: the browser Clipboard API, as `useCopy` uses. */\n readonly adapter?: ClipboardAdapter;\n /** Default: `window`. For tests, webviews and other hosts. */\n readonly environment?: ShareEnvironment;\n /** Aborting it stops a copy in progress; the share sheet itself can only be closed by the user. */\n readonly signal?: AbortSignal;\n}\n\n/**\n * Why the content was copied rather than shared: `preferred` (the mode chose\n * copy, as on desktop in `auto`), `unsupported` (no share sheet, or it can't\n * take this content) or `fallback` (the share sheet failed).\n */\nexport type CopyReason = 'preferred' | 'unsupported' | 'fallback';\n\n/** What `shareOrCopy` resolves to. It never rejects. */\nexport type ShareOutcome =\n | { readonly status: 'shared'; readonly method: 'native'; readonly content: ResolvedShare }\n | { readonly status: 'copied'; readonly method: 'copy'; readonly reason: CopyReason; readonly payload: CopyPayload; readonly content: ResolvedShare }\n /** The user closed the share sheet. Nothing to report. */\n | { readonly status: 'cancelled'; readonly method: 'native' }\n | { readonly status: 'error'; readonly method: ShareMethod; readonly error: CopyError };\n\n/** Phones and tablets: a touch screen is the main input and nothing hovers. */\nexport const TOUCH_FIRST = '(hover: none) and (pointer: coarse)';\n\nconst defaultEnvironment = (): ShareEnvironment | undefined => (typeof window === 'undefined' ? undefined : window);\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/** Validates and cleans what to share, or returns the typed error for invalid input. */\nfunction resolveContent(content: ShareContent, options: LinkUrlOptions): ResolvedShare | CopyError {\n const value: unknown = content;\n if (typeof value !== 'object' || value === null) return invalid('Share content must be an object with a url, text or files.');\n const { url, title, text, files } = value as Record<string, unknown>;\n let href: string | null = null;\n if (url !== undefined && url !== null) {\n try {\n href = linkUrlResolver(options)(url as string | URL);\n } catch (error) {\n return toCopyError(error);\n }\n }\n if (title !== undefined && typeof title !== 'string') return invalid('`title` must be a string.');\n if (text !== undefined && typeof text !== 'string') return invalid('`text` must be a string.');\n const list: unknown = files ?? [];\n if (!Array.isArray(list) || !list.every((file: unknown) => typeof File !== 'undefined' && file instanceof File)) {\n return invalid('`files` must be a list of File objects.');\n }\n const cleanName = title === undefined ? '' : cleanTitle(title, DEFAULT_LINK_TITLE_LENGTH);\n const message = text === undefined || text.trim() === '' ? null : text;\n if (href === null && message === null && list.length === 0) return invalid('There is nothing to share: give a url, text or files.');\n return { url: href, title: cleanName === '' ? null : cleanName, text: message, files: list as File[] };\n}\n\n/** The `ShareData` the browser receives: only the fields that are set. */\nfunction shareData(content: ResolvedShare): ShareData {\n return {\n ...(content.url === null ? {} : { url: content.url }),\n ...(content.title === null ? {} : { title: content.title }),\n ...(content.text === null ? {} : { text: content.text }),\n ...(content.files.length === 0 ? {} : { files: [...content.files] }),\n };\n}\n\n/** Whether this browser can open its share sheet for `data`. */\nfunction canShareNatively(environment: ShareEnvironment | undefined, data: ShareData | null): boolean {\n const nav = environment?.navigator;\n if (typeof nav?.share !== 'function') return false;\n if (data === null) return true;\n // Without canShare (older Safari), only links and text can be shared.\n return typeof nav.canShare === 'function' ? nav.canShare(data) : data.files === undefined;\n}\n\nfunction isTouchFirst(environment: ShareEnvironment | undefined): boolean {\n return typeof environment?.matchMedia === 'function' && environment.matchMedia(TOUCH_FIRST).matches;\n}\n\nfunction resolveMode(mode: unknown): ShareMode | CopyError {\n if (mode === undefined) return 'auto';\n return mode === 'auto' || mode === 'native' || mode === 'copy' ? mode : invalid('`mode` must be \"auto\", \"native\" or \"copy\".');\n}\n\n/**\n * How {@link shareOrCopy} would share right now: `\"native\"` (the share sheet) or\n * `\"copy\"`. Use it to label the button (\"Share…\" or \"Copy link\"). Pass the\n * content when it has files, since not every share sheet takes them.\n */\nexport function shareMethod(options: Pick<ShareOptions, 'mode' | 'environment'> = {}, content?: ShareContent): ShareMethod {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string' || mode === 'copy') return 'copy';\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'auto' && !isTouchFirst(environment)) return 'copy';\n const resolved = content === undefined ? null : resolveContent(content, {});\n const data = resolved === null ? null : 'type' in resolved ? undefined : shareData(resolved);\n return data !== undefined && canShareNatively(environment, data) ? 'native' : 'copy';\n}\n\n/** The default copy: a titled link when there is a URL, otherwise the text (one of them is always set here). */\nfunction defaultCopy(content: ResolvedShare): CopyInput {\n if (content.url !== null) return linkPayload({ url: content.url, ...(content.title === null ? {} : { title: content.title }) });\n return content.text as string;\n}\n\nasync function copyContent(content: ResolvedShare, reason: CopyReason, options: ShareOptions): Promise<ShareOutcome> {\n if (options.copy === undefined && content.url === null && content.text === null) {\n return { status: 'error', method: 'copy', error: createCopyError('unsupported-format', 'Files can only be shared through a share sheet, and this browser has none for them.') };\n }\n let payload: CopyPayload;\n try {\n payload = normalizePayload((options.copy ?? defaultCopy)(content));\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n const problem = validatePayload(payload);\n if (problem !== null) return { status: 'error', method: 'copy', error: problem };\n if (options.signal?.aborted === true) return { status: 'error', method: 'copy', error: createCopyError('aborted', 'The share was aborted.') };\n try {\n await (options.adapter ?? createBrowserClipboardAdapter()).write(payload, options.signal === undefined ? undefined : { signal: options.signal });\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n return { status: 'copied', method: 'copy', reason, payload, content };\n}\n\n/**\n * Shares through the device's share sheet where people expect one, and copies a\n * titled link everywhere else. Call it directly in a click handler: the share\n * sheet needs the user's gesture.\n *\n * It never rejects. It resolves to `shared`, `copied` (with why), `cancelled`\n * (the user closed the share sheet: nothing to report) or `error` with a typed\n * {@link CopyError}.\n *\n * @example\n * button.addEventListener('click', async () => {\n * const outcome = await shareOrCopy({ url: location.href, title: document.title });\n * if (outcome.status === 'copied') toast('Link copied');\n * });\n */\nexport async function shareOrCopy(content: ShareContent, options: ShareOptions = {}): Promise<ShareOutcome> {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string') return { status: 'error', method: 'copy', error: mode };\n const resolved = resolveContent(content, options);\n if ('type' in resolved) return { status: 'error', method: 'copy', error: resolved };\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'copy' || (mode === 'auto' && !isTouchFirst(environment))) return copyContent(resolved, 'preferred', options);\n const data = shareData(resolved);\n if (!canShareNatively(environment, data)) return copyContent(resolved, 'unsupported', options);\n try {\n // Called before any await: the share sheet needs the click's user activation.\n await (environment?.navigator?.share as (data: ShareData) => Promise<void>)(data);\n return { status: 'shared', method: 'native', content: resolved };\n } catch (error) {\n if (readName(error) === 'AbortError') return { status: 'cancelled', method: 'native' };\n if (options.fallback === false) return { status: 'error', method: 'native', error: shareError(error) };\n return copyContent(resolved, 'fallback', options);\n }\n}\n\nfunction readName(error: unknown): string | undefined {\n const name: unknown = typeof error === 'object' && error !== null ? (error as { name?: unknown }).name : undefined;\n return typeof name === 'string' ? name : undefined;\n}\n\n/** Classifies a share sheet failure. */\nfunction shareError(cause: unknown): CopyError {\n switch (readName(cause)) {\n case 'NotAllowedError':\n return createCopyError('permission-denied', 'The share sheet was blocked: it needs a click, and an iframe needs the web-share permission.', cause);\n case 'InvalidStateError':\n return createCopyError('unknown', 'Another share sheet is already open.', cause);\n case 'DataError':\n case 'TypeError':\n return createCopyError('unsupported-format', 'The share sheet rejected this content.', cause);\n default:\n return toCopyError(cause);\n }\n}\n\nconst SHARE_DESCRIPTIONS: Partial<Readonly<Record<CopyErrorType, string>>> = {\n 'permission-denied': \"Sharing isn't allowed here.\",\n 'unsupported-format': \"This can't be shared from this browser.\",\n timeout: 'Sharing took too long. Try again.',\n};\n\n/**\n * Default English, user-facing sentence for a failed share: a share sheet\n * failure is described as sharing, a failed copy as copying. Replace for i18n.\n */\nexport function describeShareError(error: CopyError, method: ShareMethod): string {\n if (method === 'copy') return describeCopyError(error);\n return SHARE_DESCRIPTIONS[error.type] ?? \"Couldn't share. Try again.\";\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"share-Bk6MPmJg.cjs","names":["createCopyError","linkUrlResolver","toCopyError","cleanTitle","linkPayload","normalizePayload","validatePayload","createBrowserClipboardAdapter","describeCopyError"],"sources":["../../src/share/share.ts"],"sourcesContent":["import { createBrowserClipboardAdapter, type ClipboardAdapter } from '../core/clipboard-adapter';\nimport { createCopyError, describeCopyError, toCopyError, type CopyError, type CopyErrorType } from '../core/errors';\nimport { normalizePayload, validatePayload, type CopyInput, type CopyPayload } from '../core/payload';\nimport { cleanTitle, DEFAULT_LINK_TITLE_LENGTH, linkPayload } from '../link/payload';\nimport { linkUrlResolver, type LinkUrlOptions } from '../link/url';\n\n/** What to share: a link, a message, files, or any mix of them. */\nexport interface ShareContent {\n /** Validated like every link in this package: allowed schemes only, credentials removed. */\n readonly url?: string | URL;\n readonly title?: string;\n /** A message to share alongside (or instead of) the link. */\n readonly text?: string;\n /** Files for the share sheet, where the browser can share them (`navigator.canShare({ files })`). Never copied. */\n readonly files?: readonly File[];\n}\n\n/** The content after validation: what the share sheet or the clipboard receives. */\nexport interface ResolvedShare {\n readonly url: string | null;\n /** Cleaned of hidden characters; `null` when there is none. */\n readonly title: string | null;\n readonly text: string | null;\n readonly files: readonly File[];\n}\n\n/**\n * How to share:\n * - `auto` (default): the share sheet on phones and tablets, where people expect it; copy elsewhere.\n * - `native`: the share sheet wherever the browser has one (also desktop Safari, Edge and Chrome on Windows and macOS).\n * - `copy`: always copy.\n */\nexport type ShareMode = 'auto' | 'native' | 'copy';\n\nexport type ShareMethod = 'native' | 'copy';\n\n/** Structural view of what sharing needs from the browser; `window` by default. */\nexport interface ShareEnvironment {\n readonly navigator?: {\n readonly share?: (data: ShareData) => Promise<void>;\n readonly canShare?: (data: ShareData) => boolean;\n };\n readonly matchMedia?: (query: string) => { readonly matches: boolean };\n}\n\nexport interface ShareOptions extends LinkUrlOptions {\n /** Default `\"auto\"`. */\n readonly mode?: ShareMode;\n /** When the share sheet fails for a reason other than the user closing it, copy instead. Default `true`. */\n readonly fallback?: boolean;\n /**\n * What to copy. Default: a titled link (`linkPayload`) when there is a URL,\n * otherwise the text. Return a string or any copy payload.\n */\n readonly copy?: (content: ResolvedShare) => CopyInput;\n /** Default: the browser Clipboard API, as `useCopy` uses. */\n readonly adapter?: ClipboardAdapter;\n /** Default: `window`. For tests, webviews and other hosts. */\n readonly environment?: ShareEnvironment;\n /** Aborting it stops a copy in progress; the share sheet itself can only be closed by the user. */\n readonly signal?: AbortSignal;\n}\n\n/**\n * Why the content was copied rather than shared: `preferred` (the mode chose\n * copy, as on desktop in `auto`), `unsupported` (no share sheet, or it can't\n * take this content) or `fallback` (the share sheet failed).\n */\nexport type CopyReason = 'preferred' | 'unsupported' | 'fallback';\n\n/** What `shareOrCopy` resolves to. It never rejects. */\nexport type ShareOutcome =\n | { readonly status: 'shared'; readonly method: 'native'; readonly content: ResolvedShare }\n | { readonly status: 'copied'; readonly method: 'copy'; readonly reason: CopyReason; readonly payload: CopyPayload; readonly content: ResolvedShare }\n /** The user closed the share sheet. Nothing to report. */\n | { readonly status: 'cancelled'; readonly method: 'native' }\n | { readonly status: 'error'; readonly method: ShareMethod; readonly error: CopyError };\n\n/** Phones and tablets: a touch screen is the main input and nothing hovers. */\nexport const TOUCH_FIRST = '(hover: none) and (pointer: coarse)';\n\nconst defaultEnvironment = (): ShareEnvironment | undefined => (typeof window === 'undefined' ? undefined : window);\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/** Validates and cleans what to share, or returns the typed error for invalid input. */\nfunction resolveContent(content: ShareContent, options: LinkUrlOptions): ResolvedShare | CopyError {\n const value: unknown = content;\n if (typeof value !== 'object' || value === null) return invalid('Share content must be an object with a url, text or files.');\n const { url, title, text, files } = value as Record<string, unknown>;\n let href: string | null = null;\n if (url !== undefined && url !== null) {\n try {\n href = linkUrlResolver(options)(url as string | URL);\n } catch (error) {\n return toCopyError(error);\n }\n }\n if (title !== undefined && typeof title !== 'string') return invalid('`title` must be a string.');\n if (text !== undefined && typeof text !== 'string') return invalid('`text` must be a string.');\n const list: unknown = files ?? [];\n if (!Array.isArray(list) || !list.every((file: unknown) => typeof File !== 'undefined' && file instanceof File)) {\n return invalid('`files` must be a list of File objects.');\n }\n const cleanName = title === undefined ? '' : cleanTitle(title, DEFAULT_LINK_TITLE_LENGTH);\n const message = text === undefined || text.trim() === '' ? null : text;\n if (href === null && message === null && list.length === 0) return invalid('There is nothing to share: give a url, text or files.');\n return { url: href, title: cleanName === '' ? null : cleanName, text: message, files: list as File[] };\n}\n\n/** The `ShareData` the browser receives: only the fields that are set. */\nfunction shareData(content: ResolvedShare): ShareData {\n return {\n ...(content.url === null ? {} : { url: content.url }),\n ...(content.title === null ? {} : { title: content.title }),\n ...(content.text === null ? {} : { text: content.text }),\n ...(content.files.length === 0 ? {} : { files: [...content.files] }),\n };\n}\n\n/** Whether this browser can open its share sheet for `data`. */\nfunction canShareNatively(environment: ShareEnvironment | undefined, data: ShareData | null): boolean {\n const nav = environment?.navigator;\n if (typeof nav?.share !== 'function') return false;\n if (data === null) return true;\n // Without canShare (older Safari), only links and text can be shared.\n return typeof nav.canShare === 'function' ? nav.canShare(data) : data.files === undefined;\n}\n\nfunction isTouchFirst(environment: ShareEnvironment | undefined): boolean {\n return typeof environment?.matchMedia === 'function' && environment.matchMedia(TOUCH_FIRST).matches;\n}\n\nfunction resolveMode(mode: unknown): ShareMode | CopyError {\n if (mode === undefined) return 'auto';\n return mode === 'auto' || mode === 'native' || mode === 'copy' ? mode : invalid('`mode` must be \"auto\", \"native\" or \"copy\".');\n}\n\n/**\n * How {@link shareOrCopy} would share right now: `\"native\"` (the share sheet) or\n * `\"copy\"`. Use it to label the button (\"Share…\" or \"Copy link\"). Pass the\n * content when it has files, since not every share sheet takes them.\n */\nexport function shareMethod(options: Pick<ShareOptions, 'mode' | 'environment'> = {}, content?: ShareContent): ShareMethod {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string' || mode === 'copy') return 'copy';\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'auto' && !isTouchFirst(environment)) return 'copy';\n const resolved = content === undefined ? null : resolveContent(content, {});\n const data = resolved === null ? null : 'type' in resolved ? undefined : shareData(resolved);\n return data !== undefined && canShareNatively(environment, data) ? 'native' : 'copy';\n}\n\n/** The default copy: a titled link when there is a URL, otherwise the text (one of them is always set here). */\nfunction defaultCopy(content: ResolvedShare): CopyInput {\n if (content.url !== null) return linkPayload({ url: content.url, ...(content.title === null ? {} : { title: content.title }) });\n return content.text as string;\n}\n\nasync function copyContent(content: ResolvedShare, reason: CopyReason, options: ShareOptions): Promise<ShareOutcome> {\n if (options.copy === undefined && content.url === null && content.text === null) {\n return { status: 'error', method: 'copy', error: createCopyError('unsupported-format', 'Files can only be shared through a share sheet, and this browser has none for them.') };\n }\n let payload: CopyPayload;\n try {\n payload = normalizePayload((options.copy ?? defaultCopy)(content));\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n const problem = validatePayload(payload);\n if (problem !== null) return { status: 'error', method: 'copy', error: problem };\n if (options.signal?.aborted === true) return { status: 'error', method: 'copy', error: createCopyError('aborted', 'The share was aborted.') };\n try {\n await (options.adapter ?? createBrowserClipboardAdapter()).write(payload, options.signal === undefined ? undefined : { signal: options.signal });\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n return { status: 'copied', method: 'copy', reason, payload, content };\n}\n\n/**\n * Shares through the device's share sheet where people expect one, and copies a\n * titled link everywhere else. Call it directly in a click handler: the share\n * sheet needs the user's gesture.\n *\n * It never rejects. It resolves to `shared`, `copied` (with why), `cancelled`\n * (the user closed the share sheet: nothing to report) or `error` with a typed\n * {@link CopyError}.\n *\n * @example\n * button.addEventListener('click', async () => {\n * const outcome = await shareOrCopy({ url: location.href, title: document.title });\n * if (outcome.status === 'copied') toast('Link copied');\n * });\n */\nexport async function shareOrCopy(content: ShareContent, options: ShareOptions = {}): Promise<ShareOutcome> {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string') return { status: 'error', method: 'copy', error: mode };\n const resolved = resolveContent(content, options);\n if ('type' in resolved) return { status: 'error', method: 'copy', error: resolved };\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'copy' || (mode === 'auto' && !isTouchFirst(environment))) return copyContent(resolved, 'preferred', options);\n const data = shareData(resolved);\n if (!canShareNatively(environment, data)) return copyContent(resolved, 'unsupported', options);\n try {\n // Called before any await: the share sheet needs the click's user activation.\n await (environment?.navigator?.share as (data: ShareData) => Promise<void>)(data);\n return { status: 'shared', method: 'native', content: resolved };\n } catch (error) {\n if (readName(error) === 'AbortError') return { status: 'cancelled', method: 'native' };\n if (options.fallback === false) return { status: 'error', method: 'native', error: shareError(error) };\n return copyContent(resolved, 'fallback', options);\n }\n}\n\nfunction readName(error: unknown): string | undefined {\n const name: unknown = typeof error === 'object' && error !== null ? (error as { name?: unknown }).name : undefined;\n return typeof name === 'string' ? name : undefined;\n}\n\n/** Classifies a share sheet failure. */\nfunction shareError(cause: unknown): CopyError {\n switch (readName(cause)) {\n case 'NotAllowedError':\n return createCopyError('permission-denied', 'The share sheet was blocked: it needs a click, and an iframe needs the web-share permission.', cause);\n case 'InvalidStateError':\n return createCopyError('unknown', 'Another share sheet is already open.', cause);\n case 'DataError':\n case 'TypeError':\n return createCopyError('unsupported-format', 'The share sheet rejected this content.', cause);\n default:\n return toCopyError(cause);\n }\n}\n\nconst SHARE_DESCRIPTIONS: Partial<Readonly<Record<CopyErrorType, string>>> = {\n 'permission-denied': \"Sharing isn't allowed here.\",\n 'unsupported-format': \"This can't be shared from this browser.\",\n timeout: 'Sharing took too long. Try again.',\n};\n\n/**\n * Default English, user-facing sentence for a failed share: a share sheet\n * failure is described as sharing, a failed copy as copying. Replace for i18n.\n */\nexport function describeShareError(error: CopyError, method: ShareMethod): string {\n if (method === 'copy') return describeCopyError(error);\n return SHARE_DESCRIPTIONS[error.type] ?? \"Couldn't share. Try again.\";\n}\n"],"mappings":"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"}
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
|
|
2
|
-
import { c as toCopyError, i as describeCopyError, r as createCopyError } from "./errors-
|
|
3
|
-
import { a as validatePayload, r as normalizePayload } from "./payload-
|
|
4
|
-
import { t as createBrowserClipboardAdapter } from "./clipboard-adapter-
|
|
5
|
-
import { i as linkUrlResolver } from "./url-
|
|
6
|
-
import { n as cleanTitle, r as linkPayload } from "./payload-
|
|
2
|
+
import { c as toCopyError, i as describeCopyError, r as createCopyError } from "./errors-CGcMvbhJ.js";
|
|
3
|
+
import { a as validatePayload, r as normalizePayload } from "./payload-5uJedhwz.js";
|
|
4
|
+
import { t as createBrowserClipboardAdapter } from "./clipboard-adapter-DyCmyZV9.js";
|
|
5
|
+
import { i as linkUrlResolver } from "./url-zB_krkuF.js";
|
|
6
|
+
import { n as cleanTitle, r as linkPayload } from "./payload-DZnXoBmF.js";
|
|
7
7
|
//#region src/share/share.ts
|
|
8
8
|
/** Phones and tablets: a touch screen is the main input and nothing hovers. */
|
|
9
9
|
const TOUCH_FIRST = "(hover: none) and (pointer: coarse)";
|
|
@@ -205,4 +205,4 @@ function describeShareError(error, method) {
|
|
|
205
205
|
//#endregion
|
|
206
206
|
export { shareOrCopy as i, describeShareError as n, shareMethod as r, TOUCH_FIRST as t };
|
|
207
207
|
|
|
208
|
-
//# sourceMappingURL=share-
|
|
208
|
+
//# sourceMappingURL=share-tdlNQeje.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"share-CU91L4EK.js","names":[],"sources":["../../src/share/share.ts"],"sourcesContent":["import { createBrowserClipboardAdapter, type ClipboardAdapter } from '../core/clipboard-adapter';\nimport { createCopyError, describeCopyError, toCopyError, type CopyError, type CopyErrorType } from '../core/errors';\nimport { normalizePayload, validatePayload, type CopyInput, type CopyPayload } from '../core/payload';\nimport { cleanTitle, DEFAULT_LINK_TITLE_LENGTH, linkPayload } from '../link/payload';\nimport { linkUrlResolver, type LinkUrlOptions } from '../link/url';\n\n/** What to share: a link, a message, files, or any mix of them. */\nexport interface ShareContent {\n /** Validated like every link in this package: allowed schemes only, credentials removed. */\n readonly url?: string | URL;\n readonly title?: string;\n /** A message to share alongside (or instead of) the link. */\n readonly text?: string;\n /** Files for the share sheet, where the browser can share them (`navigator.canShare({ files })`). Never copied. */\n readonly files?: readonly File[];\n}\n\n/** The content after validation: what the share sheet or the clipboard receives. */\nexport interface ResolvedShare {\n readonly url: string | null;\n /** Cleaned of hidden characters; `null` when there is none. */\n readonly title: string | null;\n readonly text: string | null;\n readonly files: readonly File[];\n}\n\n/**\n * How to share:\n * - `auto` (default): the share sheet on phones and tablets, where people expect it; copy elsewhere.\n * - `native`: the share sheet wherever the browser has one (also desktop Safari, Edge and Chrome on Windows and macOS).\n * - `copy`: always copy.\n */\nexport type ShareMode = 'auto' | 'native' | 'copy';\n\nexport type ShareMethod = 'native' | 'copy';\n\n/** Structural view of what sharing needs from the browser; `window` by default. */\nexport interface ShareEnvironment {\n readonly navigator?: {\n readonly share?: (data: ShareData) => Promise<void>;\n readonly canShare?: (data: ShareData) => boolean;\n };\n readonly matchMedia?: (query: string) => { readonly matches: boolean };\n}\n\nexport interface ShareOptions extends LinkUrlOptions {\n /** Default `\"auto\"`. */\n readonly mode?: ShareMode;\n /** When the share sheet fails for a reason other than the user closing it, copy instead. Default `true`. */\n readonly fallback?: boolean;\n /**\n * What to copy. Default: a titled link (`linkPayload`) when there is a URL,\n * otherwise the text. Return a string or any copy payload.\n */\n readonly copy?: (content: ResolvedShare) => CopyInput;\n /** Default: the browser Clipboard API, as `useCopy` uses. */\n readonly adapter?: ClipboardAdapter;\n /** Default: `window`. For tests, webviews and other hosts. */\n readonly environment?: ShareEnvironment;\n /** Aborting it stops a copy in progress; the share sheet itself can only be closed by the user. */\n readonly signal?: AbortSignal;\n}\n\n/**\n * Why the content was copied rather than shared: `preferred` (the mode chose\n * copy, as on desktop in `auto`), `unsupported` (no share sheet, or it can't\n * take this content) or `fallback` (the share sheet failed).\n */\nexport type CopyReason = 'preferred' | 'unsupported' | 'fallback';\n\n/** What `shareOrCopy` resolves to. It never rejects. */\nexport type ShareOutcome =\n | { readonly status: 'shared'; readonly method: 'native'; readonly content: ResolvedShare }\n | { readonly status: 'copied'; readonly method: 'copy'; readonly reason: CopyReason; readonly payload: CopyPayload; readonly content: ResolvedShare }\n /** The user closed the share sheet. Nothing to report. */\n | { readonly status: 'cancelled'; readonly method: 'native' }\n | { readonly status: 'error'; readonly method: ShareMethod; readonly error: CopyError };\n\n/** Phones and tablets: a touch screen is the main input and nothing hovers. */\nexport const TOUCH_FIRST = '(hover: none) and (pointer: coarse)';\n\nconst defaultEnvironment = (): ShareEnvironment | undefined => (typeof window === 'undefined' ? undefined : window);\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/** Validates and cleans what to share, or returns the typed error for invalid input. */\nfunction resolveContent(content: ShareContent, options: LinkUrlOptions): ResolvedShare | CopyError {\n const value: unknown = content;\n if (typeof value !== 'object' || value === null) return invalid('Share content must be an object with a url, text or files.');\n const { url, title, text, files } = value as Record<string, unknown>;\n let href: string | null = null;\n if (url !== undefined && url !== null) {\n try {\n href = linkUrlResolver(options)(url as string | URL);\n } catch (error) {\n return toCopyError(error);\n }\n }\n if (title !== undefined && typeof title !== 'string') return invalid('`title` must be a string.');\n if (text !== undefined && typeof text !== 'string') return invalid('`text` must be a string.');\n const list: unknown = files ?? [];\n if (!Array.isArray(list) || !list.every((file: unknown) => typeof File !== 'undefined' && file instanceof File)) {\n return invalid('`files` must be a list of File objects.');\n }\n const cleanName = title === undefined ? '' : cleanTitle(title, DEFAULT_LINK_TITLE_LENGTH);\n const message = text === undefined || text.trim() === '' ? null : text;\n if (href === null && message === null && list.length === 0) return invalid('There is nothing to share: give a url, text or files.');\n return { url: href, title: cleanName === '' ? null : cleanName, text: message, files: list as File[] };\n}\n\n/** The `ShareData` the browser receives: only the fields that are set. */\nfunction shareData(content: ResolvedShare): ShareData {\n return {\n ...(content.url === null ? {} : { url: content.url }),\n ...(content.title === null ? {} : { title: content.title }),\n ...(content.text === null ? {} : { text: content.text }),\n ...(content.files.length === 0 ? {} : { files: [...content.files] }),\n };\n}\n\n/** Whether this browser can open its share sheet for `data`. */\nfunction canShareNatively(environment: ShareEnvironment | undefined, data: ShareData | null): boolean {\n const nav = environment?.navigator;\n if (typeof nav?.share !== 'function') return false;\n if (data === null) return true;\n // Without canShare (older Safari), only links and text can be shared.\n return typeof nav.canShare === 'function' ? nav.canShare(data) : data.files === undefined;\n}\n\nfunction isTouchFirst(environment: ShareEnvironment | undefined): boolean {\n return typeof environment?.matchMedia === 'function' && environment.matchMedia(TOUCH_FIRST).matches;\n}\n\nfunction resolveMode(mode: unknown): ShareMode | CopyError {\n if (mode === undefined) return 'auto';\n return mode === 'auto' || mode === 'native' || mode === 'copy' ? mode : invalid('`mode` must be \"auto\", \"native\" or \"copy\".');\n}\n\n/**\n * How {@link shareOrCopy} would share right now: `\"native\"` (the share sheet) or\n * `\"copy\"`. Use it to label the button (\"Share…\" or \"Copy link\"). Pass the\n * content when it has files, since not every share sheet takes them.\n */\nexport function shareMethod(options: Pick<ShareOptions, 'mode' | 'environment'> = {}, content?: ShareContent): ShareMethod {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string' || mode === 'copy') return 'copy';\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'auto' && !isTouchFirst(environment)) return 'copy';\n const resolved = content === undefined ? null : resolveContent(content, {});\n const data = resolved === null ? null : 'type' in resolved ? undefined : shareData(resolved);\n return data !== undefined && canShareNatively(environment, data) ? 'native' : 'copy';\n}\n\n/** The default copy: a titled link when there is a URL, otherwise the text (one of them is always set here). */\nfunction defaultCopy(content: ResolvedShare): CopyInput {\n if (content.url !== null) return linkPayload({ url: content.url, ...(content.title === null ? {} : { title: content.title }) });\n return content.text as string;\n}\n\nasync function copyContent(content: ResolvedShare, reason: CopyReason, options: ShareOptions): Promise<ShareOutcome> {\n if (options.copy === undefined && content.url === null && content.text === null) {\n return { status: 'error', method: 'copy', error: createCopyError('unsupported-format', 'Files can only be shared through a share sheet, and this browser has none for them.') };\n }\n let payload: CopyPayload;\n try {\n payload = normalizePayload((options.copy ?? defaultCopy)(content));\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n const problem = validatePayload(payload);\n if (problem !== null) return { status: 'error', method: 'copy', error: problem };\n if (options.signal?.aborted === true) return { status: 'error', method: 'copy', error: createCopyError('aborted', 'The share was aborted.') };\n try {\n await (options.adapter ?? createBrowserClipboardAdapter()).write(payload, options.signal === undefined ? undefined : { signal: options.signal });\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n return { status: 'copied', method: 'copy', reason, payload, content };\n}\n\n/**\n * Shares through the device's share sheet where people expect one, and copies a\n * titled link everywhere else. Call it directly in a click handler: the share\n * sheet needs the user's gesture.\n *\n * It never rejects. It resolves to `shared`, `copied` (with why), `cancelled`\n * (the user closed the share sheet: nothing to report) or `error` with a typed\n * {@link CopyError}.\n *\n * @example\n * button.addEventListener('click', async () => {\n * const outcome = await shareOrCopy({ url: location.href, title: document.title });\n * if (outcome.status === 'copied') toast('Link copied');\n * });\n */\nexport async function shareOrCopy(content: ShareContent, options: ShareOptions = {}): Promise<ShareOutcome> {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string') return { status: 'error', method: 'copy', error: mode };\n const resolved = resolveContent(content, options);\n if ('type' in resolved) return { status: 'error', method: 'copy', error: resolved };\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'copy' || (mode === 'auto' && !isTouchFirst(environment))) return copyContent(resolved, 'preferred', options);\n const data = shareData(resolved);\n if (!canShareNatively(environment, data)) return copyContent(resolved, 'unsupported', options);\n try {\n // Called before any await: the share sheet needs the click's user activation.\n await (environment?.navigator?.share as (data: ShareData) => Promise<void>)(data);\n return { status: 'shared', method: 'native', content: resolved };\n } catch (error) {\n if (readName(error) === 'AbortError') return { status: 'cancelled', method: 'native' };\n if (options.fallback === false) return { status: 'error', method: 'native', error: shareError(error) };\n return copyContent(resolved, 'fallback', options);\n }\n}\n\nfunction readName(error: unknown): string | undefined {\n const name: unknown = typeof error === 'object' && error !== null ? (error as { name?: unknown }).name : undefined;\n return typeof name === 'string' ? name : undefined;\n}\n\n/** Classifies a share sheet failure. */\nfunction shareError(cause: unknown): CopyError {\n switch (readName(cause)) {\n case 'NotAllowedError':\n return createCopyError('permission-denied', 'The share sheet was blocked: it needs a click, and an iframe needs the web-share permission.', cause);\n case 'InvalidStateError':\n return createCopyError('unknown', 'Another share sheet is already open.', cause);\n case 'DataError':\n case 'TypeError':\n return createCopyError('unsupported-format', 'The share sheet rejected this content.', cause);\n default:\n return toCopyError(cause);\n }\n}\n\nconst SHARE_DESCRIPTIONS: Partial<Readonly<Record<CopyErrorType, string>>> = {\n 'permission-denied': \"Sharing isn't allowed here.\",\n 'unsupported-format': \"This can't be shared from this browser.\",\n timeout: 'Sharing took too long. Try again.',\n};\n\n/**\n * Default English, user-facing sentence for a failed share: a share sheet\n * failure is described as sharing, a failed copy as copying. Replace for i18n.\n */\nexport function describeShareError(error: CopyError, method: ShareMethod): string {\n if (method === 'copy') return describeCopyError(error);\n return SHARE_DESCRIPTIONS[error.type] ?? \"Couldn't share. Try again.\";\n}\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"share-tdlNQeje.js","names":[],"sources":["../../src/share/share.ts"],"sourcesContent":["import { createBrowserClipboardAdapter, type ClipboardAdapter } from '../core/clipboard-adapter';\nimport { createCopyError, describeCopyError, toCopyError, type CopyError, type CopyErrorType } from '../core/errors';\nimport { normalizePayload, validatePayload, type CopyInput, type CopyPayload } from '../core/payload';\nimport { cleanTitle, DEFAULT_LINK_TITLE_LENGTH, linkPayload } from '../link/payload';\nimport { linkUrlResolver, type LinkUrlOptions } from '../link/url';\n\n/** What to share: a link, a message, files, or any mix of them. */\nexport interface ShareContent {\n /** Validated like every link in this package: allowed schemes only, credentials removed. */\n readonly url?: string | URL;\n readonly title?: string;\n /** A message to share alongside (or instead of) the link. */\n readonly text?: string;\n /** Files for the share sheet, where the browser can share them (`navigator.canShare({ files })`). Never copied. */\n readonly files?: readonly File[];\n}\n\n/** The content after validation: what the share sheet or the clipboard receives. */\nexport interface ResolvedShare {\n readonly url: string | null;\n /** Cleaned of hidden characters; `null` when there is none. */\n readonly title: string | null;\n readonly text: string | null;\n readonly files: readonly File[];\n}\n\n/**\n * How to share:\n * - `auto` (default): the share sheet on phones and tablets, where people expect it; copy elsewhere.\n * - `native`: the share sheet wherever the browser has one (also desktop Safari, Edge and Chrome on Windows and macOS).\n * - `copy`: always copy.\n */\nexport type ShareMode = 'auto' | 'native' | 'copy';\n\nexport type ShareMethod = 'native' | 'copy';\n\n/** Structural view of what sharing needs from the browser; `window` by default. */\nexport interface ShareEnvironment {\n readonly navigator?: {\n readonly share?: (data: ShareData) => Promise<void>;\n readonly canShare?: (data: ShareData) => boolean;\n };\n readonly matchMedia?: (query: string) => { readonly matches: boolean };\n}\n\nexport interface ShareOptions extends LinkUrlOptions {\n /** Default `\"auto\"`. */\n readonly mode?: ShareMode;\n /** When the share sheet fails for a reason other than the user closing it, copy instead. Default `true`. */\n readonly fallback?: boolean;\n /**\n * What to copy. Default: a titled link (`linkPayload`) when there is a URL,\n * otherwise the text. Return a string or any copy payload.\n */\n readonly copy?: (content: ResolvedShare) => CopyInput;\n /** Default: the browser Clipboard API, as `useCopy` uses. */\n readonly adapter?: ClipboardAdapter;\n /** Default: `window`. For tests, webviews and other hosts. */\n readonly environment?: ShareEnvironment;\n /** Aborting it stops a copy in progress; the share sheet itself can only be closed by the user. */\n readonly signal?: AbortSignal;\n}\n\n/**\n * Why the content was copied rather than shared: `preferred` (the mode chose\n * copy, as on desktop in `auto`), `unsupported` (no share sheet, or it can't\n * take this content) or `fallback` (the share sheet failed).\n */\nexport type CopyReason = 'preferred' | 'unsupported' | 'fallback';\n\n/** What `shareOrCopy` resolves to. It never rejects. */\nexport type ShareOutcome =\n | { readonly status: 'shared'; readonly method: 'native'; readonly content: ResolvedShare }\n | { readonly status: 'copied'; readonly method: 'copy'; readonly reason: CopyReason; readonly payload: CopyPayload; readonly content: ResolvedShare }\n /** The user closed the share sheet. Nothing to report. */\n | { readonly status: 'cancelled'; readonly method: 'native' }\n | { readonly status: 'error'; readonly method: ShareMethod; readonly error: CopyError };\n\n/** Phones and tablets: a touch screen is the main input and nothing hovers. */\nexport const TOUCH_FIRST = '(hover: none) and (pointer: coarse)';\n\nconst defaultEnvironment = (): ShareEnvironment | undefined => (typeof window === 'undefined' ? undefined : window);\n\nconst invalid = (message: string): CopyError => createCopyError('invalid-payload', message);\n\n/** Validates and cleans what to share, or returns the typed error for invalid input. */\nfunction resolveContent(content: ShareContent, options: LinkUrlOptions): ResolvedShare | CopyError {\n const value: unknown = content;\n if (typeof value !== 'object' || value === null) return invalid('Share content must be an object with a url, text or files.');\n const { url, title, text, files } = value as Record<string, unknown>;\n let href: string | null = null;\n if (url !== undefined && url !== null) {\n try {\n href = linkUrlResolver(options)(url as string | URL);\n } catch (error) {\n return toCopyError(error);\n }\n }\n if (title !== undefined && typeof title !== 'string') return invalid('`title` must be a string.');\n if (text !== undefined && typeof text !== 'string') return invalid('`text` must be a string.');\n const list: unknown = files ?? [];\n if (!Array.isArray(list) || !list.every((file: unknown) => typeof File !== 'undefined' && file instanceof File)) {\n return invalid('`files` must be a list of File objects.');\n }\n const cleanName = title === undefined ? '' : cleanTitle(title, DEFAULT_LINK_TITLE_LENGTH);\n const message = text === undefined || text.trim() === '' ? null : text;\n if (href === null && message === null && list.length === 0) return invalid('There is nothing to share: give a url, text or files.');\n return { url: href, title: cleanName === '' ? null : cleanName, text: message, files: list as File[] };\n}\n\n/** The `ShareData` the browser receives: only the fields that are set. */\nfunction shareData(content: ResolvedShare): ShareData {\n return {\n ...(content.url === null ? {} : { url: content.url }),\n ...(content.title === null ? {} : { title: content.title }),\n ...(content.text === null ? {} : { text: content.text }),\n ...(content.files.length === 0 ? {} : { files: [...content.files] }),\n };\n}\n\n/** Whether this browser can open its share sheet for `data`. */\nfunction canShareNatively(environment: ShareEnvironment | undefined, data: ShareData | null): boolean {\n const nav = environment?.navigator;\n if (typeof nav?.share !== 'function') return false;\n if (data === null) return true;\n // Without canShare (older Safari), only links and text can be shared.\n return typeof nav.canShare === 'function' ? nav.canShare(data) : data.files === undefined;\n}\n\nfunction isTouchFirst(environment: ShareEnvironment | undefined): boolean {\n return typeof environment?.matchMedia === 'function' && environment.matchMedia(TOUCH_FIRST).matches;\n}\n\nfunction resolveMode(mode: unknown): ShareMode | CopyError {\n if (mode === undefined) return 'auto';\n return mode === 'auto' || mode === 'native' || mode === 'copy' ? mode : invalid('`mode` must be \"auto\", \"native\" or \"copy\".');\n}\n\n/**\n * How {@link shareOrCopy} would share right now: `\"native\"` (the share sheet) or\n * `\"copy\"`. Use it to label the button (\"Share…\" or \"Copy link\"). Pass the\n * content when it has files, since not every share sheet takes them.\n */\nexport function shareMethod(options: Pick<ShareOptions, 'mode' | 'environment'> = {}, content?: ShareContent): ShareMethod {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string' || mode === 'copy') return 'copy';\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'auto' && !isTouchFirst(environment)) return 'copy';\n const resolved = content === undefined ? null : resolveContent(content, {});\n const data = resolved === null ? null : 'type' in resolved ? undefined : shareData(resolved);\n return data !== undefined && canShareNatively(environment, data) ? 'native' : 'copy';\n}\n\n/** The default copy: a titled link when there is a URL, otherwise the text (one of them is always set here). */\nfunction defaultCopy(content: ResolvedShare): CopyInput {\n if (content.url !== null) return linkPayload({ url: content.url, ...(content.title === null ? {} : { title: content.title }) });\n return content.text as string;\n}\n\nasync function copyContent(content: ResolvedShare, reason: CopyReason, options: ShareOptions): Promise<ShareOutcome> {\n if (options.copy === undefined && content.url === null && content.text === null) {\n return { status: 'error', method: 'copy', error: createCopyError('unsupported-format', 'Files can only be shared through a share sheet, and this browser has none for them.') };\n }\n let payload: CopyPayload;\n try {\n payload = normalizePayload((options.copy ?? defaultCopy)(content));\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n const problem = validatePayload(payload);\n if (problem !== null) return { status: 'error', method: 'copy', error: problem };\n if (options.signal?.aborted === true) return { status: 'error', method: 'copy', error: createCopyError('aborted', 'The share was aborted.') };\n try {\n await (options.adapter ?? createBrowserClipboardAdapter()).write(payload, options.signal === undefined ? undefined : { signal: options.signal });\n } catch (error) {\n return { status: 'error', method: 'copy', error: toCopyError(error) };\n }\n return { status: 'copied', method: 'copy', reason, payload, content };\n}\n\n/**\n * Shares through the device's share sheet where people expect one, and copies a\n * titled link everywhere else. Call it directly in a click handler: the share\n * sheet needs the user's gesture.\n *\n * It never rejects. It resolves to `shared`, `copied` (with why), `cancelled`\n * (the user closed the share sheet: nothing to report) or `error` with a typed\n * {@link CopyError}.\n *\n * @example\n * button.addEventListener('click', async () => {\n * const outcome = await shareOrCopy({ url: location.href, title: document.title });\n * if (outcome.status === 'copied') toast('Link copied');\n * });\n */\nexport async function shareOrCopy(content: ShareContent, options: ShareOptions = {}): Promise<ShareOutcome> {\n const mode = resolveMode(options.mode);\n if (typeof mode !== 'string') return { status: 'error', method: 'copy', error: mode };\n const resolved = resolveContent(content, options);\n if ('type' in resolved) return { status: 'error', method: 'copy', error: resolved };\n const environment = options.environment ?? defaultEnvironment();\n if (mode === 'copy' || (mode === 'auto' && !isTouchFirst(environment))) return copyContent(resolved, 'preferred', options);\n const data = shareData(resolved);\n if (!canShareNatively(environment, data)) return copyContent(resolved, 'unsupported', options);\n try {\n // Called before any await: the share sheet needs the click's user activation.\n await (environment?.navigator?.share as (data: ShareData) => Promise<void>)(data);\n return { status: 'shared', method: 'native', content: resolved };\n } catch (error) {\n if (readName(error) === 'AbortError') return { status: 'cancelled', method: 'native' };\n if (options.fallback === false) return { status: 'error', method: 'native', error: shareError(error) };\n return copyContent(resolved, 'fallback', options);\n }\n}\n\nfunction readName(error: unknown): string | undefined {\n const name: unknown = typeof error === 'object' && error !== null ? (error as { name?: unknown }).name : undefined;\n return typeof name === 'string' ? name : undefined;\n}\n\n/** Classifies a share sheet failure. */\nfunction shareError(cause: unknown): CopyError {\n switch (readName(cause)) {\n case 'NotAllowedError':\n return createCopyError('permission-denied', 'The share sheet was blocked: it needs a click, and an iframe needs the web-share permission.', cause);\n case 'InvalidStateError':\n return createCopyError('unknown', 'Another share sheet is already open.', cause);\n case 'DataError':\n case 'TypeError':\n return createCopyError('unsupported-format', 'The share sheet rejected this content.', cause);\n default:\n return toCopyError(cause);\n }\n}\n\nconst SHARE_DESCRIPTIONS: Partial<Readonly<Record<CopyErrorType, string>>> = {\n 'permission-denied': \"Sharing isn't allowed here.\",\n 'unsupported-format': \"This can't be shared from this browser.\",\n timeout: 'Sharing took too long. Try again.',\n};\n\n/**\n * Default English, user-facing sentence for a failed share: a share sheet\n * failure is described as sharing, a failed copy as copying. Replace for i18n.\n */\nexport function describeShareError(error: CopyError, method: ShareMethod): string {\n if (method === 'copy') return describeCopyError(error);\n return SHARE_DESCRIPTIONS[error.type] ?? \"Couldn't share. Try again.\";\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
|
|
2
|
-
const require_errors = require("./errors-
|
|
2
|
+
const require_errors = require("./errors-CF2EQNbc.cjs");
|
|
3
3
|
//#region src/link/url.ts
|
|
4
4
|
/** Schemes a copied or pasted link may use by default. Never `javascript:`, `data:`, `vbscript:` or `file:`. */
|
|
5
5
|
const DEFAULT_LINK_PROTOCOLS = /* @__PURE__ */ Object.freeze([
|
|
@@ -161,4 +161,4 @@ Object.defineProperty(exports, "resolveLinkUrl", {
|
|
|
161
161
|
}
|
|
162
162
|
});
|
|
163
163
|
|
|
164
|
-
//# sourceMappingURL=url-
|
|
164
|
+
//# sourceMappingURL=url-CL4YTCvM.cjs.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"url-
|
|
1
|
+
{"version":3,"file":"url-CL4YTCvM.cjs","names":["copyFailure"],"sources":["../../src/link/url.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** Schemes a copied or pasted link may use by default. Never `javascript:`, `data:`, `vbscript:` or `file:`. */\nexport const DEFAULT_LINK_PROTOCOLS: readonly string[] = /* @__PURE__ */ Object.freeze(['https:', 'http:', 'mailto:', 'tel:']);\n\n/**\n * Query parameters that only track where a click came from: the defaults of\n * {@link cleanLinkUrl}. `utm_` matches every parameter starting with it.\n */\nexport const TRACKING_PARAMETERS: readonly string[] = /* @__PURE__ */ Object.freeze([\n 'utm_',\n 'fbclid',\n 'gclid',\n 'gclsrc',\n 'dclid',\n 'gbraid',\n 'wbraid',\n 'msclkid',\n 'yclid',\n 'twclid',\n 'ttclid',\n 'li_fat_id',\n 'igshid',\n 'igsh',\n 'mc_cid',\n 'mc_eid',\n '_hsenc',\n '_hsmi',\n 'mkt_tok',\n 'oly_anon_id',\n 'oly_enc_id',\n 'vero_id',\n 'wickedid',\n '_gl',\n]);\n\nexport interface CleanLinkOptions {\n /**\n * Parameters to remove: exact names, names ending in `_` (a prefix, like\n * `utm_`), or regular expressions tested against the name. Default {@link TRACKING_PARAMETERS}.\n */\n readonly params?: readonly (string | RegExp)[];\n /** Parameters never removed, even when `params` matches them. */\n readonly keep?: readonly string[];\n}\n\nexport interface LinkUrlOptions {\n /** Resolves relative links. Default: the page's address in a browser; required elsewhere for relative links. */\n readonly base?: string | URL;\n /** Allowed schemes, with the colon. Default {@link DEFAULT_LINK_PROTOCOLS}. */\n readonly protocols?: readonly string[];\n /** Remove tracking parameters: `true` for {@link TRACKING_PARAMETERS}, or your own list. Default `false`. */\n readonly clean?: boolean | CleanLinkOptions;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nfunction baseUrl(base: LinkUrlOptions['base']): string | undefined {\n if (base !== undefined) {\n if (typeof base === 'string' || base instanceof URL) return String(base);\n throw invalid('`base` must be a string or a URL.');\n }\n return typeof location === 'undefined' ? undefined : location.href;\n}\n\nfunction protocolSet(protocols: LinkUrlOptions['protocols']): ReadonlySet<string> {\n const list: unknown = protocols ?? DEFAULT_LINK_PROTOCOLS;\n const valid = (protocol: unknown): protocol is string => typeof protocol === 'string' && /^[a-z][a-z\\d+.-]*:$/i.test(protocol);\n if (!Array.isArray(list) || list.length === 0 || !(list as readonly unknown[]).every(valid)) {\n throw invalid('`protocols` must be a non-empty list of schemes with their colon, like \"https:\".');\n }\n return new Set((list as readonly string[]).map((protocol) => protocol.toLowerCase()));\n}\n\nfunction matcher(params: CleanLinkOptions['params']): (name: string) => boolean {\n const list = params ?? TRACKING_PARAMETERS;\n if (!Array.isArray(list) || !list.every((param) => typeof param === 'string' || param instanceof RegExp)) {\n throw invalid('`clean.params` must be a list of strings and regular expressions.');\n }\n return (name) => {\n const lower = name.toLowerCase();\n return list.some((param) => {\n if (typeof param !== 'string') return new RegExp(param.source, param.flags.replace(/[gy]/g, '')).test(name);\n const wanted = param.toLowerCase();\n return wanted.endsWith('_') ? lower.startsWith(wanted) : lower === wanted;\n });\n };\n}\n\n/** The cleaning step `clean` asks for, or `null`. Throws for an invalid option. */\nfunction cleaner(option: LinkUrlOptions['clean']): ((url: URL) => void) | null {\n const cleaning: unknown = option ?? false; // Plain-JS callers can pass anything.\n if (cleaning === false) return null;\n if (cleaning !== true && (typeof cleaning !== 'object' || cleaning === null)) throw invalid('`clean` must be a boolean or an options object.');\n const settings: CleanLinkOptions = cleaning === true ? {} : cleaning;\n const tracking = matcher(settings.params);\n const keep = settings.keep ?? [];\n if (!Array.isArray(keep) || !keep.every((name: unknown) => typeof name === 'string')) throw invalid('`clean.keep` must be a list of strings.');\n const kept = new Set(keep.map((name) => name.toLowerCase()));\n return (url) => {\n for (const name of [...new Set(url.searchParams.keys())]) {\n if (tracking(name) && !kept.has(name.toLowerCase())) url.searchParams.delete(name);\n }\n };\n}\n\n/**\n * Validates `options` once (throwing a typed `invalid-payload` error for invalid\n * ones) and returns a resolver that throws only for invalid links.\n * @internal\n */\nexport function linkUrlResolver(options: LinkUrlOptions = {}): (input: string | URL) => string {\n const protocols = protocolSet(options.protocols);\n const base = baseUrl(options.base);\n const clean = cleaner(options.clean);\n return (input) => {\n if (typeof input !== 'string' && !(input instanceof URL)) throw invalid('A link must be a string or a URL.');\n const raw = String(input).trim();\n if (raw === '') throw invalid('A link must not be empty.');\n let url: URL;\n try {\n url = new URL(raw, base);\n } catch (cause) {\n throw copyFailure('invalid-payload', `Not a valid link: ${JSON.stringify(raw.slice(0, 200))}.`, cause);\n }\n if (!protocols.has(url.protocol)) {\n throw invalid(`Links with the scheme \"${url.protocol}\" are not allowed (allowed: ${[...protocols].join(', ')}).`);\n }\n // Never copy or paste credentials embedded in a link.\n url.username = '';\n url.password = '';\n clean?.(url);\n return url.href;\n };\n}\n\n/**\n * The link as an absolute, safe URL string, or a typed `invalid-payload` error:\n * relative links are resolved, the scheme must be allowed, user names and\n * passwords are always removed, and tracking parameters optionally.\n */\nexport function resolveLinkUrl(input: string | URL, options: LinkUrlOptions = {}): string {\n return linkUrlResolver(options)(input);\n}\n\n/**\n * Removes tracking parameters (`utm_*`, `fbclid`, `gclid`, ...) from a link, keeping\n * everything else, including the fragment. Also validates it like every link here.\n *\n * @example\n * cleanLinkUrl('https://shop.example/p/42?utm_source=news&color=red'); // 'https://shop.example/p/42?color=red'\n */\nexport function cleanLinkUrl(url: string | URL, options: CleanLinkOptions & Omit<LinkUrlOptions, 'clean'> = {}): string {\n const { params, keep, ...rest } = options;\n return resolveLinkUrl(url, { ...rest, clean: { ...(params === undefined ? {} : { params }), ...(keep === undefined ? {} : { keep }) } });\n}\n"],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure } from "./errors-
|
|
2
|
+
import { n as copyFailure } from "./errors-CGcMvbhJ.js";
|
|
3
3
|
//#region src/link/url.ts
|
|
4
4
|
/** Schemes a copied or pasted link may use by default. Never `javascript:`, `data:`, `vbscript:` or `file:`. */
|
|
5
5
|
const DEFAULT_LINK_PROTOCOLS = /* @__PURE__ */ Object.freeze([
|
|
@@ -132,4 +132,4 @@ function cleanLinkUrl(url, options = {}) {
|
|
|
132
132
|
//#endregion
|
|
133
133
|
export { resolveLinkUrl as a, linkUrlResolver as i, TRACKING_PARAMETERS as n, cleanLinkUrl as r, DEFAULT_LINK_PROTOCOLS as t };
|
|
134
134
|
|
|
135
|
-
//# sourceMappingURL=url-
|
|
135
|
+
//# sourceMappingURL=url-zB_krkuF.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"url-
|
|
1
|
+
{"version":3,"file":"url-zB_krkuF.js","names":[],"sources":["../../src/link/url.ts"],"sourcesContent":["import { copyFailure } from '../core/errors';\n\n/** Schemes a copied or pasted link may use by default. Never `javascript:`, `data:`, `vbscript:` or `file:`. */\nexport const DEFAULT_LINK_PROTOCOLS: readonly string[] = /* @__PURE__ */ Object.freeze(['https:', 'http:', 'mailto:', 'tel:']);\n\n/**\n * Query parameters that only track where a click came from: the defaults of\n * {@link cleanLinkUrl}. `utm_` matches every parameter starting with it.\n */\nexport const TRACKING_PARAMETERS: readonly string[] = /* @__PURE__ */ Object.freeze([\n 'utm_',\n 'fbclid',\n 'gclid',\n 'gclsrc',\n 'dclid',\n 'gbraid',\n 'wbraid',\n 'msclkid',\n 'yclid',\n 'twclid',\n 'ttclid',\n 'li_fat_id',\n 'igshid',\n 'igsh',\n 'mc_cid',\n 'mc_eid',\n '_hsenc',\n '_hsmi',\n 'mkt_tok',\n 'oly_anon_id',\n 'oly_enc_id',\n 'vero_id',\n 'wickedid',\n '_gl',\n]);\n\nexport interface CleanLinkOptions {\n /**\n * Parameters to remove: exact names, names ending in `_` (a prefix, like\n * `utm_`), or regular expressions tested against the name. Default {@link TRACKING_PARAMETERS}.\n */\n readonly params?: readonly (string | RegExp)[];\n /** Parameters never removed, even when `params` matches them. */\n readonly keep?: readonly string[];\n}\n\nexport interface LinkUrlOptions {\n /** Resolves relative links. Default: the page's address in a browser; required elsewhere for relative links. */\n readonly base?: string | URL;\n /** Allowed schemes, with the colon. Default {@link DEFAULT_LINK_PROTOCOLS}. */\n readonly protocols?: readonly string[];\n /** Remove tracking parameters: `true` for {@link TRACKING_PARAMETERS}, or your own list. Default `false`. */\n readonly clean?: boolean | CleanLinkOptions;\n}\n\nconst invalid = (message: string) => copyFailure('invalid-payload', message);\n\nfunction baseUrl(base: LinkUrlOptions['base']): string | undefined {\n if (base !== undefined) {\n if (typeof base === 'string' || base instanceof URL) return String(base);\n throw invalid('`base` must be a string or a URL.');\n }\n return typeof location === 'undefined' ? undefined : location.href;\n}\n\nfunction protocolSet(protocols: LinkUrlOptions['protocols']): ReadonlySet<string> {\n const list: unknown = protocols ?? DEFAULT_LINK_PROTOCOLS;\n const valid = (protocol: unknown): protocol is string => typeof protocol === 'string' && /^[a-z][a-z\\d+.-]*:$/i.test(protocol);\n if (!Array.isArray(list) || list.length === 0 || !(list as readonly unknown[]).every(valid)) {\n throw invalid('`protocols` must be a non-empty list of schemes with their colon, like \"https:\".');\n }\n return new Set((list as readonly string[]).map((protocol) => protocol.toLowerCase()));\n}\n\nfunction matcher(params: CleanLinkOptions['params']): (name: string) => boolean {\n const list = params ?? TRACKING_PARAMETERS;\n if (!Array.isArray(list) || !list.every((param) => typeof param === 'string' || param instanceof RegExp)) {\n throw invalid('`clean.params` must be a list of strings and regular expressions.');\n }\n return (name) => {\n const lower = name.toLowerCase();\n return list.some((param) => {\n if (typeof param !== 'string') return new RegExp(param.source, param.flags.replace(/[gy]/g, '')).test(name);\n const wanted = param.toLowerCase();\n return wanted.endsWith('_') ? lower.startsWith(wanted) : lower === wanted;\n });\n };\n}\n\n/** The cleaning step `clean` asks for, or `null`. Throws for an invalid option. */\nfunction cleaner(option: LinkUrlOptions['clean']): ((url: URL) => void) | null {\n const cleaning: unknown = option ?? false; // Plain-JS callers can pass anything.\n if (cleaning === false) return null;\n if (cleaning !== true && (typeof cleaning !== 'object' || cleaning === null)) throw invalid('`clean` must be a boolean or an options object.');\n const settings: CleanLinkOptions = cleaning === true ? {} : cleaning;\n const tracking = matcher(settings.params);\n const keep = settings.keep ?? [];\n if (!Array.isArray(keep) || !keep.every((name: unknown) => typeof name === 'string')) throw invalid('`clean.keep` must be a list of strings.');\n const kept = new Set(keep.map((name) => name.toLowerCase()));\n return (url) => {\n for (const name of [...new Set(url.searchParams.keys())]) {\n if (tracking(name) && !kept.has(name.toLowerCase())) url.searchParams.delete(name);\n }\n };\n}\n\n/**\n * Validates `options` once (throwing a typed `invalid-payload` error for invalid\n * ones) and returns a resolver that throws only for invalid links.\n * @internal\n */\nexport function linkUrlResolver(options: LinkUrlOptions = {}): (input: string | URL) => string {\n const protocols = protocolSet(options.protocols);\n const base = baseUrl(options.base);\n const clean = cleaner(options.clean);\n return (input) => {\n if (typeof input !== 'string' && !(input instanceof URL)) throw invalid('A link must be a string or a URL.');\n const raw = String(input).trim();\n if (raw === '') throw invalid('A link must not be empty.');\n let url: URL;\n try {\n url = new URL(raw, base);\n } catch (cause) {\n throw copyFailure('invalid-payload', `Not a valid link: ${JSON.stringify(raw.slice(0, 200))}.`, cause);\n }\n if (!protocols.has(url.protocol)) {\n throw invalid(`Links with the scheme \"${url.protocol}\" are not allowed (allowed: ${[...protocols].join(', ')}).`);\n }\n // Never copy or paste credentials embedded in a link.\n url.username = '';\n url.password = '';\n clean?.(url);\n return url.href;\n };\n}\n\n/**\n * The link as an absolute, safe URL string, or a typed `invalid-payload` error:\n * relative links are resolved, the scheme must be allowed, user names and\n * passwords are always removed, and tracking parameters optionally.\n */\nexport function resolveLinkUrl(input: string | URL, options: LinkUrlOptions = {}): string {\n return linkUrlResolver(options)(input);\n}\n\n/**\n * Removes tracking parameters (`utm_*`, `fbclid`, `gclid`, ...) from a link, keeping\n * everything else, including the fragment. Also validates it like every link here.\n *\n * @example\n * cleanLinkUrl('https://shop.example/p/42?utm_source=news&color=red'); // 'https://shop.example/p/42?color=red'\n */\nexport function cleanLinkUrl(url: string | URL, options: CleanLinkOptions & Omit<LinkUrlOptions, 'clean'> = {}): string {\n const { params, keep, ...rest } = options;\n return resolveLinkUrl(url, { ...rest, clean: { ...(params === undefined ? {} : { params }), ...(keep === undefined ? {} : { keep }) } });\n}\n"],"mappings":"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"}
|
package/dist/code.cjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
4
|
-
const require_limits = require("./chunks/limits-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
|
+
const require_limits = require("./chunks/limits-Vy-Xv26D.cjs");
|
|
5
5
|
const require_inert_html = require("./chunks/inert-html-DyxjWDok.cjs");
|
|
6
6
|
const require_text_field = require("./chunks/text-field-BEzUVOag.cjs");
|
|
7
7
|
//#region src/code/inspect.ts
|
package/dist/code.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure, o as isCopyFailure } from "./chunks/errors-
|
|
3
|
-
import { t as positiveLimit } from "./chunks/limits-
|
|
2
|
+
import { n as copyFailure, o as isCopyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
|
+
import { t as positiveLimit } from "./chunks/limits-DvJZJn0V.js";
|
|
4
4
|
import { t as parseInertHtml } from "./chunks/inert-html-D75NyVvT.js";
|
|
5
5
|
import { n as insertText, t as asTextField } from "./chunks/text-field-D7PF2WlX.js";
|
|
6
6
|
//#region src/code/inspect.ts
|
package/dist/color.cjs
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
4
|
const require_text_field = require("./chunks/text-field-BEzUVOag.cjs");
|
|
5
|
-
const require_contrast = require("./chunks/contrast-
|
|
5
|
+
const require_contrast = require("./chunks/contrast-BatHkv8j.cjs");
|
|
6
6
|
//#region src/color/payload.ts
|
|
7
7
|
/** The sRGB hex of a colour for the swatch's inline style: always generated here, never user text. */
|
|
8
8
|
const swatchColor = (c) => require_contrast.formatColor(require_contrast.toGamut(c), "hex");
|
package/dist/color.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure } from "./chunks/errors-
|
|
2
|
+
import { n as copyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
3
|
import { n as insertText, t as asTextField } from "./chunks/text-field-D7PF2WlX.js";
|
|
4
|
-
import { a as toColor, c as inGamut, i as formatColor, l as toGamut, n as contrastRatio, o as parseColor, r as COLOR_FORMATS, t as contrastLevel } from "./chunks/contrast-
|
|
4
|
+
import { a as toColor, c as inGamut, i as formatColor, l as toGamut, n as contrastRatio, o as parseColor, r as COLOR_FORMATS, t as contrastLevel } from "./chunks/contrast-DnCunIr1.js";
|
|
5
5
|
//#region src/color/payload.ts
|
|
6
6
|
/** The sRGB hex of a colour for the swatch's inline style: always generated here, never user text. */
|
|
7
7
|
const swatchColor = (c) => formatColor(toGamut(c), "hex");
|
package/dist/core.cjs
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
4
|
-
const require_payload = require("./chunks/payload-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
|
+
const require_payload = require("./chunks/payload-DjSSLonm.cjs");
|
|
5
5
|
const require_mime = require("./chunks/mime--LB7kdqG.cjs");
|
|
6
|
-
const require_clipboard_adapter = require("./chunks/clipboard-adapter-
|
|
7
|
-
const require_core = require("./chunks/core-
|
|
8
|
-
const require_paste_reader = require("./chunks/paste-reader-
|
|
6
|
+
const require_clipboard_adapter = require("./chunks/clipboard-adapter-Bpuf5GmB.cjs");
|
|
7
|
+
const require_core = require("./chunks/core-DF6jiigD.cjs");
|
|
8
|
+
const require_paste_reader = require("./chunks/paste-reader-BL51Jt1y.cjs");
|
|
9
9
|
exports.CopyFailure = require_errors.CopyFailure;
|
|
10
10
|
exports.DEFAULT_INTERCEPTED_EVENTS = require_core.DEFAULT_INTERCEPTED_EVENTS;
|
|
11
11
|
exports.DEFAULT_MAX_RETRIES = require_core.DEFAULT_MAX_RETRIES;
|
package/dist/core.js
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
|
|
2
|
-
import { a as describePasteError, c as toCopyError, i as describeCopyError, n as copyFailure, o as isCopyFailure, r as createCopyError, s as isRetryableError, t as CopyFailure } from "./chunks/errors-
|
|
3
|
-
import { a as validatePayload, i as serializeJson, n as isBlob, r as normalizePayload, t as IMAGE_MIME_TYPE } from "./chunks/payload-
|
|
2
|
+
import { a as describePasteError, c as toCopyError, i as describeCopyError, n as copyFailure, o as isCopyFailure, r as createCopyError, s as isRetryableError, t as CopyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
|
+
import { a as validatePayload, i as serializeJson, n as isBlob, r as normalizePayload, t as IMAGE_MIME_TYPE } from "./chunks/payload-5uJedhwz.js";
|
|
4
4
|
import { a as matchesMimePattern, c as sniffImageBytes, i as isWebCustomFormat, l as sniffImageType, n as WEB_CUSTOM_FORMAT_PREFIX, o as normalizeClipboardType, r as isTextualMimeType, s as normalizeMimeType, t as SVG_MIME_TYPE } from "./chunks/mime-aa-HA2dm.js";
|
|
5
|
-
import { t as createBrowserClipboardAdapter } from "./chunks/clipboard-adapter-
|
|
6
|
-
import { _ as DEFAULT_MAX_RETRIES, a as readClipboardPermission, b as createCopyCoordinator, c as registerDragCopy, d as readCopySelection, f as registerCopyInterceptor, g as createCopyMachine, h as canRetryState, i as createBrowserPasteAdapter, l as DEFAULT_INTERCEPTED_EVENTS, m as IDLE_STATE, n as canRetryPasteState, o as watchClipboardPermission, p as DEFAULT_RESET_AFTER_MS, r as createPasteMachine, s as applyDragCopy, t as PASTE_IDLE_STATE, u as interceptCopyEvent, y as resolveMaxRetries } from "./chunks/core-
|
|
7
|
-
import { i as canAcceptDrag, l as resolvePasteReadOptions, n as DEFAULT_PASTE_MAX_BYTES, r as DEFAULT_PASTE_MAX_ITEMS, t as DEFAULT_PASTE_ACCEPT } from "./chunks/paste-reader-
|
|
5
|
+
import { t as createBrowserClipboardAdapter } from "./chunks/clipboard-adapter-DyCmyZV9.js";
|
|
6
|
+
import { _ as DEFAULT_MAX_RETRIES, a as readClipboardPermission, b as createCopyCoordinator, c as registerDragCopy, d as readCopySelection, f as registerCopyInterceptor, g as createCopyMachine, h as canRetryState, i as createBrowserPasteAdapter, l as DEFAULT_INTERCEPTED_EVENTS, m as IDLE_STATE, n as canRetryPasteState, o as watchClipboardPermission, p as DEFAULT_RESET_AFTER_MS, r as createPasteMachine, s as applyDragCopy, t as PASTE_IDLE_STATE, u as interceptCopyEvent, y as resolveMaxRetries } from "./chunks/core-88XdCKaH.js";
|
|
7
|
+
import { i as canAcceptDrag, l as resolvePasteReadOptions, n as DEFAULT_PASTE_MAX_BYTES, r as DEFAULT_PASTE_MAX_ITEMS, t as DEFAULT_PASTE_ACCEPT } from "./chunks/paste-reader-BpXOH_Px.js";
|
|
8
8
|
export { CopyFailure, DEFAULT_INTERCEPTED_EVENTS, DEFAULT_MAX_RETRIES, DEFAULT_PASTE_ACCEPT, DEFAULT_PASTE_MAX_BYTES, DEFAULT_PASTE_MAX_ITEMS, DEFAULT_RESET_AFTER_MS, IDLE_STATE, IMAGE_MIME_TYPE, PASTE_IDLE_STATE, SVG_MIME_TYPE, WEB_CUSTOM_FORMAT_PREFIX, applyDragCopy, canAcceptDrag, canRetryPasteState, canRetryState, copyFailure, createBrowserClipboardAdapter, createBrowserPasteAdapter, createCopyCoordinator, createCopyError, createCopyMachine, createPasteMachine, describeCopyError, describePasteError, interceptCopyEvent, isBlob, isCopyFailure, isRetryableError, isTextualMimeType, isWebCustomFormat, matchesMimePattern, normalizeClipboardType, normalizeMimeType, normalizePayload, readClipboardPermission, readCopySelection, registerCopyInterceptor, registerDragCopy, resolveMaxRetries, resolvePasteReadOptions, serializeJson, sniffImageBytes, sniffImageType, toCopyError, validatePayload, watchClipboardPermission };
|
package/dist/email.cjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
4
|
-
const require_limits = require("./chunks/limits-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
|
+
const require_limits = require("./chunks/limits-Vy-Xv26D.cjs");
|
|
5
5
|
const require_text_field = require("./chunks/text-field-BEzUVOag.cjs");
|
|
6
6
|
//#region src/email/address.ts
|
|
7
7
|
/** Invisible and direction-changing characters, soft hyphens and variation selectors. */
|
package/dist/email.js
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure } from "./chunks/errors-
|
|
3
|
-
import { t as positiveLimit } from "./chunks/limits-
|
|
2
|
+
import { n as copyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
|
+
import { t as positiveLimit } from "./chunks/limits-DvJZJn0V.js";
|
|
4
4
|
import { n as insertText, t as asTextField } from "./chunks/text-field-D7PF2WlX.js";
|
|
5
5
|
//#region src/email/address.ts
|
|
6
6
|
/** Invisible and direction-changing characters, soft hyphens and variation selectors. */
|
package/dist/files.cjs
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
4
|
//#region src/files/detect.ts
|
|
5
5
|
/** How many leading bytes {@link detectFileType} reads: enough for every signature and a text sniff. */
|
|
6
6
|
const FILE_SNIFF_BYTES = 8192;
|
package/dist/files.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
|
|
2
|
-
import { n as copyFailure } from "./chunks/errors-
|
|
2
|
+
import { n as copyFailure } from "./chunks/errors-CGcMvbhJ.js";
|
|
3
3
|
//#region src/files/detect.ts
|
|
4
4
|
/** How many leading bytes {@link detectFileType} reads: enough for every signature and a text sniff. */
|
|
5
5
|
const FILE_SNIFF_BYTES = 8192;
|
package/dist/image.cjs
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
|
|
2
2
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
3
|
-
const require_errors = require("./chunks/errors-
|
|
4
|
-
const require_deadline = require("./chunks/deadline-
|
|
3
|
+
const require_errors = require("./chunks/errors-CF2EQNbc.cjs");
|
|
4
|
+
const require_deadline = require("./chunks/deadline-Cz6l-PDR.cjs");
|
|
5
5
|
//#region src/image/bytes.ts
|
|
6
6
|
/** Bounds-checked reads over a byte array: out-of-range reads return `null`, never garbage. */
|
|
7
7
|
var Bytes = class Bytes {
|
|
@@ -1132,7 +1132,7 @@ async function encodeWithin(environment, image, settings) {
|
|
|
1132
1132
|
background: type === "image/jpeg" ? settings.background : null
|
|
1133
1133
|
}, signal);
|
|
1134
1134
|
} catch (cause) {
|
|
1135
|
-
throw require_errors.isCopyFailure(cause) ? cause :
|
|
1135
|
+
throw require_errors.isCopyFailure(cause) ? cause : require_deadline.blobFailure(`Encoding ${type}`, cause);
|
|
1136
1136
|
}
|
|
1137
1137
|
if (blob.type !== type) {
|
|
1138
1138
|
if (requested !== "auto") throw require_errors.copyFailure("unsupported-format", `This browser can't encode ${type}.`);
|