rregex 1.13.2 → 2.0.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/lib/esm.mjs CHANGED
@@ -1,1059 +1,1109 @@
1
- import { readFile } from "node:fs/promises";
2
-
3
-
1
+ /* @ts-self-types="./esm.d.mts" */
2
+ import { readFileSync } from "node:fs";
3
+ // js/wasm/rregex.js
4
+ let wasm;
4
5
  function addToExternrefTable0(obj) {
5
- const idx = wasm.__externref_table_alloc();
6
- wasm.__wbindgen_export_2.set(idx, obj);
7
- return idx;
6
+ const idx = wasm.__externref_table_alloc();
7
+ wasm.__wbindgen_export_2.set(idx, obj);
8
+ return idx;
8
9
  }
9
-
10
10
  function handleError(f, args) {
11
- try {
12
- return f.apply(this, args);
13
- } catch (e) {
14
- const idx = addToExternrefTable0(e);
15
- wasm.__wbindgen_exn_store(idx);
16
- }
11
+ try {
12
+ return f.apply(this, args);
13
+ } catch (e) {
14
+ const idx = addToExternrefTable0(e);
15
+ wasm.__wbindgen_exn_store(idx);
16
+ }
17
17
  }
18
-
19
- const cachedTextDecoder = (typeof TextDecoder !== 'undefined' ? new TextDecoder('utf-8', { ignoreBOM: true, fatal: true }) : { decode: () => { throw Error('TextDecoder not available') } } );
20
-
21
- if (typeof TextDecoder !== 'undefined') { cachedTextDecoder.decode(); };
22
-
18
+ const cachedTextDecoder = typeof TextDecoder !== "undefined" ? new TextDecoder("utf-8", {
19
+ ignoreBOM: true,
20
+ fatal: true
21
+ }) : { decode: () => {
22
+ throw Error("TextDecoder not available");
23
+ } };
24
+ if (typeof TextDecoder !== "undefined") cachedTextDecoder.decode();
23
25
  let cachedUint8ArrayMemory0 = null;
24
-
25
26
  function getUint8ArrayMemory0() {
26
- if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) {
27
- cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
28
- }
29
- return cachedUint8ArrayMemory0;
27
+ if (cachedUint8ArrayMemory0 === null || cachedUint8ArrayMemory0.byteLength === 0) cachedUint8ArrayMemory0 = new Uint8Array(wasm.memory.buffer);
28
+ return cachedUint8ArrayMemory0;
30
29
  }
31
-
32
30
  function getStringFromWasm0(ptr, len) {
33
- ptr = ptr >>> 0;
34
- return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
31
+ ptr = ptr >>> 0;
32
+ return cachedTextDecoder.decode(getUint8ArrayMemory0().subarray(ptr, ptr + len));
35
33
  }
36
-
37
- let WASM_VECTOR_LEN = 0;
38
-
39
- const cachedTextEncoder = (typeof TextEncoder !== 'undefined' ? new TextEncoder('utf-8') : { encode: () => { throw Error('TextEncoder not available') } } );
40
-
41
- const encodeString = function (arg, view) {
42
- return cachedTextEncoder.encodeInto(arg, view);
43
- };
44
-
45
- function passStringToWasm0(arg, malloc, realloc) {
46
-
47
- if (realloc === undefined) {
48
- const buf = cachedTextEncoder.encode(arg);
49
- const ptr = malloc(buf.length, 1) >>> 0;
50
- getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
51
- WASM_VECTOR_LEN = buf.length;
52
- return ptr;
53
- }
54
-
55
- let len = arg.length;
56
- let ptr = malloc(len, 1) >>> 0;
57
-
58
- const mem = getUint8ArrayMemory0();
59
-
60
- let offset = 0;
61
-
62
- for (; offset < len; offset++) {
63
- const code = arg.charCodeAt(offset);
64
- if (code > 0x7F) break;
65
- mem[ptr + offset] = code;
66
- }
67
-
68
- if (offset !== len) {
69
- if (offset !== 0) {
70
- arg = arg.slice(offset);
71
- }
72
- ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
73
- const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
74
- const ret = encodeString(arg, view);
75
-
76
- offset += ret.written;
77
- ptr = realloc(ptr, len, offset, 1) >>> 0;
78
- }
79
-
80
- WASM_VECTOR_LEN = offset;
81
- return ptr;
82
- }
83
-
84
34
  function isLikeNone(x) {
85
- return x === undefined || x === null;
35
+ return x === void 0 || x === null;
86
36
  }
87
-
88
37
  let cachedDataViewMemory0 = null;
89
-
90
38
  function getDataViewMemory0() {
91
- if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || (cachedDataViewMemory0.buffer.detached === undefined && cachedDataViewMemory0.buffer !== wasm.memory.buffer)) {
92
- cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
93
- }
94
- return cachedDataViewMemory0;
39
+ if (cachedDataViewMemory0 === null || cachedDataViewMemory0.buffer.detached === true || cachedDataViewMemory0.buffer.detached === void 0 && cachedDataViewMemory0.buffer !== wasm.memory.buffer) cachedDataViewMemory0 = new DataView(wasm.memory.buffer);
40
+ return cachedDataViewMemory0;
41
+ }
42
+ let WASM_VECTOR_LEN = 0;
43
+ const cachedTextEncoder = typeof TextEncoder !== "undefined" ? new TextEncoder("utf-8") : { encode: () => {
44
+ throw Error("TextEncoder not available");
45
+ } };
46
+ const encodeString = typeof cachedTextEncoder.encodeInto === "function" ? function(arg, view) {
47
+ return cachedTextEncoder.encodeInto(arg, view);
48
+ } : function(arg, view) {
49
+ const buf = cachedTextEncoder.encode(arg);
50
+ view.set(buf);
51
+ return {
52
+ read: arg.length,
53
+ written: buf.length
54
+ };
55
+ };
56
+ function passStringToWasm0(arg, malloc, realloc) {
57
+ if (realloc === void 0) {
58
+ const buf = cachedTextEncoder.encode(arg);
59
+ const ptr = malloc(buf.length, 1) >>> 0;
60
+ getUint8ArrayMemory0().subarray(ptr, ptr + buf.length).set(buf);
61
+ WASM_VECTOR_LEN = buf.length;
62
+ return ptr;
63
+ }
64
+ let len = arg.length;
65
+ let ptr = malloc(len, 1) >>> 0;
66
+ const mem = getUint8ArrayMemory0();
67
+ let offset = 0;
68
+ for (; offset < len; offset++) {
69
+ const code = arg.charCodeAt(offset);
70
+ if (code > 127) break;
71
+ mem[ptr + offset] = code;
72
+ }
73
+ if (offset !== len) {
74
+ if (offset !== 0) arg = arg.slice(offset);
75
+ ptr = realloc(ptr, len, len = offset + arg.length * 3, 1) >>> 0;
76
+ const view = getUint8ArrayMemory0().subarray(ptr + offset, ptr + len);
77
+ const ret = encodeString(arg, view);
78
+ offset += ret.written;
79
+ ptr = realloc(ptr, len, offset, 1) >>> 0;
80
+ }
81
+ WASM_VECTOR_LEN = offset;
82
+ return ptr;
95
83
  }
96
-
97
84
  function takeFromExternrefTable0(idx) {
98
- const value = wasm.__wbindgen_export_2.get(idx);
99
- wasm.__externref_table_dealloc(idx);
100
- return value;
85
+ const value = wasm.__wbindgen_export_2.get(idx);
86
+ wasm.__externref_table_dealloc(idx);
87
+ return value;
101
88
  }
102
-
103
89
  function getArrayJsValueFromWasm0(ptr, len) {
104
- ptr = ptr >>> 0;
105
- const mem = getDataViewMemory0();
106
- const result = [];
107
- for (let i = ptr; i < ptr + 4 * len; i += 4) {
108
- result.push(wasm.__wbindgen_export_2.get(mem.getUint32(i, true)));
109
- }
110
- wasm.__externref_drop_slice(ptr, len);
111
- return result;
90
+ ptr = ptr >>> 0;
91
+ const mem = getDataViewMemory0();
92
+ const result = [];
93
+ for (let i = ptr; i < ptr + 4 * len; i += 4) result.push(wasm.__wbindgen_export_2.get(mem.getUint32(i, true)));
94
+ wasm.__externref_drop_slice(ptr, len);
95
+ return result;
112
96
  }
