Spectrum CSS 5.0.0版本发布：上下文帮助组件重大更新

项目背景

Spectrum CSS是Adobe开源的一套CSS框架，它为Adobe产品提供了一套统一的设计语言和UI组件。这套框架遵循Adobe Spectrum设计系统，帮助开发者快速构建符合Adobe设计规范的Web应用界面。

重大更新内容

Spectrum CSS的上下文帮助组件(@spectrum-css/contextualhelp)迎来了5.0.0版本的重大更新。这次更新主要实现了Spectrum 1(S1)和Spectrum 2(S2)设计之间的桥梁，被称为"Spectrum 2 Foundations"。

设计系统兼容性

这个版本并不是一个完整的S2组件迁移，而是提供了一种灵活的方式，让开发者可以在S1、Express和S2设计风格之间切换。通过引入"系统"层，将组件级别的token重新映射到适当的token数据集。

要使用S2样式，开发者需要搭配使用16.0.0或更高版本的@spectrum-css/tokens。如果希望保持S1或Express风格，则需要使用14.x或15.x版本的@spectrum-css/tokens。

文件结构调整

1. 移除了包含mods.md和metadata.json的metadata文件夹，相关信息现在可以在每个组件dist目录下的metadata.json中找到。
2. 移除了已废弃的index-vars.css文件，建议使用index.css或index-base.css替代。

文件使用建议

• 如果只需要S2 Foundations样式，可以使用index.css文件，它包含所有基础样式和S2 Foundations的系统映射。
• 如果只需要S1或Express组件样式，可以使用index-base.css加上相应的themes/(spectrum|express).css文件。
• 如果需要构建可以在S2 Foundations、S1和Express上下文之间切换的组件，可以加载index-base.css和index-theme.css文件，并使用适当的上下文类(.spectrum--legacy表示S1，.spectrum--express表示Express)。

依赖更新

这次更新还涉及多个依赖组件的版本升级：

• @spectrum-css/tokens升级到16.0.0
• @spectrum-css/actionbutton升级到7.0.0
• @spectrum-css/popover升级到8.0.0
• @spectrum-css/link升级到7.0.0

技术意义

这次更新为开发者提供了更大的灵活性，使他们能够更容易地在不同设计系统版本之间切换。同时，通过移除废弃文件和简化文件结构，提高了项目的可维护性。这种渐进式的迁移策略也使得从S1到S2的过渡更加平滑，降低了开发者的迁移成本。

对于正在使用Spectrum Web Components 1.x的开发者来说，这个版本提供了与现有代码库兼容的S2设计基础，为未来的全面迁移做好了准备。