@thi.ng/parse 2.1.3 → 2.1.6

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/CHANGELOG.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # Change Log
2
2
 
3
- - **Last updated**: 2021-11-21T17:09:28Z
3
+ - **Last updated**: 2022-04-07T14:17:30Z
4
4
  - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
5
5
 
6
6
  All notable changes to this project will be documented in this file.
@@ -9,6 +9,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
9
9
  **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
10
10
  and/or version bumps of transitive dependencies.
11
11
 
12
+ ### [2.1.5](https://github.com/thi-ng/umbrella/tree/@thi.ng/parse@2.1.5) (2022-03-11)
13
+
14
+ #### ♻️ Refactoring
15
+
16
+ - add type hint (TS4.6) ([6cd42e8](https://github.com/thi-ng/umbrella/commit/6cd42e8))
17
+
12
18
  ## [2.1.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/parse@2.1.0) (2021-11-17)
13
19
 
14
20
  #### 🚀 Features
package/README.md CHANGED
@@ -572,4 +572,4 @@ If this project contributes to an academic publication, please cite it as:
572
572
 
573
573
  ## License
574
574
 
575
- © 2020 - 2021 Karsten Schmidt // Apache Software License 2.0
575
+ © 2020 - 2022 Karsten Schmidt // Apache Software License 2.0
@@ -57,10 +57,10 @@ import type { Parser } from "../api.js";
57
57
  * // { p: 10, l: 1, c: 11, done: false, last: 'a' }
58
58
  * ```
59
59
  *
60
- * @param parser
61
- * @param ahead
62
- * @param capture
63
- * @param id
60
+ * @param parser -
61
+ * @param ahead -
62
+ * @param capture -
63
+ * @param id -
64
64
  */
65
65
  export declare const lookahead: <T>(parser: Parser<T>, ahead: Parser<T>, capture?: boolean, id?: string) => Parser<T>;
66
66
  //# sourceMappingURL=lookahead.d.ts.map
@@ -56,10 +56,10 @@
56
56
  * // { p: 10, l: 1, c: 11, done: false, last: 'a' }
57
57
  * ```
58
58
  *
59
- * @param parser
60
- * @param ahead
61
- * @param capture
62
- * @param id
59
+ * @param parser -
60
+ * @param ahead -
61
+ * @param capture -
62
+ * @param id -
63
63
  */
64
64
  export const lookahead = (parser, ahead, capture = false, id = "lookahead") => (ctx) => {
65
65
  if (ctx.done)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@thi.ng/parse",
3
- "version": "2.1.3",
3
+ "version": "2.1.6",
4
4
  "description": "Purely functional parser combinators & AST generation for generic inputs",
5
5
  "type": "module",
6
6
  "module": "./index.js",
@@ -34,19 +34,19 @@
34
34
  "test": "testament test"
35
35
  },
36
36
  "dependencies": {
37
- "@thi.ng/api": "^8.3.2",
38
- "@thi.ng/checks": "^3.1.2",
39
- "@thi.ng/defmulti": "^2.1.2",
40
- "@thi.ng/errors": "^2.1.2",
41
- "@thi.ng/strings": "^3.3.0"
37
+ "@thi.ng/api": "^8.3.5",
38
+ "@thi.ng/checks": "^3.1.5",
39
+ "@thi.ng/defmulti": "^2.1.5",
40
+ "@thi.ng/errors": "^2.1.5",
41
+ "@thi.ng/strings": "^3.3.3"
42
42
  },
43
43
  "devDependencies": {
44
- "@microsoft/api-extractor": "^7.18.19",
45
- "@thi.ng/testament": "^0.2.2",
44
+ "@microsoft/api-extractor": "^7.19.4",
45
+ "@thi.ng/testament": "^0.2.5",
46
46
  "rimraf": "^3.0.2",
47
47
  "tools": "^0.0.1",
48
- "typedoc": "^0.22.9",
49
- "typescript": "^4.5.2"
48
+ "typedoc": "^0.22.13",
49
+ "typescript": "^4.6.2"
50
50
  },
51
51
  "keywords": [
52
52
  "ast",
@@ -81,154 +81,154 @@
81
81
  ],
82
82
  "exports": {
83
83
  ".": {
84
- "import": "./index.js"
84
+ "default": "./index.js"
85
85
  },
86
86
  "./api": {
87
- "import": "./api.js"
87
+ "default": "./api.js"
88
88
  },
89
89
  "./combinators/alt": {
90
- "import": "./combinators/alt.js"
90
+ "default": "./combinators/alt.js"
91
91
  },
92
92
  "./combinators/boundary": {
93
- "import": "./combinators/boundary.js"
93
+ "default": "./combinators/boundary.js"
94
94
  },
95
95
  "./combinators/check": {
96
- "import": "./combinators/check.js"
96
+ "default": "./combinators/check.js"
97
97
  },
98
98
  "./combinators/dynamic": {
99
- "import": "./combinators/dynamic.js"
99
+ "default": "./combinators/dynamic.js"
100
100
  },
101
101
  "./combinators/expect": {
102
- "import": "./combinators/expect.js"
102
+ "default": "./combinators/expect.js"
103
103
  },
104
104
  "./combinators/lookahead": {
105
- "import": "./combinators/lookahead.js"
105
+ "default": "./combinators/lookahead.js"
106
106
  },
107
107
  "./combinators/maybe": {
108
- "import": "./combinators/maybe.js"
108
+ "default": "./combinators/maybe.js"
109
109
  },
110
110
  "./combinators/not": {
111
- "import": "./combinators/not.js"
111
+ "default": "./combinators/not.js"
112
112
  },
113
113
  "./combinators/repeat": {
114
- "import": "./combinators/repeat.js"
114
+ "default": "./combinators/repeat.js"
115
115
  },
116
116
  "./combinators/seq": {
117
- "import": "./combinators/seq.js"
117
+ "default": "./combinators/seq.js"
118
118
  },
119
119
  "./combinators/wrap": {
120
- "import": "./combinators/wrap.js"
120
+ "default": "./combinators/wrap.js"
121
121
  },
122
122
  "./combinators/xform": {
123
- "import": "./combinators/xform.js"
123
+ "default": "./combinators/xform.js"
124
124
  },
125
125
  "./context": {
126
- "import": "./context.js"
126
+ "default": "./context.js"
127
127
  },
128
128
  "./error": {
129
- "import": "./error.js"
129
+ "default": "./error.js"
130
130
  },
131
131
  "./grammar": {
132
- "import": "./grammar.js"
132
+ "default": "./grammar.js"
133
133
  },
134
134
  "./presets/alpha": {
135
- "import": "./presets/alpha.js"
135
+ "default": "./presets/alpha.js"
136
136
  },
137
137
  "./presets/bits": {
138
- "import": "./presets/bits.js"
138
+ "default": "./presets/bits.js"
139
139
  },
140
140
  "./presets/digits": {
141
- "import": "./presets/digits.js"
141
+ "default": "./presets/digits.js"
142
142
  },
143
143
  "./presets/escape": {
144
- "import": "./presets/escape.js"
144
+ "default": "./presets/escape.js"
145
145
  },
146
146
  "./presets/hex": {
147
- "import": "./presets/hex.js"
147
+ "default": "./presets/hex.js"
148
148
  },
149
149
  "./presets/numbers": {
150
- "import": "./presets/numbers.js"
150
+ "default": "./presets/numbers.js"
151
151
  },
152
152
  "./presets/string": {
153
- "import": "./presets/string.js"
153
+ "default": "./presets/string.js"
154
154
  },
155
155
  "./presets/whitespace": {
156
- "import": "./presets/whitespace.js"
156
+ "default": "./presets/whitespace.js"
157
157
  },
158
158
  "./prims/always": {
159
- "import": "./prims/always.js"
159
+ "default": "./prims/always.js"
160
160
  },
161
161
  "./prims/anchor": {
162
- "import": "./prims/anchor.js"
162
+ "default": "./prims/anchor.js"
163
163
  },
164
164
  "./prims/fail": {
165
- "import": "./prims/fail.js"
165
+ "default": "./prims/fail.js"
166
166
  },
167
167
  "./prims/lit": {
168
- "import": "./prims/lit.js"
168
+ "default": "./prims/lit.js"
169
169
  },
170
170
  "./prims/none-of": {
171
- "import": "./prims/none-of.js"
171
+ "default": "./prims/none-of.js"
172
172
  },
173
173
  "./prims/one-of": {
174
- "import": "./prims/one-of.js"
174
+ "default": "./prims/one-of.js"
175
175
  },
176
176
  "./prims/pass": {
177
- "import": "./prims/pass.js"
177
+ "default": "./prims/pass.js"
178
178
  },
179
179
  "./prims/range": {
180
- "import": "./prims/range.js"
180
+ "default": "./prims/range.js"
181
181
  },
182
182
  "./prims/satisfy": {
183
- "import": "./prims/satisfy.js"
183
+ "default": "./prims/satisfy.js"
184
184
  },
185
185
  "./prims/skip": {
186
- "import": "./prims/skip.js"
186
+ "default": "./prims/skip.js"
187
187
  },
188
188
  "./prims/string": {
189
- "import": "./prims/string.js"
189
+ "default": "./prims/string.js"
190
190
  },
191
191
  "./readers/array-reader": {
192
- "import": "./readers/array-reader.js"
192
+ "default": "./readers/array-reader.js"
193
193
  },
194
194
  "./readers/string-reader": {
195
- "import": "./readers/string-reader.js"
195
+ "default": "./readers/string-reader.js"
196
196
  },
197
197
  "./xform/collect": {
198
- "import": "./xform/collect.js"
198
+ "default": "./xform/collect.js"
199
199
  },
200
200
  "./xform/comp": {
201
- "import": "./xform/comp.js"
201
+ "default": "./xform/comp.js"
202
202
  },
203
203
  "./xform/count": {
204
- "import": "./xform/count.js"
204
+ "default": "./xform/count.js"
205
205
  },
206
206
  "./xform/discard": {
207
- "import": "./xform/discard.js"
207
+ "default": "./xform/discard.js"
208
208
  },
209
209
  "./xform/hoist": {
210
- "import": "./xform/hoist.js"
210
+ "default": "./xform/hoist.js"
211
211
  },
212
212
  "./xform/join": {
213
- "import": "./xform/join.js"
213
+ "default": "./xform/join.js"
214
214
  },
215
215
  "./xform/nest": {
216
- "import": "./xform/nest.js"
216
+ "default": "./xform/nest.js"
217
217
  },
218
218
  "./xform/number": {
219
- "import": "./xform/number.js"
219
+ "default": "./xform/number.js"
220
220
  },
221
221
  "./xform/print": {
222
- "import": "./xform/print.js"
222
+ "default": "./xform/print.js"
223
223
  },
224
224
  "./xform/replace": {
225
- "import": "./xform/replace.js"
225
+ "default": "./xform/replace.js"
226
226
  },
227
227
  "./xform/trim": {
228
- "import": "./xform/trim.js"
228
+ "default": "./xform/trim.js"
229
229
  },
230
230
  "./xform/with-id": {
231
- "import": "./xform/with-id.js"
231
+ "default": "./xform/with-id.js"
232
232
  }
233
233
  },
234
234
  "thi.ng": {
@@ -238,5 +238,5 @@
238
238
  ],
239
239
  "year": 2020
240
240
  },
241
- "gitHead": "32cf1a96854f9bb97aca65ffa05ca862ea377059\n"
241
+ "gitHead": "5ee1feb590dd935593b1dd4e7f38a3ed3ba64765\n"
242
242
  }
