@nymphjs/query-parser 1.0.0-beta.12 → 1.0.0-beta.121

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.
Files changed (24) hide show
  1. package/CHANGELOG.md +457 -0
  2. package/README.md +16 -6
  3. package/dist/index.d.ts +4 -0
  4. package/dist/index.js +4 -1
  5. package/dist/index.js.map +1 -1
  6. package/{lib → dist}/queryParser.js +166 -50
  7. package/dist/queryParser.js.map +1 -0
  8. package/{lib → dist}/queryParser.test.js +402 -54
  9. package/dist/queryParser.test.js.map +1 -0
  10. package/jest.config.js +31 -5
  11. package/package.json +30 -32
  12. package/src/index.ts +2 -2
  13. package/src/queryParser.test.ts +395 -2
  14. package/src/queryParser.ts +153 -48
  15. package/tsconfig.json +7 -4
  16. package/typedoc.json +4 -0
  17. package/lib/index.d.ts +0 -4
  18. package/lib/index.js +0 -25
  19. package/lib/index.js.map +0 -1
  20. package/lib/queryParser.js.map +0 -1
  21. package/lib/queryParser.test.js.map +0 -1
  22. package/webpack.config.js +0 -28
  23. /package/{lib → dist}/queryParser.d.ts +0 -0
  24. /package/{lib → dist}/queryParser.test.d.ts +0 -0
