lawspec 0.31.0 → 0.31.3

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 (437) hide show
  1. package/CHANGELOG.md +116 -1
  2. package/README.md +86 -4
  3. package/api.mjs +14 -9
  4. package/authoring.mjs +899 -0
  5. package/beam-coverage.mjs +190 -65
  6. package/beam-doctor.mjs +343 -124
  7. package/bin/lawspec.mjs +1955 -657
  8. package/build.json +135 -129
  9. package/component-packages.mjs +662 -176
  10. package/component.d.ts +82 -20
  11. package/component.mjs +317 -94
  12. package/core.wasm +2 -2
  13. package/core_jsffi.js +5 -5
  14. package/doctor.mjs +558 -299
  15. package/examples-command.mjs +44 -23
  16. package/failure-database.mjs +60 -17
  17. package/files.mjs +122 -62
  18. package/index.d.ts +585 -312
  19. package/input-files.mjs +90 -25
  20. package/launcher.mjs +72 -31
  21. package/learn/adapters.mjs +226 -0
  22. package/learn/app.mjs +1279 -0
  23. package/learn/assert.mjs +33 -0
  24. package/learn/assets.mjs +15 -0
  25. package/learn/browser-runtime.mjs +58 -0
  26. package/learn/bundle.mjs +118 -0
  27. package/learn/compile-worker.mjs +106 -0
  28. package/learn/compiler.mjs +230 -0
  29. package/learn/coverage.json +8259 -0
  30. package/learn/curriculum.json +2955 -0
  31. package/learn/fantomas-worker.mjs +25 -0
  32. package/learn/format-worker.mjs +148 -0
  33. package/learn/fsharp.mjs +83 -0
  34. package/learn/harness-host.mjs +22 -0
  35. package/learn/index.html +326 -0
  36. package/learn/lawspec-core.mjs +223 -0
  37. package/learn/lawspec-language.mjs +69 -0
  38. package/learn/node-test.mjs +11 -0
  39. package/learn/presentation.mjs +73 -0
  40. package/learn/runner.mjs +72 -0
  41. package/learn/sandbox-frame.html +34 -0
  42. package/learn/sandbox.mjs +91 -0
  43. package/learn/store.mjs +141 -0
  44. package/learn/story.mjs +42 -0
  45. package/learn/style-options.json +16 -0
  46. package/learn/style.css +1023 -0
  47. package/learn/theme.js +77 -0
  48. package/learn/typescript.mjs +53 -0
  49. package/learn/vendor/@fontsource-atkinson-hyperlegible-LICENSE.txt +93 -0
  50. package/learn/vendor/@fontsource-atkinson-hyperlegible-mono-LICENSE.txt +93 -0
  51. package/learn/vendor/@fontsource-overpass-LICENSE.txt +93 -0
  52. package/learn/vendor/assemblies.json +1 -0
  53. package/learn/vendor/editor-worker.js +30 -0
  54. package/learn/vendor/editor.css +1 -0
  55. package/learn/vendor/editor.mjs +931 -0
  56. package/learn/vendor/esbuild-wasm-LICENSE.txt +21 -0
  57. package/learn/vendor/esbuild.mjs +2683 -0
  58. package/learn/vendor/esbuild.wasm +0 -0
  59. package/learn/vendor/fable-library/Array.js +1347 -0
  60. package/learn/vendor/fable-library/Async.js +134 -0
  61. package/learn/vendor/fable-library/AsyncBuilder.js +183 -0
  62. package/learn/vendor/fable-library/BigInt.js +306 -0
  63. package/learn/vendor/fable-library/BitConverter.js +138 -0
  64. package/learn/vendor/fable-library/Boolean.js +22 -0
  65. package/learn/vendor/fable-library/CHANGELOG.md +242 -0
  66. package/learn/vendor/fable-library/Char.js +202 -0
  67. package/learn/vendor/fable-library/Choice.js +184 -0
  68. package/learn/vendor/fable-library/CollectionUtil.js +182 -0
  69. package/learn/vendor/fable-library/ConditionalWeakTable.js +21 -0
  70. package/learn/vendor/fable-library/Date.js +841 -0
  71. package/learn/vendor/fable-library/DateOffset.js +261 -0
  72. package/learn/vendor/fable-library/DateOnly.js +124 -0
  73. package/learn/vendor/fable-library/Decimal.js +238 -0
  74. package/learn/vendor/fable-library/Double.js +47 -0
  75. package/learn/vendor/fable-library/Encoding.js +185 -0
  76. package/learn/vendor/fable-library/Event.js +93 -0
  77. package/learn/vendor/fable-library/FSharp.Collections.js +45 -0
  78. package/learn/vendor/fable-library/FSharp.Core.CompilerServices.js +27 -0
  79. package/learn/vendor/fable-library/FSharp.Core.js +156 -0
  80. package/learn/vendor/fable-library/Global.js +29 -0
  81. package/learn/vendor/fable-library/Guid.js +161 -0
  82. package/learn/vendor/fable-library/Int32.js +135 -0
  83. package/learn/vendor/fable-library/List.js +1323 -0
  84. package/learn/vendor/fable-library/Long.js +47 -0
  85. package/learn/vendor/fable-library/MailboxProcessor.js +94 -0
  86. package/learn/vendor/fable-library/Map.js +1396 -0
  87. package/learn/vendor/fable-library/MapUtil.js +130 -0
  88. package/learn/vendor/fable-library/MutableMap.js +339 -0
  89. package/learn/vendor/fable-library/MutableSet.js +233 -0
  90. package/learn/vendor/fable-library/Native.js +14 -0
  91. package/learn/vendor/fable-library/Numeric.js +75 -0
  92. package/learn/vendor/fable-library/Observable.js +113 -0
  93. package/learn/vendor/fable-library/Option.js +104 -0
  94. package/learn/vendor/fable-library/README.md +3 -0
  95. package/learn/vendor/fable-library/Random.js +172 -0
  96. package/learn/vendor/fable-library/Range.js +45 -0
  97. package/learn/vendor/fable-library/Reflection.js +479 -0
  98. package/learn/vendor/fable-library/RegExp.js +141 -0
  99. package/learn/vendor/fable-library/Result.js +165 -0
  100. package/learn/vendor/fable-library/Seq.js +1417 -0
  101. package/learn/vendor/fable-library/Seq2.js +111 -0
  102. package/learn/vendor/fable-library/Set.js +1816 -0
  103. package/learn/vendor/fable-library/String.js +674 -0
  104. package/learn/vendor/fable-library/System.Collections.Generic.js +333 -0
  105. package/learn/vendor/fable-library/System.Text.js +200 -0
  106. package/learn/vendor/fable-library/System.js +289 -0
  107. package/learn/vendor/fable-library/TimeOnly.js +122 -0
  108. package/learn/vendor/fable-library/TimeSpan.js +180 -0
  109. package/learn/vendor/fable-library/Timer.js +67 -0
  110. package/learn/vendor/fable-library/Types.js +198 -0
  111. package/learn/vendor/fable-library/Unicode.13.0.0.js +4 -0
  112. package/learn/vendor/fable-library/Uri.js +165 -0
  113. package/learn/vendor/fable-library/Util.js +796 -0
  114. package/learn/vendor/fable-library/big.d.ts +338 -0
  115. package/learn/vendor/fable-library/lib/big.js +825 -0
  116. package/learn/vendor/fable-library/package.json +24 -0
  117. package/learn/vendor/fable-library/quotation.js +618 -0
  118. package/learn/vendor/fable.js +430 -0
  119. package/learn/vendor/fantomas/FSharp.Core.uawo19tl4c.wasm +0 -0
  120. package/learn/vendor/fantomas/Fantomas.Core.stnanlnpyw.wasm +0 -0
  121. package/learn/vendor/fantomas/Fantomas.FCS.lqohfu5o9y.wasm +0 -0
  122. package/learn/vendor/fantomas/LawSpec.Learn.Formatter.poiijdbsl9.wasm +0 -0
  123. package/learn/vendor/fantomas/Microsoft.CSharp.mp8lhr6rez.wasm +0 -0
  124. package/learn/vendor/fantomas/Microsoft.VisualBasic.0e5fchkecn.wasm +0 -0
  125. package/learn/vendor/fantomas/Microsoft.VisualBasic.Core.17wn27qal2.wasm +0 -0
  126. package/learn/vendor/fantomas/Microsoft.Win32.Primitives.9d566sle9e.wasm +0 -0
  127. package/learn/vendor/fantomas/Microsoft.Win32.Registry.52dy96yk8i.wasm +0 -0
  128. package/learn/vendor/fantomas/System.AppContext.jwujeh069z.wasm +0 -0
  129. package/learn/vendor/fantomas/System.Buffers.y0isk1x97h.wasm +0 -0
  130. package/learn/vendor/fantomas/System.Collections.Concurrent.x5koi7bzem.wasm +0 -0
  131. package/learn/vendor/fantomas/System.Collections.Immutable.diwg7advch.wasm +0 -0
  132. package/learn/vendor/fantomas/System.Collections.NonGeneric.4089xs440e.wasm +0 -0
  133. package/learn/vendor/fantomas/System.Collections.Specialized.hj81u7zblb.wasm +0 -0
  134. package/learn/vendor/fantomas/System.Collections.nvrdeoknr1.wasm +0 -0
  135. package/learn/vendor/fantomas/System.ComponentModel.Annotations.yatcnfjeuk.wasm +0 -0
  136. package/learn/vendor/fantomas/System.ComponentModel.DataAnnotations.led9l5awu3.wasm +0 -0
  137. package/learn/vendor/fantomas/System.ComponentModel.EventBasedAsync.hpvp6cf4de.wasm +0 -0
  138. package/learn/vendor/fantomas/System.ComponentModel.Primitives.v7cajwpaqo.wasm +0 -0
  139. package/learn/vendor/fantomas/System.ComponentModel.TypeConverter.xk1hnyt762.wasm +0 -0
  140. package/learn/vendor/fantomas/System.ComponentModel.rrnda1lucx.wasm +0 -0
  141. package/learn/vendor/fantomas/System.Configuration.bn9vghjcq8.wasm +0 -0
  142. package/learn/vendor/fantomas/System.Console.09ajpiafhz.wasm +0 -0
  143. package/learn/vendor/fantomas/System.Core.wc649o5mw9.wasm +0 -0
  144. package/learn/vendor/fantomas/System.Data.Common.s4cowzd9a9.wasm +0 -0
  145. package/learn/vendor/fantomas/System.Data.DataSetExtensions.5fm360ikxl.wasm +0 -0
  146. package/learn/vendor/fantomas/System.Data.fsu4j4t4jw.wasm +0 -0
  147. package/learn/vendor/fantomas/System.Diagnostics.Contracts.p74re5oxzn.wasm +0 -0
  148. package/learn/vendor/fantomas/System.Diagnostics.Debug.622sixg49n.wasm +0 -0
  149. package/learn/vendor/fantomas/System.Diagnostics.DiagnosticSource.2j35bc2g2b.wasm +0 -0
  150. package/learn/vendor/fantomas/System.Diagnostics.FileVersionInfo.7n0wdvltaa.wasm +0 -0
  151. package/learn/vendor/fantomas/System.Diagnostics.Process.8iffh49mew.wasm +0 -0
  152. package/learn/vendor/fantomas/System.Diagnostics.StackTrace.1yz88vico8.wasm +0 -0
  153. package/learn/vendor/fantomas/System.Diagnostics.TextWriterTraceListener.ua8iuh2vhj.wasm +0 -0
  154. package/learn/vendor/fantomas/System.Diagnostics.Tools.roy5445ugj.wasm +0 -0
  155. package/learn/vendor/fantomas/System.Diagnostics.TraceSource.6qx1ldzz7g.wasm +0 -0
  156. package/learn/vendor/fantomas/System.Diagnostics.Tracing.b4799zpaas.wasm +0 -0
  157. package/learn/vendor/fantomas/System.Drawing.8gcjjqj0pu.wasm +0 -0
  158. package/learn/vendor/fantomas/System.Drawing.Primitives.y2uveru2yk.wasm +0 -0
  159. package/learn/vendor/fantomas/System.Dynamic.Runtime.023zrvzh9x.wasm +0 -0
  160. package/learn/vendor/fantomas/System.Formats.Asn1.znpklkbgqv.wasm +0 -0
  161. package/learn/vendor/fantomas/System.Formats.Tar.5yybjepfi2.wasm +0 -0
  162. package/learn/vendor/fantomas/System.Globalization.Calendars.10g6hyjy3k.wasm +0 -0
  163. package/learn/vendor/fantomas/System.Globalization.Extensions.hrinfrismg.wasm +0 -0
  164. package/learn/vendor/fantomas/System.Globalization.uvs4rah8fk.wasm +0 -0
  165. package/learn/vendor/fantomas/System.IO.4j645gw40d.wasm +0 -0
  166. package/learn/vendor/fantomas/System.IO.Compression.2z7vdt6tfb.wasm +0 -0
  167. package/learn/vendor/fantomas/System.IO.Compression.Brotli.fv80xs79j3.wasm +0 -0
  168. package/learn/vendor/fantomas/System.IO.Compression.FileSystem.88jdddz3sw.wasm +0 -0
  169. package/learn/vendor/fantomas/System.IO.Compression.ZipFile.jkn9avr4vo.wasm +0 -0
  170. package/learn/vendor/fantomas/System.IO.FileSystem.AccessControl.yme0uhbu37.wasm +0 -0
  171. package/learn/vendor/fantomas/System.IO.FileSystem.DriveInfo.qas7wf73rs.wasm +0 -0
  172. package/learn/vendor/fantomas/System.IO.FileSystem.Primitives.d1jmhkzu0e.wasm +0 -0
  173. package/learn/vendor/fantomas/System.IO.FileSystem.Watcher.z570derp0d.wasm +0 -0
  174. package/learn/vendor/fantomas/System.IO.FileSystem.o6jtz51fup.wasm +0 -0
  175. package/learn/vendor/fantomas/System.IO.IsolatedStorage.hqyeyb5ipe.wasm +0 -0
  176. package/learn/vendor/fantomas/System.IO.MemoryMappedFiles.zhamjnusxd.wasm +0 -0
  177. package/learn/vendor/fantomas/System.IO.Pipelines.wrmw5vws31.wasm +0 -0
  178. package/learn/vendor/fantomas/System.IO.Pipes.AccessControl.qcancj8gj2.wasm +0 -0
  179. package/learn/vendor/fantomas/System.IO.Pipes.zhcyguvwkr.wasm +0 -0
  180. package/learn/vendor/fantomas/System.IO.UnmanagedMemoryStream.o8cpjnlard.wasm +0 -0
  181. package/learn/vendor/fantomas/System.Linq.AsyncEnumerable.hyc0b7okjw.wasm +0 -0
  182. package/learn/vendor/fantomas/System.Linq.Expressions.ldibvm0efj.wasm +0 -0
  183. package/learn/vendor/fantomas/System.Linq.Parallel.2buevezvch.wasm +0 -0
  184. package/learn/vendor/fantomas/System.Linq.Queryable.cvq43g1awj.wasm +0 -0
  185. package/learn/vendor/fantomas/System.Linq.lz6mvi0hm2.wasm +0 -0
  186. package/learn/vendor/fantomas/System.Memory.3jekerw0ga.wasm +0 -0
  187. package/learn/vendor/fantomas/System.Net.Http.Json.8k237kkwec.wasm +0 -0
  188. package/learn/vendor/fantomas/System.Net.Http.cityx2bvcl.wasm +0 -0
  189. package/learn/vendor/fantomas/System.Net.HttpListener.s1jreclykx.wasm +0 -0
  190. package/learn/vendor/fantomas/System.Net.Mail.cmlj4c0gto.wasm +0 -0
  191. package/learn/vendor/fantomas/System.Net.NameResolution.q3gf18q13l.wasm +0 -0
  192. package/learn/vendor/fantomas/System.Net.NetworkInformation.xaz5tjw7d0.wasm +0 -0
  193. package/learn/vendor/fantomas/System.Net.Ping.a40atim1h0.wasm +0 -0
  194. package/learn/vendor/fantomas/System.Net.Primitives.i88i20r8sr.wasm +0 -0
  195. package/learn/vendor/fantomas/System.Net.Quic.hx06eo5xkj.wasm +0 -0
  196. package/learn/vendor/fantomas/System.Net.Requests.hkjxlfe5f5.wasm +0 -0
  197. package/learn/vendor/fantomas/System.Net.Security.ch34yya69o.wasm +0 -0
  198. package/learn/vendor/fantomas/System.Net.ServerSentEvents.0u7o0jk3p1.wasm +0 -0
  199. package/learn/vendor/fantomas/System.Net.ServicePoint.xbhxnytx4l.wasm +0 -0
  200. package/learn/vendor/fantomas/System.Net.Sockets.hzgzlvkc9l.wasm +0 -0
  201. package/learn/vendor/fantomas/System.Net.WebClient.84i8nwzbgu.wasm +0 -0
  202. package/learn/vendor/fantomas/System.Net.WebHeaderCollection.326nl7s9g3.wasm +0 -0
  203. package/learn/vendor/fantomas/System.Net.WebProxy.oq3mgkkqef.wasm +0 -0
  204. package/learn/vendor/fantomas/System.Net.WebSockets.2cx1v74vg8.wasm +0 -0
  205. package/learn/vendor/fantomas/System.Net.WebSockets.Client.rafzkktw8j.wasm +0 -0
  206. package/learn/vendor/fantomas/System.Net.w1hpj3bo6r.wasm +0 -0
  207. package/learn/vendor/fantomas/System.Numerics.Vectors.oyv7biw9ux.wasm +0 -0
  208. package/learn/vendor/fantomas/System.Numerics.lyu36wqn19.wasm +0 -0
  209. package/learn/vendor/fantomas/System.ObjectModel.kxu80demuu.wasm +0 -0
  210. package/learn/vendor/fantomas/System.Private.CoreLib.1vy46s12u6.wasm +0 -0
  211. package/learn/vendor/fantomas/System.Private.DataContractSerialization.ao8k9iu77a.wasm +0 -0
  212. package/learn/vendor/fantomas/System.Private.Uri.itn0n2zjd0.wasm +0 -0
  213. package/learn/vendor/fantomas/System.Private.Xml.19nzpxrx8w.wasm +0 -0
  214. package/learn/vendor/fantomas/System.Private.Xml.Linq.tw5eq1hjvo.wasm +0 -0
  215. package/learn/vendor/fantomas/System.Reflection.DispatchProxy.7lajnj8s8c.wasm +0 -0
  216. package/learn/vendor/fantomas/System.Reflection.Emit.7liz9zln06.wasm +0 -0
  217. package/learn/vendor/fantomas/System.Reflection.Emit.ILGeneration.1ut3qgacw8.wasm +0 -0
  218. package/learn/vendor/fantomas/System.Reflection.Emit.Lightweight.d0gvllb1jj.wasm +0 -0
  219. package/learn/vendor/fantomas/System.Reflection.Extensions.zr5bhwfczd.wasm +0 -0
  220. package/learn/vendor/fantomas/System.Reflection.Metadata.ff6np6mz2j.wasm +0 -0
  221. package/learn/vendor/fantomas/System.Reflection.Primitives.igpmvwv78c.wasm +0 -0
  222. package/learn/vendor/fantomas/System.Reflection.TypeExtensions.qouojzlnp9.wasm +0 -0
  223. package/learn/vendor/fantomas/System.Reflection.mk3jyxvh13.wasm +0 -0
  224. package/learn/vendor/fantomas/System.Resources.Reader.41ppfyz2vc.wasm +0 -0
  225. package/learn/vendor/fantomas/System.Resources.ResourceManager.sfwvfmw1ea.wasm +0 -0
  226. package/learn/vendor/fantomas/System.Resources.Writer.3uvs9tp38z.wasm +0 -0
  227. package/learn/vendor/fantomas/System.Runtime.CompilerServices.Unsafe.puz1xm53oc.wasm +0 -0
  228. package/learn/vendor/fantomas/System.Runtime.CompilerServices.VisualC.9qdau315py.wasm +0 -0
  229. package/learn/vendor/fantomas/System.Runtime.Extensions.i7gntui96b.wasm +0 -0
  230. package/learn/vendor/fantomas/System.Runtime.Handles.00oxj4o6ov.wasm +0 -0
  231. package/learn/vendor/fantomas/System.Runtime.InteropServices.JavaScript.9kq1vofond.wasm +0 -0
  232. package/learn/vendor/fantomas/System.Runtime.InteropServices.RuntimeInformation.my7qeqbhfh.wasm +0 -0
  233. package/learn/vendor/fantomas/System.Runtime.InteropServices.vqp80tnwc7.wasm +0 -0
  234. package/learn/vendor/fantomas/System.Runtime.Intrinsics.u0samjybfo.wasm +0 -0
  235. package/learn/vendor/fantomas/System.Runtime.Loader.n6zxw1b98a.wasm +0 -0
  236. package/learn/vendor/fantomas/System.Runtime.Numerics.o40sjhz59x.wasm +0 -0
  237. package/learn/vendor/fantomas/System.Runtime.Serialization.Formatters.1esvva4te3.wasm +0 -0
  238. package/learn/vendor/fantomas/System.Runtime.Serialization.Json.4n7u09advh.wasm +0 -0
  239. package/learn/vendor/fantomas/System.Runtime.Serialization.Primitives.xs2bo91wvk.wasm +0 -0
  240. package/learn/vendor/fantomas/System.Runtime.Serialization.Xml.ny21jmziti.wasm +0 -0
  241. package/learn/vendor/fantomas/System.Runtime.Serialization.qcxaur5wqs.wasm +0 -0
  242. package/learn/vendor/fantomas/System.Runtime.odq454d6j9.wasm +0 -0
  243. package/learn/vendor/fantomas/System.Security.AccessControl.8yfnzmqzaq.wasm +0 -0
  244. package/learn/vendor/fantomas/System.Security.Claims.8ogy0860de.wasm +0 -0
  245. package/learn/vendor/fantomas/System.Security.Cryptography.Algorithms.8zijp1svfw.wasm +0 -0
  246. package/learn/vendor/fantomas/System.Security.Cryptography.Cng.yxagtt77no.wasm +0 -0
  247. package/learn/vendor/fantomas/System.Security.Cryptography.Csp.uhfbvvau84.wasm +0 -0
  248. package/learn/vendor/fantomas/System.Security.Cryptography.Encoding.2ywrusvy8q.wasm +0 -0
  249. package/learn/vendor/fantomas/System.Security.Cryptography.OpenSsl.oa268u7i92.wasm +0 -0
  250. package/learn/vendor/fantomas/System.Security.Cryptography.Primitives.5uhvqe8puk.wasm +0 -0
  251. package/learn/vendor/fantomas/System.Security.Cryptography.X509Certificates.6i7pxilopt.wasm +0 -0
  252. package/learn/vendor/fantomas/System.Security.Cryptography.d0quqk1iyr.wasm +0 -0
  253. package/learn/vendor/fantomas/System.Security.Principal.Windows.gpqua4rz29.wasm +0 -0
  254. package/learn/vendor/fantomas/System.Security.Principal.i20kfklf3g.wasm +0 -0
  255. package/learn/vendor/fantomas/System.Security.SecureString.x2y8tzci3c.wasm +0 -0
  256. package/learn/vendor/fantomas/System.Security.e83vvh6sl2.wasm +0 -0
  257. package/learn/vendor/fantomas/System.ServiceModel.Web.poglliv2no.wasm +0 -0
  258. package/learn/vendor/fantomas/System.ServiceProcess.yro5uj2opo.wasm +0 -0
  259. package/learn/vendor/fantomas/System.Text.Encoding.CodePages.2wchx40i7z.wasm +0 -0
  260. package/learn/vendor/fantomas/System.Text.Encoding.Extensions.8utaw61kn5.wasm +0 -0
  261. package/learn/vendor/fantomas/System.Text.Encoding.cxdyfepnpj.wasm +0 -0
  262. package/learn/vendor/fantomas/System.Text.Encodings.Web.37ehbi7cye.wasm +0 -0
  263. package/learn/vendor/fantomas/System.Text.Json.ixiaa8hd3h.wasm +0 -0
  264. package/learn/vendor/fantomas/System.Text.RegularExpressions.2fhfmkk6vf.wasm +0 -0
  265. package/learn/vendor/fantomas/System.Threading.6pry74a050.wasm +0 -0
  266. package/learn/vendor/fantomas/System.Threading.AccessControl.76zfdfy8go.wasm +0 -0
  267. package/learn/vendor/fantomas/System.Threading.Channels.gpxnr01lmp.wasm +0 -0
  268. package/learn/vendor/fantomas/System.Threading.Overlapped.aqpl8tzdyc.wasm +0 -0
  269. package/learn/vendor/fantomas/System.Threading.Tasks.Dataflow.ytwttt7fzh.wasm +0 -0
  270. package/learn/vendor/fantomas/System.Threading.Tasks.Extensions.0deavcb00v.wasm +0 -0
  271. package/learn/vendor/fantomas/System.Threading.Tasks.Parallel.tjwtxugso0.wasm +0 -0
  272. package/learn/vendor/fantomas/System.Threading.Tasks.fu4qd5h3qy.wasm +0 -0
  273. package/learn/vendor/fantomas/System.Threading.Thread.klaua2by9m.wasm +0 -0
  274. package/learn/vendor/fantomas/System.Threading.ThreadPool.mkzm212njz.wasm +0 -0
  275. package/learn/vendor/fantomas/System.Threading.Timer.yp49llu5h2.wasm +0 -0
  276. package/learn/vendor/fantomas/System.Transactions.Local.vz6cgeh4w7.wasm +0 -0
  277. package/learn/vendor/fantomas/System.Transactions.ipwm3rsy66.wasm +0 -0
  278. package/learn/vendor/fantomas/System.ValueTuple.7ol6ljuhx8.wasm +0 -0
  279. package/learn/vendor/fantomas/System.Web.HttpUtility.itlvncjd96.wasm +0 -0
  280. package/learn/vendor/fantomas/System.Web.np8uzzakvl.wasm +0 -0
  281. package/learn/vendor/fantomas/System.Windows.18nzio44t3.wasm +0 -0
  282. package/learn/vendor/fantomas/System.Xml.45jprtg1pa.wasm +0 -0
  283. package/learn/vendor/fantomas/System.Xml.Linq.v9v8udncm1.wasm +0 -0
  284. package/learn/vendor/fantomas/System.Xml.ReaderWriter.a9mr08uzci.wasm +0 -0
  285. package/learn/vendor/fantomas/System.Xml.Serialization.03juoguwgc.wasm +0 -0
  286. package/learn/vendor/fantomas/System.Xml.XDocument.c9dhjnzqjb.wasm +0 -0
  287. package/learn/vendor/fantomas/System.Xml.XPath.XDocument.138b12i1pm.wasm +0 -0
  288. package/learn/vendor/fantomas/System.Xml.XPath.pvxm9341ce.wasm +0 -0
  289. package/learn/vendor/fantomas/System.Xml.XmlDocument.450wsyxvl0.wasm +0 -0
  290. package/learn/vendor/fantomas/System.Xml.XmlSerializer.y3t2n0tce7.wasm +0 -0
  291. package/learn/vendor/fantomas/System.gjriafnqmz.wasm +0 -0
  292. package/learn/vendor/fantomas/WindowsBase.8zsce9qxfb.wasm +0 -0
  293. package/learn/vendor/fantomas/cs/FSharp.Core.resources.9ehmavdel7.wasm +0 -0
  294. package/learn/vendor/fantomas/de/FSharp.Core.resources.2ofmxloa01.wasm +0 -0
  295. package/learn/vendor/fantomas/dotnet.js +1233 -0
  296. package/learn/vendor/fantomas/dotnet.native.b6l13xorvf.js +16 -0
  297. package/learn/vendor/fantomas/dotnet.native.rw4kynp763.wasm +0 -0
  298. package/learn/vendor/fantomas/dotnet.runtime.v06hirbjsv.js +4 -0
  299. package/learn/vendor/fantomas/es/FSharp.Core.resources.hkr5ggb4tr.wasm +0 -0
  300. package/learn/vendor/fantomas/fr/FSharp.Core.resources.43soen28ow.wasm +0 -0
  301. package/learn/vendor/fantomas/icudt_CJK.tjcz0u77k5.dat +0 -0
  302. package/learn/vendor/fantomas/icudt_EFIGS.tptq2av103.dat +0 -0
  303. package/learn/vendor/fantomas/icudt_no_CJK.lfu7j35m59.dat +0 -0
  304. package/learn/vendor/fantomas/it/FSharp.Core.resources.m60n5ls7oq.wasm +0 -0
  305. package/learn/vendor/fantomas/ja/FSharp.Core.resources.o6oof69v14.wasm +0 -0
  306. package/learn/vendor/fantomas/ko/FSharp.Core.resources.q6l4snlu9o.wasm +0 -0
  307. package/learn/vendor/fantomas/mscorlib.8ptuc08eli.wasm +0 -0
  308. package/learn/vendor/fantomas/netstandard.eymp85mooh.wasm +0 -0
  309. package/learn/vendor/fantomas/pl/FSharp.Core.resources.8bni0w6j8b.wasm +0 -0
  310. package/learn/vendor/fantomas/pt-BR/FSharp.Core.resources.k849vqm41u.wasm +0 -0
  311. package/learn/vendor/fantomas/ru/FSharp.Core.resources.jz9rhhtsla.wasm +0 -0
  312. package/learn/vendor/fantomas/tr/FSharp.Core.resources.wn6vbvjm1u.wasm +0 -0
  313. package/learn/vendor/fantomas/zh-Hans/FSharp.Core.resources.z7zzbso094.wasm +0 -0
  314. package/learn/vendor/fantomas/zh-Hant/FSharp.Core.resources.iammfsi7ls.wasm +0 -0
  315. package/learn/vendor/fast-check-LICENSE.txt +21 -0
  316. package/learn/vendor/fast-check.mjs +37 -0
  317. package/learn/vendor/fonts/atkinson-hyperlegible-latin-400-normal.woff2 +0 -0
  318. package/learn/vendor/fonts/atkinson-hyperlegible-latin-700-normal.woff2 +0 -0
  319. package/learn/vendor/fonts/atkinson-hyperlegible-mono-latin-400-normal.woff2 +0 -0
  320. package/learn/vendor/fonts/overpass-latin-600-normal.woff2 +0 -0
  321. package/learn/vendor/fonts/overpass-latin-700-normal.woff2 +0 -0
  322. package/learn/vendor/formatter-licenses/DotNet-LICENSE.txt +23 -0
  323. package/learn/vendor/formatter-licenses/DotNet-THIRD-PARTY-NOTICES.txt +1418 -0
  324. package/learn/vendor/formatter-licenses/FSharp-LICENSE.txt +23 -0
  325. package/learn/vendor/formatter-licenses/Fantomas-LICENSE.txt +202 -0
  326. package/learn/vendor/formatter-licenses/README.md +12 -0
  327. package/learn/vendor/manifest.json +1354 -0
  328. package/learn/vendor/metadata/Browser.Blob.dll +0 -0
  329. package/learn/vendor/metadata/Browser.Dom.dll +0 -0
  330. package/learn/vendor/metadata/Browser.Event.dll +0 -0
  331. package/learn/vendor/metadata/Browser.Gamepad.dll +0 -0
  332. package/learn/vendor/metadata/Browser.WebGL.dll +0 -0
  333. package/learn/vendor/metadata/Browser.WebStorage.dll +0 -0
  334. package/learn/vendor/metadata/FSharp.Core.dll +0 -0
  335. package/learn/vendor/metadata/Fable.Core.dll +0 -0
  336. package/learn/vendor/metadata/Fable.Repl.Lib.dll +0 -0
  337. package/learn/vendor/metadata/System.Collections.Concurrent.dll +0 -0
  338. package/learn/vendor/metadata/System.Collections.dll +0 -0
  339. package/learn/vendor/metadata/System.ComponentModel.Primitives.dll +0 -0
  340. package/learn/vendor/metadata/System.ComponentModel.TypeConverter.dll +0 -0
  341. package/learn/vendor/metadata/System.ComponentModel.dll +0 -0
  342. package/learn/vendor/metadata/System.Console.dll +0 -0
  343. package/learn/vendor/metadata/System.Core.dll +0 -0
  344. package/learn/vendor/metadata/System.Diagnostics.Debug.dll +0 -0
  345. package/learn/vendor/metadata/System.Diagnostics.Tools.dll +0 -0
  346. package/learn/vendor/metadata/System.Diagnostics.Tracing.dll +0 -0
  347. package/learn/vendor/metadata/System.Globalization.dll +0 -0
  348. package/learn/vendor/metadata/System.IO.dll +0 -0
  349. package/learn/vendor/metadata/System.Net.Requests.dll +0 -0
  350. package/learn/vendor/metadata/System.Net.WebClient.dll +0 -0
  351. package/learn/vendor/metadata/System.Numerics.dll +0 -0
  352. package/learn/vendor/metadata/System.Reflection.Extensions.dll +0 -0
  353. package/learn/vendor/metadata/System.Reflection.Metadata.dll +0 -0
  354. package/learn/vendor/metadata/System.Reflection.Primitives.dll +0 -0
  355. package/learn/vendor/metadata/System.Reflection.TypeExtensions.dll +0 -0
  356. package/learn/vendor/metadata/System.Reflection.dll +0 -0
  357. package/learn/vendor/metadata/System.Runtime.Extensions.dll +0 -0
  358. package/learn/vendor/metadata/System.Runtime.InteropServices.dll +0 -0
  359. package/learn/vendor/metadata/System.Runtime.Numerics.dll +0 -0
  360. package/learn/vendor/metadata/System.Runtime.dll +0 -0
  361. package/learn/vendor/metadata/System.Text.Encoding.Extensions.dll +0 -0
  362. package/learn/vendor/metadata/System.Text.Encoding.dll +0 -0
  363. package/learn/vendor/metadata/System.Text.RegularExpressions.dll +0 -0
  364. package/learn/vendor/metadata/System.Threading.Tasks.dll +0 -0
  365. package/learn/vendor/metadata/System.Threading.Thread.dll +0 -0
  366. package/learn/vendor/metadata/System.Threading.dll +0 -0
  367. package/learn/vendor/metadata/System.ValueTuple.dll +0 -0
  368. package/learn/vendor/metadata/System.dll +0 -0
  369. package/learn/vendor/metadata/mscorlib.dll +0 -0
  370. package/learn/vendor/metadata/netstandard.dll +0 -0
  371. package/learn/vendor/monaco-editor-LICENSE.txt +21 -0
  372. package/learn/vendor/prettier/babel.mjs +16 -0
  373. package/learn/vendor/prettier/brace-style.mjs +376 -0
  374. package/learn/vendor/prettier/estree.mjs +44 -0
  375. package/learn/vendor/prettier/standalone.mjs +29 -0
  376. package/learn/vendor/prettier/typescript.mjs +22 -0
  377. package/learn/vendor/prettier-LICENSE.txt +7 -0
  378. package/learn/vendor/prettier-plugin-brace-style-LICENSE.txt +21 -0
  379. package/learn/vendor/typescript-LICENSE.txt +55 -0
  380. package/learn/vendor/typescript-libs.json +1 -0
  381. package/learn/vendor/typescript.mjs +451 -0
  382. package/learn/vendor/zod-LICENSE.txt +21 -0
  383. package/learn/web-format.mjs +8 -0
  384. package/learn.mjs +126 -0
  385. package/lsp.mjs +444 -133
  386. package/mcp.mjs +250 -0
  387. package/native-evidence.mjs +668 -182
  388. package/native-examples.mjs +56 -19
  389. package/native-host.mjs +136 -42
  390. package/native-parsers/clojure.LICENSE +121 -0
  391. package/native-parsers/clojure.wasm +0 -0
  392. package/native-parsers/csharp.LICENSE +21 -0
  393. package/native-parsers/csharp.wasm +0 -0
  394. package/native-parsers/elixir.LICENSE +176 -0
  395. package/native-parsers/elixir.wasm +0 -0
  396. package/native-parsers/erlang.LICENSE +201 -0
  397. package/native-parsers/erlang.wasm +0 -0
  398. package/native-parsers/fsharp.LICENSE +21 -0
  399. package/native-parsers/fsharp.wasm +0 -0
  400. package/native-parsers/gleam.LICENSE +202 -0
  401. package/native-parsers/gleam.wasm +0 -0
  402. package/native-parsers/go.LICENSE +21 -0
  403. package/native-parsers/go.wasm +0 -0
  404. package/native-parsers/groovy.LICENSE +21 -0
  405. package/native-parsers/groovy.wasm +0 -0
  406. package/native-parsers/haskell.LICENSE +21 -0
  407. package/native-parsers/haskell.wasm +0 -0
  408. package/native-parsers/java.LICENSE +21 -0
  409. package/native-parsers/java.wasm +0 -0
  410. package/native-parsers/javascript.LICENSE +21 -0
  411. package/native-parsers/javascript.wasm +0 -0
  412. package/native-parsers/kotlin.LICENSE +9 -0
  413. package/native-parsers/kotlin.wasm +0 -0
  414. package/native-parsers/lock.json +114 -0
  415. package/native-parsers/prolog.LICENSE +21 -0
  416. package/native-parsers/prolog.wasm +0 -0
  417. package/native-parsers/python.LICENSE +21 -0
  418. package/native-parsers/python.wasm +0 -0
  419. package/native-parsers/rust.LICENSE +21 -0
  420. package/native-parsers/rust.wasm +0 -0
  421. package/native-parsers/scala.LICENSE +21 -0
  422. package/native-parsers/scala.wasm +0 -0
  423. package/native-parsers/swift.LICENSE +21 -0
  424. package/native-parsers/swift.wasm +0 -0
  425. package/native-parsers/typescript.LICENSE +21 -0
  426. package/native-parsers/typescript.wasm +0 -0
  427. package/node-events-reporter.mjs +41 -17
  428. package/package.json +5 -3
  429. package/project.mjs +338 -0
  430. package/proof.d.ts +93 -19
  431. package/proof.mjs +1538 -447
  432. package/read-only-hpack.mjs +6 -5
  433. package/scala-build-state.mjs +131 -41
  434. package/scala-coverage.mjs +57 -34
  435. package/scalars.mjs +23 -8
  436. package/templates.mjs +566 -617
  437. package/test-command.mjs +1671 -521