package/prims/lit.d.ts CHANGED
@@ -1,20 +1,20 @@
1
1
  /**
2
2
  * HOF predicate for matching given single char literal.
3
3
  *
4
- * @param c
4
+ * @param c -
5
5
  */
6
6
  export declare const litP: <T>(c: T) => (x: T) => boolean;
7
7
  /**
8
8
  * Matches single char/value `c`.
9
9
  *
10
- * @param c
11
- * @param id
10
+ * @param c -
11
+ * @param id -
12
12
  */
13
13
  export declare const lit: <T>(c: T, id?: string) => import("../api.js").LitParser<T>;
14
14
  /**
15
15
  * Discarded literal. Same as {@link lit}, but result will be discarded.
16
16
  *
17
- * @param c
17
+ * @param c -
18
18
  */
19
19
  export declare const litD: <T>(c: T) => import("../api.js").LitParser<T>;
20
20
  //# sourceMappingURL=lit.d.ts.map
package/prims/lit.js CHANGED
@@ -2,19 +2,19 @@ import { satisfyD, satisfy } from "./satisfy.js";
2
2
  /**
3
3
  * HOF predicate for matching given single char literal.
4
4
  *
5
- * @param c
5
+ * @param c -
6
6
  */
7
7
  export const litP = (c) => (x) => x === c;
