@planet-matrix/mobius-model 0.4.0 → 0.6.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 (179) hide show
  1. package/CHANGELOG.md +32 -0
  2. package/README.md +134 -21
  3. package/dist/index.js +45 -4
  4. package/dist/index.js.map +186 -11
  5. package/oxlint.config.ts +6 -0
  6. package/package.json +16 -10
  7. package/src/abort/README.md +92 -0
  8. package/src/abort/abort-manager.ts +278 -0
  9. package/src/abort/abort-signal-listener-manager.ts +81 -0
  10. package/src/abort/index.ts +2 -0
  11. package/src/basic/README.md +69 -117
  12. package/src/basic/enhance.ts +10 -0
  13. package/src/basic/function.ts +81 -62
  14. package/src/basic/index.ts +2 -0
  15. package/src/basic/is.ts +152 -71
  16. package/src/basic/object.ts +82 -0
  17. package/src/basic/promise.ts +29 -8
  18. package/src/basic/string.ts +2 -33
  19. package/src/color/README.md +105 -0
  20. package/src/color/index.ts +3 -0
  21. package/src/color/internal.ts +42 -0
  22. package/src/color/rgb/analyze.ts +236 -0
  23. package/src/color/rgb/construct.ts +130 -0
  24. package/src/color/rgb/convert.ts +227 -0
  25. package/src/color/rgb/derive.ts +303 -0
  26. package/src/color/rgb/index.ts +6 -0
  27. package/src/color/rgb/internal.ts +208 -0
  28. package/src/color/rgb/parse.ts +302 -0
  29. package/src/color/rgb/serialize.ts +144 -0
  30. package/src/color/types.ts +57 -0
  31. package/src/color/xyz/analyze.ts +80 -0
  32. package/src/color/xyz/construct.ts +19 -0
  33. package/src/color/xyz/convert.ts +71 -0
  34. package/src/color/xyz/index.ts +3 -0
  35. package/src/color/xyz/internal.ts +23 -0
  36. package/src/css/README.md +93 -0
  37. package/src/css/class.ts +559 -0
  38. package/src/css/index.ts +1 -0
  39. package/src/encoding/README.md +92 -0
  40. package/src/encoding/base64.ts +107 -0
  41. package/src/encoding/index.ts +1 -0
  42. package/src/environment/README.md +97 -0
  43. package/src/environment/basic.ts +26 -0
  44. package/src/environment/device.ts +311 -0
  45. package/src/environment/feature.ts +285 -0
  46. package/src/environment/geo.ts +337 -0
  47. package/src/environment/index.ts +7 -0
  48. package/src/environment/runtime.ts +400 -0
  49. package/src/environment/snapshot.ts +60 -0
  50. package/src/environment/variable.ts +239 -0
  51. package/src/event/README.md +90 -0
  52. package/src/event/class-event-proxy.ts +228 -0
  53. package/src/event/common.ts +19 -0
  54. package/src/event/event-manager.ts +203 -0
  55. package/src/event/index.ts +4 -0
  56. package/src/event/instance-event-proxy.ts +186 -0
  57. package/src/event/internal.ts +24 -0
  58. package/src/exception/README.md +96 -0
  59. package/src/exception/browser.ts +219 -0
  60. package/src/exception/index.ts +4 -0
  61. package/src/exception/nodejs.ts +169 -0
  62. package/src/exception/normalize.ts +106 -0
  63. package/src/exception/types.ts +99 -0
  64. package/src/identifier/README.md +92 -0
  65. package/src/identifier/id.ts +119 -0
  66. package/src/identifier/index.ts +2 -0
  67. package/src/identifier/uuid.ts +187 -0
  68. package/src/index.ts +18 -1
  69. package/src/log/README.md +79 -0
  70. package/src/log/index.ts +5 -0
  71. package/src/log/log-emitter.ts +72 -0
  72. package/src/log/log-record.ts +10 -0
  73. package/src/log/log-scheduler.ts +74 -0
  74. package/src/log/log-type.ts +8 -0
  75. package/src/log/logger.ts +543 -0
  76. package/src/orchestration/README.md +89 -0
  77. package/src/orchestration/coordination/barrier.ts +214 -0
  78. package/src/orchestration/coordination/count-down-latch.ts +215 -0
  79. package/src/orchestration/coordination/errors.ts +98 -0
  80. package/src/orchestration/coordination/index.ts +16 -0
  81. package/src/orchestration/coordination/internal/wait-constraints.ts +95 -0
  82. package/src/orchestration/coordination/internal/wait-queue.ts +109 -0
  83. package/src/orchestration/coordination/keyed-lock.ts +168 -0
  84. package/src/orchestration/coordination/mutex.ts +257 -0
  85. package/src/orchestration/coordination/permit.ts +127 -0
  86. package/src/orchestration/coordination/read-write-lock.ts +444 -0
  87. package/src/orchestration/coordination/semaphore.ts +280 -0
  88. package/src/orchestration/index.ts +1 -0
  89. package/src/random/README.md +78 -0
  90. package/src/random/index.ts +1 -0
  91. package/src/random/string.ts +35 -0
  92. package/src/reactor/README.md +4 -0
  93. package/src/reactor/reactor-core/primitive.ts +9 -9
  94. package/src/reactor/reactor-core/reactive-system.ts +5 -5
  95. package/src/singleton/README.md +79 -0
  96. package/src/singleton/factory.ts +55 -0
  97. package/src/singleton/index.ts +2 -0
  98. package/src/singleton/manager.ts +204 -0
  99. package/src/storage/README.md +107 -0
  100. package/src/storage/index.ts +1 -0
  101. package/src/storage/table.ts +449 -0
  102. package/src/timer/README.md +86 -0
  103. package/src/timer/expiration/expiration-manager.ts +594 -0
  104. package/src/timer/expiration/index.ts +3 -0
  105. package/src/timer/expiration/min-heap.ts +208 -0
  106. package/src/timer/expiration/remaining-manager.ts +241 -0
  107. package/src/timer/index.ts +1 -0
  108. package/src/type/README.md +54 -307
  109. package/src/type/class.ts +2 -2
  110. package/src/type/index.ts +14 -14
  111. package/src/type/is.ts +265 -2
  112. package/src/type/object.ts +37 -0
  113. package/src/type/string.ts +7 -2
  114. package/src/type/tuple.ts +6 -6
  115. package/src/type/union.ts +16 -0
  116. package/src/web/README.md +77 -0
  117. package/src/web/capture.ts +35 -0
  118. package/src/web/clipboard.ts +97 -0
  119. package/src/web/dom.ts +117 -0
  120. package/src/web/download.ts +16 -0
  121. package/src/web/event.ts +46 -0
  122. package/src/web/index.ts +10 -0
  123. package/src/web/local-storage.ts +113 -0
  124. package/src/web/location.ts +28 -0
  125. package/src/web/permission.ts +172 -0
  126. package/src/web/script-loader.ts +432 -0
  127. package/tests/unit/abort/abort-manager.spec.ts +225 -0
  128. package/tests/unit/abort/abort-signal-listener-manager.spec.ts +62 -0
  129. package/tests/unit/basic/array.spec.ts +1 -1
  130. package/tests/unit/basic/object.spec.ts +32 -1
  131. package/tests/unit/basic/stream.spec.ts +1 -1
  132. package/tests/unit/basic/string.spec.ts +0 -9
  133. package/tests/unit/color/rgb/analyze.spec.ts +110 -0
  134. package/tests/unit/color/rgb/construct.spec.ts +56 -0
  135. package/tests/unit/color/rgb/convert.spec.ts +60 -0
  136. package/tests/unit/color/rgb/derive.spec.ts +103 -0
  137. package/tests/unit/color/rgb/parse.spec.ts +66 -0
  138. package/tests/unit/color/rgb/serialize.spec.ts +46 -0
  139. package/tests/unit/color/xyz/analyze.spec.ts +33 -0
  140. package/tests/unit/color/xyz/construct.spec.ts +10 -0
  141. package/tests/unit/color/xyz/convert.spec.ts +18 -0
  142. package/tests/unit/css/class.spec.ts +157 -0
  143. package/tests/unit/encoding/base64.spec.ts +40 -0
  144. package/tests/unit/environment/basic.spec.ts +20 -0
  145. package/tests/unit/environment/device.spec.ts +146 -0
  146. package/tests/unit/environment/feature.spec.ts +388 -0
  147. package/tests/unit/environment/geo.spec.ts +111 -0
  148. package/tests/unit/environment/runtime.spec.ts +364 -0
  149. package/tests/unit/environment/snapshot.spec.ts +4 -0
  150. package/tests/unit/environment/variable.spec.ts +190 -0
  151. package/tests/unit/event/class-event-proxy.spec.ts +225 -0
  152. package/tests/unit/event/event-manager.spec.ts +246 -0
  153. package/tests/unit/event/instance-event-proxy.spec.ts +187 -0
  154. package/tests/unit/exception/browser.spec.ts +213 -0
  155. package/tests/unit/exception/nodejs.spec.ts +144 -0
  156. package/tests/unit/exception/normalize.spec.ts +57 -0
  157. package/tests/unit/identifier/id.spec.ts +71 -0
  158. package/tests/unit/identifier/uuid.spec.ts +85 -0
  159. package/tests/unit/log/log-emitter.spec.ts +33 -0
  160. package/tests/unit/log/log-scheduler.spec.ts +40 -0
  161. package/tests/unit/log/log-type.spec.ts +7 -0
  162. package/tests/unit/log/logger.spec.ts +222 -0
  163. package/tests/unit/orchestration/coordination/barrier.spec.ts +96 -0
  164. package/tests/unit/orchestration/coordination/count-down-latch.spec.ts +63 -0
  165. package/tests/unit/orchestration/coordination/errors.spec.ts +29 -0
  166. package/tests/unit/orchestration/coordination/keyed-lock.spec.ts +109 -0
  167. package/tests/unit/orchestration/coordination/mutex.spec.ts +132 -0
  168. package/tests/unit/orchestration/coordination/permit.spec.ts +43 -0
  169. package/tests/unit/orchestration/coordination/read-write-lock.spec.ts +154 -0
  170. package/tests/unit/orchestration/coordination/semaphore.spec.ts +135 -0
  171. package/tests/unit/random/string.spec.ts +11 -0
  172. package/tests/unit/reactor/alien-signals-effect.spec.ts +11 -10
  173. package/tests/unit/reactor/preact-signal.spec.ts +1 -2
  174. package/tests/unit/singleton/singleton.spec.ts +49 -0
  175. package/tests/unit/storage/table.spec.ts +620 -0
  176. package/tests/unit/timer/expiration/expiration-manager.spec.ts +464 -0
  177. package/tests/unit/timer/expiration/min-heap.spec.ts +71 -0
  178. package/tests/unit/timer/expiration/remaining-manager.spec.ts +234 -0
  179. package/.oxlintrc.json +0 -5
