📝 docs(tsl): document {Unit.}Type source annotation

This commit is contained in:
csh 2026-01-07 15:10:29 +08:00
parent 3dceaf71fd
commit 41fc43b79e
1 changed files with 13 additions and 0 deletions

View File

@ -179,6 +179,19 @@ end;
- 签名尽量自解释:对外 API 的参数/返回值建议显式写类型注解;并用注释写清契约(可复用 3.2 的模板)。 - 签名尽量自解释:对外 API 的参数/返回值建议显式写类型注解;并用注释写清契约(可复用 3.2 的模板)。
- 类型注解不支持 `xxx.xxx` 形式;使用单一类型名。 - 类型注解不支持 `xxx.xxx` 形式;使用单一类型名。
- 若需标注类型来源,允许在类型名前用块注释写 `{Unit.}` 前缀,例如 `style_: {DocxML.}Style;`。该前缀仅为注释,不参与语义或类型检查,工具可能忽略;类型名仍是 `Style`(建议紧贴类型名书写)。
- 示例(`{Unit.}` 前缀仅用于阅读,不改变类型名):
```tsl
type DocxContext = class
public
property Style read style_ write style_;
private
style_: {DocxML.}Style;
end;
function RenderParagraph(para_: {DocxML.}Paragraph): void;
```
- 无返回值函数显式标注返回类型为 `void``create`/`destroy` 作为构造/析构函数不写返回类型。 - 无返回值函数显式标注返回类型为 `void``create`/`destroy` 作为构造/析构函数不写返回类型。
```tsl ```tsl