Function createModule

module.go:126–176

createModule implements the core module creation logic This function handles the QuickJS module creation and registration: 1. Module creation phase: create C module and declare exports 2. Module initialization phase: set actual export values via proxy The module will be available for import in JavaS

(ctx *Context, builder *ModuleBuilder)

// 2. Module initialization phase: set actual export values via proxy
// The module will be available for import in JavaScript code
func createModule(ctx *Context, builder *ModuleBuilder) error {
	// Step 1: Validate module builder
	if err := validateModuleBuilder(builder); err != nil {
		return fmt.Errorf("module validation failed: %v", err)
	}
	snapshot := cloneModuleBuilder(builder)

	// Step 2: Store a build snapshot in HandleStore for initialization access.
	builderID := ctx.handleStore.Store(snapshot)

	// Step 3: Prepare export names for C function
	exportNames := make([]*C.char, len(snapshot.exports))
	exportCount := len(snapshot.exports)

	// Convert Go strings to C strings
	for i, export := range snapshot.exports {
		exportNames[i] = C.CString(export.Name)
	}

	// Prepare parameters for C function call
	moduleName := C.CString(snapshot.name)
	var exportNamesPtr **C.char
	if exportCount > 0 {
		exportNamesPtr = &exportNames[0]
	}

	// Step 4: Call C function to create module
	result := C.CreateModule(
		ctx.ref,
		moduleName,
		exportNamesPtr,
		C.int(exportCount),
		C.int32_t(builderID),
	)

	// Step 5: Clean up C strings
	C.free(unsafe.Pointer(moduleName))
	for _, cStr := range exportNames {
		C.free(unsafe.Pointer(cStr))
	}

	// Step 6: Check result and handle errors
	if result < 0 {
		// Clean up HandleStore on failure
		ctx.handleStore.Delete(builderID)
		return ctx.Exception()
	}

	// Module is now created and registered, ready for import
	return nil
}