spec: define TypeParam fields

Author: AsterDY

README.md

@@ -21,7 +21,7 @@ Based on these features, developers can easily implement or enhance their AI-ass
 
 ## Universal Abstract-Syntax-Tree Specification
 
-see [UniAST Specification](docs/uniast-zh.md)
+see [UniAST Specification](docs/uniast-en.md)
 
 
 # Quick Start
@@ -117,19 +117,19 @@ $ exit
 
 ABCoder currently supports the following languages:
 
-| Language | Parser      | Writer      |
-| -------- | ----------- | ----------- |
-| Go       | ✅          | ✅          |
-| Rust     | ✅          | Coming Soon |
-| C        | ✅          | Coming Soon |
-| Python   | ✅          | Coming Soon |
+| Language | Parser | Writer      |
+| -------- | ------ | ----------- |
+| Go       | ✅      | ✅           |
+| Rust     | ✅      | Coming Soon |
+| C        | ✅      | Coming Soon |
+| Python   | ✅      | Coming Soon |
 
 
 # Getting Involved
 
 We encourage developers to contribute and make this tool more powerful. If you are interested in contributing to ABCoder
 project, kindly check out our guide:
-- [Parser Extension](docs/parser-zh.md)
+- [Parser Extension](docs/parser-en.md)
 
 > Note: This is a dynamic README and is subject to changes as the project evolves.
 

docs/uniast-en.md

@@ -249,6 +249,7 @@ Function type AST Node entity, corresponding to [NodeType] as FUNC, including fu
     "EndOffset": 3573,
     "Content": "// BindSession binds the session with current goroutine\nfunc (self *SessionManager) BindSession(Identity SessionIdentity, s Session) {\n\tshard : = self.shards[uint64(Identity)%uint64(self.opts.ShardNumber)]\n\n\tshard.Store(Identity, s)\n\n\tif self.opts.EnableImplicitlyTransmitAsync {\n\t\ttransmitSessionIdentity(Identity)\n\t}\n}",
     "Signature": "func (self *SessionManager) BindSession(Identity SessionIdentity, s Session)",
+    "TypeParams": [],
     "Receiver": {
         "IsPointer": true,
         "Type": {
@@ -334,6 +335,8 @@ Function type AST Node entity, corresponding to [NodeType] as FUNC, including fu
 
 - Signature: Function signature, including function name, parameters, return values, etc.
 
+- TypeParams: Generic type parameters (Dependency structure)
+
 - IsInterfaceMethod: Whether it is an interface method -- Here abcoder parse collects InterfaceMethod for easier LLM understanding, but it is not considered a language entity in write
 
 
@@ -420,9 +423,8 @@ Type definition, [NodeType] is TYPE, including type definitions in specific lang
     "StartOffset": 725,
     "EndOffset": 1027,
     "Content": "// Session represents a local storage for one session\ntype Session interface {\n\t// IsValid tells if the session is valid at present\n\tIsValid() bool\n\n\t// Get returns value for specific key\n\tGet(key interface{}) interface{}\n\n\t// WithValue sets value for specific key，and return newly effective session\n\tWithValue(key interface{}, val interface{}) Session\n}",
-    "InlineStruct": [
-        {} // dependency
-    ],
+    "InlineStruct": [],
+    "TypeParams": [],
     "Methods": {
         "Get": {
             "ModPath": "github.com/cloudwego/localsession",
@@ -475,6 +477,7 @@ Type definition, [NodeType] is TYPE, including type definitions in specific lang
 
     - Reason: In some languages like Golang, methods of nested sub-structs are inherited by the parent struct, so they are distinguished from general sub-structs to facilitate tracing all methods owned by the type
 
+- TypeParams: Generic type parameters (Dependency structure)
 
 - Methods: All method Identities corresponding to the struct. The key is the method name, and the value is the function Identity.
 

docs/uniast-zh.md

@@ -1,4 +1,4 @@
-# Universal Abstract-Syntax-Tree Specification (v0.1.3)
+# Universal Abstract-Syntax-Tree Specification (v0.1.4)
 
 Universal Abstract-Syntax-Tree 是 ABCoder 建立的一种 LLM 亲和、语言无关的代码上下文数据结构，表示某个仓库代码的统一抽象语法树。收集了语言实体（函数、类型、常（变）量）的定义及其相互依赖关系，用于后续的 AI 理解、coding-workflow 开发。
 
@@ -250,6 +250,7 @@ Universal Abstract-Syntax-Tree 是 ABCoder 建立的一种 LLM 亲和、语言
     "EndOffset": 3573,
     "Content": "// BindSession binds the session with current goroutine\nfunc (self *SessionManager) BindSession(Identity SessionIdentity, s Session) {\n\tshard : = self.shards[uint64(Identity)%uint64(self.opts.ShardNumber)]\n\n\tshard.Store(Identity, s)\n\n\tif self.opts.EnableImplicitlyTransmitAsync {\n\t\ttransmitSessionIdentity(Identity)\n\t}\n}",
     "Signature": "func (self *SessionManager) BindSession(Identity SessionIdentity, s Session)",
+    "TypeParams": [],
     "Receiver": {
         "IsPointer": true,
         "Type": {
@@ -335,6 +336,8 @@ Universal Abstract-Syntax-Tree 是 ABCoder 建立的一种 LLM 亲和、语言
 
 - Signature: 函数签名，包括函数名、参数、返回值等
 
+- TypeParams: 泛型的类型参数 (Dependency 结构)
+
 - IsInterfaceMethod: 是否是接口的方法--这里 abcoder parse 收集 InterfaceMethod 为了方便 LLM 理解，但是实际上 write 中并不会认为其是一个语言实体
 
 
@@ -421,9 +424,8 @@ Universal Abstract-Syntax-Tree 是 ABCoder 建立的一种 LLM 亲和、语言
     "StartOffset": 725,
     "EndOffset": 1027,
     "Content": "// Session represents a local storage for one session\ntype Session interface {\n\t// IsValid tells if the session is valid at present\n\tIsValid() bool\n\n\t// Get returns value for specific key\n\tGet(key interface{}) interface{}\n\n\t// WithValue sets value for specific key，and return newly effective session\n\tWithValue(key interface{}, val interface{}) Session\n}",
-    "InlineStruct": [
-        {} // dependency
-    ],
+    "InlineStruct": [],
+    "TypeParams": [],
     "Methods": {
         "Get": {
             "ModPath": "github.com/cloudwego/localsession",
@@ -476,6 +478,7 @@ Universal Abstract-Syntax-Tree 是 ABCoder 建立的一种 LLM 亲和、语言
 
 	- 原因: 在某些语言如 Golang 中嵌套子结构体的 methods 会被继承到父结构体中，因此和一般子结构体区分开，方便回溯该类型拥有的所有 method
 
+- TypeParams: 泛型的类型参数 (Dependency 结构)
 
 - Methods: 结构体对应的全部方法 **Identity**，key 为方法名，val 为函数 Identity。
 

lang/uniast/version.go

@@ -16,4 +16,4 @@
 
 package uniast
 
-const Version = "v0.1.3"
+const Version = "v0.1.4"