Standard Library

当前标准库围绕核心值、Unicode 文本、集合、受控系统资源和结构数据建立强类型 API。公开能力以 norm/stdlib/std 源码、内建 ABI 与当前版本验收程序为准。

已交付模块

Package	职责	参考
std.core	Result、Unit、Exception 与核心 interface	核心类型
std.annotation	Annotation 目标、保留与拦截 interface	Annotation 规范
std.text	Unicode 规范化与文本构造	String
std.collections	序列算法与集合 extension	Collections
std.configuration	类型化框架配置到宿主属性的结构映射	Configuration
std.math	Integer 数学函数	Math
std.cli	长选项、位置参数与帮助	CLI
std.application	参数、环境、目录与完成码	CLI
std.process	子进程、输出预算、超时与取消	CLI
std.time	Instant、Duration 与 Clock	Time
std.concurrent	有类型任务、等待与取消	Concurrency
std.build	强类型结果构建器	结果构建器
std.io	Bytes、UTF-8、流与 Resource	I/O
std.filesystem	流式文件读写	Filesystem
std.http	URI、请求、响应与 HTTP client	HTTP
std.websocket	WS/WSS 客户端、消息与连接生命周期	WebSocket
std.serialization	结构映射契约与 metadata	Serialization
std.json	JSON tree、parse/write 与结构映射	JSON
std.xml	XML 结构映射	XML
std.yaml	YAML 结构映射	YAML
std.validation	字段与参数约束	Validation
std.testing	断言值与验收输出协议	Testing

Array、List、Map、Set、Stack、Queue、Deque、Pair、Range 和 StringBuilder 是当前内建类型模型的一部分，并由标准库源码提供组合算法。

共同规则

• 公共 API 保留完整静态类型，不接受 raw collection；
• 普通缺失使用 T?，互斥业务结果使用 enum 或 Result<T, E>，系统失败抛出领域 Exception；
• 外部资源通过 Resource 与 use 确定性关闭；
• 文本 API 明确区分 byte、Unicode code point 和 grapheme；
• 序列化按 Core field ordinal 读取 value，不依赖 JVM reflection 或字符串 getter；
• 配置映射与序列化共享结构 metadata，不维护第二份字符串属性表；
• 每个格式保留自己的领域规则和失败类型，不使用不真实的统一错误模型。

当前边界

结构映射只处理 value。Class identity、对象图、循环引用和多态尚未进入协议。HTTP 服务应用使用独立库；当前可用范围见库示例与 Status。

具体签名以各页面链接的 Norm 源码为准，文档负责解释模块职责、失败边界和最小用法，不复制第二份完整方法清单。

独立库

OpenAI 客户端 作为独立库提供 Responses API，不进入标准库。

库示例索引按用途链接到各仓库维护的可运行场景。