Style Dictionary 4.0 版本中名称转换器的变更解析

在 Style Dictionary 4.0 版本中，名称转换器（Name Transform）的命名规范发生了重要变化。这个变更主要影响了那些使用内置名称转换器的开发者，特别是那些在配置文件中使用了name/cti/kebab这类转换器的用户。

变更内容

在 Style Dictionary 4.0 之前，内置的名称转换器采用了name/cti/[format]的命名模式，其中cti代表"Category/Type/Item"的缩写。这种命名方式在4.0版本中进行了简化，移除了中间的cti部分，直接使用name/[format]的形式。

具体变化如下：

• 旧版：name/cti/kebab
• 新版：name/kebab

类似的转换器命名也都遵循这个简化原则，例如：

• name/cti/camel → name/camel
• name/cti/snake → name/snake
• name/cti/constant → name/constant

影响范围

这个变更会影响所有在 Style Dictionary 配置文件中使用了旧版命名方式的开发者。当系统尝试加载name/cti/kebab这样的转换器时，会抛出"Unknown transform"错误，因为新版中这个转换器名称已经不存在了。

解决方案

开发者需要检查所有 Style Dictionary 配置文件，将所有使用了name/cti/[format]格式的转换器更新为name/[format]格式。例如：

{
  "transform": {
    "name": "name/kebab"  // 而不是 "name/cti/kebab"
  }
}

升级建议

1. 全面检查项目中的所有 Style Dictionary 配置文件
2. 更新所有名称转换器的引用
3. 测试构建过程确保所有转换器都能正常工作
4. 更新相关文档和团队知识库

这个变更虽然简单，但对于大型项目或多团队协作的项目来说，确保所有配置文件都同步更新非常重要。Style Dictionary 团队做出这个变更是为了简化API并提高一致性，从长远来看会使配置更加清晰易懂。