dsh-plugin-cyrene-live2d 0.2.9 → 0.3.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 (210) hide show
  1. package/README.md +8 -2
  2. package/assets/default-prefs.json +8 -8
  3. package/assets/icon.svg +89 -89
  4. package/assets/locale/notes/en.json +6 -6
  5. package/assets/locale/notes/zh-CN.json +6 -6
  6. package/assets/locale/reminder/en.json +6 -6
  7. package/assets/locale/reminder/zh-CN.json +6 -6
  8. package/assets/model/Cyrene.model3.json +441 -441
  9. package/assets/model/bongo-standard/Live2d_expression0.exp3.json +9 -9
  10. package/assets/model/bongo-standard/cat.cdi3.json +296 -296
  11. package/assets/model/bongo-standard/cat.model3.json +33 -33
  12. package/assets/model/bongo-standard/cat.physics3.json +232 -232
  13. package/assets/model/expressions/0.exp3.json +24 -24
  14. package/assets/model/expressions/1.exp3.json +11 -11
  15. package/assets/model/expressions/10.exp3.json +9 -9
  16. package/assets/model/expressions/11.exp3.json +9 -9
  17. package/assets/model/expressions/2.exp3.json +9 -9
  18. package/assets/model/expressions/3.exp3.json +9 -9
  19. package/assets/model/expressions/4.exp3.json +11 -11
  20. package/assets/model/expressions/5.exp3.json +11 -11
  21. package/assets/model/expressions/6.exp3.json +11 -11
  22. package/assets/model/expressions/7.exp3.json +11 -11
  23. package/assets/model/expressions/8.exp3.json +11 -11
  24. package/assets/model/expressions/9.exp3.json +9 -9
  25. package/assets/model/model.physics3.json +641 -641
  26. package/assets/model/motions/Tick3_3.motion3.json +1347 -1347
  27. package/assets/model/motions//345/212/250/344/275/2346_0.motion3.json +699 -699
  28. package/assets/model/motions//345/212/250/344/275/2346_1.motion3.json +1241 -1241
  29. package/assets/model/motions//345/212/250/344/275/2346_2.motion3.json +1117 -1117
  30. package/assets/model/motions//345/212/250/344/275/2346_3.motion3.json +1106 -1106
  31. package/assets/model/we-q/expressions/FileReferences_Expressions_0_File_0.exp3.json +19 -19
  32. package/assets/model/we-q/expressions/FileReferences_Expressions_1_File_0.exp3.json +41 -41
  33. package/assets/model/we-q/expressions/FileReferences_Expressions_2_File_0.exp3.json +104 -104
  34. package/assets/model/we-q/model0.model3.json +245 -245
  35. package/assets/model/we-q/motions/FileReferences_Motions_shake#1_0_File_0.motion3.json +520 -520
  36. package/assets/model/we-q/motions/FileReferences_Motions_talk#1_0_File_0.motion3.json +499 -499
  37. package/assets/model/we-q/motions/FileReferences_Motions_talk#1_1_File_0.motion3.json +453 -453
  38. package/assets/model/we-q/motions/FileReferences_Motions_wink#1_0_File_0.motion3.json +478 -478
  39. package/assets/model/we-q/motions/FileReferences_Motions_/346/212/254/346/211/213_0_File_0.motion3.json +450 -450
  40. package/assets/model/we-q/motions/FileReferences_Motions_/346/212/254/346/211/213_1_File_0.motion3.json +450 -450
  41. package/assets/model/we-q/motions/idle/FileReferences_Motions_Idleidle_0_File_0.motion3.json +422 -422
  42. package/assets/model/we-q/physics/FileReferences_Physics_0.physic3.json +236 -236
  43. package/assets/runtime/live2dcubismcore.min.js +8 -8
  44. package/assets/stickers.json +84 -84
  45. package/assets/vendor/cubism4.min.js +1 -1
  46. package/assets/vendor/pixi.min.js +9 -9
  47. package/assets/vendor/theme-cyrene-factory.js +4314 -4314
  48. package/assets/vendor/theme-cyrene.js +4317 -4317
  49. package/assets/voice/angry-00.opus +0 -0
  50. package/assets/voice/angry-02.opus +0 -0
  51. package/assets/voice/approval-00.opus +0 -0
  52. package/assets/voice/approval-01.opus +0 -0
  53. package/assets/voice/approval-02.opus +0 -0
  54. package/assets/voice/askAck-00.opus +0 -0
  55. package/assets/voice/away-01.opus +0 -0
  56. package/assets/voice/away-02.opus +0 -0
  57. package/assets/voice/away-03.opus +0 -0
  58. package/assets/voice/away-05.opus +0 -0
  59. package/assets/voice/back-00.opus +0 -0
  60. package/assets/voice/back-01.opus +0 -0
  61. package/assets/voice/backLong-05.opus +0 -0
  62. package/assets/voice/backShort-03.opus +0 -0
  63. package/assets/voice/backShort-04.opus +0 -0
  64. package/assets/voice/backShort-07.opus +0 -0
  65. package/assets/voice/backVeryLong-01.opus +0 -0
  66. package/assets/voice/backVeryLong-02.opus +0 -0
  67. package/assets/voice/backVeryLong-03.opus +0 -0
  68. package/assets/voice/backVeryLong-04.opus +0 -0
  69. package/assets/voice/backVeryLong-05.opus +0 -0
  70. package/assets/voice/backVeryLong-07.opus +0 -0
  71. package/assets/voice/backVeryLong-08.opus +0 -0
  72. package/assets/voice/balLow-00.opus +0 -0
  73. package/assets/voice/balLow-01.opus +0 -0
  74. package/assets/voice/birthday-02.opus +0 -0
  75. package/assets/voice/click-00.opus +0 -0
  76. package/assets/voice/click-01.opus +0 -0
  77. package/assets/voice/click-07.opus +0 -0
  78. package/assets/voice/click-10.opus +0 -0
  79. package/assets/voice/click-11.opus +0 -0
  80. package/assets/voice/click-12.opus +0 -0
  81. package/assets/voice/click-16.opus +0 -0
  82. package/assets/voice/click-17.opus +0 -0
  83. package/assets/voice/click-18.opus +0 -0
  84. package/assets/voice/comfort-03.opus +0 -0
  85. package/assets/voice/comfort-04.opus +0 -0
  86. package/assets/voice/cost10-00.opus +0 -0
  87. package/assets/voice/cost2-00.opus +0 -0
  88. package/assets/voice/cost5-00.opus +0 -0
  89. package/assets/voice/costTurn-01.opus +0 -0
  90. package/assets/voice/costTurn-02.opus +0 -0
  91. package/assets/voice/ctxFull-01.opus +0 -0
  92. package/assets/voice/ctxHigh-00.opus +0 -0
  93. package/assets/voice/dawn-01.opus +0 -0
  94. package/assets/voice/dawn-04.opus +0 -0
  95. package/assets/voice/dawn-06.opus +0 -0
  96. package/assets/voice/dawn-07.opus +0 -0
  97. package/assets/voice/deepWake-03.opus +0 -0
  98. package/assets/voice/deepWake-04.opus +0 -0
  99. package/assets/voice/deepWake-06.opus +0 -0
  100. package/assets/voice/deepWake-07.opus +0 -0
  101. package/assets/voice/done-05.opus +0 -0
  102. package/assets/voice/done-08.opus +0 -0
  103. package/assets/voice/done-09.opus +0 -0
  104. package/assets/voice/done-11.opus +0 -0
  105. package/assets/voice/empty-00.opus +0 -0
  106. package/assets/voice/encourage-02.opus +0 -0
  107. package/assets/voice/failed-01.opus +0 -0
  108. package/assets/voice/failed-05.opus +0 -0
  109. package/assets/voice/failkind-auth-01.opus +0 -0
  110. package/assets/voice/failkind-auth-02.opus +0 -0
  111. package/assets/voice/failkind-ctx-00.opus +0 -0
  112. package/assets/voice/failkind-missing-01.opus +0 -0
  113. package/assets/voice/focusEnd-02.opus +0 -0
  114. package/assets/voice/focusEnd-04.opus +0 -0
  115. package/assets/voice/forgive-00.opus +0 -0
  116. package/assets/voice/hello-00.opus +0 -0
  117. package/assets/voice/hello-03.opus +0 -0
  118. package/assets/voice/hold-00.opus +0 -0
  119. package/assets/voice/idleTap-00.opus +0 -0
  120. package/assets/voice/idleTapLong-02.opus +0 -0
  121. package/assets/voice/lateNight-00.opus +0 -0
  122. package/assets/voice/lateNight-02.opus +0 -0
  123. package/assets/voice/lateNight-03.opus +0 -0
  124. package/assets/voice/lateNight-06.opus +0 -0
  125. package/assets/voice/lateNight-07.opus +0 -0
  126. package/assets/voice/murmur-04.opus +0 -0
  127. package/assets/voice/night-01.opus +0 -0
  128. package/assets/voice/night-03.opus +0 -0
  129. package/assets/voice/night-05.opus +0 -0
  130. package/assets/voice/noon-04.opus +0 -0
  131. package/assets/voice/petArm-02.opus +0 -0
  132. package/assets/voice/petCheek-00.opus +0 -0
  133. package/assets/voice/petCheek-01.opus +0 -0
  134. package/assets/voice/petCheek-02.opus +0 -0
  135. package/assets/voice/petHead-01.opus +0 -0
  136. package/assets/voice/petHead-03.opus +0 -0
  137. package/assets/voice/petHead-04.opus +0 -0
  138. package/assets/voice/praised-01.opus +0 -0
  139. package/assets/voice/praised-03.opus +0 -0
  140. package/assets/voice/question-00.opus +0 -0
  141. package/assets/voice/question-03.opus +0 -0
  142. package/assets/voice/question-04.opus +0 -0
  143. package/assets/voice/question-06.opus +0 -0
  144. package/assets/voice/shy-00.opus +0 -0
  145. package/assets/voice/spot-0-0.opus +0 -0
  146. package/assets/voice/spot-0-1.opus +0 -0
  147. package/assets/voice/spot-0-2.opus +0 -0
  148. package/assets/voice/spot-3-0.opus +0 -0
  149. package/assets/voice/spot-4-0.opus +0 -0
  150. package/assets/voice/spot-4-2.opus +0 -0
  151. package/assets/voice/spot-5-2.opus +0 -0
  152. package/assets/voice/spot-6-0.opus +0 -0
  153. package/assets/voice/spot-6-1.opus +0 -0
  154. package/assets/voice/spot-7-0.opus +0 -0
  155. package/assets/voice/spot-7-2.opus +0 -0
  156. package/assets/voice/spot-8-1.opus +0 -0
  157. package/assets/voice/tagent-00.opus +0 -0
  158. package/assets/voice/thinkFast-01.opus +0 -0
  159. package/assets/voice/thinkFast-02.opus +0 -0
  160. package/assets/voice/thinkFast-03.opus +0 -0
  161. package/assets/voice/thinkSlow-01.opus +0 -0
  162. package/assets/voice/thinkSlow-03.opus +0 -0
  163. package/assets/voice/thinking-01.opus +0 -0
  164. package/assets/voice/thinking-02.opus +0 -0
  165. package/assets/voice/thinking-03.opus +0 -0
  166. package/assets/voice/thinking-09.opus +0 -0
  167. package/assets/voice/tread-00.opus +0 -0
  168. package/assets/voice/tread-01.opus +0 -0
  169. package/assets/voice/trun-02.opus +0 -0
  170. package/assets/voice/tsun-00.opus +0 -0
  171. package/assets/voice/tsun-01.opus +0 -0
  172. package/assets/voice/tsun-04.opus +0 -0
  173. package/assets/voice/twrite-00.opus +0 -0
  174. package/assets/voice/unknown-01.opus +0 -0
  175. package/assets/voice/waitApproval-00.opus +0 -0
  176. package/assets/voice/waitApproval-01.opus +0 -0
  177. package/assets/voice/waitApproval-02.opus +0 -0
  178. package/assets/voice/waitApproval-03.opus +0 -0
  179. package/assets/voice/waitApprovalLate-02.opus +0 -0
  180. package/assets/voice/waitApprovalLate-03.opus +0 -0
  181. package/assets/voice/waitAsk-00.opus +0 -0
  182. package/assets/voice/waitAsk-02.opus +0 -0
  183. package/assets/voice/waitAskLate-03.opus +0 -0
  184. package/assets/voice/wake-03.opus +0 -0
  185. package/assets/voice/wake-04.opus +0 -0
  186. package/assets/voice/wake-05.opus +0 -0
  187. package/assets/voice/wake-06.opus +0 -0
  188. package/lib/client.js +7 -7
  189. package/lib/features/notes.js +172 -172
  190. package/lib/features/reminder.js +216 -216
  191. package/lib/l2d-plan.js +295 -295
  192. package/lib/l2d-tools.js +293 -293
  193. package/lib/ledger.js +163 -163
  194. package/lib/mys/config.js +183 -183
  195. package/lib/mys/ds.js +209 -209
  196. package/lib/mys/http.js +85 -85
  197. package/lib/mys/mys.js +419 -419
  198. package/lib/mys/qr.js +434 -434
  199. package/lib/mys/scheduler.js +206 -206
  200. package/lib/mys/store.js +248 -248
  201. package/lib/mys/tz.js +174 -174
  202. package/lib/wavtrim.js +245 -245
  203. package/lib/worldbook/NOTICE.md +18 -18
  204. package/lib/worldbook/data/Cyrene.md +111 -111
  205. package/lib/worldbook/data/_glossary.md +181 -181
  206. package/lib/worldbook/data/characters.md +289 -289
  207. package/lib/worldbook/data/story.md +130 -130
  208. package/lib/worldbook/data/world.md +182 -182
  209. package/lib/worldbook.js +189 -189
  210. package/package.json +72 -69