8
8
  /**
9
9
  * Matches single char/value `c`.
10
10
  *
11
- * @param c
12
- * @param id
11
+ * @param c -
12
+ * @param id -
13
13
  */
14
14
  export const lit = (c, id = "lit") => satisfy(litP(c), id);
15
15
  /**
16
16
  * Discarded literal. Same as {@link lit}, but result will be discarded.
17
17
  *
18
- * @param c
18
+ * @param c -
19
19
  */
20
20
  export const litD = (c) => satisfyD(litP(c));
@@ -4,22 +4,22 @@ import type { CharSet, LitParser } from "../api.js";
4
4
  * HOF predicate for matching single char against given options. Returns
5
5
  * true if there's no match.
6
6
  *
7
- * @param opts
7
+ * @param opts -
8
8
  */
9
9
  export declare const noneOfP: (opts: string | CharSet | any[] | Set<any>) => Predicate<any>;
10
10
  /**
11
11
  * Matches single char against given options and only succeeds if
12
12
  * there's no match. Also see {@link oneOf} for reverse logic.
13
13
  *
14
- * @param opts
15
- * @param id
14
+ * @param opts -
15
+ * @param id -
16
16
  */
17
17
  export declare function noneOf(opts: string | CharSet, id?: string): LitParser<string>;
