roblox-opencode 1.0.0 → 1.0.1

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 (246) hide show
  1. package/README.md +112 -122
  2. package/commands/setup-game.md +108 -108
  3. package/commands/sync-check.md +53 -53
  4. package/core/roblox-core.md +93 -93
  5. package/dist/server.js +189 -167
  6. package/package.json +35 -35
  7. package/skills/roblox-analytics/SKILL.md +277 -277
  8. package/skills/roblox-analytics/references/event-batcher.luau +75 -75
  9. package/skills/roblox-animation-vfx/SKILL.md +1325 -1325
  10. package/skills/roblox-architecture/SKILL.md +863 -863
  11. package/skills/roblox-architecture/references/combat-systems.md +1381 -1381
  12. package/skills/roblox-code-review/SKILL.md +686 -686
  13. package/skills/roblox-data/SKILL.md +889 -889
  14. package/skills/roblox-data/references/inventory-systems.md +1729 -1729
  15. package/skills/roblox-debug/SKILL.md +98 -98
  16. package/skills/roblox-gui/SKILL.md +1103 -1103
  17. package/skills/roblox-gui-fusion/SKILL.md +150 -150
  18. package/skills/roblox-gui-fusion/references/inventory.luau +427 -427
  19. package/skills/roblox-gui-fusion/references/settings-menu.luau +579 -579
  20. package/skills/roblox-gui-fusion/references/shop.luau +411 -411
  21. package/skills/roblox-luau-mastery/SKILL.md +1519 -1519
  22. package/skills/roblox-monetization/SKILL.md +1084 -1084
  23. package/skills/roblox-monetization/references/process-receipt.luau +131 -131
  24. package/skills/roblox-networking/SKILL.md +669 -669
  25. package/skills/roblox-networking/references/remote-validator.luau +193 -193
  26. package/skills/roblox-publish-checklist/SKILL.md +127 -127
  27. package/skills/roblox-runtime/SKILL.md +753 -753
  28. package/skills/roblox-sharp-edges/SKILL.md +294 -294
  29. package/skills/roblox-sync/SKILL.md +126 -126
  30. package/skills/roblox-testing/SKILL.md +943 -943
  31. package/skills/roblox-tooling/SKILL.md +149 -149
  32. package/vendor/LICENSES/ProfileStore-LICENSE +201 -201
  33. package/vendor/LICENSES/RbxUtil-LICENSE +7 -7
  34. package/vendor/LICENSES/promise-LICENSE +20 -20
  35. package/vendor/LICENSES/t-LICENSE +21 -21
  36. package/vendor/LICENSES/testez-LICENSE +200 -200
  37. package/vendor/README.md +83 -83
  38. package/vendor/fusion/Animation/ExternalTime.luau +83 -83
  39. package/vendor/fusion/Animation/Spring.luau +321 -321
  40. package/vendor/fusion/Animation/Stopwatch.luau +127 -127
  41. package/vendor/fusion/Animation/Tween.luau +187 -187
  42. package/vendor/fusion/Animation/getTweenDuration.luau +27 -27
  43. package/vendor/fusion/Animation/getTweenRatio.luau +47 -47
  44. package/vendor/fusion/Animation/lerpType.luau +163 -163
  45. package/vendor/fusion/Animation/packType.luau +99 -99
  46. package/vendor/fusion/Animation/springCoefficients.luau +80 -80
  47. package/vendor/fusion/Animation/unpackType.luau +102 -102
  48. package/vendor/fusion/Colour/Oklab.luau +70 -70
  49. package/vendor/fusion/Colour/sRGB.luau +54 -54
  50. package/vendor/fusion/External.luau +167 -167
  51. package/vendor/fusion/ExternalDebug.luau +69 -69
  52. package/vendor/fusion/Graph/Observer.luau +113 -113
  53. package/vendor/fusion/Graph/castToGraph.luau +28 -28
  54. package/vendor/fusion/Graph/change.luau +80 -80
  55. package/vendor/fusion/Graph/depend.luau +32 -32
  56. package/vendor/fusion/Graph/evaluate.luau +55 -55
  57. package/vendor/fusion/Instances/Attribute.luau +57 -57
  58. package/vendor/fusion/Instances/AttributeChange.luau +46 -46
  59. package/vendor/fusion/Instances/AttributeOut.luau +63 -63
  60. package/vendor/fusion/Instances/Child.luau +21 -21
  61. package/vendor/fusion/Instances/Children.luau +147 -147
  62. package/vendor/fusion/Instances/Hydrate.luau +32 -32
  63. package/vendor/fusion/Instances/New.luau +52 -52
  64. package/vendor/fusion/Instances/OnChange.luau +49 -49
  65. package/vendor/fusion/Instances/OnEvent.luau +53 -53
  66. package/vendor/fusion/Instances/Out.luau +69 -69
  67. package/vendor/fusion/Instances/applyInstanceProps.luau +148 -148
  68. package/vendor/fusion/Instances/defaultProps.luau +194 -194
  69. package/vendor/fusion/LICENSE +21 -21
  70. package/vendor/fusion/Logging/formatError.luau +48 -48
  71. package/vendor/fusion/Logging/messages.luau +51 -51
  72. package/vendor/fusion/Logging/parseError.luau +24 -24
  73. package/vendor/fusion/Memory/checkLifetime.luau +133 -133
  74. package/vendor/fusion/Memory/deriveScope.luau +23 -23
  75. package/vendor/fusion/Memory/deriveScopeImpl.luau +44 -44
  76. package/vendor/fusion/Memory/doCleanup.luau +78 -78
  77. package/vendor/fusion/Memory/innerScope.luau +33 -33
  78. package/vendor/fusion/Memory/legacyCleanup.luau +17 -17
  79. package/vendor/fusion/Memory/needsDestruction.luau +16 -16
  80. package/vendor/fusion/Memory/poisonScope.luau +33 -33
  81. package/vendor/fusion/Memory/scopePool.luau +54 -54
  82. package/vendor/fusion/Memory/scoped.luau +26 -26
  83. package/vendor/fusion/Memory/whichLivesLonger.luau +74 -74
  84. package/vendor/fusion/RobloxExternal.luau +97 -97
  85. package/vendor/fusion/State/Computed.luau +138 -138
  86. package/vendor/fusion/State/For/Disassembly.luau +210 -210
  87. package/vendor/fusion/State/For/ForTypes.luau +30 -30
  88. package/vendor/fusion/State/For/init.luau +109 -109
  89. package/vendor/fusion/State/ForKeys.luau +93 -93
  90. package/vendor/fusion/State/ForPairs.luau +96 -96
  91. package/vendor/fusion/State/ForValues.luau +93 -93
  92. package/vendor/fusion/State/Value.luau +87 -87
  93. package/vendor/fusion/State/castToState.luau +25 -25
  94. package/vendor/fusion/State/peek.luau +30 -30
  95. package/vendor/fusion/Types.luau +314 -314
  96. package/vendor/fusion/Utility/Contextual.luau +90 -90
  97. package/vendor/fusion/Utility/Safe.luau +22 -22
  98. package/vendor/fusion/Utility/isSimilar.luau +29 -29
  99. package/vendor/fusion/Utility/merge.luau +35 -35
  100. package/vendor/fusion/Utility/nameOf.luau +34 -34
  101. package/vendor/fusion/Utility/never.luau +13 -13
  102. package/vendor/fusion/Utility/nicknames.luau +10 -10
  103. package/vendor/fusion/Utility/xtypeof.luau +26 -26
  104. package/vendor/fusion/init.luau +82 -82
  105. package/vendor/profilestore/init.luau +2242 -2242
  106. package/vendor/promise/init.luau +1982 -1982
  107. package/vendor/rbxutil/buffer-util/Buffer.test.luau +25 -25
  108. package/vendor/rbxutil/buffer-util/BufferReader.luau +228 -228
  109. package/vendor/rbxutil/buffer-util/BufferWriter.luau +269 -269
  110. package/vendor/rbxutil/buffer-util/DataTypeBuffer.luau +223 -223
  111. package/vendor/rbxutil/buffer-util/Types.luau +60 -60
  112. package/vendor/rbxutil/buffer-util/index.d.ts +153 -153
  113. package/vendor/rbxutil/buffer-util/init.luau +41 -41
  114. package/vendor/rbxutil/buffer-util/package.json +16 -16
  115. package/vendor/rbxutil/buffer-util/wally.toml +9 -9
  116. package/vendor/rbxutil/comm/Client/ClientComm.luau +232 -232
  117. package/vendor/rbxutil/comm/Client/ClientRemoteProperty.luau +156 -156
  118. package/vendor/rbxutil/comm/Client/ClientRemoteSignal.luau +109 -109
  119. package/vendor/rbxutil/comm/Client/init.luau +135 -135
  120. package/vendor/rbxutil/comm/Server/RemoteProperty.luau +295 -295
  121. package/vendor/rbxutil/comm/Server/RemoteSignal.luau +211 -211
  122. package/vendor/rbxutil/comm/Server/ServerComm.luau +211 -211
  123. package/vendor/rbxutil/comm/Server/init.luau +140 -140
  124. package/vendor/rbxutil/comm/Types.luau +18 -18
  125. package/vendor/rbxutil/comm/Util.luau +27 -27
  126. package/vendor/rbxutil/comm/init.luau +35 -35
  127. package/vendor/rbxutil/comm/wally.toml +13 -13
  128. package/vendor/rbxutil/component/init.luau +759 -759
  129. package/vendor/rbxutil/component/init.test.luau +311 -311
  130. package/vendor/rbxutil/component/wally.toml +14 -14
  131. package/vendor/rbxutil/concur/init.luau +542 -542
  132. package/vendor/rbxutil/concur/init.test.luau +364 -364
  133. package/vendor/rbxutil/concur/wally.toml +8 -8
  134. package/vendor/rbxutil/enum-list/init.luau +101 -101
  135. package/vendor/rbxutil/enum-list/init.test.luau +91 -91
  136. package/vendor/rbxutil/enum-list/wally.toml +8 -8
  137. package/vendor/rbxutil/find/index.d.ts +20 -20
  138. package/vendor/rbxutil/find/init.luau +44 -44
  139. package/vendor/rbxutil/find/package.json +17 -17
  140. package/vendor/rbxutil/find/wally.toml +8 -8
  141. package/vendor/rbxutil/input/Gamepad.luau +559 -559
  142. package/vendor/rbxutil/input/Keyboard.luau +124 -124
  143. package/vendor/rbxutil/input/Mouse.luau +278 -278
  144. package/vendor/rbxutil/input/PreferredInput.luau +91 -91
  145. package/vendor/rbxutil/input/Touch.luau +120 -120
  146. package/vendor/rbxutil/input/init.luau +33 -33
  147. package/vendor/rbxutil/input/wally.toml +12 -12
  148. package/vendor/rbxutil/loader/index.d.ts +15 -15
  149. package/vendor/rbxutil/loader/init.luau +137 -137
  150. package/vendor/rbxutil/loader/wally.toml +8 -8
  151. package/vendor/rbxutil/log/index.d.ts +38 -38
  152. package/vendor/rbxutil/log/init.luau +746 -746
  153. package/vendor/rbxutil/log/wally.toml +8 -8
  154. package/vendor/rbxutil/net/init.luau +190 -190
  155. package/vendor/rbxutil/net/wally.toml +8 -8
  156. package/vendor/rbxutil/option/index.d.ts +44 -44
  157. package/vendor/rbxutil/option/init.luau +489 -489
  158. package/vendor/rbxutil/option/init.test.luau +342 -342
  159. package/vendor/rbxutil/option/wally.toml +8 -8
  160. package/vendor/rbxutil/pid/index.d.ts +53 -53
  161. package/vendor/rbxutil/pid/init.luau +195 -195
  162. package/vendor/rbxutil/pid/package.json +16 -16
  163. package/vendor/rbxutil/pid/wally.toml +9 -9
  164. package/vendor/rbxutil/quaternion/index.d.ts +117 -117
  165. package/vendor/rbxutil/quaternion/init.luau +570 -570
  166. package/vendor/rbxutil/quaternion/package.json +16 -16
  167. package/vendor/rbxutil/quaternion/wally.toml +9 -9
  168. package/vendor/rbxutil/query/index.d.ts +43 -43
  169. package/vendor/rbxutil/query/init.luau +117 -117
  170. package/vendor/rbxutil/query/package.json +18 -18
  171. package/vendor/rbxutil/query/wally.toml +9 -9
  172. package/vendor/rbxutil/sequent/index.d.ts +28 -28
  173. package/vendor/rbxutil/sequent/init.luau +340 -340
  174. package/vendor/rbxutil/sequent/package.json +16 -16
  175. package/vendor/rbxutil/sequent/wally.toml +9 -9
  176. package/vendor/rbxutil/ser/init.luau +175 -175
  177. package/vendor/rbxutil/ser/init.test.luau +50 -50
  178. package/vendor/rbxutil/ser/wally.toml +11 -11
  179. package/vendor/rbxutil/shake/index.d.ts +36 -36
  180. package/vendor/rbxutil/shake/init.luau +532 -532
  181. package/vendor/rbxutil/shake/init.test.luau +267 -267
  182. package/vendor/rbxutil/shake/package.json +16 -16
  183. package/vendor/rbxutil/shake/wally.toml +9 -9
  184. package/vendor/rbxutil/signal/index.d.ts +100 -100
  185. package/vendor/rbxutil/signal/init.luau +432 -432
  186. package/vendor/rbxutil/signal/init.test.luau +190 -190
  187. package/vendor/rbxutil/signal/package.json +17 -17
  188. package/vendor/rbxutil/signal/wally.toml +9 -9
  189. package/vendor/rbxutil/silo/TableWatcher.luau +65 -65
  190. package/vendor/rbxutil/silo/Util.luau +55 -55
  191. package/vendor/rbxutil/silo/init.luau +338 -338
  192. package/vendor/rbxutil/silo/init.test.luau +215 -215
  193. package/vendor/rbxutil/silo/wally.toml +8 -8
  194. package/vendor/rbxutil/spring/index.d.ts +40 -40
  195. package/vendor/rbxutil/spring/init.luau +97 -97
  196. package/vendor/rbxutil/spring/package.json +17 -17
  197. package/vendor/rbxutil/spring/wally.toml +8 -8
  198. package/vendor/rbxutil/stream/index.d.ts +88 -88
  199. package/vendor/rbxutil/stream/init.luau +597 -597
  200. package/vendor/rbxutil/stream/package.json +18 -18
  201. package/vendor/rbxutil/stream/wally.toml +9 -9
  202. package/vendor/rbxutil/streamable/Streamable.luau +202 -202
  203. package/vendor/rbxutil/streamable/StreamableUtil.luau +80 -80
  204. package/vendor/rbxutil/streamable/init.luau +8 -8
  205. package/vendor/rbxutil/streamable/wally.toml +12 -12
  206. package/vendor/rbxutil/symbol/init.luau +56 -56
  207. package/vendor/rbxutil/symbol/init.test.luau +37 -37
  208. package/vendor/rbxutil/symbol/wally.toml +8 -8
  209. package/vendor/rbxutil/table-util/init.luau +938 -938
  210. package/vendor/rbxutil/table-util/init.test.luau +439 -439
  211. package/vendor/rbxutil/task-queue/index.d.ts +27 -27
  212. package/vendor/rbxutil/task-queue/init.luau +97 -97
  213. package/vendor/rbxutil/task-queue/wally.toml +8 -8
  214. package/vendor/rbxutil/timer/index.d.ts +81 -81
  215. package/vendor/rbxutil/timer/init.luau +249 -249
  216. package/vendor/rbxutil/timer/init.test.luau +73 -73
  217. package/vendor/rbxutil/timer/wally.toml +11 -11
  218. package/vendor/rbxutil/tree/index.d.ts +15 -15
  219. package/vendor/rbxutil/tree/init.luau +137 -137
  220. package/vendor/rbxutil/tree/wally.toml +8 -8
  221. package/vendor/rbxutil/trove/index.d.ts +46 -46
  222. package/vendor/rbxutil/trove/init.luau +787 -787
  223. package/vendor/rbxutil/trove/init.test.luau +203 -203
  224. package/vendor/rbxutil/trove/wally.toml +8 -8
  225. package/vendor/rbxutil/typed-remote/init.luau +196 -196
  226. package/vendor/rbxutil/typed-remote/wally.toml +8 -8
  227. package/vendor/rbxutil/wait-for/index.d.ts +17 -17
  228. package/vendor/rbxutil/wait-for/init.luau +257 -257
  229. package/vendor/rbxutil/wait-for/init.test.luau +182 -182
  230. package/vendor/rbxutil/wait-for/wally.toml +11 -11
  231. package/vendor/t/t.lua +1350 -1350
  232. package/vendor/testez/Context.lua +26 -26
  233. package/vendor/testez/Expectation.lua +311 -311
  234. package/vendor/testez/ExpectationContext.lua +38 -38
  235. package/vendor/testez/LifecycleHooks.lua +89 -89
  236. package/vendor/testez/Reporters/TeamCityReporter.lua +101 -101
  237. package/vendor/testez/Reporters/TextReporter.lua +105 -105
  238. package/vendor/testez/Reporters/TextReporterQuiet.lua +96 -96
  239. package/vendor/testez/TestBootstrap.lua +146 -146
  240. package/vendor/testez/TestEnum.lua +27 -27
  241. package/vendor/testez/TestPlan.lua +304 -304
  242. package/vendor/testez/TestPlanner.lua +39 -39
  243. package/vendor/testez/TestResults.lua +111 -111
  244. package/vendor/testez/TestRunner.lua +188 -188
  245. package/vendor/testez/TestSession.lua +243 -243
  246. package/vendor/testez/init.lua +39 -39
