roblox-opencode 1.0.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 (248) hide show
  1. package/README.md +122 -0
  2. package/commands/setup-game.md +108 -0
  3. package/commands/sync-check.md +53 -0
  4. package/core/roblox-core.md +93 -0
  5. package/dist/server.js +167 -0
  6. package/package.json +35 -0
  7. package/skills/roblox-analytics/SKILL.md +277 -0
  8. package/skills/roblox-analytics/references/event-batcher.luau +75 -0
  9. package/skills/roblox-animation-vfx/SKILL.md +1325 -0
  10. package/skills/roblox-architecture/SKILL.md +863 -0
  11. package/skills/roblox-architecture/references/combat-systems.md +1381 -0
  12. package/skills/roblox-code-review/SKILL.md +687 -0
  13. package/skills/roblox-data/SKILL.md +889 -0
  14. package/skills/roblox-data/references/inventory-systems.md +1729 -0
  15. package/skills/roblox-debug/SKILL.md +99 -0
  16. package/skills/roblox-gui/SKILL.md +1103 -0
  17. package/skills/roblox-gui-fusion/SKILL.md +150 -0
  18. package/skills/roblox-gui-fusion/references/inventory.luau +427 -0
  19. package/skills/roblox-gui-fusion/references/settings-menu.luau +579 -0
  20. package/skills/roblox-gui-fusion/references/shop.luau +411 -0
  21. package/skills/roblox-luau-mastery/SKILL.md +1519 -0
  22. package/skills/roblox-monetization/SKILL.md +1084 -0
  23. package/skills/roblox-monetization/references/process-receipt.luau +131 -0
  24. package/skills/roblox-networking/SKILL.md +669 -0
  25. package/skills/roblox-networking/references/remote-validator.luau +193 -0
  26. package/skills/roblox-publish-checklist/SKILL.md +128 -0
  27. package/skills/roblox-runtime/SKILL.md +753 -0
  28. package/skills/roblox-sharp-edges/SKILL.md +295 -0
  29. package/skills/roblox-sync/SKILL.md +126 -0
  30. package/skills/roblox-testing/SKILL.md +943 -0
  31. package/skills/roblox-tooling/SKILL.md +150 -0
  32. package/vendor/LICENSES/ProfileStore-LICENSE +201 -0
  33. package/vendor/LICENSES/RbxUtil-LICENSE +7 -0
  34. package/vendor/LICENSES/promise-LICENSE +21 -0
  35. package/vendor/LICENSES/t-LICENSE +21 -0
  36. package/vendor/LICENSES/testez-LICENSE +201 -0
  37. package/vendor/README.md +84 -0
  38. package/vendor/fusion/Animation/ExternalTime.luau +84 -0
  39. package/vendor/fusion/Animation/Spring.luau +322 -0
  40. package/vendor/fusion/Animation/Stopwatch.luau +128 -0
  41. package/vendor/fusion/Animation/Tween.luau +187 -0
  42. package/vendor/fusion/Animation/getTweenDuration.luau +27 -0
  43. package/vendor/fusion/Animation/getTweenRatio.luau +47 -0
  44. package/vendor/fusion/Animation/lerpType.luau +164 -0
  45. package/vendor/fusion/Animation/packType.luau +100 -0
  46. package/vendor/fusion/Animation/springCoefficients.luau +80 -0
  47. package/vendor/fusion/Animation/unpackType.luau +103 -0
  48. package/vendor/fusion/Colour/Oklab.luau +70 -0
  49. package/vendor/fusion/Colour/sRGB.luau +55 -0
  50. package/vendor/fusion/External.luau +168 -0
  51. package/vendor/fusion/ExternalDebug.luau +70 -0
  52. package/vendor/fusion/Graph/Observer.luau +114 -0
  53. package/vendor/fusion/Graph/castToGraph.luau +29 -0
  54. package/vendor/fusion/Graph/change.luau +81 -0
  55. package/vendor/fusion/Graph/depend.luau +33 -0
  56. package/vendor/fusion/Graph/evaluate.luau +56 -0
  57. package/vendor/fusion/Instances/Attribute.luau +58 -0
  58. package/vendor/fusion/Instances/AttributeChange.luau +47 -0
  59. package/vendor/fusion/Instances/AttributeOut.luau +63 -0
  60. package/vendor/fusion/Instances/Child.luau +21 -0
  61. package/vendor/fusion/Instances/Children.luau +148 -0
  62. package/vendor/fusion/Instances/Hydrate.luau +33 -0
  63. package/vendor/fusion/Instances/New.luau +53 -0
  64. package/vendor/fusion/Instances/OnChange.luau +50 -0
  65. package/vendor/fusion/Instances/OnEvent.luau +54 -0
  66. package/vendor/fusion/Instances/Out.luau +69 -0
  67. package/vendor/fusion/Instances/applyInstanceProps.luau +149 -0
  68. package/vendor/fusion/Instances/defaultProps.luau +194 -0
  69. package/vendor/fusion/LICENSE +21 -0
  70. package/vendor/fusion/Logging/formatError.luau +49 -0
  71. package/vendor/fusion/Logging/messages.luau +52 -0
  72. package/vendor/fusion/Logging/parseError.luau +25 -0
  73. package/vendor/fusion/Memory/checkLifetime.luau +134 -0
  74. package/vendor/fusion/Memory/deriveScope.luau +24 -0
  75. package/vendor/fusion/Memory/deriveScopeImpl.luau +45 -0
  76. package/vendor/fusion/Memory/doCleanup.luau +79 -0
  77. package/vendor/fusion/Memory/innerScope.luau +34 -0
  78. package/vendor/fusion/Memory/legacyCleanup.luau +18 -0
  79. package/vendor/fusion/Memory/needsDestruction.luau +17 -0
  80. package/vendor/fusion/Memory/poisonScope.luau +34 -0
  81. package/vendor/fusion/Memory/scopePool.luau +55 -0
  82. package/vendor/fusion/Memory/scoped.luau +27 -0
  83. package/vendor/fusion/Memory/whichLivesLonger.luau +75 -0
  84. package/vendor/fusion/RobloxExternal.luau +98 -0
  85. package/vendor/fusion/State/Computed.luau +139 -0
  86. package/vendor/fusion/State/For/Disassembly.luau +211 -0
  87. package/vendor/fusion/State/For/ForTypes.luau +30 -0
  88. package/vendor/fusion/State/For/init.luau +110 -0
  89. package/vendor/fusion/State/ForKeys.luau +94 -0
  90. package/vendor/fusion/State/ForPairs.luau +97 -0
  91. package/vendor/fusion/State/ForValues.luau +94 -0
  92. package/vendor/fusion/State/Value.luau +88 -0
  93. package/vendor/fusion/State/castToState.luau +26 -0
  94. package/vendor/fusion/State/peek.luau +31 -0
  95. package/vendor/fusion/State/updateAll.luau +1 -0
  96. package/vendor/fusion/Types.luau +314 -0
  97. package/vendor/fusion/Utility/Contextual.luau +91 -0
  98. package/vendor/fusion/Utility/Safe.luau +23 -0
  99. package/vendor/fusion/Utility/isSimilar.luau +29 -0
  100. package/vendor/fusion/Utility/merge.luau +35 -0
  101. package/vendor/fusion/Utility/nameOf.luau +35 -0
  102. package/vendor/fusion/Utility/never.luau +14 -0
  103. package/vendor/fusion/Utility/nicknames.luau +11 -0
  104. package/vendor/fusion/Utility/xtypeof.luau +27 -0
  105. package/vendor/fusion/init.luau +82 -0
  106. package/vendor/profilestore/init.luau +2243 -0
  107. package/vendor/promise/init.luau +1982 -0
  108. package/vendor/rbxutil/buffer-util/Buffer.test.luau +25 -0
  109. package/vendor/rbxutil/buffer-util/BufferReader.luau +228 -0
  110. package/vendor/rbxutil/buffer-util/BufferWriter.luau +269 -0
  111. package/vendor/rbxutil/buffer-util/DataTypeBuffer.luau +223 -0
  112. package/vendor/rbxutil/buffer-util/Types.luau +60 -0
  113. package/vendor/rbxutil/buffer-util/index.d.ts +153 -0
  114. package/vendor/rbxutil/buffer-util/init.luau +41 -0
  115. package/vendor/rbxutil/buffer-util/package.json +16 -0
  116. package/vendor/rbxutil/buffer-util/wally.toml +9 -0
  117. package/vendor/rbxutil/comm/Client/ClientComm.luau +232 -0
  118. package/vendor/rbxutil/comm/Client/ClientRemoteProperty.luau +156 -0
  119. package/vendor/rbxutil/comm/Client/ClientRemoteSignal.luau +109 -0
  120. package/vendor/rbxutil/comm/Client/init.luau +135 -0
  121. package/vendor/rbxutil/comm/Server/RemoteProperty.luau +295 -0
  122. package/vendor/rbxutil/comm/Server/RemoteSignal.luau +211 -0
  123. package/vendor/rbxutil/comm/Server/ServerComm.luau +211 -0
  124. package/vendor/rbxutil/comm/Server/init.luau +140 -0
  125. package/vendor/rbxutil/comm/Types.luau +18 -0
  126. package/vendor/rbxutil/comm/Util.luau +27 -0
  127. package/vendor/rbxutil/comm/init.luau +35 -0
  128. package/vendor/rbxutil/comm/wally.toml +13 -0
  129. package/vendor/rbxutil/component/init.luau +759 -0
  130. package/vendor/rbxutil/component/init.test.luau +311 -0
  131. package/vendor/rbxutil/component/wally.toml +14 -0
  132. package/vendor/rbxutil/concur/init.luau +542 -0
  133. package/vendor/rbxutil/concur/init.test.luau +364 -0
  134. package/vendor/rbxutil/concur/wally.toml +8 -0
  135. package/vendor/rbxutil/enum-list/init.luau +101 -0
  136. package/vendor/rbxutil/enum-list/init.test.luau +91 -0
  137. package/vendor/rbxutil/enum-list/wally.toml +8 -0
  138. package/vendor/rbxutil/find/index.d.ts +20 -0
  139. package/vendor/rbxutil/find/init.luau +44 -0
  140. package/vendor/rbxutil/find/package.json +17 -0
  141. package/vendor/rbxutil/find/wally.toml +8 -0
  142. package/vendor/rbxutil/input/Gamepad.luau +559 -0
  143. package/vendor/rbxutil/input/Keyboard.luau +124 -0
  144. package/vendor/rbxutil/input/Mouse.luau +278 -0
  145. package/vendor/rbxutil/input/PreferredInput.luau +91 -0
  146. package/vendor/rbxutil/input/Touch.luau +120 -0
  147. package/vendor/rbxutil/input/init.luau +33 -0
  148. package/vendor/rbxutil/input/wally.toml +12 -0
  149. package/vendor/rbxutil/loader/index.d.ts +15 -0
  150. package/vendor/rbxutil/loader/init.luau +137 -0
  151. package/vendor/rbxutil/loader/wally.toml +8 -0
  152. package/vendor/rbxutil/log/index.d.ts +38 -0
  153. package/vendor/rbxutil/log/init.luau +746 -0
  154. package/vendor/rbxutil/log/wally.toml +8 -0
  155. package/vendor/rbxutil/net/init.luau +190 -0
  156. package/vendor/rbxutil/net/wally.toml +8 -0
  157. package/vendor/rbxutil/option/index.d.ts +44 -0
  158. package/vendor/rbxutil/option/init.luau +489 -0
  159. package/vendor/rbxutil/option/init.test.luau +342 -0
  160. package/vendor/rbxutil/option/wally.toml +8 -0
  161. package/vendor/rbxutil/pid/index.d.ts +53 -0
  162. package/vendor/rbxutil/pid/init.luau +195 -0
  163. package/vendor/rbxutil/pid/package.json +16 -0
  164. package/vendor/rbxutil/pid/wally.toml +9 -0
  165. package/vendor/rbxutil/quaternion/index.d.ts +117 -0
  166. package/vendor/rbxutil/quaternion/init.luau +570 -0
  167. package/vendor/rbxutil/quaternion/package.json +16 -0
  168. package/vendor/rbxutil/quaternion/wally.toml +9 -0
  169. package/vendor/rbxutil/query/index.d.ts +43 -0
  170. package/vendor/rbxutil/query/init.luau +117 -0
  171. package/vendor/rbxutil/query/package.json +18 -0
  172. package/vendor/rbxutil/query/wally.toml +9 -0
  173. package/vendor/rbxutil/sequent/index.d.ts +28 -0
  174. package/vendor/rbxutil/sequent/init.luau +340 -0
  175. package/vendor/rbxutil/sequent/package.json +16 -0
  176. package/vendor/rbxutil/sequent/wally.toml +9 -0
  177. package/vendor/rbxutil/ser/init.luau +175 -0
  178. package/vendor/rbxutil/ser/init.test.luau +50 -0
  179. package/vendor/rbxutil/ser/wally.toml +11 -0
  180. package/vendor/rbxutil/shake/index.d.ts +36 -0
  181. package/vendor/rbxutil/shake/init.luau +532 -0
  182. package/vendor/rbxutil/shake/init.test.luau +267 -0
  183. package/vendor/rbxutil/shake/package.json +16 -0
  184. package/vendor/rbxutil/shake/wally.toml +9 -0
  185. package/vendor/rbxutil/signal/index.d.ts +100 -0
  186. package/vendor/rbxutil/signal/init.luau +432 -0
  187. package/vendor/rbxutil/signal/init.test.luau +190 -0
  188. package/vendor/rbxutil/signal/package.json +17 -0
  189. package/vendor/rbxutil/signal/wally.toml +9 -0
  190. package/vendor/rbxutil/silo/TableWatcher.luau +65 -0
  191. package/vendor/rbxutil/silo/Util.luau +55 -0
  192. package/vendor/rbxutil/silo/init.luau +338 -0
  193. package/vendor/rbxutil/silo/init.test.luau +215 -0
  194. package/vendor/rbxutil/silo/wally.toml +8 -0
  195. package/vendor/rbxutil/spring/index.d.ts +40 -0
  196. package/vendor/rbxutil/spring/init.luau +97 -0
  197. package/vendor/rbxutil/spring/package.json +17 -0
  198. package/vendor/rbxutil/spring/wally.toml +8 -0
  199. package/vendor/rbxutil/stream/index.d.ts +88 -0
  200. package/vendor/rbxutil/stream/init.luau +597 -0
  201. package/vendor/rbxutil/stream/package.json +18 -0
  202. package/vendor/rbxutil/stream/wally.toml +9 -0
  203. package/vendor/rbxutil/streamable/Streamable.luau +202 -0
  204. package/vendor/rbxutil/streamable/StreamableUtil.luau +80 -0
  205. package/vendor/rbxutil/streamable/init.luau +8 -0
  206. package/vendor/rbxutil/streamable/wally.toml +12 -0
  207. package/vendor/rbxutil/symbol/init.luau +56 -0
  208. package/vendor/rbxutil/symbol/init.test.luau +37 -0
  209. package/vendor/rbxutil/symbol/wally.toml +8 -0
  210. package/vendor/rbxutil/table-util/init.luau +938 -0
  211. package/vendor/rbxutil/table-util/init.test.luau +439 -0
  212. package/vendor/rbxutil/table-util/wally.toml +8 -0
  213. package/vendor/rbxutil/task-queue/index.d.ts +27 -0
  214. package/vendor/rbxutil/task-queue/init.luau +97 -0
  215. package/vendor/rbxutil/task-queue/wally.toml +8 -0
  216. package/vendor/rbxutil/timer/index.d.ts +81 -0
  217. package/vendor/rbxutil/timer/init.luau +249 -0
  218. package/vendor/rbxutil/timer/init.test.luau +73 -0
  219. package/vendor/rbxutil/timer/wally.toml +11 -0
  220. package/vendor/rbxutil/tree/index.d.ts +15 -0
  221. package/vendor/rbxutil/tree/init.luau +137 -0
  222. package/vendor/rbxutil/tree/wally.toml +8 -0
  223. package/vendor/rbxutil/trove/index.d.ts +46 -0
  224. package/vendor/rbxutil/trove/init.luau +787 -0
  225. package/vendor/rbxutil/trove/init.test.luau +203 -0
  226. package/vendor/rbxutil/trove/wally.toml +8 -0
  227. package/vendor/rbxutil/typed-remote/init.luau +196 -0
  228. package/vendor/rbxutil/typed-remote/wally.toml +8 -0
  229. package/vendor/rbxutil/wait-for/index.d.ts +17 -0
  230. package/vendor/rbxutil/wait-for/init.luau +257 -0
  231. package/vendor/rbxutil/wait-for/init.test.luau +182 -0
  232. package/vendor/rbxutil/wait-for/wally.toml +11 -0
  233. package/vendor/t/t.lua +1350 -0
  234. package/vendor/testez/Context.lua +26 -0
  235. package/vendor/testez/Expectation.lua +311 -0
  236. package/vendor/testez/ExpectationContext.lua +38 -0
  237. package/vendor/testez/LifecycleHooks.lua +89 -0
  238. package/vendor/testez/Reporters/TeamCityReporter.lua +102 -0
  239. package/vendor/testez/Reporters/TextReporter.lua +106 -0
  240. package/vendor/testez/Reporters/TextReporterQuiet.lua +97 -0
  241. package/vendor/testez/TestBootstrap.lua +147 -0
  242. package/vendor/testez/TestEnum.lua +28 -0
  243. package/vendor/testez/TestPlan.lua +304 -0
  244. package/vendor/testez/TestPlanner.lua +40 -0
  245. package/vendor/testez/TestResults.lua +112 -0
  246. package/vendor/testez/TestRunner.lua +188 -0
  247. package/vendor/testez/TestSession.lua +243 -0
  248. package/vendor/testez/init.lua +40 -0
