@bquery/bquery 1.2.0 → 1.4.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 (309) hide show
  1. package/README.md +127 -27
  2. package/dist/batch-x7b2eZST.js +13 -0
  3. package/dist/batch-x7b2eZST.js.map +1 -0
  4. package/dist/component/component.d.ts +69 -0
  5. package/dist/component/component.d.ts.map +1 -0
  6. package/dist/component/html.d.ts +35 -0
  7. package/dist/component/html.d.ts.map +1 -0
  8. package/dist/component/index.d.ts +3 -126
  9. package/dist/component/index.d.ts.map +1 -1
  10. package/dist/component/props.d.ts +18 -0
  11. package/dist/component/props.d.ts.map +1 -0
  12. package/dist/component/types.d.ts +77 -0
  13. package/dist/component/types.d.ts.map +1 -0
  14. package/dist/component.es.mjs +90 -59
  15. package/dist/component.es.mjs.map +1 -1
  16. package/dist/core/collection.d.ts +55 -3
  17. package/dist/core/collection.d.ts.map +1 -1
  18. package/dist/core/dom.d.ts +6 -0
  19. package/dist/core/dom.d.ts.map +1 -0
  20. package/dist/core/element.d.ts +31 -4
  21. package/dist/core/element.d.ts.map +1 -1
  22. package/dist/core/index.d.ts +2 -0
  23. package/dist/core/index.d.ts.map +1 -1
  24. package/dist/core/utils/array.d.ts +74 -0
  25. package/dist/core/utils/array.d.ts.map +1 -0
  26. package/dist/core/utils/function.d.ts +87 -0
  27. package/dist/core/utils/function.d.ts.map +1 -0
  28. package/dist/core/utils/index.d.ts +70 -0
  29. package/dist/core/utils/index.d.ts.map +1 -0
  30. package/dist/core/utils/misc.d.ts +63 -0
  31. package/dist/core/utils/misc.d.ts.map +1 -0
  32. package/dist/core/utils/number.d.ts +65 -0
  33. package/dist/core/utils/number.d.ts.map +1 -0
  34. package/dist/core/utils/object.d.ts +133 -0
  35. package/dist/core/utils/object.d.ts.map +1 -0
  36. package/dist/core/utils/string.d.ts +80 -0
  37. package/dist/core/utils/string.d.ts.map +1 -0
  38. package/dist/core/utils/type-guards.d.ts +79 -0
  39. package/dist/core/utils/type-guards.d.ts.map +1 -0
  40. package/dist/core-BhpuvPhy.js +170 -0
  41. package/dist/core-BhpuvPhy.js.map +1 -0
  42. package/dist/core.es.mjs +495 -489
  43. package/dist/core.es.mjs.map +1 -1
  44. package/dist/full.d.ts +2 -2
  45. package/dist/full.d.ts.map +1 -1
  46. package/dist/full.es.mjs +87 -64
  47. package/dist/full.es.mjs.map +1 -1
  48. package/dist/full.iife.js +2 -2
  49. package/dist/full.iife.js.map +1 -1
  50. package/dist/full.umd.js +2 -2
  51. package/dist/full.umd.js.map +1 -1
  52. package/dist/index.es.mjs +138 -68
  53. package/dist/index.es.mjs.map +1 -1
  54. package/dist/motion/animate.d.ts +25 -0
  55. package/dist/motion/animate.d.ts.map +1 -0
  56. package/dist/motion/easing.d.ts +30 -0
  57. package/dist/motion/easing.d.ts.map +1 -0
  58. package/dist/motion/flip.d.ts +55 -0
  59. package/dist/motion/flip.d.ts.map +1 -0
  60. package/dist/motion/index.d.ts +11 -138
  61. package/dist/motion/index.d.ts.map +1 -1
  62. package/dist/motion/keyframes.d.ts +21 -0
  63. package/dist/motion/keyframes.d.ts.map +1 -0
  64. package/dist/motion/reduced-motion.d.ts +12 -0
  65. package/dist/motion/reduced-motion.d.ts.map +1 -0
  66. package/dist/motion/scroll.d.ts +15 -0
  67. package/dist/motion/scroll.d.ts.map +1 -0
  68. package/dist/motion/spring.d.ts +42 -0
  69. package/dist/motion/spring.d.ts.map +1 -0
  70. package/dist/motion/stagger.d.ts +22 -0
  71. package/dist/motion/stagger.d.ts.map +1 -0
  72. package/dist/motion/timeline.d.ts +21 -0
  73. package/dist/motion/timeline.d.ts.map +1 -0
  74. package/dist/motion/transition.d.ts +22 -0
  75. package/dist/motion/transition.d.ts.map +1 -0
  76. package/dist/motion/types.d.ts +182 -0
  77. package/dist/motion/types.d.ts.map +1 -0
  78. package/dist/motion.es.mjs +320 -61
  79. package/dist/motion.es.mjs.map +1 -1
  80. package/dist/persisted-DHoi3uEs.js +278 -0
  81. package/dist/persisted-DHoi3uEs.js.map +1 -0
  82. package/dist/platform/storage.d.ts.map +1 -1
  83. package/dist/platform.es.mjs +12 -7
  84. package/dist/platform.es.mjs.map +1 -1
  85. package/dist/reactive/batch.d.ts +13 -0
  86. package/dist/reactive/batch.d.ts.map +1 -0
  87. package/dist/reactive/computed.d.ts +50 -0
  88. package/dist/reactive/computed.d.ts.map +1 -0
  89. package/dist/reactive/core.d.ts +72 -0
  90. package/dist/reactive/core.d.ts.map +1 -0
  91. package/dist/reactive/effect.d.ts +15 -0
  92. package/dist/reactive/effect.d.ts.map +1 -0
  93. package/dist/reactive/index.d.ts +2 -2
  94. package/dist/reactive/index.d.ts.map +1 -1
  95. package/dist/reactive/internals.d.ts +42 -0
  96. package/dist/reactive/internals.d.ts.map +1 -0
  97. package/dist/reactive/linked.d.ts +36 -0
  98. package/dist/reactive/linked.d.ts.map +1 -0
  99. package/dist/reactive/persisted.d.ts +14 -0
  100. package/dist/reactive/persisted.d.ts.map +1 -0
  101. package/dist/reactive/readonly.d.ts +26 -0
  102. package/dist/reactive/readonly.d.ts.map +1 -0
  103. package/dist/reactive/signal.d.ts +13 -312
  104. package/dist/reactive/signal.d.ts.map +1 -1
  105. package/dist/reactive/type-guards.d.ts +20 -0
  106. package/dist/reactive/type-guards.d.ts.map +1 -0
  107. package/dist/reactive/untrack.d.ts +29 -0
  108. package/dist/reactive/untrack.d.ts.map +1 -0
  109. package/dist/reactive/watch.d.ts +42 -0
  110. package/dist/reactive/watch.d.ts.map +1 -0
  111. package/dist/reactive.es.mjs +30 -163
  112. package/dist/reactive.es.mjs.map +1 -1
  113. package/dist/router/index.d.ts +6 -252
  114. package/dist/router/index.d.ts.map +1 -1
  115. package/dist/router/links.d.ts +44 -0
  116. package/dist/router/links.d.ts.map +1 -0
  117. package/dist/router/match.d.ts +20 -0
  118. package/dist/router/match.d.ts.map +1 -0
  119. package/dist/router/navigation.d.ts +45 -0
  120. package/dist/router/navigation.d.ts.map +1 -0
  121. package/dist/router/query.d.ts +16 -0
  122. package/dist/router/query.d.ts.map +1 -0
  123. package/dist/router/router.d.ts +34 -0
  124. package/dist/router/router.d.ts.map +1 -0
  125. package/dist/router/state.d.ts +27 -0
  126. package/dist/router/state.d.ts.map +1 -0
  127. package/dist/router/types.d.ts +88 -0
  128. package/dist/router/types.d.ts.map +1 -0
  129. package/dist/router/utils.d.ts +65 -0
  130. package/dist/router/utils.d.ts.map +1 -0
  131. package/dist/router.es.mjs +168 -132
  132. package/dist/router.es.mjs.map +1 -1
  133. package/dist/sanitize-Cxvxa-DX.js +283 -0
  134. package/dist/sanitize-Cxvxa-DX.js.map +1 -0
  135. package/dist/security/constants.d.ts +42 -0
  136. package/dist/security/constants.d.ts.map +1 -0
  137. package/dist/security/csp.d.ts +24 -0
  138. package/dist/security/csp.d.ts.map +1 -0
  139. package/dist/security/index.d.ts +4 -2
  140. package/dist/security/index.d.ts.map +1 -1
  141. package/dist/security/sanitize-core.d.ts +13 -0
  142. package/dist/security/sanitize-core.d.ts.map +1 -0
  143. package/dist/security/sanitize.d.ts +5 -57
  144. package/dist/security/sanitize.d.ts.map +1 -1
  145. package/dist/security/trusted-types.d.ts +25 -0
  146. package/dist/security/trusted-types.d.ts.map +1 -0
  147. package/dist/security/types.d.ts +36 -0
  148. package/dist/security/types.d.ts.map +1 -0
  149. package/dist/security.es.mjs +50 -277
  150. package/dist/security.es.mjs.map +1 -1
  151. package/dist/store/create-store.d.ts +15 -0
  152. package/dist/store/create-store.d.ts.map +1 -0
  153. package/dist/store/define-store.d.ts +28 -0
  154. package/dist/store/define-store.d.ts.map +1 -0
  155. package/dist/store/devtools.d.ts +22 -0
  156. package/dist/store/devtools.d.ts.map +1 -0
  157. package/dist/store/index.d.ts +10 -286
  158. package/dist/store/index.d.ts.map +1 -1
  159. package/dist/store/mapping.d.ts +28 -0
  160. package/dist/store/mapping.d.ts.map +1 -0
  161. package/dist/store/persisted.d.ts +13 -0
  162. package/dist/store/persisted.d.ts.map +1 -0
  163. package/dist/store/plugins.d.ts +13 -0
  164. package/dist/store/plugins.d.ts.map +1 -0
  165. package/dist/store/registry.d.ts +28 -0
  166. package/dist/store/registry.d.ts.map +1 -0
  167. package/dist/store/types.d.ts +71 -0
  168. package/dist/store/types.d.ts.map +1 -0
  169. package/dist/store/utils.d.ts +28 -0
  170. package/dist/store/utils.d.ts.map +1 -0
  171. package/dist/store/watch.d.ts +23 -0
  172. package/dist/store/watch.d.ts.map +1 -0
  173. package/dist/store.es.mjs +22 -224
  174. package/dist/store.es.mjs.map +1 -1
  175. package/dist/type-guards-BdKlYYlS.js +32 -0
  176. package/dist/type-guards-BdKlYYlS.js.map +1 -0
  177. package/dist/untrack-DNnnqdlR.js +6 -0
  178. package/dist/untrack-DNnnqdlR.js.map +1 -0
  179. package/dist/view/directives/bind.d.ts +7 -0
  180. package/dist/view/directives/bind.d.ts.map +1 -0
  181. package/dist/view/directives/class.d.ts +8 -0
  182. package/dist/view/directives/class.d.ts.map +1 -0
  183. package/dist/view/directives/for.d.ts +23 -0
  184. package/dist/view/directives/for.d.ts.map +1 -0
  185. package/dist/view/directives/html.d.ts +7 -0
  186. package/dist/view/directives/html.d.ts.map +1 -0
  187. package/dist/view/directives/if.d.ts +7 -0
  188. package/dist/view/directives/if.d.ts.map +1 -0
  189. package/dist/view/directives/index.d.ts +12 -0
  190. package/dist/view/directives/index.d.ts.map +1 -0
  191. package/dist/view/directives/model.d.ts +7 -0
  192. package/dist/view/directives/model.d.ts.map +1 -0
  193. package/dist/view/directives/on.d.ts +7 -0
  194. package/dist/view/directives/on.d.ts.map +1 -0
  195. package/dist/view/directives/ref.d.ts +7 -0
  196. package/dist/view/directives/ref.d.ts.map +1 -0
  197. package/dist/view/directives/show.d.ts +7 -0
  198. package/dist/view/directives/show.d.ts.map +1 -0
  199. package/dist/view/directives/style.d.ts +7 -0
  200. package/dist/view/directives/style.d.ts.map +1 -0
  201. package/dist/view/directives/text.d.ts +7 -0
  202. package/dist/view/directives/text.d.ts.map +1 -0
  203. package/dist/view/evaluate.d.ts +43 -0
  204. package/dist/view/evaluate.d.ts.map +1 -0
  205. package/dist/view/index.d.ts +3 -93
  206. package/dist/view/index.d.ts.map +1 -1
  207. package/dist/view/mount.d.ts +69 -0
  208. package/dist/view/mount.d.ts.map +1 -0
  209. package/dist/view/process.d.ts +26 -0
  210. package/dist/view/process.d.ts.map +1 -0
  211. package/dist/view/types.d.ts +36 -0
  212. package/dist/view/types.d.ts.map +1 -0
  213. package/dist/view.es.mjs +358 -251
  214. package/dist/view.es.mjs.map +1 -1
  215. package/dist/watch-DXXv3iAI.js +58 -0
  216. package/dist/watch-DXXv3iAI.js.map +1 -0
  217. package/package.json +14 -14
  218. package/src/component/component.ts +289 -0
  219. package/src/component/html.ts +53 -0
  220. package/src/component/index.ts +40 -414
  221. package/src/component/props.ts +116 -0
  222. package/src/component/types.ts +85 -0
  223. package/src/core/collection.ts +181 -7
  224. package/src/core/dom.ts +38 -0
  225. package/src/core/element.ts +59 -25
  226. package/src/core/index.ts +48 -4
  227. package/src/core/utils/array.ts +102 -0
  228. package/src/core/utils/function.ts +151 -0
  229. package/src/core/utils/index.ts +83 -0
  230. package/src/core/utils/misc.ts +82 -0
  231. package/src/core/utils/number.ts +78 -0
  232. package/src/core/utils/object.ts +206 -0
  233. package/src/core/utils/string.ts +112 -0
  234. package/src/core/utils/type-guards.ts +112 -0
  235. package/src/full.ts +187 -150
  236. package/src/index.ts +36 -36
  237. package/src/motion/animate.ts +113 -0
  238. package/src/motion/easing.ts +40 -0
  239. package/src/motion/flip.ts +176 -0
  240. package/src/motion/index.ts +41 -358
  241. package/src/motion/keyframes.ts +46 -0
  242. package/src/motion/reduced-motion.ts +17 -0
  243. package/src/motion/scroll.ts +57 -0
  244. package/src/motion/spring.ts +150 -0
  245. package/src/motion/stagger.ts +43 -0
  246. package/src/motion/timeline.ts +246 -0
  247. package/src/motion/transition.ts +51 -0
  248. package/src/motion/types.ts +198 -0
  249. package/src/platform/storage.ts +215 -208
  250. package/src/reactive/batch.ts +22 -0
  251. package/src/reactive/computed.ts +92 -0
  252. package/src/reactive/core.ts +114 -0
  253. package/src/reactive/effect.ts +54 -0
  254. package/src/reactive/index.ts +23 -22
  255. package/src/reactive/internals.ts +122 -0
  256. package/src/reactive/linked.ts +56 -0
  257. package/src/reactive/persisted.ts +74 -0
  258. package/src/reactive/readonly.ts +35 -0
  259. package/src/reactive/signal.ts +20 -520
  260. package/src/reactive/type-guards.ts +22 -0
  261. package/src/reactive/untrack.ts +31 -0
  262. package/src/reactive/watch.ts +73 -0
  263. package/src/router/index.ts +41 -718
  264. package/src/router/links.ts +130 -0
  265. package/src/router/match.ts +106 -0
  266. package/src/router/navigation.ts +71 -0
  267. package/src/router/query.ts +35 -0
  268. package/src/router/router.ts +211 -0
  269. package/src/router/state.ts +46 -0
  270. package/src/router/types.ts +93 -0
  271. package/src/router/utils.ts +116 -0
  272. package/src/security/constants.ts +209 -0
  273. package/src/security/csp.ts +77 -0
  274. package/src/security/index.ts +4 -12
  275. package/src/security/sanitize-core.ts +364 -0
  276. package/src/security/sanitize.ts +66 -625
  277. package/src/security/trusted-types.ts +69 -0
  278. package/src/security/types.ts +40 -0
  279. package/src/store/create-store.ts +329 -0
  280. package/src/store/define-store.ts +48 -0
  281. package/src/store/devtools.ts +45 -0
  282. package/src/store/index.ts +22 -848
  283. package/src/store/mapping.ts +73 -0
  284. package/src/store/persisted.ts +61 -0
  285. package/src/store/plugins.ts +32 -0
  286. package/src/store/registry.ts +51 -0
  287. package/src/store/types.ts +94 -0
  288. package/src/store/utils.ts +141 -0
  289. package/src/store/watch.ts +52 -0
  290. package/src/view/directives/bind.ts +23 -0
  291. package/src/view/directives/class.ts +70 -0
  292. package/src/view/directives/for.ts +275 -0
  293. package/src/view/directives/html.ts +19 -0
  294. package/src/view/directives/if.ts +30 -0
  295. package/src/view/directives/index.ts +11 -0
  296. package/src/view/directives/model.ts +56 -0
  297. package/src/view/directives/on.ts +41 -0
  298. package/src/view/directives/ref.ts +41 -0
  299. package/src/view/directives/show.ts +26 -0
  300. package/src/view/directives/style.ts +47 -0
  301. package/src/view/directives/text.ts +15 -0
  302. package/src/view/evaluate.ts +290 -0
  303. package/src/view/index.ts +112 -1041
  304. package/src/view/mount.ts +200 -0
  305. package/src/view/process.ts +92 -0
  306. package/src/view/types.ts +44 -0
  307. package/dist/core/utils.d.ts +0 -313
  308. package/dist/core/utils.d.ts.map +0 -1
  309. package/src/core/utils.ts +0 -444
