bupkis 0.18.3 → 1.0.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 (388) hide show
  1. package/CHANGELOG.md +21 -0
  2. package/README.md +1 -1
  3. package/dist/assertion/assertion-async.cjs +268 -0
  4. package/dist/assertion/assertion-async.cjs.map +1 -0
  5. package/dist/assertion/assertion-async.d.cts +40 -0
  6. package/dist/assertion/assertion-async.d.cts.map +1 -0
  7. package/dist/assertion/assertion-async.d.ts +40 -0
  8. package/dist/assertion/assertion-async.d.ts.map +1 -0
  9. package/dist/assertion/assertion-async.js +259 -0
  10. package/dist/assertion/assertion-async.js.map +1 -0
  11. package/dist/assertion/assertion-standard-schema-async.cjs +132 -0
  12. package/dist/assertion/assertion-standard-schema-async.cjs.map +1 -0
  13. package/dist/assertion/assertion-standard-schema-async.d.cts +52 -0
  14. package/dist/assertion/assertion-standard-schema-async.d.cts.map +1 -0
  15. package/dist/assertion/assertion-standard-schema-async.d.ts +52 -0
  16. package/dist/assertion/assertion-standard-schema-async.d.ts.map +1 -0
  17. package/dist/assertion/assertion-standard-schema-async.js +128 -0
  18. package/dist/assertion/assertion-standard-schema-async.js.map +1 -0
  19. package/dist/assertion/assertion-standard-schema-sync.cjs +141 -0
  20. package/dist/assertion/assertion-standard-schema-sync.cjs.map +1 -0
  21. package/dist/assertion/assertion-standard-schema-sync.d.cts +52 -0
  22. package/dist/assertion/assertion-standard-schema-sync.d.cts.map +1 -0
  23. package/dist/assertion/assertion-standard-schema-sync.d.ts +52 -0
  24. package/dist/assertion/assertion-standard-schema-sync.d.ts.map +1 -0
  25. package/dist/assertion/assertion-standard-schema-sync.js +137 -0
  26. package/dist/assertion/assertion-standard-schema-sync.js.map +1 -0
  27. package/dist/assertion/assertion-sync.cjs +281 -0
  28. package/dist/assertion/assertion-sync.cjs.map +1 -0
  29. package/dist/assertion/assertion-sync.d.cts +60 -0
  30. package/dist/assertion/assertion-sync.d.cts.map +1 -0
  31. package/dist/assertion/assertion-sync.d.ts +60 -0
  32. package/dist/assertion/assertion-sync.d.ts.map +1 -0
  33. package/dist/assertion/assertion-sync.js +275 -0
  34. package/dist/assertion/assertion-sync.js.map +1 -0
  35. package/dist/assertion/assertion-types.cjs +20 -0
  36. package/dist/assertion/assertion-types.cjs.map +1 -0
  37. package/dist/assertion/assertion-types.d.cts +1086 -0
  38. package/dist/assertion/assertion-types.d.cts.map +1 -0
  39. package/dist/assertion/assertion-types.d.ts +1086 -0
  40. package/dist/assertion/assertion-types.d.ts.map +1 -0
  41. package/dist/assertion/assertion-types.js +19 -0
  42. package/dist/assertion/assertion-types.js.map +1 -0
  43. package/dist/assertion/assertion.cjs +382 -0
  44. package/dist/assertion/assertion.cjs.map +1 -0
  45. package/dist/assertion/assertion.d.cts +109 -0
  46. package/dist/assertion/assertion.d.cts.map +1 -0
  47. package/dist/assertion/assertion.d.ts +109 -0
  48. package/dist/assertion/assertion.d.ts.map +1 -0
  49. package/dist/assertion/assertion.js +375 -0
  50. package/dist/assertion/assertion.js.map +1 -0
  51. package/dist/assertion/create.cjs +148 -0
  52. package/dist/assertion/create.cjs.map +1 -0
  53. package/dist/assertion/create.d.cts +85 -0
  54. package/dist/assertion/create.d.cts.map +1 -0
  55. package/dist/assertion/create.d.ts +85 -0
  56. package/dist/assertion/create.d.ts.map +1 -0
  57. package/dist/assertion/create.js +143 -0
  58. package/dist/assertion/create.js.map +1 -0
  59. package/dist/assertion/format-assertion-failure.cjs +63 -0
  60. package/dist/assertion/format-assertion-failure.cjs.map +1 -0
  61. package/dist/assertion/format-assertion-failure.d.cts +21 -0
  62. package/dist/assertion/format-assertion-failure.d.cts.map +1 -0
  63. package/dist/assertion/format-assertion-failure.d.ts +21 -0
  64. package/dist/assertion/format-assertion-failure.d.ts.map +1 -0
  65. package/dist/assertion/format-assertion-failure.js +59 -0
  66. package/dist/assertion/format-assertion-failure.js.map +1 -0
  67. package/dist/assertion/impl/assertion-util.cjs +68 -0
  68. package/dist/assertion/impl/assertion-util.cjs.map +1 -0
  69. package/dist/assertion/impl/assertion-util.d.cts +36 -0
  70. package/dist/assertion/impl/assertion-util.d.cts.map +1 -0
  71. package/dist/assertion/impl/assertion-util.d.ts +36 -0
  72. package/dist/assertion/impl/assertion-util.d.ts.map +1 -0
  73. package/dist/assertion/impl/assertion-util.js +62 -0
  74. package/dist/assertion/impl/assertion-util.js.map +1 -0
  75. package/dist/assertion/impl/async-iterable.cjs +627 -0
  76. package/dist/assertion/impl/async-iterable.cjs.map +1 -0
  77. package/dist/assertion/impl/async-iterable.d.cts +406 -0
  78. package/dist/assertion/impl/async-iterable.d.cts.map +1 -0
  79. package/dist/assertion/impl/async-iterable.d.ts +406 -0
  80. package/dist/assertion/impl/async-iterable.d.ts.map +1 -0
  81. package/dist/assertion/impl/async-iterable.js +624 -0
  82. package/dist/assertion/impl/async-iterable.js.map +1 -0
  83. package/dist/assertion/impl/async-parametric.cjs +412 -0
  84. package/dist/assertion/impl/async-parametric.cjs.map +1 -0
  85. package/dist/assertion/impl/async-parametric.d.cts +278 -0
  86. package/dist/assertion/impl/async-parametric.d.cts.map +1 -0
  87. package/dist/assertion/impl/async-parametric.d.ts +278 -0
  88. package/dist/assertion/impl/async-parametric.d.ts.map +1 -0
  89. package/dist/assertion/impl/async-parametric.js +409 -0
  90. package/dist/assertion/impl/async-parametric.js.map +1 -0
  91. package/dist/assertion/impl/async.cjs +56 -0
  92. package/dist/assertion/impl/async.cjs.map +1 -0
  93. package/dist/assertion/impl/async.d.cts +179 -0
  94. package/dist/assertion/impl/async.d.cts.map +1 -0
  95. package/dist/assertion/impl/async.d.ts +179 -0
  96. package/dist/assertion/impl/async.d.ts.map +1 -0
  97. package/dist/assertion/impl/async.js +39 -0
  98. package/dist/assertion/impl/async.js.map +1 -0
  99. package/dist/assertion/impl/index.cjs +37 -0
  100. package/dist/assertion/impl/index.cjs.map +1 -0
  101. package/dist/assertion/impl/index.d.cts +21 -0
  102. package/dist/assertion/impl/index.d.cts.map +1 -0
  103. package/dist/assertion/impl/index.d.ts +21 -0
  104. package/dist/assertion/impl/index.d.ts.map +1 -0
  105. package/dist/assertion/impl/index.js +21 -0
  106. package/dist/assertion/impl/index.js.map +1 -0
  107. package/dist/assertion/impl/iteration-util.cjs +297 -0
  108. package/dist/assertion/impl/iteration-util.cjs.map +1 -0
  109. package/dist/assertion/impl/iteration-util.d.cts +12 -0
  110. package/dist/assertion/impl/iteration-util.d.cts.map +1 -0
  111. package/dist/assertion/impl/iteration-util.d.ts +12 -0
  112. package/dist/assertion/impl/iteration-util.d.ts.map +1 -0
  113. package/dist/assertion/impl/iteration-util.js +282 -0
  114. package/dist/assertion/impl/iteration-util.js.map +1 -0
  115. package/dist/assertion/impl/snapshot.cjs +276 -0
  116. package/dist/assertion/impl/snapshot.cjs.map +1 -0
  117. package/dist/assertion/impl/snapshot.d.cts +278 -0
  118. package/dist/assertion/impl/snapshot.d.cts.map +1 -0
  119. package/dist/assertion/impl/snapshot.d.ts +278 -0
  120. package/dist/assertion/impl/snapshot.d.ts.map +1 -0
  121. package/dist/assertion/impl/snapshot.js +273 -0
  122. package/dist/assertion/impl/snapshot.js.map +1 -0
  123. package/dist/assertion/impl/sync-basic.cjs +553 -0
  124. package/dist/assertion/impl/sync-basic.cjs.map +1 -0
  125. package/dist/assertion/impl/sync-basic.d.cts +528 -0
  126. package/dist/assertion/impl/sync-basic.d.cts.map +1 -0
  127. package/dist/assertion/impl/sync-basic.d.ts +528 -0
  128. package/dist/assertion/impl/sync-basic.d.ts.map +1 -0
  129. package/dist/assertion/impl/sync-basic.js +550 -0
  130. package/dist/assertion/impl/sync-basic.js.map +1 -0
  131. package/dist/assertion/impl/sync-collection.cjs +1424 -0
  132. package/dist/assertion/impl/sync-collection.cjs.map +1 -0
  133. package/dist/assertion/impl/sync-collection.d.cts +922 -0
  134. package/dist/assertion/impl/sync-collection.d.cts.map +1 -0
  135. package/dist/assertion/impl/sync-collection.d.ts +922 -0
  136. package/dist/assertion/impl/sync-collection.d.ts.map +1 -0
  137. package/dist/assertion/impl/sync-collection.js +1418 -0
  138. package/dist/assertion/impl/sync-collection.js.map +1 -0
  139. package/dist/assertion/impl/sync-date.cjs +341 -0
  140. package/dist/assertion/impl/sync-date.cjs.map +1 -0
  141. package/dist/assertion/impl/sync-date.d.cts +209 -0
  142. package/dist/assertion/impl/sync-date.d.cts.map +1 -0
  143. package/dist/assertion/impl/sync-date.d.ts +209 -0
  144. package/dist/assertion/impl/sync-date.d.ts.map +1 -0
  145. package/dist/assertion/impl/sync-date.js +338 -0
  146. package/dist/assertion/impl/sync-date.js.map +1 -0
  147. package/dist/assertion/impl/sync-esoteric.cjs +214 -0
  148. package/dist/assertion/impl/sync-esoteric.cjs.map +1 -0
  149. package/dist/assertion/impl/sync-esoteric.d.cts +191 -0
  150. package/dist/assertion/impl/sync-esoteric.d.cts.map +1 -0
  151. package/dist/assertion/impl/sync-esoteric.d.ts +191 -0
  152. package/dist/assertion/impl/sync-esoteric.d.ts.map +1 -0
  153. package/dist/assertion/impl/sync-esoteric.js +211 -0
  154. package/dist/assertion/impl/sync-esoteric.js.map +1 -0
  155. package/dist/assertion/impl/sync-iterable.cjs +512 -0
  156. package/dist/assertion/impl/sync-iterable.cjs.map +1 -0
  157. package/dist/assertion/impl/sync-iterable.d.cts +334 -0
  158. package/dist/assertion/impl/sync-iterable.d.cts.map +1 -0
  159. package/dist/assertion/impl/sync-iterable.d.ts +334 -0
  160. package/dist/assertion/impl/sync-iterable.d.ts.map +1 -0
  161. package/dist/assertion/impl/sync-iterable.js +509 -0
  162. package/dist/assertion/impl/sync-iterable.js.map +1 -0
  163. package/dist/assertion/impl/sync-parametric.cjs +805 -0
  164. package/dist/assertion/impl/sync-parametric.cjs.map +1 -0
  165. package/dist/assertion/impl/sync-parametric.d.cts +560 -0
  166. package/dist/assertion/impl/sync-parametric.d.cts.map +1 -0
  167. package/dist/assertion/impl/sync-parametric.d.ts +560 -0
  168. package/dist/assertion/impl/sync-parametric.d.ts.map +1 -0
  169. package/dist/assertion/impl/sync-parametric.js +802 -0
  170. package/dist/assertion/impl/sync-parametric.js.map +1 -0
  171. package/dist/assertion/impl/sync.cjs +229 -0
  172. package/dist/assertion/impl/sync.cjs.map +1 -0
  173. package/dist/assertion/impl/sync.d.cts +536 -0
  174. package/dist/assertion/impl/sync.d.cts.map +1 -0
  175. package/dist/assertion/impl/sync.d.ts +536 -0
  176. package/dist/assertion/impl/sync.d.ts.map +1 -0
  177. package/dist/assertion/impl/sync.js +212 -0
  178. package/dist/assertion/impl/sync.js.map +1 -0
  179. package/dist/assertion/index.cjs +38 -0
  180. package/dist/assertion/index.cjs.map +1 -0
  181. package/dist/assertion/index.d.cts +18 -0
  182. package/dist/assertion/index.d.cts.map +1 -0
  183. package/dist/assertion/index.d.ts +18 -0
  184. package/dist/assertion/index.d.ts.map +1 -0
  185. package/dist/assertion/index.js +17 -0
  186. package/dist/assertion/index.js.map +1 -0
  187. package/dist/assertion/slotify.cjs +165 -0
  188. package/dist/assertion/slotify.cjs.map +1 -0
  189. package/dist/assertion/slotify.d.cts +11 -0
  190. package/dist/assertion/slotify.d.cts.map +1 -0
  191. package/dist/assertion/slotify.d.ts +11 -0
  192. package/dist/assertion/slotify.d.ts.map +1 -0
  193. package/dist/assertion/slotify.js +161 -0
  194. package/dist/assertion/slotify.js.map +1 -0
  195. package/dist/bootstrap.cjs +43 -0
  196. package/dist/bootstrap.cjs.map +1 -0
  197. package/dist/bootstrap.d.cts +27 -0
  198. package/dist/bootstrap.d.cts.map +1 -0
  199. package/dist/bootstrap.d.ts +27 -0
  200. package/dist/bootstrap.d.ts.map +1 -0
  201. package/dist/bootstrap.js +40 -0
  202. package/dist/bootstrap.js.map +1 -0
  203. package/dist/constant.cjs +82 -0
  204. package/dist/constant.cjs.map +1 -0
  205. package/dist/constant.d.cts +69 -0
  206. package/dist/constant.d.cts.map +1 -0
  207. package/dist/constant.d.ts +69 -0
  208. package/dist/constant.d.ts.map +1 -0
  209. package/dist/constant.js +79 -0
  210. package/dist/constant.js.map +1 -0
  211. package/dist/diff.cjs +340 -0
  212. package/dist/diff.cjs.map +1 -0
  213. package/dist/diff.d.cts +51 -0
  214. package/dist/diff.d.cts.map +1 -0
  215. package/dist/diff.d.ts +51 -0
  216. package/dist/diff.d.ts.map +1 -0
  217. package/dist/diff.js +334 -0
  218. package/dist/diff.js.map +1 -0
  219. package/dist/error.cjs +194 -0
  220. package/dist/error.cjs.map +1 -0
  221. package/dist/error.d.cts +212 -0
  222. package/dist/error.d.cts.map +1 -0
  223. package/dist/error.d.ts +212 -0
  224. package/dist/error.d.ts.map +1 -0
  225. package/dist/error.js +181 -0
  226. package/dist/error.js.map +1 -0
  227. package/dist/expect.cjs +587 -0
  228. package/dist/expect.cjs.map +1 -0
  229. package/dist/expect.d.cts +138 -0
  230. package/dist/expect.d.cts.map +1 -0
  231. package/dist/expect.d.ts +138 -0
  232. package/dist/expect.d.ts.map +1 -0
  233. package/dist/expect.js +582 -0
  234. package/dist/expect.js.map +1 -0
  235. package/dist/guards.cjs +291 -0
  236. package/dist/guards.cjs.map +1 -0
  237. package/dist/guards.d.cts +225 -0
  238. package/dist/guards.d.cts.map +1 -0
  239. package/dist/guards.d.ts +225 -0
  240. package/dist/guards.d.ts.map +1 -0
  241. package/dist/guards.js +273 -0
  242. package/dist/guards.js.map +1 -0
  243. package/dist/index.cjs +111 -0
  244. package/dist/index.cjs.map +1 -0
  245. package/dist/index.d.cts +460 -0
  246. package/dist/index.d.cts.map +1 -0
  247. package/dist/index.d.ts +460 -0
  248. package/dist/index.d.ts.map +1 -0
  249. package/dist/index.js +71 -0
  250. package/dist/index.js.map +1 -0
  251. package/dist/internal-schema.cjs +234 -0
  252. package/dist/internal-schema.cjs.map +1 -0
  253. package/dist/internal-schema.d.cts +8 -0
  254. package/dist/internal-schema.d.cts.map +1 -0
  255. package/dist/internal-schema.d.ts +8 -0
  256. package/dist/internal-schema.d.ts.map +1 -0
  257. package/dist/internal-schema.js +229 -0
  258. package/dist/internal-schema.js.map +1 -0
  259. package/dist/metadata.cjs +57 -0
  260. package/dist/metadata.cjs.map +1 -0
  261. package/dist/metadata.d.cts +27 -0
  262. package/dist/metadata.d.cts.map +1 -0
  263. package/dist/metadata.d.ts +27 -0
  264. package/dist/metadata.d.ts.map +1 -0
  265. package/dist/metadata.js +54 -0
  266. package/dist/metadata.js.map +1 -0
  267. package/dist/schema.cjs +1522 -0
  268. package/dist/schema.cjs.map +1 -0
  269. package/dist/schema.d.cts +1196 -0
  270. package/dist/schema.d.cts.map +1 -0
  271. package/dist/schema.d.ts +1196 -0
  272. package/dist/schema.d.ts.map +1 -0
  273. package/dist/schema.js +1516 -0
  274. package/dist/schema.js.map +1 -0
  275. package/dist/snapshot/adapter.cjs +29 -0
  276. package/dist/snapshot/adapter.cjs.map +1 -0
  277. package/dist/snapshot/adapter.d.cts +258 -0
  278. package/dist/snapshot/adapter.d.cts.map +1 -0
  279. package/dist/snapshot/adapter.d.ts +258 -0
  280. package/dist/snapshot/adapter.d.ts.map +1 -0
  281. package/dist/snapshot/adapter.js +25 -0
  282. package/dist/snapshot/adapter.js.map +1 -0
  283. package/dist/snapshot/adapters/fallback.cjs +452 -0
  284. package/dist/snapshot/adapters/fallback.cjs.map +1 -0
  285. package/dist/snapshot/adapters/fallback.d.cts +185 -0
  286. package/dist/snapshot/adapters/fallback.d.cts.map +1 -0
  287. package/dist/snapshot/adapters/fallback.d.ts +185 -0
  288. package/dist/snapshot/adapters/fallback.d.ts.map +1 -0
  289. package/dist/snapshot/adapters/fallback.js +445 -0
  290. package/dist/snapshot/adapters/fallback.js.map +1 -0
  291. package/dist/snapshot/adapters/node-test.cjs +297 -0
  292. package/dist/snapshot/adapters/node-test.cjs.map +1 -0
  293. package/dist/snapshot/adapters/node-test.d.cts +131 -0
  294. package/dist/snapshot/adapters/node-test.d.cts.map +1 -0
  295. package/dist/snapshot/adapters/node-test.d.ts +131 -0
  296. package/dist/snapshot/adapters/node-test.d.ts.map +1 -0
  297. package/dist/snapshot/adapters/node-test.js +293 -0
  298. package/dist/snapshot/adapters/node-test.js.map +1 -0
  299. package/dist/snapshot/index.cjs +61 -0
  300. package/dist/snapshot/index.cjs.map +1 -0
  301. package/dist/snapshot/index.d.cts +40 -0
  302. package/dist/snapshot/index.d.cts.map +1 -0
  303. package/dist/snapshot/index.d.ts +40 -0
  304. package/dist/snapshot/index.d.ts.map +1 -0
  305. package/dist/snapshot/index.js +44 -0
  306. package/dist/snapshot/index.js.map +1 -0
  307. package/dist/snapshot/node-version.cjs +49 -0
  308. package/dist/snapshot/node-version.cjs.map +1 -0
  309. package/dist/snapshot/node-version.d.cts +34 -0
  310. package/dist/snapshot/node-version.d.cts.map +1 -0
  311. package/dist/snapshot/node-version.d.ts +34 -0
  312. package/dist/snapshot/node-version.d.ts.map +1 -0
  313. package/dist/snapshot/node-version.js +44 -0
  314. package/dist/snapshot/node-version.js.map +1 -0
  315. package/dist/snapshot/select-adapter.cjs +170 -0
  316. package/dist/snapshot/select-adapter.cjs.map +1 -0
  317. package/dist/snapshot/select-adapter.d.cts +128 -0
  318. package/dist/snapshot/select-adapter.d.cts.map +1 -0
  319. package/dist/snapshot/select-adapter.d.ts +128 -0
  320. package/dist/snapshot/select-adapter.d.ts.map +1 -0
  321. package/dist/snapshot/select-adapter.js +164 -0
  322. package/dist/snapshot/select-adapter.js.map +1 -0
  323. package/dist/snapshot/serializer.cjs +245 -0
  324. package/dist/snapshot/serializer.cjs.map +1 -0
  325. package/dist/snapshot/serializer.d.cts +126 -0
  326. package/dist/snapshot/serializer.d.cts.map +1 -0
  327. package/dist/snapshot/serializer.d.ts +126 -0
  328. package/dist/snapshot/serializer.d.ts.map +1 -0
  329. package/dist/snapshot/serializer.js +237 -0
  330. package/dist/snapshot/serializer.js.map +1 -0
  331. package/dist/standard-schema.cjs +13 -0
  332. package/dist/standard-schema.cjs.map +1 -0
  333. package/dist/standard-schema.d.cts +192 -0
  334. package/dist/standard-schema.d.cts.map +1 -0
  335. package/dist/standard-schema.d.ts +192 -0
  336. package/dist/standard-schema.d.ts.map +1 -0
  337. package/dist/standard-schema.js +12 -0
  338. package/dist/standard-schema.js.map +1 -0
  339. package/dist/types.cjs +22 -0
  340. package/dist/types.cjs.map +1 -0
  341. package/dist/types.d.cts +756 -0
  342. package/dist/types.d.cts.map +1 -0
  343. package/dist/types.d.ts +756 -0
  344. package/dist/types.d.ts.map +1 -0
  345. package/dist/types.js +21 -0
  346. package/dist/types.js.map +1 -0
  347. package/dist/use.cjs +240 -0
  348. package/dist/use.cjs.map +1 -0
  349. package/dist/use.d.cts +8 -0
  350. package/dist/use.d.cts.map +1 -0
  351. package/dist/use.d.ts +8 -0
  352. package/dist/use.d.ts.map +1 -0
  353. package/dist/use.js +236 -0
  354. package/dist/use.js.map +1 -0
  355. package/dist/util.cjs +255 -0
  356. package/dist/util.cjs.map +1 -0
  357. package/dist/util.d.cts +141 -0
  358. package/dist/util.d.cts.map +1 -0
  359. package/dist/util.d.ts +141 -0
  360. package/dist/util.d.ts.map +1 -0
  361. package/dist/util.js +234 -0
  362. package/dist/util.js.map +1 -0
  363. package/dist/value-to-schema.cjs +537 -0
  364. package/dist/value-to-schema.cjs.map +1 -0
  365. package/dist/value-to-schema.d.cts +144 -0
  366. package/dist/value-to-schema.d.cts.map +1 -0
  367. package/dist/value-to-schema.d.ts +144 -0
  368. package/dist/value-to-schema.d.ts.map +1 -0
  369. package/dist/value-to-schema.js +533 -0
  370. package/dist/value-to-schema.js.map +1 -0
  371. package/package.json +22 -19
  372. package/src/assertion/assertion-types.ts +4 -8
  373. package/src/assertion/assertion.ts +1 -1
  374. package/src/assertion/format-assertion-failure.ts +2 -0
  375. package/src/assertion/impl/assertion-util.ts +1 -2
  376. package/src/assertion/impl/iteration-util.ts +1 -3
  377. package/src/assertion/impl/sync-collection.ts +633 -7
  378. package/src/assertion/impl/sync.ts +27 -0
  379. package/src/error.ts +13 -22
  380. package/src/guards.ts +8 -14
  381. package/src/internal-schema.ts +4 -8
  382. package/src/metadata.ts +1 -2
  383. package/src/snapshot/adapter.ts +2 -3
  384. package/src/snapshot/adapters/fallback.ts +2 -3
  385. package/src/snapshot/adapters/node-test.ts +14 -20
  386. package/src/snapshot/select-adapter.ts +3 -3
  387. package/src/snapshot/serializer.ts +2 -3
  388. package/src/types.ts +2 -162
