react-smart-copy 1.21.0 → 1.22.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 +39 -0
- package/dist/chunks/field-BTsKTs2M.d.cts +87 -0
- package/dist/chunks/field-BTsKTs2M.d.ts +87 -0
- package/dist/chunks/field-Cdq2LxEO.js +563 -0
- package/dist/chunks/field-Cdq2LxEO.js.map +1 -0
- package/dist/chunks/field-NaDdWy_5.cjs +586 -0
- package/dist/chunks/field-NaDdWy_5.cjs.map +1 -0
- package/dist/index.cjs +89 -0
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +42 -1
- package/dist/index.d.ts +42 -1
- package/dist/index.js +89 -1
- package/dist/index.js.map +1 -1
- package/dist/otp.cjs +7 -0
- package/dist/otp.d.cts +54 -0
- package/dist/otp.d.ts +54 -0
- package/dist/otp.js +2 -0
- package/package.json +37 -3
package/README.md
CHANGED
|
@@ -34,6 +34,7 @@ ID PLT-29018 [Copy]
|
|
|
34
34
|
- **`react-smart-copy/image`**: get pasted photos and screenshots ready to upload. It removes GPS location, camera data and hidden thumbnails without touching a pixel, and fits size and byte limits, re-encoding only when it has to
|
|
35
35
|
- **`react-smart-copy/files`**: take pasted and dropped files and whole folders safely. Types come from each file's content, so a program named `invoice.pdf.exe` or a web page named `report.pdf` is turned away with a reason, names are made safe for every operating system, and limits cap count, size and depth
|
|
36
36
|
- **`react-smart-copy/secrets`**: keep API keys, tokens, private keys, passwords, card numbers and IBANs out of pastes and copies. Paste guards for chat boxes and forms, and redaction of what people copy from logs and consoles. Every pattern runs in linear time, and no finding holds the secret
|
|
37
|
+
- **`react-smart-copy/otp`** and **`useOtpField`**: one-time code fields that typing, pasting a whole SMS, SMS autofill and WebOTP fill, with an accessible name on every box, and `extractOtp` to read the code in a message while leaving prices, dates, phone numbers and order numbers alone
|
|
37
38
|
- **`react-smart-copy/link`**: "Copy link" buttons that paste as a titled link in Slack, Docs and Notion and as the URL in editors, links that scroll to a highlighted passage, tracking parameters removed, and pasting a URL over selected text to make a link
|
|
38
39
|
- **`react-smart-copy/rich`**: copy styled content so it pastes as it looks in Gmail, Outlook, Apple Mail, Google Docs, Word, Notion and Slack: sanitized HTML with inline styles, email-safe colours and absolute links, plus readable plain text. Works for buttons and for Ctrl/⌘+C. And the other way: paste from Docs, Word and mail into a rich-text editor (TipTap, Lexical, `contenteditable`) as clean, semantic HTML
|
|
39
40
|
- **`react-smart-copy/color`**: copy colours in any CSS format (hex to `oklch()` and Display P3) with a swatch for Docs and Slack, paste any format into a colour field, and check WCAG contrast. Wide-gamut colours are mapped the way CSS specifies, never clipped to a wrong hue
|
|
@@ -1019,6 +1020,43 @@ paste with secrets is blocked. Scanning in the browser protects the people using
|
|
|
1019
1020
|
Scan again on your server before you store or forward text, because `scanSecrets` works the
|
|
1020
1021
|
same there.
|
|
1021
1022
|
|
|
1023
|
+
## One-time codes
|
|
1024
|
+
|
|
1025
|
+
`react-smart-copy/otp` handles the one-time codes people copy from an SMS or an e-mail.
|
|
1026
|
+
`extractOtp` finds the code in a message, and leaves prices, dates, times, phone numbers and
|
|
1027
|
+
order numbers alone. `useOtpField` (in the React entry) wires a row of single-character
|
|
1028
|
+
boxes: typing moves on, Backspace goes back, and pasting a whole message into any box fills
|
|
1029
|
+
them all. No dependencies, about 3.6 kB (about 2 kB for `extractOtp` alone).
|
|
1030
|
+
|
|
1031
|
+
```tsx
|
|
1032
|
+
import { useOtpField } from "react-smart-copy";
|
|
1033
|
+
|
|
1034
|
+
const otp = useOtpField({ length: 6, onComplete: verify });
|
|
1035
|
+
|
|
1036
|
+
<div role="group" aria-label="Verification code">
|
|
1037
|
+
{Array.from({ length: 6 }, (_, index) => (
|
|
1038
|
+
<input key={index} {...otp.getInputProps(index)} />
|
|
1039
|
+
))}
|
|
1040
|
+
</div>
|
|
1041
|
+
```
|
|
1042
|
+
|
|
1043
|
+
- **SMS autofill** on iOS and Android (`autocomplete="one-time-code"` on the first box), and
|
|
1044
|
+
the **WebOTP API** with `webOtp: true`, cancelled when the boxes unmount or the code is typed.
|
|
1045
|
+
- **Every box is named** (`Digit 1 of 6`), numeric codes get the numeric keyboard, and the
|
|
1046
|
+
arrow keys, Home, End, Backspace and Delete work as people expect.
|
|
1047
|
+
- **`extractOtp`** reads codes on their own (`482 913`), origin-bound lines
|
|
1048
|
+
(`@example.com #482913`, refused for another `domain`), and numbers next to a word that
|
|
1049
|
+
names them in twenty languages, with digits of any script. Linear time, first 100,000
|
|
1050
|
+
characters.
|
|
1051
|
+
|
|
1052
|
+
```ts
|
|
1053
|
+
import { extractOtp } from "react-smart-copy/otp";
|
|
1054
|
+
|
|
1055
|
+
extractOtp("Your verification code is 482913. It expires in 10 minutes.");
|
|
1056
|
+
// { code: "482913", source: "keyword", confidence: "high", domain: null }
|
|
1057
|
+
extractOtp("Your order 48291 of $1,249.00 ships on 24/10."); // null
|
|
1058
|
+
```
|
|
1059
|
+
|
|
1022
1060
|
## Copy links
|
|
1023
1061
|
|
|
1024
1062
|
`react-smart-copy/link` is for "Copy link" and "Share" buttons, and for fields people
|
|
@@ -1838,6 +1876,7 @@ embedded webviews. Where a capability is missing you get a typed error, never a
|
|
|
1838
1876
|
- ~~**1.19** `react-smart-copy/rich`, paste side: paste from Word, Google Docs and web pages into rich-text editors as clean, safe HTML~~ shipped
|
|
1839
1877
|
- ~~**1.20** `react-smart-copy/files` — take pasted and dropped files and folders safely: types from content, risky files rejected, safe names, limits~~ shipped
|
|
1840
1878
|
- ~~**1.21** `react-smart-copy/secrets` — find and redact API keys, tokens, private keys, passwords, cards and IBANs in pastes and copies~~ shipped
|
|
1879
|
+
- ~~**1.22** `react-smart-copy/otp` and `useOtpField` — one-time code fields filled by typing, pasting, SMS autofill and WebOTP, and codes read from pasted messages~~ shipped
|
|
1841
1880
|
|
|
1842
1881
|
Full history: [CHANGELOG.md](./CHANGELOG.md) or the [Releases page](https://suprabhat02.github.io/react-smart-copy/project/releases/).
|
|
1843
1882
|
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
|
|
2
|
+
//#region src/otp/normalize.d.ts
|
|
3
|
+
/** What a one-time code is made of. */
|
|
4
|
+
type OtpAlphabet = 'numeric' | 'alphanumeric';
|
|
5
|
+
/**
|
|
6
|
+
* `text` with its digits in ASCII and, for alphanumeric codes, its letters in upper case:
|
|
7
|
+
* full-width digits and letters, and Arabic-Indic, Devanagari and other scripts' digits,
|
|
8
|
+
* become ASCII. Other characters are kept: callers decide what to drop.
|
|
9
|
+
*/
|
|
10
|
+
declare function normalizeOtpText(text: string, alphabet: OtpAlphabet): string;
|
|
11
|
+
//#endregion
|
|
12
|
+
//#region src/otp/web-otp.d.ts
|
|
13
|
+
/**
|
|
14
|
+
* Where filling a code from an SMS (the WebOTP API) stands.
|
|
15
|
+
*
|
|
16
|
+
* - `idle`: not asked for.
|
|
17
|
+
* - `waiting`: the browser is waiting for an SMS that ends with `@your.host #code`.
|
|
18
|
+
* - `received`: it came, and filled the field.
|
|
19
|
+
* - `unsupported`: this browser has no WebOTP API (only Chrome on Android has).
|
|
20
|
+
* - `failed`: the browser refused or gave up (no permission, a timeout, an insecure page).
|
|
21
|
+
* - `aborted`: the field was detached before an SMS came.
|
|
22
|
+
*/
|
|
23
|
+
type WebOtpStatus = 'idle' | 'waiting' | 'received' | 'unsupported' | 'failed' | 'aborted';
|
|
24
|
+
//#endregion
|
|
25
|
+
//#region src/otp/field.d.ts
|
|
26
|
+
interface OtpFieldOptions {
|
|
27
|
+
/** How many characters the code has: one box each. Default 6. */
|
|
28
|
+
readonly length?: number;
|
|
29
|
+
/** Default `'numeric'`. */
|
|
30
|
+
readonly alphabet?: OtpAlphabet;
|
|
31
|
+
/**
|
|
32
|
+
* Each box's accessible name. Default `Digit 1 of 6` (`Character 1 of 6` for alphanumeric
|
|
33
|
+
* codes). Name the group around the boxes too (`role="group"` with a label).
|
|
34
|
+
*/
|
|
35
|
+
readonly label?: (index: number, length: number) => string;
|
|
36
|
+
/**
|
|
37
|
+
* Fill the code from an SMS with the WebOTP API, where the browser has it (Chrome on
|
|
38
|
+
* Android): the message must end with `@your.host #code`. Asked for when the boxes are
|
|
39
|
+
* attached; cancelled when they are detached, or when the code is typed. Default `false`.
|
|
40
|
+
*/
|
|
41
|
+
readonly webOtp?: boolean;
|
|
42
|
+
/** Called when the value changes. */
|
|
43
|
+
readonly onChange?: (snapshot: OtpSnapshot) => void;
|
|
44
|
+
/** Called when every box is filled, with the code. Again after an edit fills them anew. */
|
|
45
|
+
readonly onComplete?: (code: string) => void;
|
|
46
|
+
}
|
|
47
|
+
interface OtpSnapshot {
|
|
48
|
+
/** Each box's character: `''` for an empty box. */
|
|
49
|
+
readonly chars: readonly string[];
|
|
50
|
+
/** The characters typed so far, in order, without gaps. */
|
|
51
|
+
readonly value: string;
|
|
52
|
+
/** Every box holds a character: `value` is the code. */
|
|
53
|
+
readonly complete: boolean;
|
|
54
|
+
/** Where filling the code from an SMS stands. `idle` unless `webOtp` is on. */
|
|
55
|
+
readonly webOtp: WebOtpStatus;
|
|
56
|
+
}
|
|
57
|
+
/** The field's functions are bound: pass them around freely (`onClick={field.clear}`). */
|
|
58
|
+
interface OtpField {
|
|
59
|
+
/**
|
|
60
|
+
* Wires up the boxes (one `<input>` each, in order): their typing, pasting, autofill,
|
|
61
|
+
* keys, focus and attributes. Returns a function that undoes it. Boxes are wired to one
|
|
62
|
+
* field at a time: attaching again first detaches the previous boxes.
|
|
63
|
+
*/
|
|
64
|
+
readonly attach: (inputs: readonly HTMLInputElement[]) => () => void;
|
|
65
|
+
/** The current state. A new object after each change, the same one otherwise. */
|
|
66
|
+
readonly getSnapshot: () => OtpSnapshot;
|
|
67
|
+
/** Calls `listener` after each change. Returns a function that stops it. */
|
|
68
|
+
readonly subscribe: (listener: () => void) => () => void;
|
|
69
|
+
/** Fills the boxes with `code` from the first (characters a code can't have are dropped). */
|
|
70
|
+
readonly setValue: (code: string) => void;
|
|
71
|
+
/** Empties every box and focuses the first. */
|
|
72
|
+
readonly clear: () => void;
|
|
73
|
+
/** Focuses the first empty box (or the last, when all are filled). */
|
|
74
|
+
readonly focus: () => void;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* A one-time code field over a row of single-character boxes, without a framework:
|
|
78
|
+
* typing moves to the next box, Backspace to the one before; pasting a code, or an SMS
|
|
79
|
+
* holding one, fills every box from any of them; an SMS autofill into the first box
|
|
80
|
+
* (iOS, Android) fills them all. `useOtpField` is this, for React.
|
|
81
|
+
*
|
|
82
|
+
* @throws {CopyFailure} `invalid-payload` for a `length` that is not 1 to 32.
|
|
83
|
+
*/
|
|
84
|
+
declare function createOtpField(options?: OtpFieldOptions): OtpField;
|
|
85
|
+
//#endregion
|
|
86
|
+
export { WebOtpStatus as a, createOtpField as i, OtpFieldOptions as n, OtpAlphabet as o, OtpSnapshot as r, normalizeOtpText as s, OtpField as t };
|
|
87
|
+
//# sourceMappingURL=field-BTsKTs2M.d.cts.map
|
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
|
|
2
|
+
//#region src/otp/normalize.d.ts
|
|
3
|
+
/** What a one-time code is made of. */
|
|
4
|
+
type OtpAlphabet = 'numeric' | 'alphanumeric';
|
|
5
|
+
/**
|
|
6
|
+
* `text` with its digits in ASCII and, for alphanumeric codes, its letters in upper case:
|
|
7
|
+
* full-width digits and letters, and Arabic-Indic, Devanagari and other scripts' digits,
|
|
8
|
+
* become ASCII. Other characters are kept: callers decide what to drop.
|
|
9
|
+
*/
|
|
10
|
+
declare function normalizeOtpText(text: string, alphabet: OtpAlphabet): string;
|
|
11
|
+
//#endregion
|
|
12
|
+
//#region src/otp/web-otp.d.ts
|
|
13
|
+
/**
|
|
14
|
+
* Where filling a code from an SMS (the WebOTP API) stands.
|
|
15
|
+
*
|
|
16
|
+
* - `idle`: not asked for.
|
|
17
|
+
* - `waiting`: the browser is waiting for an SMS that ends with `@your.host #code`.
|
|
18
|
+
* - `received`: it came, and filled the field.
|
|
19
|
+
* - `unsupported`: this browser has no WebOTP API (only Chrome on Android has).
|
|
20
|
+
* - `failed`: the browser refused or gave up (no permission, a timeout, an insecure page).
|
|
21
|
+
* - `aborted`: the field was detached before an SMS came.
|
|
22
|
+
*/
|
|
23
|
+
type WebOtpStatus = 'idle' | 'waiting' | 'received' | 'unsupported' | 'failed' | 'aborted';
|
|
24
|
+
//#endregion
|
|
25
|
+
//#region src/otp/field.d.ts
|
|
26
|
+
interface OtpFieldOptions {
|
|
27
|
+
/** How many characters the code has: one box each. Default 6. */
|
|
28
|
+
readonly length?: number;
|
|
29
|
+
/** Default `'numeric'`. */
|
|
30
|
+
readonly alphabet?: OtpAlphabet;
|
|
31
|
+
/**
|
|
32
|
+
* Each box's accessible name. Default `Digit 1 of 6` (`Character 1 of 6` for alphanumeric
|
|
33
|
+
* codes). Name the group around the boxes too (`role="group"` with a label).
|
|
34
|
+
*/
|
|
35
|
+
readonly label?: (index: number, length: number) => string;
|
|
36
|
+
/**
|
|
37
|
+
* Fill the code from an SMS with the WebOTP API, where the browser has it (Chrome on
|
|
38
|
+
* Android): the message must end with `@your.host #code`. Asked for when the boxes are
|
|
39
|
+
* attached; cancelled when they are detached, or when the code is typed. Default `false`.
|
|
40
|
+
*/
|
|
41
|
+
readonly webOtp?: boolean;
|
|
42
|
+
/** Called when the value changes. */
|
|
43
|
+
readonly onChange?: (snapshot: OtpSnapshot) => void;
|
|
44
|
+
/** Called when every box is filled, with the code. Again after an edit fills them anew. */
|
|
45
|
+
readonly onComplete?: (code: string) => void;
|
|
46
|
+
}
|
|
47
|
+
interface OtpSnapshot {
|
|
48
|
+
/** Each box's character: `''` for an empty box. */
|
|
49
|
+
readonly chars: readonly string[];
|
|
50
|
+
/** The characters typed so far, in order, without gaps. */
|
|
51
|
+
readonly value: string;
|
|
52
|
+
/** Every box holds a character: `value` is the code. */
|
|
53
|
+
readonly complete: boolean;
|
|
54
|
+
/** Where filling the code from an SMS stands. `idle` unless `webOtp` is on. */
|
|
55
|
+
readonly webOtp: WebOtpStatus;
|
|
56
|
+
}
|
|
57
|
+
/** The field's functions are bound: pass them around freely (`onClick={field.clear}`). */
|
|
58
|
+
interface OtpField {
|
|
59
|
+
/**
|
|
60
|
+
* Wires up the boxes (one `<input>` each, in order): their typing, pasting, autofill,
|
|
61
|
+
* keys, focus and attributes. Returns a function that undoes it. Boxes are wired to one
|
|
62
|
+
* field at a time: attaching again first detaches the previous boxes.
|
|
63
|
+
*/
|
|
64
|
+
readonly attach: (inputs: readonly HTMLInputElement[]) => () => void;
|
|
65
|
+
/** The current state. A new object after each change, the same one otherwise. */
|
|
66
|
+
readonly getSnapshot: () => OtpSnapshot;
|
|
67
|
+
/** Calls `listener` after each change. Returns a function that stops it. */
|
|
68
|
+
readonly subscribe: (listener: () => void) => () => void;
|
|
69
|
+
/** Fills the boxes with `code` from the first (characters a code can't have are dropped). */
|
|
70
|
+
readonly setValue: (code: string) => void;
|
|
71
|
+
/** Empties every box and focuses the first. */
|
|
72
|
+
readonly clear: () => void;
|
|
73
|
+
/** Focuses the first empty box (or the last, when all are filled). */
|
|
74
|
+
readonly focus: () => void;
|
|
75
|
+
}
|
|
76
|
+
/**
|
|
77
|
+
* A one-time code field over a row of single-character boxes, without a framework:
|
|
78
|
+
* typing moves to the next box, Backspace to the one before; pasting a code, or an SMS
|
|
79
|
+
* holding one, fills every box from any of them; an SMS autofill into the first box
|
|
80
|
+
* (iOS, Android) fills them all. `useOtpField` is this, for React.
|
|
81
|
+
*
|
|
82
|
+
* @throws {CopyFailure} `invalid-payload` for a `length` that is not 1 to 32.
|
|
83
|
+
*/
|
|
84
|
+
declare function createOtpField(options?: OtpFieldOptions): OtpField;
|
|
85
|
+
//#endregion
|
|
86
|
+
export { WebOtpStatus as a, createOtpField as i, OtpFieldOptions as n, OtpAlphabet as o, OtpSnapshot as r, normalizeOtpText as s, OtpField as t };
|
|
87
|
+
//# sourceMappingURL=field-BTsKTs2M.d.ts.map
|