@@ -1,110 +1,110 @@
1
- --!strict
2
- --!nolint LocalUnused
3
- --!nolint LocalShadow
4
- local task = nil -- Disable usage of Roblox's task scheduler
5
-
6
- --[[
7
- The generic implementation for all `For` objects.
8
- ]]
9
-
10
- local Package = script.Parent.Parent
11
- local Types = require(Package.Types)
12
- local External = require(Package.External)
13
- -- Graph
14
- local depend = require(Package.Graph.depend)
15
- -- State
16
- local peek = require(Package.State.peek)
17
- local castToState = require(Package.State.castToState)
18
- local ForTypes = require(Package.State.For.ForTypes)
19
- -- Utility
20
- local never = require(Package.Utility.never)
21
- local nicknames = require(Package.Utility.nicknames)
22
-
23
- local Disassembly = require(Package.State.For.Disassembly)
24
-
25
- type Self<S, KI, KO, VI, VO> = Types.For<KO, VO> & {
26
- _disassembly: ForTypes.Disassembly<S, KI, KO, VI, VO>
27
- }
28
-
29
- local class = {}
30
- class.type = "State"
31
- class.kind = "For"
32
- class.timeliness = "lazy"
33
-
34
- local METATABLE = table.freeze {__index = class}
35
-
36
- local function For<S, KI, KO, VI, VO>(
37
- scope: Types.Scope<S>,
38
- inputTable: Types.UsedAs<{[KI]: VI}>,
39
- constructor: (
40
- Types.Scope<S>,
41
- initialKey: KI,
42
- initialValue: VI
43
- ) -> ForTypes.SubObject<S, KI, KO, VI, VO>
44
- ): Types.For<KO, VO>
45
- local createdAt = os.clock()
46
- local self: Self<S, KI, KO, VI, VO> = setmetatable(
47
- {
48
- createdAt = createdAt,
49
- dependencySet = {},
50
- dependentSet = {},
51
- scope = scope,
52
- validity = "invalid",
53
- _EXTREMELY_DANGEROUS_usedAsValue = {},
54
- _disassembly = Disassembly(
55
- scope,
56
- inputTable,
57
- constructor
58
- )
59
- },
60
- METATABLE
61
- ) :: any
62
-
63
- local destroy = function()
64
- self.scope = nil
65
- for dependency in pairs(self.dependencySet) do
66
- dependency.dependentSet[self] = nil
67
- end
68
- end
69
- self.oldestTask = destroy
70
- nicknames[self.oldestTask] = "For"
71
- table.insert(scope, destroy)
72
-
73
- return self
74
- end
75
-
76
- function class.get<S, KI, KO, VI, VO>(
77
- _self: Self<S, KI, KO, VI, VO>
78
- ): never
79
- External.logError("stateGetWasRemoved")
80
- return never()
81
- end
82
-
83
- function class._evaluate<S, KI, KO, VI, VO>(
84
- self: Self<S, KI, KO, VI, VO>
85
- ): boolean
86
- if self.scope == nil then
87
- return false
88
- end
89
- local outerScope = self.scope :: S & Types.Scope<unknown>
90
-
91
- depend(self, self._disassembly)
92
- table.clear(self._EXTREMELY_DANGEROUS_usedAsValue)
93
- self._disassembly:populate(
94
- function<T>(
95
- maybeState: Types.UsedAs<T>
96
- ): T
97
- local state = castToState(maybeState)
98
- if state ~= nil then
99
- depend(self, state)
100
- end
101
- return peek(maybeState)
102
- end,
103
- self._EXTREMELY_DANGEROUS_usedAsValue
104
- )
105
-
106
- return true
107
- end
108
-
109
- table.freeze(class)
1
+ --!strict
2
+ --!nolint LocalUnused
3
+ --!nolint LocalShadow
4
+ local task = nil -- Disable usage of Roblox's task scheduler
5
+
6
+ --[[
7
+ The generic implementation for all `For` objects.
8
+ ]]
9
+
10
+ local Package = script.Parent.Parent
11
+ local Types = require(Package.Types)
12
+ local External = require(Package.External)
13
+ -- Graph
14
+ local depend = require(Package.Graph.depend)
15
+ -- State
16
+ local peek = require(Package.State.peek)
17
+ local castToState = require(Package.State.castToState)
18
+ local ForTypes = require(Package.State.For.ForTypes)
19
+ -- Utility
20
+ local never = require(Package.Utility.never)
21
+ local nicknames = require(Package.Utility.nicknames)
22
+
23
+ local Disassembly = require(Package.State.For.Disassembly)
24
+
25
+ type Self<S, KI, KO, VI, VO> = Types.For<KO, VO> & {
26
+ _disassembly: ForTypes.Disassembly<S, KI, KO, VI, VO>
27
+ }
28
+
29
+ local class = {}
30
+ class.type = "State"
31
+ class.kind = "For"
32
+ class.timeliness = "lazy"
33
+
34
+ local METATABLE = table.freeze {__index = class}
35
+
36
+ local function For<S, KI, KO, VI, VO>(
37
+ scope: Types.Scope<S>,
38
+ inputTable: Types.UsedAs<{[KI]: VI}>,
39
+ constructor: (
40
+ Types.Scope<S>,
41
+ initialKey: KI,
42
+ initialValue: VI
43
+ ) -> ForTypes.SubObject<S, KI, KO, VI, VO>
44
+ ): Types.For<KO, VO>
45
+ local createdAt = os.clock()
46
+ local self: Self<S, KI, KO, VI, VO> = setmetatable(
47
+ {
48
+ createdAt = createdAt,
49
+ dependencySet = {},
50
+ dependentSet = {},
51
+ scope = scope,
52
+ validity = "invalid",
53
+ _EXTREMELY_DANGEROUS_usedAsValue = {},
54
+ _disassembly = Disassembly(
55
+ scope,
56
+ inputTable,
57
+ constructor
58
+ )
59
+ },
60
+ METATABLE
61
+ ) :: any
62
+
63
+ local destroy = function()
64
+ self.scope = nil
65
+ for dependency in pairs(self.dependencySet) do
66
+ dependency.dependentSet[self] = nil
67
+ end
68
+ end
69
+ self.oldestTask = destroy
70
+ nicknames[self.oldestTask] = "For"
71
+ table.insert(scope, destroy)
72
+
73
+ return self
74
+ end
75
+
76
+ function class.get<S, KI, KO, VI, VO>(
77
+ _self: Self<S, KI, KO, VI, VO>
78
+ ): never
79
+ External.logError("stateGetWasRemoved")
80
+ return never()
81
+ end
82
+
83
+ function class._evaluate<S, KI, KO, VI, VO>(
84
+ self: Self<S, KI, KO, VI, VO>
85
+ ): boolean
86
+ if self.scope == nil then
87
+ return false
88
+ end
89
+ local outerScope = self.scope :: S & Types.Scope<unknown>
90
+
91
+ depend(self, self._disassembly)
92
+ table.clear(self._EXTREMELY_DANGEROUS_usedAsValue)
93
+ self._disassembly:populate(
94
+ function<T>(
95
+ maybeState: Types.UsedAs<T>
96
+ ): T
97
+ local state = castToState(maybeState)
98
+ if state ~= nil then
99
+ depend(self, state)
100
+ end
101
+ return peek(maybeState)
102
+ end,
103
+ self._EXTREMELY_DANGEROUS_usedAsValue
104
+ )
105
+
106
+ return true
107
+ end
108
+
109
+ table.freeze(class)
110
110
  return For
