@opensumi/ide-utils 2.21.13 → 2.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (114) hide show
  1. package/lib/arrays.d.ts +3 -3
  2. package/lib/arrays.d.ts.map +1 -1
  3. package/lib/arrays.js.map +1 -1
  4. package/lib/async.d.ts +3 -3
  5. package/lib/async.d.ts.map +1 -1
  6. package/lib/buffer.js +4 -4
  7. package/lib/buffer.js.map +1 -1
  8. package/lib/character-classifier.js +3 -3
  9. package/lib/character-classifier.js.map +1 -1
  10. package/lib/decorators.d.ts +1 -1
  11. package/lib/decorators.d.ts.map +1 -1
  12. package/lib/encoding.d.ts +7 -1
  13. package/lib/encoding.d.ts.map +1 -1
  14. package/lib/encoding.js +15 -2
  15. package/lib/encoding.js.map +1 -1
  16. package/lib/errors.d.ts +2 -2
  17. package/lib/errors.d.ts.map +1 -1
  18. package/lib/event.d.ts +2 -2
  19. package/lib/event.d.ts.map +1 -1
  20. package/lib/filters.d.ts +3 -3
  21. package/lib/filters.d.ts.map +1 -1
  22. package/lib/filters.js +25 -25
  23. package/lib/filters.js.map +1 -1
  24. package/lib/glob.d.ts +2 -2
  25. package/lib/glob.d.ts.map +1 -1
  26. package/lib/glob.js +1 -1
  27. package/lib/glob.js.map +1 -1
  28. package/lib/hash.js +10 -10
  29. package/lib/hash.js.map +1 -1
  30. package/lib/iterator.d.ts +1 -1
  31. package/lib/iterator.d.ts.map +1 -1
  32. package/lib/linked-text.d.ts +1 -1
  33. package/lib/linked-text.d.ts.map +1 -1
  34. package/lib/linked-text.js.map +1 -1
  35. package/lib/map.js +17 -17
  36. package/lib/map.js.map +1 -1
  37. package/lib/objects.d.ts +1 -0
  38. package/lib/objects.d.ts.map +1 -1
  39. package/lib/objects.js +38 -1
  40. package/lib/objects.js.map +1 -1
  41. package/lib/os.d.ts +1 -8
  42. package/lib/os.d.ts.map +1 -1
  43. package/lib/os.js +4 -8
  44. package/lib/os.js.map +1 -1
  45. package/lib/path.d.ts +1 -1
  46. package/lib/path.d.ts.map +1 -1
  47. package/lib/path.js +29 -29
  48. package/lib/path.js.map +1 -1
  49. package/lib/platform.js +8 -8
  50. package/lib/platform.js.map +1 -1
  51. package/lib/process.d.ts.map +1 -1
  52. package/lib/process.js +28 -13
  53. package/lib/process.js.map +1 -1
  54. package/lib/progress.js +3 -3
  55. package/lib/progress.js.map +1 -1
  56. package/lib/strings.js +9 -9
  57. package/lib/strings.js.map +1 -1
  58. package/lib/types.d.ts +5 -1
  59. package/lib/types.d.ts.map +1 -1
  60. package/lib/types.js +8 -1
  61. package/lib/types.js.map +1 -1
  62. package/lib/uint.js +4 -4
  63. package/lib/uint.js.map +1 -1
  64. package/lib/uri.js +8 -8
  65. package/lib/uri.js.map +1 -1
  66. package/lib/uuid.d.ts +1 -1
  67. package/lib/uuid.d.ts.map +1 -1
  68. package/lib/uuid.js +3 -2
  69. package/lib/uuid.js.map +1 -1
  70. package/package.json +8 -6
  71. package/src/ansi.ts +10 -0
  72. package/src/argv.ts +57 -0
  73. package/src/arrays.ts +328 -0
  74. package/src/async.ts +580 -0
  75. package/src/buffer.ts +290 -0
  76. package/src/cache.ts +37 -0
  77. package/src/cancellation.ts +136 -0
  78. package/src/charCode.ts +425 -0
  79. package/src/character-classifier.ts +82 -0
  80. package/src/const/encoding.ts +242 -0
  81. package/src/const/index.ts +1 -0
  82. package/src/date.ts +36 -0
  83. package/src/decorators.ts +166 -0
  84. package/src/disposable.ts +377 -0
  85. package/src/encoding.ts +278 -0
  86. package/src/errors.ts +192 -0
  87. package/src/event.ts +1024 -0
  88. package/src/file-uri.ts +41 -0
  89. package/src/filters.ts +887 -0
  90. package/src/functional.ts +43 -0
  91. package/src/glob.ts +752 -0
  92. package/src/hash.ts +336 -0
  93. package/src/iconLabels.ts +149 -0
  94. package/src/index.ts +40 -0
  95. package/src/iterator.ts +36 -0
  96. package/src/lifecycle.ts +48 -0
  97. package/src/linked-list.ts +144 -0
  98. package/src/linked-text.ts +55 -0
  99. package/src/lru-map.ts +133 -0
  100. package/src/map.ts +934 -0
  101. package/src/marshalling.ts +62 -0
  102. package/src/objects.ts +145 -0
  103. package/src/os.ts +76 -0
  104. package/src/path.ts +1885 -0
  105. package/src/platform.ts +194 -0
  106. package/src/process.ts +43 -0
  107. package/src/progress.ts +83 -0
  108. package/src/promises.ts +23 -0
  109. package/src/sequence.ts +28 -0
  110. package/src/strings.ts +1002 -0
  111. package/src/types.ts +214 -0
  112. package/src/uint.ts +59 -0
  113. package/src/uri.ts +298 -0
  114. package/src/uuid.ts +6 -0