@@ -0,0 +1,223 @@
1
+ --!native
2
+
3
+ local Types = require(script.Parent.Types)
4
+
5
+ type ReadWritePair = {
6
+ read: <T>(reader: Types.BufferReader) -> T,
7
+ write: <T>(writer: Types.BufferWriter, value: T) -> (),
8
+ }
9
+
10
+ local DataTypeBuffer = {}
11
+
12
+ DataTypeBuffer.DataTypesToString = {
13
+ [BrickColor] = "BrickColor",
14
+ [CFrame] = "CFrame",
15
+ [Color3] = "Color3",
16
+ [DateTime] = "DateTime",
17
+ [Ray] = "Ray",
18
+ [Rect] = "Rect",
19
+ [Region3] = "Region3",
20
+ [Region3int16] = "Region3int16",
21
+ [UDim] = "UDim",
22
+ [UDim2] = "UDim2",
23
+ [Vector2] = "Vector2",
24
+ [Vector3] = "Vector3",
25
+ [Vector2int16] = "Vector2int16",
26
+ [Vector3int16] = "Vector3int16",
27
+ }
28
+
29
+ DataTypeBuffer.ReadWrite = {} :: { [string]: ReadWritePair }
30
+
31
+ DataTypeBuffer.ReadWrite.BrickColor = {
32
+ write = function(writer: Types.BufferWriter, brickColor: BrickColor)
33
+ writer:WriteUInt16(brickColor.Number)
34
+ end,
35
+
36
+ read = function(reader: Types.BufferReader): BrickColor
37
+ local number = reader:ReadUInt16()
38
+ return BrickColor.new(number)
39
+ end,
40
+ }
41
+
42
+ DataTypeBuffer.ReadWrite.CFrame = {
43
+ write = function(writer: Types.BufferWriter, cf: CFrame)
44
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, cf.Position)
45
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, cf.XVector)
46
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, cf.YVector)
47
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, cf.ZVector)
48
+ end,
49
+
50
+ read = function(reader: Types.BufferReader): CFrame
51
+ local pos = DataTypeBuffer.ReadWrite.Vector3.read(reader)
52
+ local vx = DataTypeBuffer.ReadWrite.Vector3.read(reader)
53
+ local vy = DataTypeBuffer.ReadWrite.Vector3.read(reader)
54
+ local vz = DataTypeBuffer.ReadWrite.Vector3.read(reader)
55
+ return CFrame.fromMatrix(pos, vx, vy, vz)
56
+ end,
57
+ }
58
+
59
+ DataTypeBuffer.ReadWrite.Color3 = {
60
+ write = function(writer: Types.BufferWriter, c: Color3)
61
+ writer:WriteFloat32(c.R)
62
+ writer:WriteFloat32(c.G)
63
+ writer:WriteFloat32(c.B)
64
+ end,
65
+
66
+ read = function(reader: Types.BufferReader): Color3
67
+ local r = reader:ReadFloat32()
68
+ local g = reader:ReadFloat32()
69
+ local b = reader:ReadFloat32()
70
+ return Color3.new(r, g, b)
71
+ end,
72
+ }
73
+
74
+ DataTypeBuffer.ReadWrite.DateTime = {
75
+ write = function(writer: Types.BufferWriter, dt: DateTime)
76
+ writer:WriteFloat64(dt.UnixTimestampMillis)
77
+ end,
78
+
79
+ read = function(reader: Types.BufferReader): DateTime
80
+ local millis = reader:ReadFloat64()
81
+ return DateTime.fromUnixTimestampMillis(millis)
82
+ end,
83
+ }
84
+
85
+ DataTypeBuffer.ReadWrite.Ray = {
86
+ write = function(writer: Types.BufferWriter, ray: Ray)
87
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, ray.Origin)
88
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, ray.Direction)
89
+ end,
90
+
91
+ read = function(reader: Types.BufferReader): Ray
92
+ local origin = DataTypeBuffer.ReadWrite.Vector3.read(reader)
93
+ local direction = DataTypeBuffer.ReadWrite.Vector3.read(reader)
94
+ return Ray.new(origin, direction)
95
+ end,
96
+ }
97
+
98
+ DataTypeBuffer.ReadWrite.Rect = {
99
+ write = function(writer: Types.BufferWriter, rect: Rect)
100
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, rect.Min)
101
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, rect.Max)
102
+ end,
103
+
104
+ read = function(reader: Types.BufferReader): Rect
105
+ local min = DataTypeBuffer.ReadWrite.Vector3.read(reader)
106
+ local max = DataTypeBuffer.ReadWrite.Vector3.read(reader)
107
+ return Rect.new(min, max)
108
+ end,
109
+ }
110
+
111
+ DataTypeBuffer.ReadWrite.Region3 = {
112
+ write = function(writer: Types.BufferWriter, region3: Region3)
113
+ local pos = region3.CFrame.Position
114
+ local sizeHalf = region3.Size * 0.5
115
+ local min = pos - sizeHalf
116
+ local max = pos + sizeHalf
117
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, min)
118
+ DataTypeBuffer.ReadWrite.Vector3.write(writer, max)
119
+ end,
120
+
121
+ read = function(reader: Types.BufferReader): Region3
122
+ local min = DataTypeBuffer.ReadWrite.Vector3.read(reader)
123
+ local max = DataTypeBuffer.ReadWrite.Vector3.read(reader)
124
+ return Region3.new(min, max)
125
+ end,
126
+ }
127
+
128
+ DataTypeBuffer.ReadWrite.Region3int16 = {
129
+ write = function(writer: Types.BufferWriter, region3int16: Region3int16)
130
+ DataTypeBuffer.ReadWrite.Vector3int16.write(writer, region3int16.Min)
131
+ DataTypeBuffer.ReadWrite.Vector3int16.write(writer, region3int16.Max)
132
+ end,
133
+
134
+ read = function(reader: Types.BufferReader): Region3int16
135
+ local min = DataTypeBuffer.ReadWrite.Vector3int16.read(reader)
136
+ local max = DataTypeBuffer.ReadWrite.Vector3int16.read(reader)
137
+ return Region3int16.new(min, max)
138
+ end,
139
+ }
140
+
141
+ DataTypeBuffer.ReadWrite.UDim = {
142
+ write = function(writer: Types.BufferWriter, udim: UDim)
143
+ writer:WriteFloat32(udim.Scale)
144
+ writer:WriteInt32(udim.Offset)
145
+ end,
146
+
147
+ read = function(reader: Types.BufferReader): UDim
148
+ local scale = reader:ReadFloat32()
149
+ local offset = reader:ReadInt32()
150
+ return UDim.new(scale, offset)
151
+ end,
152
+ }
153
+
154
+ DataTypeBuffer.ReadWrite.UDim2 = {
155
+ write = function(writer: Types.BufferWriter, udim2: UDim2)
156
+ DataTypeBuffer.ReadWrite.UDim.write(writer, udim2.X)
157
+ DataTypeBuffer.ReadWrite.UDim.write(writer, udim2.Y)
158
+ end,
159
+
160
+ read = function(reader: Types.BufferReader): UDim2
161
+ local x = DataTypeBuffer.ReadWrite.UDim.read(reader)
162
+ local y = DataTypeBuffer.ReadWrite.UDim.read(reader)
163
+ return UDim2.new(x, y)
164
+ end,
165
+ }
166
+
167
+ DataTypeBuffer.ReadWrite.Vector2 = {
168
+ write = function(writer: Types.BufferWriter, v2: Vector2)
169
+ writer:WriteFloat32(v2.X)
170
+ writer:WriteFloat32(v2.Y)
171
+ end,
172
+
173
+ read = function(reader: Types.BufferReader): Vector2
174
+ local x = reader:ReadFloat32()
175
+ local y = reader:ReadFloat32()
176
+ return Vector2.new(x, y)
177
+ end,
178
+ }
179
+
180
+ DataTypeBuffer.ReadWrite.Vector3 = {
181
+ write = function(writer: Types.BufferWriter, v3: Vector3)
182
+ writer:WriteFloat32(v3.X)
183
+ writer:WriteFloat32(v3.Y)
184
+ writer:WriteFloat32(v3.Z)
185
+ end,
186
+
187
+ read = function(reader: Types.BufferReader): Vector3
188
+ local x = reader:ReadFloat32()
189
+ local y = reader:ReadFloat32()
190
+ local z = reader:ReadFloat32()
191
+ return Vector3.new(x, y, z)
192
+ end,
193
+ }
194
+
195
+ DataTypeBuffer.ReadWrite.Vector2int16 = {
196
+ write = function(writer: Types.BufferWriter, v2: Vector2int16)
197
+ writer:WriteInt16(v2.X)
198
+ writer:WriteInt16(v2.Y)
199
+ end,
200
+
201
+ read = function(reader: Types.BufferReader): Vector2int16
202
+ local x = reader:ReadInt16()
203
+ local y = reader:ReadInt16()
204
+ return Vector2int16.new(x, y)
205
+ end,
206
+ }
207
+
208
+ DataTypeBuffer.ReadWrite.Vector3int16 = {
209
+ write = function(writer: Types.BufferWriter, v3: Vector3int16)
210
+ writer:WriteInt16(v3.X)
211
+ writer:WriteInt16(v3.Y)
212
+ writer:WriteInt16(v3.Z)
213
+ end,
214
+
215
+ read = function(reader: Types.BufferReader): Vector3int16
216
+ local x = reader:ReadInt16()
217
+ local y = reader:ReadInt16()
218
+ local z = reader:ReadInt16()
219
+ return Vector3int16.new(x, y, z)
220
+ end,
221
+ }
222
+
223
+ return DataTypeBuffer
@@ -0,0 +1,60 @@
1
+ export type DataTypes =
2
+ | BrickColor
3
+ | CFrame
4
+ | Color3
5
+ | DateTime
6
+ | Ray
7
+ | Rect
8
+ | Region3
9
+ | Region3int16
10
+ | UDim
11
+ | UDim2
12
+ | Vector2
13
+ | Vector3
14
+ | Vector2int16
15
+ | Vector3int16
16
+
17
+ export type BufferReader = {
18
+ ReadInt8: (self: BufferReader) -> number,
19
+ ReadUInt8: (self: BufferReader) -> number,
20
+ ReadInt16: (self: BufferReader) -> number,
21
+ ReadUInt16: (self: BufferReader) -> number,
22
+ ReadInt32: (self: BufferReader) -> number,
23
+ ReadUInt32: (self: BufferReader) -> number,
24
+ ReadFloat32: (self: BufferReader) -> number,
25
+ ReadFloat64: (self: BufferReader) -> number,
26
+ ReadBool: (self: BufferReader) -> boolean,
27
+ ReadString: (self: BufferReader) -> string,
28
+ ReadStringRaw: (self: BufferReader, length: number) -> string,
29
+ ReadDataType: <T>(self: BufferReader, dataType: { new: (...any) -> T }) -> T,
30
+ GetSize: (self: BufferReader) -> number,
31
+ ResetCursor: (self: BufferReader) -> (),
32
+ SetCursor: (self: BufferReader, cursorPosition: number) -> (),
33
+ GetCursor: (self: BufferReader) -> number,
34
+ GetBuffer: (self: BufferReader) -> buffer,
35
+ }
36
+
37
+ export type BufferWriter = {
38
+ WriteInt8: (self: BufferWriter, int8: number) -> (),
39
+ WriteUInt8: (self: BufferWriter, uint8: number) -> (),
40
+ WriteInt16: (self: BufferWriter, int16: number) -> (),
41
+ WriteUInt16: (self: BufferWriter, uint16: number) -> (),
42
+ WriteInt32: (self: BufferWriter, int32: number) -> (),
43
+ WriteUInt32: (self: BufferWriter, uint32: number) -> (),
44
+ WriteFloat32: (self: BufferWriter, f32: number) -> (),
45
+ WriteFloat64: (self: BufferWriter, f64: number) -> (),
46
+ WriteBool: (self: BufferWriter, bool: boolean) -> (),
47
+ WriteString: (self: BufferWriter, str: string, length: number?) -> (),
48
+ WriteStringRaw: (self: BufferWriter, str: string, length: number?) -> (),
49
+ WriteDataType: (self: BufferWriter, data: DataTypes) -> (),
50
+ GetSize: (self: BufferWriter) -> number,
51
+ GetCapacity: (self: BufferWriter) -> number,
52
+ ResetCursor: (self: BufferWriter) -> (),
53
+ SetCursor: (self: BufferWriter, cursorPosition: number) -> (),
54
+ GetCursor: (self: BufferWriter) -> number,
55
+ Shrink: (self: BufferWriter) -> (),
56
+ GetBuffer: (self: BufferWriter) -> buffer,
57
+ ToString: (self: BufferWriter) -> string,
58
+ }
59
+
60
+ return nil
@@ -0,0 +1,153 @@
1
+ declare namespace BufferUtil {
2
+ type DataTypes =
3
+ | BrickColor
4
+ | CFrame
5
+ | Color3
6
+ | DateTime
7
+ | Ray
8
+ | Rect
9
+ | Region3
10
+ | Region3int16
11
+ | UDim
12
+ | UDim2
13
+ | Vector2
14
+ | Vector3
15
+ | Vector2int16
16
+ | Vector3int16;
17
+
18
+ interface Util {
19
+ /** Create a BufferReader from the given `buffer` or string. */
20
+ reader: (buf: buffer | string | BufferWriter) => BufferReader;
21
+
22
+ /** Create a zero-initialized BufferWriter with an optional initial byte capacity. */
23
+ writer: (initialCapacity?: number) => BufferWriter;
24
+ }
25
+
26
+ interface BufferReader {
27
+ /** Read a signed 8-bit integer from the buffer. */
28
+ ReadInt8(): number;
29
+
30
+ /** Read an unsigned 8-bit integer from the buffer. */
31
+ ReadUInt8(): number;
32
+
33
+ /** Read a signed 16-bit integer from the buffer. */
34
+ ReadInt16(): number;
35
+
36
+ /** Read an unsigned 16-bit integer from the buffer. */
37
+ ReadUInt16(): number;
38
+
39
+ /** Read a signed 32-bit integer from the buffer. */
40
+ ReadInt32(): number;
41
+
42
+ /** Read an unsigned 32-bit integer from the buffer. */
43
+ ReadUInt32(): number;
44
+
45
+ /** Read a 32-bit single-precision float from the buffer. */
46
+ ReadFloat32(): number;
47
+
48
+ /** Read a 64-bit double-precision float from the buffer. */
49
+ ReadFloat64(): number;
50
+
51
+ /** Read a bool from the buffer. */
52
+ ReadBool(): boolean;
53
+
54
+ /** Read a string from the buffer. */
55
+ ReadString(): string;
56
+
57
+ /** Read a raw string from the buffer. */
58
+ ReadStringRaw(length: number): string;
59
+
60
+ /** Read a DataType from the buffer. */
61
+ ReadDataType<T extends DataTypes>(dataType: new (...args: unknown[]) => T): T;
62
+
63
+ /** Returns the position of the cursor. */
64
+ GetCursor(): number;
65
+
66
+ /** Sets the position of the cursor. */
67
+ SetCursor(position: number): void;
68
+
69
+ /** Resets the position of the cursor. */
70
+ ResetCursor(): void;
71
+
72
+ /** Returns the size of the buffer. */
73
+ GetSize(): number;
74
+
75
+ /** Returns the `buffer` object. */
76
+ GetBuffer(): buffer;
77
+ }
78
+
79
+ interface BufferWriter {
80
+ /** Write a signed 8-bit integer to the buffer. */
81
+ WriteInt8(int8: number): void;
82
+
83
+ /** Write an unsigned 8-bit integer to the buffer. */
84
+ WriteUInt8(uint8: number): void;
85
+
86
+ /** Write a signed 16-bit integer to the buffer. */
87
+ WriteInt16(int16: number): void;
88
+
89
+ /** Write an unsigned 16-bit integer to the buffer. */
90
+ WriteUInt16(uint16: number): void;
91
+
92
+ /** Write a signed 32-bit integer to the buffer. */
93
+ WriteInt32(int32: number): void;
94
+
95
+ /** Write an unsigned 32-bit integer to the buffer. */
96
+ WriteUInt32(uint32: number): void;
97
+
98
+ /** Write a 32-bit single-precision float to the buffer. */
99
+ WriteFloat32(f32: number): void;
100
+
101
+ /** Write a 64-bit double-precision float to the buffer. */
102
+ WriteFloat64(f64: number): void;
103
+
104
+ /** Write a boolean to the buffer. */
105
+ WriteBool(bool: boolean): void;
106
+
107
+ /** Write a string to the buffer, with an optional `length` of bytes taken from the string. */
108
+ WriteString(str: string, length?: number): void;
109
+
110
+ /** Write a raw string to the buffer, with an optional `length` of bytes taken from the string. */
111
+ WriteStringRaw(str: string, length?: number): void;
112
+
113
+ /** Write a DataType to the buffer. */
114
+ WriteDataType<T extends DataTypes>(data: T): void;
115
+
116
+ /** Shrinks the capacity of the buffer to the current data size. */
117
+ Shrink(): void;
118
+
119
+ /**
120
+ * Returns the current data size of the buffer. This is _not_ necessarily
121
+ * equal to the capacity of the buffer.
122
+ */
123
+ GetSize(): number;
124
+
125
+ /**
126
+ * Returns the current capacity of the buffer. This is the length of the
127
+ * internal buffer, which is usually not the same as the length of the stored
128
+ * data.
129
+ *
130
+ * The buffer capacity automatically grows as data is added.
131
+ */
132
+ GetCapacity(): number;
133
+
134
+ /** Returns the `buffer` object. */
135
+ GetBuffer(): buffer;
136
+
137
+ /** Sets the position of the cursor. */
138
+ SetCursor(position: number): void;
139
+
140
+ /** Gets the position of the cursor. */
141
+ GetCursor(): number;
142
+
143
+ /** Resets the position of the cursor. */
144
+ ResetCursor(): number;
145
+
146
+ /** Returns the string version of the internal buffer. */
147
+ ToString(): string;
148
+ }
149
+ }
150
+
151
+ declare const BufferUtil: BufferUtil.Util;
152
+
153
+ export = BufferUtil;
@@ -0,0 +1,41 @@
1
+ --!native
2
+
3
+ local BufferReader = require(script.BufferReader)
4
+ local BufferWriter = require(script.BufferWriter)
5
+
6
+ --[=[
7
+ @class BufferUtil
8
+ ]=]
9
+
10
+ --[=[
11
+ @within BufferUtil
12
+ @function reader
13
+ @param buf buffer | string
14
+ @return BufferReader
15
+
16
+ Creates a BufferReader. The reader can be constructed from either
17
+ a string or a `buffer` object.
18
+
19
+ ```lua
20
+ local reader = BufferUtil.reader()
21
+ ```
22
+ ]=]
23
+
24
+ --[=[
25
+ @within BufferUtil
26
+ @function writer
27
+ @param initialCapacity number?
28
+ @return BufferWriter
29
+
30
+ Creates a zero-initialized BufferWriter. An initial capacity can
31
+ optionally be set, and is defaulted to `0`.
32
+
33
+ ```lua
34
+ local writer = BufferUtil.writer()
35
+ ```
36
+ ]=]
37
+
38
+ return {
39
+ reader = BufferReader.new,
40
+ writer = BufferWriter.new,
41
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "@rbxutil/buffer-util",
3
+ "version": "0.3.2",
4
+ "main": "init.luau",
5
+ "repository": "github:Sleitnick/RbxUtil",
6
+ "license": "MIT",
7
+ "types": "index.d.ts",
8
+ "files": [
9
+ "./",
10
+ "!*.toml",
11
+ "!*.json"
12
+ ],
13
+ "publishConfig": {
14
+ "access": "public"
15
+ }
16
+ }
@@ -0,0 +1,9 @@
1
+ [package]
2
+ name = "sleitnick/buffer-util"
3
+ description = "Buffer utilities"
4
+ version = "0.3.2"
5
+ license = "MIT"
6
+ authors = ["Stephen Leitnick"]
7
+ registry = "https://github.com/UpliftGames/wally-index"
8
+ realm = "shared"
9
+ exclude = ["node_modules", "package.json", "**/*.ts", "**/*.test.luau"]