package/authoring.mjs ADDED
@@ -0,0 +1,899 @@
1
+ // Generated from templates/npm/authoring.mjs by lawspec-dev generate. Do not edit.
2
+ // Bounded native syntax checks use upstream Tree-sitter grammars. Findings are
3
+ // review candidates, not proof of semantic or nominal equivalence.
4
+ // ref:DEC-authoring-advisories
5
+ import {readFile, readdir} from 'node:fs/promises';
6
+ import {createHash} from 'node:crypto';
7
+ import path from 'node:path';
8
+ import {programTargets, artifactTargets} from './templates.mjs';
9
+
10
+ const extensions = {
11
+ '.java': 'java',
12
+ '.py': 'python',
13
+ '.js': 'javascript',
14
+ '.mjs': 'javascript',
15
+ '.cjs': 'javascript',
16
+ '.ts': 'typescript',
17
+ '.mts': 'typescript',
18
+ '.cts': 'typescript',
19
+ '.tsx': 'tsx',
20
+ '.jsx': 'javascript',
21
+ '.go': 'go',
22
+ '.hs': 'haskell',
23
+ '.lhs': 'literate-haskell',
24
+ '.kt': 'kotlin',
25
+ '.kts': 'kotlin',
26
+ '.rs': 'rust',
27
+ '.erl': 'erlang',
28
+ '.hrl': 'erlang',
29
+ '.ex': 'elixir',
30
+ '.exs': 'elixir',
31
+ '.gleam': 'gleam',
32
+ '.fs': 'fsharp',
33
+ '.fsx': 'fsharp',
34
+ '.fsi': 'fsharp',
35
+ '.cs': 'csharp',
36
+ '.scala': 'scala',
37
+ '.groovy': 'groovy',
38
+ '.clj': 'clojure',
39
+ '.cljc': 'clojure',
40
+ '.swift': 'swift',
41
+ '.pl': 'prolog',
42
+ };
43
+ // Composite targets analyze their emitted host language as well.
44
+ const hostLanguages = {
45
+ javascript: ['javascript', 'typescript', 'tsx'],
46
+ typescript: ['typescript', 'javascript', 'tsx'],
47
+ haskell: ['haskell', 'literate-haskell'],
48
+ kotlin: ['kotlin', 'java'],
49
+ scala: ['scala', 'java'],
50
+ groovy: ['groovy', 'java'],
51
+ clojure: ['clojure', 'java'],
52
+ elixir: ['elixir', 'erlang'],
53
+ gleam: ['gleam', 'erlang'],
54
+ csharp: ['csharp', 'fsharp'],
55
+ prolog: ['prolog', 'python'],
56
+ };
57
+ const declarations = {
58
+ java: [
59
+ 'class_declaration',
60
+ 'record_declaration',
61
+ 'interface_declaration',
62
+ 'enum_declaration',
63
+ 'method_declaration',
64
+ ],
65
+ python: ['class_definition', 'function_definition'],
66
+ javascript: [
67
+ 'class_declaration',
68
+ 'function_declaration',
69
+ 'variable_declarator',
70
+ ],
71
+ typescript: [
72
+ 'class_declaration',
73
+ 'function_declaration',
74
+ 'interface_declaration',
75
+ 'type_alias_declaration',
76
+ 'enum_declaration',
77
+ 'variable_declarator',
78
+ ],
79
+ go: ['type_spec', 'function_declaration', 'method_declaration'],
80
+ haskell: ['data_type', 'newtype', 'type_synomym', 'function', 'bind'],
81
+ kotlin: [
82
+ 'class_declaration',
83
+ 'object_declaration',
84
+ 'function_declaration',
85
+ 'type_alias',
86
+ ],
87
+ rust: ['struct_item', 'enum_item', 'type_item', 'function_item'],
88
+ erlang: ['record_decl', 'type_alias', 'fun_decl'],
89
+ elixir: ['call'],
90
+ gleam: ['type_definition', 'type_alias', 'function'],
91
+ fsharp: ['type_definition', 'function_or_value_defn'],
92
+ csharp: [
93
+ 'class_declaration',
94
+ 'record_declaration',
95
+ 'struct_declaration',
96
+ 'interface_declaration',
97
+ 'enum_declaration',
98
+ 'method_declaration',
99
+ ],
100
+ scala: [
101
+ 'class_definition',
102
+ 'object_definition',
103
+ 'trait_definition',
104
+ 'enum_definition',
105
+ 'type_definition',
106
+ 'function_definition',
107
+ ],
108
+ groovy: [
109
+ 'class_declaration',
110
+ 'method_declaration',
111
+ 'interface_declaration',
112
+ 'enum_declaration',
113
+ ],
114
+ clojure: ['list_lit'],
115
+ swift: [
116
+ 'class_declaration',
117
+ 'protocol_declaration',
118
+ 'typealias_declaration',
119
+ 'function_declaration',
120
+ ],
121
+ prolog: ['clause', 'dict'],
122
+ };
123
+ const digest = content => createHash('sha256').update(content).digest('hex');
124
+ const comment = node => /comment|xml_doc/.test(node.type);
125
+ let runtime;
126
+ const languages = new Map();
127
+ const syntaxCache = new Map();
128
+ async function languageFor(language)
129
+ {
130
+ runtime ??= (async () =>
131
+ {
132
+ const module = await import('web-tree-sitter');
133
+ await module.Parser.init();
134
+ const lock = JSON.parse(
135
+ await readFile(
136
+ new URL('./native-parsers/lock.json', import.meta.url),
137
+ 'utf8',
138
+ ),
139
+ );
140
+ if (programTargets.some(target => !lock.grammars[target]))
141
+ throw new Error('Parser coverage differs from programTargets');
142
+ return {...module, lock};
143
+ })();
144
+ const api = await runtime;
145
+ if (!languages.has(language))
146
+ {
147
+ const entry = api.lock.grammars[language];
148
+ if (!entry) throw new Error(`No bundled parser for ${language}`);
149
+ const bytes = await readFile(
150
+ new URL('./native-parsers/' + entry.file, import.meta.url),
151
+ );
152
+ if (digest(bytes) !== entry.sha256)
153
+ throw new Error(`Parser digest mismatch for ${language}`);
154
+ languages.set(language, await api.Language.load(bytes));
155
+ }
156
+ return {Parser: api.Parser, language: languages.get(language)};
157
+ }
158
+ function nameNode(node, language)
159
+ {
160
+ if (language === 'prolog')
161
+ {
162
+ let term = node.childForFieldName('term') ?? node;
163
+ if (term.type === 'binary_operation') term = term.childForFieldName('left');
164
+ return term?.childForFieldName('functor') ?? term?.childForFieldName('tag');
165
+ }
166
+ if (language === 'clojure')
167
+ {
168
+ const children = node.namedChildren;
169
+ return ['defrecord', 'deftype', 'defn', 'defn-'].includes(children[0]?.text)
170
+ ? children[1]
171
+ : null;
172
+ }
173
+ if (language === 'elixir')
174
+ {
175
+ const head = node.childForFieldName('target')?.text;
176
+ if (!['defmodule', 'def', 'defp'].includes(head)) return null;
177
+ const args = node.namedChildren.find(child => child.type === 'arguments');
178
+ const first = args?.namedChildren[0];
179
+ return first?.childForFieldName('target') ?? first;
180
+ }
181
+ if (language === 'erlang' && node.type === 'fun_decl')
182
+ return node.childForFieldName('clause')?.childForFieldName('name');
183
+ let found =
184
+ node.childForFieldName('name') ?? node.childForFieldName('type_name');
185
+ if (found) return found;
186
+ const pending = [...node.namedChildren];
187
+ while (pending.length)
188
+ {
189
+ const child = pending.shift();
190
+ if (
191
+ /^(identifier|type_identifier|name|simple_identifier|type_name|atom|variable)$/.test(
192
+ child.type,
193
+ )
194
+ )
195
+ return child;
196
+ if (
197
+ /^(type_name|record_type_defn|union_type_defn|function_declaration_left|function_or_value_defn|function_declaration|function_head|value_declaration_left|identifier_pattern|long_identifier_or_op|long_identifier|type|head)$/.test(
198
+ child.type,
199
+ )
200
+ )
201
+ pending.unshift(...child.namedChildren);
202
+ }
203
+ return null;
204
+ }
205
+ function leaves(node)
206
+ {
207
+ if (comment(node)) return [];
208
+ if (!node.childCount) return [[node.type, node.text]];
209
+ return node.children.flatMap(leaves);
210
+ }
211
+ async function parse(source)
212
+ {
213
+ const language = extensions[path.extname(source.path)];
214
+ if (!language)
215
+ return {
216
+ status: 'unsupported',
217
+ reason: 'No grammar selected for this file extension',
218
+ declarations: [],
219
+ };
220
+ if (Buffer.byteLength(source.content) > 2 * 1024 * 1024)
221
+ return {
222
+ status: 'incomplete',
223
+ reason: 'Native file exceeds the 2 MiB analysis limit',
224
+ declarations: [],
225
+ };
226
+ const key = language + ':' + digest(source.content);
227
+ if (syntaxCache.has(key)) return syntaxCache.get(key);
228
+ let parser, tree;
229
+ try
230
+ {
231
+ const api = await languageFor(language);
232
+ parser = new api.Parser();
233
+ parser.setLanguage(api.language);
234
+ tree = parser.parse(source.content);
235
+ if (!tree || tree.rootNode.hasError)
236
+ return {
237
+ status: 'incomplete',
238
+ reason: 'Tree-sitter reported an ERROR or missing node',
239
+ declarations: [],
240
+ };
241
+ const result = [];
242
+ const imports = [];
243
+ const modules = [];
244
+ const limits = [];
245
+ const stack = [tree.rootNode];
246
+ let count = 0;
247
+ while (stack.length)
248
+ {
249
+ const node = stack.pop();
250
+ if (++count > 100000)
251
+ return {
252
+ status: 'incomplete',
253
+ reason: 'Native syntax exceeds the 100000-node analysis limit',
254
+ declarations: [],
255
+ };
256
+ stack.push(...node.namedChildren);
257
+ if (
258
+ /^(macro_invocation|macro_definition|preproc_call|preproc_if|preproc_ifdef)$/.test(
259
+ node.type,
260
+ ) &&
261
+ !(
262
+ language === 'rust' &&
263
+ node.type === 'macro_invocation' &&
264
+ ['unimplemented', 'todo', 'panic'].includes(
265
+ node.childForFieldName('macro')?.text,
266
+ ) &&
267
+ node.namedChildren
268
+ .filter(child => child.type === 'token_tree')
269
+ .every(tokens =>
270
+ tokens.namedChildren.every(
271
+ child => child.type === 'string_literal',
272
+ ),
273
+ )
274
+ )
275
+ )
276
+ limits.push(
277
+ `Unsupported ${node.type} at line ${node.startPosition.row + 1}`,
278
+ );
279
+ if (
280
+ /^(import_statement|import_from_statement|import_declaration|import_spec|import_header|use_declaration|open_declaration|open_statement|import)$/.test(
281
+ node.type,
282
+ )
283
+ )
284
+ {
285
+ let module =
286
+ node.childForFieldName('source') ??
287
+ node.childForFieldName('module_name') ??
288
+ node.childForFieldName('module') ??
289
+ node.childForFieldName('path') ??
290
+ node.childForFieldName('argument') ??
291
+ node.childForFieldName('name') ??
292
+ node.namedChildren.find(child =>
293
+ /string|identifier|name|module/.test(child.type),
294
+ );
295
+ if (module?.type === 'aliased_import')
296
+ module = module.childForFieldName('name');
297
+ if (module) imports.push(module.text.replace(/^['"]|['"]$/g, ''));
298
+ else
299
+ limits.push(
300
+ `Unresolved import syntax at line ${node.startPosition.row + 1}`,
301
+ );
302
+ }
303
+ if (
304
+ /^(namespace_declaration|file_scoped_namespace_declaration|package_declaration|package_clause|named_module|module_attribute|header)$/.test(
305
+ node.type,
306
+ )
307
+ )
308
+ {
309
+ const module =
310
+ node.childForFieldName('name') ??
311
+ node.childForFieldName('module') ??
312
+ node.namedChildren.find(child => /identifier|name/.test(child.type));
313
+ if (module) modules.push(module.text);
314
+ }
315
+ if (language === 'clojure' && node.type === 'list_lit')
316
+ {
317
+ const children = node.namedChildren,
318
+ head = children[0]?.text;
319
+ if (head === 'ns' && children[1]) modules.push(children[1].text);
320
+ if ([':require', ':use'].includes(head))
321
+ for (const entry of children.slice(1))
322
+ {
323
+ if (
324
+ entry.type === 'vec_lit' &&
325
+ entry.namedChildren[0]?.type === 'sym_lit'
326
+ )
327
+ imports.push(entry.namedChildren[0].text);
328
+ else limits.push('Unsupported Clojure namespace reference');
329
+ }
330
+ if (
331
+ ['defmacro', 'load', 'load-file', 'require', 'use', 'eval'].includes(
332
+ head,
333
+ )
334
+ )
335
+ limits.push(`Dynamic Clojure declaration or reference: ${head}`);
336
+ }
337
+ if (language === 'elixir' && node.type === 'call')
338
+ {
339
+ const head = node.childForFieldName('target')?.text;
340
+ if (['alias', 'import', 'require', 'use'].includes(head))
341
+ {
342
+ const module = node.namedChildren.find(
343
+ child => child.type === 'arguments',
344
+ )?.namedChildren[0];
345
+ if (module?.type === 'alias') imports.push(module.text);
346
+ else limits.push(`Unsupported Elixir ${head} reference`);
347
+ if (head === 'use')
348
+ limits.push('Elixir use may introduce declarations through macros');
349
+ }
350
+ if (head === 'defmacro' || head === 'defmacrop')
351
+ limits.push('Elixir macro declaration requires expansion');
352
+ }
353
+ if (
354
+ language === 'prolog' &&
355
+ node.type === 'compound_term' &&
356
+ ['use_module', 'ensure_loaded', 'include', 'reexport'].includes(
357
+ node.childForFieldName('functor')?.text,
358
+ )
359
+ )
360
+ {
361
+ const module = node.childrenForFieldName('argument')[0];
362
+ if (module) imports.push(module.text.replace(/^'|'$/g, ''));
363
+ else limits.push('Unsupported Prolog module reference');
364
+ }
365
+ if (
366
+ language === 'erlang' &&
367
+ /^(import_attribute|include|include_lib)$/.test(node.type)
368
+ )
369
+ {
370
+ const module =
371
+ node.childForFieldName('module') ??
372
+ node.childForFieldName('file') ??
373
+ node.namedChildren[0];
374
+ if (module) imports.push(module.text.replace(/^"|"$/g, ''));
375
+ else limits.push('Unsupported Erlang module reference');
376
+ }
377
+ if (!declarations[language].includes(node.type)) continue;
378
+ const name = nameNode(node, language);
379
+ if (!name) continue;
380
+ const tokens = leaves(node);
381
+ result.push({
382
+ name: name.text,
383
+ kind: node.type,
384
+ line: node.startPosition.row + 1,
385
+ fields:
386
+ language === 'prolog' && node.type === 'dict'
387
+ ? node.namedChildren
388
+ .filter(child => child.type === 'dict_pair')
389
+ .map(child => child.childForFieldName('key')?.text)
390
+ .filter(Boolean)
391
+ .sort()
392
+ : [],
393
+ identifiers: tokens
394
+ .filter(([type]) =>
395
+ /identifier|atom|symbol|name|constructor|variable|alias/.test(type),
396
+ )
397
+ .map(([type, text]) =>
398
+ language === 'clojure'
399
+ ? text.replace(/\.$/, '')
400
+ : /atom/.test(type)
401
+ ? text.replace(/^'|'$/g, '')
402
+ : text,
403
+ ),
404
+ model:
405
+ /class|record|struct|enum|interface|type|newtype|dict/.test(
406
+ node.type,
407
+ ) ||
408
+ (language === 'elixir' &&
409
+ node.childForFieldName('target')?.text === 'defmodule') ||
410
+ (language === 'clojure' &&
411
+ ['defrecord', 'deftype'].includes(node.namedChildren[0]?.text)),
412
+ fingerprint: digest(
413
+ JSON.stringify(
414
+ tokens.map(([type, text]) => [
415
+ type,
416
+ text === name.text ? '$declaration' : text,
417
+ ]),
418
+ ),
419
+ ),
420
+ });
421
+ }
422
+ const parsed = {
423
+ status: 'complete',
424
+ declarations: result,
425
+ imports,
426
+ modules,
427
+ limits,
428
+ fingerprint: digest(JSON.stringify(leaves(tree.rootNode))),
429
+ };
430
+ // Bound process-local memory; cached summaries contain no parser nodes.
431
+ if (syntaxCache.size >= 128) syntaxCache.clear();
432
+ syntaxCache.set(key, parsed);
433
+ return parsed;
434
+ }
435
+ catch (error)
436
+ {
437
+ return {status: 'incomplete', reason: error.message, declarations: []};
438
+ }
439
+ finally
440
+ {
441
+ tree?.delete();
442
+ parser?.delete();
443
+ }
444
+ }
445
+ const rules = [
446
+ 'copied-generated',
447
+ 'native-model',
448
+ 'adapter-identity',
449
+ 'manual-conversion',
450
+ ];
451
+ export function settleAdvice(advice, exceptions = [])
452
+ {
453
+ if (
454
+ !Array.isArray(exceptions) ||
455
+ exceptions.some(
456
+ e =>
457
+ !e ||
458
+ typeof e.declaration !== 'string' ||
459
+ !e.declaration.trim() ||
460
+ typeof e.reason !== 'string' ||
461
+ !e.reason.trim() ||
462
+ typeof e.rule !== 'string' ||
463
+ !e.rule.trim(),
464
+ )
465
+ )
466
+ throw new Error(
467
+ 'Authoring exceptions require a declaration, rule and nonempty reason',
468
+ );
469
+ const findings = advice.findings.map(finding =>
470
+ {
471
+ const exception = exceptions.find(
472
+ e => e.declaration === finding.declaration && e.rule === finding.rule,
473
+ );
474
+ return exception
475
+ ? {...finding, status: 'excepted', reason: exception.reason}
476
+ : finding;
477
+ });
478
+ return {
479
+ ...advice,
480
+ findings,
481
+ ok:
482
+ !findings.some(f => f.status === 'unresolved') &&
483
+ advice.checks.every(c =>
484
+ ['complete', 'not-applicable'].includes(c.status),
485
+ ),
486
+ };
487
+ }
488
+ export async function advise(call, input)
489
+ {
490
+ const {nativeSources, exceptions, strict, ...request} = input;
491
+ const result = await call({
492
+ schemaVersion: 5,
493
+ ...request,
494
+ advice: true,
495
+ method: request.target ? 'inspect' : 'advise',
496
+ });
497
+ if (result.diagnostics?.length) return result;
498
+ const report = result.advice ?? {findings: [], checks: []};
499
+ if (request.target)
500
+ {
501
+ const native = await analyzeNative(result, request, nativeSources);
502
+ report.findings.push(...native.findings);
503
+ report.checks.push(...native.checks);
504
+ }
505
+ result.advice = settleAdvice(report, exceptions);
506
+ // Required interfaces remain inspect's output; advise returns findings only.
507
+ delete result.interface;
508
+ delete result.files;
509
+ return result;
510
+ }
511
+ export async function analyzeNative(result, input, sources)
512
+ {
513
+ const target = input.target;
514
+ const checks = [];
515
+ const findings = [];
516
+ const check = (status, reason) =>
517
+ {
518
+ for (const rule of rules)
519
+ checks.push({
520
+ rule,
521
+ target,
522
+ status,
523
+ ...(reason ? {reason} : {}),
524
+ scope: 'declared native syntax; no whole-program type equivalence',
525
+ });
526
+ };
527
+ if (artifactTargets.includes(target))
528
+ {
529
+ check('not-applicable', 'Artifact target has no native application model');
530
+ return {findings, checks};
531
+ }
532
+ if (!programTargets.includes(target))
533
+ {
534
+ check('unsupported', 'Unknown program target');
535
+ return {findings, checks};
536
+ }
537
+ if (!Array.isArray(sources))
538
+ {
539
+ check('incomplete', 'Native sources were not supplied');
540
+ return {findings, checks};
541
+ }
542
+ const invalid = sources.filter(
543
+ source =>
544
+ !source ||
545
+ typeof source.path !== 'string' ||
546
+ typeof source.content !== 'string',
547
+ );
548
+ if (invalid.length)
549
+ {
550
+ check('incomplete', 'Malformed native source');
551
+ return {findings, checks};
552
+ }
553
+ const generated = (result.files ?? []).filter(
554
+ f => f.ownership === 'generated' && extensions[path.extname(f.path)],
555
+ );
556
+ const expected = new Map((result.files ?? []).map(f => [f.path, f]));
557
+ const acceptedDigests = new Map(
558
+ (result.interface?.generatedDigests ?? []).map(file => [
559
+ file.path,
560
+ new Set(file.sha256),
561
+ ]),
562
+ );
563
+ const rawCopies = new Map(generated.map(f => [digest(f.content), f.path]));
564
+ for (const [file, digests] of acceptedDigests)
565
+ for (const hash of digests) rawCopies.set(hash, file);
566
+ const baselines = new Map();
567
+ const names = new Set();
568
+ const adapterNames = new Set();
569
+ const boundTypes = input.nativeBindings?.types ?? [];
570
+ const recordShapes = (result.dataTypes ?? [])
571
+ .filter(type => type.constructors.length === 1)
572
+ .map(type => type.constructors[0].fields.map(field => field.name).sort());
573
+ const observedBindings = new Set();
574
+ const boundName = (source, declaration, parsed) =>
575
+ boundTypes.some(binding =>
576
+ {
577
+ const references = [
578
+ binding.native,
579
+ ...(binding.constructors ?? []).map(c => c.native),
580
+ ].filter(Array.isArray);
581
+ const matched = references.some(ref =>
582
+ {
583
+ const name = ref.at(-1),
584
+ module = ref
585
+ .slice(0, -1)
586
+ .filter(part => part !== 'crate')
587
+ .join('/');
588
+ const file = source.path.replace(/\.[^.]+$/, '');
589
+ const declaredModules = (parsed.modules ?? []).map(value =>
590
+ value.replace(/\.|::/g, '/'),
591
+ );
592
+ return (
593
+ (ref.length > 1 && ref.join('.') === declaration.name) ||
594
+ (name === declaration.name &&
595
+ module &&
596
+ (file === module ||
597
+ file.endsWith('/' + module) ||
598
+ file.endsWith('/' + module + '/' + name) ||
599
+ file === module + '/' + name ||
600
+ declaredModules.includes(module)))
601
+ );
602
+ });
603
+ if (matched) observedBindings.add(binding.type);
604
+ return matched;
605
+ });
606
+ let incomplete = false;
607
+ const relevant = (result.files ?? []).filter(
608
+ f =>
609
+ extensions[path.extname(f.path)] &&
610
+ (f.ownership === 'user' ||
611
+ (/data|types|schema/i.test(f.path) &&
612
+ !/runtime|testing/i.test(f.path))),
613
+ );
614
+ for (const file of relevant)
615
+ {
616
+ const parsed = await parse(file);
617
+ if (parsed.status !== 'complete')
618
+ {
619
+ incomplete = true;
620
+ checks.push({
621
+ rule: 'native-baseline',
622
+ target,
623
+ path: file.path,
624
+ status: parsed.status,
625
+ reason: parsed.reason,
626
+ });
627
+ continue;
628
+ }
629
+ for (const declaration of parsed.declarations)
630
+ {
631
+ if (file.ownership === 'user')
632
+ {
633
+ if (!declaration.model) adapterNames.add(declaration.name);
634
+ continue;
635
+ }
636
+ if (declaration.model) names.add(declaration.name);
637
+ baselines.set(declaration.fingerprint, {...declaration, path: file.path});
638
+ }
639
+ }
640
+ for (const item of result.interface?.data ?? [])
641
+ {
642
+ if (item.ownership === 'bound') continue;
643
+ if (item.nativeName) names.add(item.nativeName);
644
+ for (const c of item.constructors ?? [])
645
+ if (c.allocatedName) names.add(c.allocatedName);
646
+ }
647
+ const modulePaths = [...(result.files ?? []), ...sources].map(file =>
648
+ file.path
649
+ .replace(/\.[^.]+$/, '')
650
+ .split(path.sep)
651
+ .join('/'),
652
+ );
653
+ const standard =
654
+ /^(builtins$|node:|java\.|javax\.|scala\.|kotlin\.|System(?:\.|$)|Microsoft\.|std(?:::|\.|$)|core::|alloc::|Data\.|Control\.|GHC\.|Prelude$|typing$|dataclasses$|functools$|fractions$|decimal$|math$|collections$|abc$|sys$|os$|pathlib$|typing_extensions$|gleam\/|erlang$|Elixir\.|clojure\.|library\()/;
655
+ const add = (rule, source, declaration, message) =>
656
+ findings.push({
657
+ rule,
658
+ target,
659
+ path: source.path,
660
+ declaration: `${source.path}::${declaration.name}`,
661
+ line: declaration.line,
662
+ severity: 'warning',
663
+ status: 'unresolved',
664
+ message,
665
+ suggestion:
666
+ 'Migrate to the generated interface; retain an application model through explicit checked bindings/codecs, or a declaration-scoped exception with a reason.',
667
+ });
668
+ for (const source of sources)
669
+ {
670
+ if (typeof source.path !== 'string' || typeof source.content !== 'string')
671
+ {
672
+ incomplete = true;
673
+ checks.push({
674
+ rule: 'native-source',
675
+ target,
676
+ status: 'incomplete',
677
+ reason: 'Malformed native source',
678
+ });
679
+ continue;
680
+ }
681
+ const language = extensions[path.extname(source.path)];
682
+ if (language && !(hostLanguages[target] ?? [target]).includes(language))
683
+ {
684
+ checks.push({
685
+ rule: 'native-language',
686
+ target,
687
+ path: source.path,
688
+ status: 'not-applicable',
689
+ reason: `${language} is outside the selected target's native languages`,
690
+ });
691
+ continue;
692
+ }
693
+ const known = expected.get(source.path);
694
+ if (known?.ownership === 'generated')
695
+ {
696
+ if (
697
+ known.content !== source.content &&
698
+ !acceptedDigests.get(source.path)?.has(digest(source.content))
699
+ )
700
+ {
701
+ const original = await parse(known),
702
+ actual = await parse(source);
703
+ if (original.status !== 'complete' || actual.status !== 'complete')
704
+ {
705
+ incomplete = true;
706
+ checks.push({
707
+ rule: 'generated-ownership',
708
+ target,
709
+ path: source.path,
710
+ status: 'incomplete',
711
+ reason:
712
+ 'Cannot compare changed generated syntax with the current plan',
713
+ });
714
+ }
715
+ else if (original.fingerprint !== actual.fingerprint)
716
+ add(
717
+ 'copied-generated',
718
+ source,
719
+ {name: '<file>', line: 1},
720
+ 'Compiler-owned source differs from the generation plan.',
721
+ );
722
+ }
723
+ continue;
724
+ }
725
+ const copy = rawCopies.get(digest(source.content));
726
+ if (copy)
727
+ {
728
+ add(
729
+ 'copied-generated',
730
+ source,
731
+ {name: '<file>', line: 1},
732
+ `This file copies compiler-owned ${copy}.`,
733
+ );
734
+ continue;
735
+ }
736
+ const parsed = await parse(source);
737
+ if (parsed.status !== 'complete')
738
+ {
739
+ incomplete = true;
740
+ checks.push({
741
+ rule: 'native-parse',
742
+ target,
743
+ path: source.path,
744
+ status: parsed.status,
745
+ reason: parsed.reason,
746
+ });
747
+ continue;
748
+ }
749
+ for (const reason of parsed.limits ?? [])
750
+ {
751
+ incomplete = true;
752
+ checks.push({
753
+ rule: 'native-construct',
754
+ target,
755
+ path: source.path,
756
+ status: 'unsupported',
757
+ reason,
758
+ });
759
+ }
760
+ for (const imported of parsed.imports ?? [])
761
+ {
762
+ const normalized = imported.replace(/::|\./g, '/').replace(/\/\*$/, '');
763
+ const relative = path.posix
764
+ .normalize(path.posix.join(path.posix.dirname(source.path), imported))
765
+ .replace(/\.[^.]+$/, '');
766
+ const resolved =
767
+ standard.test(imported) ||
768
+ modulePaths.some(
769
+ module =>
770
+ module === relative ||
771
+ module.endsWith('/' + normalized) ||
772
+ module === normalized ||
773
+ module.endsWith('/' + normalized + '/mod') ||
774
+ (target === 'swift' && module.includes('/' + normalized + '/')),
775
+ );
776
+ if (!resolved)
777
+ {
778
+ incomplete = true;
779
+ checks.push({
780
+ rule: 'native-reference',
781
+ target,
782
+ path: source.path,
783
+ status: 'incomplete',
784
+ reason: `Import ${imported} is outside the supplied/generated source inventory; identity resolution is incomplete`,
785
+ });
786
+ }
787
+ }
788
+ const competitors = new Set();
789
+ for (const declaration of parsed.declarations)
790
+ {
791
+ if (boundName(source, declaration, parsed)) continue;
792
+ const clone = baselines.get(declaration.fingerprint);
793
+ const termShape =
794
+ declaration.fields.length > 0 &&
795
+ recordShapes.some(
796
+ fields =>
797
+ JSON.stringify(fields) === JSON.stringify(declaration.fields),
798
+ );
799
+ if (clone || termShape || names.has(declaration.name))
800
+ {
801
+ competitors.add(declaration.name);
802
+ add(
803
+ 'native-model',
804
+ source,
805
+ declaration,
806
+ termShape
807
+ ? 'Native dict fields match a generated record schema; review the constructor identity and meaning.'
808
+ : clone
809
+ ? `Declaration matches a supported generated syntax shape in ${clone.path}; review its meaning and ownership.`
810
+ : 'Declaration shares a generated model name; review identity and domain meaning.',
811
+ );
812
+ }
813
+ }
814
+ for (const declaration of parsed.declarations)
815
+ {
816
+ if (
817
+ adapterNames.has(declaration.name) &&
818
+ declaration.identifiers.some(n => competitors.has(n))
819
+ )
820
+ add(
821
+ 'adapter-identity',
822
+ source,
823
+ declaration,
824
+ 'Adapter refers to a competing local model; check the generated signature and nominal identity.',
825
+ );
826
+ if (
827
+ declaration.identifiers.some(n => names.has(n)) &&
828
+ declaration.identifiers.some(n => competitors.has(n)) &&
829
+ !competitors.has(declaration.name)
830
+ )
831
+ add(
832
+ 'manual-conversion',
833
+ source,
834
+ declaration,
835
+ 'This function mentions a generated model name and a competing local declaration; review the boundary for migration or supported native bindings.',
836
+ );
837
+ }
838
+ }
839
+ for (const binding of boundTypes)
840
+ if (!observedBindings.has(binding.type))
841
+ {
842
+ incomplete = true;
843
+ checks.push({
844
+ rule: 'native-binding-reference',
845
+ target,
846
+ status: 'incomplete',
847
+ reason: `Bound model ${binding.type} was not resolved to a declaration in the supplied source inventory`,
848
+ });
849
+ }
850
+ check(
851
+ incomplete ? 'incomplete' : 'complete',
852
+ incomplete ? 'Some selected syntax could not be analyzed' : undefined,
853
+ );
854
+ return {findings, checks};
855
+ }
856
+ export async function collectNativeSources(root)
857
+ {
858
+ const sources = [];
859
+ const excluded = new Set([
860
+ 'node_modules',
861
+ '.git',
862
+ '.stack-work',
863
+ '.artifacts',
864
+ 'vendor',
865
+ 'target',
866
+ 'build',
867
+ 'dist',
868
+ 'bin',
869
+ 'obj',
870
+ '.venv',
871
+ 'venv',
872
+ '__pycache__',
873
+ '.gradle',
874
+ '.lawspec',
875
+ ]);
876
+ async function walk(directory)
877
+ {
878
+ for (const entry of await readdir(directory, {withFileTypes: true}))
879
+ {
880
+ if (entry.isSymbolicLink())
881
+ throw new Error(
882
+ `Native source symlink requires an explicit source selection: ${path.relative(root, path.join(directory, entry.name))}`,
883
+ );
884
+ const file = path.join(directory, entry.name);
885
+ if (entry.isDirectory())
886
+ {
887
+ if (!entry.name.startsWith('.') && !excluded.has(entry.name))
888
+ await walk(file);
889
+ }
890
+ else if (entry.isFile() && extensions[path.extname(file)])
891
+ sources.push({
892
+ path: path.relative(root, file).split(path.sep).join('/'),
893
+ content: await readFile(file, 'utf8'),
894
+ });
895
+ }
896
+ }
897
+ await walk(root);
898
+ return sources;
899
+ }