18
18
  export declare function noneOf<T>(opts: T[] | Set<T>, id?: string): LitParser<T>;
19
19
  /**
20
20
  * Like {@link noneOf}, but discards result.
21
21
  *
22
- * @param opts
22
+ * @param opts -
23
23
  */
24
24
  export declare function noneOfD(opts: string | CharSet): LitParser<string>;
25
25
  export declare function noneOfD<T>(opts: T[] | Set<T>): LitParser<T>;
package/prims/none-of.js CHANGED
@@ -5,7 +5,7 @@ import { satisfy, satisfyD } from "./satisfy.js";
5
5
  * HOF predicate for matching single char against given options. Returns
6
6
  * true if there's no match.
7
7
  *
8
- * @param opts
8
+ * @param opts -
9
9
  */
10
10
  export const noneOfP = (opts) => isSet(opts)
11
11
  ? (x) => !opts.has(x)
package/prims/one-of.d.ts CHANGED
@@ -3,22 +3,22 @@ import type { CharSet, LitParser } from "../api.js";
3
3
  /**
4
4
  * HOF predicate for matching single char against given options.
5
5
  *
6
- * @param opts
6
+ * @param opts -
7
7
  */
8
8
  export declare const oneOfP: (opts: string | any[] | Set<any> | CharSet) => Predicate<any>;
9
9
  /**
10
10
  * Matches single char against given options. Also see {@link noneOf}
11
11
  * for reverse logic.
12
12
  *
13
- * @param opts
14
- * @param id
13
+ * @param opts -
14
+ * @param id -
15
15
  */
16
16
  export declare function oneOf(opts: string | CharSet, id?: string): LitParser<string>;
17
17
  export declare function oneOf<T>(opts: T[] | Set<T>, id?: string): LitParser<T>;
18
18
  /**
19
19
  * Like {@link oneOf}, but discards result.
20
20
  *
21
- * @param opts
21
+ * @param opts -
22
22
  */
23
23
  export declare function oneOfD(opts: string | CharSet): LitParser<string>;
24
24
  export declare function oneOfD<T>(opts: T[] | Set<T>): LitParser<T>;
package/prims/one-of.js CHANGED
@@ -4,7 +4,7 @@ import { satisfy, satisfyD } from "./satisfy.js";
4
4
  /**
5
5
  * HOF predicate for matching single char against given options.
6
6
  *
7
- * @param opts
7
+ * @param opts -
8
8
  */
9
9
  export const oneOfP = (opts) => isSet(opts)
10
10
  ? (x) => opts.has(x)
package/prims/range.d.ts CHANGED
@@ -22,17 +22,17 @@ export declare function rangeD(min: number, max: number): LitParser<number>;
22
22
  /**
23
23
  * Matches single char in given UTF-16 codepoint range.
24
24
  *
25
- * @param min
26
- * @param max
27
- * @param id
25
+ * @param min -
26
+ * @param max -
27
+ * @param id -
28
28
  */
29
29
  export declare const utf16Range: (min: number, max: number, id?: string) => LitParser<string>;
30
30
  /**
31
31
  * Matches single char in given UTF-16 codepoint range.
32
32
  *
33
- * @param min
34
- * @param max
35
- * @param id
33
+ * @param min -
34
+ * @param max -
35
+ * @param id -
36
36
  */
37
37
  export declare const utf16RangeD: (min: number, max: number) => LitParser<string>;
38
38
  //# sourceMappingURL=range.d.ts.map