@@ -1,318 +1,19 @@
1
1
  /**
2
2
  * Reactive primitives inspired by fine-grained reactivity.
3
3
  *
4
- * This module provides a minimal but powerful reactive system:
5
- * - Signal: A reactive value that notifies subscribers when changed
6
- * - Computed: A derived value that automatically updates when dependencies change
7
- * - Effect: A side effect that re-runs when its dependencies change
8
- * - Batch: Group multiple updates to prevent intermediate re-renders
9
- *
10
4
  * @module bquery/reactive
11
- *
12
- * @example
13
- * ```ts
14
- * const count = signal(0);
15
- * const doubled = computed(() => count.value * 2);
16
- *
17
- * effect(() => {
18
- * console.log(`Count: ${count.value}, Doubled: ${doubled.value}`);
19
- * });
20
- *
21
- * batch(() => {
22
- * count.value = 1;
23
- * count.value = 2;
24
- * });
25
- * // Logs: "Count: 2, Doubled: 4" (only once due to batching)
26
- * ```
27
- */
28
- /**
29
- * Observer function type used internally for tracking reactivity.
30
- */
31
- export type Observer = () => void;
32
- /**
33
- * Cleanup function returned by effects for disposal.
34
- */
35
- export type CleanupFn = () => void;
36
- /**
37
- * A reactive value container that notifies subscribers on change.
38
- *
39
- * Signals are the foundational primitive of the reactive system.
40
- * Reading a signal's value inside an effect or computed automatically
41
- * establishes a reactive dependency.
42
- *
43
- * @template T - The type of the stored value
44
- *
45
- * @example
46
- * ```ts
47
- * const name = signal('World');
48
- * console.log(name.value); // 'World'
49
- *
50
- * name.value = 'bQuery';
51
- * console.log(name.value); // 'bQuery'
52
- * ```
53
- */
54
- export declare class Signal<T> {
55
- private _value;
56
- private subscribers;
57
- /**
58
- * Creates a new signal with an initial value.
59
- * @param _value - The initial value
60
- */
61
- constructor(_value: T);
62
- /**
63
- * Gets the current value and tracks the read if inside an observer.
64
- * Respects the global tracking state (disabled during untrack calls).
65
- */
66
- get value(): T;
67
- /**
68
- * Sets a new value and notifies all subscribers if the value changed.
69
- * Uses Object.is for equality comparison.
70
- */
71
- set value(next: T);
72
- /**
73
- * Reads the current value without tracking.
74
- * Useful when you need the value but don't want to create a dependency.
75
- *
76
- * @returns The current value
77
- */
78
- peek(): T;
79
- /**
80
- * Updates the value using a function.
81
- * Useful for updates based on the current value.
82
- *
83
- * @param updater - Function that receives current value and returns new value
84
- */
85
- update(updater: (current: T) => T): void;
86
- }
87
- /**
88
- * A computed value that derives from other reactive sources.
89
- *
90
- * Computed values are lazily evaluated and cached. They only
91
- * recompute when their dependencies change.
92
- *
93
- * @template T - The type of the computed value
94
- *
95
- * @example
96
- * ```ts
97
- * const price = signal(100);
98
- * const quantity = signal(2);
99
- * const total = computed(() => price.value * quantity.value);
100
- *
101
- * console.log(total.value); // 200
102
- * price.value = 150;
103
- * console.log(total.value); // 300
104
- * ```
105
- */
106
- export declare class Computed<T> {
107
- private readonly compute;
108
- private cachedValue;
109
- private dirty;
110
- private subscribers;
111
- private readonly markDirty;
112
- /**
113
- * Creates a new computed value.
114
- * @param compute - Function that computes the value
115
- */
116
- constructor(compute: () => T);
117
- /**
118
- * Gets the computed value, recomputing if dependencies changed.
119
- */
120
- get value(): T;
121
- /**
122
- * Reads the current computed value without tracking.
123
- * Useful when you need the value but don't want to create a dependency.
124
- *
125
- * @returns The current cached value (recomputes if dirty)
126
- */
127
- peek(): T;
128
- }
129
- /**
130
- * Creates a new reactive signal.
131
- *
132
- * @template T - The type of the signal value
133
- * @param value - The initial value
134
- * @returns A new Signal instance
135
- *
136
- * @example
137
- * ```ts
138
- * const count = signal(0);
139
- * count.value++; // Triggers subscribers
140
- * ```
141
- */
142
- export declare const signal: <T>(value: T) => Signal<T>;
143
- /**
144
- * Creates a new computed value.
145
- *
146
- * @template T - The type of the computed value
147
- * @param fn - Function that computes the value from reactive sources
148
- * @returns A new Computed instance
149
- *
150
- * @example
151
- * ```ts
152
- * const doubled = computed(() => count.value * 2);
153
- * ```
154
- */
155
- export declare const computed: <T>(fn: () => T) => Computed<T>;
156
- /**
157
- * Creates a side effect that automatically re-runs when dependencies change.
158
- *
159
- * The effect runs immediately upon creation and then re-runs whenever
160
- * any signal or computed value read inside it changes.
161
- *
162
- * @param fn - The effect function to run
163
- * @returns A cleanup function to stop the effect
164
- *
165
- * @example
166
- * ```ts
167
- * const count = signal(0);
168
- *
169
- * const cleanup = effect(() => {
170
- * document.title = `Count: ${count.value}`;
171
- * });
172
- *
173
- * // Later, to stop the effect:
174
- * cleanup();
175
- * ```
176
- */
177
- export declare const effect: (fn: () => void | CleanupFn) => CleanupFn;
178
- /**
179
- * Batches multiple signal updates into a single notification cycle.
180
- *
181
- * Updates made inside the batch function are deferred until the batch
182
- * completes, preventing intermediate re-renders and improving performance.
183
- *
184
- * @param fn - Function containing multiple signal updates
185
- *
186
- * @example
187
- * ```ts
188
- * batch(() => {
189
- * firstName.value = 'John';
190
- * lastName.value = 'Doe';
191
- * age.value = 30;
192
- * });
193
- * // Effects only run once with all three updates
194
- * ```
195
- */
196
- export declare const batch: (fn: () => void) => void;
197
- /**
198
- * Creates a signal that persists to localStorage.
199
- *
200
- * @template T - The type of the signal value
201
- * @param key - The localStorage key
202
- * @param initialValue - The initial value if not found in storage
203
- * @returns A Signal that syncs with localStorage
204
- *
205
- * @example
206
- * ```ts
207
- * const theme = persistedSignal('theme', 'light');
208
- * theme.value = 'dark'; // Automatically saved to localStorage
209
- * ```
210
- */
211
- export declare const persistedSignal: <T>(key: string, initialValue: T) => Signal<T>;
212
- /**
213
- * A readonly wrapper around a signal that prevents writes.
214
- * Provides read-only access to a signal's value while maintaining reactivity.
215
- *
216
- * @template T - The type of the wrapped value
217
- */
218
- export interface ReadonlySignal<T> {
219
- /** Gets the current value with dependency tracking. */
220
- readonly value: T;
221
- /** Gets the current value without dependency tracking. */
222
- peek(): T;
223
- }
224
- /**
225
- * Creates a read-only view of a signal.
226
- * Useful for exposing reactive state without allowing modifications.
227
- *
228
- * @template T - The type of the signal value
229
- * @param sig - The signal to wrap
230
- * @returns A readonly signal wrapper
231
- *
232
- * @example
233
- * ```ts
234
- * const _count = signal(0);
235
- * const count = readonly(_count); // Expose read-only version
236
- *
237
- * console.log(count.value); // 0
238
- * count.value = 1; // TypeScript error: Cannot assign to 'value'
239
- * ```
240
- */
241
- export declare const readonly: <T>(sig: Signal<T>) => ReadonlySignal<T>;
242
- /**
243
- * Watches a signal or computed value and calls a callback with old and new values.
244
- * Unlike effect, watch provides access to the previous value.
245
- *
246
- * @template T - The type of the watched value
247
- * @param source - The signal or computed to watch
248
- * @param callback - Function called with (newValue, oldValue) on changes
249
- * @param options - Watch options
250
- * @returns A cleanup function to stop watching
251
- *
252
- * @example
253
- * ```ts
254
- * const count = signal(0);
255
- *
256
- * const cleanup = watch(count, (newVal, oldVal) => {
257
- * console.log(`Changed from ${oldVal} to ${newVal}`);
258
- * });
259
- *
260
- * count.value = 5; // Logs: "Changed from 0 to 5"
261
- * cleanup();
262
- * ```
263
- */
264
- export declare const watch: <T>(source: Signal<T> | Computed<T>, callback: (newValue: T, oldValue: T | undefined) => void, options?: {
265
- immediate?: boolean;
266
- }) => CleanupFn;
267
- /**
268
- * Executes a function without tracking any signal dependencies.
269
- * Useful when reading a signal value without creating a reactive dependency.
270
- *
271
- * @template T - The return type of the function
272
- * @param fn - The function to execute without tracking
273
- * @returns The result of the function
274
- *
275
- * @example
276
- * ```ts
277
- * const count = signal(0);
278
- *
279
- * effect(() => {
280
- * // This creates a dependency
281
- * console.log('Tracked:', count.value);
282
- *
283
- * // This does NOT create a dependency
284
- * const untracked = untrack(() => otherSignal.value);
285
- * });
286
- * ```
287
- */
288
- export declare const untrack: <T>(fn: () => T) => T;
289
- /**
290
- * Type guard to check if a value is a Signal instance.
291
- *
292
- * @param value - The value to check
293
- * @returns True if the value is a Signal
294
- *
295
- * @example
296
- * ```ts
297
- * const count = signal(0);
298
- * const num = 42;
299
- *
300
- * isSignal(count); // true
301
- * isSignal(num); // false
302
- * ```
303
- */
304
- export declare const isSignal: (value: unknown) => value is Signal<unknown>;
305
- /**
306
- * Type guard to check if a value is a Computed instance.
307
- *
308
- * @param value - The value to check
309
- * @returns True if the value is a Computed
310
- *
311
- * @example
312
- * ```ts
313
- * const doubled = computed(() => count.value * 2);
314
- * isComputed(doubled); // true
315
- * ```
316
5
  */