package/src/glob.ts ADDED
@@ -0,0 +1,752 @@
1
+ /* eslint-disable @typescript-eslint/consistent-type-assertions */
2
+ /* eslint-disable brace-style */
3
+ /* eslint-disable no-case-declarations */
4
+ /* ---------------------------------------------------------------------------------------------
5
+ * Copyright (c) Microsoft Corporation. All rights reserved.
6
+ * Licensed under the MIT License. See License.txt in the project root for license information.
7
+ *--------------------------------------------------------------------------------------------*/
8
+ // Some code copied and modified from https://github.com/microsoft/vscode/blob/1.44.0/src/vs/base/common/glob.ts
9
+
10
+ import { CharCode } from './charCode';
11
+ import { LRUCache } from './map';
12
+ import { Path, basename as getBaseName, extname } from './path';
13
+ import * as strings from './strings';
14
+
15
+ export interface IExpression {
16
+ [pattern: string]: boolean | SiblingClause;
17
+ }
18
+
19
+ export interface IRelativePattern {
20
+ base: string;
21
+ pattern: string;
22
+ }
23
+
24
+ export function getEmptyExpression(): IExpression {
25
+ return Object.create(null);
26
+ }
27
+
28
+ export interface SiblingClause {
29
+ when: string;
30
+ }
31
+
32
+ const GLOBSTAR = '**';
33
+ const GLOB_SPLIT = '/';
34
+ const PATH_REGEX = '[/\\\\]'; // any slash or backslash
35
+ const NO_PATH_REGEX = '[^/\\\\]'; // any non-slash and non-backslash
36
+ const ALL_FORWARD_SLASHES = /\//g;
37
+
38
+ function starsToRegExp(starCount: number): string {
39
+ switch (starCount) {
40
+ case 0:
41
+ return '';
42
+ case 1:
43
+ return `${NO_PATH_REGEX}*?`; // 1 star matches any number of characters except path separator (/ and \) - non greedy (?)
44
+ default:
45
+ // Matches: (Path Sep OR Path Val followed by Path Sep OR Path Sep followed by Path Val) 0-many times
46
+ // Group is non capturing because we don't need to capture at all (?:...)
47
+ // Overall we use non-greedy matching because it could be that we match too much
48
+ return `(?:${PATH_REGEX}|${NO_PATH_REGEX}+${PATH_REGEX}|${PATH_REGEX}${NO_PATH_REGEX}+)*?`;
49
+ }
50
+ }
51
+
52
+ export function splitGlobAware(pattern: string, splitChar: string): string[] {
53
+ if (!pattern) {
54
+ return [];
55
+ }
56
+
57
+ const segments: string[] = [];
58
+
59
+ let inBraces = false;
60
+ let inBrackets = false;
61
+
62
+ let curVal = '';
63
+ for (const char of pattern) {
64
+ switch (char) {
65
+ case splitChar:
66
+ if (!inBraces && !inBrackets) {
67
+ segments.push(curVal);
68
+ curVal = '';
69
+
70
+ continue;
71
+ }
72
+ break;
73
+ case '{':
74
+ inBraces = true;
75
+ break;
76
+ case '}':
77
+ inBraces = false;
78
+ break;
79
+ case '[':
80
+ inBrackets = true;
81
+ break;
82
+ case ']':
83
+ inBrackets = false;
84
+ break;
85
+ }
86
+
87
+ curVal += char;
88
+ }
89
+
90
+ // Tail
91
+ if (curVal) {
92
+ segments.push(curVal);
93
+ }
94
+
95
+ return segments;
96
+ }
97
+
98
+ function parseRegExp(pattern: string): string {
99
+ if (!pattern) {
100
+ return '';
101
+ }
102
+
103
+ let regEx = '';
104
+
105
+ // Split up into segments for each slash found
106
+ const segments = splitGlobAware(pattern, GLOB_SPLIT);
107
+
108
+ // Special case where we only have globstars
109
+ if (segments.every((s) => s === GLOBSTAR)) {
110
+ regEx = '.*';
111
+ }
112
+
113
+ // Build regex over segments
114
+ else {
115
+ let previousSegmentWasGlobStar = false;
116
+ segments.forEach((segment, index) => {
117
+ // Globstar is special
118
+ if (segment === GLOBSTAR) {
119
+ // if we have more than one globstar after another, just ignore it
120
+ if (!previousSegmentWasGlobStar) {
121
+ regEx += starsToRegExp(2);
122
+ previousSegmentWasGlobStar = true;
123
+ }
124
+
125
+ return;
126
+ }
127
+
128
+ // States
129
+ let inBraces = false;
130
+ let braceVal = '';
131
+
132
+ let inBrackets = false;
133
+ let bracketVal = '';
134
+
135
+ for (const char of segment) {
136
+ // Support brace expansion
137
+ if (char !== '}' && inBraces) {
138
+ braceVal += char;
139
+ continue;
140
+ }
141
+
142
+ // Support brackets
143
+ if (
144
+ inBrackets &&
145
+ (char !== ']' || !bracketVal) /* ] is literally only allowed as first character in brackets to match it */
146
+ ) {
147
+ let res: string;
148
+
149
+ // range operator
150
+ if (char === '-') {
151
+ res = char;
152
+ }
153
+
154
+ // negation operator (only valid on first index in bracket)
155
+ else if ((char === '^' || char === '!') && !bracketVal) {
156
+ res = '^';
157
+ }
158
+
159
+ // glob split matching is not allowed within character ranges
160
+ // see http://man7.org/linux/man-pages/man7/glob.7.html
161
+ else if (char === GLOB_SPLIT) {
162
+ res = '';
163
+ }
164
+
165
+ // anything else gets escaped
166
+ else {
167
+ res = strings.escapeRegExpCharacters(char);
168
+ }
169
+
170
+ bracketVal += res;
171
+ continue;
172
+ }
173
+
174
+ switch (char) {
175
+ case '{':
176
+ inBraces = true;
177
+ continue;
178
+
179
+ case '[':
180
+ inBrackets = true;
181
+ continue;
182
+
183
+ case '}':
184
+ const choices = splitGlobAware(braceVal, ',');
185
+
186
+ // Converts {foo,bar} => [foo|bar]
187
+ const braceRegExp = `(?:${choices.map((c) => parseRegExp(c)).join('|')})`;
188
+
189
+ regEx += braceRegExp;
190
+
191
+ inBraces = false;
192
+ braceVal = '';
193
+
194
+ break;
195
+
196
+ case ']':
197
+ regEx += '[' + bracketVal + ']';
198
+
199
+ inBrackets = false;
200
+ bracketVal = '';
201
+
202
+ break;
203
+
204
+ case '?':
205
+ regEx += NO_PATH_REGEX; // 1 ? matches any single character except path separator (/ and \)
206
+ continue;
207
+
208
+ case '*':
209
+ regEx += starsToRegExp(1);
210
+ continue;
211
+
212
+ default:
213
+ regEx += strings.escapeRegExpCharacters(char);
214
+ }
215
+ }
216
+
217
+ // Tail: Add the slash we had split on if there is more to come and the remaining pattern is not a globstar
218
+ // For example if pattern: some/**/*.js we want the "/" after some to be included in the RegEx to prevent
219
+ // a folder called "something" to match as well.
220
+ // However, if pattern: some/**, we tolerate that we also match on "something" because our globstar behaviour
221
+ // is to match 0-N segments.
222
+ if (index < segments.length - 1 && (segments[index + 1] !== GLOBSTAR || index + 2 < segments.length)) {
223
+ regEx += PATH_REGEX;
224
+ }
225
+
226
+ // reset state
227
+ previousSegmentWasGlobStar = false;
228
+ });
229
+ }
230
+
231
+ return regEx;
232
+ }
233
+
234
+ // regexes to check for trival glob patterns that just check for String#endsWith
235
+ const T1 = /^\*\*\/\*\.[\w\.-]+$/; // **/*.something
236
+ const T2 = /^\*\*\/([\w\.-]+)\/?$/; // **/something
237
+ const T3 = /^{\*\*\/[\*\.]?[\w\.-]+\/?(,\*\*\/[\*\.]?[\w\.-]+\/?)*}$/; // {**/*.something,**/*.else} or {**/package.json,**/project.json}
238
+ const T3_2 = /^{\*\*\/[\*\.]?[\w\.-]+(\/(\*\*)?)?(,\*\*\/[\*\.]?[\w\.-]+(\/(\*\*)?)?)*}$/; // Like T3, with optional trailing /**
239
+ const T4 = /^\*\*((\/[\w\.-]+)+)\/?$/; // **/something/else
240
+ const T5 = /^([\w\.-]+(\/[\w\.-]+)*)\/?$/; // something/else
241
+
242
+ export type ParsedPattern = (path: string, basename?: string) => boolean;
243
+
244
+ // The ParsedExpression returns a Promise iff hasSibling returns a Promise.
245
+ export type ParsedExpression = (
246
+ path: string,
247
+ basename?: string,
248
+ hasSibling?: (name: string) => boolean | Promise<boolean>,
249
+ ) => string | null | Promise<string | null> /* the matching pattern */;
250
+
251
+ export interface IGlobOptions {
252
+ /**
253
+ * Simplify patterns for use as exclusion filters during tree traversal to skip entire subtrees. Cannot be used outside of a tree traversal.
254
+ */
255
+ trimForExclusions?: boolean;
256
+ }
257
+
258
+ interface ParsedStringPattern {
259
+ (path: string, basename?: string): string | null | Promise<string | null> /* the matching pattern */;
260
+ basenames?: string[];
261
+ patterns?: string[];
262
+ allBasenames?: string[];
263
+ allPaths?: string[];
264
+ }
265
+ interface ParsedExpressionPattern {
266
+ (path: string, basename?: string, name?: string, hasSibling?: (name: string) => boolean | Promise<boolean>):
267
+ | string
268
+ | null
269
+ | Promise<string | null> /* the matching pattern */;
270
+ requiresSiblings?: boolean;
271
+ allBasenames?: string[];
272
+ allPaths?: string[];
273
+ }
274
+
275
+ const CACHE = new LRUCache<string, ParsedStringPattern>(10000); // bounded to 10000 elements
276
+
277
+ const FALSE = function () {
278
+ return false;
279
+ };
280
+
281
+ const NULL = function (): string | null {
282
+ return null;
283
+ };
284
+
285
+ function parsePattern(arg1: string | IRelativePattern, options: IGlobOptions): ParsedStringPattern {
286
+ if (!arg1) {
287
+ return NULL;
288
+ }
289
+
290
+ // Handle relative patterns
291
+ let pattern: string;
292
+ if (typeof arg1 !== 'string') {
293
+ pattern = arg1.pattern;
294
+ } else {
295
+ pattern = arg1;
296
+ }
297
+
298
+ // Whitespace trimming
299
+ pattern = pattern.trim();
300
+
301
+ // Check cache
302
+ const patternKey = `${pattern}_${!!options.trimForExclusions}`;
303
+ let parsedPattern = CACHE.get(patternKey);
304
+ if (parsedPattern) {
305
+ return wrapRelativePattern(parsedPattern, arg1);
306
+ }
307
+
308
+ // Check for Trivials
309
+ let match: RegExpExecArray | null;
310
+ if (T1.test(pattern)) {
311
+ parsedPattern = trivia1(pattern.substr(4), pattern); // common pattern: **/*.txt just need endsWith check
312
+ } else if ((match = T2.exec(trimForExclusions(pattern, options)))) {
313
+ // common pattern: **/some.txt just need basename check
314
+ parsedPattern = trivia2(match[1], pattern);
315
+ } else if ((options.trimForExclusions ? T3_2 : T3).test(pattern)) {
316
+ // repetition of common patterns (see above) {**/*.txt,**/*.png}
317
+ parsedPattern = trivia3(pattern, options);
318
+ } else if ((match = T4.exec(trimForExclusions(pattern, options)))) {
319
+ // common pattern: **/something/else just need endsWith check
320
+ parsedPattern = trivia4and5(match[1].substr(1), pattern, true);
321
+ } else if ((match = T5.exec(trimForExclusions(pattern, options)))) {
322
+ // common pattern: something/else just need equals check
323
+ parsedPattern = trivia4and5(match[1], pattern, false);
324
+ }
325
+
326
+ // Otherwise convert to pattern
327
+ else {
328
+ parsedPattern = toRegExp(pattern);
329
+ }
330
+
331
+ // Cache
332
+ CACHE.set(patternKey, parsedPattern);
333
+
334
+ return wrapRelativePattern(parsedPattern, arg1);
335
+ }
336
+
337
+ function wrapRelativePattern(parsedPattern: ParsedStringPattern, arg2: string | IRelativePattern): ParsedStringPattern {
338
+ if (typeof arg2 === 'string') {
339
+ return parsedPattern;
340
+ }
341
+
342
+ return function (path, basename) {
343
+ const base = new Path(arg2.base);
344
+ const target = new Path(path);
345
+ if (!base.isEqualOrParent(target)) {
346
+ return null;
347
+ }
348
+ return parsedPattern(base.relative(target)?.toString() || '', basename);
349
+ };
350
+ }
351
+
352
+ function trimForExclusions(pattern: string, options: IGlobOptions): string {
353
+ return options.trimForExclusions && pattern.endsWith('/**') ? pattern.substr(0, pattern.length - 2) : pattern; // dropping **, tailing / is dropped later
354
+ }
355
+
356
+ // common pattern: **/*.txt just need endsWith check
357
+ function trivia1(base: string, pattern: string): ParsedStringPattern {
358
+ return function (path: string, basename?: string) {
359
+ return typeof path === 'string' && path.endsWith(base) ? pattern : null;
360
+ };
361
+ }
362
+
363
+ // common pattern: **/some.txt just need basename check
364
+ function trivia2(base: string, originalPattern: string): ParsedStringPattern {
365
+ const slashBase = `/${base}`;
366
+ const backslashBase = `\\${base}`;
367
+ const parsedPattern: ParsedStringPattern = function (path, basename) {
368
+ if (typeof path !== 'string') {
369
+ return null;
370
+ }
371
+ if (basename) {
372
+ return basename === base ? originalPattern : null;
373
+ }
374
+ return path === base || path.endsWith(slashBase) || path.endsWith(backslashBase) ? originalPattern : null;
375
+ };
376
+ const basenames = [base];
377
+ parsedPattern.basenames = basenames;
378
+ parsedPattern.patterns = [originalPattern];
379
+ parsedPattern.allBasenames = basenames;
380
+ return parsedPattern;
381
+ }
382
+
383
+ // repetition of common patterns (see above) {**/*.txt,**/*.png}
384
+ function trivia3(pattern: string, options: IGlobOptions): ParsedStringPattern {
385
+ const parsedPatterns = aggregateBasenameMatches(
386
+ pattern
387
+ .slice(1, -1)
388
+ .split(',')
389
+ .map((pattern) => parsePattern(pattern, options))
390
+ .filter((pattern) => pattern !== NULL),
391
+ pattern,
392
+ );
393
+ const n = parsedPatterns.length;
394
+ if (!n) {
395
+ return NULL;
396
+ }
397
+ if (n === 1) {
398
+ return <ParsedStringPattern>parsedPatterns[0];
399
+ }
400
+ const parsedPattern: ParsedStringPattern = function (path: string, basename?: string) {
401
+ for (let i = 0, n = parsedPatterns.length; i < n; i++) {
402
+ if ((<ParsedStringPattern>parsedPatterns[i])(path, basename)) {
403
+ return pattern;
404
+ }
405
+ }
406
+ return null;
407
+ };
408
+ const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
409
+ if (withBasenames) {
410
+ parsedPattern.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
411
+ }
412
+ const allPaths = parsedPatterns.reduce(
413
+ (all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
414
+ <string[]>[],
415
+ );
416
+ if (allPaths.length) {
417
+ parsedPattern.allPaths = allPaths;
418
+ }
419
+ return parsedPattern;
420
+ }
421
+
422
+ // common patterns: **/something/else just need endsWith check, something/else just needs and equals check
423
+ function trivia4and5(path: string, pattern: string, matchPathEnds: boolean): ParsedStringPattern {
424
+ const nativePath = Path.separator !== Path.nativeSeparator ? path.replace(ALL_FORWARD_SLASHES, Path.separator) : path;
425
+ const nativePathEnd = Path.separator + nativePath;
426
+ const parsedPattern: ParsedStringPattern = matchPathEnds
427
+ ? function (path, basename) {
428
+ return typeof path === 'string' && (path === nativePath || path.endsWith(nativePathEnd)) ? pattern : null;
429
+ }
430
+ : function (path, basename) {
431
+ return typeof path === 'string' && path === nativePath ? pattern : null;
432
+ };
433
+ parsedPattern.allPaths = [(matchPathEnds ? '*/' : './') + path];
434
+ return parsedPattern;
435
+ }
436
+
437
+ function toRegExp(pattern: string): ParsedStringPattern {
438
+ try {
439
+ const regExp = new RegExp(`^${parseRegExp(pattern)}$`);
440
+ return function (path: string) {
441
+ regExp.lastIndex = 0; // reset RegExp to its initial state to reuse it!
442
+ return typeof path === 'string' && regExp.test(path) ? pattern : null;
443
+ };
444
+ } catch (error) {
445
+ return NULL;
446
+ }
447
+ }
448
+
449
+ /**
450
+ * Simplified glob matching. Supports a subset of glob patterns:
451
+ * - * matches anything inside a path segment
452
+ * - ? matches 1 character inside a path segment
453
+ * - ** matches anything including an empty path segment
454
+ * - simple brace expansion ({js,ts} => js or ts)
455
+ * - character ranges (using [...])
456
+ */
457
+ export function match(pattern: string | IRelativePattern, path: string): boolean;
458
+ export function match(
459
+ expression: IExpression,
460
+ path: string,
461
+ hasSibling?: (name: string) => boolean,
462
+ ): string; /* the matching pattern */
463
+ export function match(
464
+ arg1: string | IExpression | IRelativePattern,
465
+ path: string,
466
+ hasSibling?: (name: string) => boolean,
467
+ ): boolean | string | null | Promise<string | null> {
468
+ if (!arg1 || typeof path !== 'string') {
469
+ return false;
470
+ }
471
+
472
+ return parseGlob(<IExpression>arg1)(path, undefined, hasSibling);
473
+ }
474
+
475
+ /**
476
+ * Simplified glob matching. Supports a subset of glob patterns:
477
+ * - * matches anything inside a path segment
478
+ * - ? matches 1 character inside a path segment
479
+ * - ** matches anything including an empty path segment
480
+ * - simple brace expansion ({js,ts} => js or ts)
481
+ * - character ranges (using [...])
482
+ */
483
+ export function parseGlob(pattern: string | IRelativePattern, options?: IGlobOptions): ParsedPattern;
484
+ export function parseGlob(expression: IExpression, options?: IGlobOptions): ParsedExpression;
485
+ export function parseGlob(
486
+ arg1: string | IExpression | IRelativePattern,
487
+ options: IGlobOptions = {},
488
+ ): ParsedPattern | ParsedExpression {
489
+ if (!arg1) {
490
+ return FALSE;
491
+ }
492
+
493
+ // Glob with String
494
+ if (typeof arg1 === 'string' || isRelativePattern(arg1)) {
495
+ const parsedPattern = parsePattern(arg1, options);
496
+ if (parsedPattern === NULL) {
497
+ return FALSE;
498
+ }
499
+ const resultPattern: ParsedPattern & { allBasenames?: string[]; allPaths?: string[] } = function (
500
+ path: string,
501
+ basename?: string,
502
+ ) {
503
+ return !!parsedPattern(path, basename);
504
+ };
505
+ if (parsedPattern.allBasenames) {
506
+ resultPattern.allBasenames = parsedPattern.allBasenames;
507
+ }
508
+ if (parsedPattern.allPaths) {
509
+ resultPattern.allPaths = parsedPattern.allPaths;
510
+ }
511
+ return resultPattern;
512
+ }
513
+
514
+ // Glob with Expression
515
+ return parsedExpression(<IExpression>arg1, options);
516
+ }
517
+
518
+ export function hasSiblingPromiseFn(siblingsFn?: () => Promise<string[]>) {
519
+ if (!siblingsFn) {
520
+ return undefined;
521
+ }
522
+
523
+ let siblings: Promise<Record<string, true>>;
524
+ return (name: string) => {
525
+ if (!siblings) {
526
+ siblings = (siblingsFn() || Promise.resolve([])).then((list) => (list ? listToMap(list) : {}));
527
+ }
528
+ return siblings.then((map) => !!map[name]);
529
+ };
530
+ }
531
+
532
+ export function hasSiblingFn(siblingsFn?: () => string[]) {
533
+ if (!siblingsFn) {
534
+ return undefined;
535
+ }
536
+
537
+ let siblings: Record<string, true>;
538
+ return (name: string) => {
539
+ if (!siblings) {
540
+ const list = siblingsFn();
541
+ siblings = list ? listToMap(list) : {};
542
+ }
543
+ return !!siblings[name];
544
+ };
545
+ }
546
+
547
+ function listToMap(list: string[]) {
548
+ const map: Record<string, true> = {};
549
+ for (const key of list) {
550
+ map[key] = true;
551
+ }
552
+ return map;
553
+ }
554
+
555
+ export function isRelativePattern(obj: unknown): obj is IRelativePattern {
556
+ const rp = obj as IRelativePattern;
557
+
558
+ return rp && typeof rp.base === 'string' && typeof rp.pattern === 'string';
559
+ }
560
+
561
+ export function getBasenameTerms(patternOrExpression: ParsedPattern | ParsedExpression): string[] {
562
+ return (<ParsedStringPattern>patternOrExpression).allBasenames || [];
563
+ }
564
+
565
+ export function getPathTerms(patternOrExpression: ParsedPattern | ParsedExpression): string[] {
566
+ return (<ParsedStringPattern>patternOrExpression).allPaths || [];
567
+ }
568
+
569
+ function parsedExpression(expression: IExpression, options: IGlobOptions): ParsedExpression {
570
+ const parsedPatterns = aggregateBasenameMatches(
571
+ Object.getOwnPropertyNames(expression)
572
+ .map((pattern) => parseExpressionPattern(pattern, expression[pattern], options))
573
+ .filter((pattern) => pattern !== NULL),
574
+ );
575
+
576
+ const n = parsedPatterns.length;
577
+ if (!n) {
578
+ return NULL;
579
+ }
580
+
581
+ if (!parsedPatterns.some((parsedPattern) => !!(<ParsedExpressionPattern>parsedPattern).requiresSiblings)) {
582
+ if (n === 1) {
583
+ return <ParsedStringPattern>parsedPatterns[0];
584
+ }
585
+
586
+ const resultExpression: ParsedStringPattern = function (path: string, basename?: string) {
587
+ for (let i = 0, n = parsedPatterns.length; i < n; i++) {
588
+ // Pattern matches path
589
+ const result = (<ParsedStringPattern>parsedPatterns[i])(path, basename);
590
+ if (result) {
591
+ return result;
592
+ }
593
+ }
594
+
595
+ return null;
596
+ };
597
+
598
+ const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
599
+ if (withBasenames) {
600
+ resultExpression.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
601
+ }
602
+
603
+ const allPaths = parsedPatterns.reduce(
604
+ (all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
605
+ <string[]>[],
606
+ );
607
+ if (allPaths.length) {
608
+ resultExpression.allPaths = allPaths;
609
+ }
610
+
611
+ return resultExpression;
612
+ }
613
+
614
+ const resultExpression: ParsedStringPattern = function (
615
+ path: string,
616
+ basename?: string,
617
+ hasSibling?: (name: string) => boolean | Promise<boolean>,
618
+ ) {
619
+ let name: string | undefined;
620
+
621
+ for (let i = 0, n = parsedPatterns.length; i < n; i++) {
622
+ // Pattern matches path
623
+ const parsedPattern = <ParsedExpressionPattern>parsedPatterns[i];
624
+ if (parsedPattern.requiresSiblings && hasSibling) {
625
+ if (!basename) {
626
+ basename = getBaseName(path);
627
+ }
628
+ if (!name) {
629
+ name = basename.substr(0, basename.length - extname(path).length);
630
+ }
631
+ }
632
+ const result = parsedPattern(path, basename, name, hasSibling);
633
+ if (result) {
634
+ return result;
635
+ }
636
+ }
637
+
638
+ return null;
639
+ };
640
+
641
+ const withBasenames = parsedPatterns.find((pattern) => !!(<ParsedStringPattern>pattern).allBasenames);
642
+ if (withBasenames) {
643
+ resultExpression.allBasenames = (<ParsedStringPattern>withBasenames).allBasenames;
644
+ }
645
+
646
+ const allPaths = parsedPatterns.reduce(
647
+ (all, current) => (current.allPaths ? all.concat(current.allPaths) : all),
648
+ <string[]>[],
649
+ );
650
+ if (allPaths.length) {
651
+ resultExpression.allPaths = allPaths;
652
+ }
653
+
654
+ return resultExpression;
655
+ }
656
+
657
+ function parseExpressionPattern(
658
+ pattern: string,
659
+ value: boolean | SiblingClause,
660
+ options: IGlobOptions,
661
+ ): ParsedStringPattern | ParsedExpressionPattern {
662
+ if (value === false) {
663
+ return NULL; // pattern is disabled
664
+ }
665
+
666
+ const parsedPattern = parsePattern(pattern, options);
667
+ if (parsedPattern === NULL) {
668
+ return NULL;
669
+ }
670
+
671
+ // Expression Pattern is <boolean>
672
+ if (typeof value === 'boolean') {
673
+ return parsedPattern;
674
+ }
675
+
676
+ // Expression Pattern is <SiblingClause>
677
+ if (value) {
678
+ const when = (<SiblingClause>value).when;
679
+ if (typeof when === 'string') {
680
+ const result: ParsedExpressionPattern = (
681
+ path: string,
682
+ basename?: string,
683
+ name?: string,
684
+ hasSibling?: (name: string) => boolean | Promise<boolean>,
685
+ ) => {
686
+ if (!hasSibling || !parsedPattern(path, basename)) {
687
+ return null;
688
+ }
689
+
690
+ const clausePattern = when.replace('$(basename)', name!);
691
+ const matched = hasSibling(clausePattern);
692
+ return matched instanceof Promise ? matched.then((m) => (m ? pattern : null)) : matched ? pattern : null;
693
+ };
694
+ result.requiresSiblings = true;
695
+ return result;
696
+ }
697
+ }
698
+
699
+ // Expression is Anything
700
+ return parsedPattern;
701
+ }
702
+
703
+ function aggregateBasenameMatches(
704
+ parsedPatterns: Array<ParsedStringPattern | ParsedExpressionPattern>,
705
+ result?: string,
706
+ ): Array<ParsedStringPattern | ParsedExpressionPattern> {
707
+ const basenamePatterns = parsedPatterns.filter((parsedPattern) => !!(<ParsedStringPattern>parsedPattern).basenames);
708
+ if (basenamePatterns.length < 2) {
709
+ return parsedPatterns;
710
+ }
711
+
712
+ const basenames = basenamePatterns.reduce<string[]>((all, current) => {
713
+ const basenames = (<ParsedStringPattern>current).basenames;
714
+ return basenames ? all.concat(basenames) : all;
715
+ }, <string[]>[]);
716
+ let patterns: string[];
717
+ if (result) {
718
+ patterns = [];
719
+ for (let i = 0, n = basenames.length; i < n; i++) {
720
+ patterns.push(result);
721
+ }
722
+ } else {
723
+ patterns = basenamePatterns.reduce((all, current) => {
724
+ const patterns = (<ParsedStringPattern>current).patterns;
725
+ return patterns ? all.concat(patterns) : all;
726
+ }, <string[]>[]);
727
+ }
728
+ const aggregate: ParsedStringPattern = function (path, basename) {
729
+ if (typeof path !== 'string') {
730
+ return null;
731
+ }
732
+ if (!basename) {
733
+ let i: number;
734
+ for (i = path.length; i > 0; i--) {
735
+ const ch = path.charCodeAt(i - 1);
736
+ if (ch === CharCode.Slash || ch === CharCode.Backslash) {
737
+ break;
738
+ }
739
+ }
740
+ basename = path.substr(i);
741
+ }
742
+ const index = basenames.indexOf(basename);
743
+ return index !== -1 ? patterns[index] : null;
744
+ };
745
+ aggregate.basenames = basenames;
746
+ aggregate.patterns = patterns;
747
+ aggregate.allBasenames = basenames;
748
+
749
+ const aggregatedPatterns = parsedPatterns.filter((parsedPattern) => !(<ParsedStringPattern>parsedPattern).basenames);
750
+ aggregatedPatterns.push(aggregate);
751
+ return aggregatedPatterns;
752
+ }