goscript 0.0.54 → 0.0.56

package/README.md

@@ -64,6 +64,108 @@ npm install -g goscript
 goscript compile --package . --output ./dist
 ```
 
+## 📦 Using Generated Code in Your Project
+
+After compiling your Go code to TypeScript, you'll need to set up your project appropriately.
+
+### TypeScript Configuration
+
+Create or update your `tsconfig.json` with these settings:
+
+```json
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "esnext.disposable", "dom"],
+    "baseUrl": "./",
+    "paths": {
+      "@goscript/*": ["./path/to/generated/output/@goscript/*"]
+    },
+    "allowSyntheticDefaultImports": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "strict": true
+  }
+}
+```
+
+**Important requirements:**
+- **`target: "ES2022"` or newer** - Required for `Disposable` and other features
+- **`lib: ["esnext.disposable"]`** - Enables TypeScript's disposable types for resource management
+- **`baseUrl` and `paths`** - Allows TypeScript to resolve `@goscript/*` imports
+- **`moduleResolution: "bundler"`** - Recommended for modern bundlers
+
+You should be able to use any TypeScript bundler to compile the generated TypeScript.
+
+## 🛠️ Integration & Usage
+
+### Command Line
+
+```bash
+goscript compile --package ./my-go-code --output ./dist
+```
+
+**Options:**
+- `--package <path>` - Go package to compile (default: ".")
+- `--output <dir>` - Output directory for TypeScript files
+
+### Programmatic API
+
+**Go:**
+```go
+import "github.com/aperturerobotics/goscript/compiler"
+
+conf := &compiler.Config{OutputPath: "./dist"}
+comp, err := compiler.NewCompiler(conf, logger, nil)
+_, err = comp.CompilePackages(ctx, "your/package/path")
+```
+
+**Node.js:**
+```typescript
+import { compile } from 'goscript'
+
+await compile({
+  pkg: './my-go-package',
+  output: './dist'
+})
+```
+
+### Frontend Frameworks
+
+**React + GoScript:**
+```typescript
+import { NewCalculator } from '@goscript/myapp/calculator'
+
+function CalculatorApp() {
+  const [calc] = useState(() => NewCalculator())
+  
+  const handleAdd = () => {
+    const result = calc.Add(5, 3)
+    setResult(result)
+  }
+
+  return <button onClick={handleAdd}>Add 5 + 3</button>
+}
+```
+
+**Vue + GoScript:**
+```vue
+<script setup lang="ts">
+import { NewUser, FindUserByEmail } from '@goscript/myapp/user'
+
+const users = ref([
+  NewUser(1, "Alice", "alice@example.com")
+])
+
+const searchUser = (email: string) => {
+  return FindUserByEmail(users.value, email)
+}
+</script>
+```
+
+
 ## 💡 See It In Action
 
 ### Example: User Management
@@ -196,72 +298,6 @@ async function handleMessages() {
 }
 ```
 
-## 🛠️ Integration & Usage
-
-### Command Line
-
-```bash
-goscript compile --package ./my-go-code --output ./dist
-```
-
-**Options:**
-- `--package <path>` - Go package to compile (default: ".")
-- `--output <dir>` - Output directory for TypeScript files
-
-### Programmatic API
-
-**Go:**
-```go
-import "github.com/aperturerobotics/goscript/compiler"
-
-conf := &compiler.Config{OutputPath: "./dist"}
-comp, err := compiler.NewCompiler(conf, logger, nil)
-_, err = comp.CompilePackages(ctx, "your/package/path")
-```
-
-**Node.js:**
-```typescript
-import { compile } from 'goscript'
-
-await compile({
-  pkg: './my-go-package',
-  output: './dist'
-})
-```
-
-### Frontend Frameworks
-
-**React + GoScript:**
-```typescript
-import { NewCalculator } from '@goscript/myapp/calculator'
-
-function CalculatorApp() {
-  const [calc] = useState(() => NewCalculator())
-  
-  const handleAdd = () => {
-    const result = calc.Add(5, 3)
-    setResult(result)
-  }
-
-  return <button onClick={handleAdd}>Add 5 + 3</button>
-}
-```
-
-**Vue + GoScript:**
-```vue
-<script setup lang="ts">
-import { NewUser, FindUserByEmail } from '@goscript/myapp/user'
-
-const users = ref([
-  NewUser(1, "Alice", "alice@example.com")
-])
-
-const searchUser = (email: string) => {
-  return FindUserByEmail(users.value, email)
-}
-</script>
-```
-
 ## 🚀 What's Next?
 
 **Current Status:**
@@ -276,19 +312,7 @@ const searchUser = (email: string) => {
 - ⚡ Performance optimizations
 - 🔧 Better tooling integration
 
-Check our [compliance tests](./compliance/COMPLIANCE.md) for detailed progress.
-
-## 🤝 Real-World Use Cases
-
-**Fintech:** Share complex financial calculations between Go services and trading dashboards
-
-**Gaming:** Run the same game logic on servers and in browser clients
-
-**Data Processing:** Use identical algorithms for backend ETL and frontend analytics
-
-**Validation:** Keep business rules consistent across your entire stack
-
-Ready to eliminate code duplication? [Get started now](#-get-started-in-2-minutes) 🚀
+Check the [compliance tests](./compliance/COMPLIANCE.md) for detailed progress.
 
 ## License
 

package/compiler/compiler.go

@@ -434,6 +434,24 @@ func (c *PackageCompiler) generateIndexFile(compiledFiles []string) error {
 				case *ast.FuncDecl:
 					if d.Recv == nil && d.Name.IsExported() {
 						valueSymbols = append(valueSymbols, sanitizeIdentifier(d.Name.Name))
+					} else if d.Recv != nil && len(d.Recv.List) == 1 && d.Name.IsExported() {
+						recvField := d.Recv.List[0]
+						recvTypeExpr := recvField.Type
+						if star, ok := recvTypeExpr.(*ast.StarExpr); ok {
+							recvTypeExpr = star.X
+						}
+						if ident, ok := recvTypeExpr.(*ast.Ident); ok {
+							typeObj := c.pkg.TypesInfo.ObjectOf(ident)
+							if typeObj != nil && typeObj.Exported() {
+								if typeName, ok := typeObj.(*types.TypeName); ok {
+									underlying := typeName.Type().Underlying()
+									if _, isStruct := underlying.(*types.Struct); !isStruct {
+										methodName := sanitizeIdentifier(ident.Name + "_" + d.Name.Name)
+										valueSymbols = append(valueSymbols, methodName)
+									}
+								}
+							}
+						}
 					}
 				case *ast.GenDecl:
 					for _, spec := range d.Specs {

package/compiler/compiler_test.go

@@ -1,6 +1,7 @@
 package compiler_test
 
 import (
+	"fmt"
 	"os"
 	"os/exec"
 	"path/filepath"
@@ -135,5 +136,14 @@ func getParentGoModulePath() (string, error) {
 	if err != nil {
 		return "", err
 	}
-	return strings.TrimSpace(string(output)), nil
+	// note: in a go work configuration, go list -m can report multiple modules
+	// only one of which is the goscript case, so we need to filter:
+	pf := strings.Fields(strings.TrimSpace(string(output)))
+	pf = slices.DeleteFunc(pf, func(n string) bool {
+		return !strings.HasSuffix(n, "goscript")
+	})
+	if len(pf) != 1 {
+		return "", fmt.Errorf("'go list -m' did not have exactly 1 goscript package -- run in root of goscript package")
+	}
+	return pf[0], nil
 }

package/compiler/expr-call.go

@@ -349,9 +349,47 @@ func (c *GoToTSCompiler) writeWrapperTypeMethodCall(exp *ast.CallExpr, selectorE
 	c.tsw.WriteLiterally(selectorExpr.Sel.Name)
 	c.tsw.WriteLiterally("(")
 
-	// First argument is the receiver
-	if err := c.WriteValueExpr(selectorExpr.X); err != nil {
-		return true, fmt.Errorf("failed to write wrapper type method receiver: %w", err)
+	// Write the receiver (the object the method is called on)
+	// For pointer receiver methods, we need to pass the VarRef instead of the value
+	receiverNeedsVarRef := false
+
+	// Check if the method has a pointer receiver by looking at the method signature
+	if selection := c.pkg.TypesInfo.Selections[selectorExpr]; selection != nil {
+		if methodObj := selection.Obj(); methodObj != nil {
+			if methodFunc, ok := methodObj.(*types.Func); ok {
+				if sig, ok := methodFunc.Type().(*types.Signature); ok && sig != nil {
+					if recv := sig.Recv(); recv != nil {
+						if _, isPointer := recv.Type().(*types.Pointer); isPointer {
+							receiverNeedsVarRef = true
+						}
+					}
+				}
+			}
+		}
+	}
+
+	if receiverNeedsVarRef {
+		// For pointer receivers, we need to pass the VarRef
+		// Convert p.field to p._fields.field
+		if selExpr, ok := selectorExpr.X.(*ast.SelectorExpr); ok {
+			if baseIdent, ok := selExpr.X.(*ast.Ident); ok {
+				c.tsw.WriteLiterally(baseIdent.Name)
+				c.tsw.WriteLiterally("._fields.")
+				c.tsw.WriteLiterally(selExpr.Sel.Name)
+			} else {
+				if err := c.WriteValueExpr(selectorExpr.X); err != nil {
+					return true, fmt.Errorf("failed to write wrapper type method receiver: %w", err)
+				}
+			}
+		} else {
+			if err := c.WriteValueExpr(selectorExpr.X); err != nil {
+				return true, fmt.Errorf("failed to write wrapper type method receiver: %w", err)
+			}
+		}
+	} else {
+		if err := c.WriteValueExpr(selectorExpr.X); err != nil {
+			return true, fmt.Errorf("failed to write wrapper type method receiver: %w", err)
+		}
 	}
 
 	// Add other arguments

package/compiler/spec.go

@@ -376,8 +376,10 @@ func (c *GoToTSCompiler) WriteNamedTypeWithMethods(a *ast.TypeSpec) error {
 			}
 			recvField := funcDecl.Recv.List[0]
 			recvType := recvField.Type
+			isPointerReceiver := false
 			if starExpr, ok := recvType.(*ast.StarExpr); ok {
 				recvType = starExpr.X
+				isPointerReceiver = true
 			}
 
 			// Check for both simple identifiers (FileMode) and generic types (FileMode[T])
@@ -391,12 +393,7 @@ func (c *GoToTSCompiler) WriteNamedTypeWithMethods(a *ast.TypeSpec) error {
 			}
 
 			if recvTypeName == className {
-				if !isInsideFunction {
-					c.tsw.WriteLiterally("export ")
-				}
-
-				// Generate function signature: export function TypeName_MethodName(receiver: TypeName, ...args): ReturnType
-				c.tsw.WriteLiterally("function ")
+				c.tsw.WriteLiterally("export function ")
 				c.tsw.WriteLiterally(className)
 				c.tsw.WriteLiterally("_")
 				c.tsw.WriteLiterally(funcDecl.Name.Name)
@@ -413,7 +410,15 @@ func (c *GoToTSCompiler) WriteNamedTypeWithMethods(a *ast.TypeSpec) error {
 				}
 				c.tsw.WriteLiterally(receiverParamName)
 				c.tsw.WriteLiterally(": ")
-				c.tsw.WriteLiterally(className)
+
+				// For pointer receivers, use VarRef<T>
+				if isPointerReceiver {
+					c.tsw.WriteLiterally("$.VarRef<")
+					c.tsw.WriteLiterally(className)
+					c.tsw.WriteLiterally(">")
+				} else {
+					c.tsw.WriteLiterally(className)
+				}
 
 				// Add other parameters
 				if funcDecl.Type.Params != nil && len(funcDecl.Type.Params.List) > 0 {

package/compiler/stmt-range.go

@@ -3,11 +3,10 @@ package compiler
 import (
 	"fmt"
 	"go/ast"
+	"go/token"
 	"go/types"
 	"strings"
 
-	"go/token"
-
 	"github.com/pkg/errors"
 )
 

package/dist/gs/reflect/iter.js.map

@@ -1 +1 @@
-{"version":3,"file":"iter.js","sourceRoot":"","sources":["../../../gs/reflect/iter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,WAAW,CAAA;AAKhD,MAAM,UAAU,QAAQ,CAKtB,GAAM,EAAE,CAAO;IACf,8CAA8C;IAE9C,2CAA2C;IAC3C,wBAAwB;IACxB,OAAO,CAAC,MAAsC,EAAQ,EAAE;QACtD,IAAI,OAAO,GAAG,CAAE,CAAC,OAAQ,EAAE,IAAI,EAAE,CAAA;QACjC,8CAA8C;QAE9C,2CAA2C;QAC3C,wBAAwB;QACxB,KAAK,IAAI,CAAC,GAAG,CAAiB,EAAE,CAAC,GAAI,GAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/D,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;YAC5B,2CAA2C;YAC3C,wBAAwB;YACxB,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;YAC9B,CAAC;YACD,IAAI,CAAC,MAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}
+{"version":3,"file":"iter.js","sourceRoot":"","sources":["../../../gs/reflect/iter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,OAAO,EAAE,MAAM,WAAW,CAAA;AAKhD,MAAM,UAAU,QAAQ,CACtB,GAAM,EACN,CAAO;IAEP,8CAA8C;IAE9C,2CAA2C;IAC3C,wBAAwB;IACxB,OAAO,CAAC,MAAsC,EAAQ,EAAE;QACtD,IAAI,OAAO,GAAG,CAAE,CAAC,OAAQ,EAAE,IAAI,EAAE,CAAA;QACjC,8CAA8C;QAE9C,2CAA2C;QAC3C,wBAAwB;QACxB,KAAK,IAAI,CAAC,GAAG,CAAiB,EAAE,CAAC,GAAI,GAAoB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/D,IAAI,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;YAC5B,2CAA2C;YAC3C,wBAAwB;YACxB,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAA;YAC9B,CAAC;YACD,IAAI,CAAC,MAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClB,OAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC,CAAA;AACH,CAAC"}

package/gs/reflect/iter.ts

@@ -3,12 +3,10 @@ import { uintptr } from './types.js'
 
 import * as iter from '@goscript/iter/index.js'
 
-export function rangeNum<
-  T extends
-    | number
-    | uintptr,
-  N extends number | number,
->(num: N, t: Type): iter.Seq<Value> {
+export function rangeNum<T extends number | uintptr, N extends number | number>(
+  num: N,
+  t: Type,
+): iter.Seq<Value> {
   // cannot use range T(v) because no core type.
 
   // if the iteration value type is define by

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "goscript",
   "description": "Go to TypeScript transpiler",
-  "version": "0.0.54",
+  "version": "0.0.56",
   "author": {
     "name": "Aperture Robotics LLC.",
     "email": "support@aperture.us",