113
97
  /**
114
- * Escapes all regular expression meta characters in `text`.
115
- *
116
- * The string returned may be safely used as a literal in a regular
117
- * expression.
118
- * @param {string} text
119
- * @returns {string}
120
- */
121
- export function escape(text) {
122
- let deferred2_0;
123
- let deferred2_1;
124
- try {
125
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
126
- const len0 = WASM_VECTOR_LEN;
127
- const ret = wasm.escape(ptr0, len0);
128
- deferred2_0 = ret[0];
129
- deferred2_1 = ret[1];
130
- return getStringFromWasm0(ret[0], ret[1]);
131
- } finally {
132
- wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
133
- }
98
+ * Escapes all regular expression meta characters in `text`.
99
+ *
100
+ * The string returned may be safely used as a literal in a regular
101
+ * expression.
102
+ * @param {string} text
103
+ * @returns {string}
104
+ */
105
+ function escape(text) {
106
+ let deferred2_0;
107
+ let deferred2_1;
108
+ try {
109
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
110
+ const len0 = WASM_VECTOR_LEN;
111
+ const ret = wasm.escape(ptr0, len0);
112
+ deferred2_0 = ret[0];
113
+ deferred2_1 = ret[1];
114
+ return getStringFromWasm0(ret[0], ret[1]);
115
+ } finally {
116
+ wasm.__wbindgen_free(deferred2_0, deferred2_1, 1);
117
+ }
134
118
  }
135
-
136
- const RRegexFinalization = (typeof FinalizationRegistry === 'undefined')
137
- ? { register: () => {}, unregister: () => {} }
138
- : new FinalizationRegistry(ptr => wasm.__wbg_rregex_free(ptr >>> 0, 1));
119
+ const RRegexFinalization = typeof FinalizationRegistry === "undefined" ? {
120
+ register: () => {},
121
+ unregister: () => {}
122
+ } : new FinalizationRegistry((ptr) => wasm.__wbg_rregex_free(ptr >>> 0, 1));
139
123
  /**
140
- * A compiled regular expression for matching Unicode strings.
141
- *
142
- * A `RRegex` can be used to search haystacks, split haystacks into substrings
143
- * or replace substrings in a haystack with a different substring. All
144
- * searching is done with an implicit `(?s:.)*?` at the beginning and end of
145
- * an pattern. To force an expression to match the whole string (or a prefix
146
- * or a suffix), you must use an anchor like `^` or `$` (or `\A` and `\z`).
147
- *
148
- * While this library will handle Unicode strings (whether in the regular
149
- * expression or in the haystack), all positions returned are **byte
150
- * offsets**. Every byte offset is guaranteed to be at a Unicode code point
151
- * boundary. That is, all offsets returned by the `RRegex` API are guaranteed
152
- * to be ranges that can slice an `Uint8Array` created with a TextEncoder.
153
- *
154
- * # Example: slicing over UTF strings
155
- *
156
- * ```typescript
157
- * import { RRegex } from "rregex"
158
- *
159
- * const re = new RRegex("ä")
160
- * const m = re.find("äöü") // { start: 0, end: 2 }
161
- *
162
- * const buff = new TextEncoder().encode("äöü")
163
- * const slice = buff.slice(m.start, m.end)
164
- * expect(new TextDecoder().decode(slice)).toBe("ä")
165
- * ```
166
- *
167
- * # Example: find the offsets of a US phone number:
168
- *
169
- * ```typescript
170
- * import { RRegex } from "rregex"
171
- *
172
- * const re = new RRegex("[0-9]{3}-[0-9]{3}-[0-9]{4}");
173
- * const m = re.find("phone: 111-222-3333");
174
- * expect(m.start).toBe(7);
175
- * expect(m.end).toBe(19);
176
- * ```
177
- *
178
- * @see https://docs.rs/regex/latest/regex/
179
- */
180
- export class RRegex {
181
-
182
- __destroy_into_raw() {
183
- const ptr = this.__wbg_ptr;
184
- this.__wbg_ptr = 0;
185
- RRegexFinalization.unregister(this);
186
- return ptr;
187
- }
188
-
189
- free() {
190
- const ptr = this.__destroy_into_raw();
191
- wasm.__wbg_rregex_free(ptr, 0);
192
- }
193
- /**
194
- * Returns the same as is_match, but starts the search at the given offset.
195
- * The significance of the starting point is that it takes the surrounding
196
- * context into consideration. For example, the `\A` anchor can only match
197
- * when `start == 0`.
198
- *
199
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.is_match_at
200
- * @param {string} text - The string against which to match the regular expression
201
- * @param {number} start - Zero-based index at which to start matching
202
- * @return {boolean}
203
- */
204
- isMatchAt(text, start) {
205
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
206
- const len0 = WASM_VECTOR_LEN;
207
- const ret = wasm.rregex_isMatchAt(this.__wbg_ptr, ptr0, len0, start);
208
- return ret !== 0;
209
- }
210
- /**
211
- * Replaces all non-overlapping matches in `text` with the replacement
212
- * provided. This is the same as calling `replacen` with `limit` set to
213
- * `0`.
214
- *
215
- * See the documentation for `replace` for details on how to access
216
- * capturing group matches in the replacement string.
217
- *
218
- * See the documentation for `replace` for details on how to access capturing group matches in the replacement string.
219
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replace_all
220
- * @param {string} text - The string against which to match the regular expression
221
- * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
222
- * @returns {string}
223
- */
224
- replaceAll(text, rep) {
225
- let deferred3_0;
226
- let deferred3_1;
227
- try {
228
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
229
- const len0 = WASM_VECTOR_LEN;
230
- const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
231
- const len1 = WASM_VECTOR_LEN;
232
- const ret = wasm.rregex_replaceAll(this.__wbg_ptr, ptr0, len0, ptr1, len1);
233
- deferred3_0 = ret[0];
234
- deferred3_1 = ret[1];
235
- return getStringFromWasm0(ret[0], ret[1]);
236
- } finally {
237
- wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
238
- }
239
- }
240
- /**
241
- * Returns a list with all the non-overlapping capture groups matched
242
- * in `text`. This is operationally the same as `findAll`, except it
243
- * returns information about capturing group matches.
244
- *
245
- * # Example
246
- *
247
- * We can use this to find all movie titles and their release years in
248
- * some text, where the movie is formatted like "'Title' (xxxx)":
249
- *
250
- * ```typescript
251
- * import { RRegex } from "rregex"
252
- *
253
- * const re = new RRegex("'(?P<title>[^']+)'\s+\((?P<year>\d{4})\)")
254
- * const text = "'Citizen Kane' (1941), 'The Wizard of Oz' (1939), 'M' (1931)."
255
- * for caps of re.captures_iter(text) {
256
- * console.log(
257
- * "Movie:", caps.name["title"].value, ","
258
- * "Released:", caps.name["year"].value
259
- * );
260
- * }
261
- * // Output:
262
- * // Movie: Citizen Kane, Released: 1941
263
- * // Movie: The Wizard of Oz, Released: 1939
264
- * // Movie: M, Released: 1931
265
- * ```
266
- *
267
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures_iter
268
- * @param {string} text - The string against which to match the regular expression
269
- * @returns {Captures[]}
270
- */
271
- capturesAll(text) {
272
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
273
- const len0 = WASM_VECTOR_LEN;
274
- const ret = wasm.rregex_capturesAll(this.__wbg_ptr, ptr0, len0);
275
- if (ret[2]) {
276
- throw takeFromExternrefTable0(ret[1]);
277
- }
278
- return takeFromExternrefTable0(ret[0]);
279
- }
280
- /**
281
- * Returns the number of captures.
282
- *
283
- * This includes all named and unnamed groups, including the implicit
284
- * unnamed group that is always present and corresponds to the entire match.
285
- *
286
- * Since the implicit unnamed group is always included in this length, the
287
- * length returned is guaranteed to be greater than zero.
288
- *
289
- * ## Example
290
- *
291
- * ```typescript
292
- * import { RRegex } from "rregex"
293
- *
294
- * const re1 = new RRegex("(?P<y>\d{4})-(?P<m>\d{2})-(?P<d>\d{2})")
295
- * expect(re1.capturesLength()).toEqual(4)
296
- *
297
- * const re2 = new RRegex("foo")
298
- * expect(re2.capturesLength()).toEqual(1)
299
- *
300
- * const re3 = new RRegex("(foo)")
301
- * expect(re3.capturesLength()).toEqual(2)
302
- *
303
- * const re4 = new RRegex("(?<a>.(?<b>.))(.)(?:.)(?<c>.)")
304
- * expect(re4.capturesLength()).toEqual(5)
305
- *
306
- * const re5 = new RRegex("[a&&b]")
307
- * expect(re5.capturesLength()).toEqual(1)
308
- * ```
309
- *
310
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures_len
311
- * @returns {number}
312
- */
313
- capturesLength() {
314
- const ret = wasm.rregex_capturesLength(this.__wbg_ptr);
315
- return ret >>> 0;
316
- }
317
- /**
318
- * Returns a list of the capture names in this regex.
319
- *
320
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.capture_names
321
- */
322
- captureNames() {
323
- const ret = wasm.rregex_captureNames(this.__wbg_ptr);
324
- var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
325
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
326
- return v1;
327
- }
328
- /**
329
- * Returns the end location of a match in the text given.
330
- *
331
- * This method may have the same performance characteristics as
332
- * `isMatch`, except it provides an end location for a match. In
333
- * particular, the location returned *may be shorter* than the proper end
334
- * of the leftmost-first match that you would find via `Regex.find`.
335
- *
336
- * Note that it is not guaranteed that this routine finds the shortest or
337
- * "earliest" possible match. Instead, the main idea of this API is that
338
- * it returns the offset at the point at which the internal regex engine
339
- * has determined that a match has occurred. This may vary depending on
340
- * which internal regex engine is used, and thus, the offset itself may
341
- * change.
342
- *
343
- * # Example
344
- *
345
- * Typically, `a+` would match the entire first sequence of `a` in some
346
- * text, but `shortest_match` can give up as soon as it sees the first
347
- * `a`.
348
- *
349
- * ```typescript
350
- * import { RRegex } from "rregex"
351
- *
352
- * const text = "aaaaa"
353
- * const = new RRegex("a+").shortest_match(text)
354
- * expect(pos).toBe(1)
355
- * ```
356
- *
357
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.shortest_match
358
- * @param {string} text - The string against which to match the regular expression
359
- * @returns {number|undefined}
360
- */
361
- shortestMatch(text) {
362
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
363
- const len0 = WASM_VECTOR_LEN;
364
- const ret = wasm.rregex_shortestMatch(this.__wbg_ptr, ptr0, len0);
365
- return ret === 0x100000001 ? undefined : ret;
366
- }
367
- /**
368
- * Returns the same as `shortest_match`, but starts the search at the
369
- * given offset.
370
- *
371
- * The significance of the starting point is that it takes the surrounding
372
- * context into consideration. For example, the `\A` anchor can only match
373
- * when `start == 0`.
374
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.shortest_match_at
375
- * @param {string} text - The string against which to match the regular expression
376
- * @param {number} start - Zero-based index at which to start matching
377
- * @returns {number|undefined}
378
- */
379
- shortestMatchAt(text, start) {
380
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
381
- const len0 = WASM_VECTOR_LEN;
382
- const ret = wasm.rregex_shortestMatchAt(this.__wbg_ptr, ptr0, len0, start);
383
- return ret === 0x100000001 ? undefined : ret;
384
- }
385
- /**
386
- * Compiles a regular expression. Once compiled, it can be used repeatedly
387
- * to search, split or replace text in a string.
388
- *
389
- * If an invalid expression is given, then an error is returned.
390
- * @param {string} re
391
- */
392
- constructor(re) {
393
- const ptr0 = passStringToWasm0(re, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
394
- const len0 = WASM_VECTOR_LEN;
395
- const ret = wasm.rregex_new(ptr0, len0);
396
- if (ret[2]) {
397
- throw takeFromExternrefTable0(ret[1]);
398
- }
399
- this.__wbg_ptr = ret[0] >>> 0;
400
- RRegexFinalization.register(this, this.__wbg_ptr, this);
401
- return this;
402
- }
403
- /**
404
- * Returns the start and end byte range of the leftmost-first match in
405
- * `text`. If no match exists, then `undefined` is returned.
406
- *
407
- * Note that this should only be used if you want to discover the position
408
- * of the match. Testing the existence of a match is faster if you use
409
- * `isMatch`.
410
- *
411
- * # Example
412
- *
413
- * Find the start and end location of the first word with exactly 13
414
- * Unicode word characters:
415
- *
416
- * ```typescript
417
- * import { RRegex } from "rregex"
418
- *
419
- * const text = "I categorically deny having triskaidekaphobia."
420
- * const m = new RRegex("\b\w{13}\b").find(text)
421
- * expect(m.start).toBe(2)
422
- * expect(m.end).toBe(15)
423
- * ```
424
- *
425
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find
426
- * @param {string} text - The string against which to match the regular expression
427
- * @return {Match}
428
- */
429
- find(text) {
430
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
431
- const len0 = WASM_VECTOR_LEN;
432
- const ret = wasm.rregex_find(this.__wbg_ptr, ptr0, len0);
433
- if (ret[2]) {
434
- throw takeFromExternrefTable0(ret[1]);
435
- }
436
- return takeFromExternrefTable0(ret[0]);
437
- }
438
- /**
439
- * Returns an iterator of substrings of `text` delimited by a match of the
440
- * regular expression. Namely, each element of the iterator corresponds to
441
- * text that *isn't* matched by the regular expression.
442
- *
443
- * This method will *not* copy the text given.
444
- *
445
- * # Example
446
- *
447
- * To split a string delimited by arbitrary amounts of spaces or tabs:
448
- *
449
- * ```typescript
450
- * import { RRegex } from "rregex"
451
- *
452
- * const re = new RRegex(r"[ \t]+")
453
- * const fields = re.split("a b c d e")
454
- * expect(fields).toEqual(["a", "b", "c", "d", "e"])
455
- * ```
456
- *
457
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.split
458
- * @param {string} text - The string against which to match the regular expression
459
- * @returns {string[]}
460
- */
461
- split(text) {
462
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
463
- const len0 = WASM_VECTOR_LEN;
464
- const ret = wasm.rregex_split(this.__wbg_ptr, ptr0, len0);
465
- var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
466
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
467
- return v2;
468
- }
469
- /**
470
- * Returns an iterator of at most `limit` substrings of `text` delimited
471
- * by a match of the regular expression. (A `limit` of `0` will return no
472
- * substrings.) Namely, each element of the iterator corresponds to text
473
- * that *isn't* matched by the regular expression. The remainder of the
474
- * string that is not split will be the last element in the iterator.
475
- *
476
- * This method will *not* copy the text given.
477
- *
478
- * # Example
479
- *
480
- * Get the first two words in some text:
481
- *
482
- * ```typescript
483
- * import { RRegex } from "rregex"
484
- *
485
- * const re = new RRegex(r"\W+")
486
- * const fields = re.splitn("Hey! How are you?", 3)
487
- * expect(fields).toEqual(["Hey", "How", "are you?"])
488
- * ```
489
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.splitn
490
- * @param {string} text - The string against which to match the regular expression
491
- * @param {number} limit - Max number result elements
492
- * @returns {string[]}
493
- */
494
- splitn(text, limit) {
495
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
496
- const len0 = WASM_VECTOR_LEN;
497
- const ret = wasm.rregex_splitn(this.__wbg_ptr, ptr0, len0, limit);
498
- var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
499
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
500
- return v2;
501
- }
502
- /**
503
- * Returns the regular expression into a high level intermediate
504
- * representation.
505
- * @returns {any}
506
- */
507
- syntax() {
508
- const ret = wasm.rregex_syntax(this.__wbg_ptr);
509
- if (ret[2]) {
510
- throw takeFromExternrefTable0(ret[1]);
511
- }
512
- return takeFromExternrefTable0(ret[0]);
513
- }
514
- /**
515
- * Returns the same as find, but starts the search at the given
516
- * offset.
517
- *
518
- * The significance of the starting point is that it takes the surrounding
519
- * context into consideration. For example, the `\A` anchor can only
520
- * match when `start == 0`.
521
- *
522
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find_at
523
- * @param {string} text - The string against which to match the regular expression
524
- * @param {number} start - Zero-based index at which to start matching
525
- * @returns {Match}
526
- */
527
- findAt(text, start) {
528
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
529
- const len0 = WASM_VECTOR_LEN;
530
- const ret = wasm.rregex_findAt(this.__wbg_ptr, ptr0, len0, start);
531
- if (ret[2]) {
532
- throw takeFromExternrefTable0(ret[1]);
533
- }
534
- return takeFromExternrefTable0(ret[0]);
535
- }
536
- /**
537
- * Replaces the leftmost-first match with the replacement provided.
538
- * The replacement can be a regular string (where `$N` and `$name` are
539
- * expanded to match capture groups) or a function that takes the matches'
540
- * `Captures` and returns the replaced string.
541
- *
542
- * If no match is found, then a copy of the string is returned unchanged.
543
- *
544
- * # Replacement string syntax
545
- *
546
- * All instances of `$name` in the replacement text is replaced with the
547
- * corresponding capture group `name`.
548
- *
549
- * `name` may be an integer corresponding to the index of the
550
- * capture group (counted by order of opening parenthesis where `0` is the
551
- * entire match) or it can be a name (consisting of letters, digits or
552
- * underscores) corresponding to a named capture group.
553
- *
554
- * If `name` isn't a valid capture group (whether the name doesn't exist
555
- * or isn't a valid index), then it is replaced with the empty string.
556
- *
557
- * The longest possible name is used. e.g., `$1a` looks up the capture
558
- * group named `1a` and not the capture group at index `1`. To exert more
559
- * precise control over the name, use braces, e.g., `${1}a`.
560
- *
561
- * To write a literal `$` use `$$`.
562
- *
563
- * # Examples
564
- *
565
- * Note that this function is polymorphic with respect to the replacement.
566
- * In typical usage, this can just be a normal string:
567
- *
568
- * ```typescript
569
- * import { RRegex } from "rregex"
570
- *
571
- * const re = new RRegex("[^01]+")
572
- * expect(re.replace("1078910", "").toBe("1010")
573
- * ```
574
- *
575
- * Here's the example using this expansion technique with named capture
576
- * groups:
577
- *
578
- * ```typescript
579
- * import { RRegex } from "rregex"
580
- *
581
- * const re = new RRegex("(?P<last>[^,\s]+),\s+(?P<first>\S+)")
582
- * const result = re.replace("Springsteen, Bruce", "$first $last")
583
- * expect(result).toBe("Bruce Springsteen")
584
- * ```
585
- *
586
- * Note that using `$2` instead of `$first` or `$1` instead of `$last`
587
- * would produce the same result. To write a literal `$` use `$$`.
588
- *
589
- * Sometimes the replacement string requires use of curly braces to
590
- * delineate a capture group replacement and surrounding literal text.
591
- * For example, if we wanted to join two words together with an
592
- * underscore:
593
- *
594
- * ```typescript
595
- * import { RRegex } from "rregex"
596
- *
597
- * const re = new RRegex("(?P<first>\w+)\s+(?P<second>\w+)")
598
- * const result = re.replace("deep fried", "${first}_$second")
599
- * expect(result).toBe("deep_fried")
600
- * ```
601
- *
602
- * Without the curly braces, the capture group name `first_` would be
603
- * used, and since it doesn't exist, it would be replaced with the empty
604
- * string.
605
- *
606
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replace
607
- * @param {string} text - The string against which to match the regular expression
608
- * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
609
- * @returns {string}
610
- */
611
- replace(text, rep) {
612
- let deferred3_0;
613
- let deferred3_1;
614
- try {
615
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
616
- const len0 = WASM_VECTOR_LEN;
617
- const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
618
- const len1 = WASM_VECTOR_LEN;
619
- const ret = wasm.rregex_replace(this.__wbg_ptr, ptr0, len0, ptr1, len1);
620
- deferred3_0 = ret[0];
621
- deferred3_1 = ret[1];
622
- return getStringFromWasm0(ret[0], ret[1]);
623
- } finally {
624
- wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
625
- }
626
- }
627
- /**
628
- * Returns the capture groups corresponding to the leftmost-first
629
- * match in `text`. Capture group `0` always corresponds to the entire
630
- * match. If no match is found, then `undefined` is returned.
631
- *
632
- * You should only use `captures` if you need access to the location of
633
- * capturing group matches. Otherwise, `find` is faster for discovering
634
- * the location of the overall match.
635
- *
636
- * # Examples
637
- *
638
- * Say you have some text with movie names and their release years,
639
- * like "'Citizen Kane' (1941)". It'd be nice if we could search for text
640
- * looking like that, while also extracting the movie name and its release
641
- * year separately.
642
- *
643
- * ```typescript
644
- * import { RRegex } from "rregex"
645
- *
646
- * const re = new RRegex("'([^']+)'\s+\((\d{4})\)")
647
- * const text = "Not my favorite movie: 'Citizen Kane' (1941)."
648
- * const caps = re.captures(text)
649
- * expect(caps.get[1].value).toBe("Citizen Kane")
650
- * expect(caps.get[2].value).toBe("1941")
651
- * expect(caps.get[0].value).toBe("'Citizen Kane' (1941)")
652
- * ```
653
- *
654
- * Note that the full match is at capture group `0`. Each subsequent
655
- * capture group is indexed by the order of its opening `(`.
656
- *
657
- * We can make this example a bit clearer by using *named* capture groups:
658
- *
659
- * ```typescript
660
- * import { RRegex } from "rregex"
661
- *
662
- * const re = new RRegex("'(?P<title>[^']+)'\s+\((?P<year>\d{4})\)")
663
- * const text = "Not my favorite movie: 'Citizen Kane' (1941)."
664
- * const caps = re.captures(text)
665
- * expect(caps.name["title"].value).toBe("Citizen Kane")
666
- * expect(caps.name["year"].value).toBe("1941")
667
- * expect(caps.get[0].value).toBe("'Citizen Kane' (1941)")
668
- * ```
669
- *
670
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures
671
- * @param {string} text - The string against which to match the regular expression
672
- * @returns {Captures|undefined}
673
- */
674
- captures(text) {
675
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
676
- const len0 = WASM_VECTOR_LEN;
677
- const ret = wasm.rregex_captures(this.__wbg_ptr, ptr0, len0);
678
- if (ret[2]) {
679
- throw takeFromExternrefTable0(ret[1]);
680
- }
681
- return takeFromExternrefTable0(ret[0]);
682
- }
683
- /**
684
- * Returns an array for each successive non-overlapping match in `text``,
685
- * returning the start and end byte indices with respect to `text`.
686
- *
687
- * # Example
688
- *
689
- * Find the start and end location of every word with exactly 13 Unicode
690
- * word characters:
691
- *
692
- * ```typescript
693
- * import { RRegex } from "rregex"
694
- *
695
- * const text = "Retroactively relinquishing remunerations is reprehensible."
696
- * const matches = new RRegex("\b\w{13}\b").findAll(text)
697
- * ```
698
- *
699
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find_iter
700
- * @param {string} text - The string against which to match the regular expression
701
- * @returns {Match}
702
- */
703
- findAll(text) {
704
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
705
- const len0 = WASM_VECTOR_LEN;
706
- const ret = wasm.rregex_findAll(this.__wbg_ptr, ptr0, len0);
707
- if (ret[2]) {
708
- throw takeFromExternrefTable0(ret[1]);
709
- }
710
- return takeFromExternrefTable0(ret[0]);
711
- }
712
- /**
713
- * Returns true if and only if there is a match for the regex in the
714
- * string given.
715
- *
716
- * It is recommended to use this method if all you need to do is test
717
- * a match, since the underlying matching engine may be able to do less
718
- * work.
719
- *
720
- * # Example
721
- *
722
- * Test if some text contains at least one word with exactly 13
723
- * Unicode word characters:
724
- *
725
- * ```typescript
726
- * import { RRegex } from "rregex"
727
- *
728
- * const text = "I categorically deny having triskaidekaphobia."
729
- * expect(new RRegex("\b\w{13}\b").is_match(text)).toBe(true)
730
- * ```
731
- *
732
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.is_match
733
- * @param {string} text - The string against which to match the regular expression
734
- * @return {boolean}
735
- */
736
- isMatch(text) {
737
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
738
- const len0 = WASM_VECTOR_LEN;
739
- const ret = wasm.rregex_isMatch(this.__wbg_ptr, ptr0, len0);
740
- return ret !== 0;
741
- }
742
- /**
743
- * Replaces at most `limit` non-overlapping matches in `text` with the
744
- * replacement provided. If `limit` is 0, then all non-overlapping matches
745
- * are replaced.
746
- *
747
- * See the documentation for `replace` for details on how to access
748
- * capturing group matches in the replacement string.
749
- *
750
- * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replacen
751
- * @param {string} text - The string against which to match the regular expression
752
- * @param {number} limit - Max number of replacement
753
- * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
754
- * @returns {string}
755
- */
756
- replacen(text, limit, rep) {
757
- let deferred3_0;
758
- let deferred3_1;
759
- try {
760
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
761
- const len0 = WASM_VECTOR_LEN;
762
- const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
763
- const len1 = WASM_VECTOR_LEN;
764
- const ret = wasm.rregex_replacen(this.__wbg_ptr, ptr0, len0, limit, ptr1, len1);
765
- deferred3_0 = ret[0];
766
- deferred3_1 = ret[1];
767
- return getStringFromWasm0(ret[0], ret[1]);
768
- } finally {
769
- wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
770
- }
771
- }
772
- /**
773
- * Returns a string representing the regular expression
774
- * @returns {string}
775
- */
776
- toString() {
777
- let deferred1_0;
778
- let deferred1_1;
779
- try {
780
- const ret = wasm.rregex_toString(this.__wbg_ptr);
781
- deferred1_0 = ret[0];
782
- deferred1_1 = ret[1];
783
- return getStringFromWasm0(ret[0], ret[1]);
784
- } finally {
785
- wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
786
- }
787
- }
788
- }
789
-
790
- const RRegexSetFinalization = (typeof FinalizationRegistry === 'undefined')
791
- ? { register: () => {}, unregister: () => {} }
792
- : new FinalizationRegistry(ptr => wasm.__wbg_rregexset_free(ptr >>> 0, 1));
124
+ * A compiled regular expression for matching Unicode strings.
125
+ *
126
+ * A `RRegex` can be used to search haystacks, split haystacks into substrings
127
+ * or replace substrings in a haystack with a different substring. All
128
+ * searching is done with an implicit `(?s:.)*?` at the beginning and end of
129
+ * an pattern. To force an expression to match the whole string (or a prefix
130
+ * or a suffix), you must use an anchor like `^` or `$` (or `\A` and `\z`).
131
+ *
132
+ * While this library will handle Unicode strings (whether in the regular
133
+ * expression or in the haystack), all positions returned are **byte
134
+ * offsets**. Every byte offset is guaranteed to be at a Unicode code point
135
+ * boundary. That is, all offsets returned by the `RRegex` API are guaranteed
136
+ * to be ranges that can slice an `Uint8Array` created with a TextEncoder.
137
+ *
138
+ * # Example: slicing over UTF strings
139
+ *
140
+ * ```typescript
141
+ * import { RRegex } from "rregex"
142
+ *
143
+ * const re = new RRegex("ä")
144
+ * const m = re.find("äöü") // { start: 0, end: 2 }
145
+ *
146
+ * const buff = new TextEncoder().encode("äöü")
147
+ * const slice = buff.slice(m.start, m.end)
148
+ * expect(new TextDecoder().decode(slice)).toBe("ä")
149
+ * ```
150
+ *
151
+ * # Example: find the offsets of a US phone number:
152
+ *
153
+ * ```typescript
154
+ * import { RRegex } from "rregex"
155
+ *
156
+ * const re = new RRegex("[0-9]{3}-[0-9]{3}-[0-9]{4}");
157
+ * const m = re.find("phone: 111-222-3333");
158
+ * expect(m.start).toBe(7);
159
+ * expect(m.end).toBe(19);
160
+ * ```
161
+ *
162
+ * @see https://docs.rs/regex/latest/regex/
163
+ */
164
+ var RRegex = class {
165
+ __destroy_into_raw() {
166
+ const ptr = this.__wbg_ptr;
167
+ this.__wbg_ptr = 0;
168
+ RRegexFinalization.unregister(this);
169
+ return ptr;
170
+ }
171
+ free() {
172
+ const ptr = this.__destroy_into_raw();
173
+ wasm.__wbg_rregex_free(ptr, 0);
174
+ }
175
+ /**
176
+ * Returns the same as is_match, but starts the search at the given offset.
177
+ * The significance of the starting point is that it takes the surrounding
178
+ * context into consideration. For example, the `\A` anchor can only match
179
+ * when `start == 0`.
180
+ *
181
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.is_match_at
182
+ * @param {string} text - The string against which to match the regular expression
183
+ * @param {number} start - Zero-based index at which to start matching
184
+ * @return {boolean}
185
+ */
186
+ isMatchAt(text, start) {
187
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
188
+ const len0 = WASM_VECTOR_LEN;
189
+ return wasm.rregex_isMatchAt(this.__wbg_ptr, ptr0, len0, start) !== 0;
190
+ }
191
+ /**
192
+ * Replaces all non-overlapping matches in `text` with the replacement
193
+ * provided. This is the same as calling `replacen` with `limit` set to
194
+ * `0`.
195
+ *
196
+ * See the documentation for `replace` for details on how to access
197
+ * capturing group matches in the replacement string.
198
+ *
199
+ * See the documentation for `replace` for details on how to access capturing group matches in the replacement string.
200
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replace_all
201
+ * @param {string} text - The string against which to match the regular expression
202
+ * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
203
+ * @returns {string}
204
+ */
205
+ replaceAll(text, rep) {
206
+ let deferred3_0;
207
+ let deferred3_1;
208
+ try {
209
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
210
+ const len0 = WASM_VECTOR_LEN;
211
+ const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
212
+ const len1 = WASM_VECTOR_LEN;
213
+ const ret = wasm.rregex_replaceAll(this.__wbg_ptr, ptr0, len0, ptr1, len1);
214
+ deferred3_0 = ret[0];
215
+ deferred3_1 = ret[1];
216
+ return getStringFromWasm0(ret[0], ret[1]);
217
+ } finally {
218
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
219
+ }
220
+ }
221
+ /**
222
+ * Returns a list with all the non-overlapping capture groups matched
223
+ * in `text`. This is operationally the same as `findAll`, except it
224
+ * returns information about capturing group matches.
225
+ *
226
+ * # Example
227
+ *
228
+ * We can use this to find all movie titles and their release years in
229
+ * some text, where the movie is formatted like "'Title' (xxxx)":
230
+ *
231
+ * ```typescript
232
+ * import { RRegex } from "rregex"
233
+ *
234
+ * const re = new RRegex("'(?P<title>[^']+)'\\s+\\((?P<year>\\d{4})\\)")
235
+ * const text = "'Citizen Kane' (1941), 'The Wizard of Oz' (1939), 'M' (1931)."
236
+ * for caps of re.captures_iter(text) {
237
+ * console.log(
238
+ * "Movie:", caps.name["title"].value, ","
239
+ * "Released:", caps.name["year"].value
240
+ * );
241
+ * }
242
+ * // Output:
243
+ * // Movie: Citizen Kane, Released: 1941
244
+ * // Movie: The Wizard of Oz, Released: 1939
245
+ * // Movie: M, Released: 1931
246
+ * ```
247
+ *
248
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures_iter
249
+ * @param {string} text - The string against which to match the regular expression
250
+ * @returns {Captures[]}
251
+ */
252
+ capturesAll(text) {
253
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
254
+ const len0 = WASM_VECTOR_LEN;
255
+ const ret = wasm.rregex_capturesAll(this.__wbg_ptr, ptr0, len0);
256
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
257
+ return takeFromExternrefTable0(ret[0]);
258
+ }
259
+ /**
260
+ * Returns the number of captures.
261
+ *
262
+ * This includes all named and unnamed groups, including the implicit
263
+ * unnamed group that is always present and corresponds to the entire match.
264
+ *
265
+ * Since the implicit unnamed group is always included in this length, the
266
+ * length returned is guaranteed to be greater than zero.
267
+ *
268
+ * ## Example
269
+ *
270
+ * ```typescript
271
+ * import { RRegex } from "rregex"
272
+ *
273
+ * const re1 = new RRegex("(?P<y>\\d{4})-(?P<m>\\d{2})-(?P<d>\\d{2})")
274
+ * expect(re1.capturesLength()).toEqual(4)
275
+ *
276
+ * const re2 = new RRegex("foo")
277
+ * expect(re2.capturesLength()).toEqual(1)
278
+ *
279
+ * const re3 = new RRegex("(foo)")
280
+ * expect(re3.capturesLength()).toEqual(2)
281
+ *
282
+ * const re4 = new RRegex("(?<a>.(?<b>.))(.)(?:.)(?<c>.)")
283
+ * expect(re4.capturesLength()).toEqual(5)
284
+ *
285
+ * const re5 = new RRegex("[a&&b]")
286
+ * expect(re5.capturesLength()).toEqual(1)
287
+ * ```
288
+ *
289
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures_len
290
+ * @returns {number}
291
+ */
292
+ capturesLength() {
293
+ return wasm.rregex_capturesLength(this.__wbg_ptr) >>> 0;
294
+ }
295
+ /**
296
+ * Returns a list of the capture names in this regex.
297
+ *
298
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.capture_names
299
+ */
300
+ captureNames() {
301
+ const ret = wasm.rregex_captureNames(this.__wbg_ptr);
302
+ var v1 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
303
+ wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
304
+ return v1;
305
+ }
306
+ /**
307
+ * Returns the end location of a match in the text given.
308
+ *
309
+ * This method may have the same performance characteristics as
310
+ * `isMatch`, except it provides an end location for a match. In
311
+ * particular, the location returned *may be shorter* than the proper end
312
+ * of the leftmost-first match that you would find via `Regex.find`.
313
+ *
314
+ * Note that it is not guaranteed that this routine finds the shortest or
315
+ * "earliest" possible match. Instead, the main idea of this API is that
316
+ * it returns the offset at the point at which the internal regex engine
317
+ * has determined that a match has occurred. This may vary depending on
318
+ * which internal regex engine is used, and thus, the offset itself may
319
+ * change.
320
+ *
321
+ * # Example
322
+ *
323
+ * Typically, `a+` would match the entire first sequence of `a` in some
324
+ * text, but `shortest_match` can give up as soon as it sees the first
325
+ * `a`.
326
+ *
327
+ * ```typescript
328
+ * import { RRegex } from "rregex"
329
+ *
330
+ * const text = "aaaaa"
331
+ * const = new RRegex("a+").shortest_match(text)
332
+ * expect(pos).toBe(1)
333
+ * ```
334
+ *
335
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.shortest_match
336
+ * @param {string} text - The string against which to match the regular expression
337
+ * @returns {number|undefined}
338
+ */
339
+ shortestMatch(text) {
340
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
341
+ const len0 = WASM_VECTOR_LEN;
342
+ const ret = wasm.rregex_shortestMatch(this.__wbg_ptr, ptr0, len0);
343
+ return ret === 4294967297 ? void 0 : ret;
344
+ }
345
+ /**
346
+ * Returns the same as `shortest_match`, but starts the search at the
347
+ * given offset.
348
+ *
349
+ * The significance of the starting point is that it takes the surrounding
350
+ * context into consideration. For example, the `\A` anchor can only match
351
+ * when `start == 0`.
352
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.shortest_match_at
353
+ * @param {string} text - The string against which to match the regular expression
354
+ * @param {number} start - Zero-based index at which to start matching
355
+ * @returns {number|undefined}
356
+ */
357
+ shortestMatchAt(text, start) {
358
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
359
+ const len0 = WASM_VECTOR_LEN;
360
+ const ret = wasm.rregex_shortestMatchAt(this.__wbg_ptr, ptr0, len0, start);
361
+ return ret === 4294967297 ? void 0 : ret;
362
+ }
363
+ /**
364
+ * Compiles a regular expression. Once compiled, it can be used repeatedly
365
+ * to search, split or replace text in a string.
366
+ *
367
+ * If an invalid expression is given, then an error is returned.
368
+ * Options only apply to this instance, see `RRegexOptions`.
369
+ * @param {string} re
370
+ * @param {RRegexOptions | null} [options]
371
+ */
372
+ constructor(re, options) {
373
+ const ptr0 = passStringToWasm0(re, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
374
+ const len0 = WASM_VECTOR_LEN;
375
+ const ret = wasm.rregex_new(ptr0, len0, isLikeNone(options) ? 0 : addToExternrefTable0(options));
376
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
377
+ this.__wbg_ptr = ret[0] >>> 0;
378
+ RRegexFinalization.register(this, this.__wbg_ptr, this);
379
+ return this;
380
+ }
381
+ /**
382
+ * Returns the start and end byte range of the leftmost-first match in
383
+ * `text`. If no match exists, then `undefined` is returned.
384
+ *
385
+ * Note that this should only be used if you want to discover the position
386
+ * of the match. Testing the existence of a match is faster if you use
387
+ * `isMatch`.
388
+ *
389
+ * # Example
390
+ *
391
+ * Find the start and end location of the first word with exactly 13
392
+ * Unicode word characters:
393
+ *
394
+ * ```typescript
395
+ * import { RRegex } from "rregex"
396
+ *
397
+ * const text = "I categorically deny having triskaidekaphobia."
398
+ * const m = new RRegex("\\b\\w{13}\\b").find(text)
399
+ * expect(m.start).toBe(2)
400
+ * expect(m.end).toBe(15)
401
+ * ```
402
+ *
403
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find
404
+ * @param {string} text - The string against which to match the regular expression
405
+ * @return {Match}
406
+ */
407
+ find(text) {
408
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
409
+ const len0 = WASM_VECTOR_LEN;
410
+ const ret = wasm.rregex_find(this.__wbg_ptr, ptr0, len0);
411
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
412
+ return takeFromExternrefTable0(ret[0]);
413
+ }
414
+ /**
415
+ * Returns an iterator of substrings of `text` delimited by a match of the
416
+ * regular expression. Namely, each element of the iterator corresponds to
417
+ * text that *isn't* matched by the regular expression.
418
+ *
419
+ * This method will *not* copy the text given.
420
+ *
421
+ * # Example
422
+ *
423
+ * To split a string delimited by arbitrary amounts of spaces or tabs:
424
+ *
425
+ * ```typescript
426
+ * import { RRegex } from "rregex"
427
+ *
428
+ * const re = new RRegex(r"[ \\t]+")
429
+ * const fields = re.split("a b \t c\td e")
430
+ * expect(fields).toEqual(["a", "b", "c", "d", "e"])
431
+ * ```
432
+ *
433
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.split
434
+ * @param {string} text - The string against which to match the regular expression
435
+ * @returns {string[]}
436
+ */
437
+ split(text) {
438
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
439
+ const len0 = WASM_VECTOR_LEN;
440
+ const ret = wasm.rregex_split(this.__wbg_ptr, ptr0, len0);
441
+ var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
442
+ wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
443
+ return v2;
444
+ }
445
+ /**
446
+ * Returns an iterator of at most `limit` substrings of `text` delimited
447
+ * by a match of the regular expression. (A `limit` of `0` will return no
448
+ * substrings.) Namely, each element of the iterator corresponds to text
449
+ * that *isn't* matched by the regular expression. The remainder of the
450
+ * string that is not split will be the last element in the iterator.
451
+ *
452
+ * This method will *not* copy the text given.
453
+ *
454
+ * # Example
455
+ *
456
+ * Get the first two words in some text:
457
+ *
458
+ * ```typescript
459
+ * import { RRegex } from "rregex"
460
+ *
461
+ * const re = new RRegex(r"\\W+")
462
+ * const fields = re.splitn("Hey! How are you?", 3)
463
+ * expect(fields).toEqual(["Hey", "How", "are you?"])
464
+ * ```
465
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.splitn
466
+ * @param {string} text - The string against which to match the regular expression
467
+ * @param {number} limit - Max number result elements
468
+ * @returns {string[]}
469
+ */
470
+ splitn(text, limit) {
471
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
472
+ const len0 = WASM_VECTOR_LEN;
473
+ const ret = wasm.rregex_splitn(this.__wbg_ptr, ptr0, len0, limit);
474
+ var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
475
+ wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
476
+ return v2;
477
+ }
478
+ /**
479
+ * Returns the regular expression into a high level intermediate
480
+ * representation.
481
+ * @returns {Hir}
482
+ */
483
+ syntax() {
484
+ const ret = wasm.rregex_syntax(this.__wbg_ptr);
485
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
486
+ return takeFromExternrefTable0(ret[0]);
487
+ }
488
+ /**
489
+ * Returns the same as find, but starts the search at the given
490
+ * offset.
491
+ *
492
+ * The significance of the starting point is that it takes the surrounding
493
+ * context into consideration. For example, the `\A` anchor can only
494
+ * match when `start == 0`.
495
+ *
496
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find_at
497
+ * @param {string} text - The string against which to match the regular expression
498
+ * @param {number} start - Zero-based index at which to start matching
499
+ * @returns {Match}
500
+ */
501
+ findAt(text, start) {
502
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
503
+ const len0 = WASM_VECTOR_LEN;
504
+ const ret = wasm.rregex_findAt(this.__wbg_ptr, ptr0, len0, start);
505
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
506
+ return takeFromExternrefTable0(ret[0]);
507
+ }
508
+ /**
509
+ * Replaces the leftmost-first match with the replacement provided.
510
+ * The replacement can be a regular string (where `$N` and `$name` are
511
+ * expanded to match capture groups) or a function that takes the matches'
512
+ * `Captures` and returns the replaced string.
513
+ *
514
+ * If no match is found, then a copy of the string is returned unchanged.
515
+ *
516
+ * # Replacement string syntax
517
+ *
518
+ * All instances of `$name` in the replacement text is replaced with the
519
+ * corresponding capture group `name`.
520
+ *
521
+ * `name` may be an integer corresponding to the index of the
522
+ * capture group (counted by order of opening parenthesis where `0` is the
523
+ * entire match) or it can be a name (consisting of letters, digits or
524
+ * underscores) corresponding to a named capture group.
525
+ *
526
+ * If `name` isn't a valid capture group (whether the name doesn't exist
527
+ * or isn't a valid index), then it is replaced with the empty string.
528
+ *
529
+ * The longest possible name is used. e.g., `$1a` looks up the capture
530
+ * group named `1a` and not the capture group at index `1`. To exert more
531
+ * precise control over the name, use braces, e.g., `${1}a`.
532
+ *
533
+ * To write a literal `$` use `$$`.
534
+ *
535
+ * # Examples
536
+ *
537
+ * Note that this function is polymorphic with respect to the replacement.
538
+ * In typical usage, this can just be a normal string:
539
+ *
540
+ * ```typescript
541
+ * import { RRegex } from "rregex"
542
+ *
543
+ * const re = new RRegex("[^01]+")
544
+ * expect(re.replace("1078910", "").toBe("1010")
545
+ * ```
546
+ *
547
+ * Here's the example using this expansion technique with named capture
548
+ * groups:
549
+ *
550
+ * ```typescript
551
+ * import { RRegex } from "rregex"
552
+ *
553
+ * const re = new RRegex("(?P<last>[^,\\s]+),\\s+(?P<first>\\S+)")
554
+ * const result = re.replace("Springsteen, Bruce", "$first $last")
555
+ * expect(result).toBe("Bruce Springsteen")
556
+ * ```
557
+ *
558
+ * Note that using `$2` instead of `$first` or `$1` instead of `$last`
559
+ * would produce the same result. To write a literal `$` use `$$`.
560
+ *
561
+ * Sometimes the replacement string requires use of curly braces to
562
+ * delineate a capture group replacement and surrounding literal text.
563
+ * For example, if we wanted to join two words together with an
564
+ * underscore:
565
+ *
566
+ * ```typescript
567
+ * import { RRegex } from "rregex"
568
+ *
569
+ * const re = new RRegex("(?P<first>\\w+)\\s+(?P<second>\\w+)")
570
+ * const result = re.replace("deep fried", "${first}_$second")
571
+ * expect(result).toBe("deep_fried")
572
+ * ```
573
+ *
574
+ * Without the curly braces, the capture group name `first_` would be
575
+ * used, and since it doesn't exist, it would be replaced with the empty
576
+ * string.
577
+ *
578
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replace
579
+ * @param {string} text - The string against which to match the regular expression
580
+ * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
581
+ * @returns {string}
582
+ */
583
+ replace(text, rep) {
584
+ let deferred3_0;
585
+ let deferred3_1;
586
+ try {
587
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
588
+ const len0 = WASM_VECTOR_LEN;
589
+ const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
590
+ const len1 = WASM_VECTOR_LEN;
591
+ const ret = wasm.rregex_replace(this.__wbg_ptr, ptr0, len0, ptr1, len1);
592
+ deferred3_0 = ret[0];
593
+ deferred3_1 = ret[1];
594
+ return getStringFromWasm0(ret[0], ret[1]);
595
+ } finally {
596
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
597
+ }
598
+ }
599
+ /**
600
+ * Returns the capture groups corresponding to the leftmost-first
601
+ * match in `text`. Capture group `0` always corresponds to the entire
602
+ * match. If no match is found, then `undefined` is returned.
603
+ *
604
+ * You should only use `captures` if you need access to the location of
605
+ * capturing group matches. Otherwise, `find` is faster for discovering
606
+ * the location of the overall match.
607
+ *
608
+ * # Examples
609
+ *
610
+ * Say you have some text with movie names and their release years,
611
+ * like "'Citizen Kane' (1941)". It'd be nice if we could search for text
612
+ * looking like that, while also extracting the movie name and its release
613
+ * year separately.
614
+ *
615
+ * ```typescript
616
+ * import { RRegex } from "rregex"
617
+ *
618
+ * const re = new RRegex("'([^']+)'\\s+\\((\\d{4})\)")
619
+ * const text = "Not my favorite movie: 'Citizen Kane' (1941)."
620
+ * const caps = re.captures(text)
621
+ * expect(caps.get[1].value).toBe("Citizen Kane")
622
+ * expect(caps.get[2].value).toBe("1941")
623
+ * expect(caps.get[0].value).toBe("'Citizen Kane' (1941)")
624
+ * ```
625
+ *
626
+ * Note that the full match is at capture group `0`. Each subsequent
627
+ * capture group is indexed by the order of its opening `(`.
628
+ *
629
+ * We can make this example a bit clearer by using *named* capture groups:
630
+ *
631
+ * ```typescript
632
+ * import { RRegex } from "rregex"
633
+ *
634
+ * const re = new RRegex("'(?P<title>[^']+)'\\s+\\((?P<year>\\d{4})\)")
635
+ * const text = "Not my favorite movie: 'Citizen Kane' (1941)."
636
+ * const caps = re.captures(text)
637
+ * expect(caps.name["title"].value).toBe("Citizen Kane")
638
+ * expect(caps.name["year"].value).toBe("1941")
639
+ * expect(caps.get[0].value).toBe("'Citizen Kane' (1941)")
640
+ * ```
641
+ *
642
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.captures
643
+ * @param {string} text - The string against which to match the regular expression
644
+ * @returns {Captures|undefined}
645
+ */
646
+ captures(text) {
647
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
648
+ const len0 = WASM_VECTOR_LEN;
649
+ const ret = wasm.rregex_captures(this.__wbg_ptr, ptr0, len0);
650
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
651
+ return takeFromExternrefTable0(ret[0]);
652
+ }
653
+ /**
654
+ * Returns an array for each successive non-overlapping match in `text``,
655
+ * returning the start and end byte indices with respect to `text`.
656
+ *
657
+ * # Example
658
+ *
659
+ * Find the start and end location of every word with exactly 13 Unicode
660
+ * word characters:
661
+ *
662
+ * ```typescript
663
+ * import { RRegex } from "rregex"
664
+ *
665
+ * const text = "Retroactively relinquishing remunerations is reprehensible."
666
+ * const matches = new RRegex("\\b\\w{13}\\b").findAll(text)
667
+ * ```
668
+ *
669
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.find_iter
670
+ * @param {string} text - The string against which to match the regular expression
671
+ * @returns {Match}
672
+ */
673
+ findAll(text) {
674
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
675
+ const len0 = WASM_VECTOR_LEN;
676
+ const ret = wasm.rregex_findAll(this.__wbg_ptr, ptr0, len0);
677
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
678
+ return takeFromExternrefTable0(ret[0]);
679
+ }
680
+ /**
681
+ * Returns true if and only if there is a match for the regex in the
682
+ * string given.
683
+ *
684
+ * It is recommended to use this method if all you need to do is test
685
+ * a match, since the underlying matching engine may be able to do less
686
+ * work.
687
+ *
688
+ * # Example
689
+ *
690
+ * Test if some text contains at least one word with exactly 13
691
+ * Unicode word characters:
692
+ *
693
+ * ```typescript
694
+ * import { RRegex } from "rregex"
695
+ *
696
+ * const text = "I categorically deny having triskaidekaphobia."
697
+ * expect(new RRegex("\\b\\w{13}\\b").is_match(text)).toBe(true)
698
+ * ```
699
+ *
700
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.is_match
701
+ * @param {string} text - The string against which to match the regular expression
702
+ * @return {boolean}
703
+ */
704
+ isMatch(text) {
705
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
706
+ const len0 = WASM_VECTOR_LEN;
707
+ return wasm.rregex_isMatch(this.__wbg_ptr, ptr0, len0) !== 0;
708
+ }
709
+ /**
710
+ * Replaces at most `limit` non-overlapping matches in `text` with the
711
+ * replacement provided. If `limit` is 0, then all non-overlapping matches
712
+ * are replaced.
713
+ *
714
+ * See the documentation for `replace` for details on how to access
715
+ * capturing group matches in the replacement string.
716
+ *
717
+ * @see https://docs.rs/regex/latest/regex/struct.Regex.html#method.replacen
718
+ * @param {string} text - The string against which to match the regular expression
719
+ * @param {number} limit - Max number of replacement
720
+ * @param {string} rep - It's a string, it will replace the substring matched by `pattern`.
721
+ * @returns {string}
722
+ */
723
+ replacen(text, limit, rep) {
724
+ let deferred3_0;
725
+ let deferred3_1;
726
+ try {
727
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
728
+ const len0 = WASM_VECTOR_LEN;
729
+ const ptr1 = passStringToWasm0(rep, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
730
+ const len1 = WASM_VECTOR_LEN;
731
+ const ret = wasm.rregex_replacen(this.__wbg_ptr, ptr0, len0, limit, ptr1, len1);
732
+ deferred3_0 = ret[0];
733
+ deferred3_1 = ret[1];
734
+ return getStringFromWasm0(ret[0], ret[1]);
735
+ } finally {
736
+ wasm.__wbindgen_free(deferred3_0, deferred3_1, 1);
737
+ }
738
+ }
739
+ /**
740
+ * Returns a string representing the regular expression
741
+ * @returns {string}
742
+ */
743
+ toString() {
744
+ let deferred1_0;
745
+ let deferred1_1;
746
+ try {
747
+ const ret = wasm.rregex_toString(this.__wbg_ptr);
748
+ deferred1_0 = ret[0];
749
+ deferred1_1 = ret[1];
750
+ return getStringFromWasm0(ret[0], ret[1]);
751
+ } finally {
752
+ wasm.__wbindgen_free(deferred1_0, deferred1_1, 1);
753
+ }
754
+ }
755
+ };
756
+ const RRegexSetFinalization = typeof FinalizationRegistry === "undefined" ? {
757
+ register: () => {},
758
+ unregister: () => {}
759
+ } : new FinalizationRegistry((ptr) => wasm.__wbg_rregexset_free(ptr >>> 0, 1));
793
760
  /**
794
- * Match multiple (possibly overlapping) regular expressions in a single scan.
795
- * A regex set corresponds to the union of two or more regular expressions.
796
- *
797
- * That is, a regex set will match text where at least one of its constituent
798
- * regular expressions matches. A regex set as its formulated here provides a
799
- * touch more power: it will also report which regular expressions in the set match.
800
- * Indeed, this is the key difference between regex sets and a single `Regex`
801
- * with many alternates, since only one alternate can match at a time.
802
- *
803
- * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.empty
804
- */
805
- export class RRegexSet {
806
-
807
- __destroy_into_raw() {
808
- const ptr = this.__wbg_ptr;
809
- this.__wbg_ptr = 0;
810
- RRegexSetFinalization.unregister(this);
811
- return ptr;
812
- }
813
-
814
- free() {
815
- const ptr = this.__destroy_into_raw();
816
- wasm.__wbg_rregexset_free(ptr, 0);
817
- }
818
- /**
819
- * Create a new regex set with the given regular expressions.
820
- *
821
- * This takes an of strings, if any item in the list is not a valid regular
822
- * expressions, then an error is returned.
823
- *
824
- * # Example
825
- *
826
- * Create a new regex set from an iterator of strings:
827
- *
828
- * ```typescript
829
- * import { RegexSet } from "rregex"
830
- *
831
- * const set = new RegexSet(["\w+", "\d+"])
832
- * expect(set.is_match("foo")).toBe(true)
833
- * ```
834
- * @param {Array<any>} list
835
- */
836
- constructor(list) {
837
- const ret = wasm.rregexset_new(list);
838
- if (ret[2]) {
839
- throw takeFromExternrefTable0(ret[1]);
840
- }
841
- this.__wbg_ptr = ret[0] >>> 0;
842
- RRegexSetFinalization.register(this, this.__wbg_ptr, this);
843
- return this;
844
- }
845
- /**
846
- * Returns the set of regular expressions that match in the given text.
847
- *
848
- * The set returned contains the index of each regular expression that
849
- * matches in the given text. The index is in correspondence with the
850
- * order of regular expressions given to `RegexSet`'s constructor.
851
- *
852
- * The set can also be used to iterate over the matched indices.
853
- *
854
- * Note that as with searches using `Regex`, the expression is unanchored
855
- * by default. That is, if the regex does not start with `^` or `\A`, or
856
- * end with `$` or `\z`, then it is permitted to match anywhere in the
857
- * text.
858
- *
859
- * # Example
860
- *
861
- * Tests which regular expressions match the given text:
862
- *
863
- * ```typescript
864
- * import { RegexSet } from "rregex"
865
- *
866
- * const set = new RegexSet([
867
- * "\w+",
868
- * "\d+",
869
- * "\pL+",
870
- * "foo",
871
- * "bar",
872
- * "barfoo",
873
- * "foobar",
874
- * ])
875
- * const matches = set.matches("foobar")
876
- * expect(matches).toBe([0, 2, 3, 4, 6])
877
- * ```
878
- *
879
- * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.matches
880
- * @param {string} text - The string against which to match the regular expression
881
- * @return {number[]}
882
- */
883
- matches(text) {
884
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
885
- const len0 = WASM_VECTOR_LEN;
886
- const ret = wasm.rregexset_matches(this.__wbg_ptr, ptr0, len0);
887
- var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
888
- wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
889
- return v2;
890
- }
891
- /**
892
- * Returns true if and only if one of the regexes in this set matches
893
- * the text given.
894
- *
895
- * This method should be preferred if you only need to test whether any
896
- * of the regexes in the set should match, but don't care about *which*
897
- * regexes matched. This is because the underlying matching engine will
898
- * quit immediately after seeing the first match instead of continuing to
899
- * find all matches.
900
- *
901
- * Note that as with searches using `Regex`, the expression is unanchored
902
- * by default. That is, if the regex does not start with `^` or `\A`, or
903
- * end with `$` or `\z`, then it is permitted to match anywhere in the
904
- * text.
905
- *
906
- * # Example
907
- *
908
- * Tests whether a set matches some text:
909
- *
910
- * ```typescript
911
- * import { RegexSet } from "rregex"
912
- *
913
- * const set = new RegexSet(["\w+", "\d+"])
914
- * expect(set.is_match("foo")).toBe(true)
915
- * expect(!set.is_match("☃")).toBe(false)
916
- * ```
917
- *
918
- * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.is_match
919
- * @param {string} text - The string against which to match the regular expression
920
- * @return {boolean}
921
- */
922
- isMatch(text) {
923
- const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
924
- const len0 = WASM_VECTOR_LEN;
925
- const ret = wasm.rregexset_isMatch(this.__wbg_ptr, ptr0, len0);
926
- return ret !== 0;
927
- }
928
- }
929
-
930
- const imports = {
931
- wbg: {
932
- __wbg_buffer_609cc3eee51ed158: function(arg0) {
933
- const ret = arg0.buffer;
934
- return ret;
935
- },
936
- __wbg_fromCodePoint_f37c25c172f2e8b5: function() { return handleError(function (arg0) {
937
- const ret = String.fromCodePoint(arg0 >>> 0);
938
- return ret;
939
- }, arguments) },
940
- __wbg_from_2a5d3e218e67aa85: function(arg0) {
941
- const ret = Array.from(arg0);
942
- return ret;
943
- },
944
- __wbg_get_b9b93047fe3cf45b: function(arg0, arg1) {
945
- const ret = arg0[arg1 >>> 0];
946
- return ret;
947
- },
948
- __wbg_length_e2d2a49132c1b256: function(arg0) {
949
- const ret = arg0.length;
950
- return ret;
951
- },
952
- __wbg_new_405e22f390576ce2: function() {
953
- const ret = new Object();
954
- return ret;
955
- },
956
- __wbg_new_78feb108b6472713: function() {
957
- const ret = new Array();
958
- return ret;
959
- },
960
- __wbg_new_a12002a7f91c75be: function(arg0) {
961
- const ret = new Uint8Array(arg0);
962
- return ret;
963
- },
964
- __wbg_newwithbyteoffsetandlength_d97e637ebe145a9a: function(arg0, arg1, arg2) {
965
- const ret = new Uint8Array(arg0, arg1 >>> 0, arg2 >>> 0);
966
- return ret;
967
- },
968
- __wbg_push_737cfc8c1432c2c6: function(arg0, arg1) {
969
- const ret = arg0.push(arg1);
970
- return ret;
971
- },
972
- __wbg_set_37837023f3d740e8: function(arg0, arg1, arg2) {
973
- arg0[arg1 >>> 0] = arg2;
974
- },
975
- __wbg_set_3f1d0b984ed272ed: function(arg0, arg1, arg2) {
976
- arg0[arg1] = arg2;
977
- },
978
- __wbg_set_bb8cecf6a62b9f46: function() { return handleError(function (arg0, arg1, arg2) {
979
- const ret = Reflect.set(arg0, arg1, arg2);
980
- return ret;
981
- }, arguments) },
982
- __wbindgen_bigint_from_u64: function(arg0) {
983
- const ret = BigInt.asUintN(64, arg0);
984
- return ret;
985
- },
986
- __wbindgen_error_new: function(arg0, arg1) {
987
- const ret = new Error(getStringFromWasm0(arg0, arg1));
988
- return ret;
989
- },
990
- __wbindgen_init_externref_table: function() {
991
- const table = wasm.__wbindgen_export_2;
992
- const offset = table.grow(4);
993
- table.set(0, undefined);
994
- table.set(offset + 0, undefined);
995
- table.set(offset + 1, null);
996
- table.set(offset + 2, true);
997
- table.set(offset + 3, false);
998
- ;
999
- },
1000
- __wbindgen_memory: function() {
1001
- const ret = wasm.memory;
1002
- return ret;
1003
- },
1004
- __wbindgen_number_new: function(arg0) {
1005
- const ret = arg0;
1006
- return ret;
1007
- },
1008
- __wbindgen_string_get: function(arg0, arg1) {
1009
- const obj = arg1;
1010
- const ret = typeof(obj) === 'string' ? obj : undefined;
1011
- var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
1012
- var len1 = WASM_VECTOR_LEN;
1013
- getDataViewMemory0().setInt32(arg0 + 4 * 1, len1, true);
1014
- getDataViewMemory0().setInt32(arg0 + 4 * 0, ptr1, true);
1015
- },
1016
- __wbindgen_string_new: function(arg0, arg1) {
1017
- const ret = getStringFromWasm0(arg0, arg1);
1018
- return ret;
1019
- },
1020
- __wbindgen_throw: function(arg0, arg1) {
1021
- throw new Error(getStringFromWasm0(arg0, arg1));
1022
- },
1023
- },
1024
-
761
+ * Match multiple (possibly overlapping) regular expressions in a single scan.
762
+ * A regex set corresponds to the union of two or more regular expressions.
763
+ *
764
+ * That is, a regex set will match text where at least one of its constituent
765
+ * regular expressions matches. A regex set as its formulated here provides a
766
+ * touch more power: it will also report which regular expressions in the set match.
767
+ * Indeed, this is the key difference between regex sets and a single `Regex`
768
+ * with many alternates, since only one alternate can match at a time.
769
+ *
770
+ * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.empty
771
+ */
772
+ var RRegexSet = class {
773
+ __destroy_into_raw() {
774
+ const ptr = this.__wbg_ptr;
775
+ this.__wbg_ptr = 0;
776
+ RRegexSetFinalization.unregister(this);
777
+ return ptr;
778
+ }
779
+ free() {
780
+ const ptr = this.__destroy_into_raw();
781
+ wasm.__wbg_rregexset_free(ptr, 0);
782
+ }
783
+ /**
784
+ * Create a new regex set with the given regular expressions.
785
+ *
786
+ * This takes an array of strings, if any item in the list is not a valid regular
787
+ * expression, then an error is returned. Options only apply to this
788
+ * instance, see `RRegexOptions`.
789
+ *
790
+ * # Example
791
+ *
792
+ * Create a new regex set from an iterator of strings:
793
+ *
794
+ * ```typescript
795
+ * import { RegexSet } from "rregex"
796
+ *
797
+ * const set = new RegexSet(["\\w+", "\\d+"])
798
+ * expect(set.is_match("foo")).toBe(true)
799
+ * ```
800
+ * @param {string[]} list
801
+ * @param {RRegexOptions | null} [options]
802
+ */
803
+ constructor(list, options) {
804
+ const ret = wasm.rregexset_new(list, isLikeNone(options) ? 0 : addToExternrefTable0(options));
805
+ if (ret[2]) throw takeFromExternrefTable0(ret[1]);
806
+ this.__wbg_ptr = ret[0] >>> 0;
807
+ RRegexSetFinalization.register(this, this.__wbg_ptr, this);
808
+ return this;
809
+ }
810
+ /**
811
+ * Returns the set of regular expressions that match in the given text.
812
+ *
813
+ * The set returned contains the index of each regular expression that
814
+ * matches in the given text. The index is in correspondence with the
815
+ * order of regular expressions given to `RegexSet`'s constructor.
816
+ *
817
+ * The set can also be used to iterate over the matched indices.
818
+ *
819
+ * Note that as with searches using `Regex`, the expression is unanchored
820
+ * by default. That is, if the regex does not start with `^` or `\A`, or
821
+ * end with `$` or `\z`, then it is permitted to match anywhere in the
822
+ * text.
823
+ *
824
+ * # Example
825
+ *
826
+ * Tests which regular expressions match the given text:
827
+ *
828
+ * ```typescript
829
+ * import { RegexSet } from "rregex"
830
+ *
831
+ * const set = new RegexSet([
832
+ * "\\w+",
833
+ * "\\d+",
834
+ * "\\pL+",
835
+ * "foo",
836
+ * "bar",
837
+ * "barfoo",
838
+ * "foobar",
839
+ * ])
840
+ * const matches = set.matches("foobar")
841
+ * expect(matches).toBe([0, 2, 3, 4, 6])
842
+ * ```
843
+ *
844
+ * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.matches
845
+ * @param {string} text - The string against which to match the regular expression
846
+ * @return {number[]}
847
+ */
848
+ matches(text) {
849
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
850
+ const len0 = WASM_VECTOR_LEN;
851
+ const ret = wasm.rregexset_matches(this.__wbg_ptr, ptr0, len0);
852
+ var v2 = getArrayJsValueFromWasm0(ret[0], ret[1]).slice();
853
+ wasm.__wbindgen_free(ret[0], ret[1] * 4, 4);
854
+ return v2;
855
+ }
856
+ /**
857
+ * Returns true if and only if one of the regexes in this set matches
858
+ * the text given.
859
+ *
860
+ * This method should be preferred if you only need to test whether any
861
+ * of the regexes in the set should match, but don't care about *which*
862
+ * regexes matched. This is because the underlying matching engine will
863
+ * quit immediately after seeing the first match instead of continuing to
864
+ * find all matches.
865
+ *
866
+ * Note that as with searches using `Regex`, the expression is unanchored
867
+ * by default. That is, if the regex does not start with `^` or `\A`, or
868
+ * end with `$` or `\z`, then it is permitted to match anywhere in the
869
+ * text.
870
+ *
871
+ * # Example
872
+ *
873
+ * Tests whether a set matches some text:
874
+ *
875
+ * ```typescript
876
+ * import { RegexSet } from "rregex"
877
+ *
878
+ * const set = new RegexSet(["\\w+", "\\d+"])
879
+ * expect(set.is_match("foo")).toBe(true)
880
+ * expect(!set.is_match("☃")).toBe(false)
881
+ * ```
882
+ *
883
+ * @see https://docs.rs/regex/latest/regex/struct.RegexSet.html#method.is_match
884
+ * @param {string} text - The string against which to match the regular expression
885
+ * @return {boolean}
886
+ */
887
+ isMatch(text) {
888
+ const ptr0 = passStringToWasm0(text, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
889
+ const len0 = WASM_VECTOR_LEN;
890
+ return wasm.rregexset_isMatch(this.__wbg_ptr, ptr0, len0) !== 0;
891
+ }
1025
892
  };
1026
-
1027
- const wasm_url = new URL('rregex.wasm', import.meta.url);
1028
- let wasmCode = '';
1029
- switch (wasm_url.protocol) {
1030
- case 'file:':
1031
- wasmCode = await readFile(wasm_url);
1032
- break
1033
- case 'https:':
1034
- case 'http:':
1035
- wasmCode = await (await fetch(wasm_url)).arrayBuffer();
1036
- break
1037
- default:
1038
- throw new Error(`Unsupported protocol: ${wasm_url.protocol}`);
893
+ async function __wbg_load(module, imports) {
894
+ if (typeof Response === "function" && module instanceof Response) {
895
+ if (typeof WebAssembly.instantiateStreaming === "function") try {
896
+ return await WebAssembly.instantiateStreaming(module, imports);
897
+ } catch (e) {
898
+ if (module.headers.get("Content-Type") != "application/wasm") console.warn("`WebAssembly.instantiateStreaming` failed because your server does not serve Wasm with `application/wasm` MIME type. Falling back to `WebAssembly.instantiate` which is slower. Original error:\n", e);
899
+ else throw e;
900
+ }
901
+ const bytes = await module.arrayBuffer();
902
+ return await WebAssembly.instantiate(bytes, imports);
903
+ } else {
904
+ const instance = await WebAssembly.instantiate(module, imports);
905
+ if (instance instanceof WebAssembly.Instance) return {
906
+ instance,
907
+ module
908
+ };
909
+ else return instance;
910
+ }
911
+ }
912
+ function __wbg_get_imports() {
913
+ const imports = {};
914
+ imports.wbg = {};
915
+ imports.wbg.__wbg_buffer_609cc3eee51ed158 = function(arg0) {
916
+ return arg0.buffer;
917
+ };
918
+ imports.wbg.__wbg_get_67b2ba62fc30de12 = function() {
919
+ return handleError(function(arg0, arg1) {
920
+ return Reflect.get(arg0, arg1);
921
+ }, arguments);
922
+ };
923
+ imports.wbg.__wbg_get_b9b93047fe3cf45b = function(arg0, arg1) {
924
+ return arg0[arg1 >>> 0];
925
+ };
926
+ imports.wbg.__wbg_keys_5c77a08ddc2fb8a6 = function(arg0) {
927
+ return Object.keys(arg0);
928
+ };
929
+ imports.wbg.__wbg_length_e2d2a49132c1b256 = function(arg0) {
930
+ return arg0.length;
931
+ };
932
+ imports.wbg.__wbg_new_405e22f390576ce2 = function() {
933
+ return /* @__PURE__ */ new Object();
934
+ };
935
+ imports.wbg.__wbg_new_78feb108b6472713 = function() {
936
+ return new Array();
937
+ };
938
+ imports.wbg.__wbg_new_a12002a7f91c75be = function(arg0) {
939
+ return new Uint8Array(arg0);
940
+ };
941
+ imports.wbg.__wbg_newwithbyteoffsetandlength_d97e637ebe145a9a = function(arg0, arg1, arg2) {
942
+ return new Uint8Array(arg0, arg1 >>> 0, arg2 >>> 0);
943
+ };
944
+ imports.wbg.__wbg_of_2eaf5a02d443ef03 = function(arg0) {
945
+ return Array.of(arg0);
946
+ };
947
+ imports.wbg.__wbg_push_737cfc8c1432c2c6 = function(arg0, arg1) {
948
+ return arg0.push(arg1);
949
+ };
950
+ imports.wbg.__wbg_set_3236fed40a9cf7a8 = function(arg0, arg1, arg2) {
951
+ arg0[arg1] = arg2;
952
+ };
953
+ imports.wbg.__wbg_set_bb8cecf6a62b9f46 = function() {
954
+ return handleError(function(arg0, arg1, arg2) {
955
+ return Reflect.set(arg0, arg1, arg2);
956
+ }, arguments);
957
+ };
958
+ imports.wbg.__wbg_setbool_dad62f465efebe9f = function(arg0, arg1, arg2) {
959
+ arg0[arg1] = arg2 !== 0;
960
+ };
961
+ imports.wbg.__wbg_setnum_a8317d001ce5988f = function(arg0, arg1, arg2) {
962
+ arg0[arg1] = arg2;
963
+ };
964
+ imports.wbg.__wbg_setstr_689ca87d17411175 = function(arg0, arg1, arg2, arg3) {
965
+ arg0[arg1] = getStringFromWasm0(arg2, arg3);
966
+ };
967
+ imports.wbg.__wbindgen_error_new = function(arg0, arg1) {
968
+ return new Error(getStringFromWasm0(arg0, arg1));
969
+ };
970
+ imports.wbg.__wbindgen_init_externref_table = function() {
971
+ const table = wasm.__wbindgen_export_2;
972
+ const offset = table.grow(4);
973
+ table.set(0, void 0);
974
+ table.set(offset + 0, void 0);
975
+ table.set(offset + 1, null);
976
+ table.set(offset + 2, true);
977
+ table.set(offset + 3, false);
978
+ };
979
+ imports.wbg.__wbindgen_is_null = function(arg0) {
980
+ return arg0 === null;
981
+ };
982
+ imports.wbg.__wbindgen_is_object = function(arg0) {
983
+ const val = arg0;
984
+ return typeof val === "object" && val !== null;
985
+ };
986
+ imports.wbg.__wbindgen_is_undefined = function(arg0) {
987
+ return arg0 === void 0;
988
+ };
989
+ imports.wbg.__wbindgen_memory = function() {
990
+ return wasm.memory;
991
+ };
992
+ imports.wbg.__wbindgen_number_get = function(arg0, arg1) {
993
+ const obj = arg1;
994
+ const ret = typeof obj === "number" ? obj : void 0;
995
+ getDataViewMemory0().setFloat64(arg0 + 8, isLikeNone(ret) ? 0 : ret, true);
996
+ getDataViewMemory0().setInt32(arg0 + 0, !isLikeNone(ret), true);
997
+ };
998
+ imports.wbg.__wbindgen_number_new = function(arg0) {
999
+ return arg0;
1000
+ };
1001
+ imports.wbg.__wbindgen_string_get = function(arg0, arg1) {
1002
+ const obj = arg1;
1003
+ const ret = typeof obj === "string" ? obj : void 0;
1004
+ var ptr1 = isLikeNone(ret) ? 0 : passStringToWasm0(ret, wasm.__wbindgen_malloc, wasm.__wbindgen_realloc);
1005
+ var len1 = WASM_VECTOR_LEN;
1006
+ getDataViewMemory0().setInt32(arg0 + 4, len1, true);
1007
+ getDataViewMemory0().setInt32(arg0 + 0, ptr1, true);
1008
+ };
1009
+ imports.wbg.__wbindgen_string_new = function(arg0, arg1) {
1010
+ return getStringFromWasm0(arg0, arg1);
1011
+ };
1012
+ imports.wbg.__wbindgen_throw = function(arg0, arg1) {
1013
+ throw new Error(getStringFromWasm0(arg0, arg1));
1014
+ };
1015
+ return imports;
1039
1016
  }
1040
-
1041
- const wasmInstance = (await WebAssembly.instantiate(wasmCode, imports)).instance;
1042
- const wasm = wasmInstance.exports;
1043
- export const __wasm = wasm;
1044
-
1045
- wasm.__wbindgen_start();
1046
-
1047
-
1017
+ function __wbg_finalize_init(instance, module) {
1018
+ wasm = instance.exports;
1019
+ __wbg_init.__wbindgen_wasm_module = module;
1020
+ cachedDataViewMemory0 = null;
1021
+ cachedUint8ArrayMemory0 = null;
1022
+ wasm.__wbindgen_start();
1023
+ return wasm;
1024
+ }
1025
+ function initSync$1(module) {
1026
+ if (wasm !== void 0) return wasm;
1027
+ if (typeof module !== "undefined") {
1028
+ if (Object.getPrototypeOf(module) === Object.prototype) ({module} = module);
1029
+ else console.warn("using deprecated parameters for `initSync()`; pass a single object instead");
1030
+ }
1031
+ const imports = __wbg_get_imports();
1032
+ if (!(module instanceof WebAssembly.Module)) module = new WebAssembly.Module(module);
1033
+ return __wbg_finalize_init(new WebAssembly.Instance(module, imports), module);
1034
+ }
1035
+ async function __wbg_init(module_or_path) {
1036
+ if (wasm !== void 0) return wasm;
1037
+ if (typeof module_or_path !== "undefined") {
1038
+ if (Object.getPrototypeOf(module_or_path) === Object.prototype) ({module_or_path} = module_or_path);
1039
+ else console.warn("using deprecated parameters for the initialization function; pass a single object instead");
1040
+ }
1041
+ const imports = __wbg_get_imports();
1042
+ if (typeof module_or_path === "string" || typeof Request === "function" && module_or_path instanceof Request || typeof URL === "function" && module_or_path instanceof URL) module_or_path = fetch(module_or_path);
1043
+ const { instance, module } = await __wbg_load(await module_or_path, imports);
1044
+ return __wbg_finalize_init(instance, module);
1045
+ }
1046
+ // js/wasm/metadata.ts
1048
1047
  /** Build metadata */
1049
- export const metadata = {
1050
- "name": "rregex",
1051
- "description": "Rust Regex binding for Javascript",
1052
- "authors": [
1053
- "Fede Ramirez <i@2fd.me>"
1054
- ],
1055
- "homepage": "http://rregex.dev",
1056
- "repository": "https://github.com/2fd/rregex",
1057
- "regex": "1.13.1",
1058
- "regex-syntax": "0.8.11"
1048
+ const metadata = {
1049
+ "name": "rregex",
1050
+ "description": "Rust Regex binding for Javascript",
1051
+ "authors": ["Fede Ramirez <i@2fd.me>"],
1052
+ "homepage": "http://rregex.dev",
1053
+ "repository": "https://github.com/2fd/rregex",
1054
+ "regex": "1.13.1",
1055
+ "regex-syntax": "0.8.11"
1056
+ };
1057
+ // js/core.ts
1058
+ /**
1059
+ * Runtime-agnostic entry point. It does not load the WebAssembly module:
1060
+ * call {@link init} or {@link initSync} once before you use any export.
1061
+ *
1062
+ * Every runtime-specific entry point (`node`, `web`, `workerd`, `standalone`)
1063
+ * is a thin wrapper on top of this module.
1064
+ *
1065
+ * @module
1066
+ */
1067
+ let initialized = false;
1068
+ /**
1069
+ * The raw exports of the WebAssembly instance (`memory`, allocator, bindings),
1070
+ * set by {@link init} and {@link initSync}. For tests and debugging only: it
1071
+ * is not part of the public API and can change in any release.
1072
+ *
1073
+ * @internal
1074
+ */
1075
+ let __wasm;
1076
+ /** Returns `true` after the WebAssembly module has been instantiated. */
1077
+ function isInitialized() {
1078
+ return initialized;
1059
1079
  }
1080
+ /**
1081
+ * Instantiates the WebAssembly module synchronously. Calls after the first
1082
+ * successful call have no effect.
1083
+ *
1084
+ * @param options - The module, or (deprecated) the module passed directly.
1085
+ */
1086
+ function initSync(options) {
1087
+ __wasm = initSync$1({ module: isOptions(options, "module") ? options.module : options });
1088
+ initialized = true;
1089
+ }
1090
+ /**
1091
+ * Instantiates the WebAssembly module asynchronously. Calls after the first
1092
+ * successful call have no effect.
1093
+ */
1094
+ async function init(options) {
1095
+ __wasm = await __wbg_init({ module_or_path: options.module_or_path });
1096
+ initialized = true;
1097
+ }
1098
+ function isOptions(value, key) {
1099
+ return typeof value === "object" && value !== null && Object.getPrototypeOf(value) === Object.prototype && key in value;
1100
+ }
1101
+ // js/node.ts
1102
+ /**
1103
+ * Entry point for Node.js, Deno and Bun. The WebAssembly module is loaded
1104
+ * from the file system and instantiated when this module is imported.
1105
+ *
1106
+ * @module
1107
+ */
1108
+ initSync({ module: readFileSync(new URL("./rregex.wasm", import.meta.url)) });
1109
+ export { RRegex, RRegexSet, __wasm, escape, init, initSync, isInitialized, metadata };