📝 fix(docs): fix specifications

Signed-off-by: FurryR <awathefox@gmail.com>

Author: FurryR

README.md

@@ -19,7 +19,7 @@ event.start {
 - **Supports variables, lists, and custom blocks**
 - **Event-driven programming** with Scratch hat blocks
 - **Type annotations** for better code clarity
-- **Decorators** for external block integration
+- **Decorators** for exporting blocks and variables
 - Can be used as **Intermediate Representation (IR)** for other languages, or as a component for Scratch Addons
 
 ## Examples
@@ -113,15 +113,14 @@ event.keyPressed("space") {
 }
 ```
 
-### Using External Blocks with Decorators
+### Export Blocks with Decorators
 
 ```fuse
-// Define external Scratch blocks using @extern decorator
-@extern("wait 1 frame") fn yield() once -> void {
-  // External block implementation
+// Export Scratch blocks using @export decorator
+@export("wait 1 frame") fn yield() once -> void {
 }
 
-@extern("current timestamp") fn currentTimestamp() once -> any {
+@export("current timestamp") fn currentTimestamp() once -> any {
   return sensing.daysSince2000() * 86400 * 1000
 }
 
@@ -140,13 +139,21 @@ event.start {
 ### FPS Counter Example
 
 ```fuse
-@extern("last timestamp") let lastTimestamp = 0
+@export("// [value]") fn description(value: any) once -> void {
+  // This function is a no-op, used for adding comments in the generated Scratch blocks
+}
+@export("drop [value]") fn drop(value: any) once -> void {
+  description(value)
+}
+@export("last timestamp") let lastTimestamp = 0
 
-@extern("current timestamp") fn currentTimestamp() once -> any {
+@export("current timestamp") fn currentTimestamp() once -> any {
   return sensing.daysSince2000() * 86400 * 1000
 }
 
-@extern("wait 1 frame") fn yield() once -> void {}
+@export("wait 1 frame") fn yield() once -> void {
+  drop(translate.getTranslate(1, ""))
+}
 
 fn calculateFps() once -> any {
   lastTimestamp = currentTimestamp()

specification.md

@@ -155,7 +155,7 @@ Target = FunctionDeclaration | VariableDeclaration ;
 ArgumentList = Literal ("," Literal)* ;
 ```
 
-**Note**: Currently, only the `@extern` decorator is supported.
+**Note**: Currently, only the `@export` decorator is supported.
 
 ### Hat Blocks (Event Handlers)
 
@@ -323,20 +323,20 @@ The FUSE program structure allows only the following at the top level:
 FUSE uses a simple type system:
 - `void`: No return value
 - `any`: Any Scratch value (string, number, boolean)
-- Custom types can be defined through identifiers
+- `bool`: Boolean values (`true` or `false`)
 
 ### Decorators
 
-#### `@extern` Decorator
+#### `@export` Decorator
 
-The `@extern` decorator is used to define external Scratch blocks or mark code that should use specific Scratch block implementations.
+The `@export` decorator is used to export Scratch blocks.
 
 ```fuse
-@extern("block description") fn functionName(params) once -> returnType {
-  // implementation
+@export("test [params]") fn functionName(params: any) once -> returnType {
+  // The function will appear as a Scratch block with the given name and parameters
 }
 
-@extern("variable description") let variableName = initialValue ;
+@export("variable description") let variableName = initialValue ;
 ```
 
 ### Operators
@@ -502,10 +502,10 @@ fn processArray() once -> void {
 }
 ```
 
-### External Blocks
+### exportal Blocks
 
 ```fuse
-@extern("custom block [arg1] and [arg2]") 
+@export("custom block [arg1] and [arg2]") 
 fn customBlock(arg1: any, arg2: any) once -> any {
   return arg1 + arg2
 }

src/compiler/compiler.ts

@@ -1584,7 +1584,7 @@ export class Compiler {
           case 'DecoratorStatement': {
             // Perform simple check
             const decorator = stmt as DecoratorStatement
-            if (decorator.name.name !== 'extern') {
+            if (decorator.name.name !== 'export') {
               throw new CompilerError(
                 `Unknown decorator @${decorator.name.name}`,
                 decorator.line,
@@ -2622,14 +2622,14 @@ export class Compiler {
         let exportName: string | null = null
         if (decl.type === 'DecoratorStatement') {
           const decorator = decl as DecoratorStatement
-          if (decorator.name.name !== 'extern') {
+          if (decorator.name.name !== 'export') {
             throw new CompilerError(
               `Unknown decorator @${decorator.name.name}`,
               decorator.line,
               decorator.column
             )
           }
-          // @export("external name") fn ...
+          // @export("exportal name") fn ...
           if (decorator.target.type !== 'FunctionDeclaration') {
             continue
           }
@@ -2696,14 +2696,14 @@ export function getProgramInfo(program: Program): ProgramInfo {
       let exportName: string | null = null
       if (decl.type === 'DecoratorStatement') {
         const decorator = decl as DecoratorStatement
-        if (decorator.name.name !== 'extern') {
+        if (decorator.name.name !== 'export') {
           throw new CompilerError(
             `Unknown decorator @${decorator.name.name}`,
             decorator.line,
             decorator.column
           )
         }
-        // @export("external name") global id = 1
+        // @export("exportal name") global id = 1
         if (decorator.target.type !== 'VariableDeclaration') {
           continue
         }