317
- export declare const isComputed: (value: unknown) => value is Computed<unknown>;
6
+ export { batch } from './batch';
7
+ export { Computed, computed } from './computed';
8
+ export { Signal, signal } from './core';
9
+ export { effect } from './effect';
10
+ export { linkedSignal } from './linked';
11
+ export { persistedSignal } from './persisted';
12
+ export { readonly } from './readonly';
13
+ export { isComputed, isSignal } from './type-guards';
14
+ export { untrack } from './untrack';
15
+ export { watch } from './watch';
16
+ export type { CleanupFn, Observer } from './internals';
17
+ export type { LinkedSignal } from './linked';
18
+ export type { ReadonlySignal } from './readonly';
318
19
  //# sourceMappingURL=signal.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/reactive/signal.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"signal.d.ts","sourceRoot":"","sources":["../../src/reactive/signal.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
@@ -0,0 +1,20 @@
1
+ /**
2
+ * Type guards for reactive primitives.
3
+ */
4
+ import { Computed } from './computed';
5
+ import { Signal } from './core';
6
+ /**
7
+ * Type guard to check if a value is a Signal instance.
8
+ *
9
+ * @param value - The value to check
10
+ * @returns True if the value is a Signal
11
+ */
12
+ export declare const isSignal: (value: unknown) => value is Signal<unknown>;
13
+ /**
14
+ * Type guard to check if a value is a Computed instance.
15
+ *
16
+ * @param value - The value to check
17
+ * @returns True if the value is a Computed
18
+ */
19
+ export declare const isComputed: (value: unknown) => value is Computed<unknown>;
20
+ //# sourceMappingURL=type-guards.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/reactive/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAA4B,CAAC;AAE9F;;;;;GAKG;AACH,eAAO,MAAM,UAAU,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,QAAQ,CAAC,OAAO,CAA8B,CAAC"}
@@ -0,0 +1,29 @@
1
+ /**
2
+ * Dependency tracking control helpers.
3
+ */
4
+ /**
5
+ * Executes a function without tracking any signal dependencies.
6
+ * Useful when reading a signal value without creating a reactive dependency.
7
+ *
8
+ * This implementation temporarily hides the current observer rather than
9
+ * disabling tracking globally. This ensures that nested reactive internals
10
+ * (e.g., computed recomputation triggered during untrack) can still properly
11
+ * track their own dependencies.
12
+ *
13
+ * @template T - The return type of the function
14
+ * @param fn - The function to execute without tracking
15
+ * @returns The result of the function
16
+ *
17
+ * @example
18
+ * ```ts
19
+ * const count = signal(0);
20
+ * effect(() => {
21
+ * // This read creates a dependency
22
+ * console.log(count.value);
23
+ * // This read does not create a dependency
24
+ * const snapshot = untrack(() => count.value);
25
+ * });
26
+ * ```
27
+ */
28
+ export declare const untrack: <T>(fn: () => T) => T;
29
+ //# sourceMappingURL=untrack.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"untrack.d.ts","sourceRoot":"","sources":["../../src/reactive/untrack.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,IAAI,MAAM,CAAC,KAAG,CAA+B,CAAC"}
@@ -0,0 +1,42 @@
1
+ /**
2
+ * Value watching helpers.
3
+ */
4
+ import type { Computed } from './computed';
5
+ import type { Signal } from './core';
6
+ import type { CleanupFn } from './internals';
7
+ /**
8
+ * Options for the watch function.
9
+ */
10
+ export interface WatchOptions<T> {
11
+ /** If true, the callback is invoked immediately with the current value. */
12
+ immediate?: boolean;
13
+ /** Custom equality function. Defaults to Object.is. */
14
+ equals?: (a: T, b: T | undefined) => boolean;
15
+ }
16
+ /**
17
+ * Watches a signal or computed value and calls a callback with old and new values.
18
+ * Unlike effect, watch provides access to the previous value.
19
+ * The callback is only invoked when the value actually changes (compared via Object.is or custom equals).
20
+ *
21
+ * @template T - The type of the watched value
22
+ * @param source - The signal or computed to watch
23
+ * @param callback - Function called with (newValue, oldValue) on changes
24
+ * @param options - Watch options
25
+ * @returns A cleanup function to stop watching
26
+ *
27
+ * @example
28
+ * ```ts
29
+ * const count = signal(0);
30
+ * watch(count, (newVal, oldVal) => {
31
+ * console.log(`Changed from ${oldVal} to ${newVal}`);
32
+ * });
33
+ *
34
+ * // With custom equality for objects
35
+ * const user = signal({ id: 1, name: 'Alice' });
36
+ * watch(user, (newVal, oldVal) => { ... }, {
37
+ * equals: (a, b) => a?.id === b?.id
38
+ * });
39
+ * ```
40
+ */
41
+ export declare const watch: <T>(source: Signal<T> | Computed<T>, callback: (newValue: T, oldValue: T | undefined) => void, options?: WatchOptions<T>) => CleanupFn;
42
+ //# sourceMappingURL=watch.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/reactive/watch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAI7C;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,SAAS,KAAK,OAAO,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,EACrB,QAAQ,MAAM,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,EAC/B,UAAU,CAAC,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,EACxD,UAAS,YAAY,CAAC,CAAC,CAAM,KAC5B,SAuBF,CAAC"}
@@ -1,169 +1,36 @@
1
- const i = [];
2
- let a = 0;
3
- const l = /* @__PURE__ */ new Set();
4
- let u = !0;
5
- const o = (t, e) => {
6
- i.push(t);
7
- try {
8
- return e();
9
- } finally {
10
- i.pop();
11
- }
12
- }, h = (t) => {
13
- if (a > 0) {
14
- l.add(t);
15
- return;
16
- }
17
- t();
18
- }, p = () => {
19
- for (const t of Array.from(l))
20
- l.delete(t), t();
21
- };
22
- class f {
23
- /**
24
- * Creates a new signal with an initial value.
25
- * @param _value - The initial value
26
- */
27
- constructor(e) {
28
- this._value = e, this.subscribers = /* @__PURE__ */ new Set();
29
- }
30
- /**
31
- * Gets the current value and tracks the read if inside an observer.
32
- * Respects the global tracking state (disabled during untrack calls).
33
- */
34
- get value() {
35
- if (u) {
36
- const e = i[i.length - 1];
37
- e && this.subscribers.add(e);
38
- }
39
- return this._value;
40
- }
41
- /**
42
- * Sets a new value and notifies all subscribers if the value changed.
43
- * Uses Object.is for equality comparison.
44
- */
45
- set value(e) {
46
- if (!Object.is(this._value, e)) {
47
- this._value = e;
48
- for (const s of this.subscribers)
49
- h(s);
1
+ import { c as s } from "./core-BhpuvPhy.js";
2
+ import { C as u, S as l, s as m } from "./core-BhpuvPhy.js";
3
+ import { b as d } from "./batch-x7b2eZST.js";
4
+ import { e as g, i as x, a as S } from "./type-guards-BdKlYYlS.js";
5
+ import { p as v, r as C, w as b } from "./watch-DXXv3iAI.js";
6
+ import { u as w } from "./untrack-DNnnqdlR.js";
7
+ const p = (a, r) => {
8
+ const e = s(a);
9
+ return {
10
+ get value() {
11
+ return e.value;
12
+ },
13
+ set value(t) {
14
+ r(t);
15
+ },
16
+ peek() {
17
+ return e.peek();
50
18
  }
51
- }
52
- /**
53
- * Reads the current value without tracking.
54
- * Useful when you need the value but don't want to create a dependency.
55
- *
56
- * @returns The current value
57
- */
58
- peek() {
59
- return this._value;
60
- }
61
- /**
62
- * Updates the value using a function.
63
- * Useful for updates based on the current value.
64
- *
65
- * @param updater - Function that receives current value and returns new value
66
- */
67
- update(e) {
68
- this.value = e(this._value);
69
- }
70
- }
71
- class d {
72
- /**
73
- * Creates a new computed value.
74
- * @param compute - Function that computes the value
75
- */
76
- constructor(e) {
77
- this.compute = e, this.dirty = !0, this.subscribers = /* @__PURE__ */ new Set(), this.markDirty = () => {
78
- this.dirty = !0;
79
- for (const s of this.subscribers)
80
- h(s);
81
- };
82
- }
83
- /**
84
- * Gets the computed value, recomputing if dependencies changed.
85
- */
86
- get value() {
87
- const e = i[i.length - 1];
88
- return e && this.subscribers.add(e), this.dirty && (this.dirty = !1, this.cachedValue = o(this.markDirty, this.compute)), this.cachedValue;
89
- }
90
- /**
91
- * Reads the current computed value without tracking.
92
- * Useful when you need the value but don't want to create a dependency.
93
- *
94
- * @returns The current cached value (recomputes if dirty)
95
- */
96
- peek() {
97
- return this.dirty && (this.dirty = !1, this.cachedValue = o(this.markDirty, this.compute)), this.cachedValue;
98
- }
99
- }
100
- const v = (t) => new f(t), y = (t) => new d(t), b = (t) => {
101
- let e, s = !1;
102
- const r = () => {
103
- s || (e && e(), e = o(r, t));
104
- };
105
- return r(), () => {
106
- s = !0, e && e();
107
19
  };
108
- }, g = (t) => {
109
- a += 1;
110
- try {
111
- t();
112
- } finally {
113
- a -= 1, a === 0 && p();
114
- }
115
- }, m = (t, e) => {
116
- let s = e;
117
- try {
118
- const n = localStorage.getItem(t);
119
- n !== null && (s = JSON.parse(n));
120
- } catch {
121
- }
122
- const r = v(s);
123
- return b(() => {
124
- try {
125
- localStorage.setItem(t, JSON.stringify(r.value));
126
- } catch {
127
- }
128
- }), r;
129
- }, S = (t) => ({
130
- get value() {
131
- return t.value;
132
- },
133
- peek() {
134
- return t.peek();
135
- }
136
- }), k = (t, e, s = {}) => {
137
- let r, n = !0;
138
- return b(() => {
139
- const c = t.value;
140
- if (n) {
141
- n = !1, r = c, s.immediate && e(c, void 0);
142
- return;
143
- }
144
- e(c, r), r = c;
145
- });
146
- }, w = (t) => {
147
- const e = u;
148
- u = !1;
149
- try {
150
- return t();
151
- } finally {
152
- u = e;
153
- }
154
- }, O = (t) => t instanceof f, V = (t) => t instanceof d;
20
+ };
155
21
  export {
156
- d as Computed,
157
- f as Signal,
158
- g as batch,
159
- y as computed,
160
- b as effect,
161
- V as isComputed,
162
- O as isSignal,
163
- m as persistedSignal,
164
- S as readonly,
165
- v as signal,
22
+ u as Computed,
23
+ l as Signal,
24
+ d as batch,
25
+ s as computed,
26
+ g as effect,
27
+ x as isComputed,
28
+ S as isSignal,
29
+ p as linkedSignal,
30
+ v as persistedSignal,
31
+ C as readonly,
32
+ m as signal,
166
33
  w as untrack,
167
- k as watch
34
+ b as watch
168
35
  };
169
36
  //# sourceMappingURL=reactive.es.mjs.map