@blac/core 2.0.13 → 2.0.14

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 (379) hide show
  1. package/README.md +85 -3
  2. package/dist/Cubit-9jal5zdZ.cjs +1 -1
  3. package/dist/Cubit-BAUPiUF7.cjs +359 -286
  4. package/dist/Cubit-BBKF3PIg.js +269 -230
  5. package/dist/Cubit-BC70gaiA.js +453 -0
  6. package/dist/Cubit-BC70gaiA.js.map +1 -0
  7. package/dist/Cubit-BOgUZva7.js +342 -266
  8. package/dist/Cubit-BOxMvpfc.js +273 -232
  9. package/dist/Cubit-BTznt8zg.js +1 -1
  10. package/dist/Cubit-BogJXkLm.js +260 -225
  11. package/dist/Cubit-C-8R_8db.cjs +475 -0
  12. package/dist/Cubit-C-8R_8db.cjs.map +1 -0
  13. package/dist/Cubit-C3Mw3EoO.cjs +401 -0
  14. package/dist/Cubit-C3Mw3EoO.cjs.map +1 -0
  15. package/dist/Cubit-CO8Fr72L.cjs +447 -0
  16. package/dist/Cubit-CO8Fr72L.cjs.map +1 -0
  17. package/dist/Cubit-COfHT1Bm.cjs +300 -259
  18. package/dist/Cubit-CROWjjs9.js +481 -0
  19. package/dist/Cubit-CROWjjs9.js.map +1 -0
  20. package/dist/Cubit-CWP8Ddzx.cjs +510 -0
  21. package/dist/Cubit-CWP8Ddzx.cjs.map +1 -0
  22. package/dist/Cubit-CXxh9iol.js +284 -242
  23. package/dist/Cubit-CYOWfzQt.cjs +297 -254
  24. package/dist/Cubit-CZaf_fp4.cjs +1 -1
  25. package/dist/Cubit-C_dUEUdd.cjs +359 -286
  26. package/dist/Cubit-C_rxRCTN.cjs +523 -0
  27. package/dist/Cubit-C_rxRCTN.cjs.map +1 -0
  28. package/dist/Cubit-CcKgMEBO.js +281 -239
  29. package/dist/Cubit-CfT6Y1jl.js +328 -280
  30. package/dist/Cubit-CynJruuO.js +369 -0
  31. package/dist/Cubit-CynJruuO.js.map +1 -0
  32. package/dist/Cubit-D2vQ6nMb.js +342 -266
  33. package/dist/Cubit-D7jOZCoZ.js +342 -266
  34. package/dist/Cubit-D9j3IGPc.cjs +523 -0
  35. package/dist/Cubit-D9j3IGPc.cjs.map +1 -0
  36. package/dist/Cubit-DKEY9WYq.cjs +276 -240
  37. package/dist/Cubit-DMV_0TCp.js +481 -0
  38. package/dist/Cubit-DMV_0TCp.js.map +1 -0
  39. package/dist/Cubit-DP5DXPUK.js +342 -266
  40. package/dist/Cubit-DRFkzD2h.js +426 -0
  41. package/dist/Cubit-DRFkzD2h.js.map +1 -0
  42. package/dist/Cubit-DbnhTUaZ.cjs +359 -286
  43. package/dist/Cubit-DrqG3SP3.cjs +349 -300
  44. package/dist/Cubit-DsDkCo42.cjs +292 -250
  45. package/dist/Cubit-DwRw1E9D.cjs +289 -247
  46. package/dist/Cubit-Dw_kFBgc.js +1 -1
  47. package/dist/Cubit-KiXZCubP.cjs +1 -1
  48. package/dist/Cubit-Ksj7G4uR.js +342 -266
  49. package/dist/Cubit-MkjbpcPf.cjs +359 -286
  50. package/dist/Cubit-NRhvdDQ6.js +279 -239
  51. package/dist/Cubit-PMTXxI_u.js +1 -1
  52. package/dist/Cubit-VJuu2tt9.js +481 -0
  53. package/dist/Cubit-VJuu2tt9.js.map +1 -0
  54. package/dist/Cubit-jz922NKf.cjs +300 -257
  55. package/dist/Cubit-kU5_4jgC.cjs +359 -286
  56. package/dist/StateContainerRegistry-B4yVMYbx.cjs +1057 -0
  57. package/dist/StateContainerRegistry-B4yVMYbx.cjs.map +1 -0
  58. package/dist/StateContainerRegistry-BAcxouCu.js +683 -615
  59. package/dist/StateContainerRegistry-BK57H92E.js +701 -630
  60. package/dist/StateContainerRegistry-BRBATSrx.cjs +1030 -0
  61. package/dist/StateContainerRegistry-BRBATSrx.cjs.map +1 -0
  62. package/dist/StateContainerRegistry-BgBIKcQF.js +956 -0
  63. package/dist/StateContainerRegistry-BgBIKcQF.js.map +1 -0
  64. package/dist/StateContainerRegistry-BglEhqdA.js +669 -606
  65. package/dist/StateContainerRegistry-BhcnG0DF.js +625 -562
  66. package/dist/StateContainerRegistry-BpO5t-0i.js +642 -580
  67. package/dist/StateContainerRegistry-BqS-wpb_.js +957 -0
  68. package/dist/StateContainerRegistry-BqS-wpb_.js.map +1 -0
  69. package/dist/StateContainerRegistry-BrEGYPZT.cjs +1029 -0
  70. package/dist/StateContainerRegistry-BrEGYPZT.cjs.map +1 -0
  71. package/dist/StateContainerRegistry-Bxfne4A7.cjs +908 -0
  72. package/dist/StateContainerRegistry-Bxfne4A7.cjs.map +1 -0
  73. package/dist/StateContainerRegistry-C0E7vsgy.js +758 -0
  74. package/dist/StateContainerRegistry-C0E7vsgy.js.map +1 -0
  75. package/dist/StateContainerRegistry-C0I77Ndz.cjs +920 -0
  76. package/dist/StateContainerRegistry-C0I77Ndz.cjs.map +1 -0
  77. package/dist/StateContainerRegistry-CDH9mnQS.cjs +668 -614
  78. package/dist/StateContainerRegistry-CTOXUf75.cjs +695 -640
  79. package/dist/StateContainerRegistry-CX2CBOmv.cjs +739 -679
  80. package/dist/StateContainerRegistry-CXnnf2-l.js +867 -0
  81. package/dist/StateContainerRegistry-CXnnf2-l.js.map +1 -0
  82. package/dist/StateContainerRegistry-CehuIpK_.cjs +811 -0
  83. package/dist/StateContainerRegistry-CehuIpK_.cjs.map +1 -0
  84. package/dist/StateContainerRegistry-Ci0ajc5g.js +680 -612
  85. package/dist/StateContainerRegistry-Ck2-XmT_.js +587 -527
  86. package/dist/StateContainerRegistry-D1lVJFGL.cjs +706 -646
  87. package/dist/StateContainerRegistry-DC4N73O6.js +632 -569
  88. package/dist/StateContainerRegistry-DOuGI-l5.js +645 -582
  89. package/dist/StateContainerRegistry-DT66lr3I.cjs +651 -596
  90. package/dist/StateContainerRegistry-DmmzYa7S.js +974 -0
  91. package/dist/StateContainerRegistry-DmmzYa7S.js.map +1 -0
  92. package/dist/StateContainerRegistry-Upsrlg9G.cjs +709 -649
  93. package/dist/StateContainerRegistry-WznfcA-Q.js +855 -0
  94. package/dist/StateContainerRegistry-WznfcA-Q.js.map +1 -0
  95. package/dist/StateContainerRegistry-Yph6UCA_.js +637 -569
  96. package/dist/StateContainerRegistry-mseeTqSA.cjs +671 -616
  97. package/dist/StateContainerRegistry-pRNxHNFD.cjs +658 -603
  98. package/dist/StateContainerRegistry-vXMWtG7J.cjs +613 -561
  99. package/dist/StateContainerRegistry-v_prqMcI.cjs +663 -603
  100. package/dist/branded-BSeA_mZO.cjs.map +1 -1
  101. package/dist/branded-DCqi3De1.cjs +11 -11
  102. package/dist/branded-DwtzSsg0.js.map +1 -1
  103. package/dist/branded-Max3xOTA.js +6 -6
  104. package/dist/config-0ZD9i3wy.js +16 -0
  105. package/dist/config-0ZD9i3wy.js.map +1 -0
  106. package/dist/config-B3NIwDQv.cjs +20 -20
  107. package/dist/config-BKGHop0V.js +5 -5
  108. package/dist/config-BKoaAlmb.js +5 -5
  109. package/dist/config-BPj08-8h.cjs +32 -0
  110. package/dist/config-BPj08-8h.cjs.map +1 -0
  111. package/dist/config-BR0Xy-Tn.cjs +20 -20
  112. package/dist/config-B_4xXpvK.cjs +32 -0
  113. package/dist/config-B_4xXpvK.cjs.map +1 -0
  114. package/dist/config-BflrQM4_.cjs +32 -0
  115. package/dist/config-BflrQM4_.cjs.map +1 -0
  116. package/dist/config-BzObBsk2.cjs +32 -0
  117. package/dist/config-BzObBsk2.cjs.map +1 -0
  118. package/dist/config-C0yumL1H.cjs +32 -0
  119. package/dist/config-C0yumL1H.cjs.map +1 -0
  120. package/dist/config-C8xqVHTf.js +16 -0
  121. package/dist/config-C8xqVHTf.js.map +1 -0
  122. package/dist/config-CCUhIYIF.js +5 -5
  123. package/dist/config-CGo__MAt.js +16 -0
  124. package/dist/config-CGo__MAt.js.map +1 -0
  125. package/dist/config-CQH9fTY-.cjs +20 -20
  126. package/dist/config-CR_Bz7RD.js +5 -5
  127. package/dist/config-CTOa-yPN.cjs +20 -20
  128. package/dist/config-Cd7Q-B4g.js +16 -0
  129. package/dist/config-Cd7Q-B4g.js.map +1 -0
  130. package/dist/config-CmDEX-1o.js +16 -0
  131. package/dist/config-CmDEX-1o.js.map +1 -0
  132. package/dist/config-CoNMTnMA.cjs +32 -0
  133. package/dist/config-CoNMTnMA.cjs.map +1 -0
  134. package/dist/config-Cwj8-C1J.js +5 -5
  135. package/dist/config-D3jisfdj.cjs +20 -20
  136. package/dist/config-D4GifZQ4.js +5 -5
  137. package/dist/config-DDrSQGpQ.cjs +20 -20
  138. package/dist/config-DEcslxan.cjs +20 -20
  139. package/dist/config-DMNZ2YLV.cjs +20 -20
  140. package/dist/config-De9oQ6Ki.js +5 -5
  141. package/dist/config-DoHx0Xsl.js +16 -0
  142. package/dist/config-DoHx0Xsl.js.map +1 -0
  143. package/dist/config-DokTzpr8.cjs +20 -20
  144. package/dist/config-DslYBm4Z.js +5 -5
  145. package/dist/config-H6FAqbW4.cjs +20 -20
  146. package/dist/config-Yp645dGK.js +5 -5
  147. package/dist/config-ispAzOZV.js +5 -5
  148. package/dist/config.d.cts +72 -0
  149. package/dist/config.d.ts +72 -0
  150. package/dist/constants.d.cts +13 -0
  151. package/dist/constants.d.ts +13 -0
  152. package/dist/core/Cubit.d.ts +14 -4
  153. package/dist/core/StateContainer.d.ts +111 -11
  154. package/dist/core/StateContainerRegistry.d.ts +55 -11
  155. package/dist/core/symbols.d.ts +26 -0
  156. package/dist/debug.cjs +3 -3
  157. package/dist/debug.js +3 -3
  158. package/dist/decorators/blac.d.ts +17 -0
  159. package/dist/ensure-9VEq5H0L.js +3 -3
  160. package/dist/ensure-BB6xHQAF.cjs +14 -0
  161. package/dist/ensure-BB6xHQAF.cjs.map +1 -0
  162. package/dist/ensure-BNDfTzqg.cjs +8 -8
  163. package/dist/ensure-BVCnjU7r.js +343 -267
  164. package/dist/ensure-BbzGXjep.cjs +8 -8
  165. package/dist/ensure-BlIaQai6.js +9 -0
  166. package/dist/ensure-BlIaQai6.js.map +1 -0
  167. package/dist/ensure-Bm3oHxga.js +9 -0
  168. package/dist/ensure-Bm3oHxga.js.map +1 -0
  169. package/dist/ensure-C3eIRs6e.cjs +8 -8
  170. package/dist/ensure-CJZL7bcA.cjs +365 -292
  171. package/dist/ensure-CN6unBOe.cjs +8 -8
  172. package/dist/ensure-CU-B1ywv.js +3 -3
  173. package/dist/ensure-CWKzeno7.js +3 -3
  174. package/dist/ensure-CkENsuQ9.js +9 -0
  175. package/dist/ensure-CkENsuQ9.js.map +1 -0
  176. package/dist/ensure-Cm-4_LSh.cjs +14 -0
  177. package/dist/ensure-Cm-4_LSh.cjs.map +1 -0
  178. package/dist/ensure-Cqex5r1P.cjs +14 -0
  179. package/dist/ensure-Cqex5r1P.cjs.map +1 -0
  180. package/dist/ensure-Cv5AbNGZ.js +9 -0
  181. package/dist/ensure-Cv5AbNGZ.js.map +1 -0
  182. package/dist/ensure-D63lEMUK.cjs +8 -8
  183. package/dist/ensure-DGEtPU9A.cjs +8 -8
  184. package/dist/ensure-DM3qb336.cjs +14 -0
  185. package/dist/ensure-DM3qb336.cjs.map +1 -0
  186. package/dist/ensure-DME-_T0j.cjs +8 -8
  187. package/dist/ensure-DWd0GCYB.js +3 -3
  188. package/dist/ensure-DamKOP6q.cjs +8 -8
  189. package/dist/ensure-Dcfptl-A.js +9 -0
  190. package/dist/ensure-Dcfptl-A.js.map +1 -0
  191. package/dist/ensure-Def-EBWG.js +3 -3
  192. package/dist/ensure-DnHL5QiQ.cjs +14 -0
  193. package/dist/ensure-DnHL5QiQ.cjs.map +1 -0
  194. package/dist/ensure-Dr7I78Ku.cjs +8 -8
  195. package/dist/ensure-SLVdGd5b.js +3 -3
  196. package/dist/ensure-Sb92MCXu.js +3 -3
  197. package/dist/ensure-gFlvevGm.cjs +14 -0
  198. package/dist/ensure-gFlvevGm.cjs.map +1 -0
  199. package/dist/ensure-l2-H7S5W.js +3 -3
  200. package/dist/ensure-mkL-3qh8.js +9 -0
  201. package/dist/ensure-mkL-3qh8.js.map +1 -0
  202. package/dist/ensure-n80crSlX.js +3 -3
  203. package/dist/ensure-nCxg7MCN.js +3 -3
  204. package/dist/ensure-vS71MV4q.cjs +8 -8
  205. package/dist/index.cjs +37 -14
  206. package/dist/index.cjs.map +1 -1
  207. package/dist/index.d.cts +14 -4
  208. package/dist/index.d.ts +14 -4
  209. package/dist/index.js +23 -10
  210. package/dist/index.js.map +1 -1
  211. package/dist/management-6oQbmf0z.js +41 -0
  212. package/dist/management-6oQbmf0z.js.map +1 -0
  213. package/dist/management-B46QwA9Y.js +20 -11
  214. package/dist/management-B9yrRpeg.js +41 -0
  215. package/dist/management-B9yrRpeg.js.map +1 -0
  216. package/dist/management-BCKTEZ8Q.js +20 -11
  217. package/dist/management-BbMzdXbT.js +41 -0
  218. package/dist/management-BbMzdXbT.js.map +1 -0
  219. package/dist/management-Bg652agq.js +20 -11
  220. package/dist/management-BnedF5ZD.cjs +50 -50
  221. package/dist/management-BoUa99eB.cjs +79 -0
  222. package/dist/management-BoUa99eB.cjs.map +1 -0
  223. package/dist/management-C4SHcrJm.cjs +79 -0
  224. package/dist/management-C4SHcrJm.cjs.map +1 -0
  225. package/dist/management-CK-GL3wY.js +20 -11
  226. package/dist/management-CPhgY8OE.js +41 -0
  227. package/dist/management-CPhgY8OE.js.map +1 -0
  228. package/dist/management-CU_V3LIP.js +20 -11
  229. package/dist/management-CUwXDSi9.cjs +79 -0
  230. package/dist/management-CUwXDSi9.cjs.map +1 -0
  231. package/dist/management-CaqiyNzB.js +20 -11
  232. package/dist/management-Cin-JvYe.js +20 -11
  233. package/dist/management-ClaXym0F.cjs +50 -50
  234. package/dist/management-DL0Uzsoz.js +20 -11
  235. package/dist/management-DLdAQfqk.cjs +79 -0
  236. package/dist/management-DLdAQfqk.cjs.map +1 -0
  237. package/dist/management-DMZ8qpwr.cjs +50 -50
  238. package/dist/management-DTzcC6aD.cjs +79 -0
  239. package/dist/management-DTzcC6aD.cjs.map +1 -0
  240. package/dist/management-DYLNyj9p.cjs +50 -50
  241. package/dist/management-Dag9u4t6.cjs +50 -50
  242. package/dist/management-DbMRdDBo.cjs +50 -50
  243. package/dist/management-DfnDAKmP.js +41 -0
  244. package/dist/management-DfnDAKmP.js.map +1 -0
  245. package/dist/management-DjBU1gtb.cjs +50 -50
  246. package/dist/management-DwCozsY8.js +20 -11
  247. package/dist/management-H4m3ciJO.js +32 -0
  248. package/dist/management-H4m3ciJO.js.map +1 -0
  249. package/dist/management-Xo3A6Za3.cjs +79 -0
  250. package/dist/management-Xo3A6Za3.cjs.map +1 -0
  251. package/dist/management-ZU2YzOkr.js +18 -10
  252. package/dist/management-baPDwA9n.cjs +50 -50
  253. package/dist/management-jQGCvZNN.cjs +44 -44
  254. package/dist/management-ry_KteFK.cjs +50 -50
  255. package/dist/plugin/BlacPlugin.d.ts +89 -15
  256. package/dist/plugin/PluginManager.d.ts +65 -5
  257. package/dist/plugins.cjs +1 -1
  258. package/dist/plugins.d.cts +2 -2
  259. package/dist/plugins.d.ts +2 -2
  260. package/dist/plugins.js +1 -1
  261. package/dist/registry/acquire.d.ts +9 -2
  262. package/dist/registry/ensure.d.ts +2 -2
  263. package/dist/registry/index.d.ts +1 -1
  264. package/dist/resolve-dependencies-B2QggQAi.js +641 -558
  265. package/dist/resolve-dependencies-B6JDXvpr.js +651 -566
  266. package/dist/resolve-dependencies-BAKAoD0U.js +878 -0
  267. package/dist/resolve-dependencies-BAKAoD0U.js.map +1 -0
  268. package/dist/resolve-dependencies-BFZQq60Y.cjs +724 -666
  269. package/dist/resolve-dependencies-BGafS3Ww.js +643 -561
  270. package/dist/resolve-dependencies-BHd34gS3.cjs +724 -666
  271. package/dist/resolve-dependencies-BNeayhbQ.cjs +732 -671
  272. package/dist/resolve-dependencies-BWEMpuDy.js +641 -558
  273. package/dist/resolve-dependencies-BiWkW2eS.js +643 -561
  274. package/dist/resolve-dependencies-BjxCztYD.js +739 -0
  275. package/dist/resolve-dependencies-BjxCztYD.js.map +1 -0
  276. package/dist/resolve-dependencies-BlyBV0hB.cjs +969 -0
  277. package/dist/resolve-dependencies-BlyBV0hB.cjs.map +1 -0
  278. package/dist/resolve-dependencies-By26rT_i.js +651 -566
  279. package/dist/resolve-dependencies-C9Kf7AzY.cjs +724 -666
  280. package/dist/resolve-dependencies-CTzV1txG.js +643 -561
  281. package/dist/resolve-dependencies-CWjuGHiF.cjs +969 -0
  282. package/dist/resolve-dependencies-CWjuGHiF.cjs.map +1 -0
  283. package/dist/resolve-dependencies-ClSsP0DJ.cjs +722 -663
  284. package/dist/resolve-dependencies-D0vTzZgs.js +643 -561
  285. package/dist/resolve-dependencies-D2WnZMF-.cjs +724 -666
  286. package/dist/resolve-dependencies-DCBLTeza.cjs +969 -0
  287. package/dist/resolve-dependencies-DCBLTeza.cjs.map +1 -0
  288. package/dist/resolve-dependencies-DMlqYJR2.js +643 -561
  289. package/dist/resolve-dependencies-DP6U1EYB.cjs +840 -0
  290. package/dist/resolve-dependencies-DP6U1EYB.cjs.map +1 -0
  291. package/dist/resolve-dependencies-DSQNXvnV.cjs +724 -666
  292. package/dist/resolve-dependencies-DV3HO_uH.js +878 -0
  293. package/dist/resolve-dependencies-DV3HO_uH.js.map +1 -0
  294. package/dist/resolve-dependencies-DXwMhP0Y.js +878 -0
  295. package/dist/resolve-dependencies-DXwMhP0Y.js.map +1 -0
  296. package/dist/resolve-dependencies-DbRWlt9u.js +878 -0
  297. package/dist/resolve-dependencies-DbRWlt9u.js.map +1 -0
  298. package/dist/resolve-dependencies-DcUUva2P.cjs +724 -666
  299. package/dist/resolve-dependencies-Dd8T6TLt.cjs +724 -666
  300. package/dist/resolve-dependencies-Dfdp_DZd.cjs +732 -671
  301. package/dist/resolve-dependencies-GJ8PNyNB.cjs +969 -0
  302. package/dist/resolve-dependencies-GJ8PNyNB.cjs.map +1 -0
  303. package/dist/resolve-dependencies-KSpTt4jy.cjs +722 -663
  304. package/dist/resolve-dependencies-Nvjp4CwS.js +643 -561
  305. package/dist/resolve-dependencies-f-QUqYiL.js +643 -561
  306. package/dist/testing.cjs +27 -20
  307. package/dist/testing.cjs.map +1 -1
  308. package/dist/testing.d.cts +22 -1
  309. package/dist/testing.d.ts +22 -1
  310. package/dist/testing.js +27 -21
  311. package/dist/testing.js.map +1 -1
  312. package/dist/tracked-B77j2g9M.js +171 -151
  313. package/dist/tracked-BDVi2LKM.cjs +196 -175
  314. package/dist/tracked-BFdJCzL0.cjs +242 -0
  315. package/dist/tracked-BFdJCzL0.cjs.map +1 -0
  316. package/dist/tracked-BH-gX4T1.cjs +196 -175
  317. package/dist/tracked-BTHok3Dl.cjs +196 -175
  318. package/dist/tracked-BTbFkFeM.js +186 -166
  319. package/dist/tracked-BU_OBWqM.cjs +242 -0
  320. package/dist/tracked-BU_OBWqM.cjs.map +1 -0
  321. package/dist/tracked-BfctH2es.cjs +242 -0
  322. package/dist/tracked-BfctH2es.cjs.map +1 -0
  323. package/dist/tracked-BhQtzUhZ.js +186 -166
  324. package/dist/tracked-BnqrYXiO.js +212 -0
  325. package/dist/tracked-BnqrYXiO.js.map +1 -0
  326. package/dist/tracked-BtgFOGup.js +212 -0
  327. package/dist/tracked-BtgFOGup.js.map +1 -0
  328. package/dist/tracked-C3nIS4J7.cjs +242 -0
  329. package/dist/tracked-C3nIS4J7.cjs.map +1 -0
  330. package/dist/tracked-C52awNV9.js +171 -151
  331. package/dist/tracked-CGzduF2m.js +186 -166
  332. package/dist/tracked-CK_-ixtX.cjs +196 -175
  333. package/dist/tracked-CLlvURln.js +186 -166
  334. package/dist/tracked-CgHWmuGC.cjs +211 -190
  335. package/dist/tracked-CoAlC8fs.js +171 -151
  336. package/dist/tracked-D3Xjm1H1.cjs +211 -190
  337. package/dist/tracked-DB6yMV5F.js +212 -0
  338. package/dist/tracked-DB6yMV5F.js.map +1 -0
  339. package/dist/tracked-DBn-bs_G.js +171 -151
  340. package/dist/tracked-DMBTDF0P.js +171 -151
  341. package/dist/tracked-DN3h3Rp1.js +171 -151
  342. package/dist/tracked-DOGh1Q5Z.cjs +242 -0
  343. package/dist/tracked-DOGh1Q5Z.cjs.map +1 -0
  344. package/dist/tracked-DUkp4zve.cjs +196 -175
  345. package/dist/tracked-D_ou7mYG.js +212 -0
  346. package/dist/tracked-D_ou7mYG.js.map +1 -0
  347. package/dist/tracked-Dcu6EATB.js +171 -151
  348. package/dist/tracked-GvAJQVAI.cjs +227 -196
  349. package/dist/tracked-O2lv-kJV.cjs +211 -190
  350. package/dist/tracked-WF6aXuAo.js +186 -162
  351. package/dist/tracked-d_sQWU3c.cjs +196 -175
  352. package/dist/tracked-n9TMK-30.cjs +196 -175
  353. package/dist/tracked-njU-_pVa.cjs +211 -190
  354. package/dist/tracked-zAgmKIlC.js +212 -0
  355. package/dist/tracked-zAgmKIlC.js.map +1 -0
  356. package/dist/tracking/dependency-manager.d.ts +33 -29
  357. package/dist/tracking/index.d.ts +16 -1
  358. package/dist/tracking/iteration-perf.bench.d.ts +1 -0
  359. package/dist/tracking/path-utils.d.ts +18 -1
  360. package/dist/tracking/resolve-dependencies.d.ts +3 -1
  361. package/dist/tracking/tracked.d.ts +37 -34
  362. package/dist/tracking/tracking-proxy.d.ts +94 -47
  363. package/dist/tracking.cjs +12 -9
  364. package/dist/tracking.js +32 -2
  365. package/dist/types/utilities.d.ts +15 -3
  366. package/dist/types.cjs +1 -1
  367. package/dist/types.js +1 -1
  368. package/dist/utils/static-props.d.ts +14 -0
  369. package/dist/utils/structural-key.d.ts +14 -0
  370. package/dist/watch/watch.d.ts +1 -1
  371. package/dist/watch-BpwaUL8r.cjs +68 -0
  372. package/dist/watch-BpwaUL8r.cjs.map +1 -0
  373. package/dist/watch-DWCqXllW.js +57 -0
  374. package/dist/watch-DWCqXllW.js.map +1 -0
  375. package/dist/watch-entry.cjs +3 -6
  376. package/dist/watch-entry.d.cts +1 -3
  377. package/dist/watch-entry.d.ts +1 -3
  378. package/dist/watch-entry.js +2 -2
  379. package/package.json +4 -14