@@ -0,0 +1,234 @@
1
+ import { expect, test, vi } from "vitest"
2
+
3
+ import { ExpirationManager } from "#Source/timer/index.ts"
4
+
5
+ test("RemainingManager getRemaining only returns seconds for active expirations", () => {
6
+ vi.useFakeTimers()
7
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
8
+
9
+ try {
10
+ const expirationManager = new ExpirationManager<"alpha" | "beta" | "gamma">({
11
+ enableRemainingManager: false,
12
+ })
13
+
14
+ expirationManager.upsertExpiration("alpha", Date.now() + 2_500)
15
+ expirationManager.upsertExpiration("beta", Date.now() - 1)
16
+ expirationManager.upsertExpiration("gamma", Date.now() + 2_500)
17
+ expirationManager.removeExpiration("gamma")
18
+
19
+ expect(expirationManager.remainingManager.getRemaining("alpha")).toBe(3)
20
+ expect(expirationManager.remainingManager.getRemaining("beta")).toBeUndefined()
21
+ expect(expirationManager.remainingManager.getRemaining("gamma")).toBeUndefined()
22
+
23
+ expirationManager.terminate()
24
+ }
25
+ finally {
26
+ vi.clearAllTimers()
27
+ vi.useRealTimers()
28
+ }
29
+ })
30
+
31
+ test("RemainingManager getRemainingSnapshot only includes active expirations", () => {
32
+ vi.useFakeTimers()
33
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
34
+
35
+ try {
36
+ const expirationManager = new ExpirationManager<"alpha" | "beta" | "gamma">({
37
+ enableRemainingManager: false,
38
+ })
39
+
40
+ expirationManager.upsertExpiration("alpha", Date.now() + 1_500)
41
+ expirationManager.upsertExpiration("beta", Date.now() - 1)
42
+ expirationManager.upsertExpiration("gamma", Date.now() + 1_500)
43
+ expirationManager.removeExpiration("gamma")
44
+
45
+ expect(expirationManager.remainingManager.getRemainingSnapshot()).toEqual({ alpha: 2 })
46
+
47
+ expirationManager.terminate()
48
+ }
49
+ finally {
50
+ vi.clearAllTimers()
51
+ vi.useRealTimers()
52
+ }
53
+ })
54
+
55
+ test("RemainingManager emit only publishes changed snapshots", () => {
56
+ vi.useFakeTimers()
57
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
58
+
59
+ try {
60
+ const expirationManager = new ExpirationManager<"alpha">({
61
+ enableRemainingManager: false,
62
+ })
63
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
64
+
65
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
66
+ remainingSnapshots.push({ ...remaining })
67
+ })
68
+
69
+ expirationManager.upsertExpiration("alpha", Date.now() + 2_500)
70
+ expirationManager.remainingManager.emit()
71
+ vi.advanceTimersByTime(1_000)
72
+ expirationManager.remainingManager.emit()
73
+
74
+ expect(remainingSnapshots).toEqual([{ alpha: 3 }, { alpha: 2 }])
75
+
76
+ expirationManager.terminate()
77
+ }
78
+ finally {
79
+ vi.clearAllTimers()
80
+ vi.useRealTimers()
81
+ }
82
+ })
83
+
84
+ test("RemainingManager start enables interval-driven updates", () => {
85
+ vi.useFakeTimers()
86
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
87
+
88
+ try {
89
+ const expirationManager = new ExpirationManager<"alpha">({
90
+ enableRemainingManager: false,
91
+ })
92
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
93
+
94
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
95
+ remainingSnapshots.push({ ...remaining })
96
+ })
97
+
98
+ expirationManager.upsertExpiration("alpha", Date.now() + 2_500)
99
+ vi.advanceTimersByTime(1_000)
100
+
101
+ expect(remainingSnapshots).toEqual([{ alpha: 3 }])
102
+
103
+ expirationManager.remainingManager.start()
104
+ vi.advanceTimersByTime(1_000)
105
+
106
+ expect(remainingSnapshots).toEqual([{ alpha: 3 }, { alpha: 1 }])
107
+
108
+ expirationManager.terminate()
109
+ }
110
+ finally {
111
+ vi.clearAllTimers()
112
+ vi.useRealTimers()
113
+ }
114
+ })
115
+
116
+ test("RemainingManager stop disables interval-driven updates", () => {
117
+ vi.useFakeTimers()
118
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
119
+
120
+ try {
121
+ const expirationManager = new ExpirationManager<"alpha">({
122
+ enableRemainingManager: true,
123
+ })
124
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
125
+
126
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
127
+ remainingSnapshots.push({ ...remaining })
128
+ })
129
+
130
+ expirationManager.upsertExpiration("alpha", Date.now() + 3_500)
131
+ vi.advanceTimersByTime(1_000)
132
+
133
+ expect(remainingSnapshots).toEqual([{ alpha: 4 }, { alpha: 3 }])
134
+
135
+ expirationManager.remainingManager.stop()
136
+ vi.advanceTimersByTime(1_000)
137
+
138
+ expect(remainingSnapshots).toEqual([{ alpha: 4 }, { alpha: 3 }])
139
+
140
+ expirationManager.terminate()
141
+ }
142
+ finally {
143
+ vi.clearAllTimers()
144
+ vi.useRealTimers()
145
+ }
146
+ })
147
+
148
+ test("RemainingManager pause suspends interval-driven updates", () => {
149
+ vi.useFakeTimers()
150
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
151
+
152
+ try {
153
+ const expirationManager = new ExpirationManager<"alpha">({
154
+ enableRemainingManager: true,
155
+ })
156
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
157
+
158
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
159
+ remainingSnapshots.push({ ...remaining })
160
+ })
161
+
162
+ expirationManager.upsertExpiration("alpha", Date.now() + 3_500)
163
+ vi.advanceTimersByTime(1_000)
164
+ expirationManager.remainingManager.pause()
165
+ vi.advanceTimersByTime(1_000)
166
+
167
+ expect(remainingSnapshots).toEqual([{ alpha: 4 }, { alpha: 3 }])
168
+
169
+ expirationManager.terminate()
170
+ }
171
+ finally {
172
+ vi.clearAllTimers()
173
+ vi.useRealTimers()
174
+ }
175
+ })
176
+
177
+ test("RemainingManager resume restarts interval-driven updates after pause", () => {
178
+ vi.useFakeTimers()
179
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
180
+
181
+ try {
182
+ const expirationManager = new ExpirationManager<"alpha">({
183
+ enableRemainingManager: true,
184
+ })
185
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
186
+
187
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
188
+ remainingSnapshots.push({ ...remaining })
189
+ })
190
+
191
+ expirationManager.upsertExpiration("alpha", Date.now() + 3_500)
192
+ expirationManager.remainingManager.pause()
193
+ vi.advanceTimersByTime(1_000)
194
+ expirationManager.remainingManager.resume()
195
+ vi.advanceTimersByTime(1_000)
196
+
197
+ expect(remainingSnapshots).toEqual([{ alpha: 4 }, { alpha: 2 }])
198
+
199
+ expirationManager.terminate()
200
+ }
201
+ finally {
202
+ vi.clearAllTimers()
203
+ vi.useRealTimers()
204
+ }
205
+ })
206
+
207
+ test("RemainingManager terminate stops future emissions", () => {
208
+ vi.useFakeTimers()
209
+ vi.setSystemTime(new Date(2_026, 0, 1, 0, 0, 0))
210
+
211
+ try {
212
+ const expirationManager = new ExpirationManager<"alpha">({
213
+ enableRemainingManager: true,
214
+ })
215
+ const remainingSnapshots: Array<{ alpha?: number | undefined }> = []
216
+
217
+ expirationManager.remainingManager.event.subscribe("remaining", (remaining): void => {
218
+ remainingSnapshots.push({ ...remaining })
219
+ })
220
+
221
+ expirationManager.upsertExpiration("alpha", Date.now() + 3_500)
222
+ expirationManager.remainingManager.terminate()
223
+ vi.advanceTimersByTime(2_000)
224
+ expirationManager.remainingManager.emit()
225
+
226
+ expect(remainingSnapshots).toEqual([{ alpha: 4 }])
227
+
228
+ expirationManager.terminate()
229
+ }
230
+ finally {
231
+ vi.clearAllTimers()
232
+ vi.useRealTimers()
233
+ }
234
+ })
package/.oxlintrc.json DELETED
@@ -1,5 +0,0 @@
1
- {
2
- "extends": [
3
- "./node_modules/@planet-matrix/mobius-mono/src/internals/lint/oxlintrc.json"
4
- ],
5
- }