RichTextKit 1.2版本发布：原生类型支持与排版能力升级

RichTextKit是一个专注于富文本编辑的Swift框架，它为开发者提供了丰富的富文本处理功能。在最新发布的1.2版本中，该项目迈出了重要一步：开始减少库特定的自定义类型，转而支持原生类型系统。这一改变使得开发者能够使用更少的代码实现更多的功能，同时保持与苹果原生框架更好的兼容性。

核心改进：原生类型支持

1.2版本的核心改进是引入了对NSParagraphStyle及其嵌套类型的全面支持。这意味着开发者现在可以通过统一的API来获取、设置、选择和调整以下段落样式属性：

• 对齐方式（alignment）
• 截断紧缩（allowsDefaultTighteningForTruncation）
• 基础书写方向（baseWritingDirection）
• 默认制表位间隔（defaultTabInterval）
• 首行缩进（firstLineHeadIndent）
• 段落缩进（headIndent）
• 连字符因子（hyphenationFactor）
• 换行模式（lineBreakMode）
• 换行策略（lineBreakStrategy）
• 行高倍数（lineHeightMultiple）
• 行间距（lineSpacing）
• 最大行高（maximumLineHeight）
• 最小行高（minimumLineHeight）
• 段落间距（paragraphSpacing）
• 段前间距（paragraphSpacingBefore）
• 制表位（tabStops）
• 尾部缩进（tailIndent）
• 默认连字符使用（usesDefaultHyphenation）

这种统一处理方式不仅简化了API设计，还使得开发者能够用更少的代码实现更复杂的排版效果。

新功能亮点

1. 段落样式构建器

新增了defaultMutable构建器，可以快速创建默认的可变段落样式对象：

let style = NSMutableParagraphStyle.defaultMutable

2. 默认值与步进设置

新增了defaultPickerValues(for:)和defaultStepperSteps(for:)方法，为不同类型的段落属性提供了合理的默认选择范围和步进值：

let alignments = NSParagraphStyle.defaultPickerValues(for: \.alignment)
let steps = NSParagraphStyle.defaultStepperSteps(for: \.lineSpacing)

3. 图标支持

为各种段落属性添加了默认图标支持，方便在UI中直观展示：

let alignmentIcon = NSTextAlignment.left.defaultIcon
let indentIcon = NSParagraphStyle.KeyPath.headIndent.defaultIcon

4. 上下文绑定

RichTextContext新增了段落样式值的获取和绑定方法：

let value = context.paragraphStyleValue(for: \.lineSpacing)
let binding = context.paragraphStyleValueBinding(for: \.lineSpacing)

5. 视图组件扩展

RichTextViewComponent新增了基于KeyPath的段落样式操作方法：

// 获取值
let spacing = component.richTextParagraphStyleValue(\.lineSpacing)

// 设置值
component.setRichTextParagraphStyleValue(\.lineSpacing, 10.0)

// 步进调整
component.stepRichTextParagraphStyleValue(\.lineSpacing, 1.0)

视图组件更新

选择器（Picker）

新增了基于段落样式值的初始化方法：

RichTextParagraphStylePicker(
    keyPath: \.alignment,
    values: [.left, .center, .right]
)

步进器（Stepper）

新增了段落样式值的步进控制：

RichTextParagraphStyleStepper(
    keyPath: \.lineSpacing,
    step: 1.0,
    minValue: 0,
    maxValue: 100
)

开关（Toggle）

新增了段落样式布尔值的开关控制：

RichTextParagraphStyleToggle(
    keyPath: \.allowsDefaultTighteningForTruncation
)

废弃说明

随着新段落样式系统的引入，以下自定义类型已被标记为废弃：

• RichTextAlignment及其相关类型
• RichTextLine及其相关类型

开发者应逐步迁移到新的基于NSParagraphStyle的API，这些原生类型不仅功能更强大，而且与苹果生态系统有更好的兼容性。

升级建议

对于现有项目，建议开发者：

1. 检查项目中是否使用了废弃的类型
2. 逐步替换为新的段落样式API
3. 利用新的统一API简化现有代码
4. 探索新版本带来的排版可能性

1.2版本的这些改进使得RichTextKit在保持易用性的同时，提供了更强大的排版能力和更好的系统集成，为开发者构建复杂的富文本编辑器提供了更坚实的基础。