firefly-compiler 0.4.79 → 0.4.81

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 (164) hide show
  1. package/.hintrc +4 -4
  2. package/.vscode/settings.json +4 -4
  3. package/bin/Release.ff +153 -153
  4. package/bin/firefly.mjs +1 -1
  5. package/compiler/Builder.ff +257 -257
  6. package/compiler/Compiler.ff +227 -227
  7. package/compiler/Dependencies.ff +187 -187
  8. package/compiler/DependencyLock.ff +17 -17
  9. package/compiler/Inference.ff +2 -1
  10. package/compiler/JsEmitter.ff +940 -946
  11. package/compiler/LspHook.ff +202 -202
  12. package/compiler/Main.ff +3 -3
  13. package/compiler/ModuleCache.ff +178 -178
  14. package/compiler/Tokenizer.ff +1 -1
  15. package/compiler/Unification.ff +1 -1
  16. package/compiler/Workspace.ff +88 -88
  17. package/core/.firefly/include/package-lock.json +564 -564
  18. package/core/.firefly/include/package.json +5 -5
  19. package/core/.firefly/include/prepare.sh +1 -1
  20. package/core/.firefly/package.ff +2 -2
  21. package/core/Array.ff +265 -265
  22. package/core/Atomic.ff +64 -64
  23. package/core/Box.ff +7 -7
  24. package/core/BrowserSystem.ff +40 -40
  25. package/core/BuildSystem.ff +148 -148
  26. package/core/Crypto.ff +96 -96
  27. package/core/Equal.ff +36 -36
  28. package/core/Float.ff +25 -0
  29. package/core/HttpClient.ff +148 -148
  30. package/core/JsSystem.ff +69 -69
  31. package/core/Json.ff +434 -434
  32. package/core/List.ff +486 -486
  33. package/core/Lock.ff +144 -144
  34. package/core/NodeSystem.ff +216 -216
  35. package/core/Ordering.ff +161 -161
  36. package/core/Path.ff +401 -401
  37. package/core/Random.ff +134 -134
  38. package/core/RbMap.ff +216 -216
  39. package/core/Show.ff +43 -43
  40. package/core/SourceLocation.ff +68 -68
  41. package/core/Stream.ff +9 -9
  42. package/core/Task.ff +149 -141
  43. package/core/Try.ff +25 -4
  44. package/experimental/benchmarks/ListGrab.ff +23 -23
  45. package/experimental/benchmarks/ListGrab.java +55 -55
  46. package/experimental/benchmarks/Pyrotek45.ff +30 -30
  47. package/experimental/benchmarks/Pyrotek45.java +64 -64
  48. package/experimental/bidirectional/Bidi.ff +88 -88
  49. package/experimental/random/Index.ff +53 -53
  50. package/experimental/random/Process.ff +120 -120
  51. package/experimental/random/Scrape.ff +51 -51
  52. package/experimental/random/Symbols.ff +73 -73
  53. package/experimental/random/Tensor.ff +52 -52
  54. package/experimental/random/Units.ff +36 -36
  55. package/experimental/s3/S3TestAuthorizationHeader.ff +39 -39
  56. package/experimental/s3/S3TestPut.ff +16 -16
  57. package/experimental/tests/TestJson.ff +26 -26
  58. package/firefly.sh +0 -0
  59. package/fireflysite/.firefly/package.ff +4 -4
  60. package/fireflysite/CommunityOverview.ff +20 -20
  61. package/fireflysite/CountingButtonDemo.ff +58 -58
  62. package/fireflysite/DocumentParser.ff +331 -217
  63. package/fireflysite/ExamplesOverview.ff +40 -40
  64. package/fireflysite/FrontPage.ff +344 -360
  65. package/fireflysite/{GuideIntroduction.ff → GettingStarted.ff} +45 -52
  66. package/fireflysite/Guide.ff +442 -411
  67. package/fireflysite/Main.ff +151 -137
  68. package/fireflysite/MatchingPasswordsDemo.ff +82 -82
  69. package/fireflysite/PackagesOverview.ff +49 -49
  70. package/fireflysite/PostgresqlDemo.ff +34 -34
  71. package/fireflysite/ReferenceAll.ff +18 -0
  72. package/fireflysite/ReferenceIntroduction.ff +11 -0
  73. package/fireflysite/Styles.ff +567 -495
  74. package/fireflysite/Test.ff +46 -0
  75. package/fireflysite/assets/markdown/reference/BaseTypes.md +209 -0
  76. package/fireflysite/assets/markdown/reference/EmittedJavascript.md +66 -0
  77. package/fireflysite/assets/markdown/reference/Exceptions.md +101 -0
  78. package/fireflysite/assets/markdown/reference/FunctionsAndMethods.md +338 -0
  79. package/fireflysite/assets/markdown/reference/JavascriptInterop.md +134 -0
  80. package/fireflysite/assets/markdown/reference/ModulesAndPackages.md +162 -0
  81. package/fireflysite/assets/markdown/reference/OldStructuredConcurrency.md +48 -0
  82. package/fireflysite/assets/markdown/reference/PatternMatching.md +224 -0
  83. package/fireflysite/assets/markdown/reference/StatementsAndExpressions.md +86 -0
  84. package/fireflysite/assets/markdown/reference/StructuredConcurrency.md +99 -0
  85. package/fireflysite/assets/markdown/reference/TraitsAndInstances.md +100 -0
  86. package/fireflysite/assets/markdown/reference/UserDefinedTypes.md +184 -0
  87. package/fireflysite/assets/markdown/{ControlFlow.md → scratch/ControlFlow.md} +136 -136
  88. package/fireflysite/assets/markdown/scratch/Toc.md +41 -0
  89. package/lsp/.firefly/package.ff +1 -1
  90. package/lsp/CompletionHandler.ff +828 -828
  91. package/lsp/Handler.ff +714 -714
  92. package/lsp/HoverHandler.ff +79 -79
  93. package/lsp/LanguageServer.ff +272 -272
  94. package/lsp/SignatureHelpHandler.ff +55 -55
  95. package/lsp/SymbolHandler.ff +181 -181
  96. package/lsp/TestReferences.ff +17 -17
  97. package/lsp/TestReferencesCase.ff +7 -7
  98. package/lsp/stderr.txt +1 -1
  99. package/lsp/stdout.txt +34 -34
  100. package/lux/.firefly/package.ff +1 -1
  101. package/lux/Css.ff +648 -648
  102. package/lux/CssTest.ff +48 -48
  103. package/lux/Lux.ff +593 -487
  104. package/lux/LuxEvent.ff +116 -116
  105. package/lux/Main.ff +123 -123
  106. package/lux/Main2.ff +143 -143
  107. package/lux/TestDry.ff +27 -0
  108. package/output/js/ff/compiler/Builder.mjs +47 -47
  109. package/output/js/ff/compiler/Dependencies.mjs +3 -3
  110. package/output/js/ff/compiler/Inference.mjs +2 -2
  111. package/output/js/ff/compiler/JsEmitter.mjs +18 -72
  112. package/output/js/ff/compiler/Main.mjs +4 -4
  113. package/output/js/ff/compiler/ModuleCache.mjs +4 -4
  114. package/output/js/ff/core/Array.mjs +59 -59
  115. package/output/js/ff/core/Atomic.mjs +36 -36
  116. package/output/js/ff/core/BrowserSystem.mjs +11 -11
  117. package/output/js/ff/core/BuildSystem.mjs +30 -30
  118. package/output/js/ff/core/Crypto.mjs +40 -40
  119. package/output/js/ff/core/Float.mjs +50 -0
  120. package/output/js/ff/core/HttpClient.mjs +56 -56
  121. package/output/js/ff/core/Json.mjs +147 -147
  122. package/output/js/ff/core/List.mjs +50 -50
  123. package/output/js/ff/core/Lock.mjs +97 -97
  124. package/output/js/ff/core/NodeSystem.mjs +87 -87
  125. package/output/js/ff/core/Ordering.mjs +8 -8
  126. package/output/js/ff/core/Path.mjs +231 -231
  127. package/output/js/ff/core/Random.mjs +56 -56
  128. package/output/js/ff/core/Task.mjs +71 -39
  129. package/output/js/ff/core/Try.mjs +98 -4
  130. package/package.json +1 -1
  131. package/postgresql/Pg.ff +1 -1
  132. package/rpc/.firefly/package.ff +1 -1
  133. package/rpc/Rpc.ff +70 -70
  134. package/s3/.firefly/package.ff +1 -1
  135. package/s3/S3.ff +94 -94
  136. package/unsafejs/UnsafeJs.ff +19 -19
  137. package/vscode/LICENSE.txt +21 -21
  138. package/vscode/Prepublish.ff +15 -15
  139. package/vscode/README.md +16 -16
  140. package/vscode/client/package.json +22 -22
  141. package/vscode/client/src/extension.ts +104 -104
  142. package/vscode/icons/firefly-icon.svg +10 -10
  143. package/vscode/language-configuration.json +61 -61
  144. package/vscode/package-lock.json +3623 -3623
  145. package/vscode/package.json +1 -1
  146. package/vscode/snippets.json +241 -241
  147. package/vscode/syntaxes/firefly-markdown-injection.json +45 -45
  148. package/webserver/.firefly/include/package-lock.json +22 -22
  149. package/webserver/.firefly/include/package.json +5 -5
  150. package/webserver/.firefly/package.ff +2 -2
  151. package/webserver/WebServer.ff +685 -685
  152. package/websocket/.firefly/package.ff +1 -1
  153. package/websocket/WebSocket.ff +131 -131
  154. package/fireflysite/GuideAll.ff +0 -21
  155. package/fireflysite/GuideBaseTypes.ff +0 -168
  156. package/fireflysite/GuideControlFlow.ff +0 -212
  157. package/fireflysite/assets/markdown/Example.md +0 -78
  158. /package/fireflysite/assets/{NotoSansMono-Regular.ttf → font/NotoSansMono-Regular.ttf} +0 -0
  159. /package/fireflysite/assets/{NunitoSans-VariableFont_YTLC,opsz,wdth,wght.ttf → font/NunitoSans-VariableFont_YTLC,opsz,wdth,wght.ttf} +0 -0
  160. /package/fireflysite/assets/{autocomplete-small.png → image/autocomplete-small.png} +0 -0
  161. /package/fireflysite/assets/{autocomplete.png → image/autocomplete.png} +0 -0
  162. /package/fireflysite/assets/{edit-time-error.png → image/edit-time-error.png} +0 -0
  163. /package/fireflysite/assets/{firefly-logo-notext.png → image/firefly-logo-notext.png} +0 -0
  164. /package/fireflysite/assets/{firefly-logo-yellow.png → image/firefly-logo-yellow.png} +0 -0