@@ -1,94 +1,94 @@
1
- --!strict
2
- --!nolint LocalUnused
3
- --!nolint LocalShadow
4
- local task = nil -- Disable usage of Roblox's task scheduler
5
-
6
- --[[
7
- Constructs and returns a new For state object which processes keys and
8
- preserves values.
9
-
10
- https://elttob.uk/Fusion/0.3/api-reference/state/members/forkeys/
11
-
12
- TODO: the sub objects constructed here can be more efficiently implemented
13
- as a dedicated state object.
14
- ]]
15
-
16
- local Package = script.Parent.Parent
17
- local Types = require(Package.Types)
18
- local External = require(Package.External)
19
- -- Memory
20
- local doCleanup = require(Package.Memory.doCleanup)
21
- -- State
22
- local For = require(Package.State.For)
23
- local Value = require(Package.State.Value)
24
- local Computed = require(Package.State.Computed)
25
- local ForTypes = require(Package.State.For.ForTypes)
26
- -- Logging
27
- local parseError = require(Package.Logging.parseError)
28
-
29
- local SUB_OBJECT_META = {
30
- __index = {
31
- roamKeys = false,
32
- roamValues = true,
33
- invalidateInputKey = function(self): ()
34
- self._inputKeyState:set(self.inputKey)
35
- end,
36
- invalidateInputValue = function(self): ()
37
- -- do nothing
38
- end,
39
- useOutputPair = function(self, use)
40
- return use(self._outputKeyState), self.inputValue
41
- end
42
- }
43
- }
44
-
45
- local function SubObject<KI, KO, V, S>(
46
- scope: Types.Scope<S>,
47
- initialKey: KI,
48
- initialValue: V,
49
- processor: (Types.Use, Types.Scope<S>, KI) -> KO
50
- ): ForTypes.SubObject<S, KI, KO, V, V>
51
- local self = {}
52
- self.maybeScope = scope
53
- self.inputKey = initialKey
54
- self.inputValue = initialValue
55
- self._inputKeyState = Value(scope, initialKey)
56
- self._processor = processor
57
- self._outputKeyState = Computed(scope, function(use, scope): KO?
58
- local inputKey = use(self._inputKeyState)
59
- local ok, outputKey = xpcall(self._processor, parseError, use, scope, inputKey)
60
- if ok then
61
- return outputKey
62
- else
63
- local error: Types.Error = outputKey :: any
64
- error.context = `while processing key {tostring(inputKey)}`
65
- External.logErrorNonFatal("callbackError", error)
66
- doCleanup(scope)
67
- table.clear(scope)
68
- return nil
69
- end
70
- end)
71
- return setmetatable(self, SUB_OBJECT_META) :: any
72
- end
73
-
74
- local function ForKeys<KI, KO, V, S>(
75
- scope: Types.Scope<S>,
76
- inputTable: Types.UsedAs<{[KI]: V}>,
77
- processor: (Types.Use, Types.Scope<S>, KI) -> KO,
78
- destructor: unknown?
79
- ): Types.For<KO, V>
80
- if typeof(inputTable) == "function" then
81
- External.logError("scopeMissing", nil, "ForKeys", "myScope:ForKeys(inputTable, function(scope, use, key) ... end)")
82
- elseif destructor ~= nil then
83
- External.logWarn("destructorRedundant", "ForKeys")
84
- end
85
- return For(
86
- scope,
87
- inputTable,
88
- function(scope, initialKey, initialValue)
89
- return SubObject(scope, initialKey, initialValue, processor)
90
- end
91
- )
92
- end
93
-
1
+ --!strict
2
+ --!nolint LocalUnused
3
+ --!nolint LocalShadow
4
+ local task = nil -- Disable usage of Roblox's task scheduler
5
+
6
+ --[[
7
+ Constructs and returns a new For state object which processes keys and
8
+ preserves values.
9
+
10
+ https://elttob.uk/Fusion/0.3/api-reference/state/members/forkeys/
11
+
12
+ TODO: the sub objects constructed here can be more efficiently implemented
13
+ as a dedicated state object.
14
+ ]]
15
+
16
+ local Package = script.Parent.Parent
17
+ local Types = require(Package.Types)
18
+ local External = require(Package.External)
19
+ -- Memory
20
+ local doCleanup = require(Package.Memory.doCleanup)
21
+ -- State
22
+ local For = require(Package.State.For)
23
+ local Value = require(Package.State.Value)
24
+ local Computed = require(Package.State.Computed)
25
+ local ForTypes = require(Package.State.For.ForTypes)
26
+ -- Logging
27
+ local parseError = require(Package.Logging.parseError)
28
+
29
+ local SUB_OBJECT_META = {
30
+ __index = {
31
+ roamKeys = false,
32
+ roamValues = true,
33
+ invalidateInputKey = function(self): ()
34
+ self._inputKeyState:set(self.inputKey)
35
+ end,
36
+ invalidateInputValue = function(self): ()
37
+ -- do nothing
38
+ end,
39
+ useOutputPair = function(self, use)
40
+ return use(self._outputKeyState), self.inputValue
41
+ end
42
+ }
43
+ }
44
+
45
+ local function SubObject<KI, KO, V, S>(
46
+ scope: Types.Scope<S>,
47
+ initialKey: KI,
48
+ initialValue: V,
49
+ processor: (Types.Use, Types.Scope<S>, KI) -> KO
50
+ ): ForTypes.SubObject<S, KI, KO, V, V>
51
+ local self = {}
52
+ self.maybeScope = scope
53
+ self.inputKey = initialKey
54
+ self.inputValue = initialValue
55
+ self._inputKeyState = Value(scope, initialKey)
56
+ self._processor = processor
57
+ self._outputKeyState = Computed(scope, function(use, scope): KO?
58
+ local inputKey = use(self._inputKeyState)
59
+ local ok, outputKey = xpcall(self._processor, parseError, use, scope, inputKey)
60
+ if ok then
61
+ return outputKey
62
+ else
63
+ local error: Types.Error = outputKey :: any
64
+ error.context = `while processing key {tostring(inputKey)}`
65
+ External.logErrorNonFatal("callbackError", error)
66
+ doCleanup(scope)
67
+ table.clear(scope)
68
+ return nil
69
+ end
70
+ end)
71
+ return setmetatable(self, SUB_OBJECT_META) :: any
72
+ end
73
+
74
+ local function ForKeys<KI, KO, V, S>(
75
+ scope: Types.Scope<S>,
76
+ inputTable: Types.UsedAs<{[KI]: V}>,
77
+ processor: (Types.Use, Types.Scope<S>, KI) -> KO,
78
+ destructor: unknown?
79
+ ): Types.For<KO, V>
80
+ if typeof(inputTable) == "function" then
81
+ External.logError("scopeMissing", nil, "ForKeys", "myScope:ForKeys(inputTable, function(scope, use, key) ... end)")
82
+ elseif destructor ~= nil then
83
+ External.logWarn("destructorRedundant", "ForKeys")
84
+ end
85
+ return For(
86
+ scope,
87
+ inputTable,
88
+ function(scope, initialKey, initialValue)
89
+ return SubObject(scope, initialKey, initialValue, processor)
90
+ end
91
+ )
92
+ end
93
+
94
94
  return ForKeys :: Types.ForKeysConstructor