package/CHANGELOG.md CHANGED
@@ -3,6 +3,463 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [1.0.0-beta.121](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.120...v1.0.0-beta.121) (2026-09-17)
7
+
8
+ **Note:** Version bump only for package @nymphjs/query-parser
9
+
10
+ # [1.0.0-beta.120](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.119...v1.0.0-beta.120) (2026-09-01)
11
+
12
+ **Note:** Version bump only for package @nymphjs/query-parser
13
+
14
+ # [1.0.0-beta.119](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.118...v1.0.0-beta.119) (2026-08-25)
15
+
16
+ **Note:** Version bump only for package @nymphjs/query-parser
17
+
18
+ # [1.0.0-beta.118](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.117...v1.0.0-beta.118) (2026-08-24)
19
+
20
+ ### Features
21
+
22
+ - update packages and migrate to ts7 ([c1b8eb5](https://forge.sciactive.com/sciactive/nymphjs/commits/c1b8eb5f7dd68436759f8d7b94bc9622511e71fd))
23
+
24
+ # [1.0.0-beta.117](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.116...v1.0.0-beta.117) (2026-04-21)
25
+
26
+ **Note:** Version bump only for package @nymphjs/query-parser
27
+
28
+ # [1.0.0-beta.116](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.115...v1.0.0-beta.116) (2026-04-08)
29
+
30
+ **Note:** Version bump only for package @nymphjs/query-parser
31
+
32
+ # [1.0.0-beta.115](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.114...v1.0.0-beta.115) (2026-04-06)
33
+
34
+ **Note:** Version bump only for package @nymphjs/query-parser
35
+
36
+ # [1.0.0-beta.114](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.113...v1.0.0-beta.114) (2026-04-06)
37
+
38
+ **Note:** Version bump only for package @nymphjs/query-parser
39
+
40
+ # [1.0.0-beta.113](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.112...v1.0.0-beta.113) (2026-04-03)
41
+
42
+ **Note:** Version bump only for package @nymphjs/query-parser
43
+
44
+ # [1.0.0-beta.112](https://forge.sciactive.com/sciactive/nymphjs/compare/v1.0.0-beta.111...v1.0.0-beta.112) (2026-04-03)
45
+
46
+ **Note:** Version bump only for package @nymphjs/query-parser
47
+
48
+ # [1.0.0-beta.111](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.110...v1.0.0-beta.111) (2026-03-10)
49
+
50
+ **Note:** Version bump only for package @nymphjs/query-parser
51
+
52
+ # [1.0.0-beta.110](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.109...v1.0.0-beta.110) (2026-02-23)
53
+
54
+ **Note:** Version bump only for package @nymphjs/query-parser
55
+
56
+ # [1.0.0-beta.109](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.108...v1.0.0-beta.109) (2026-02-15)
57
+
58
+ **Note:** Version bump only for package @nymphjs/query-parser
59
+
60
+ # [1.0.0-beta.108](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.107...v1.0.0-beta.108) (2026-02-15)
61
+
62
+ **Note:** Version bump only for package @nymphjs/query-parser
63
+
64
+ # [1.0.0-beta.107](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.106...v1.0.0-beta.107) (2026-02-13)
65
+
66
+ ### Features
67
+
68
+ - update packages and fix all new issues ([0e9d17c](https://github.com/sciactive/nymphjs/commit/0e9d17c6e2db12c11bdfb559031719c1b52b5fa1))
69
+
70
+ # [1.0.0-beta.106](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.105...v1.0.0-beta.106) (2025-12-05)
71
+
72
+ **Note:** Version bump only for package @nymphjs/query-parser
73
+
74
+ # [1.0.0-beta.105](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.104...v1.0.0-beta.105) (2025-12-04)
75
+
76
+ ### Features
77
+
78
+ - add a null sort option to not sort the results in a particular order ([898d039](https://github.com/sciactive/nymphjs/commit/898d03981da0ca4ca5f68868584c902e1313c7d8))
79
+
80
+ # [1.0.0-beta.104](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.103...v1.0.0-beta.104) (2025-12-01)
81
+
82
+ **Note:** Version bump only for package @nymphjs/query-parser
83
+
84
+ # [1.0.0-beta.103](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.102...v1.0.0-beta.103) (2025-11-30)
85
+
86
+ **Note:** Version bump only for package @nymphjs/query-parser
87
+
88
+ # [1.0.0-beta.102](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.101...v1.0.0-beta.102) (2025-11-29)
89
+
90
+ **Note:** Version bump only for package @nymphjs/query-parser
91
+
92
+ # [1.0.0-beta.101](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.100...v1.0.0-beta.101) (2025-11-29)
93
+
94
+ **Note:** Version bump only for package @nymphjs/query-parser
95
+
96
+ # [1.0.0-beta.100](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.99...v1.0.0-beta.100) (2025-11-29)
97
+
98
+ **Note:** Version bump only for package @nymphjs/query-parser
99
+
100
+ # [1.0.0-beta.99](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.98...v1.0.0-beta.99) (2025-11-26)
101
+
102
+ ### Features
103
+
104
+ - add full-text-search, but this is interim and will be redesigned ([56333db](https://github.com/sciactive/nymphjs/commit/56333dbe6a25755baed4e108ba4d71b3187fe8d0))
105
+ - add sciactive tokenizer based full text search ([173c96e](https://github.com/sciactive/nymphjs/commit/173c96e02827e8ca155f55e08f33e8cdef475ab9))
106
+
107
+ # [1.0.0-beta.98](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.97...v1.0.0-beta.98) (2025-10-24)
108
+
109
+ **Note:** Version bump only for package @nymphjs/query-parser
110
+
111
+ # [1.0.0-beta.97](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.96...v1.0.0-beta.97) (2025-10-04)
112
+
113
+ ### Bug Fixes
114
+
115
+ - more query parser issues ([38e9cfb](https://github.com/sciactive/nymphjs/commit/38e9cfb2f77f4696d601361825183493bba99065))
116
+ - query parser issues ([1760e15](https://github.com/sciactive/nymphjs/commit/1760e15b252781cc745b9310f25ef73734b4b10e))
117
+ - variable names and complex json in query parser ([7e475d3](https://github.com/sciactive/nymphjs/commit/7e475d3ef997c8ddd245b2f14c033e3fdda2d4bd))
118
+
119
+ # [1.0.0-beta.96](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.95...v1.0.0-beta.96) (2025-09-01)
120
+
121
+ **Note:** Version bump only for package @nymphjs/query-parser
122
+
123
+ # [1.0.0-beta.95](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.94...v1.0.0-beta.95) (2025-08-30)
124
+
125
+ **Note:** Version bump only for package @nymphjs/query-parser
126
+
127
+ # [1.0.0-beta.94](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.93...v1.0.0-beta.94) (2025-08-25)
128
+
129
+ **Note:** Version bump only for package @nymphjs/query-parser
130
+
131
+ # [1.0.0-beta.93](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.92...v1.0.0-beta.93) (2025-08-16)
132
+
133
+ **Note:** Version bump only for package @nymphjs/query-parser
134
+
135
+ # [1.0.0-beta.92](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.91...v1.0.0-beta.92) (2025-04-06)
136
+
137
+ **Note:** Version bump only for package @nymphjs/query-parser
138
+
139
+ # [1.0.0-beta.91](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.90...v1.0.0-beta.91) (2025-03-07)
140
+
141
+ **Note:** Version bump only for package @nymphjs/query-parser
142
+
143
+ # [1.0.0-beta.90](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.89...v1.0.0-beta.90) (2025-02-09)
144
+
145
+ **Note:** Version bump only for package @nymphjs/query-parser
146
+
147
+ # [1.0.0-beta.89](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.88...v1.0.0-beta.89) (2025-02-09)
148
+
149
+ **Note:** Version bump only for package @nymphjs/query-parser
150
+
151
+ # [1.0.0-beta.88](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.87...v1.0.0-beta.88) (2025-01-30)
152
+
153
+ **Note:** Version bump only for package @nymphjs/query-parser
154
+
155
+ # [1.0.0-beta.87](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.86...v1.0.0-beta.87) (2025-01-20)
156
+
157
+ **Note:** Version bump only for package @nymphjs/query-parser
158
+
159
+ # [1.0.0-beta.86](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.85...v1.0.0-beta.86) (2024-12-28)
160
+
161
+ **Note:** Version bump only for package @nymphjs/query-parser
162
+
163
+ # [1.0.0-beta.85](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.84...v1.0.0-beta.85) (2024-12-27)
164
+
165
+ **Note:** Version bump only for package @nymphjs/query-parser
166
+
167
+ # [1.0.0-beta.84](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.83...v1.0.0-beta.84) (2024-12-21)
168
+
169
+ **Note:** Version bump only for package @nymphjs/query-parser
170
+
171
+ # [1.0.0-beta.83](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.82...v1.0.0-beta.83) (2024-12-20)
172
+
173
+ **Note:** Version bump only for package @nymphjs/query-parser
174
+
175
+ # [1.0.0-beta.82](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.81...v1.0.0-beta.82) (2024-12-15)
176
+
177
+ ### Features
178
+
179
+ - migrate to es modules, upgrade all packages, migrate to Svelte 5 ([3f2b9e5](https://github.com/sciactive/nymphjs/commit/3f2b9e517b39934eddce66601d7fc747fbf3f9e6))
180
+
181
+ # [1.0.0-beta.81](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.80...v1.0.0-beta.81) (2024-09-28)
182
+
183
+ **Note:** Version bump only for package @nymphjs/query-parser
184
+
185
+ # [1.0.0-beta.80](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.79...v1.0.0-beta.80) (2024-09-28)
186
+
187
+ **Note:** Version bump only for package @nymphjs/query-parser
188
+
189
+ # [1.0.0-beta.79](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.78...v1.0.0-beta.79) (2024-09-28)
190
+
191
+ **Note:** Version bump only for package @nymphjs/query-parser
192
+
193
+ # [1.0.0-beta.78](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.77...v1.0.0-beta.78) (2024-09-27)
194
+
195
+ **Note:** Version bump only for package @nymphjs/query-parser
196
+
197
+ # [1.0.0-beta.77](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.76...v1.0.0-beta.77) (2024-09-26)
198
+
199
+ **Note:** Version bump only for package @nymphjs/query-parser
200
+
201
+ # [1.0.0-beta.76](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.75...v1.0.0-beta.76) (2024-09-25)
202
+
203
+ **Note:** Version bump only for package @nymphjs/query-parser
204
+
205
+ # [1.0.0-beta.75](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.74...v1.0.0-beta.75) (2024-09-24)
206
+
207
+ **Note:** Version bump only for package @nymphjs/query-parser
208
+
209
+ # [1.0.0-beta.74](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.73...v1.0.0-beta.74) (2024-09-21)
210
+
211
+ **Note:** Version bump only for package @nymphjs/query-parser
212
+
213
+ # [1.0.0-beta.73](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.72...v1.0.0-beta.73) (2024-09-20)
214
+
215
+ **Note:** Version bump only for package @nymphjs/query-parser
216
+
217
+ # [1.0.0-beta.72](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.71...v1.0.0-beta.72) (2024-09-20)
218
+
219
+ **Note:** Version bump only for package @nymphjs/query-parser
220
+
221
+ # [1.0.0-beta.71](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.70...v1.0.0-beta.71) (2024-09-20)
222
+
223
+ **Note:** Version bump only for package @nymphjs/query-parser
224
+
225
+ # [1.0.0-beta.70](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.69...v1.0.0-beta.70) (2024-09-20)
226
+
227
+ **Note:** Version bump only for package @nymphjs/query-parser
228
+
229
+ # [1.0.0-beta.69](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.68...v1.0.0-beta.69) (2024-09-19)
230
+
231
+ **Note:** Version bump only for package @nymphjs/query-parser
232
+
233
+ # [1.0.0-beta.68](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.67...v1.0.0-beta.68) (2024-09-19)
234
+
235
+ **Note:** Version bump only for package @nymphjs/query-parser
236
+
237
+ # [1.0.0-beta.67](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.66...v1.0.0-beta.67) (2024-09-03)
238
+
239
+ **Note:** Version bump only for package @nymphjs/query-parser
240
+
241
+ # [1.0.0-beta.66](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.65...v1.0.0-beta.66) (2024-08-06)
242
+
243
+ **Note:** Version bump only for package @nymphjs/query-parser
244
+
245
+ # [1.0.0-beta.65](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.64...v1.0.0-beta.65) (2024-08-05)
246
+
247
+ **Note:** Version bump only for package @nymphjs/query-parser
248
+
249
+ # [1.0.0-beta.64](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.63...v1.0.0-beta.64) (2024-08-04)
250
+
251
+ **Note:** Version bump only for package @nymphjs/query-parser
252
+
253
+ # [1.0.0-beta.63](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.62...v1.0.0-beta.63) (2024-06-18)
254
+
255
+ **Note:** Version bump only for package @nymphjs/query-parser
256
+
257
+ # [1.0.0-beta.62](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.61...v1.0.0-beta.62) (2024-06-15)
258
+
259
+ **Note:** Version bump only for package @nymphjs/query-parser
260
+
261
+ # [1.0.0-beta.61](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.60...v1.0.0-beta.61) (2024-06-14)
262
+
263
+ **Note:** Version bump only for package @nymphjs/query-parser
264
+
265
+ # [1.0.0-beta.60](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.59...v1.0.0-beta.60) (2024-06-14)
266
+
267
+ **Note:** Version bump only for package @nymphjs/query-parser
268
+
269
+ # [1.0.0-beta.59](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.58...v1.0.0-beta.59) (2024-06-14)
270
+
271
+ **Note:** Version bump only for package @nymphjs/query-parser
272
+
273
+ # [1.0.0-beta.58](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.57...v1.0.0-beta.58) (2024-06-12)
274
+
275
+ **Note:** Version bump only for package @nymphjs/query-parser
276
+
277
+ # [1.0.0-beta.57](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.56...v1.0.0-beta.57) (2024-06-12)
278
+
279
+ **Note:** Version bump only for package @nymphjs/query-parser
280
+
281
+ # [1.0.0-beta.56](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.55...v1.0.0-beta.56) (2024-06-11)
282
+
283
+ **Note:** Version bump only for package @nymphjs/query-parser
284
+
285
+ # [1.0.0-beta.55](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.54...v1.0.0-beta.55) (2024-05-26)
286
+
287
+ **Note:** Version bump only for package @nymphjs/query-parser
288
+
289
+ # [1.0.0-beta.54](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.53...v1.0.0-beta.54) (2024-05-26)
290
+
291
+ **Note:** Version bump only for package @nymphjs/query-parser
292
+
293
+ # [1.0.0-beta.53](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.52...v1.0.0-beta.53) (2024-05-26)
294
+
295
+ **Note:** Version bump only for package @nymphjs/query-parser
296
+
297
+ # [1.0.0-beta.52](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.51...v1.0.0-beta.52) (2024-05-25)
298
+
299
+ **Note:** Version bump only for package @nymphjs/query-parser
300
+
301
+ # [1.0.0-beta.51](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.50...v1.0.0-beta.51) (2024-04-12)
302
+
303
+ ### Bug Fixes
304
+
305
+ - query parser nested qref clauses ([10bd94d](https://github.com/sciactive/nymphjs/commit/10bd94df0329a3abc76cecb9d05f9a7fb2fdf29a))
306
+
307
+ # [1.0.0-beta.50](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.49...v1.0.0-beta.50) (2024-04-08)
308
+
309
+ **Note:** Version bump only for package @nymphjs/query-parser
310
+
311
+ # [1.0.0-beta.49](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.48...v1.0.0-beta.49) (2024-03-04)
312
+
313
+ **Note:** Version bump only for package @nymphjs/query-parser
314
+
315
+ # [1.0.0-beta.48](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.47...v1.0.0-beta.48) (2023-11-10)
316
+
317
+ **Note:** Version bump only for package @nymphjs/query-parser
318
+
319
+ # [1.0.0-beta.47](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.46...v1.0.0-beta.47) (2023-11-10)
320
+
321
+ **Note:** Version bump only for package @nymphjs/query-parser
322
+
323
+ # [1.0.0-beta.46](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.45...v1.0.0-beta.46) (2023-08-29)
324
+
325
+ **Note:** Version bump only for package @nymphjs/query-parser
326
+
327
+ # [1.0.0-beta.45](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.44...v1.0.0-beta.45) (2023-07-17)
328
+
329
+ **Note:** Version bump only for package @nymphjs/query-parser
330
+
331
+ # [1.0.0-beta.44](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.43...v1.0.0-beta.44) (2023-07-13)
332
+
333
+ **Note:** Version bump only for package @nymphjs/query-parser
334
+
335
+ # [1.0.0-beta.43](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.42...v1.0.0-beta.43) (2023-07-12)
336
+
337
+ **Note:** Version bump only for package @nymphjs/query-parser
338
+
339
+ # [1.0.0-beta.42](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.41...v1.0.0-beta.42) (2023-07-12)
340
+
341
+ **Note:** Version bump only for package @nymphjs/query-parser
342
+
343
+ # [1.0.0-beta.41](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.40...v1.0.0-beta.41) (2023-07-12)
344
+
345
+ **Note:** Version bump only for package @nymphjs/query-parser
346
+
347
+ # [1.0.0-beta.40](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.39...v1.0.0-beta.40) (2023-07-10)
348
+
349
+ **Note:** Version bump only for package @nymphjs/query-parser
350
+
351
+ # [1.0.0-beta.39](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.38...v1.0.0-beta.39) (2023-07-09)
352
+
353
+ **Note:** Version bump only for package @nymphjs/query-parser
354
+
355
+ # [1.0.0-beta.38](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.37...v1.0.0-beta.38) (2023-07-09)
356
+
357
+ **Note:** Version bump only for package @nymphjs/query-parser
358
+
359
+ # [1.0.0-beta.37](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.36...v1.0.0-beta.37) (2023-07-09)
360
+
361
+ **Note:** Version bump only for package @nymphjs/query-parser
362
+
363
+ # [1.0.0-beta.36](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.35...v1.0.0-beta.36) (2023-07-09)
364
+
365
+ **Note:** Version bump only for package @nymphjs/query-parser
366
+
367
+ # [1.0.0-beta.35](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.34...v1.0.0-beta.35) (2023-06-14)
368
+
369
+ **Note:** Version bump only for package @nymphjs/query-parser
370
+
371
+ # [1.0.0-beta.34](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.33...v1.0.0-beta.34) (2023-05-13)
372
+
373
+ **Note:** Version bump only for package @nymphjs/query-parser
374
+
375
+ # [1.0.0-beta.33](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.32...v1.0.0-beta.33) (2023-05-13)
376
+
377
+ **Note:** Version bump only for package @nymphjs/query-parser
378
+
379
+ # [1.0.0-beta.32](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.31...v1.0.0-beta.32) (2023-05-13)
380
+
381
+ **Note:** Version bump only for package @nymphjs/query-parser
382
+
383
+ # [1.0.0-beta.31](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.30...v1.0.0-beta.31) (2023-05-12)
384
+
385
+ **Note:** Version bump only for package @nymphjs/query-parser
386
+
387
+ # [1.0.0-beta.30](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.29...v1.0.0-beta.30) (2023-05-12)
388
+
389
+ **Note:** Version bump only for package @nymphjs/query-parser
390
+
391
+ # [1.0.0-beta.29](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.28...v1.0.0-beta.29) (2023-05-08)
392
+
393
+ **Note:** Version bump only for package @nymphjs/query-parser
394
+
395
+ # [1.0.0-beta.28](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.27...v1.0.0-beta.28) (2023-05-05)
396
+
397
+ **Note:** Version bump only for package @nymphjs/query-parser
398
+
399
+ # [1.0.0-beta.27](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.26...v1.0.0-beta.27) (2023-05-04)
400
+
401
+ **Note:** Version bump only for package @nymphjs/query-parser
402
+
403
+ # [1.0.0-beta.26](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.25...v1.0.0-beta.26) (2023-05-04)
404
+
405
+ ### Features
406
+
407
+ - update packages and migrate to mysql2 ([72ad611](https://github.com/sciactive/nymphjs/commit/72ad611bd2bf7bf85c3ba8a3486503d9b50c49d6))
408
+
409
+ # [1.0.0-beta.25](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.24...v1.0.0-beta.25) (2023-05-04)
410
+
411
+ **Note:** Version bump only for package @nymphjs/query-parser
412
+
413
+ # [1.0.0-beta.24](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.23...v1.0.0-beta.24) (2023-05-02)
414
+
415
+ **Note:** Version bump only for package @nymphjs/query-parser
416
+
417
+ # [1.0.0-beta.23](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.22...v1.0.0-beta.23) (2023-05-02)
418
+
419
+ **Note:** Version bump only for package @nymphjs/query-parser
420
+
421
+ # [1.0.0-beta.22](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.21...v1.0.0-beta.22) (2023-05-01)
422
+
423
+ **Note:** Version bump only for package @nymphjs/query-parser
424
+
425
+ # [1.0.0-beta.21](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.20...v1.0.0-beta.21) (2023-05-01)
426
+
427
+ **Note:** Version bump only for package @nymphjs/query-parser
428
+
429
+ # [1.0.0-beta.20](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.19...v1.0.0-beta.20) (2023-04-30)
430
+
431
+ **Note:** Version bump only for package @nymphjs/query-parser
432
+
433
+ # [1.0.0-beta.19](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.18...v1.0.0-beta.19) (2023-04-29)
434
+
435
+ **Note:** Version bump only for package @nymphjs/query-parser
436
+
437
+ # [1.0.0-beta.18](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.17...v1.0.0-beta.18) (2023-04-27)
438
+
439
+ **Note:** Version bump only for package @nymphjs/query-parser
440
+
441
+ # [1.0.0-beta.17](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.16...v1.0.0-beta.17) (2023-04-24)
442
+
443
+ **Note:** Version bump only for package @nymphjs/query-parser
444
+
445
+ # [1.0.0-beta.16](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.15...v1.0.0-beta.16) (2023-03-31)
446
+
447
+ **Note:** Version bump only for package @nymphjs/query-parser
448
+
449
+ # [1.0.0-beta.15](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.14...v1.0.0-beta.15) (2023-03-23)
450
+
451
+ ### Features
452
+
453
+ - add option to sort results by a property ([16384e7](https://github.com/sciactive/nymphjs/commit/16384e7bdab88abb55ccccabb06ac09f92fa8a03))
454
+
455
+ # [1.0.0-beta.14](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.13...v1.0.0-beta.14) (2023-03-17)
456
+
457
+ **Note:** Version bump only for package @nymphjs/query-parser
458
+
459
+ # [1.0.0-beta.13](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.12...v1.0.0-beta.13) (2023-03-16)
460
+
461
+ **Note:** Version bump only for package @nymphjs/query-parser
462
+
6
463
  # [1.0.0-beta.12](https://github.com/sciactive/nymphjs/compare/v1.0.0-beta.11...v1.0.0-beta.12) (2023-03-04)
7
464
 
8
465
  **Note:** Version bump only for package @nymphjs/query-parser
package/README.md CHANGED
@@ -23,7 +23,7 @@ import Category from './Category';
23
23
  async function doQuery() {
24
24
  const [options, ...selectors] = queryParser({
25
25
  query:
26
- 'limit:4 foobar (| [archived] mdate<"2 weeks ago") category<{cat Tech}>',
26
+ 'limit:4 sort:mdate foobar (| [archived] mdate<"2 weeks ago") category<{cat Tech}>',
27
27
  entityClass: BlogPost,
28
28
  defaultFields: ['title', 'body'],
29
29
  qrefMap: {
@@ -37,7 +37,8 @@ async function doQuery() {
37
37
  Options will be
38
38
  {
39
39
  class: BlogPost,
40
- limit: 4
40
+ limit: 4,
41
+ sort: 'mdate'
41
42
  }
42
43
 
43
44
  And selectors will be (equivalent to)
@@ -81,14 +82,17 @@ async function doQuery() {
81
82
 
82
83
  ## Options
83
84
 
84
- You can set limit, offset, and reverse like this.
85
+ You can set limit, offset, sort, and reverse like this.
85
86
 
86
87
  - `limit:number`
87
88
  - `offset:number`
89
+ - `sort:string`, `sort:-`
88
90
  - `reverse:true`, `reverse:false`, `reverse:1`, or `reverse:0`
89
91
 
90
92
  These must appear in the top level of the query (outside of any parentheses).
91
93
 
94
+ Using a dash for sort means the results will not be sorted in any particular order. You can also use "cdate" for created date and "mdate" for modified date.
95
+
92
96
  ## Clauses
93
97
 
94
98
  These are the available clauses, and their syntax.
@@ -132,18 +136,24 @@ Check for a reference to another entity.
132
136
  Check for a reference to another entity using a query.
133
137
 
134
138
  - `name<{refclassname inner query}>` or `name!<{refclassname inner query}>`
135
- - (Esacpe curly brackets with a leading backslash.)
139
+ - (Escape curly brackets with a leading backslash.)
136
140
  - (Requires a map of refclassname to their actual class and default fields.)
137
141
 
138
142
  ### contain and !contain
139
143
 
140
- Check for a JSON representation appearing within the JSON representation of the named property.
144
+ Check if the array at the named property contains a value.
141
145
 
142
146
  - `name<value>` or `name!<value>`
143
147
  - (Escape angle brackets with a leading backslash. If your value could be interpreted as valid JSON, encode it as a JSON string and use the JSON syntax instead.)
144
148
  - `name<JSON>` or `name!<JSON>`
145
149
  - (Search for a JSON encoded value (like `true`, `1`, `[1,2,3]`, or `{"prop":"val"}`).)
146
150
 
151
+ ### search and !search
152
+
153
+ Check for full-text search query match. Use single quotes to find sequential terms and double quotes to find exact terms. Use "or" as the or operator. Use "-" before a term as the negation operator. Stop words and punctuation are stripped. Case insensitive.
154
+
155
+ - `name(query)` or `name!(query)`
156
+
147
157
  ### match and !match
148
158
 
149
159
  Check for POSIX regex match.
@@ -237,7 +247,7 @@ You can also supply a function in the option `bareHandler` that will handle bare
237
247
 
238
248
  # License
239
249
 
240
- Copyright 2021 SciActive Inc
250
+ Copyright 2021-2025 SciActive Inc
241
251
 
242
252
  Licensed under the Apache License, Version 2.0 (the "License");
243
253
  you may not use this file except in compliance with the License.
package/dist/index.d.ts ADDED
@@ -0,0 +1,4 @@
1
+ export * from './queryParser.js';
2
+ import queryParser from './queryParser.js';
3
+ export { queryParser };
4
+ export default queryParser;
package/dist/index.js CHANGED
@@ -1,2 +1,5 @@
1
- !function(e,t){"object"==typeof exports&&"object"==typeof module?module.exports=t():"function"==typeof define&&define.amd?define([],t):"object"==typeof exports?exports["@nymphjs/client"]=t():e["@nymphjs/client"]=t()}(this,(()=>(()=>{"use strict";var e={568:function(e,t,l){var r=this&&this.__createBinding||(Object.create?function(e,t,l,r){void 0===r&&(r=l);var i=Object.getOwnPropertyDescriptor(t,l);i&&!("get"in i?!t.__esModule:i.writable||i.configurable)||(i={enumerable:!0,get:function(){return t[l]}}),Object.defineProperty(e,r,i)}:function(e,t,l,r){void 0===r&&(r=l),e[r]=t[l]}),i=this&&this.__exportStar||function(e,t){for(var l in e)"default"===l||Object.prototype.hasOwnProperty.call(t,l)||r(t,e,l)},c=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0}),t.queryParser=void 0,i(l(138),t);const n=c(l(138));t.queryParser=n.default,t.default=n.default},138:function(e,t,l){var r=this&&this.__importDefault||function(e){return e&&e.__esModule?e:{default:e}};Object.defineProperty(t,"__esModule",{value:!0});const i=r(l(87));function c({query:e,entityClass:t,defaultFields:l=["name"],qrefMap:r={},bareHandler:i=((e,t,l=["name"])=>(e.match(/[_%]/)||(e=`%${e}%`),l.length?{type:"|",ilike:l.map((t=>[t,e]))}:{}))}){const c={class:t};return[c,...n({query:e,entityClass:t,type:"&",defaultFields:l,qrefMap:r,options:c,bareHandler:i})]}function n({query:e,entityClass:t,type:l,defaultFields:r,qrefMap:o,options:h,bareHandler:u}){const p={type:l};let f=e;const g=[];let d=!1,m=0,y=null;for(let e=0;e<f.length;e++)if('"'===f[e])d?"\\"!==f[e-1]&&(d=!1):d=!0;else{if(d)continue;"("===f[e]?null==y?y=e:m++:")"===f[e]&&(0===m?null==y||(g.push([y,e+1]),y=null):m--)}if(g.length){p.selector=[],g.reverse();for(let e of g){let l=f.slice(e[0]+1,e[1]-1);f=f.slice(0,e[0])+f.slice(e[1]);let i="&";l.startsWith("&")?l=l.slice(1):l.startsWith("!&")?(i="!&",l=l.slice(2)):l.startsWith("|")?(i="|",l=l.slice(1)):l.startsWith("!|")?(i="!|",l=l.slice(2)):l.startsWith("!")&&(i="!&",l=l.slice(1)),p.selector.push(...n({query:l,entityClass:t,type:i,defaultFields:r,qrefMap:o,bareHandler:u}))}}if(f=function({query:e,selector:t,qrefMap:l,bareHandler:r}){let n=e;const o=/(?: |^)(\w+)!?<\{(\w+) (.*?[^\\])\}>(?= |$)/g,h=n.match(o);if(h){t.qref=[],t["!qref"]=[];for(let e of h)try{let[n,a]=(0,i.default)(e.trim().slice(0,-1),"<",2);u=a.slice(1,-1),a=u.replace(/\\\{/g,"{").replace(/\\\}/g,"}").replace(/\\\\/g,"\\");let[s,o]=a.split(" ",2);const h=l[s].class;if(null==h)continue;const p=c({query:o,entityClass:h,defaultFields:l[s].defaultFields,qrefMap:l,bareHandler:r});n.endsWith("!")?t["!qref"].push([n.slice(0,-1),p]):t.qref.push([n,p])}catch(e){continue}t.qref.length||delete t.qref,t["!qref"].length||delete t["!qref"]}var u;n=n.replace(o,"");const p=/(?: |^)(\w+)!?=(""|".*?[^\\]"|[^ ]+)(?= |$)/g,f=n.match(p);if(f){t.equal=[],t["!equal"]=[];for(let e of f)try{let[l,r]=e.trim().split("=",2);try{l.endsWith("!")?t["!equal"].push([l.slice(0,-1),JSON.parse(r)]):t.equal.push([l,JSON.parse(r)])}catch(e){l.endsWith("!")?t["!equal"].push([l.slice(0,-1),a(r)]):t.equal.push([l,a(r)])}}catch(e){continue}t.equal.length||delete t.equal,t["!equal"].length||delete t["!equal"]}n=n.replace(p,"");const g=/(?: |^)(\w+)!?<\{([0-9a-f]{24})\}>(?= |$)/g,d=n.match(g);if(d){t.ref=[],t["!ref"]=[];for(let e of d)try{let[l,r]=e.trim().slice(0,-1).split("<",2);l.endsWith("!")?t["!ref"].push([l.slice(0,-1),r.slice(1,-1)]):t.ref.push([l,r.slice(1,-1)])}catch(e){continue}t.ref.length||delete t.ref,t["!ref"].length||delete t["!ref"]}n=n.replace(g,"");const m=/(?: |^)(\w+)!?(<.*?[^\\]>)(?= |$)/g,y=n.match(m);if(y){t.contain=[],t["!contain"]=[];for(let e of y)try{let[l,r]=e.trim().slice(0,-1).split("<",2);try{l.endsWith("!")?t["!contain"].push([l.slice(0,-1),JSON.parse(s(r))]):t.contain.push([l,JSON.parse(s(r))])}catch(e){l.endsWith("!")?t["!contain"].push([l.slice(0,-1),s(r)]):t.contain.push([l,s(r)])}}catch(e){continue}t.contain.length||delete t.contain,t["!contain"].length||delete t["!contain"]}n=n.replace(m,"");const b=/(?: |^)(\w+)!?~(\/\/|\/.*?[^\\]\/)i?(?= |$)/g,q=n.match(b);if(q){t.match=[],t["!match"]=[],t.imatch=[],t["!imatch"]=[];for(let e of q)try{let[l,r]=e.trim().split("~",2);l.endsWith("!")?r.endsWith("i")?t["!imatch"].push([l.slice(0,-1),r.replace(/^\/|\/i$/g,"")]):t["!match"].push([l.slice(0,-1),r.replace(/^\/|\/$/g,"")]):r.endsWith("i")?t.imatch.push([l,r.replace(/^\/|\/i$/g,"")]):t.match.push([l,r.replace(/^\/|\/$/g,"")])}catch(e){continue}t.match.length||delete t.match,t["!match"].length||delete t["!match"],t.imatch.length||delete t.imatch,t["!imatch"].length||delete t["!imatch"]}n=n.replace(b,"");const $=/(?: |^)(\w+)!?~(""i?|".*?[^\\]"i?|[^ ]+)(?= |$)/g,w=n.match($);if(w){t.like=[],t["!like"]=[],t.ilike=[],t["!ilike"]=[];for(let e of w)try{let[l,r]=e.trim().split("~",2);l.endsWith("!")?r.endsWith('"i')?t["!ilike"].push([l.slice(0,-1),a(r.slice(0,-1))]):t["!like"].push([l.slice(0,-1),a(r)]):r.endsWith('"i')?t.ilike.push([l,a(r.slice(0,-1))]):t.like.push([l,a(r)])}catch(e){continue}t.like.length||delete t.like,t["!like"].length||delete t["!like"],t.ilike.length||delete t.ilike,t["!ilike"].length||delete t["!ilike"]}n=n.replace($,"");const _=/(?: |^)\{!?([0-9a-f]{24})\}(?= |$)/g,k=n.match(_);if(k){t.guid=[],t["!guid"]=[];for(let e of k)try{let l=e.trim().replace(/^\{|\}$/g,"");l.startsWith("!")?t["!guid"].push(l.slice(1)):t.guid.push(l)}catch(e){continue}t.guid.length||delete t.guid,t["!guid"].length||delete t["!guid"]}n=n.replace(_,"");const v=/(?: |^)\[(!?\w+)\](?= |$)/g,O=n.match(v);if(O){t.truthy=[],t["!truthy"]=[];for(let e of O)try{let l=e.trim().replace(/^\[|\]$/g,"");l.startsWith("!")?t["!truthy"].push(l.slice(1)):t.truthy.push(l)}catch(e){continue}t.truthy.length||delete t.truthy,t["!truthy"].length||delete t["!truthy"]}n=n.replace(v,"");const W=/(?: |^)<(!?\w+)>(?= |$)/g,j=n.match(W);if(j){t.tag=[],t["!tag"]=[];for(let e of j)try{let l=e.trim().replace(/^<|>$/g,"");l.startsWith("!")?t["!tag"].push(l.slice(1)):t.tag.push(l)}catch(e){continue}t.tag.length||delete t.tag,t["!tag"].length||delete t["!tag"]}n=n.replace(W,"");const M=/(?: |^)(\w+)>(-?\d+(?:\.\d+)?)(?= |$)/g,P=n.match(M);if(P){t.gt=[];for(let e of P)try{let[l,r]=e.trim().split(">",2);t.gt.push([l,Number(r)])}catch(e){continue}t.gt.length||delete t.gt}n=n.replace(M,"");const x=/(?: |^)(\w+)>(\w+|"[^"]+")(?= |$)/g,N=n.match(x);if(N){null==t.gt&&(t.gt=[]);for(let e of N)try{let[l,r]=e.trim().split(">",2);t.gt.push([l,null,r.replace(/"/g,"")])}catch(e){continue}t.gt.length||delete t.gt}n=n.replace(x,"");const S=/(?: |^)(\w+)>=(-?\d+(?:\.\d+)?)(?= |$)/g,H=n.match(S);if(H){t.gte=[];for(let e of H)try{let[l,r]=e.trim().split(">=",2);t.gte.push([l,Number(r)])}catch(e){continue}t.gte.length||delete t.gte}n=n.replace(S,"");const F=/(?: |^)(\w+)>=(\w+|"[^"]+")(?= |$)/g,C=n.match(F);if(C){null==t.gte&&(t.gte=[]);for(let e of C)try{let[l,r]=e.trim().split(">=",2);t.gte.push([l,null,r.replace(/"/g,"")])}catch(e){continue}t.gte.length||delete t.gte}n=n.replace(F,"");const J=/(?: |^)(\w+)<(-?\d+(?:\.\d+)?)(?= |$)/g,D=n.match(J);if(D){t.lt=[];for(let e of D)try{let[l,r]=e.trim().split("<",2);t.lt.push([l,Number(r)])}catch(e){continue}t.lt.length||delete t.lt}n=n.replace(J,"");const T=/(?: |^)(\w+)<(\w+|"[^"]+")(?= |$)/g,B=n.match(T);if(B){null==t.lt&&(t.lt=[]);for(let e of B)try{let[l,r]=e.trim().split("<",2);t.lt.push([l,null,r.replace(/"/g,"")])}catch(e){continue}t.lt.length||delete t.lt}n=n.replace(T,"");const z=/(?: |^)(\w+)<=(-?\d+(?:\.\d+)?)(?= |$)/g,A=n.match(z);if(A){t.lte=[];for(let e of A)try{let[l,r]=e.trim().split("<=",2);t.lte.push([l,Number(r)])}catch(e){continue}t.lte.length||delete t.lte}n=n.replace(z,"");const E=/(?: |^)(\w+)<=(\w+|"[^"]+")(?= |$)/g,G=n.match(E);if(G){null==t.lte&&(t.lte=[]);for(let e of G)try{let[l,r]=e.trim().split("<=",2);t.lte.push([l,null,r.replace(/"/g,"")])}catch(e){continue}t.lte.length||delete t.lte}return n=n.replace(E,""),n.trim()}({query:f,selector:p,qrefMap:o,bareHandler:u}),h){const e=/(?: |^)limit:(\d+)(?= |$)/,t=f.match(e);t&&(h.limit=Number(t[1])),f=f.replace(e,"");const l=/(?: |^)offset:(\d+)(?= |$)/,r=f.match(l);r&&(h.offset=Number(r[1])),f=f.replace(l,"");const i=/(?: |^)reverse:(true|false|1|0)(?= |$)/,c=f.match(i);c&&(h.reverse="true"===c[1]||"1"===c[1]),f=f.replace(i,"")}if(f=f.trim(),f.length){const e=u(f,t,r);if(Object.keys(e).length)return[...Object.keys(p).length>1?[p]:[],{type:"|",...e}]}return!("selector"in p)||1!==p.selector.length||2!==Object.keys(p).length||"&"!==p.type&&"|"!==p.type?[p]:p.selector}function a(e){return e.match(/^".*?[^\\]"$/)?e.slice(1,-1).replace(/\\"/g,'"').replace(/\\\\/g,"\\"):e}function s(e){return e.replace(/\\</g,"<").replace(/\\>/g,">").replace(/\\\\/g,"\\")}t.default=c},87:(e,t,l)=>{function r(e,t,l=1/0){let r=e;const i=[];for(;i.length<l&&r.length;){const e=r.split(t,1);i.push(e[0]),r=r.slice(e[0].length),i.length<l&&r&&(r=r.replace(t,""),r||i.push(r))}return r&&l>0&&(i[i.length-1]+=r),i}l.r(t),l.d(t,{default:()=>r})}},t={};function l(r){var i=t[r];if(void 0!==i)return i.exports;var c=t[r]={exports:{}};return e[r].call(c.exports,c,c.exports,l),c.exports}return l.d=(e,t)=>{for(var r in t)l.o(t,r)&&!l.o(e,r)&&Object.defineProperty(e,r,{enumerable:!0,get:t[r]})},l.o=(e,t)=>Object.prototype.hasOwnProperty.call(e,t),l.r=e=>{"undefined"!=typeof Symbol&&Symbol.toStringTag&&Object.defineProperty(e,Symbol.toStringTag,{value:"Module"}),Object.defineProperty(e,"__esModule",{value:!0})},l(568)})()));
1
+ export * from './queryParser.js';
2
+ import queryParser from './queryParser.js';
3
+ export { queryParser };
4
+ export default queryParser;
2
5
  //# sourceMappingURL=index.js.map