@@ -1,136 +1,136 @@
1
- # Control flow
2
-
3
- Firefly provides several ways to implement branching. Pattern matching is the most powerful, built directly into the language. `if`, `elseIf` and `else` do what you expect and are functions and methods in the standard library, implemented using the `Option` type. An then finally, there are exceptions.
4
-
5
- # Pattern matching
6
-
7
- Pattern matching allows you to check a given data structure against a pattern. For example, if we want to parse the command line arguments provided by the user, we could do it like this:
8
-
9
- ```firefly
10
- let pair = system.arguments().{
11
- | [host] => Pair(host, 80)
12
- | ["localhost", port] => Pair("localhost", port.grabInt())
13
- | _ =>
14
- system.writeErrorLine("Usage: 'localhost' | (host port)")
15
- system.exit(0)
16
- }
17
- ```
18
-
19
- In Firefly you construct a list of strings (`List[String]`) like this `["example.com", "80"]`, and using pattern matching you can de-construct in the same way.
20
-
21
- ```firefly
22
- data.{
23
- | pattern1 => // case 1
24
- | pattern2 => // case N
25
- ...
26
- }
27
- ```
28
-
29
- The patterns must be exhaustive, that is, for any possible value of the given type, there must be a matching pattern. In the example above, there are no value for the empty list `[]` , list with two values, where the first is not `"localhost"` or lists with more than 2 arguments. That's why we need the wildcard case at the end. Without this last case, the compiler would produce a compile-time error, stating that the patterns must be exhaustive.
30
-
31
- Here are more examples — all exhaustive. Let's start with records:
32
-
33
- ```firefly
34
- pair.{
35
- | Pair(first, second) =>
36
- }
37
- ```
38
-
39
- Numbers
40
-
41
- ```firefly
42
- n.{
43
- | 1 =>
44
- | 2 =>
45
- | n =>
46
- }
47
- ```
48
-
49
- Booleans
50
-
51
- ```firefly
52
- n.{
53
- | True =>
54
- | False =>
55
- }
56
- ```
57
-
58
- And you can combine pattern as needed. Imagine you have a pair of type `Pair[List[Bool], Pair(Int, String)]`
59
-
60
-
61
- ```firefly
62
- pair.{
63
- | Pair([True, False], Pair(42, "foo")) =>
64
- | other =>
65
- }
66
- ```
67
-
68
-
69
- # Option
70
-
71
- Sometimes you don't have a value. Other languages uses null for this purpose, but Firefly does not have null. Instead, we have `Option` from the core package.
72
-
73
-
74
- ```firefly
75
- data Option[T] {
76
- None
77
- Some(value: T)
78
- }
79
- ```
80
-
81
- For some type `T`, say `String`, `Option[String]` is either some string or no value `None`. This way, the type system guides you to check for no-value.
82
-
83
- Many functions and methods returns an `Option` in Firefly. For instance the `getInt` method on `String`. This method returns `Some[Int]` when the string consists only of digits and `None` otherwise. We can perform pattern matching on Option like this:
84
-
85
- ```firefly
86
- port.getInt().{
87
- | None => 80
88
- | Some(p) => p
89
- }
90
- ```
91
-
92
- Many methods like `getInt` have a non-total counterpart `grabInt`, which returns an `Int`. But it will throw an exception when the input cannot be parsed. Options let's you code in an exception-safe manner.
93
-
94
-
95
- # if - elseIf - else
96
-
97
- You write if-statements in Firefly like this:
98
-
99
- ```firefly
100
- if(path == "/") {
101
- response.writeText("<!doctype html>")
102
- } elseIf {path.startsWith("/js/")} {
103
- response.writeText("<script>")
104
- } else {
105
- response.writeStatus("404 Not found")
106
- }
107
- ```
108
-
109
- You can also use it as an expression like this
110
-
111
-
112
- ```firefly
113
- let contentType = if(path == "/") {
114
- "text/html; charset=UTF-8"
115
- } elseIf(directory2.exists) {
116
- "text/javascript; charset=UTF-8"
117
- } else {
118
- "text/plain; charset=UTF-8"
119
- }
120
- ```
121
-
122
- `if`, `elseIf` and `else` are not keywords or construct build into Firefly. `if` is just a function defined like this:
123
-
124
-
125
- ```firefly
126
- if[T](condition: Bool, body: () => T): Option[T] {
127
- condition.{
128
- | False => None
129
- | True => Some(body())
130
- }
131
- }
132
- ```
133
-
134
- # Exceptions
135
-
136
- ...
1
+ # Control flow
2
+
3
+ Firefly provides several ways to implement branching. Pattern matching is the most powerful, built directly into the language. `if`, `elseIf` and `else` do what you expect and are functions and methods in the standard library, implemented using the `Option` type. An then finally, there are [exceptions](#Exceptions).
4
+
5
+ # Pattern matching
6
+
7
+ Pattern matching allows you to check a given data structure against a pattern. For example, if we want to parse the command line arguments provided by the user, we could do it like this:
8
+
9
+ ```firefly
10
+ let pair = system.arguments().{
11
+ | [host] => Pair(host, 80)
12
+ | ["localhost", port] => Pair("localhost", port.grabInt())
13
+ | _ =>
14
+ system.writeErrorLine("Usage: 'localhost' | (host port)")
15
+ system.exit(0)
16
+ }
17
+ ```
18
+
19
+ In Firefly you construct a list of strings (`List[String]`) like this `["example.com", "80"]`, and using pattern matching you can de-construct in the same way.
20
+
21
+ ```firefly
22
+ data.{
23
+ | pattern1 => // case 1
24
+ | pattern2 => // case N
25
+ ...
26
+ }
27
+ ```
28
+
29
+ The patterns must be exhaustive, that is, for any possible value of the given type, there must be a matching pattern. In the example above, there are no value for the empty list `[]` , list with two values, where the first is not `"localhost"` or lists with more than 2 arguments. That's why we need the wildcard case at the end. Without this last case, the compiler would produce a compile-time error, stating that the patterns must be exhaustive.
30
+
31
+ Here are more examples — all exhaustive. Let's start with records:
32
+
33
+ ```firefly
34
+ pair.{
35
+ | Pair(first, second) =>
36
+ }
37
+ ```
38
+
39
+ Numbers
40
+
41
+ ```firefly
42
+ n.{
43
+ | 1 =>
44
+ | 2 =>
45
+ | n =>
46
+ }
47
+ ```
48
+
49
+ Booleans
50
+
51
+ ```firefly
52
+ n.{
53
+ | True =>
54
+ | False =>
55
+ }
56
+ ```
57
+
58
+ And you can combine pattern as needed. Imagine you have a pair of type `Pair[List[Bool], Pair(Int, String)]`
59
+
60
+
61
+ ```firefly
62
+ pair.{
63
+ | Pair([True, False], Pair(42, "foo")) =>
64
+ | other =>
65
+ }
66
+ ```
67
+
68
+
69
+ # Option
70
+
71
+ Sometimes you don't have a value. Other languages uses null for this purpose, but Firefly does not have null. Instead, we have `Option` from the core package.
72
+
73
+
74
+ ```firefly
75
+ data Option[T] {
76
+ None
77
+ Some(value: T)
78
+ }
79
+ ```
80
+
81
+ For some type `T`, say `String`, `Option[String]` is either some string or no value `None`. This way, the type system guides you to check for no-value.
82
+
83
+ Many functions and methods returns an `Option` in Firefly. For instance the `getInt` method on `String`. This method returns `Some[Int]` when the string consists only of digits and `None` otherwise. We can perform pattern matching on Option like this:
84
+
85
+ ```firefly
86
+ port.getInt().{
87
+ | None => 80
88
+ | Some(p) => p
89
+ }
90
+ ```
91
+
92
+ Many methods like `getInt` have a non-total counterpart `grabInt`, which returns an `Int`. But it will throw an exception when the input cannot be parsed. Options let's you code in an exception-safe manner.
93
+
94
+
95
+ # if - elseIf - else
96
+
97
+ You write if-statements in Firefly like this:
98
+
99
+ ```firefly
100
+ if(path == "/") {
101
+ response.writeText("<!doctype html>")
102
+ } elseIf {path.startsWith("/js/")} {
103
+ response.writeText("<script>")
104
+ } else {
105
+ response.writeStatus("404 Not found")
106
+ }
107
+ ```
108
+
109
+ You can also use it as an expression like this
110
+
111
+
112
+ ```firefly
113
+ let contentType = if(path == "/") {
114
+ "text/html; charset=UTF-8"
115
+ } elseIf(directory2.exists) {
116
+ "text/javascript; charset=UTF-8"
117
+ } else {
118
+ "text/plain; charset=UTF-8"
119
+ }
120
+ ```
121
+
122
+ `if`, `elseIf` and `else` are not keywords or construct build into Firefly. `if` is just a function defined like this:
123
+
124
+
125
+ ```firefly
126
+ if[T](condition: Bool, body: () => T): Option[T] {
127
+ condition.{
128
+ | False => None
129
+ | True => Some(body())
130
+ }
131
+ }
132
+ ```
133
+
134
+ # Exceptions
135
+
136
+ ...
@@ -0,0 +1,41 @@
1
+ # A Firefly file
2
+ # Base types
3
+ Bool, Int, Float, Char, String
4
+ # User defined types
5
+ data, class, capability, newtype
6
+ variant
7
+ (EVariantIs)
8
+ mutable fields, assign field
9
+ copy
10
+ Anonomous records
11
+ # Statements
12
+ let, mutable, assign
13
+ +=
14
+ ; (sequence)
15
+ # Functions and methods
16
+ signatures, type parameters
17
+ {...}
18
+ call, pipe
19
+ Eta expansion
20
+ extend
21
+ Unit
22
+ # Pattern matching
23
+ # Traits and instances
24
+ type parameters contraints (T: Ordered)
25
+ # Exceptions
26
+ # Packages and modules
27
+ package
28
+ .firefly/package.ff
29
+ include
30
+ dependency
31
+ import
32
+ # JavaScript interop
33
+ target
34
+ # Async I/O
35
+ # Structured concurrency
36
+
37
+
38
+
39
+ Shadowing
40
+ Type inference
41
+ Operator precedence
@@ -1 +1 @@
1
- dependency ff:compiler:0.0.0
1
+ dependency ff:compiler:0.0.0