pi-cursor-sdk 0.1.49 → 0.1.51

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 (278) hide show
  1. package/CHANGELOG.md +36 -1
  2. package/README.md +2 -2
  3. package/docs/cursor-live-smoke-checklist.md +4 -4
  4. package/docs/cursor-model-ux-spec.md +5 -5
  5. package/docs/cursor-native-tool-replay.md +2 -2
  6. package/docs/cursor-native-tool-visual-audit.md +1 -1
  7. package/docs/cursor-testing-lessons.md +1 -1
  8. package/package.json +6 -15
  9. package/src/cursor-fallback-models.generated.ts +536 -302
  10. package/src/cursor-provider-errors.ts +29 -0
  11. package/src/cursor-provider-overflow.ts +96 -0
  12. package/src/cursor-tool-manifest.ts +1 -1
  13. package/src/index.ts +4 -1
  14. package/node_modules/@connectrpc/connect-node/README.md +0 -141
  15. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.d.ts +0 -15
  16. package/node_modules/@connectrpc/connect-node/dist/cjs/compression.js +0 -89
  17. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.d.ts +0 -42
  18. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-node-adapter.js +0 -61
  19. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.d.ts +0 -100
  20. package/node_modules/@connectrpc/connect-node/dist/cjs/connect-transport.js +0 -25
  21. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.d.ts +0 -96
  22. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-transport.js +0 -25
  23. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.d.ts +0 -96
  24. package/node_modules/@connectrpc/connect-node/dist/cjs/grpc-web-transport.js +0 -25
  25. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.d.ts +0 -146
  26. package/node_modules/@connectrpc/connect-node/dist/cjs/http2-session-manager.js +0 -536
  27. package/node_modules/@connectrpc/connect-node/dist/cjs/index.d.ts +0 -15
  28. package/node_modules/@connectrpc/connect-node/dist/cjs/index.js +0 -36
  29. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.d.ts +0 -45
  30. package/node_modules/@connectrpc/connect-node/dist/cjs/node-error.js +0 -154
  31. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.d.ts +0 -1
  32. package/node_modules/@connectrpc/connect-node/dist/cjs/node-headers-polyfill.js +0 -29
  33. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.d.ts +0 -89
  34. package/node_modules/@connectrpc/connect-node/dist/cjs/node-transport-options.js +0 -58
  35. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.d.ts +0 -54
  36. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-client.js +0 -326
  37. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.d.ts +0 -41
  38. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-handler.js +0 -234
  39. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.d.ts +0 -19
  40. package/node_modules/@connectrpc/connect-node/dist/cjs/node-universal-header.js +0 -97
  41. package/node_modules/@connectrpc/connect-node/dist/cjs/package.json +0 -1
  42. package/node_modules/@connectrpc/connect-node/dist/esm/compression.d.ts +0 -15
  43. package/node_modules/@connectrpc/connect-node/dist/esm/compression.js +0 -86
  44. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.d.ts +0 -42
  45. package/node_modules/@connectrpc/connect-node/dist/esm/connect-node-adapter.js +0 -58
  46. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.d.ts +0 -100
  47. package/node_modules/@connectrpc/connect-node/dist/esm/connect-transport.js +0 -22
  48. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.d.ts +0 -96
  49. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-transport.js +0 -22
  50. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.d.ts +0 -96
  51. package/node_modules/@connectrpc/connect-node/dist/esm/grpc-web-transport.js +0 -22
  52. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.d.ts +0 -146
  53. package/node_modules/@connectrpc/connect-node/dist/esm/http2-session-manager.js +0 -532
  54. package/node_modules/@connectrpc/connect-node/dist/esm/index.d.ts +0 -15
  55. package/node_modules/@connectrpc/connect-node/dist/esm/index.js +0 -23
  56. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.d.ts +0 -45
  57. package/node_modules/@connectrpc/connect-node/dist/esm/node-error.js +0 -147
  58. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.d.ts +0 -1
  59. package/node_modules/@connectrpc/connect-node/dist/esm/node-headers-polyfill.js +0 -27
  60. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.d.ts +0 -89
  61. package/node_modules/@connectrpc/connect-node/dist/esm/node-transport-options.js +0 -58
  62. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.d.ts +0 -54
  63. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-client.js +0 -324
  64. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.d.ts +0 -41
  65. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-handler.js +0 -230
  66. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.d.ts +0 -19
  67. package/node_modules/@connectrpc/connect-node/dist/esm/node-universal-header.js +0 -93
  68. package/node_modules/@connectrpc/connect-node/package.json +0 -46
  69. package/node_modules/undici/LICENSE +0 -21
  70. package/node_modules/undici/README.md +0 -741
  71. package/node_modules/undici/docs/docs/api/Agent.md +0 -84
  72. package/node_modules/undici/docs/docs/api/BalancedPool.md +0 -99
  73. package/node_modules/undici/docs/docs/api/CacheStorage.md +0 -30
  74. package/node_modules/undici/docs/docs/api/CacheStore.md +0 -164
  75. package/node_modules/undici/docs/docs/api/Client.md +0 -288
  76. package/node_modules/undici/docs/docs/api/ClientStats.md +0 -27
  77. package/node_modules/undici/docs/docs/api/Connector.md +0 -115
  78. package/node_modules/undici/docs/docs/api/ContentType.md +0 -57
  79. package/node_modules/undici/docs/docs/api/Cookies.md +0 -128
  80. package/node_modules/undici/docs/docs/api/Debug.md +0 -62
  81. package/node_modules/undici/docs/docs/api/DiagnosticsChannel.md +0 -315
  82. package/node_modules/undici/docs/docs/api/Dispatcher.md +0 -1392
  83. package/node_modules/undici/docs/docs/api/EnvHttpProxyAgent.md +0 -159
  84. package/node_modules/undici/docs/docs/api/Errors.md +0 -49
  85. package/node_modules/undici/docs/docs/api/EventSource.md +0 -45
  86. package/node_modules/undici/docs/docs/api/Fetch.md +0 -60
  87. package/node_modules/undici/docs/docs/api/GlobalInstallation.md +0 -139
  88. package/node_modules/undici/docs/docs/api/H2CClient.md +0 -263
  89. package/node_modules/undici/docs/docs/api/MockAgent.md +0 -603
  90. package/node_modules/undici/docs/docs/api/MockCallHistory.md +0 -197
  91. package/node_modules/undici/docs/docs/api/MockCallHistoryLog.md +0 -43
  92. package/node_modules/undici/docs/docs/api/MockClient.md +0 -81
  93. package/node_modules/undici/docs/docs/api/MockErrors.md +0 -12
  94. package/node_modules/undici/docs/docs/api/MockPool.md +0 -555
  95. package/node_modules/undici/docs/docs/api/Pool.md +0 -84
  96. package/node_modules/undici/docs/docs/api/PoolStats.md +0 -35
  97. package/node_modules/undici/docs/docs/api/ProxyAgent.md +0 -229
  98. package/node_modules/undici/docs/docs/api/RedirectHandler.md +0 -93
  99. package/node_modules/undici/docs/docs/api/RetryAgent.md +0 -50
  100. package/node_modules/undici/docs/docs/api/RetryHandler.md +0 -118
  101. package/node_modules/undici/docs/docs/api/RoundRobinPool.md +0 -145
  102. package/node_modules/undici/docs/docs/api/SnapshotAgent.md +0 -616
  103. package/node_modules/undici/docs/docs/api/Socks5ProxyAgent.md +0 -275
  104. package/node_modules/undici/docs/docs/api/Util.md +0 -25
  105. package/node_modules/undici/docs/docs/api/WebSocket.md +0 -141
  106. package/node_modules/undici/docs/docs/api/api-lifecycle.md +0 -91
  107. package/node_modules/undici/docs/docs/best-practices/client-certificate.md +0 -64
  108. package/node_modules/undici/docs/docs/best-practices/crawling.md +0 -58
  109. package/node_modules/undici/docs/docs/best-practices/mocking-request.md +0 -190
  110. package/node_modules/undici/docs/docs/best-practices/proxy.md +0 -127
  111. package/node_modules/undici/docs/docs/best-practices/undici-vs-builtin-fetch.md +0 -224
  112. package/node_modules/undici/docs/docs/best-practices/writing-tests.md +0 -63
  113. package/node_modules/undici/index-fetch.js +0 -65
  114. package/node_modules/undici/index.d.ts +0 -3
  115. package/node_modules/undici/index.js +0 -234
  116. package/node_modules/undici/lib/api/abort-signal.js +0 -59
  117. package/node_modules/undici/lib/api/api-connect.js +0 -110
  118. package/node_modules/undici/lib/api/api-pipeline.js +0 -252
  119. package/node_modules/undici/lib/api/api-request.js +0 -214
  120. package/node_modules/undici/lib/api/api-stream.js +0 -209
  121. package/node_modules/undici/lib/api/api-upgrade.js +0 -111
  122. package/node_modules/undici/lib/api/index.js +0 -7
  123. package/node_modules/undici/lib/api/readable.js +0 -580
  124. package/node_modules/undici/lib/cache/memory-cache-store.js +0 -234
  125. package/node_modules/undici/lib/cache/sqlite-cache-store.js +0 -461
  126. package/node_modules/undici/lib/core/connect.js +0 -153
  127. package/node_modules/undici/lib/core/constants.js +0 -143
  128. package/node_modules/undici/lib/core/diagnostics.js +0 -227
  129. package/node_modules/undici/lib/core/errors.js +0 -477
  130. package/node_modules/undici/lib/core/request.js +0 -453
  131. package/node_modules/undici/lib/core/socks5-client.js +0 -422
  132. package/node_modules/undici/lib/core/socks5-utils.js +0 -212
  133. package/node_modules/undici/lib/core/symbols.js +0 -75
  134. package/node_modules/undici/lib/core/tree.js +0 -160
  135. package/node_modules/undici/lib/core/util.js +0 -992
  136. package/node_modules/undici/lib/dispatcher/agent.js +0 -158
  137. package/node_modules/undici/lib/dispatcher/balanced-pool.js +0 -219
  138. package/node_modules/undici/lib/dispatcher/client-h1.js +0 -1722
  139. package/node_modules/undici/lib/dispatcher/client-h2.js +0 -995
  140. package/node_modules/undici/lib/dispatcher/client.js +0 -664
  141. package/node_modules/undici/lib/dispatcher/dispatcher-base.js +0 -184
  142. package/node_modules/undici/lib/dispatcher/dispatcher.js +0 -48
  143. package/node_modules/undici/lib/dispatcher/env-http-proxy-agent.js +0 -146
  144. package/node_modules/undici/lib/dispatcher/fixed-queue.js +0 -135
  145. package/node_modules/undici/lib/dispatcher/h2c-client.js +0 -51
  146. package/node_modules/undici/lib/dispatcher/pool-base.js +0 -214
  147. package/node_modules/undici/lib/dispatcher/pool.js +0 -118
  148. package/node_modules/undici/lib/dispatcher/proxy-agent.js +0 -319
  149. package/node_modules/undici/lib/dispatcher/retry-agent.js +0 -35
  150. package/node_modules/undici/lib/dispatcher/round-robin-pool.js +0 -137
  151. package/node_modules/undici/lib/dispatcher/socks5-proxy-agent.js +0 -260
  152. package/node_modules/undici/lib/encoding/index.js +0 -33
  153. package/node_modules/undici/lib/global.js +0 -59
  154. package/node_modules/undici/lib/handler/cache-handler.js +0 -578
  155. package/node_modules/undici/lib/handler/cache-revalidation-handler.js +0 -124
  156. package/node_modules/undici/lib/handler/decorator-handler.js +0 -67
  157. package/node_modules/undici/lib/handler/deduplication-handler.js +0 -460
  158. package/node_modules/undici/lib/handler/redirect-handler.js +0 -238
  159. package/node_modules/undici/lib/handler/retry-handler.js +0 -394
  160. package/node_modules/undici/lib/handler/unwrap-handler.js +0 -106
  161. package/node_modules/undici/lib/handler/wrap-handler.js +0 -105
  162. package/node_modules/undici/lib/interceptor/cache.js +0 -495
  163. package/node_modules/undici/lib/interceptor/decompress.js +0 -259
  164. package/node_modules/undici/lib/interceptor/deduplicate.js +0 -117
  165. package/node_modules/undici/lib/interceptor/dns.js +0 -571
  166. package/node_modules/undici/lib/interceptor/dump.js +0 -112
  167. package/node_modules/undici/lib/interceptor/redirect.js +0 -21
  168. package/node_modules/undici/lib/interceptor/response-error.js +0 -95
  169. package/node_modules/undici/lib/interceptor/retry.js +0 -19
  170. package/node_modules/undici/lib/llhttp/.gitkeep +0 -0
  171. package/node_modules/undici/lib/llhttp/constants.d.ts +0 -195
  172. package/node_modules/undici/lib/llhttp/constants.js +0 -531
  173. package/node_modules/undici/lib/llhttp/llhttp-wasm.js +0 -15
  174. package/node_modules/undici/lib/llhttp/llhttp_simd-wasm.js +0 -15
  175. package/node_modules/undici/lib/llhttp/utils.d.ts +0 -2
  176. package/node_modules/undici/lib/llhttp/utils.js +0 -12
  177. package/node_modules/undici/lib/mock/mock-agent.js +0 -232
  178. package/node_modules/undici/lib/mock/mock-call-history.js +0 -248
  179. package/node_modules/undici/lib/mock/mock-client.js +0 -68
  180. package/node_modules/undici/lib/mock/mock-errors.js +0 -29
  181. package/node_modules/undici/lib/mock/mock-interceptor.js +0 -209
  182. package/node_modules/undici/lib/mock/mock-pool.js +0 -68
  183. package/node_modules/undici/lib/mock/mock-symbols.js +0 -32
  184. package/node_modules/undici/lib/mock/mock-utils.js +0 -486
  185. package/node_modules/undici/lib/mock/pending-interceptors-formatter.js +0 -43
  186. package/node_modules/undici/lib/mock/snapshot-agent.js +0 -353
  187. package/node_modules/undici/lib/mock/snapshot-recorder.js +0 -588
  188. package/node_modules/undici/lib/mock/snapshot-utils.js +0 -158
  189. package/node_modules/undici/lib/util/cache.js +0 -414
  190. package/node_modules/undici/lib/util/date.js +0 -653
  191. package/node_modules/undici/lib/util/promise.js +0 -28
  192. package/node_modules/undici/lib/util/runtime-features.js +0 -124
  193. package/node_modules/undici/lib/util/stats.js +0 -32
  194. package/node_modules/undici/lib/util/timers.js +0 -425
  195. package/node_modules/undici/lib/web/cache/cache.js +0 -864
  196. package/node_modules/undici/lib/web/cache/cachestorage.js +0 -152
  197. package/node_modules/undici/lib/web/cache/util.js +0 -45
  198. package/node_modules/undici/lib/web/cookies/constants.js +0 -12
  199. package/node_modules/undici/lib/web/cookies/index.js +0 -199
  200. package/node_modules/undici/lib/web/cookies/parse.js +0 -314
  201. package/node_modules/undici/lib/web/cookies/util.js +0 -282
  202. package/node_modules/undici/lib/web/eventsource/eventsource-stream.js +0 -399
  203. package/node_modules/undici/lib/web/eventsource/eventsource.js +0 -501
  204. package/node_modules/undici/lib/web/eventsource/util.js +0 -29
  205. package/node_modules/undici/lib/web/fetch/LICENSE +0 -21
  206. package/node_modules/undici/lib/web/fetch/body.js +0 -509
  207. package/node_modules/undici/lib/web/fetch/constants.js +0 -131
  208. package/node_modules/undici/lib/web/fetch/data-url.js +0 -596
  209. package/node_modules/undici/lib/web/fetch/formdata-parser.js +0 -586
  210. package/node_modules/undici/lib/web/fetch/formdata.js +0 -259
  211. package/node_modules/undici/lib/web/fetch/global.js +0 -40
  212. package/node_modules/undici/lib/web/fetch/headers.js +0 -719
  213. package/node_modules/undici/lib/web/fetch/index.js +0 -2413
  214. package/node_modules/undici/lib/web/fetch/request.js +0 -1115
  215. package/node_modules/undici/lib/web/fetch/response.js +0 -641
  216. package/node_modules/undici/lib/web/fetch/util.js +0 -1522
  217. package/node_modules/undici/lib/web/infra/index.js +0 -229
  218. package/node_modules/undici/lib/web/subresource-integrity/Readme.md +0 -9
  219. package/node_modules/undici/lib/web/subresource-integrity/subresource-integrity.js +0 -307
  220. package/node_modules/undici/lib/web/webidl/index.js +0 -1006
  221. package/node_modules/undici/lib/web/websocket/connection.js +0 -329
  222. package/node_modules/undici/lib/web/websocket/constants.js +0 -126
  223. package/node_modules/undici/lib/web/websocket/events.js +0 -331
  224. package/node_modules/undici/lib/web/websocket/frame.js +0 -133
  225. package/node_modules/undici/lib/web/websocket/permessage-deflate.js +0 -100
  226. package/node_modules/undici/lib/web/websocket/receiver.js +0 -507
  227. package/node_modules/undici/lib/web/websocket/sender.js +0 -109
  228. package/node_modules/undici/lib/web/websocket/stream/websocketerror.js +0 -104
  229. package/node_modules/undici/lib/web/websocket/stream/websocketstream.js +0 -498
  230. package/node_modules/undici/lib/web/websocket/util.js +0 -347
  231. package/node_modules/undici/lib/web/websocket/websocket.js +0 -758
  232. package/node_modules/undici/package.json +0 -152
  233. package/node_modules/undici/scripts/strip-comments.js +0 -10
  234. package/node_modules/undici/types/README.md +0 -6
  235. package/node_modules/undici/types/agent.d.ts +0 -32
  236. package/node_modules/undici/types/api.d.ts +0 -43
  237. package/node_modules/undici/types/balanced-pool.d.ts +0 -30
  238. package/node_modules/undici/types/cache-interceptor.d.ts +0 -179
  239. package/node_modules/undici/types/cache.d.ts +0 -36
  240. package/node_modules/undici/types/client-stats.d.ts +0 -15
  241. package/node_modules/undici/types/client.d.ts +0 -139
  242. package/node_modules/undici/types/connector.d.ts +0 -36
  243. package/node_modules/undici/types/content-type.d.ts +0 -21
  244. package/node_modules/undici/types/cookies.d.ts +0 -30
  245. package/node_modules/undici/types/diagnostics-channel.d.ts +0 -74
  246. package/node_modules/undici/types/dispatcher.d.ts +0 -275
  247. package/node_modules/undici/types/env-http-proxy-agent.d.ts +0 -22
  248. package/node_modules/undici/types/errors.d.ts +0 -177
  249. package/node_modules/undici/types/eventsource.d.ts +0 -66
  250. package/node_modules/undici/types/fetch.d.ts +0 -231
  251. package/node_modules/undici/types/formdata.d.ts +0 -114
  252. package/node_modules/undici/types/global-dispatcher.d.ts +0 -9
  253. package/node_modules/undici/types/global-origin.d.ts +0 -7
  254. package/node_modules/undici/types/h2c-client.d.ts +0 -73
  255. package/node_modules/undici/types/handlers.d.ts +0 -14
  256. package/node_modules/undici/types/header.d.ts +0 -160
  257. package/node_modules/undici/types/index.d.ts +0 -91
  258. package/node_modules/undici/types/interceptors.d.ts +0 -80
  259. package/node_modules/undici/types/mock-agent.d.ts +0 -68
  260. package/node_modules/undici/types/mock-call-history.d.ts +0 -111
  261. package/node_modules/undici/types/mock-client.d.ts +0 -27
  262. package/node_modules/undici/types/mock-errors.d.ts +0 -12
  263. package/node_modules/undici/types/mock-interceptor.d.ts +0 -94
  264. package/node_modules/undici/types/mock-pool.d.ts +0 -27
  265. package/node_modules/undici/types/patch.d.ts +0 -29
  266. package/node_modules/undici/types/pool-stats.d.ts +0 -19
  267. package/node_modules/undici/types/pool.d.ts +0 -41
  268. package/node_modules/undici/types/proxy-agent.d.ts +0 -29
  269. package/node_modules/undici/types/readable.d.ts +0 -68
  270. package/node_modules/undici/types/retry-agent.d.ts +0 -8
  271. package/node_modules/undici/types/retry-handler.d.ts +0 -125
  272. package/node_modules/undici/types/round-robin-pool.d.ts +0 -41
  273. package/node_modules/undici/types/snapshot-agent.d.ts +0 -109
  274. package/node_modules/undici/types/socks5-proxy-agent.d.ts +0 -25
  275. package/node_modules/undici/types/util.d.ts +0 -18
  276. package/node_modules/undici/types/utility.d.ts +0 -7
  277. package/node_modules/undici/types/webidl.d.ts +0 -347
  278. package/node_modules/undici/types/websocket.d.ts +0 -188