@@ -0,0 +1,758 @@
1
+ //#region src/constants.ts
2
+ /**
3
+ * Default configuration constants for BlaC
4
+ *
5
+ * Centralized location for all magic numbers and default values.
6
+ */
7
+ /**
8
+ * Default configuration constants for BlaC
9
+ */
10
+ const BLAC_DEFAULTS = {
11
+ DEFAULT_INSTANCE_KEY: 'default',
12
+ MAX_GETTER_DEPTH: 10,
13
+ };
14
+ /**
15
+ * Static property names for StateContainer classes
16
+ * Used for feature flags and configuration on bloc classes
17
+ */
18
+ const BLAC_STATIC_PROPS = {
19
+ KEEP_ALIVE: 'keepAlive',
20
+ EXCLUDE_FROM_DEVTOOLS: '__excludeFromDevTools',
21
+ ISOLATED: 'isolated',
22
+ EQUALITY: '__equality',
23
+ };
24
+ /**
25
+ * Standard error message prefix
26
+ */
27
+ const BLAC_ERROR_PREFIX = '[BlaC]';
28
+ //#endregion
29
+ //#region src/plugin/PluginManager.ts
30
+ /**
31
+ * Manages plugin lifecycle for the BlaC state management system.
32
+ * Plugins receive notifications about state container lifecycle events.
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * const manager = createPluginManager(registry);
37
+ * manager.install(myPlugin, { environment: 'development' });
38
+ * ```
39
+ */
40
+ var PluginManager = class {
41
+ /**
42
+ * Create a new PluginManager
43
+ * @param registry - The StateContainerRegistry to monitor for lifecycle events
44
+ */
45
+ constructor(registry) {
46
+ this.plugins = /* @__PURE__ */ new Map();
47
+ this.lifecycleUnsubscribers = [];
48
+ this.registry = registry;
49
+ this.setupLifecycleHooks();
50
+ }
51
+ /**
52
+ * Install a plugin with optional configuration
53
+ * @param plugin - The plugin to install
54
+ * @param config - Optional plugin configuration
55
+ * @throws Error if plugin is already installed
56
+ */
57
+ install(plugin, config = {}) {
58
+ const effectiveConfig = {
59
+ enabled: true,
60
+ environment: 'all',
61
+ ...config,
62
+ };
63
+ if (!this.shouldEnablePlugin(effectiveConfig)) {
64
+ console.log(
65
+ `[BlaC] Plugin "${plugin.name}" skipped (environment mismatch)`,
66
+ );
67
+ return;
68
+ }
69
+ if (this.plugins.has(plugin.name))
70
+ throw new Error(`Plugin "${plugin.name}" is already installed`);
71
+ const context = this.createPluginContext();
72
+ this.plugins.set(plugin.name, {
73
+ plugin,
74
+ config: effectiveConfig,
75
+ context,
76
+ });
77
+ if (plugin.onInstall)
78
+ try {
79
+ plugin.onInstall(context);
80
+ } catch (error) {
81
+ console.error(
82
+ `[BlaC] Error installing plugin "${plugin.name}":`,
83
+ error,
84
+ );
85
+ this.plugins.delete(plugin.name);
86
+ throw error;
87
+ }
88
+ console.log(`[BlaC] Plugin "${plugin.name}" v${plugin.version} installed`);
89
+ }
90
+ /**
91
+ * Uninstall a plugin by name
92
+ * @param pluginName - The name of the plugin to uninstall
93
+ * @throws Error if plugin is not installed
94
+ */
95
+ uninstall(pluginName) {
96
+ const installed = this.plugins.get(pluginName);
97
+ if (!installed) throw new Error(`Plugin "${pluginName}" is not installed`);
98
+ if (installed.plugin.onUninstall)
99
+ try {
100
+ installed.plugin.onUninstall();
101
+ } catch (error) {
102
+ console.error(
103
+ `[BlaC] Error uninstalling plugin "${pluginName}":`,
104
+ error,
105
+ );
106
+ }
107
+ this.plugins.delete(pluginName);
108
+ console.log(`[BlaC] Plugin "${pluginName}" uninstalled`);
109
+ }
110
+ /**
111
+ * Get an installed plugin by name
112
+ * @param pluginName - The name of the plugin to retrieve
113
+ * @returns The plugin instance or undefined if not found
114
+ */
115
+ getPlugin(pluginName) {
116
+ return this.plugins.get(pluginName)?.plugin;
117
+ }
118
+ /**
119
+ * Get all installed plugins
120
+ * @returns Array of all installed plugins
121
+ */
122
+ getAllPlugins() {
123
+ return Array.from(this.plugins.values()).map((p) => p.plugin);
124
+ }
125
+ /**
126
+ * Check if a plugin is installed
127
+ * @param pluginName - The name of the plugin to check
128
+ * @returns true if the plugin is installed
129
+ */
130
+ hasPlugin(pluginName) {
131
+ return this.plugins.has(pluginName);
132
+ }
133
+ /**
134
+ * Uninstall all plugins
135
+ */
136
+ clear() {
137
+ for (const name of this.plugins.keys()) this.uninstall(name);
138
+ }
139
+ destroy() {
140
+ this.clear();
141
+ for (const unsub of this.lifecycleUnsubscribers) unsub();
142
+ this.lifecycleUnsubscribers = [];
143
+ }
144
+ /**
145
+ * Setup lifecycle hooks to notify plugins
146
+ */
147
+ setupLifecycleHooks() {
148
+ this.lifecycleUnsubscribers = [
149
+ this.registry.on('created', (instance) => {
150
+ this.notifyPlugins('onInstanceCreated', instance);
151
+ }),
152
+ this.registry.on(
153
+ 'stateChanged',
154
+ (instance, previousState, currentState) => {
155
+ this.notifyPlugins(
156
+ 'onStateChanged',
157
+ instance,
158
+ previousState,
159
+ currentState,
160
+ );
161
+ },
162
+ ),
163
+ this.registry.on('disposed', (instance) => {
164
+ this.notifyPlugins('onInstanceDisposed', instance);
165
+ }),
166
+ this.registry.on('refAcquired', (instance, refId) => {
167
+ this.notifyPlugins('onRefAcquired', instance, refId);
168
+ }),
169
+ this.registry.on('refReleased', (instance, refId) => {
170
+ this.notifyPlugins('onRefReleased', instance, refId);
171
+ }),
172
+ ];
173
+ }
174
+ /**
175
+ * Notify all plugins of a lifecycle event
176
+ */
177
+ notifyPlugins(hookName, ...args) {
178
+ for (const { plugin, config, context } of this.plugins.values()) {
179
+ if (!config.enabled) continue;
180
+ const hook = plugin[hookName];
181
+ if (typeof hook === 'function')
182
+ try {
183
+ hook.apply(plugin, [...args, context]);
184
+ } catch (error) {
185
+ console.error(
186
+ `[BlaC] Error in plugin "${plugin.name}" ${hookName}:`,
187
+ error,
188
+ );
189
+ }
190
+ }
191
+ }
192
+ /**
193
+ * Create plugin context with safe API access
194
+ */
195
+ createPluginContext() {
196
+ return {
197
+ getInstanceMetadata: (instance) => {
198
+ return {
199
+ id: instance.instanceId,
200
+ className: instance.constructor.name,
201
+ isDisposed: instance.isDisposed,
202
+ name: instance.name,
203
+ createdAt: instance.createdAt,
204
+ state: instance.state,
205
+ hydrationStatus: instance.hydrationStatus,
206
+ isHydrated: instance.isHydrated,
207
+ hydrationError: instance.hydrationError,
208
+ changedWhileHydrating: instance.changedWhileHydrating,
209
+ };
210
+ },
211
+ getState: (instance) => {
212
+ return instance.state;
213
+ },
214
+ getHydrationStatus: (instance) => {
215
+ return instance.hydrationStatus;
216
+ },
217
+ startHydration: (instance) => {
218
+ instance.beginHydration();
219
+ },
220
+ applyHydratedState: (instance, state) => {
221
+ return instance.applyHydratedState(state);
222
+ },
223
+ finishHydration: (instance) => {
224
+ instance.finishHydration();
225
+ },
226
+ failHydration: (instance, error) => {
227
+ instance.failHydration(error);
228
+ },
229
+ waitForHydration: (instance) => {
230
+ return instance.waitForHydration();
231
+ },
232
+ queryInstances: (typeClass) => {
233
+ return this.registry.getAll(typeClass);
234
+ },
235
+ getAllTypes: () => {
236
+ return this.registry.getTypes();
237
+ },
238
+ getStats: () => {
239
+ return this.registry.getStats();
240
+ },
241
+ getRefIds: (instanceId) => {
242
+ for (const Type of this.registry.getTypes()) {
243
+ const map = this.registry.getInstancesMap(Type);
244
+ for (const [, entry] of map)
245
+ if (entry.instance.instanceId === instanceId)
246
+ return Array.from(entry.refs.keys());
247
+ }
248
+ return [];
249
+ },
250
+ };
251
+ }
252
+ /**
253
+ * Check if plugin should be enabled based on environment
254
+ */
255
+ shouldEnablePlugin(config) {
256
+ if (!config.enabled) return false;
257
+ if (config.environment === 'all') return true;
258
+ return this.getCurrentEnvironment() === config.environment;
259
+ }
260
+ /**
261
+ * Get current environment
262
+ */
263
+ getCurrentEnvironment() {
264
+ if (typeof process !== 'undefined') {
265
+ if (process.env.NODE_ENV === 'test') return 'test';
266
+ if (process.env.NODE_ENV === 'production') return 'production';
267
+ return 'development';
268
+ }
269
+ return 'development';
270
+ }
271
+ };
272
+ /**
273
+ * Create a plugin manager instance
274
+ * @param registry - The StateContainerRegistry to monitor for lifecycle events
275
+ * @returns A new PluginManager instance
276
+ */
277
+ function createPluginManager(registry) {
278
+ return new PluginManager(registry);
279
+ }
280
+ //#endregion
281
+ //#region src/utils/static-props.ts
282
+ /**
283
+ * Utility functions for accessing static properties on StateContainer classes
284
+ */
285
+ /**
286
+ * Get a static property from a class constructor
287
+ * Type-safe helper that avoids (Type as any) casts
288
+ *
289
+ * @param Type - The class constructor
290
+ * @param propName - The property name to access
291
+ * @param defaultValue - Optional default value if property is undefined
292
+ * @returns The property value or default
293
+ */
294
+ function getStaticProp(Type, propName, defaultValue) {
295
+ return Type[propName] ?? defaultValue;
296
+ }
297
+ /**
298
+ * Check if a class is marked as keepAlive.
299
+ * KeepAlive classes are never auto-disposed when ref count reaches 0.
300
+ * @param Type - The class constructor to check
301
+ * @returns true if the class has `static keepAlive = true`
302
+ */
303
+ function isKeepAliveClass(Type) {
304
+ return getStaticProp(Type, BLAC_STATIC_PROPS.KEEP_ALIVE) === true;
305
+ }
306
+ /**
307
+ * Check if a class should be excluded from DevTools.
308
+ * Used to prevent infinite loops when DevTools tracks itself.
309
+ * @param Type - The class constructor to check
310
+ * @returns true if the class has `static __excludeFromDevTools = true`
311
+ */
312
+ function isExcludedFromDevTools(Type) {
313
+ return getStaticProp(Type, BLAC_STATIC_PROPS.EXCLUDE_FROM_DEVTOOLS) === true;
314
+ }
315
+ /**
316
+ * Check if a class is marked as isolated.
317
+ * Isolated classes get a fresh, per-mount instance from `useBloc`
318
+ * (auto-keyed via React's `useId()`), instead of sharing the default
319
+ * instance with sibling call sites.
320
+ * @param Type - The class constructor to check
321
+ * @returns true if the class has `static isolated = true`
322
+ */
323
+ function isIsolatedClass(Type) {
324
+ return getStaticProp(Type, BLAC_STATIC_PROPS.ISOLATED) === true;
325
+ }
326
+ /**
327
+ * Get the per-class equality function set via `@blac({ equality })`, if any.
328
+ * @param Type - The class constructor to check
329
+ * @returns the equality function or `undefined`
330
+ */
331
+ function getClassEquality(Type) {
332
+ const fn = getStaticProp(Type, BLAC_STATIC_PROPS.EQUALITY);
333
+ return typeof fn === 'function' ? fn : void 0;
334
+ }
335
+ //#endregion
336
+ //#region src/core/StateContainerRegistry.ts
337
+ /**
338
+ * Central registry for managing StateContainer instances.
339
+ * Handles instance lifecycle, named ref tracking, and lifecycle event emission.
340
+ *
341
+ * @example
342
+ * ```ts
343
+ * const registry = new StateContainerRegistry();
344
+ * const instance = registry.acquire(MyBloc); // ownership, must release
345
+ * const other = registry.ensure(OtherBloc); // no ownership, bloc-to-bloc
346
+ * registry.on('stateChanged', (container, prev, next) => {
347
+ * console.log('State changed:', prev, '->', next);
348
+ * });
349
+ * ```
350
+ */
351
+ var StateContainerRegistry = class {
352
+ constructor() {
353
+ this.instancesByConstructor = /* @__PURE__ */ new WeakMap();
354
+ this.types = /* @__PURE__ */ new Set();
355
+ this.registeredTypeNames = /* @__PURE__ */ new Set();
356
+ this.listeners = /* @__PURE__ */ new Map();
357
+ this._stateChangedListenerCount = 0;
358
+ this._pendingStateChanges = null;
359
+ this._autoRefIdCounter = 0;
360
+ }
361
+ get hasStateChangedListeners() {
362
+ return this._stateChangedListenerCount > 0;
363
+ }
364
+ /**
365
+ * Register a type for lifecycle event tracking
366
+ * @param constructor - The StateContainer class constructor
367
+ */
368
+ registerType(constructor) {
369
+ this.types.add(constructor);
370
+ }
371
+ /**
372
+ * Register a StateContainer class with configuration
373
+ * @param constructor - The StateContainer class constructor
374
+ * @throws Error if type is already registered
375
+ */
376
+ register(constructor) {
377
+ const className = constructor.name;
378
+ if (this.registeredTypeNames.has(className))
379
+ throw new Error(
380
+ `${BLAC_ERROR_PREFIX} Type "${className}" is already registered`,
381
+ );
382
+ this.registeredTypeNames.add(className);
383
+ this.registerType(constructor);
384
+ }
385
+ ensureInstancesMap(Type) {
386
+ let instances = this.instancesByConstructor.get(Type);
387
+ if (!instances) {
388
+ instances = /* @__PURE__ */ new Map();
389
+ this.instancesByConstructor.set(Type, instances);
390
+ }
391
+ return instances;
392
+ }
393
+ /**
394
+ * Get the instances Map for a specific class (public API for stats/debugging)
395
+ */
396
+ getInstancesMap(Type) {
397
+ return this.instancesByConstructor.get(Type) || /* @__PURE__ */ new Map();
398
+ }
399
+ /**
400
+ * Acquire an instance with ref tracking (ownership semantics).
401
+ * Creates a new instance if one doesn't exist, or returns existing and adds a ref.
402
+ * You must call `release()` with the same refId when done.
403
+ * @param Type - The StateContainer class constructor
404
+ * @param instanceKey - Instance key (defaults to 'default')
405
+ * @param options - Acquisition options
406
+ * @param options.canCreate - Whether to create new instance if not found (default: true)
407
+ * @param options.countRef - Whether to add a reference (default: true)
408
+ * @param options.refId - Named reference ID for debugging; auto-generated if omitted
409
+ * @returns The state container instance
410
+ */
411
+ acquire(
412
+ Type,
413
+ instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,
414
+ options = {},
415
+ ) {
416
+ const { canCreate = true, countRef = true } = options;
417
+ const config = { instanceId: instanceKey };
418
+ const instances = this.ensureInstancesMap(Type);
419
+ let entry = instances.get(instanceKey);
420
+ if (entry?.instance.isDisposed) {
421
+ instances.delete(instanceKey);
422
+ entry = void 0;
423
+ }
424
+ if (entry && countRef) {
425
+ const refId = options.refId ?? `_auto_${this._autoRefIdCounter++}`;
426
+ entry.refs.set(refId, (entry.refs.get(refId) ?? 0) + 1);
427
+ this.emit('refAcquired', entry.instance, refId);
428
+ }
429
+ if (entry) return entry.instance;
430
+ if (!canCreate)
431
+ throw new Error(
432
+ `${BLAC_ERROR_PREFIX} ${Type.name} instance "${instanceKey}" not found and creation is disabled.`,
433
+ );
434
+ const instance = new Type();
435
+ instance.initConfig(config);
436
+ const initialRefs = /* @__PURE__ */ new Map();
437
+ let initialRefId;
438
+ if (countRef) {
439
+ initialRefId = options.refId ?? `_auto_${this._autoRefIdCounter++}`;
440
+ initialRefs.set(initialRefId, 1);
441
+ }
442
+ instances.set(instanceKey, {
443
+ instance,
444
+ refs: initialRefs,
445
+ });
446
+ this.registerType(Type);
447
+ if (initialRefId) this.emit('refAcquired', instance, initialRefId);
448
+ return instance;
449
+ }
450
+ /**
451
+ * Borrow an existing instance without adding a ref (borrowing semantics).
452
+ * Tracks cross-bloc dependency for reactive updates.
453
+ * @param Type - The StateContainer class constructor
454
+ * @param instanceKey - Instance key (defaults to 'default')
455
+ * @returns The state container instance
456
+ * @throws Error if instance doesn't exist
457
+ */
458
+ borrow(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
459
+ return this.acquire(Type, instanceKey, {
460
+ canCreate: false,
461
+ countRef: false,
462
+ });
463
+ }
464
+ /**
465
+ * Safely borrow an existing instance (borrowing semantics with error handling).
466
+ * Returns discriminated union for type-safe conditional access.
467
+ * @param Type - The StateContainer class constructor
468
+ * @param instanceKey - Instance key (defaults to 'default')
469
+ * @returns Discriminated union with either the instance or an error
470
+ */
471
+ borrowSafe(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
472
+ try {
473
+ return {
474
+ error: null,
475
+ instance: this.borrow(Type, instanceKey),
476
+ };
477
+ } catch (error) {
478
+ return {
479
+ error,
480
+ instance: null,
481
+ };
482
+ }
483
+ }
484
+ /**
485
+ * Ensure an instance exists without taking ownership (for bloc-to-bloc communication).
486
+ * Gets existing instance OR creates it if it doesn't exist, without adding a ref.
487
+ * Tracks cross-bloc dependency for reactive updates.
488
+ *
489
+ * Use this in bloc-to-bloc communication when you need to ensure an instance exists
490
+ * but don't want to claim ownership (no ref added).
491
+ * @param Type - The StateContainer class constructor
492
+ * @param instanceKey - Instance key (defaults to 'default')
493
+ * @returns The state container instance
494
+ */
495
+ ensure(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
496
+ return this.acquire(Type, instanceKey, {
497
+ canCreate: true,
498
+ countRef: false,
499
+ });
500
+ }
501
+ /**
502
+ * Release a reference to an instance.
503
+ * Removes the ref and disposes when refs is empty (unless keepAlive).
504
+ * Releasing an already-removed refId is a no-op (idempotent).
505
+ * @param Type - The StateContainer class constructor
506
+ * @param instanceKey - Instance key (defaults to 'default')
507
+ * @param forceDispose - Force immediate disposal regardless of refs
508
+ * @param refId - The specific ref to remove; removes one arbitrary ref if omitted
509
+ */
510
+ release(
511
+ Type,
512
+ instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY,
513
+ forceDispose = false,
514
+ refId,
515
+ ) {
516
+ const instances = this.ensureInstancesMap(Type);
517
+ const entry = instances.get(instanceKey);
518
+ if (!entry) return;
519
+ if (forceDispose) {
520
+ if (!entry.instance.isDisposed) entry.instance.dispose();
521
+ instances.delete(instanceKey);
522
+ return;
523
+ }
524
+ let releasedRefId;
525
+ if (refId !== void 0) {
526
+ const count = entry.refs.get(refId) ?? 0;
527
+ if (count <= 1) entry.refs.delete(refId);
528
+ else entry.refs.set(refId, count - 1);
529
+ releasedRefId = refId;
530
+ } else {
531
+ const firstKey = entry.refs.keys().next().value;
532
+ if (firstKey !== void 0) {
533
+ const count = entry.refs.get(firstKey) ?? 0;
534
+ if (count <= 1) entry.refs.delete(firstKey);
535
+ else entry.refs.set(firstKey, count - 1);
536
+ releasedRefId = firstKey;
537
+ }
538
+ }
539
+ if (releasedRefId) this.emit('refReleased', entry.instance, releasedRefId);
540
+ const keepAlive = isKeepAliveClass(Type);
541
+ if (entry.refs.size === 0 && !keepAlive) {
542
+ const deps = entry.instance.dependencies;
543
+ if (!entry.instance.isDisposed) entry.instance.dispose();
544
+ instances.delete(instanceKey);
545
+ for (const [DepType, depKey] of deps) {
546
+ const depInstances = this.ensureInstancesMap(DepType);
547
+ const depEntry = depInstances.get(depKey);
548
+ if (
549
+ depEntry &&
550
+ depEntry.refs.size === 0 &&
551
+ !isKeepAliveClass(DepType) &&
552
+ !depEntry.instance.isDisposed
553
+ ) {
554
+ depEntry.instance.dispose();
555
+ depInstances.delete(depKey);
556
+ }
557
+ }
558
+ }
559
+ }
560
+ /**
561
+ * Get all instances of a specific type.
562
+ * @param Type - The StateContainer class constructor
563
+ * @returns Array of all instances
564
+ */
565
+ getAll(Type) {
566
+ const instances = this.ensureInstancesMap(Type);
567
+ const result = [];
568
+ for (const entry of instances.values()) result.push(entry.instance);
569
+ return result;
570
+ }
571
+ /**
572
+ * Safely iterate over all instances of a type.
573
+ * Skips disposed instances and catches callback errors.
574
+ * @param Type - The StateContainer class constructor
575
+ * @param callback - Function to call for each instance
576
+ */
577
+ forEach(Type, callback) {
578
+ const instances = this.ensureInstancesMap(Type);
579
+ for (const entry of instances.values()) {
580
+ const instance = entry.instance;
581
+ if (!instance.isDisposed)
582
+ try {
583
+ callback(instance);
584
+ } catch (error) {
585
+ console.error(
586
+ `${BLAC_ERROR_PREFIX} forEach callback error for ${Type.name}:`,
587
+ error,
588
+ );
589
+ }
590
+ }
591
+ }
592
+ /**
593
+ * Clear all instances of a specific type (disposes them).
594
+ * @param Type - The StateContainer class constructor
595
+ */
596
+ clear(Type) {
597
+ const instances = this.ensureInstancesMap(Type);
598
+ for (const entry of instances.values())
599
+ if (!entry.instance.isDisposed) entry.instance.dispose();
600
+ instances.clear();
601
+ }
602
+ /**
603
+ * Get reference count for an instance (number of active refs).
604
+ * @param Type - The StateContainer class constructor
605
+ * @param instanceKey - Instance key (defaults to 'default')
606
+ * @returns Current ref count (0 if instance doesn't exist)
607
+ */
608
+ getRefCount(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
609
+ return this.ensureInstancesMap(Type).get(instanceKey)?.refs.size ?? 0;
610
+ }
611
+ /**
612
+ * Get all active reference IDs for an instance.
613
+ * @param Type - The StateContainer class constructor
614
+ * @param instanceKey - Instance key (defaults to 'default')
615
+ * @returns Array of ref ID strings (empty if instance doesn't exist)
616
+ */
617
+ getRefIds(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
618
+ const instances = this.instancesByConstructor.get(Type);
619
+ if (!instances) return [];
620
+ const entry = instances.get(instanceKey);
621
+ return entry ? Array.from(entry.refs.keys()) : [];
622
+ }
623
+ /**
624
+ * Check if an instance exists.
625
+ * @param Type - The StateContainer class constructor
626
+ * @param instanceKey - Instance key (defaults to 'default')
627
+ * @returns true if instance exists
628
+ */
629
+ hasInstance(Type, instanceKey = BLAC_DEFAULTS.DEFAULT_INSTANCE_KEY) {
630
+ return this.ensureInstancesMap(Type).has(instanceKey);
631
+ }
632
+ /**
633
+ * Clear all instances from all types (for testing)
634
+ *
635
+ * Iterates all registered types and clears their instances.
636
+ * Also clears type tracking to reset the registry state.
637
+ */
638
+ clearAll() {
639
+ for (const Type of this.types) this.clear(Type);
640
+ this.types.clear();
641
+ this.registeredTypeNames.clear();
642
+ }
643
+ /**
644
+ * Get registry statistics for debugging.
645
+ * @returns Object with registeredTypes, totalInstances, and typeBreakdown
646
+ */
647
+ getStats() {
648
+ const typeBreakdown = {};
649
+ let totalInstances = 0;
650
+ for (const Type of this.types) {
651
+ const typeName = Type.name;
652
+ const count = this.getInstancesMap(Type).size;
653
+ typeBreakdown[typeName] = count;
654
+ totalInstances += count;
655
+ }
656
+ return {
657
+ registeredTypes: this.types.size,
658
+ totalInstances,
659
+ typeBreakdown,
660
+ };
661
+ }
662
+ /**
663
+ * Get all registered types (for plugin system).
664
+ * @returns Array of all registered StateContainer class constructors
665
+ */
666
+ getTypes() {
667
+ return Array.from(this.types);
668
+ }
669
+ /**
670
+ * Subscribe to lifecycle events
671
+ * @param event - The lifecycle event to listen for
672
+ * @param listener - The listener function to call when the event occurs
673
+ * @returns Unsubscribe function
674
+ */
675
+ on(event, listener) {
676
+ if (!this.listeners.has(event))
677
+ this.listeners.set(event, /* @__PURE__ */ new Set());
678
+ const instance = this.listeners.get(event);
679
+ if (!instance)
680
+ throw new Error(
681
+ `${BLAC_ERROR_PREFIX} Failed to register listener for event '${event}'`,
682
+ );
683
+ instance.add(listener);
684
+ if (event === 'stateChanged') this._stateChangedListenerCount++;
685
+ return () => {
686
+ if (
687
+ this.listeners.get(event)?.delete(listener) &&
688
+ event === 'stateChanged'
689
+ )
690
+ this._stateChangedListenerCount--;
691
+ };
692
+ }
693
+ emit(event, ...args) {
694
+ const listeners = this.listeners.get(event);
695
+ if (!listeners || listeners.size === 0) return;
696
+ for (const listener of listeners)
697
+ try {
698
+ listener(...args);
699
+ } catch (error) {
700
+ console.error(
701
+ `${BLAC_ERROR_PREFIX} Listener error for '${event}':`,
702
+ error,
703
+ );
704
+ }
705
+ }
706
+ /**
707
+ * Schedule a deferred stateChanged notification via microtask.
708
+ * Skips entirely when no stateChanged listeners are registered.
709
+ * @internal - Called by StateContainer.applyState
710
+ */
711
+ notifyStateChanged(container, previousState, newState) {
712
+ if (this._stateChangedListenerCount === 0) return;
713
+ if (!this._pendingStateChanges) {
714
+ this._pendingStateChanges = [];
715
+ queueMicrotask(() => this.flushStateChanged());
716
+ }
717
+ this._pendingStateChanges.push([container, previousState, newState]);
718
+ }
719
+ flushStateChanged() {
720
+ const pending = this._pendingStateChanges;
721
+ this._pendingStateChanges = null;
722
+ if (!pending) return;
723
+ for (const [container, prev, next] of pending)
724
+ this.emit('stateChanged', container, prev, next);
725
+ }
726
+ };
727
+ /**
728
+ * Global default registry instance
729
+ */
730
+ const globalRegistry = new StateContainerRegistry();
731
+ /**
732
+ * Global plugin manager (initialized lazily)
733
+ */
734
+ let _globalPluginManager = null;
735
+ /**
736
+ * Get the global plugin manager
737
+ */
738
+ function getPluginManager() {
739
+ if (!_globalPluginManager)
740
+ _globalPluginManager = createPluginManager(globalRegistry);
741
+ return _globalPluginManager;
742
+ }
743
+ //#endregion
744
+ export {
745
+ isExcludedFromDevTools as a,
746
+ PluginManager as c,
747
+ BLAC_STATIC_PROPS as d,
748
+ getClassEquality as i,
749
+ BLAC_DEFAULTS as l,
750
+ getPluginManager as n,
751
+ isIsolatedClass as o,
752
+ globalRegistry as r,
753
+ isKeepAliveClass as s,
754
+ StateContainerRegistry as t,
755
+ BLAC_ERROR_PREFIX as u,
756
+ };
757
+
758
+ //# sourceMappingURL=StateContainerRegistry-C0E7vsgy.js.map