Add function type info

[waynemwashuma]

Objective

Add function type information support to the reflect module, enabling the reflection system to track and query function parameter and return types.

Solution

Introduced a new FunctionInfo class that extends TypeInfo to store function signature metadata. This class provides:

• Storage of parameter types as a readonly array of TypeId
• Storage of return type as a TypeId
• Methods to retrieve individual parameters by index, get all parameters, and get the return type

Additionally, added a typeidFunction utility that generates proper type IDs for function signatures in the format fn(param1,param2,...):returnType.

Extended the type system by adding the TupleFnConstructor type definition to properly represent parameter type tuples in a type-safe manner.

Showcase

import { FunctionInfo, typeid, typeidFunction } from '@reflect'

// Create function type info
const functionInfo = new FunctionInfo(
  [typeid(Number), typeid(String)], 
  typeid(Boolean)
)

// Access parameter information
const firstParam = functionInfo.getParameter(0)  // Returns typeid(Number)
const allParams = functionInfo.getParameters()    // Returns all parameter types
const returnType = functionInfo.getReturnType()   // Returns typeid(Boolean)

// Generate type IDs for functions
function myFunction(a, b) {
  return true
}
const typeId = typeidFunction(myFunction, [Number, String], Boolean)

Migration guide

No breaking changes. This is a pure enhancement to the reflect module that adds new functionality without modifying existing APIs.

Checklist

• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have added tests to cover my changes.