From 41fc43b79edef9f7fbbcef509643d22702167ce5 Mon Sep 17 00:00:00 2001 From: csh Date: Wed, 7 Jan 2026 15:10:29 +0800 Subject: [PATCH] :memo: docs(tsl): document {Unit.}Type source annotation --- docs/tsl/code_style.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/docs/tsl/code_style.md b/docs/tsl/code_style.md index dcbb3be..ed58002 100644 --- a/docs/tsl/code_style.md +++ b/docs/tsl/code_style.md @@ -179,6 +179,19 @@ end; - 签名尽量自解释：对外 API 的参数/返回值建议显式写类型注解；并用注释写清契约（可复用 3.2 的模板）。 - 类型注解不支持 `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` 作为构造/析构函数不写返回类型。 ```tsl