package/prims/range.js CHANGED
@@ -26,16 +26,16 @@ export function rangeD(min, max) {
26
26
  /**
27
27
  * Matches single char in given UTF-16 codepoint range.
28
28
  *
29
- * @param min
30
- * @param max
31
- * @param id
29
+ * @param min -
30
+ * @param max -
31
+ * @param id -
32
32
  */
33
33
  export const utf16Range = (min, max, id = "utfLit") => satisfy(utf16RangeP(min, max), id);
34
34
  /**
35
35
  * Matches single char in given UTF-16 codepoint range.
36
36
  *
37
- * @param min
38
- * @param max
39
- * @param id
37
+ * @param min -
38
+ * @param max -
39
+ * @param id -
40
40
  */
41
41
  export const utf16RangeD = (min, max) => satisfyD(utf16RangeP(min, max));
@@ -5,7 +5,7 @@ export declare const satisfy: <T>(pred: Predicate<T>, id?: string) => LitParser<
5
5
  * Like {@link satisfy}, but avoids creating AST node and discards
6
6
  * result.
7
7
  *
8
- * @param pred
8
+ * @param pred -
9
9
  */
10
10
  export declare const satisfyD: <T>(pred: Predicate<T>) => LitParser<T>;
11
11
  //# sourceMappingURL=satisfy.d.ts.map
package/prims/satisfy.js CHANGED
@@ -8,7 +8,7 @@ export const satisfy = (pred, id = "satisfy") => ((ctx) => {
8
8
  * Like {@link satisfy}, but avoids creating AST node and discards
9
9
  * result.
10
10
  *
11
- * @param pred
11
+ * @param pred -
12
12
  */
13
13
  export const satisfyD = (pred) => ((ctx) => {
14
14
  if (ctx.done)
package/prims/skip.d.ts CHANGED
@@ -18,7 +18,7 @@ import type { Parser } from "../api.js";
18
18
  * // { p: 15, l: 2, c: 1, done: true, last: '\n' }
19
19
  * ```
20
20
  *
21
- * @param pred
21
+ * @param pred -
22
22
  */
23
23
  export declare const skipWhile: <T>(pred: Predicate<T>) => Parser<T>;
24
24
  //# sourceMappingURL=skip.d.ts.map
package/prims/skip.js CHANGED
@@ -16,7 +16,7 @@
16
16
  * // { p: 15, l: 2, c: 1, done: true, last: '\n' }
17
17
  * ```
18
18
  *
19
- * @param pred
19
+ * @param pred -
20
20
  */
21
21
  export const skipWhile = (pred) => (ctx) => {
22
22
  const state = { ...ctx.state };
package/utils.d.ts CHANGED
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Memoized indentation.
3
3
  *
4
- * @param x
4
+ * @param x -
5
5
  *
6
6
  * @internal
7
7
  */
package/utils.js CHANGED
@@ -3,7 +3,7 @@ const cache = [];
3
3
  /**
4
4
  * Memoized indentation.
5
5
  *
6
- * @param x
6
+ * @param x -
7
7
  *
8
8
  * @internal
9
9
  */
@@ -3,13 +3,13 @@ import type { Parser, ScopeTransform } from "../api.js";
3
3
  * Collects results of all direct children into an array, then discards
4
4
  * children. Also see {@link collect}.
5
5
  *
6
- * @param scope
6
+ * @param scope -
7
7
  */
8
8
  export declare const xfCollect: ScopeTransform<any>;
9
9
  /**
10
10
  * Syntax sugar for `xform(parser, xfCollect)`.
11
11
  *
12
- * @param parser
12
+ * @param parser -
13
13
  */
14
14
  export declare const collect: <T>(parser: Parser<T>) => Parser<T>;
15
15
  //# sourceMappingURL=collect.d.ts.map
package/xform/collect.js CHANGED
@@ -3,7 +3,7 @@ import { xform } from "../combinators/xform.js";
3
3
  * Collects results of all direct children into an array, then discards
4
4
  * children. Also see {@link collect}.
5
5
  *
6
- * @param scope
6
+ * @param scope -
7
7
  */
8
8
  export const xfCollect = (scope) => {
9
9
  scope.result = scope.children.map((c) => c.result);
@@ -13,6 +13,6 @@ export const xfCollect = (scope) => {
13
13
  /**
14
14
  * Syntax sugar for `xform(parser, xfCollect)`.
15
15
  *
16
- * @param parser
16
+ * @param parser -
17
17
  */
18
18
  export const collect = (parser) => xform(parser, xfCollect);
package/xform/comp.d.ts CHANGED
@@ -3,7 +3,7 @@ import type { ScopeTransform } from "../api.js";
3
3
  * Takes any number of {@link ScopeTransform}s and composes them into
4
4
  * new xform w/ left to right order of execution.
5
5
  *
6
- * @param xs
6
+ * @param xs -
7
7
  */
8
8
  export declare const comp: <T>(...xs: ScopeTransform<T>[]) => ScopeTransform<T>;
9
9
  //# sourceMappingURL=comp.d.ts.map
package/xform/comp.js CHANGED
@@ -2,7 +2,7 @@
2
2
  * Takes any number of {@link ScopeTransform}s and composes them into
3
3
  * new xform w/ left to right order of execution.
4
4
  *
5
- * @param xs
5
+ * @param xs -
6
6
  */
7
7
  export const comp = (...xs) => {
8
8
  const [a, b, c, d] = xs;
package/xform/count.d.ts CHANGED
@@ -3,13 +3,13 @@ import type { Parser, ScopeTransform } from "../api.js";
3
3
  * Stores number of children as result, then discards children. Also see
4
4
  * {@link count}.
5
5
  *
6
- * @param scope
6
+ * @param scope -
7
7
  */
8
8
  export declare const xfCount: ScopeTransform<any>;
9
9
  /**
10
10
  * Syntax sugar for `xform(parser, xfCount)`.
11
11
  *
12
- * @param parser
12
+ * @param parser -
13
13
  */
14
14
  export declare const count: <T>(parser: Parser<T>) => Parser<T>;
15
15
  //# sourceMappingURL=count.d.ts.map
package/xform/count.js CHANGED
@@ -3,7 +3,7 @@ import { xform } from "../combinators/xform.js";
3
3
  * Stores number of children as result, then discards children. Also see
4
4
  * {@link count}.
5
5
  *
6
- * @param scope
6
+ * @param scope -
7
7
  */
8
8
  export const xfCount = (scope) => {
9
9
  scope.result = scope.children ? scope.children.length : 0;
@@ -13,6 +13,6 @@ export const xfCount = (scope) => {
13
13
  /**
14
14
  * Syntax sugar for `xform(parser, xfCount)`.
15
15
  *
16
- * @param parser
16
+ * @param parser -
17
17
  */
18
18
  export const count = (parser) => xform(parser, xfCount);
@@ -6,7 +6,7 @@ export declare const xfDiscard: () => null;
6
6
  /**
7
7
  * Syntax sugar for `xform(parser, xfDiscard)`.
8
8
  *
9
- * @param parser
9
+ * @param parser -
10
10
  */
11
11
  export declare const discard: (parser: Parser<any>) => Parser<any>;
12
12
  //# sourceMappingURL=discard.d.ts.map
package/xform/discard.js CHANGED
@@ -6,6 +6,6 @@ export const xfDiscard = () => null;
6
6
  /**
7
7
  * Syntax sugar for `xform(parser, xfDiscard)`.
8
8
  *
9
- * @param parser
9
+ * @param parser -
10
10
  */
11
11
  export const discard = (parser) => xform(parser, xfDiscard);
package/xform/hoist.d.ts CHANGED
@@ -2,26 +2,26 @@ import type { Parser, ScopeTransform } from "../api.js";
2
2
  /**
3
3
  * Replace AST node with its first child node. Also see {@link hoist}.
4
4
  *
5
- * @param scope
5
+ * @param scope -
6
6
  */
7
7
  export declare const xfHoist: ScopeTransform<any>;
8
8
  /**
9
9
  * Moves the result of first child node to this node, then discards all
10
10
  * children. Also see {@link hoistR}.
11
11
  *
12
- * @param scope
12
+ * @param scope -
13
13
  */
14
14
  export declare const xfHoistResult: ScopeTransform<any>;
15
15
  /**
16
16
  * Syntax sugar for `xform(parser, xfHoist)`.
17
17
  *
18
- * @param parser
18
+ * @param parser -
19
19
  */
20
20
  export declare const hoist: <T>(parser: Parser<T>) => Parser<T>;
21
21
  /**
22
22
  * Syntax sugar for `xform(parser, xfHoistR)`.
23
23
  *
24
- * @param parser
24
+ * @param parser -
25
25
  */
26
26
  export declare const hoistResult: <T>(parser: Parser<T>) => Parser<T>;
27
27
  //# sourceMappingURL=hoist.d.ts.map
package/xform/hoist.js CHANGED
@@ -2,7 +2,7 @@ import { xform } from "../combinators/xform.js";
2
2
  /**
3
3
  * Replace AST node with its first child node. Also see {@link hoist}.
4
4
  *
5
- * @param scope
5
+ * @param scope -
6
6
  */
7
7
  export const xfHoist = (scope) => {
8
8
  Object.assign(scope, scope.children[0]);
@@ -12,7 +12,7 @@ export const xfHoist = (scope) => {
12
12
  * Moves the result of first child node to this node, then discards all
13
13
  * children. Also see {@link hoistR}.
14
14
  *
15
- * @param scope
15
+ * @param scope -
16
16
  */
17
17
  export const xfHoistResult = (scope) => {
18
18
  scope.result = scope.children[0].result;
@@ -22,12 +22,12 @@ export const xfHoistResult = (scope) => {
22
22
  /**
23
23
  * Syntax sugar for `xform(parser, xfHoist)`.
24
24
  *
25
- * @param parser
25
+ * @param parser -
26
26
  */
27
27
  export const hoist = (parser) => xform(parser, xfHoist);
28
28
  /**
29
29
  * Syntax sugar for `xform(parser, xfHoistR)`.
30
30
  *
31
- * @param parser
31
+ * @param parser -
32
32
  */
33
33
  export const hoistResult = (parser) => xform(parser, xfHoistResult);
package/xform/join.d.ts CHANGED
@@ -4,13 +4,13 @@ import type { Parser, ParseScope } from "../api.js";
4
4
  * Recursively joins non-null results of all children into a single
5
5
  * string, then discards children. Also see {@link join}.
6
6
  *
7
- * @param scope
7
+ * @param scope -
8
8
  */
9
9
  export declare const xfJoin: <T>(scope: Nullable<ParseScope<T>>) => ParseScope<T> | null;
10
10
  /**
11
11
  * Syntax sugar for `xform(parser, xfJoin)`.
12
12
  *
13
- * @param parser
13
+ * @param parser -
14
14
  */
15
15
  export declare const join: <T>(parser: Parser<T>) => Parser<T>;
16
16
  //# sourceMappingURL=join.d.ts.map
package/xform/join.js CHANGED
@@ -3,7 +3,7 @@ import { xform } from "../combinators/xform.js";
3
3
  * Recursively joins non-null results of all children into a single
4
4
  * string, then discards children. Also see {@link join}.
5
5
  *
6
- * @param scope
6
+ * @param scope -
7
7
  */
8
8
  export const xfJoin = (scope) => {
9
9
  if (!scope || !scope.children)
@@ -21,6 +21,6 @@ export const xfJoin = (scope) => {
21
21
  /**
22
22
  * Syntax sugar for `xform(parser, xfJoin)`.
23
23
  *
24
- * @param parser
24
+ * @param parser -
25
25
  */
26
26
  export const join = (parser) => xform(parser, xfJoin);
package/xform/nest.d.ts CHANGED
@@ -12,7 +12,7 @@ import type { Parser, ScopeTransform } from "../api.js";
12
12
  * context will be configured to produce true absolute offsets for its results
13
13
  * as if they were in the main context.
14
14
  *
15
- * @param parser
15
+ * @param parser -
16
16
  */
17
17
  export declare const xfNest: (parser: Parser<string>) => ScopeTransform<string>;
18
18
  export declare const nest: (outer: Parser<string>, inner: Parser<string>) => Parser<string>;
package/xform/nest.js CHANGED
@@ -14,7 +14,7 @@ import { xfJoin } from "./join.js";
14
14
  * context will be configured to produce true absolute offsets for its results
15
15
  * as if they were in the main context.
16
16
  *
17
- * @param parser
17
+ * @param parser -
18
18
  */
19
19
  export const xfNest = (parser) => (scope, ctx) => {
20
20
  if (!scope)
package/xform/number.d.ts CHANGED
@@ -3,14 +3,14 @@ import type { ScopeTransform } from "../api.js";
3
3
  * Higher order transform. First joins all children via {@link xfJoin},
4
4
  * then parses resulting string into an integer with given `radix`.
5
5
  *
6
- * @param radix
6
+ * @param radix -
7
7
  */
8
8
  export declare const xfInt: (radix?: number) => ScopeTransform<string>;
9
9
  /**
10
10
  * First joins all children via {@link xfJoin}, then parses resulting
11
11
  * string into a floating point value.
12
12
  *
13
- * @param scope
13
+ * @param scope -
14
14
  */
15
15
  export declare const xfFloat: ScopeTransform<string>;
16
16
  //# sourceMappingURL=number.d.ts.map
package/xform/number.js CHANGED
@@ -3,7 +3,7 @@ import { xfJoin } from "./join.js";
3
3
  * Higher order transform. First joins all children via {@link xfJoin},
4
4
  * then parses resulting string into an integer with given `radix`.
5
5
  *
6
- * @param radix
6
+ * @param radix -
7
7
  */
8
8
  export const xfInt = (radix = 10) => (scope) => {
9
9
  scope.result = parseInt(xfJoin(scope).result, radix);
@@ -13,7 +13,7 @@ export const xfInt = (radix = 10) => (scope) => {
13
13
  * First joins all children via {@link xfJoin}, then parses resulting
14
14
  * string into a floating point value.
15
15
  *
16
- * @param scope
16
+ * @param scope -
17
17
  */
18
18
  export const xfFloat = (scope) => {
19
19
  scope.result = parseFloat(xfJoin(scope).result);
package/xform/print.d.ts CHANGED
@@ -9,9 +9,9 @@ import type { Parser, ScopeTransform } from "../api.js";
9
9
  * The optional `fn` function is used to print each AST node (default:
10
10
  * `console.log`).
11
11
  *
12
- * @param scope
13
- * @param ctx
14
- * @param level
12
+ * @param scope -
13
+ * @param ctx -
14
+ * @param level -
15
15
  */
16
16
  export declare const xfPrint: (fn?: Fn<string, void>) => ScopeTransform<any>;
17
17
  /**
@@ -29,7 +29,7 @@ export declare const xfPrint: (fn?: Fn<string, void>) => ScopeTransform<any>;
29
29
  * // lit: "]"
30
30
  * ```
31
31
  *
32
- * @param parser
32
+ * @param parser -
33
33
  */
34
34
  export declare const print: <T>(parser: Parser<T>, fn?: Fn<string, void> | undefined) => Parser<T>;
35
35
  //# sourceMappingURL=print.d.ts.map
package/xform/print.js CHANGED
@@ -9,9 +9,9 @@ import { indent } from "../utils.js";
9
9
  * The optional `fn` function is used to print each AST node (default:
10
10
  * `console.log`).
11
11
  *
12
- * @param scope
13
- * @param ctx
14
- * @param level
12
+ * @param scope -
13
+ * @param ctx -
14
+ * @param level -
15
15
  */
16
16
  export const xfPrint = (fn = console.log) => {
17
17
  const $print = (scope, _, level = 0) => {
@@ -45,6 +45,6 @@ export const xfPrint = (fn = console.log) => {
45
45
  * // lit: "]"
46
46
  * ```
47
47
  *
48
- * @param parser
48
+ * @param parser -
49
49
  */
50
50
  export const print = (parser, fn) => xform(parser, xfPrint(fn));
package/xform/trim.d.ts CHANGED
@@ -5,13 +5,13 @@ import type { Parser, ScopeTransform } from "../api.js";
5
5
  *
6
6
  * {@link trim}.
7
7
  *
8
- * @param scope
8
+ * @param scope -
9
9
  */
10
10
  export declare const xfTrim: ScopeTransform<string>;
11
11
  /**
12
12
  * Syntax sugar for `xform(parser, xfTrim)`.
13
13
  *
14
- * @param parser
14
+ * @param parser -
15
15
  */
16
16
  export declare const trim: (parser: Parser<string>) => Parser<string>;
17
17
  //# sourceMappingURL=trim.d.ts.map
package/xform/trim.js CHANGED
@@ -5,7 +5,7 @@ import { xform } from "../combinators/xform.js";
5
5
  *
6
6
  * {@link trim}.
7
7
  *
8
- * @param scope
8
+ * @param scope -
9
9
  */
10
10
  export const xfTrim = (scope) => {
11
11
  scope.result = scope.result.trim();
@@ -14,6 +14,6 @@ export const xfTrim = (scope) => {
14
14
  /**
15
15
  * Syntax sugar for `xform(parser, xfTrim)`.
16
16
  *
17
- * @param parser
17
+ * @param parser -
18
18
  */
19
19
  export const trim = (parser) => xform(parser, xfTrim);
@@ -3,7 +3,7 @@ import type { ScopeTransform, Parser } from "../api.js";
3
3
  * Assigns given `id` to AST node. E.g. used for re-labeling parser
4
4
  * results defined by {@link defGrammar}.
5
5
  *
6
- * @param id
6
+ * @param id -
7
7
  */
8
8
  export declare const xfID: (id: string) => ScopeTransform<any>;
9
9
  export declare const withID: <T>(id: string, parser: Parser<T>) => Parser<T>;
package/xform/with-id.js CHANGED
@@ -3,7 +3,7 @@ import { xform } from "../combinators/xform.js";
3
3
  * Assigns given `id` to AST node. E.g. used for re-labeling parser
4
4
  * results defined by {@link defGrammar}.
5
5
  *
6
- * @param id
6
+ * @param id -
7
7
  */
8
8
  export const xfID = (id) => (scope) => ((scope.id = id), scope);
9
9
  export const withID = (id, parser) => xform(parser, xfID(id));