@@ -1,1006 +0,0 @@
1
- 'use strict'
2
-
3
- const assert = require('node:assert')
4
- const { types, inspect } = require('node:util')
5
- const { runtimeFeatures } = require('../../util/runtime-features')
6
-
7
- const UNDEFINED = 1
8
- const BOOLEAN = 2
9
- const STRING = 3
10
- const SYMBOL = 4
11
- const NUMBER = 5
12
- const BIGINT = 6
13
- const NULL = 7
14
- const OBJECT = 8 // function and object
15
-
16
- const FunctionPrototypeSymbolHasInstance = Function.call.bind(Function.prototype[Symbol.hasInstance])
17
-
18
- /** @type {import('../../../types/webidl').Webidl} */
19
- const webidl = {
20
- converters: {},
21
- util: {},
22
- errors: {},
23
- is: {}
24
- }
25
-
26
- /**
27
- * @description Instantiate an error.
28
- *
29
- * @param {Object} opts
30
- * @param {string} opts.header
31
- * @param {string} opts.message
32
- * @returns {TypeError}
33
- */
34
- webidl.errors.exception = function (message) {
35
- return new TypeError(`${message.header}: ${message.message}`)
36
- }
37
-
38
- /**
39
- * @description Instantiate an error when conversion from one type to another has failed.
40
- *
41
- * @param {Object} opts
42
- * @param {string} opts.prefix
43
- * @param {string} opts.argument
44
- * @param {string[]} opts.types
45
- * @returns {TypeError}
46
- */
47
- webidl.errors.conversionFailed = function (opts) {
48
- const plural = opts.types.length === 1 ? '' : ' one of'
49
- const message =
50
- `${opts.argument} could not be converted to` +
51
- `${plural}: ${opts.types.join(', ')}.`
52
-
53
- return webidl.errors.exception({
54
- header: opts.prefix,
55
- message
56
- })
57
- }
58
-
59
- /**
60
- * @description Instantiate an error when an invalid argument is provided
61
- *
62
- * @param {Object} context
63
- * @param {string} context.prefix
64
- * @param {string} context.value
65
- * @param {string} context.type
66
- * @returns {TypeError}
67
- */
68
- webidl.errors.invalidArgument = function (context) {
69
- return webidl.errors.exception({
70
- header: context.prefix,
71
- message: `"${context.value}" is an invalid ${context.type}.`
72
- })
73
- }
74
-
75
- // https://webidl.spec.whatwg.org/#implements
76
- webidl.brandCheck = function (V, I) {
77
- if (!FunctionPrototypeSymbolHasInstance(I, V)) {
78
- const err = new TypeError('Illegal invocation')
79
- err.code = 'ERR_INVALID_THIS' // node compat.
80
- throw err
81
- }
82
- }
83
-
84
- webidl.brandCheckMultiple = function (List) {
85
- const prototypes = List.map((c) => webidl.util.MakeTypeAssertion(c))
86
-
87
- return (V) => {
88
- if (prototypes.every(typeCheck => !typeCheck(V))) {
89
- const err = new TypeError('Illegal invocation')
90
- err.code = 'ERR_INVALID_THIS' // node compat.
91
- throw err
92
- }
93
- }
94
- }
95
-
96
- webidl.argumentLengthCheck = function ({ length }, min, ctx) {
97
- if (length < min) {
98
- throw webidl.errors.exception({
99
- message: `${min} argument${min !== 1 ? 's' : ''} required, ` +
100
- `but${length ? ' only' : ''} ${length} found.`,
101
- header: ctx
102
- })
103
- }
104
- }
105
-
106
- webidl.illegalConstructor = function () {
107
- throw webidl.errors.exception({
108
- header: 'TypeError',
109
- message: 'Illegal constructor'
110
- })
111
- }
112
-
113
- webidl.util.MakeTypeAssertion = function (I) {
114
- return (O) => FunctionPrototypeSymbolHasInstance(I, O)
115
- }
116
-
117
- // https://tc39.es/ecma262/#sec-ecmascript-data-types-and-values
118
- webidl.util.Type = function (V) {
119
- switch (typeof V) {
120
- case 'undefined': return UNDEFINED
121
- case 'boolean': return BOOLEAN
122
- case 'string': return STRING
123
- case 'symbol': return SYMBOL
124
- case 'number': return NUMBER
125
- case 'bigint': return BIGINT
126
- case 'function':
127
- case 'object': {
128
- if (V === null) {
129
- return NULL
130
- }
131
-
132
- return OBJECT
133
- }
134
- }
135
- }
136
-
137
- webidl.util.Types = {
138
- UNDEFINED,
139
- BOOLEAN,
140
- STRING,
141
- SYMBOL,
142
- NUMBER,
143
- BIGINT,
144
- NULL,
145
- OBJECT
146
- }
147
-
148
- webidl.util.TypeValueToString = function (o) {
149
- switch (webidl.util.Type(o)) {
150
- case UNDEFINED: return 'Undefined'
151
- case BOOLEAN: return 'Boolean'
152
- case STRING: return 'String'
153
- case SYMBOL: return 'Symbol'
154
- case NUMBER: return 'Number'
155
- case BIGINT: return 'BigInt'
156
- case NULL: return 'Null'
157
- case OBJECT: return 'Object'
158
- }
159
- }
160
-
161
- webidl.util.markAsUncloneable = runtimeFeatures.has('markAsUncloneable')
162
- ? require('node:worker_threads').markAsUncloneable
163
- : () => {}
164
-
165
- // https://webidl.spec.whatwg.org/#abstract-opdef-converttoint
166
- webidl.util.ConvertToInt = function (V, bitLength, signedness, flags) {
167
- let upperBound
168
- let lowerBound
169
-
170
- // 1. If bitLength is 64, then:
171
- if (bitLength === 64) {
172
- // 1. Let upperBound be 2^53 − 1.
173
- upperBound = Math.pow(2, 53) - 1
174
-
175
- // 2. If signedness is "unsigned", then let lowerBound be 0.
176
- if (signedness === 'unsigned') {
177
- lowerBound = 0
178
- } else {
179
- // 3. Otherwise let lowerBound be −2^53 + 1.
180
- lowerBound = Math.pow(-2, 53) + 1
181
- }
182
- } else if (signedness === 'unsigned') {
183
- // 2. Otherwise, if signedness is "unsigned", then:
184
-
185
- // 1. Let lowerBound be 0.
186
- lowerBound = 0
187
-
188
- // 2. Let upperBound be 2^bitLength − 1.
189
- upperBound = Math.pow(2, bitLength) - 1
190
- } else {
191
- // 3. Otherwise:
192
-
193
- // 1. Let lowerBound be -2^(bitLength − 1).
194
- lowerBound = -Math.pow(2, bitLength - 1)
195
-
196
- // 2. Let upperBound be 2^(bitLength − 1) − 1.
197
- upperBound = Math.pow(2, bitLength - 1) - 1
198
- }
199
-
200
- // 4. Let x be ? ToNumber(V).
201
- let x = Number(V)
202
-
203
- // 5. If x is −0, then set x to +0.
204
- if (x === 0) {
205
- x = 0
206
- }
207
-
208
- // 6. If the conversion is to an IDL type associated
209
- // with the [EnforceRange] extended attribute, then:
210
- if (webidl.util.HasFlag(flags, webidl.attributes.EnforceRange)) {
211
- // 1. If x is NaN, +∞, or −∞, then throw a TypeError.
212
- if (
213
- Number.isNaN(x) ||
214
- x === Number.POSITIVE_INFINITY ||
215
- x === Number.NEGATIVE_INFINITY
216
- ) {
217
- throw webidl.errors.exception({
218
- header: 'Integer conversion',
219
- message: `Could not convert ${webidl.util.Stringify(V)} to an integer.`
220
- })
221
- }
222
-
223
- // 2. Set x to IntegerPart(x).
224
- x = webidl.util.IntegerPart(x)
225
-
226
- // 3. If x < lowerBound or x > upperBound, then
227
- // throw a TypeError.
228
- if (x < lowerBound || x > upperBound) {
229
- throw webidl.errors.exception({
230
- header: 'Integer conversion',
231
- message: `Value must be between ${lowerBound}-${upperBound}, got ${x}.`
232
- })
233
- }
234
-
235
- // 4. Return x.
236
- return x
237
- }
238
-
239
- // 7. If x is not NaN and the conversion is to an IDL
240
- // type associated with the [Clamp] extended
241
- // attribute, then:
242
- if (!Number.isNaN(x) && webidl.util.HasFlag(flags, webidl.attributes.Clamp)) {
243
- // 1. Set x to min(max(x, lowerBound), upperBound).
244
- x = Math.min(Math.max(x, lowerBound), upperBound)
245
-
246
- // 2. Round x to the nearest integer, choosing the
247
- // even integer if it lies halfway between two,
248
- // and choosing +0 rather than −0.
249
- if (Math.floor(x) % 2 === 0) {
250
- x = Math.floor(x)
251
- } else {
252
- x = Math.ceil(x)
253
- }
254
-
255
- // 3. Return x.
256
- return x
257
- }
258
-
259
- // 8. If x is NaN, +0, +∞, or −∞, then return +0.
260
- if (
261
- Number.isNaN(x) ||
262
- (x === 0 && Object.is(0, x)) ||
263
- x === Number.POSITIVE_INFINITY ||
264
- x === Number.NEGATIVE_INFINITY
265
- ) {
266
- return 0
267
- }
268
-
269
- // 9. Set x to IntegerPart(x).
270
- x = webidl.util.IntegerPart(x)
271
-
272
- // 10. Set x to x modulo 2^bitLength.
273
- x = x % Math.pow(2, bitLength)
274
-
275
- // 11. If signedness is "signed" and x ≥ 2^(bitLength − 1),
276
- // then return x − 2^bitLength.
277
- if (signedness === 'signed' && x >= Math.pow(2, bitLength - 1)) {
278
- return x - Math.pow(2, bitLength)
279
- }
280
-
281
- // 12. Otherwise, return x.
282
- return x
283
- }
284
-
285
- // https://webidl.spec.whatwg.org/#abstract-opdef-integerpart
286
- webidl.util.IntegerPart = function (n) {
287
- // 1. Let r be floor(abs(n)).
288
- const r = Math.floor(Math.abs(n))
289
-
290
- // 2. If n < 0, then return -1 × r.
291
- if (n < 0) {
292
- return -1 * r
293
- }
294
-
295
- // 3. Otherwise, return r.
296
- return r
297
- }
298
-
299
- webidl.util.Stringify = function (V) {
300
- const type = webidl.util.Type(V)
301
-
302
- switch (type) {
303
- case SYMBOL:
304
- return `Symbol(${V.description})`
305
- case OBJECT:
306
- return inspect(V)
307
- case STRING:
308
- return `"${V}"`
309
- case BIGINT:
310
- return `${V}n`
311
- default:
312
- return `${V}`
313
- }
314
- }
315
-
316
- webidl.util.IsResizableArrayBuffer = function (V) {
317
- if (types.isArrayBuffer(V)) {
318
- return V.resizable
319
- }
320
-
321
- if (types.isSharedArrayBuffer(V)) {
322
- return V.growable
323
- }
324
-
325
- throw webidl.errors.exception({
326
- header: 'IsResizableArrayBuffer',
327
- message: `"${webidl.util.Stringify(V)}" is not an array buffer.`
328
- })
329
- }
330
-
331
- webidl.util.HasFlag = function (flags, attributes) {
332
- return typeof flags === 'number' && (flags & attributes) === attributes
333
- }
334
-
335
- // https://webidl.spec.whatwg.org/#es-sequence
336
- webidl.sequenceConverter = function (converter) {
337
- return (V, prefix, argument, Iterable) => {
338
- // 1. If Type(V) is not Object, throw a TypeError.
339
- if (webidl.util.Type(V) !== OBJECT) {
340
- throw webidl.errors.exception({
341
- header: prefix,
342
- message: `${argument} (${webidl.util.Stringify(V)}) is not iterable.`
343
- })
344
- }
345
-
346
- // 2. Let method be ? GetMethod(V, @@iterator).
347
- /** @type {Generator} */
348
- const method = typeof Iterable === 'function' ? Iterable() : V?.[Symbol.iterator]?.()
349
- const seq = []
350
- let index = 0
351
-
352
- // 3. If method is undefined, throw a TypeError.
353
- if (
354
- method === undefined ||
355
- typeof method.next !== 'function'
356
- ) {
357
- throw webidl.errors.exception({
358
- header: prefix,
359
- message: `${argument} is not iterable.`
360
- })
361
- }
362
-
363
- // https://webidl.spec.whatwg.org/#create-sequence-from-iterable
364
- while (true) {
365
- const { done, value } = method.next()
366
-
367
- if (done) {
368
- break
369
- }
370
-
371
- seq.push(converter(value, prefix, `${argument}[${index++}]`))
372
- }
373
-
374
- return seq
375
- }
376
- }
377
-
378
- // https://webidl.spec.whatwg.org/#es-to-record
379
- webidl.recordConverter = function (keyConverter, valueConverter) {
380
- return (O, prefix, argument) => {
381
- // 1. If Type(O) is not Object, throw a TypeError.
382
- if (webidl.util.Type(O) !== OBJECT) {
383
- throw webidl.errors.exception({
384
- header: prefix,
385
- message: `${argument} ("${webidl.util.TypeValueToString(O)}") is not an Object.`
386
- })
387
- }
388
-
389
- // 2. Let result be a new empty instance of record<K, V>.
390
- const result = {}
391
-
392
- if (!types.isProxy(O)) {
393
- // 1. Let desc be ? O.[[GetOwnProperty]](key).
394
- const keys = [...Object.getOwnPropertyNames(O), ...Object.getOwnPropertySymbols(O)]
395
-
396
- for (const key of keys) {
397
- const keyName = webidl.util.Stringify(key)
398
-
399
- // 1. Let typedKey be key converted to an IDL value of type K.
400
- const typedKey = keyConverter(key, prefix, `Key ${keyName} in ${argument}`)
401
-
402
- // 2. Let value be ? Get(O, key).
403
- // 3. Let typedValue be value converted to an IDL value of type V.
404
- const typedValue = valueConverter(O[key], prefix, `${argument}[${keyName}]`)
405
-
406
- // 4. Set result[typedKey] to typedValue.
407
- result[typedKey] = typedValue
408
- }
409
-
410
- // 5. Return result.
411
- return result
412
- }
413
-
414
- // 3. Let keys be ? O.[[OwnPropertyKeys]]().
415
- const keys = Reflect.ownKeys(O)
416
-
417
- // 4. For each key of keys.
418
- for (const key of keys) {
419
- // 1. Let desc be ? O.[[GetOwnProperty]](key).
420
- const desc = Reflect.getOwnPropertyDescriptor(O, key)
421
-
422
- // 2. If desc is not undefined and desc.[[Enumerable]] is true:
423
- if (desc?.enumerable) {
424
- // 1. Let typedKey be key converted to an IDL value of type K.
425
- const typedKey = keyConverter(key, prefix, argument)
426
-
427
- // 2. Let value be ? Get(O, key).
428
- // 3. Let typedValue be value converted to an IDL value of type V.
429
- const typedValue = valueConverter(O[key], prefix, argument)
430
-
431
- // 4. Set result[typedKey] to typedValue.
432
- result[typedKey] = typedValue
433
- }
434
- }
435
-
436
- // 5. Return result.
437
- return result
438
- }
439
- }
440
-
441
- webidl.interfaceConverter = function (TypeCheck, name) {
442
- return (V, prefix, argument) => {
443
- if (!TypeCheck(V)) {
444
- throw webidl.errors.exception({
445
- header: prefix,
446
- message: `Expected ${argument} ("${webidl.util.Stringify(V)}") to be an instance of ${name}.`
447
- })
448
- }
449
-
450
- return V
451
- }
452
- }
453
-
454
- webidl.dictionaryConverter = function (converters) {
455
- // "For each dictionary member member declared on dictionary, in lexicographical order:"
456
- converters.sort((a, b) => (a.key > b.key) - (a.key < b.key))
457
-
458
- return (dictionary, prefix, argument) => {
459
- const dict = {}
460
-
461
- if (dictionary != null && webidl.util.Type(dictionary) !== OBJECT) {
462
- throw webidl.errors.exception({
463
- header: prefix,
464
- message: `Expected ${dictionary} to be one of: Null, Undefined, Object.`
465
- })
466
- }
467
-
468
- for (const options of converters) {
469
- const { key, defaultValue, required, converter } = options
470
-
471
- if (required === true) {
472
- if (dictionary == null || !Object.hasOwn(dictionary, key)) {
473
- throw webidl.errors.exception({
474
- header: prefix,
475
- message: `Missing required key "${key}".`
476
- })
477
- }
478
- }
479
-
480
- let value = dictionary?.[key]
481
- const hasDefault = defaultValue !== undefined
482
-
483
- // Only use defaultValue if value is undefined and
484
- // a defaultValue options was provided.
485
- if (hasDefault && value === undefined) {
486
- value = defaultValue()
487
- }
488
-
489
- // A key can be optional and have no default value.
490
- // When this happens, do not perform a conversion,
491
- // and do not assign the key a value.
492
- if (required || hasDefault || value !== undefined) {
493
- value = converter(value, prefix, `${argument}.${key}`)
494
-
495
- if (
496
- options.allowedValues &&
497
- !options.allowedValues.includes(value)
498
- ) {
499
- throw webidl.errors.exception({
500
- header: prefix,
501
- message: `${value} is not an accepted type. Expected one of ${options.allowedValues.join(', ')}.`
502
- })
503
- }
504
-
505
- dict[key] = value
506
- }
507
- }
508
-
509
- return dict
510
- }
511
- }
512
-
513
- webidl.nullableConverter = function (converter) {
514
- return (V, prefix, argument) => {
515
- if (V === null) {
516
- return V
517
- }
518
-
519
- return converter(V, prefix, argument)
520
- }
521
- }
522
-
523
- /**
524
- * @param {*} value
525
- * @returns {boolean}
526
- */
527
- webidl.is.USVString = function (value) {
528
- return (
529
- typeof value === 'string' &&
530
- value.isWellFormed()
531
- )
532
- }
533
-
534
- webidl.is.ReadableStream = webidl.util.MakeTypeAssertion(ReadableStream)
535
- webidl.is.Blob = webidl.util.MakeTypeAssertion(Blob)
536
- webidl.is.URLSearchParams = webidl.util.MakeTypeAssertion(URLSearchParams)
537
- webidl.is.File = webidl.util.MakeTypeAssertion(File)
538
- webidl.is.URL = webidl.util.MakeTypeAssertion(URL)
539
- webidl.is.AbortSignal = webidl.util.MakeTypeAssertion(AbortSignal)
540
- webidl.is.MessagePort = webidl.util.MakeTypeAssertion(MessagePort)
541
-
542
- webidl.is.BufferSource = function (V) {
543
- return types.isArrayBuffer(V) || (
544
- ArrayBuffer.isView(V) &&
545
- types.isArrayBuffer(V.buffer)
546
- )
547
- }
548
-
549
- // https://webidl.spec.whatwg.org/#dfn-get-buffer-source-copy
550
- webidl.util.getCopyOfBytesHeldByBufferSource = function (bufferSource) {
551
- // 1. Let jsBufferSource be the result of converting bufferSource to a JavaScript value.
552
- const jsBufferSource = bufferSource
553
-
554
- // 2. Let jsArrayBuffer be jsBufferSource.
555
- let jsArrayBuffer = jsBufferSource
556
-
557
- // 3. Let offset be 0.
558
- let offset = 0
559
-
560
- // 4. Let length be 0.
561
- let length = 0
562
-
563
- // 5. If jsBufferSource has a [[ViewedArrayBuffer]] internal slot, then:
564
- if (types.isTypedArray(jsBufferSource) || types.isDataView(jsBufferSource)) {
565
- // 5.1. Set jsArrayBuffer to jsBufferSource.[[ViewedArrayBuffer]].
566
- jsArrayBuffer = jsBufferSource.buffer
567
-
568
- // 5.2. Set offset to jsBufferSource.[[ByteOffset]].
569
- offset = jsBufferSource.byteOffset
570
-
571
- // 5.3. Set length to jsBufferSource.[[ByteLength]].
572
- length = jsBufferSource.byteLength
573
- } else {
574
- // 6. Otherwise:
575
-
576
- // 6.1. Assert: jsBufferSource is an ArrayBuffer or SharedArrayBuffer object.
577
- assert(types.isAnyArrayBuffer(jsBufferSource))
578
-
579
- // 6.2. Set length to jsBufferSource.[[ArrayBufferByteLength]].
580
- length = jsBufferSource.byteLength
581
- }
582
-
583
- // 7. If IsDetachedBuffer(jsArrayBuffer) is true, then return the empty byte sequence.
584
- if (jsArrayBuffer.detached) {
585
- return new Uint8Array(0)
586
- }
587
-
588
- // 8. Let bytes be a new byte sequence of length equal to length.
589
- const bytes = new Uint8Array(length)
590
-
591
- // 9. For i in the range offset to offset + length − 1, inclusive,
592
- // set bytes[i − offset] to GetValueFromBuffer(jsArrayBuffer, i, Uint8, true, Unordered).
593
- const view = new Uint8Array(jsArrayBuffer, offset, length)
594
- bytes.set(view)
595
-
596
- // 10. Return bytes.
597
- return bytes
598
- }
599
-
600
- // https://webidl.spec.whatwg.org/#es-DOMString
601
- webidl.converters.DOMString = function (V, prefix, argument, flags) {
602
- // 1. If V is null and the conversion is to an IDL type
603
- // associated with the [LegacyNullToEmptyString]
604
- // extended attribute, then return the DOMString value
605
- // that represents the empty string.
606
- if (V === null && webidl.util.HasFlag(flags, webidl.attributes.LegacyNullToEmptyString)) {
607
- return ''
608
- }
609
-
610
- // 2. Let x be ? ToString(V).
611
- if (typeof V === 'symbol') {
612
- throw webidl.errors.exception({
613
- header: prefix,
614
- message: `${argument} is a symbol, which cannot be converted to a DOMString.`
615
- })
616
- }
617
-
618
- // 3. Return the IDL DOMString value that represents the
619
- // same sequence of code units as the one the
620
- // ECMAScript String value x represents.
621
- return String(V)
622
- }
623
-
624
- // https://webidl.spec.whatwg.org/#es-ByteString
625
- webidl.converters.ByteString = function (V, prefix, argument) {
626
- // 1. Let x be ? ToString(V).
627
- if (typeof V === 'symbol') {
628
- throw webidl.errors.exception({
629
- header: prefix,
630
- message: `${argument} is a symbol, which cannot be converted to a ByteString.`
631
- })
632
- }
633
-
634
- const x = String(V)
635
-
636
- // 2. If the value of any element of x is greater than
637
- // 255, then throw a TypeError.
638
- for (let index = 0; index < x.length; index++) {
639
- if (x.charCodeAt(index) > 255) {
640
- throw new TypeError(
641
- 'Cannot convert argument to a ByteString because the character at ' +
642
- `index ${index} has a value of ${x.charCodeAt(index)} which is greater than 255.`
643
- )
644
- }
645
- }
646
-
647
- // 3. Return an IDL ByteString value whose length is the
648
- // length of x, and where the value of each element is
649
- // the value of the corresponding element of x.
650
- return x
651
- }
652
-
653
- /**
654
- * @param {unknown} value
655
- * @returns {string}
656
- * @see https://webidl.spec.whatwg.org/#es-USVString
657
- */
658
- webidl.converters.USVString = function (value) {
659
- // TODO: rewrite this so we can control the errors thrown
660
- if (typeof value === 'string') {
661
- return value.toWellFormed()
662
- }
663
- return `${value}`.toWellFormed()
664
- }
665
-
666
- // https://webidl.spec.whatwg.org/#es-boolean
667
- webidl.converters.boolean = function (V) {
668
- // 1. Let x be the result of computing ToBoolean(V).
669
- // https://262.ecma-international.org/10.0/index.html#table-10
670
- const x = Boolean(V)
671
-
672
- // 2. Return the IDL boolean value that is the one that represents
673
- // the same truth value as the ECMAScript Boolean value x.
674
- return x
675
- }
676
-
677
- // https://webidl.spec.whatwg.org/#es-any
678
- webidl.converters.any = function (V) {
679
- return V
680
- }
681
-
682
- // https://webidl.spec.whatwg.org/#es-long-long
683
- webidl.converters['long long'] = function (V, prefix, argument) {
684
- // 1. Let x be ? ConvertToInt(V, 64, "signed").
685
- const x = webidl.util.ConvertToInt(V, 64, 'signed', 0, prefix, argument)
686
-
687
- // 2. Return the IDL long long value that represents
688
- // the same numeric value as x.
689
- return x
690
- }
691
-
692
- // https://webidl.spec.whatwg.org/#es-unsigned-long-long
693
- webidl.converters['unsigned long long'] = function (V, prefix, argument) {
694
- // 1. Let x be ? ConvertToInt(V, 64, "unsigned").
695
- const x = webidl.util.ConvertToInt(V, 64, 'unsigned', 0, prefix, argument)
696
-
697
- // 2. Return the IDL unsigned long long value that
698
- // represents the same numeric value as x.
699
- return x
700
- }
701
-
702
- // https://webidl.spec.whatwg.org/#es-unsigned-long
703
- webidl.converters['unsigned long'] = function (V, prefix, argument) {
704
- // 1. Let x be ? ConvertToInt(V, 32, "unsigned").
705
- const x = webidl.util.ConvertToInt(V, 32, 'unsigned', 0, prefix, argument)
706
-
707
- // 2. Return the IDL unsigned long value that
708
- // represents the same numeric value as x.
709
- return x
710
- }
711
-
712
- // https://webidl.spec.whatwg.org/#es-unsigned-short
713
- webidl.converters['unsigned short'] = function (V, prefix, argument, flags) {
714
- // 1. Let x be ? ConvertToInt(V, 16, "unsigned").
715
- const x = webidl.util.ConvertToInt(V, 16, 'unsigned', flags, prefix, argument)
716
-
717
- // 2. Return the IDL unsigned short value that represents
718
- // the same numeric value as x.
719
- return x
720
- }
721
-
722
- // https://webidl.spec.whatwg.org/#idl-ArrayBuffer
723
- webidl.converters.ArrayBuffer = function (V, prefix, argument, flags) {
724
- // 1. If V is not an Object, or V does not have an
725
- // [[ArrayBufferData]] internal slot, then throw a
726
- // TypeError.
727
- // 2. If IsSharedArrayBuffer(V) is true, then throw a
728
- // TypeError.
729
- // see: https://tc39.es/ecma262/#sec-properties-of-the-arraybuffer-instances
730
- if (
731
- webidl.util.Type(V) !== OBJECT ||
732
- !types.isArrayBuffer(V)
733
- ) {
734
- throw webidl.errors.conversionFailed({
735
- prefix,
736
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
737
- types: ['ArrayBuffer']
738
- })
739
- }
740
-
741
- // 3. If the conversion is not to an IDL type associated
742
- // with the [AllowResizable] extended attribute, and
743
- // IsResizableArrayBuffer(V) is true, then throw a
744
- // TypeError.
745
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V)) {
746
- throw webidl.errors.exception({
747
- header: prefix,
748
- message: `${argument} cannot be a resizable ArrayBuffer.`
749
- })
750
- }
751
-
752
- // 4. Return the IDL ArrayBuffer value that is a
753
- // reference to the same object as V.
754
- return V
755
- }
756
-
757
- // https://webidl.spec.whatwg.org/#idl-SharedArrayBuffer
758
- webidl.converters.SharedArrayBuffer = function (V, prefix, argument, flags) {
759
- // 1. If V is not an Object, or V does not have an
760
- // [[ArrayBufferData]] internal slot, then throw a
761
- // TypeError.
762
- // 2. If IsSharedArrayBuffer(V) is false, then throw a
763
- // TypeError.
764
- // see: https://tc39.es/ecma262/#sec-properties-of-the-sharedarraybuffer-instances
765
- if (
766
- webidl.util.Type(V) !== OBJECT ||
767
- !types.isSharedArrayBuffer(V)
768
- ) {
769
- throw webidl.errors.conversionFailed({
770
- prefix,
771
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
772
- types: ['SharedArrayBuffer']
773
- })
774
- }
775
-
776
- // 3. If the conversion is not to an IDL type associated
777
- // with the [AllowResizable] extended attribute, and
778
- // IsResizableArrayBuffer(V) is true, then throw a
779
- // TypeError.
780
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V)) {
781
- throw webidl.errors.exception({
782
- header: prefix,
783
- message: `${argument} cannot be a resizable SharedArrayBuffer.`
784
- })
785
- }
786
-
787
- // 4. Return the IDL SharedArrayBuffer value that is a
788
- // reference to the same object as V.
789
- return V
790
- }
791
-
792
- // https://webidl.spec.whatwg.org/#dfn-typed-array-type
793
- webidl.converters.TypedArray = function (V, T, prefix, argument, flags) {
794
- // 1. Let T be the IDL type V is being converted to.
795
-
796
- // 2. If Type(V) is not Object, or V does not have a
797
- // [[TypedArrayName]] internal slot with a value
798
- // equal to T’s name, then throw a TypeError.
799
- if (
800
- webidl.util.Type(V) !== OBJECT ||
801
- !types.isTypedArray(V) ||
802
- V.constructor.name !== T.name
803
- ) {
804
- throw webidl.errors.conversionFailed({
805
- prefix,
806
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
807
- types: [T.name]
808
- })
809
- }
810
-
811
- // 3. If the conversion is not to an IDL type associated
812
- // with the [AllowShared] extended attribute, and
813
- // IsSharedArrayBuffer(V.[[ViewedArrayBuffer]]) is
814
- // true, then throw a TypeError.
815
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
816
- throw webidl.errors.exception({
817
- header: prefix,
818
- message: `${argument} cannot be a view on a shared array buffer.`
819
- })
820
- }
821
-
822
- // 4. If the conversion is not to an IDL type associated
823
- // with the [AllowResizable] extended attribute, and
824
- // IsResizableArrayBuffer(V.[[ViewedArrayBuffer]]) is
825
- // true, then throw a TypeError.
826
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
827
- throw webidl.errors.exception({
828
- header: prefix,
829
- message: `${argument} cannot be a view on a resizable array buffer.`
830
- })
831
- }
832
-
833
- // 5. Return the IDL value of type T that is a reference
834
- // to the same object as V.
835
- return V
836
- }
837
-
838
- // https://webidl.spec.whatwg.org/#idl-DataView
839
- webidl.converters.DataView = function (V, prefix, argument, flags) {
840
- // 1. If Type(V) is not Object, or V does not have a
841
- // [[DataView]] internal slot, then throw a TypeError.
842
- if (webidl.util.Type(V) !== OBJECT || !types.isDataView(V)) {
843
- throw webidl.errors.conversionFailed({
844
- prefix,
845
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
846
- types: ['DataView']
847
- })
848
- }
849
-
850
- // 2. If the conversion is not to an IDL type associated
851
- // with the [AllowShared] extended attribute, and
852
- // IsSharedArrayBuffer(V.[[ViewedArrayBuffer]]) is true,
853
- // then throw a TypeError.
854
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
855
- throw webidl.errors.exception({
856
- header: prefix,
857
- message: `${argument} cannot be a view on a shared array buffer.`
858
- })
859
- }
860
-
861
- // 3. If the conversion is not to an IDL type associated
862
- // with the [AllowResizable] extended attribute, and
863
- // IsResizableArrayBuffer(V.[[ViewedArrayBuffer]]) is
864
- // true, then throw a TypeError.
865
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
866
- throw webidl.errors.exception({
867
- header: prefix,
868
- message: `${argument} cannot be a view on a resizable array buffer.`
869
- })
870
- }
871
-
872
- // 4. Return the IDL DataView value that is a reference
873
- // to the same object as V.
874
- return V
875
- }
876
-
877
- // https://webidl.spec.whatwg.org/#ArrayBufferView
878
- webidl.converters.ArrayBufferView = function (V, prefix, argument, flags) {
879
- if (
880
- webidl.util.Type(V) !== OBJECT ||
881
- !types.isArrayBufferView(V)
882
- ) {
883
- throw webidl.errors.conversionFailed({
884
- prefix,
885
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
886
- types: ['ArrayBufferView']
887
- })
888
- }
889
-
890
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowShared) && types.isSharedArrayBuffer(V.buffer)) {
891
- throw webidl.errors.exception({
892
- header: prefix,
893
- message: `${argument} cannot be a view on a shared array buffer.`
894
- })
895
- }
896
-
897
- if (!webidl.util.HasFlag(flags, webidl.attributes.AllowResizable) && webidl.util.IsResizableArrayBuffer(V.buffer)) {
898
- throw webidl.errors.exception({
899
- header: prefix,
900
- message: `${argument} cannot be a view on a resizable array buffer.`
901
- })
902
- }
903
-
904
- return V
905
- }
906
-
907
- // https://webidl.spec.whatwg.org/#BufferSource
908
- webidl.converters.BufferSource = function (V, prefix, argument, flags) {
909
- if (types.isArrayBuffer(V)) {
910
- return webidl.converters.ArrayBuffer(V, prefix, argument, flags)
911
- }
912
-
913
- if (types.isArrayBufferView(V)) {
914
- flags &= ~webidl.attributes.AllowShared
915
-
916
- return webidl.converters.ArrayBufferView(V, prefix, argument, flags)
917
- }
918
-
919
- // Make this explicit for easier debugging
920
- if (types.isSharedArrayBuffer(V)) {
921
- throw webidl.errors.exception({
922
- header: prefix,
923
- message: `${argument} cannot be a SharedArrayBuffer.`
924
- })
925
- }
926
-
927
- throw webidl.errors.conversionFailed({
928
- prefix,
929
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
930
- types: ['ArrayBuffer', 'ArrayBufferView']
931
- })
932
- }
933
-
934
- // https://webidl.spec.whatwg.org/#AllowSharedBufferSource
935
- webidl.converters.AllowSharedBufferSource = function (V, prefix, argument, flags) {
936
- if (types.isArrayBuffer(V)) {
937
- return webidl.converters.ArrayBuffer(V, prefix, argument, flags)
938
- }
939
-
940
- if (types.isSharedArrayBuffer(V)) {
941
- return webidl.converters.SharedArrayBuffer(V, prefix, argument, flags)
942
- }
943
-
944
- if (types.isArrayBufferView(V)) {
945
- flags |= webidl.attributes.AllowShared
946
- return webidl.converters.ArrayBufferView(V, prefix, argument, flags)
947
- }
948
-
949
- throw webidl.errors.conversionFailed({
950
- prefix,
951
- argument: `${argument} ("${webidl.util.Stringify(V)}")`,
952
- types: ['ArrayBuffer', 'SharedArrayBuffer', 'ArrayBufferView']
953
- })
954
- }
955
-
956
- webidl.converters['sequence<ByteString>'] = webidl.sequenceConverter(
957
- webidl.converters.ByteString
958
- )
959
-
960
- webidl.converters['sequence<sequence<ByteString>>'] = webidl.sequenceConverter(
961
- webidl.converters['sequence<ByteString>']
962
- )
963
-
964
- webidl.converters['record<ByteString, ByteString>'] = webidl.recordConverter(
965
- webidl.converters.ByteString,
966
- webidl.converters.ByteString
967
- )
968
-
969
- webidl.converters.Blob = webidl.interfaceConverter(webidl.is.Blob, 'Blob')
970
-
971
- webidl.converters.AbortSignal = webidl.interfaceConverter(
972
- webidl.is.AbortSignal,
973
- 'AbortSignal'
974
- )
975
-
976
- /**
977
- * [LegacyTreatNonObjectAsNull]
978
- * callback EventHandlerNonNull = any (Event event);
979
- * typedef EventHandlerNonNull? EventHandler;
980
- * @param {*} V
981
- */
982
- webidl.converters.EventHandlerNonNull = function (V) {
983
- if (webidl.util.Type(V) !== OBJECT) {
984
- return null
985
- }
986
-
987
- // [I]f the value is not an object, it will be converted to null, and if the value is not callable,
988
- // it will be converted to a callback function value that does nothing when called.
989
- if (typeof V === 'function') {
990
- return V
991
- }
992
-
993
- return () => {}
994
- }
995
-
996
- webidl.attributes = {
997
- Clamp: 1 << 0,
998
- EnforceRange: 1 << 1,
999
- AllowShared: 1 << 2,
1000
- AllowResizable: 1 << 3,
1001
- LegacyNullToEmptyString: 1 << 4
1002
- }
1003
-
1004
- module.exports = {
1005
- webidl
1006
- }