@@ -1,206 +1,206 @@
1
- /**
2
- * Daily scheduling: one run per day, at a random instant inside a window.
3
- *
4
- * The planner is a pure function so the timing rules can be tested without a
5
- * live timer; the scheduler is a thin loop that re-arms itself and tolerates a
6
- * suspended machine (a late timer still runs once, never twice).
7
- */
8
- import { dayKey, gameDayKey, minuteOfDay, parseClock, pickInstantInWindow, shiftDayKey, zonedParts, zonedToInstant } from './tz.js'
9
-
10
- const MAX_ARM_MS = 6 * 60 * 60 * 1000
11
-
12
- /**
13
- * Decide when the next run should happen.
14
- *
15
- * @param {object} input
16
- * @param {object} input.config - normalized configuration.
17
- * @param {number} input.now - current epoch milliseconds.
18
- * @param {string|null} input.lastRunDate - `YYYY-MM-DD` of the last completed run.
19
- * @param {() => number} [input.random]
20
- * @returns {{date: string, targetAt: Date, window: {start: string, end: string}|null, reason: string}|null}
21
- */
22
- export function planNext({ config, now, lastRunDate = null, random = Math.random }) {
23
- if (config?.enabled !== true) return null
24
- const timeZone = config.timezone
25
- const current = new Date(now)
26
- const today = dayKey(current, timeZone)
27
- const minute = minuteOfDay(current, timeZone)
28
- // 按窗口起始时刻排序再挑:配置里的顺序不代表先后。
29
- // 以前 tomorrowPlan 固定取 config.windows[0],而今天的循环按配置顺序返回第一个「还没过」的,
30
- // 两处都可能拿到「配置里排第一但时间上不是最早」的那个窗口。
31
- const windows = [...(Array.isArray(config.windows) ? config.windows : [])].sort((a, b) => {
32
- const sa = parseClock(a && a.start)
33
- const sb = parseClock(b && b.start)
34
- return (sa === null ? 1e9 : sa) - (sb === null ? 1e9 : sb)
35
- })
36
-
37
- // 空窗口防御:normalizeConfig 理论上会保证非空,但这里再兜一次 ——
38
- // 一旦 windows 是空的,windows[0].start 会在插件加载期抛 TypeError。
39
- if (windows.length === 0) return null
40
-
41
- const tomorrowPlan = (reason) => {
42
- const date = shiftDayKey(today, 1)
43
- const window = windows[0]
44
- return {
45
- date,
46
- targetAt: pickInstantInWindow(date, { start: parseClock(window.start), end: parseClock(window.end) }, timeZone, random),
47
- window,
48
- reason,
49
- }
50
- }
51
-
52
- // 「今天跑过没有」必须和 lastRunDate 用同一个「今天」—— 它是游戏日(04:00 换日)。
53
- // 以前这里比的是自然日,窗口落在 00:00–04:00 时会判定失效、多跑一次拿到 already。
54
- // 两个都认:新记录是游戏日,老记录(升级前)是自然日。
55
- if (lastRunDate === gameDayKey(current, timeZone) || lastRunDate === today) return tomorrowPlan('done-today')
56
-
57
- for (const window of windows) {
58
- const start = parseClock(window.start)
59
- const end = parseClock(window.end)
60
- if (start === null || end === null) continue
61
- if (end <= minute) continue
62
-
63
- if (start > minute) {
64
- return {
65
- date: today,
66
- targetAt: pickInstantInWindow(today, { start, end }, timeZone, random),
67
- window,
68
- reason: 'window',
69
- }
70
- }
71
-
72
- // Already inside the window: spread the remaining minutes uniformly.
73
- const remaining = Math.max(1, end - minute)
74
- const offset = Math.floor(random() * remaining)
75
- const parts = zonedParts(current, timeZone)
76
- const targetMinute = Math.min(1439, minute + offset)
77
- return {
78
- date: today,
79
- targetAt: zonedToInstant(
80
- { year: parts.year, month: parts.month, day: parts.day, hour: Math.floor(targetMinute / 60), minute: targetMinute % 60 },
81
- timeZone,
82
- ),
83
- window,
84
- reason: 'inside',
85
- }
86
- }
87
-
88
- if (config.runWhenMissed === true) {
89
- // Every window has passed and today has no run: catch up in a few minutes,
90
- // still jittered so a restarting app does not fire on a round minute.
91
- const delayMs = 180_000 + Math.floor(random() * 420_000)
92
- return { date: today, targetAt: new Date(now + delayMs), window: null, reason: 'missed' }
93
- }
94
-
95
- return tomorrowPlan('passed')
96
- }
97
-
98
- /**
99
- * Timer loop around {@link planNext}.
100
- *
101
- * `setTimer(callback, delayMs)` must return a disposer; the host passes
102
- * cordis' `ctx.timeout` so a plugin reload clears the pending timer.
103
- */
104
- export class Scheduler {
105
- constructor({ getConfig, getLastRunDate, onRun, onPlan, onError, now = () => Date.now(), random = Math.random, setTimer }) {
106
- this.getConfig = getConfig
107
- this.getLastRunDate = getLastRunDate
108
- this.onRun = onRun
109
- this.onPlan = onPlan
110
- this.onError = onError ?? (() => {})
111
- this.now = now
112
- this.random = random
113
- this.setTimer = setTimer
114
- this.timer = null
115
- this.plan = null
116
- this.busy = false
117
- this.stopped = false
118
- }
119
-
120
- /** Whether a run is currently in flight. */
121
- get running() {
122
- return this.busy
123
- }
124
-
125
- /** Current plan without re-computing it. */
126
- getPlan() {
127
- return this.plan
128
- }
129
-
130
- /** Compute a fresh plan and arm the timer for it. */
131
- refresh() {
132
- if (this.stopped) return null
133
- this.clearTimer()
134
- const plan = planNext({
135
- config: this.getConfig(),
136
- now: this.now(),
137
- lastRunDate: this.getLastRunDate(),
138
- random: this.random,
139
- })
140
- this.plan = plan
141
- this.onPlan?.(plan)
142
- if (plan !== null) this.arm(plan)
143
- return plan
144
- }
145
-
146
- arm(plan) {
147
- const delay = Math.max(1000, plan.targetAt.getTime() - this.now())
148
- if (delay > MAX_ARM_MS) {
149
- // Re-check in six hours: a clock change or a long sleep must not skip the day.
150
- this.timer = this.setTimer(() => {
151
- this.timer = null
152
- if (this.stopped) return
153
- this.refresh()
154
- }, MAX_ARM_MS)
155
- return
156
- }
157
- this.timer = this.setTimer(() => {
158
- this.timer = null
159
- void this.fire()
160
- }, delay)
161
- }
162
-
163
- clearTimer() {
164
- if (this.timer !== null) {
165
- this.timer()
166
- this.timer = null
167
- }
168
- }
169
-
170
- async fire() {
171
- if (this.stopped) return
172
- if (this.busy) return
173
- const plan = this.plan
174
- if (plan === null) {
175
- this.refresh()
176
- return
177
- }
178
- const early = plan.targetAt.getTime() - this.now()
179
- if (early > 5000) {
180
- this.arm(plan)
181
- return
182
- }
183
- this.busy = true
184
- try {
185
- await this.onRun('schedule')
186
- } catch (error) {
187
- this.onError(error)
188
- } finally {
189
- this.busy = false
190
- this.refresh()
191
- }
192
- }
193
-
194
- /** Start the loop. */
195
- start() {
196
- this.stopped = false
197
- return this.refresh()
198
- }
199
-
200
- /** Stop the loop and drop the pending timer. */
201
- stop() {
202
- this.stopped = true
203
- this.clearTimer()
204
- this.plan = null
205
- }
206
- }
1
+ /**
2
+ * Daily scheduling: one run per day, at a random instant inside a window.
3
+ *
4
+ * The planner is a pure function so the timing rules can be tested without a
5
+ * live timer; the scheduler is a thin loop that re-arms itself and tolerates a
6
+ * suspended machine (a late timer still runs once, never twice).
7
+ */
8
+ import { dayKey, gameDayKey, minuteOfDay, parseClock, pickInstantInWindow, shiftDayKey, zonedParts, zonedToInstant } from './tz.js'
9
+
10
+ const MAX_ARM_MS = 6 * 60 * 60 * 1000
11
+
12
+ /**
13
+ * Decide when the next run should happen.
14
+ *
15
+ * @param {object} input
16
+ * @param {object} input.config - normalized configuration.
17
+ * @param {number} input.now - current epoch milliseconds.
18
+ * @param {string|null} input.lastRunDate - `YYYY-MM-DD` of the last completed run.
19
+ * @param {() => number} [input.random]
20
+ * @returns {{date: string, targetAt: Date, window: {start: string, end: string}|null, reason: string}|null}
21
+ */
22
+ export function planNext({ config, now, lastRunDate = null, random = Math.random }) {
23
+ if (config?.enabled !== true) return null
24
+ const timeZone = config.timezone
25
+ const current = new Date(now)
26
+ const today = dayKey(current, timeZone)
27
+ const minute = minuteOfDay(current, timeZone)
28
+ // 按窗口起始时刻排序再挑:配置里的顺序不代表先后。
29
+ // 以前 tomorrowPlan 固定取 config.windows[0],而今天的循环按配置顺序返回第一个「还没过」的,
30
+ // 两处都可能拿到「配置里排第一但时间上不是最早」的那个窗口。
31
+ const windows = [...(Array.isArray(config.windows) ? config.windows : [])].sort((a, b) => {
32
+ const sa = parseClock(a && a.start)
33
+ const sb = parseClock(b && b.start)
34
+ return (sa === null ? 1e9 : sa) - (sb === null ? 1e9 : sb)
35
+ })
36
+
37
+ // 空窗口防御:normalizeConfig 理论上会保证非空,但这里再兜一次 ——
38
+ // 一旦 windows 是空的,windows[0].start 会在插件加载期抛 TypeError。
39
+ if (windows.length === 0) return null
40
+
41
+ const tomorrowPlan = (reason) => {
42
+ const date = shiftDayKey(today, 1)
43
+ const window = windows[0]
44
+ return {
45
+ date,
46
+ targetAt: pickInstantInWindow(date, { start: parseClock(window.start), end: parseClock(window.end) }, timeZone, random),
47
+ window,
48
+ reason,
49
+ }
50
+ }
51
+
52
+ // 「今天跑过没有」必须和 lastRunDate 用同一个「今天」—— 它是游戏日(04:00 换日)。
53
+ // 以前这里比的是自然日,窗口落在 00:00–04:00 时会判定失效、多跑一次拿到 already。
54
+ // 两个都认:新记录是游戏日,老记录(升级前)是自然日。
55
+ if (lastRunDate === gameDayKey(current, timeZone) || lastRunDate === today) return tomorrowPlan('done-today')
56
+
57
+ for (const window of windows) {
58
+ const start = parseClock(window.start)
59
+ const end = parseClock(window.end)
60
+ if (start === null || end === null) continue
61
+ if (end <= minute) continue
62
+
63
+ if (start > minute) {
64
+ return {
65
+ date: today,
66
+ targetAt: pickInstantInWindow(today, { start, end }, timeZone, random),
67
+ window,
68
+ reason: 'window',
69
+ }
70
+ }
71
+
72
+ // Already inside the window: spread the remaining minutes uniformly.
73
+ const remaining = Math.max(1, end - minute)
74
+ const offset = Math.floor(random() * remaining)
75
+ const parts = zonedParts(current, timeZone)
76
+ const targetMinute = Math.min(1439, minute + offset)
77
+ return {
78
+ date: today,
79
+ targetAt: zonedToInstant(
80
+ { year: parts.year, month: parts.month, day: parts.day, hour: Math.floor(targetMinute / 60), minute: targetMinute % 60 },
81
+ timeZone,
82
+ ),
83
+ window,
84
+ reason: 'inside',
85
+ }
86
+ }
87
+
88
+ if (config.runWhenMissed === true) {
89
+ // Every window has passed and today has no run: catch up in a few minutes,
90
+ // still jittered so a restarting app does not fire on a round minute.
91
+ const delayMs = 180_000 + Math.floor(random() * 420_000)
92
+ return { date: today, targetAt: new Date(now + delayMs), window: null, reason: 'missed' }
93
+ }
94
+
95
+ return tomorrowPlan('passed')
96
+ }
97
+
98
+ /**
99
+ * Timer loop around {@link planNext}.
100
+ *
101
+ * `setTimer(callback, delayMs)` must return a disposer; the host passes
102
+ * cordis' `ctx.timeout` so a plugin reload clears the pending timer.
103
+ */
104
+ export class Scheduler {
105
+ constructor({ getConfig, getLastRunDate, onRun, onPlan, onError, now = () => Date.now(), random = Math.random, setTimer }) {
106
+ this.getConfig = getConfig
107
+ this.getLastRunDate = getLastRunDate
108
+ this.onRun = onRun
109
+ this.onPlan = onPlan
110
+ this.onError = onError ?? (() => {})
111
+ this.now = now
112
+ this.random = random
113
+ this.setTimer = setTimer
114
+ this.timer = null
115
+ this.plan = null
116
+ this.busy = false
117
+ this.stopped = false
118
+ }
119
+
120
+ /** Whether a run is currently in flight. */
121
+ get running() {
122
+ return this.busy
123
+ }
124
+
125
+ /** Current plan without re-computing it. */
126
+ getPlan() {
127
+ return this.plan
128
+ }
129
+
130
+ /** Compute a fresh plan and arm the timer for it. */
131
+ refresh() {
132
+ if (this.stopped) return null
133
+ this.clearTimer()
134
+ const plan = planNext({
135
+ config: this.getConfig(),
136
+ now: this.now(),
137
+ lastRunDate: this.getLastRunDate(),
138
+ random: this.random,
139
+ })
140
+ this.plan = plan
141
+ this.onPlan?.(plan)
142
+ if (plan !== null) this.arm(plan)
143
+ return plan
144
+ }
145
+
146
+ arm(plan) {
147
+ const delay = Math.max(1000, plan.targetAt.getTime() - this.now())
148
+ if (delay > MAX_ARM_MS) {
149
+ // Re-check in six hours: a clock change or a long sleep must not skip the day.
150
+ this.timer = this.setTimer(() => {
151
+ this.timer = null
152
+ if (this.stopped) return
153
+ this.refresh()
154
+ }, MAX_ARM_MS)
155
+ return
156
+ }
157
+ this.timer = this.setTimer(() => {
158
+ this.timer = null
159
+ void this.fire()
160
+ }, delay)
161
+ }
162
+
163
+ clearTimer() {
164
+ if (this.timer !== null) {
165
+ this.timer()
166
+ this.timer = null
167
+ }
168
+ }
169
+
170
+ async fire() {
171
+ if (this.stopped) return
172
+ if (this.busy) return
173
+ const plan = this.plan
174
+ if (plan === null) {
175
+ this.refresh()
176
+ return
177
+ }
178
+ const early = plan.targetAt.getTime() - this.now()
179
+ if (early > 5000) {
180
+ this.arm(plan)
181
+ return
182
+ }
183
+ this.busy = true
184
+ try {
185
+ await this.onRun('schedule')
186
+ } catch (error) {
187
+ this.onError(error)
188
+ } finally {
189
+ this.busy = false
190
+ this.refresh()
191
+ }
192
+ }
193
+
194
+ /** Start the loop. */
195
+ start() {
196
+ this.stopped = false
197
+ return this.refresh()
198
+ }
199
+
200
+ /** Stop the loop and drop the pending timer. */
201
+ stop() {
202
+ this.stopped = true
203
+ this.clearTimer()
204
+ this.plan = null
205
+ }
206
+ }