firefly-compiler 0.4.79 → 0.4.80

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 (158) 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 +141 -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 +443 -411
  67. package/fireflysite/Main.ff +141 -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 +19 -0
  72. package/fireflysite/ReferenceIntroduction.ff +11 -0
  73. package/fireflysite/Styles.ff +567 -495
  74. package/fireflysite/Test.ff +38 -0
  75. package/fireflysite/assets/markdown/reference/BaseTypes.md +209 -0
  76. package/fireflysite/assets/markdown/reference/FunctionsAndMethods.md +208 -0
  77. package/fireflysite/assets/markdown/reference/ModulesAndPackages.md +168 -0
  78. package/fireflysite/assets/markdown/reference/PatternMatching.md +224 -0
  79. package/fireflysite/assets/markdown/reference/StatementsAndExpressions.md +86 -0
  80. package/fireflysite/assets/markdown/reference/TraitsAndInstances.md +100 -0
  81. package/fireflysite/assets/markdown/reference/UserDefinedTypes.md +184 -0
  82. package/fireflysite/assets/markdown/{ControlFlow.md → scratch/ControlFlow.md} +136 -136
  83. package/fireflysite/assets/markdown/scratch/Toc.md +41 -0
  84. package/lsp/.firefly/package.ff +1 -1
  85. package/lsp/CompletionHandler.ff +828 -828
  86. package/lsp/Handler.ff +714 -714
  87. package/lsp/HoverHandler.ff +79 -79
  88. package/lsp/LanguageServer.ff +272 -272
  89. package/lsp/SignatureHelpHandler.ff +55 -55
  90. package/lsp/SymbolHandler.ff +181 -181
  91. package/lsp/TestReferences.ff +17 -17
  92. package/lsp/TestReferencesCase.ff +7 -7
  93. package/lsp/stderr.txt +1 -1
  94. package/lsp/stdout.txt +34 -34
  95. package/lux/.firefly/package.ff +1 -1
  96. package/lux/Css.ff +648 -648
  97. package/lux/CssTest.ff +48 -48
  98. package/lux/Lux.ff +487 -487
  99. package/lux/LuxEvent.ff +116 -116
  100. package/lux/Main.ff +123 -123
  101. package/lux/Main2.ff +143 -143
  102. package/output/js/ff/compiler/Builder.mjs +47 -47
  103. package/output/js/ff/compiler/Dependencies.mjs +3 -3
  104. package/output/js/ff/compiler/Inference.mjs +2 -2
  105. package/output/js/ff/compiler/JsEmitter.mjs +18 -72
  106. package/output/js/ff/compiler/Main.mjs +4 -4
  107. package/output/js/ff/compiler/ModuleCache.mjs +4 -4
  108. package/output/js/ff/core/Array.mjs +59 -59
  109. package/output/js/ff/core/Atomic.mjs +36 -36
  110. package/output/js/ff/core/BrowserSystem.mjs +11 -11
  111. package/output/js/ff/core/BuildSystem.mjs +30 -30
  112. package/output/js/ff/core/Crypto.mjs +40 -40
  113. package/output/js/ff/core/Float.mjs +50 -0
  114. package/output/js/ff/core/HttpClient.mjs +56 -56
  115. package/output/js/ff/core/Json.mjs +147 -147
  116. package/output/js/ff/core/List.mjs +50 -50
  117. package/output/js/ff/core/Lock.mjs +97 -97
  118. package/output/js/ff/core/NodeSystem.mjs +87 -87
  119. package/output/js/ff/core/Ordering.mjs +8 -8
  120. package/output/js/ff/core/Path.mjs +231 -231
  121. package/output/js/ff/core/Random.mjs +56 -56
  122. package/output/js/ff/core/Task.mjs +39 -39
  123. package/output/js/ff/core/Try.mjs +98 -4
  124. package/package.json +1 -1
  125. package/postgresql/Pg.ff +1 -1
  126. package/rpc/.firefly/package.ff +1 -1
  127. package/rpc/Rpc.ff +70 -70
  128. package/s3/.firefly/package.ff +1 -1
  129. package/s3/S3.ff +94 -94
  130. package/unsafejs/UnsafeJs.ff +19 -19
  131. package/vscode/LICENSE.txt +21 -21
  132. package/vscode/Prepublish.ff +15 -15
  133. package/vscode/README.md +16 -16
  134. package/vscode/client/package.json +22 -22
  135. package/vscode/client/src/extension.ts +104 -104
  136. package/vscode/icons/firefly-icon.svg +10 -10
  137. package/vscode/language-configuration.json +61 -61
  138. package/vscode/package-lock.json +3623 -3623
  139. package/vscode/package.json +1 -1
  140. package/vscode/snippets.json +241 -241
  141. package/vscode/syntaxes/firefly-markdown-injection.json +45 -45
  142. package/webserver/.firefly/include/package-lock.json +22 -22
  143. package/webserver/.firefly/include/package.json +5 -5
  144. package/webserver/.firefly/package.ff +2 -2
  145. package/webserver/WebServer.ff +685 -685
  146. package/websocket/.firefly/package.ff +1 -1
  147. package/websocket/WebSocket.ff +131 -131
  148. package/fireflysite/GuideAll.ff +0 -21
  149. package/fireflysite/GuideBaseTypes.ff +0 -168
  150. package/fireflysite/GuideControlFlow.ff +0 -212
  151. package/fireflysite/assets/markdown/Example.md +0 -78
  152. /package/fireflysite/assets/{NotoSansMono-Regular.ttf → font/NotoSansMono-Regular.ttf} +0 -0
  153. /package/fireflysite/assets/{NunitoSans-VariableFont_YTLC,opsz,wdth,wght.ttf → font/NunitoSans-VariableFont_YTLC,opsz,wdth,wght.ttf} +0 -0
  154. /package/fireflysite/assets/{autocomplete-small.png → image/autocomplete-small.png} +0 -0
  155. /package/fireflysite/assets/{autocomplete.png → image/autocomplete.png} +0 -0
  156. /package/fireflysite/assets/{edit-time-error.png → image/edit-time-error.png} +0 -0
  157. /package/fireflysite/assets/{firefly-logo-notext.png → image/firefly-logo-notext.png} +0 -0
  158. /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