111 Commits

Author SHA1 Message Date
chinboy 21903f7a30 fix(Generator): 统一语义部件 Since 为三段式发布版本并校验格式 2026-09-17 11:13:21 +08:00
chinboy 02dca1c1f7 feat(Semantic): 更新 Popup、Overlay 和服务宿主控件家族的语义契约,增加 DropdownButton 控件并修正相关文档 2026-09-17 11:13:03 +08:00
chinboy cb524c7900 feat(Semantic): add Cascader semantic parts with gallery showcase 2026-09-17 11:08:55 +08:00
chinboy a23522973e feat(AutoComplete): 增加语义部件并扩展跨嵌套与弹层机制、对齐 antd 示例 2026-09-17 11:08:55 +08:00
chinboy 5d6e8c1748 fix(GalleryStickyTabsHost): replace frozen VisualBrush mirror with live sticky elevation 2026-09-17 11:08:51 +08:00
chinboy 8396abc536 feat(Semantic): add Steps semantic parts with viewport-filling parts pane 2026-09-17 10:59:01 +08:00
chinboy a9f3335d31 feat(Semantic): add Calendar parts and align Ant Design demo 2026-09-17 10:57:53 +08:00
chinboy a439bb99dd feat(Semantic): enhance semantic part descriptors and improve styling for Descriptions 2026-09-17 10:57:01 +08:00
chinboy f7f183a3cd feat(Semantic): add semantic part descriptors and improve Badge control styling 2026-09-17 10:56:14 +08:00
chinboy d2e4722c81 gallery(Semantic): add lazy Semantic Part preview infrastructure 2026-09-17 10:54:59 +08:00
chinboy 937415aa94 feat(Semantic): enforce static semantic class markers in templates 2026-09-17 10:54:05 +08:00
chinboy 05c04e8d3c feat(Theme): implement Semantic Part contracts and tooling 2026-09-17 10:54:05 +08:00
chinboy c04ae9176f feat(AOT): 引入 AotTrimUnit 注解机制替代 PackageCore 目录约定 2026-09-16 14:33:01 +08:00
chinboy a7259a9284 fix(Motion): 统一内容开合动画并修复手风琴闪烁与抖动 2026-09-10 16:11:58 +08:00
chinboy 943c9cdeba fix(ImageLoading,Avatar): 兼容重复 SVG ID 并修复文字居中 2026-09-10 12:15:29 +08:00
chinboy 5b465d0efe refactor(ImageLoading)!: 重构图片源、缓存与预览切换管线 2026-09-07 23:10:02 +08:00
chinboy a8cdfc0f58 feat(TokenSystem)!: 支持 Control Design Token 继承 2026-09-07 22:38:43 +08:00
chinboy 04b070d61e fix(Gallery): 修复窗口缩放时 ShowCase 卡片换列闪动 2026-09-07 10:01:31 +08:00
chinboy 7a66123a13 fix(AOT): 修复跨项目与预编译程序集的注册闭包缺失(#453) 2026-09-05 08:52:21 +08:00
chinboy 38ef578034 feat(ImageLoading): support secure network SVG and harden lifecycle 2026-08-25 19:22:28 +08:00
chinboy 829edb980d feat(ImageLoading)!: 引入统一图片加载管线并迁移相关控件 2026-08-24 20:43:22 +08:00
CHINBOY 215f2552bb fix(build): canonicalize linked-registration Sidecar inputs 2026-08-20 16:06:42 +08:00
chinboy 0d3d9727c6 fix(AOT): restore sidecar delivery and narrow linked fallbacks 2026-08-17 23:07:14 +08:00
chinboy 9593bf1537 fix(AOT): bound linked registration analysis and static unit planning 2026-08-17 15:18:29 +08:00
chinboy 348784815b refactor(AOT)!: default registration units to package granularity 2026-08-16 11:10:55 +08:00
chinboy bd5633bab2 feat(Gallery): enhance metadata layout and introduce responsive media breakpoints 2026-08-16 10:51:25 +08:00
chinboy 9dc3d80324 docs(Mobile): integrate mobile documentation navigation 2026-08-11 11:25:12 +08:00
chinboy 447359a8ee docs(Mobile): define mobile Gallery ownership 2026-08-11 11:25:11 +08:00
chinboy 6e81c13225 docs(Mobile): define mobile package and adapter boundaries 2026-08-11 11:25:11 +08:00
chinboy 4391e14155 docs(Typography): define font subsystem architecture
新增 `docs/architecture/systems/typography/`,记录字体子系统的当前架构。此前字体只有
`docs/modules/fonts/overview.md` 一页概览,跨模块的契约、派生算法和边界没有正式所有者。

字体跨 `AtomUI.Core`、两个 `AtomUI.Fonts.*` 包、`AtomUI.Controls` 和消费控件,按文档分类规范
属于 `architecture/systems/`。核心结论是它由两条互不相干的轴组成:字体资源注册进 Avalonia
`FontManager`,与主题编译字号行高 Token,两者只在解析 `FontFamily` 字符串时汇合,没有任何代码
把它们对账。

按职责拆成六篇:overview 定位与两轴架构;font-packages 讲 `FontCollection` 与注册入口;
font-family-resolution 讲回退链、覆盖路径与注入时序;tokens-and-derivation 讲 23 个 Token 的
分级与 `e^(i/5)` 阶梯算法;consumption 讲 AXAML 与 C# 消费面和相对行高换算;verification 讲
AOT、兼容性、验证要求与已知不一致。

记录三处已确认的实现问题,均经源码核对:

- Compact 算法不压缩字号。`CalculateFontMapTokenValues` 以 `FontSize` 而非 `FontSizeSM` 为基数,
  且第 1 档强制等于基数使重算幂等,因此 Compact 与 Default 的字体 Token 完全相同。上游 antd
  compact 取 `fontSizeSM`,`FontSize = 14` 时应得 12 而非 14。共享派生函数里还留着上游那句
  `// Smaller size font-size as base` 注释,位置已使其不再成立。
- 默认字体族首项 `fonts:AlibabaSans` 是前向引用。`AtomUI.Core` 不依赖字体包,`AtomUI.Controls`
  的项目引用也不含 `AddFontCollection`;未注册时 Avalonia 静默回退,全程无诊断信号。
- 相对行高到绝对行高的换算在五个控件中各写一遍,无共享 helper,且必须同时监听行高与字号两个
  属性才不会在字号变化后失配。

同步在 `docs/overview.md`、Architecture 与 systems 导航、主题系统导航和 Fonts 模块接入入口。
2026-08-10 14:25:44 +08:00
chinboy 9f6ec36645 docs: rename directory entry files to overview.md
统一文档目录的入口文件名为 `overview.md`,取代原先的 `index.md`。单 Control 目录本来就用
`overview.md`,此前只有目录级入口用 `index.md`,两套命名并存;现在全库一致。

改名覆盖 42 个入口文件:`docs/` 根、一级分类目录、Architecture 分组与跨模块系统目录、Module
目录、Control 平台与分类目录、Guide 与 Reference 子目录。`docs/AI/generated/index.md` 是手工
维护的导航页,一并改名。

生成产物 `docs/AI/generated/llms/**/index-cn.md` 保持原名,它属于 LLMs Generator 的输出契约。

同步更新 28 个正式文档与 `AGENTS.md` 中的入站链接,以及两处目录树示意图。改名后全部相对链接
可解析,LLMs Generator `verify` 通过(78 控件 / 159 文件),单 Control 四件套文件名契约未变。

新增 `docs/engineering/contributing/documentation-structure-guidelines.md` 承载入口命名、文档
拆分标准、事实所有权和链接规范。此前该规则只写在带日期的设计过程记录里,不适合作为长期来源。
`docs/superpowers/specs/2026-08-10-documentation-information-architecture-design.md` 保留原文
并加取代说明,其余结论继续有效。
2026-08-10 14:24:36 +08:00
chinboy cafec81a6f docs: organize AI outputs and prune redundant module pages 2026-08-10 11:05:37 +08:00
chinboy 3f5cc5b56f docs: standardize navigation releases and generated output 2026-08-10 09:57:22 +08:00
chinboy 0bc3447ebb docs: reorganize module engineering and Gallery domains 2026-08-10 09:32:07 +08:00
chinboy bc482f94d1 docs(Controls): reorganize shared infrastructure documentation 2026-08-10 09:12:36 +08:00
chinboy a43ea82e4b docs(Localization): separate system module and reference docs 2026-08-10 09:02:52 +08:00
chinboy 83ff8e94ed docs(Theme): separate architecture guides and reference 2026-08-10 08:59:22 +08:00
chinboy 3ab7df2ba0 docs(Core): define Semantic Part architecture and generator contract 2026-08-10 08:28:42 +08:00
chinboy 12ba9b92ef chore(Release): add build and packaging for AtomUI language packs 2026-08-09 13:05:32 +08:00
chinboy 85ac813fc4 refactor(Localization): update namespace for localization build tasks and adjust target states in XLIFF files 2026-08-08 17:33:08 +08:00
chinboy f501cee604 refactor(Localization): simplify language pack authoring 2026-08-08 12:23:29 +08:00
chinboy fee5ef72b8 docs(Localization): define deferred language pack validation 2026-08-08 10:39:04 +08:00
chinboy ee680c3546 refactor(Localization): rename LocalizationRuntime to LocalizationHost and update related references 2026-08-08 09:32:14 +08:00
chinboy 46e3156d6d gallery(Localization): add pt-BR resources and responsive demos 2026-08-08 00:05:25 +08:00
chinboy cf127d7793 build(Localization): support language pack project references 2026-08-07 17:58:52 +08:00
chinboy 03866a7d88 feat(Localization): finalize pt-BR control translations 2026-08-07 16:36:25 +08:00
chinboy 93fba1053c feat(Localization): add pt-BR control translation drafts 2026-08-07 16:26:24 +08:00
chinboy 17be2f4b9a fix(Localization): support intentional empty translations 2026-08-07 16:19:53 +08:00
chinboy bd59e44b1b feat(Localization): scaffold official pt-BR language packages 2026-08-07 15:43:46 +08:00
chinboy 39513bc134 docs(Localization): define modular pt-BR language pack architecture 2026-08-07 13:55:55 +08:00