|
1 | 1 | namespace ts { |
2 | | - // WARNING: The script `configurePrerelease.ts` uses a regexp to parse out these values. |
3 | | - // If changing the text in this section, be sure to test `configurePrerelease` too. |
4 | | - export const versionMajorMinor = "4.8"; |
5 | | - // The following is baselined as a literal template type without intervention |
6 | | - /** The version of the TypeScript compiler release */ |
7 | | - // eslint-disable-next-line @typescript-eslint/no-inferrable-types |
8 | | - export const version: string = `${versionMajorMinor}.0-dev`; |
| 2 | +// WARNING: The script `configurePrerelease.ts` uses a regexp to parse out these values. |
| 3 | +// If changing the text in this section, be sure to test `configurePrerelease` too. |
| 4 | +export const versionMajorMinor = "4.8"; |
| 5 | +// The following is baselined as a literal template type without intervention |
| 6 | +/** The version of the TypeScript compiler release */ |
| 7 | +// eslint-disable-next-line @typescript-eslint/no-inferrable-types |
| 8 | +export const version: string = `${versionMajorMinor}.0-dev`; |
| 9 | + |
| 10 | +/** |
| 11 | + * Type of objects whose values are all of the same type. |
| 12 | + * The `in` and `for-in` operators can *not* be safely used, |
| 13 | + * since `Object.prototype` may be modified by outside code. |
| 14 | + */ |
| 15 | +export interface MapLike<T> { |
| 16 | + [index: string]: T; |
| 17 | +} |
9 | 18 |
|
10 | | - /** |
11 | | - * Type of objects whose values are all of the same type. |
12 | | - * The `in` and `for-in` operators can *not* be safely used, |
13 | | - * since `Object.prototype` may be modified by outside code. |
14 | | - */ |
15 | | - export interface MapLike<T> { |
16 | | - [index: string]: T; |
17 | | - } |
| 19 | +export interface SortedReadonlyArray<T> extends ReadonlyArray<T> { |
| 20 | + " __sortedArrayBrand": any; |
| 21 | +} |
18 | 22 |
|
19 | | - export interface SortedReadonlyArray<T> extends ReadonlyArray<T> { |
20 | | - " __sortedArrayBrand": any; |
21 | | - } |
| 23 | +export interface SortedArray<T> extends Array<T> { |
| 24 | + " __sortedArrayBrand": any; |
| 25 | +} |
22 | 26 |
|
23 | | - export interface SortedArray<T> extends Array<T> { |
24 | | - " __sortedArrayBrand": any; |
25 | | - } |
| 27 | +/** Common read methods for ES6 Map/Set. */ |
| 28 | +export interface ReadonlyCollection<K> { |
| 29 | + readonly size: number; |
| 30 | + has(key: K): boolean; |
| 31 | + keys(): Iterator<K>; |
| 32 | +} |
26 | 33 |
|
27 | | - /** Common read methods for ES6 Map/Set. */ |
28 | | - export interface ReadonlyCollection<K> { |
29 | | - readonly size: number; |
30 | | - has(key: K): boolean; |
31 | | - keys(): Iterator<K>; |
32 | | - } |
| 34 | +/** Common write methods for ES6 Map/Set. */ |
| 35 | +export interface Collection<K> extends ReadonlyCollection<K> { |
| 36 | + delete(key: K): boolean; |
| 37 | + clear(): void; |
| 38 | +} |
33 | 39 |
|
34 | | - /** Common write methods for ES6 Map/Set. */ |
35 | | - export interface Collection<K> extends ReadonlyCollection<K> { |
36 | | - delete(key: K): boolean; |
37 | | - clear(): void; |
38 | | - } |
| 40 | +/** ES6 Map interface, only read methods included. */ |
| 41 | +export interface ReadonlyESMap<K, V> extends ReadonlyCollection<K> { |
| 42 | + get(key: K): V | undefined; |
| 43 | + values(): Iterator<V>; |
| 44 | + entries(): Iterator<[K, V]>; |
| 45 | + forEach(action: (value: V, key: K) => void): void; |
| 46 | +} |
39 | 47 |
|
40 | | - /** ES6 Map interface, only read methods included. */ |
41 | | - export interface ReadonlyESMap<K, V> extends ReadonlyCollection<K> { |
42 | | - get(key: K): V | undefined; |
43 | | - values(): Iterator<V>; |
44 | | - entries(): Iterator<[K, V]>; |
45 | | - forEach(action: (value: V, key: K) => void): void; |
46 | | - } |
| 48 | +/** |
| 49 | + * ES6 Map interface, only read methods included. |
| 50 | + */ |
| 51 | +export interface ReadonlyMap<T> extends ReadonlyESMap<string, T> { |
| 52 | +} |
47 | 53 |
|
48 | | - /** |
49 | | - * ES6 Map interface, only read methods included. |
50 | | - */ |
51 | | - export interface ReadonlyMap<T> extends ReadonlyESMap<string, T> { |
52 | | - } |
| 54 | +/** ES6 Map interface. */ |
| 55 | +export interface ESMap<K, V> extends ReadonlyESMap<K, V>, Collection<K> { |
| 56 | + set(key: K, value: V): this; |
| 57 | +} |
53 | 58 |
|
54 | | - /** ES6 Map interface. */ |
55 | | - export interface ESMap<K, V> extends ReadonlyESMap<K, V>, Collection<K> { |
56 | | - set(key: K, value: V): this; |
57 | | - } |
| 59 | +/** |
| 60 | + * ES6 Map interface. |
| 61 | + */ |
| 62 | +export interface Map<T> extends ESMap<string, T> { |
| 63 | +} |
58 | 64 |
|
59 | | - /** |
60 | | - * ES6 Map interface. |
61 | | - */ |
62 | | - export interface Map<T> extends ESMap<string, T> { |
63 | | - } |
| 65 | +/* @internal */ |
| 66 | +export interface MapConstructor { |
| 67 | + // eslint-disable-next-line @typescript-eslint/prefer-function-type |
| 68 | + new <K, V>(iterable?: readonly (readonly [K, V])[] | ReadonlyESMap<K, V>): ESMap<K, V>; |
| 69 | +} |
64 | 70 |
|
65 | | - /* @internal */ |
66 | | - export interface MapConstructor { |
67 | | - // eslint-disable-next-line @typescript-eslint/prefer-function-type |
68 | | - new <K, V>(iterable?: readonly (readonly [K, V])[] | ReadonlyESMap<K, V>): ESMap<K, V>; |
69 | | - } |
| 71 | +/** ES6 Set interface, only read methods included. */ |
| 72 | +export interface ReadonlySet<T> extends ReadonlyCollection<T> { |
| 73 | + has(value: T): boolean; |
| 74 | + values(): Iterator<T>; |
| 75 | + entries(): Iterator<[T, T]>; |
| 76 | + forEach(action: (value: T, key: T) => void): void; |
| 77 | +} |
70 | 78 |
|
71 | | - /** ES6 Set interface, only read methods included. */ |
72 | | - export interface ReadonlySet<T> extends ReadonlyCollection<T> { |
73 | | - has(value: T): boolean; |
74 | | - values(): Iterator<T>; |
75 | | - entries(): Iterator<[T, T]>; |
76 | | - forEach(action: (value: T, key: T) => void): void; |
77 | | - } |
| 79 | +/** ES6 Set interface. */ |
| 80 | +export interface Set<T> extends ReadonlySet<T>, Collection<T> { |
| 81 | + add(value: T): this; |
| 82 | + delete(value: T): boolean; |
| 83 | +} |
78 | 84 |
|
79 | | - /** ES6 Set interface. */ |
80 | | - export interface Set<T> extends ReadonlySet<T>, Collection<T> { |
81 | | - add(value: T): this; |
82 | | - delete(value: T): boolean; |
83 | | - } |
| 85 | +/* @internal */ |
| 86 | +export interface SetConstructor { |
| 87 | + // eslint-disable-next-line @typescript-eslint/prefer-function-type |
| 88 | + new <T>(iterable?: readonly T[] | ReadonlySet<T>): Set<T>; |
| 89 | +} |
84 | 90 |
|
85 | | - /* @internal */ |
86 | | - export interface SetConstructor { |
87 | | - // eslint-disable-next-line @typescript-eslint/prefer-function-type |
88 | | - new <T>(iterable?: readonly T[] | ReadonlySet<T>): Set<T>; |
89 | | - } |
| 91 | +/** ES6 Iterator type. */ |
| 92 | +export interface Iterator<T> { |
| 93 | + next(): { value: T, done?: false } | { value: void, done: true }; |
| 94 | +} |
90 | 95 |
|
91 | | - /** ES6 Iterator type. */ |
92 | | - export interface Iterator<T> { |
93 | | - next(): { value: T, done?: false } | { value: void, done: true }; |
94 | | - } |
| 96 | +/** Array that is only intended to be pushed to, never read. */ |
| 97 | +export interface Push<T> { |
| 98 | + push(...values: T[]): void; |
| 99 | + /* @internal*/ readonly length: number; |
| 100 | +} |
95 | 101 |
|
96 | | - /** Array that is only intended to be pushed to, never read. */ |
97 | | - export interface Push<T> { |
98 | | - push(...values: T[]): void; |
99 | | - /* @internal*/ readonly length: number; |
100 | | - } |
| 102 | +/* @internal */ |
| 103 | +export type EqualityComparer<T> = (a: T, b: T) => boolean; |
101 | 104 |
|
102 | | - /* @internal */ |
103 | | - export type EqualityComparer<T> = (a: T, b: T) => boolean; |
| 105 | +/* @internal */ |
| 106 | +export type Comparer<T> = (a: T, b: T) => Comparison; |
104 | 107 |
|
105 | | - /* @internal */ |
106 | | - export type Comparer<T> = (a: T, b: T) => Comparison; |
| 108 | +/* @internal */ |
| 109 | +export const enum Comparison { |
| 110 | + LessThan = -1, |
| 111 | + EqualTo = 0, |
| 112 | + GreaterThan = 1 |
| 113 | +} |
107 | 114 |
|
108 | | - /* @internal */ |
109 | | - export const enum Comparison { |
110 | | - LessThan = -1, |
111 | | - EqualTo = 0, |
112 | | - GreaterThan = 1 |
113 | | - } |
| 115 | +/* @internal */ |
| 116 | +namespace NativeCollections { |
| 117 | + declare const self: any; |
114 | 118 |
|
115 | | - /* @internal */ |
116 | | - namespace NativeCollections { |
117 | | - declare const self: any; |
118 | | - |
119 | | - const globals = typeof globalThis !== "undefined" ? globalThis : |
120 | | - typeof global !== "undefined" ? global : |
121 | | - typeof self !== "undefined" ? self : |
122 | | - undefined; |
123 | | - |
124 | | - /** |
125 | | - * Returns the native Map implementation if it is available and compatible (i.e. supports iteration). |
126 | | - */ |
127 | | - export function tryGetNativeMap(): MapConstructor | undefined { |
128 | | - // Internet Explorer's Map doesn't support iteration, so don't use it. |
129 | | - const gMap = globals?.Map; |
130 | | - // eslint-disable-next-line no-in-operator |
131 | | - return typeof gMap !== "undefined" && "entries" in gMap.prototype && new gMap([[0, 0]]).size === 1 ? gMap : undefined; |
132 | | - } |
133 | | - |
134 | | - /** |
135 | | - * Returns the native Set implementation if it is available and compatible (i.e. supports iteration). |
136 | | - */ |
137 | | - export function tryGetNativeSet(): SetConstructor | undefined { |
138 | | - // Internet Explorer's Set doesn't support iteration, so don't use it. |
139 | | - const gSet = globals?.Set; |
140 | | - // eslint-disable-next-line no-in-operator |
141 | | - return typeof gSet !== "undefined" && "entries" in gSet.prototype && new gSet([0]).size === 1 ? gSet : undefined; |
142 | | - } |
| 119 | + const globals = typeof globalThis !== "undefined" ? globalThis : |
| 120 | + typeof global !== "undefined" ? global : |
| 121 | + typeof self !== "undefined" ? self : |
| 122 | + undefined; |
| 123 | + |
| 124 | + /** |
| 125 | + * Returns the native Map implementation if it is available and compatible (i.e. supports iteration). |
| 126 | + */ |
| 127 | + export function tryGetNativeMap(): MapConstructor | undefined { |
| 128 | + // Internet Explorer's Map doesn't support iteration, so don't use it. |
| 129 | + const gMap = globals?.Map; |
| 130 | + // eslint-disable-next-line no-in-operator |
| 131 | + return typeof gMap !== "undefined" && "entries" in gMap.prototype && new gMap([[0, 0]]).size === 1 ? gMap : undefined; |
143 | 132 | } |
144 | 133 |
|
145 | | - /* @internal */ |
146 | | - export const Map = getCollectionImplementation("Map", "tryGetNativeMap", "createMapShim"); |
147 | | - /* @internal */ |
148 | | - export const Set = getCollectionImplementation("Set", "tryGetNativeSet", "createSetShim"); |
149 | | - |
150 | | - /* @internal */ |
151 | | - type GetIteratorCallback = <I extends readonly any[] | ReadonlySet<any> | ReadonlyESMap<any, any> | undefined>(iterable: I) => Iterator< |
152 | | - I extends ReadonlyESMap<infer K, infer V> ? [K, V] : |
153 | | - I extends ReadonlySet<infer T> ? T : |
154 | | - I extends readonly (infer T)[] ? T : |
155 | | - I extends undefined ? undefined : |
156 | | - never>; |
157 | | - |
158 | | - /* @internal */ |
159 | | - function getCollectionImplementation< |
160 | | - K1 extends MatchingKeys<typeof NativeCollections, () => any>, |
161 | | - K2 extends MatchingKeys<typeof ShimCollections, (getIterator?: GetIteratorCallback) => ReturnType<(typeof NativeCollections)[K1]>> |
162 | | - >(name: string, nativeFactory: K1, shimFactory: K2): NonNullable<ReturnType<(typeof NativeCollections)[K1]>> { |
163 | | - // NOTE: ts.ShimCollections will be defined for typescriptServices.js but not for tsc.js, so we must test for it. |
164 | | - const constructor = NativeCollections[nativeFactory]() ?? ShimCollections?.[shimFactory](getIterator); |
165 | | - if (constructor) return constructor as NonNullable<ReturnType<(typeof NativeCollections)[K1]>>; |
166 | | - throw new Error(`TypeScript requires an environment that provides a compatible native ${name} implementation.`); |
| 134 | + /** |
| 135 | + * Returns the native Set implementation if it is available and compatible (i.e. supports iteration). |
| 136 | + */ |
| 137 | + export function tryGetNativeSet(): SetConstructor | undefined { |
| 138 | + // Internet Explorer's Set doesn't support iteration, so don't use it. |
| 139 | + const gSet = globals?.Set; |
| 140 | + // eslint-disable-next-line no-in-operator |
| 141 | + return typeof gSet !== "undefined" && "entries" in gSet.prototype && new gSet([0]).size === 1 ? gSet : undefined; |
167 | 142 | } |
168 | 143 | } |
| 144 | + |
| 145 | +/* @internal */ |
| 146 | +export const Map = getCollectionImplementation("Map", "tryGetNativeMap", "createMapShim"); |
| 147 | +/* @internal */ |
| 148 | +export const Set = getCollectionImplementation("Set", "tryGetNativeSet", "createSetShim"); |
| 149 | + |
| 150 | +/* @internal */ |
| 151 | +type GetIteratorCallback = <I extends readonly any[] | ReadonlySet<any> | ReadonlyESMap<any, any> | undefined>(iterable: I) => Iterator< |
| 152 | + I extends ReadonlyESMap<infer K, infer V> ? [K, V] : |
| 153 | + I extends ReadonlySet<infer T> ? T : |
| 154 | + I extends readonly (infer T)[] ? T : |
| 155 | + I extends undefined ? undefined : |
| 156 | + never>; |
| 157 | + |
| 158 | +/* @internal */ |
| 159 | +function getCollectionImplementation< |
| 160 | + K1 extends MatchingKeys<typeof NativeCollections, () => any>, |
| 161 | + K2 extends MatchingKeys<typeof ShimCollections, (getIterator?: GetIteratorCallback) => ReturnType<(typeof NativeCollections)[K1]>> |
| 162 | +>(name: string, nativeFactory: K1, shimFactory: K2): NonNullable<ReturnType<(typeof NativeCollections)[K1]>> { |
| 163 | + // NOTE: ts.ShimCollections will be defined for typescriptServices.js but not for tsc.js, so we must test for it. |
| 164 | + const constructor = NativeCollections[nativeFactory]() ?? ShimCollections?.[shimFactory](getIterator); |
| 165 | + if (constructor) return constructor as NonNullable<ReturnType<(typeof NativeCollections)[K1]>>; |
| 166 | + throw new Error(`TypeScript requires an environment that provides a compatible native ${name} implementation.`); |
| 167 | +} |
| 168 | +} |
0 commit comments