@@ -1,97 +1,97 @@
1
- --!strict
2
- --!nolint LocalUnused
3
- --!nolint LocalShadow
4
- local task = nil -- Disable usage of Roblox's task scheduler
5
-
6
- --[[
7
- Constructs and returns a new For state object which processes keys and
8
- values in pairs.
9
-
10
- https://elttob.uk/Fusion/0.3/api-reference/state/members/forpairs/
11
-
12
- TODO: the sub objects constructed here can be more efficiently implemented
13
- as a dedicated state object.
14
- ]]
15
-
16
- local Package = script.Parent.Parent
17
- local Types = require(Package.Types)
18
- local External = require(Package.External)
19
- -- State
20
- local For = require(Package.State.For)
21
- local Value = require(Package.State.Value)
22
- local Computed = require(Package.State.Computed)
23
- local ForTypes = require(Package.State.For.ForTypes)
24
- -- Logging
25
- local parseError = require(Package.Logging.parseError)
26
- -- Memory
27
- local doCleanup = require(Package.Memory.doCleanup)
28
-
29
- local SUB_OBJECT_META = {
30
- __index = {
31
- roamKeys = false,
32
- roamValues = false,
33
- invalidateInputKey = function(self): ()
34
- self._inputKeyState:set(self.inputKey)
35
- end,
36
- invalidateInputValue = function(self): ()
37
- self._inputValueState:set(self.inputValue)
38
- end,
39
- useOutputPair = function(self, use)
40
- local pair = use(self._outputPairState)
41
- return pair.key, pair.value
42
- end
43
- }
44
- }
45
-
46
- local function SubObject<KI, KO, VI, VO, S>(
47
- scope: Types.Scope<S>,
48
- initialKey: KI,
49
- initialValue: VI,
50
- processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO)
51
- ): ForTypes.SubObject<S, KI, KO, VI, VO>
52
- local self = {}
53
- self.maybeScope = scope
54
- self.inputKey = initialKey
55
- self.inputValue = initialValue
56
- self._inputKeyState = Value(scope, initialKey)
57
- self._inputValueState = Value(scope, initialValue)
58
- self._processor = processor
59
- self._outputPairState = Computed(scope, function(use, scope): {key: KO?, value: VO?}
60
- local inputKey = use(self._inputKeyState)
61
- local inputValue = use(self._inputValueState)
62
- local ok, outputKey, outputValue = xpcall(self._processor, parseError, use, scope, inputKey, inputValue)
63
- if ok then
64
- return {key = outputKey, value = outputValue}
65
- else
66
- local error: Types.Error = outputKey :: any
67
- error.context = `while processing key {tostring(inputValue)} and value {tostring(inputValue)}`
68
- External.logErrorNonFatal("callbackError", error)
69
- doCleanup(scope)
70
- table.clear(scope)
71
- return {key = nil, value = nil}
72
- end
73
- end)
74
- return setmetatable(self, SUB_OBJECT_META) :: any
75
- end
76
-
77
- local function ForPairs<KI, KO, VI, VO, S>(
78
- scope: Types.Scope<S>,
79
- inputTable: Types.UsedAs<{[KI]: VI}>,
80
- processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO),
81
- destructor: unknown?
82
- ): Types.For<KO, VO>
83
- if typeof(inputTable) == "function" then
84
- External.logError("scopeMissing", nil, "ForPairs", "myScope:ForPairs(inputTable, function(scope, use, key, value) ... end)")
85
- elseif destructor ~= nil then
86
- External.logWarn("destructorRedundant", "ForPairs")
87
- end
88
- return For(
89
- scope,
90
- inputTable,
91
- function(scope, initialKey, initialValue)
92
- return SubObject(scope, initialKey, initialValue, processor)
93
- end
94
- )
95
- end
96
-
1
+ --!strict
2
+ --!nolint LocalUnused
3
+ --!nolint LocalShadow
4
+ local task = nil -- Disable usage of Roblox's task scheduler
5
+
6
+ --[[
7
+ Constructs and returns a new For state object which processes keys and
8
+ values in pairs.
9
+
10
+ https://elttob.uk/Fusion/0.3/api-reference/state/members/forpairs/
11
+
12
+ TODO: the sub objects constructed here can be more efficiently implemented
13
+ as a dedicated state object.
14
+ ]]
15
+
16
+ local Package = script.Parent.Parent
17
+ local Types = require(Package.Types)
18
+ local External = require(Package.External)
19
+ -- State
20
+ local For = require(Package.State.For)
21
+ local Value = require(Package.State.Value)
22
+ local Computed = require(Package.State.Computed)
23
+ local ForTypes = require(Package.State.For.ForTypes)
24
+ -- Logging
25
+ local parseError = require(Package.Logging.parseError)
26
+ -- Memory
27
+ local doCleanup = require(Package.Memory.doCleanup)
28
+
29
+ local SUB_OBJECT_META = {
30
+ __index = {
31
+ roamKeys = false,
32
+ roamValues = false,
33
+ invalidateInputKey = function(self): ()
34
+ self._inputKeyState:set(self.inputKey)
35
+ end,
36
+ invalidateInputValue = function(self): ()
37
+ self._inputValueState:set(self.inputValue)
38
+ end,
39
+ useOutputPair = function(self, use)
40
+ local pair = use(self._outputPairState)
41
+ return pair.key, pair.value
42
+ end
43
+ }
44
+ }
45
+
46
+ local function SubObject<KI, KO, VI, VO, S>(
47
+ scope: Types.Scope<S>,
48
+ initialKey: KI,
49
+ initialValue: VI,
50
+ processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO)
51
+ ): ForTypes.SubObject<S, KI, KO, VI, VO>
52
+ local self = {}
53
+ self.maybeScope = scope
54
+ self.inputKey = initialKey
55
+ self.inputValue = initialValue
56
+ self._inputKeyState = Value(scope, initialKey)
57
+ self._inputValueState = Value(scope, initialValue)
58
+ self._processor = processor
59
+ self._outputPairState = Computed(scope, function(use, scope): {key: KO?, value: VO?}
60
+ local inputKey = use(self._inputKeyState)
61
+ local inputValue = use(self._inputValueState)
62
+ local ok, outputKey, outputValue = xpcall(self._processor, parseError, use, scope, inputKey, inputValue)
63
+ if ok then
64
+ return {key = outputKey, value = outputValue}
65
+ else
66
+ local error: Types.Error = outputKey :: any
67
+ error.context = `while processing key {tostring(inputValue)} and value {tostring(inputValue)}`
68
+ External.logErrorNonFatal("callbackError", error)
69
+ doCleanup(scope)
70
+ table.clear(scope)
71
+ return {key = nil, value = nil}
72
+ end
73
+ end)
74
+ return setmetatable(self, SUB_OBJECT_META) :: any
75
+ end
76
+
77
+ local function ForPairs<KI, KO, VI, VO, S>(
78
+ scope: Types.Scope<S>,
79
+ inputTable: Types.UsedAs<{[KI]: VI}>,
80
+ processor: (Types.Use, Types.Scope<S>, KI, VI) -> (KO, VO),
81
+ destructor: unknown?
82
+ ): Types.For<KO, VO>
83
+ if typeof(inputTable) == "function" then
84
+ External.logError("scopeMissing", nil, "ForPairs", "myScope:ForPairs(inputTable, function(scope, use, key, value) ... end)")
85
+ elseif destructor ~= nil then
86
+ External.logWarn("destructorRedundant", "ForPairs")
87
+ end
88
+ return For(
89
+ scope,
90
+ inputTable,
91
+ function(scope, initialKey, initialValue)
92
+ return SubObject(scope, initialKey, initialValue, processor)
93
+ end
94
+ )
95
+ end
96
+
97
97
  return ForPairs :: Types.ForPairsConstructor