@@ -0,0 +1,185 @@
1
+ /**
2
+ * Fallback adapter for frameworks without native snapshot support.
3
+ *
4
+ * This adapter provides custom snapshot storage for test frameworks that don't
5
+ * have built-in snapshot functionality (e.g., Mocha, Tap, custom test
6
+ * runners).
7
+ *
8
+ * **Storage Format:** Snapshots are stored as CommonJS modules in
9
+ * `__snapshots__/` directories:
10
+ *
11
+ * ```javascript
12
+ * // __snapshots__/my-test.test.js.snap.cjs
13
+ * module.exports = {
14
+ * 'test name': '{\n "value": 42\n}',
15
+ * 'test name 2': '"another snapshot"',
16
+ * };
17
+ * ```
18
+ *
19
+ * @packageDocumentation
20
+ */
21
+ import type { AssertionFailure } from "../../types.js";
22
+ import type { SnapshotAdapter, SnapshotContext, SnapshotOptions } from "../adapter.js";
23
+ /**
24
+ * Fallback adapter for frameworks without native snapshot support.
25
+ *
26
+ * This adapter provides custom snapshot storage and management for test
27
+ * frameworks that don't have built-in snapshot functionality.
28
+ *
29
+ * **Supported Contexts:**
30
+ *
31
+ * - **Mocha**: Pass `this` from test callback
32
+ * - **Explicit names**: Pass a string snapshot name
33
+ *
34
+ * **Storage:**
35
+ *
36
+ * - Snapshots stored in `__snapshots__/*.snap.cjs` files
37
+ * - CommonJS format for compatibility with both CJS and ESM projects
38
+ * - Sorted entries for consistent diffs
39
+ *
40
+ * **Update Mode:**
41
+ *
42
+ * - Controlled by `BUPKIS_UPDATE_SNAPSHOTS=1` environment variable
43
+ *
44
+ * **Features:**
45
+ *
46
+ * - Multiple snapshots per test (automatic counters)
47
+ * - Named snapshots via `hint` option
48
+ * - Circular reference detection
49
+ * - Non-JSON type handling
50
+ *
51
+ * @example
52
+ *
53
+ * ```typescript
54
+ * // Mocha usage
55
+ * describe('MyComponent', function() {
56
+ * it('renders', function() {
57
+ * const output = render(<MyComponent />);
58
+ * expect(output, 'to match snapshot', this);
59
+ * });
60
+ * });
61
+ * ```
62
+ *
63
+ * @example
64
+ *
65
+ * ```typescript
66
+ * // Explicit name (any framework)
67
+ * test('renders component', () => {
68
+ * const output = render(<MyComponent />);
69
+ * expect(output, 'to match snapshot', 'component-default-state');
70
+ * });
71
+ * ```
72
+ *
73
+ * @example
74
+ *
75
+ * ```typescript
76
+ * // Multiple snapshots with hints
77
+ * test('multi-step process', () => {
78
+ * expect(step1(), 'to match snapshot', 'step-1', { hint: 'initial' });
79
+ * expect(step2(), 'to match snapshot', 'step-2', { hint: 'processing' });
80
+ * expect(step3(), 'to match snapshot', 'step-3', { hint: 'complete' });
81
+ * });
82
+ * ```
83
+ *
84
+ * @example
85
+ *
86
+ * ```sh
87
+ * # Update snapshots
88
+ * BUPKIS_UPDATE_SNAPSHOTS=1 npm test
89
+ * ```
90
+ */
91
+ export declare class FallbackAdapter implements SnapshotAdapter {
92
+ /**
93
+ * Adapter name for identification and debugging.
94
+ */
95
+ readonly name = "fallback";
96
+ /**
97
+ * Check if this adapter can handle the given context.
98
+ *
99
+ * The fallback adapter accepts both strings (explicit snapshot names) and
100
+ * objects (potential Mocha contexts). It's designed to be the last adapter in
101
+ * the selection chain and will accept most inputs.
102
+ *
103
+ * @param context - Test context or snapshot name
104
+ * @returns `true` for strings or objects
105
+ */
106
+ canHandle: (context: unknown) => boolean;
107
+ /**
108
+ * Extract snapshot context from Mocha context or string name.
109
+ *
110
+ * **For Mocha contexts:**
111
+ *
112
+ * - Extracts test name from `this.test.fullTitle()`
113
+ * - Gets file path from `this.test.file` or stack trace
114
+ *
115
+ * **For string contexts:**
116
+ *
117
+ * - Uses the string as the test name
118
+ * - Extracts file path from stack trace
119
+ *
120
+ * **Update mode:**
121
+ *
122
+ * - Checks `process.env.BUPKIS_UPDATE_SNAPSHOTS === '1'`
123
+ *
124
+ * @param context - Mocha context or string snapshot name
125
+ * @returns Normalized snapshot context
126
+ * @throws {TypeError} If context is neither a valid Mocha context nor a
127
+ * string
128
+ */
129
+ getContext(context: unknown): SnapshotContext;
130
+ /**
131
+ * Perform snapshot assertion using custom storage.
132
+ *
133
+ * **Behavior:**
134
+ *
135
+ * - **Update mode**: Creates or updates the snapshot
136
+ * - **Comparison mode**: Loads existing snapshot and compares
137
+ *
138
+ * **Process:**
139
+ *
140
+ * 1. Serialize the value using provided serializer or default
141
+ * 2. Generate unique snapshot name (with counter if needed)
142
+ * 3. Load existing snapshot store from disk
143
+ * 4. Either update snapshot or compare and throw on mismatch
144
+ *
145
+ * @example
146
+ *
147
+ * ```typescript
148
+ * const adapter = new FallbackAdapter();
149
+ *
150
+ * // With Mocha context
151
+ * adapter.assertSnapshot({ foo: 'bar' }, mochaThis);
152
+ *
153
+ * // With explicit name
154
+ * adapter.assertSnapshot({ foo: 'bar' }, 'my-snapshot');
155
+ *
156
+ * // With custom serializer
157
+ * adapter.assertSnapshot(data, 'test', {
158
+ * serializer: (v) => JSON.stringify(v, null, 2),
159
+ * });
160
+ * ```
161
+ *
162
+ * @param value - Value to snapshot
163
+ * @param context - Mocha context or string name
164
+ * @param options - Optional serializer and hint
165
+ * @throws {TypeError} If context is invalid
166
+ * @throws {AssertionError} If snapshot doesn't match (in comparison mode)
167
+ */
168
+ validateSnapshot(value: unknown, context: unknown, options?: SnapshotOptions): AssertionFailure | void;
169
+ }
170
+ /**
171
+ * Singleton instance of the fallback adapter.
172
+ *
173
+ * This is the primary export and should be used for adapter registration.
174
+ *
175
+ * @example
176
+ *
177
+ * ```typescript
178
+ * import { fallbackAdapter } from 'bupkis/snapshot';
179
+ * import { registerAdapter } from 'bupkis/snapshot';
180
+ *
181
+ * registerAdapter(fallbackAdapter);
182
+ * ```
183
+ */
184
+ export declare const fallbackAdapter: FallbackAdapter;
185
+ //# sourceMappingURL=fallback.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fallback.d.ts","sourceRoot":"","sources":["../../../src/snapshot/adapters/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB;AACvD,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,eAAe,EAChB,sBAAsB;AAwPvB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,qBAAa,eAAgB,YAAW,eAAe;IACrD;;OAEG;IACH,QAAQ,CAAC,IAAI,cAAc;IAE3B;;;;;;;;;OASG;IACH,SAAS,GAAI,SAAS,OAAO,KAAG,OAAO,CAEsB;IAE7D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe;IAsB7C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,gBAAgB,CACd,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,eAAe,GACxB,gBAAgB,GAAG,IAAI;CA2B3B;AAoCD;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe,iBAAwB,CAAC"}
@@ -0,0 +1,445 @@
1
+ /**
2
+ * Fallback adapter for frameworks without native snapshot support.
3
+ *
4
+ * This adapter provides custom snapshot storage for test frameworks that don't
5
+ * have built-in snapshot functionality (e.g., Mocha, Tap, custom test
6
+ * runners).
7
+ *
8
+ * **Storage Format:** Snapshots are stored as CommonJS modules in
9
+ * `__snapshots__/` directories:
10
+ *
11
+ * ```javascript
12
+ * // __snapshots__/my-test.test.js.snap.cjs
13
+ * module.exports = {
14
+ * 'test name': '{\n "value": 42\n}',
15
+ * 'test name 2': '"another snapshot"',
16
+ * };
17
+ * ```
18
+ *
19
+ * @packageDocumentation
20
+ */
21
+ import stringify from 'json-stable-stringify';
22
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
23
+ import { dirname, join, relative, resolve } from 'node:path';
24
+ import { defaultSerializer } from "../serializer.js";
25
+ const { entries } = Object;
26
+ /**
27
+ * Extract snapshot context from Mocha's `this` context.
28
+ *
29
+ * Mocha provides test information through `this.test` in test callbacks. This
30
+ * function attempts to extract the test name and file path from that
31
+ * structure.
32
+ *
33
+ * @example
34
+ *
35
+ * ```typescript
36
+ * describe('suite', function () {
37
+ * it('test', function () {
38
+ * const ctx = extractMochaContext(this);
39
+ * // ctx = {
40
+ * // testPath: 'suite test',
41
+ * // filePath: '/path/to/test.js',
42
+ * // isUpdateMode: false
43
+ * // }
44
+ * });
45
+ * });
46
+ * ```
47
+ *
48
+ * @function
49
+ * @param context - Potential Mocha context object
50
+ * @returns Snapshot context if Mocha context detected, null otherwise
51
+ */
52
+ const extractMochaContext = (context) => {
53
+ const mochaCtx = context;
54
+ if (mochaCtx?.test?.fullTitle) {
55
+ return {
56
+ filePath: mochaCtx.test.file || getTestFilePathFromStack(),
57
+ isUpdateMode: process.env.BUPKIS_UPDATE_SNAPSHOTS === '1',
58
+ testPath: mochaCtx.test.fullTitle(),
59
+ };
60
+ }
61
+ return null;
62
+ };
63
+ /**
64
+ * Get snapshot file path for a test file.
65
+ *
66
+ * Snapshots are stored in a `__snapshots__/` directory next to the test file.
67
+ * The snapshot filename is based on the test file path, with slashes replaced
68
+ * by dashes to create a flat structure.
69
+ *
70
+ * Uses `.cjs` extension for CommonJS compatibility in both CJS and ESM
71
+ * projects.
72
+ *
73
+ * @example
74
+ *
75
+ * ```typescript
76
+ * getSnapshotFilePath('/project/test/unit/foo.test.ts');
77
+ * // Returns: '/project/test/unit/__snapshots__/test-unit-foo.test.ts.snap.cjs'
78
+ * ```
79
+ *
80
+ * @function
81
+ * @param testFilePath - Absolute path to the test file
82
+ * @returns Absolute path to the snapshot file
83
+ */
84
+ const getSnapshotFilePath = (testFilePath) => {
85
+ const dir = dirname(testFilePath);
86
+ const snapshotDir = join(dir, '__snapshots__');
87
+ const filename = relative(process.cwd(), testFilePath).replace(/\//g, '-');
88
+ return join(snapshotDir, `${filename}.snap.cjs`);
89
+ };
90
+ /**
91
+ * Get test file path from stack trace.
92
+ *
93
+ * Searches the stack trace for lines containing test file paths. Looks for
94
+ * files matching patterns like `*.test.js`, `*.spec.ts`, etc.
95
+ *
96
+ * @function
97
+ * @returns Absolute path to test file, or 'unknown.test.js' if not found
98
+ */
99
+ const getTestFilePathFromStack = () => {
100
+ const stack = new Error().stack || '';
101
+ const lines = stack.split('\n');
102
+ for (const line of lines) {
103
+ // Match file paths in stack traces
104
+ const match = line.match(/\((.+\.(?:test|spec)\.[jt]s):\d+:\d+\)/);
105
+ if (match && match[1]) {
106
+ return resolve(match[1]);
107
+ }
108
+ }
109
+ return resolve('unknown.test.js');
110
+ };
111
+ /**
112
+ * Load snapshots from a snapshot file.
113
+ *
114
+ * Reads and parses the CommonJS format snapshot file. If the file doesn't exist
115
+ * or can't be parsed, returns an empty store.
116
+ *
117
+ * **Expected format:**
118
+ *
119
+ * ```javascript
120
+ * module.exports = {
121
+ * 'test name': '{"value": 42}',
122
+ * 'another test': '"string"',
123
+ * };
124
+ * ```
125
+ *
126
+ * @example
127
+ *
128
+ * ```typescript
129
+ * const store = loadSnapshots('/path/to/__snapshots__/test.snap.cjs');
130
+ * console.log(store['my test']); // '{"foo": "bar"}'
131
+ * ```
132
+ *
133
+ * @function
134
+ * @param snapshotPath - Path to the snapshot file
135
+ * @returns Snapshot store (test name → serialized value)
136
+ */
137
+ const loadSnapshots = (snapshotPath) => {
138
+ if (!existsSync(snapshotPath)) {
139
+ return {};
140
+ }
141
+ try {
142
+ // Read as CommonJS module
143
+ const content = readFileSync(snapshotPath, 'utf-8');
144
+ // Parse the module.exports = { ... } format
145
+ const match = content.match(/module\.exports\s*=\s*(\{[\s\S]*\});?\s*$/);
146
+ if (match) {
147
+ // Use Function constructor to safely eval the object literal
148
+ // This is safe because we're only parsing the object structure,
149
+ // not executing arbitrary code
150
+ // eslint-disable-next-line @typescript-eslint/no-implied-eval, @typescript-eslint/no-unsafe-call
151
+ const store = new Function(`return ${match[1]}`)();
152
+ return store;
153
+ }
154
+ }
155
+ catch {
156
+ // If parsing fails, return empty store
157
+ // This allows for snapshot regeneration
158
+ }
159
+ return {};
160
+ };
161
+ /**
162
+ * Save snapshots to a snapshot file.
163
+ *
164
+ * Writes the snapshot store to disk in CommonJS format. Creates the
165
+ * `__snapshots__/` directory if it doesn't exist. Entries are sorted
166
+ * alphabetically by test name for consistency.
167
+ *
168
+ * **Output format:**
169
+ *
170
+ * ```javascript
171
+ * module.exports = {
172
+ * 'test 1': '{"value": 1}',
173
+ * 'test 2': '{"value": 2}',
174
+ * };
175
+ * ```
176
+ *
177
+ * @example
178
+ *
179
+ * ```typescript
180
+ * const store = {
181
+ * 'my test': '{"foo": "bar"}',
182
+ * 'another test': '"string"',
183
+ * };
184
+ * saveSnapshots('/path/to/__snapshots__/test.snap.cjs', store);
185
+ * ```
186
+ *
187
+ * @function
188
+ * @param snapshotPath - Path to the snapshot file
189
+ * @param store - Snapshot store to save
190
+ */
191
+ const saveSnapshots = (snapshotPath, store) => {
192
+ const dir = dirname(snapshotPath);
193
+ // Ensure directory exists
194
+ if (!existsSync(dir)) {
195
+ mkdirSync(dir, { recursive: true });
196
+ }
197
+ // Generate CommonJS module format with sorted entries
198
+ const snapshotEntries = entries(store)
199
+ .sort(([a], [b]) => a.localeCompare(b))
200
+ .map(([key, value]) => ` ${stringify(key)}: ${stringify(value)}`)
201
+ .join(',\n');
202
+ const content = `module.exports = {\n${snapshotEntries}\n};\n`;
203
+ writeFileSync(snapshotPath, content, 'utf-8');
204
+ };
205
+ /**
206
+ * Snapshot counters for multiple snapshots per test.
207
+ *
208
+ * Tracks how many snapshots have been taken for each test path to generate
209
+ * unique snapshot names when a test has multiple snapshots.
210
+ */
211
+ const snapshotCounters = new Map();
212
+ /**
213
+ * Fallback adapter for frameworks without native snapshot support.
214
+ *
215
+ * This adapter provides custom snapshot storage and management for test
216
+ * frameworks that don't have built-in snapshot functionality.
217
+ *
218
+ * **Supported Contexts:**
219
+ *
220
+ * - **Mocha**: Pass `this` from test callback
221
+ * - **Explicit names**: Pass a string snapshot name
222
+ *
223
+ * **Storage:**
224
+ *
225
+ * - Snapshots stored in `__snapshots__/*.snap.cjs` files
226
+ * - CommonJS format for compatibility with both CJS and ESM projects
227
+ * - Sorted entries for consistent diffs
228
+ *
229
+ * **Update Mode:**
230
+ *
231
+ * - Controlled by `BUPKIS_UPDATE_SNAPSHOTS=1` environment variable
232
+ *
233
+ * **Features:**
234
+ *
235
+ * - Multiple snapshots per test (automatic counters)
236
+ * - Named snapshots via `hint` option
237
+ * - Circular reference detection
238
+ * - Non-JSON type handling
239
+ *
240
+ * @example
241
+ *
242
+ * ```typescript
243
+ * // Mocha usage
244
+ * describe('MyComponent', function() {
245
+ * it('renders', function() {
246
+ * const output = render(<MyComponent />);
247
+ * expect(output, 'to match snapshot', this);
248
+ * });
249
+ * });
250
+ * ```
251
+ *
252
+ * @example
253
+ *
254
+ * ```typescript
255
+ * // Explicit name (any framework)
256
+ * test('renders component', () => {
257
+ * const output = render(<MyComponent />);
258
+ * expect(output, 'to match snapshot', 'component-default-state');
259
+ * });
260
+ * ```
261
+ *
262
+ * @example
263
+ *
264
+ * ```typescript
265
+ * // Multiple snapshots with hints
266
+ * test('multi-step process', () => {
267
+ * expect(step1(), 'to match snapshot', 'step-1', { hint: 'initial' });
268
+ * expect(step2(), 'to match snapshot', 'step-2', { hint: 'processing' });
269
+ * expect(step3(), 'to match snapshot', 'step-3', { hint: 'complete' });
270
+ * });
271
+ * ```
272
+ *
273
+ * @example
274
+ *
275
+ * ```sh
276
+ * # Update snapshots
277
+ * BUPKIS_UPDATE_SNAPSHOTS=1 npm test
278
+ * ```
279
+ */
280
+ export class FallbackAdapter {
281
+ /**
282
+ * Adapter name for identification and debugging.
283
+ */
284
+ name = 'fallback';
285
+ /**
286
+ * Check if this adapter can handle the given context.
287
+ *
288
+ * The fallback adapter accepts both strings (explicit snapshot names) and
289
+ * objects (potential Mocha contexts). It's designed to be the last adapter in
290
+ * the selection chain and will accept most inputs.
291
+ *
292
+ * @param context - Test context or snapshot name
293
+ * @returns `true` for strings or objects
294
+ */
295
+ canHandle = (context) =>
296
+ // Fallback handles strings (explicit names) and objects (Mocha)
297
+ typeof context === 'string' || typeof context === 'object';
298
+ /**
299
+ * Extract snapshot context from Mocha context or string name.
300
+ *
301
+ * **For Mocha contexts:**
302
+ *
303
+ * - Extracts test name from `this.test.fullTitle()`
304
+ * - Gets file path from `this.test.file` or stack trace
305
+ *
306
+ * **For string contexts:**
307
+ *
308
+ * - Uses the string as the test name
309
+ * - Extracts file path from stack trace
310
+ *
311
+ * **Update mode:**
312
+ *
313
+ * - Checks `process.env.BUPKIS_UPDATE_SNAPSHOTS === '1'`
314
+ *
315
+ * @param context - Mocha context or string snapshot name
316
+ * @returns Normalized snapshot context
317
+ * @throws {TypeError} If context is neither a valid Mocha context nor a
318
+ * string
319
+ */
320
+ getContext(context) {
321
+ // Try Mocha first
322
+ const mochaContext = extractMochaContext(context);
323
+ if (mochaContext) {
324
+ return mochaContext;
325
+ }
326
+ // String context (explicit snapshot name)
327
+ if (typeof context === 'string') {
328
+ return {
329
+ filePath: getTestFilePathFromStack(),
330
+ isUpdateMode: process.env.BUPKIS_UPDATE_SNAPSHOTS === '1',
331
+ testPath: context,
332
+ };
333
+ }
334
+ throw new TypeError('Fallback adapter requires either a string snapshot name or Mocha context. ' +
335
+ 'Pass test name as string: expect(value, "to match snapshot", "my-test-name")');
336
+ }
337
+ /**
338
+ * Perform snapshot assertion using custom storage.
339
+ *
340
+ * **Behavior:**
341
+ *
342
+ * - **Update mode**: Creates or updates the snapshot
343
+ * - **Comparison mode**: Loads existing snapshot and compares
344
+ *
345
+ * **Process:**
346
+ *
347
+ * 1. Serialize the value using provided serializer or default
348
+ * 2. Generate unique snapshot name (with counter if needed)
349
+ * 3. Load existing snapshot store from disk
350
+ * 4. Either update snapshot or compare and throw on mismatch
351
+ *
352
+ * @example
353
+ *
354
+ * ```typescript
355
+ * const adapter = new FallbackAdapter();
356
+ *
357
+ * // With Mocha context
358
+ * adapter.assertSnapshot({ foo: 'bar' }, mochaThis);
359
+ *
360
+ * // With explicit name
361
+ * adapter.assertSnapshot({ foo: 'bar' }, 'my-snapshot');
362
+ *
363
+ * // With custom serializer
364
+ * adapter.assertSnapshot(data, 'test', {
365
+ * serializer: (v) => JSON.stringify(v, null, 2),
366
+ * });
367
+ * ```
368
+ *
369
+ * @param value - Value to snapshot
370
+ * @param context - Mocha context or string name
371
+ * @param options - Optional serializer and hint
372
+ * @throws {TypeError} If context is invalid
373
+ * @throws {AssertionError} If snapshot doesn't match (in comparison mode)
374
+ */
375
+ validateSnapshot(value, context, options) {
376
+ const ctx = this.getContext(context);
377
+ const serializer = options?.serializer || defaultSerializer;
378
+ const snapshotName = getSnapshotName(ctx.testPath, options?.hint);
379
+ const snapshotPath = getSnapshotFilePath(ctx.filePath);
380
+ const store = loadSnapshots(snapshotPath);
381
+ const actual = serializer(value);
382
+ const expected = store[snapshotName];
383
+ if (ctx.isUpdateMode || expected === undefined) {
384
+ // Update/create snapshot
385
+ store[snapshotName] = actual;
386
+ saveSnapshots(snapshotPath, store);
387
+ return;
388
+ }
389
+ // Compare snapshots
390
+ if (actual !== expected) {
391
+ return {
392
+ actual,
393
+ expected,
394
+ message: `Snapshot mismatch for "${snapshotName}"\n\nExpected:\n${expected}\n\nActual:\n${actual}`,
395
+ };
396
+ }
397
+ }
398
+ }
399
+ /**
400
+ * Get the next snapshot name for a test.
401
+ *
402
+ * For the first snapshot in a test, uses the test path as-is. For subsequent
403
+ * snapshots, appends a counter: `"test name 2"`, `"test name 3"`, etc.
404
+ *
405
+ * If a hint is provided, it's appended in brackets: `"test name [hint]"`.
406
+ *
407
+ * @example
408
+ *
409
+ * ```typescript
410
+ * getSnapshotName('MyComponent renders'); // 'MyComponent renders'
411
+ * getSnapshotName('MyComponent renders'); // 'MyComponent renders 2'
412
+ * getSnapshotName('MyComponent renders'); // 'MyComponent renders 3'
413
+ *
414
+ * getSnapshotName('test', 'initial state'); // 'test [initial state]'
415
+ * ```
416
+ *
417
+ * @function
418
+ * @param testPath - Full test path/name
419
+ * @param hint - Optional descriptive hint
420
+ * @returns Unique snapshot name
421
+ */
422
+ const getSnapshotName = (testPath, hint) => {
423
+ if (hint) {
424
+ return `${testPath} [${hint}]`;
425
+ }
426
+ const counter = snapshotCounters.get(testPath) || 0;
427
+ snapshotCounters.set(testPath, counter + 1);
428
+ return counter === 0 ? testPath : `${testPath} ${counter + 1}`;
429
+ };
430
+ /**
431
+ * Singleton instance of the fallback adapter.
432
+ *
433
+ * This is the primary export and should be used for adapter registration.
434
+ *
435
+ * @example
436
+ *
437
+ * ```typescript
438
+ * import { fallbackAdapter } from 'bupkis/snapshot';
439
+ * import { registerAdapter } from 'bupkis/snapshot';
440
+ *
441
+ * registerAdapter(fallbackAdapter);
442
+ * ```
443
+ */
444
+ export const fallbackAdapter = new FallbackAdapter();
445
+ //# sourceMappingURL=fallback.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fallback.js","sourceRoot":"","sources":["../../../src/snapshot/adapters/fallback.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,SAAS,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAS7D,OAAO,EAAE,iBAAiB,EAAE,yBAAyB;AAErD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;AA0C3B;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,mBAAmB,GAAG,CAAC,OAAgB,EAA0B,EAAE;IACvE,MAAM,QAAQ,GAAG,OAAuB,CAAC;IAEzC,IAAI,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,wBAAwB,EAAE;YAC1D,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG;YACzD,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,mBAAmB,GAAG,CAAC,YAAoB,EAAU,EAAE;IAC3D,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAClC,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,WAAW,EAAE,GAAG,QAAQ,WAAW,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,wBAAwB,GAAG,GAAW,EAAE;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAEhC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,mCAAmC;QACnC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QACnE,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACtB,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC,iBAAiB,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,aAAa,GAAG,CAAC,YAAoB,EAAiB,EAAE;IAC5D,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,0BAA0B;QAC1B,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAEpD,4CAA4C;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;QACzE,IAAI,KAAK,EAAE,CAAC;YACV,6DAA6D;YAC7D,gEAAgE;YAChE,+BAA+B;YAC/B,iGAAiG;YACjG,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAmB,CAAC;YACpE,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;QACvC,wCAAwC;IAC1C,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,aAAa,GAAG,CAAC,YAAoB,EAAE,KAAoB,EAAQ,EAAE;IACzE,MAAM,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAElC,0BAA0B;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACrB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,CAAC;IAED,sDAAsD;IACtD,MAAM,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;SACnC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;SACtC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,SAAS,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;SACjE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEf,MAAM,OAAO,GAAG,uBAAuB,eAAe,QAAQ,CAAC;IAE/D,aAAa,CAAC,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACM,IAAI,GAAG,UAAU,CAAC;IAE3B;;;;;;;;;OASG;IACH,SAAS,GAAG,CAAC,OAAgB,EAAW,EAAE;IACxC,gEAAgE;IAChE,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,KAAK,QAAQ,CAAC;IAE7D;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAgB;QACzB,kBAAkB;QAClB,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,0CAA0C;QAC1C,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO;gBACL,QAAQ,EAAE,wBAAwB,EAAE;gBACpC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG;gBACzD,QAAQ,EAAE,OAAO;aAClB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,SAAS,CACjB,4EAA4E;YAC1E,8EAA8E,CACjF,CAAC;IACJ,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG;IACH,gBAAgB,CACd,KAAc,EACd,OAAgB,EAChB,OAAyB;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,MAAM,UAAU,GAAG,OAAO,EAAE,UAAU,IAAI,iBAAiB,CAAC;QAE5D,MAAM,YAAY,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACvD,MAAM,KAAK,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QAE1C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAG,KAAK,CAAC,YAAY,CAAC,CAAC;QAErC,IAAI,GAAG,CAAC,YAAY,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC/C,yBAAyB;YACzB,KAAK,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC;YAC7B,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,oBAAoB;QACpB,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO;gBACL,MAAM;gBACN,QAAQ;gBACR,OAAO,EAAE,0BAA0B,YAAY,mBAAmB,QAAQ,gBAAgB,MAAM,EAAE;aACnG,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,IAAa,EAAU,EAAE;IAClE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,GAAG,QAAQ,KAAK,IAAI,GAAG,CAAC;IACjC,CAAC;IAED,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpD,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC;IAE5C,OAAO,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC"}