modules

Documentation

Index

• func DefaultRoots(baseDir string) []string
• type FileResolver
  • func NewFileResolver(roots ...string) *FileResolver
  • func (r *FileResolver) Resolve(path string) ([]byte, error)
• type ModuleGraph
  • func Build(entry string, source []byte, resolver Resolver) (*ModuleGraph, error)
• type ResolvedModule
• type Resolver

Functions

func DefaultRoots

func DefaultRoots(baseDir string) []string

DefaultRoots returns standard module root directories.

Types

type FileResolver

type FileResolver struct {
	Roots []string // directories to search, e.g. ["stdlib/", "effects/"]
}

FileResolver resolves modules from filesystem roots.

func NewFileResolver

func NewFileResolver(roots ...string) *FileResolver

NewFileResolver creates a FileResolver with the given root directories.

func (*FileResolver) Resolve

func (r *FileResolver) Resolve(path string) ([]byte, error)

Resolve searches each root for path.lfx. For example, "std/math" searches each root for "std/math.lfx".

type ModuleGraph

type ModuleGraph struct {
	Entry string
	Nodes map[string]*ResolvedModule
	Edges map[string][]string // module path -> imported module paths
}

ModuleGraph tracks the dependency graph.

func Build

func Build(entry string, source []byte, resolver Resolver) (*ModuleGraph, error)

Build constructs the full import graph starting from entry. It parses each module to find imports, resolves them, detects cycles, and validates that effect modules do not import other effect modules.

type ResolvedModule

type ResolvedModule struct {
	Path   string
	Source []byte
	IsLib  bool
}

ResolvedModule holds the resolved source and metadata for a module.

type Resolver

type Resolver interface {
	Resolve(path string) ([]byte, error)
}

Resolver finds module source by path.