junny_widget 0.4.5

junny_widget: ^0.4.5 copied to clipboard

• 🐛 按钮尺寸一致性修复 • PrimaryButton 默认内边距调整为 12x8，与 ThemeButton 对齐 • 为 PrimaryButton/ThemeButton 添加默认最小高度 40，保证默认视觉一致与触达面积
• 📚 文档 • 更新变更日志，说明默认行为调整范围与影响

• ✨ 新增 FoldableActions 动态参数构建通道（menuActionBuilders） • 支持在 builder 内使用 Provider 的 watch/select 精准订阅 • 返回 null 自动隐藏按钮；在组件内部解析，减少不必要重建 • 解析结果为空时不渲染操作区，避免空占位
• ✨ 新增 CheckableListTile.actionParamsBuilders 透传通道 • 将显隐/禁用逻辑内聚到 FoldableActions 子树，避免整行重建 • 与静态参数 actions/menuActions 并存，优先使用 builders
• 🎨 增强 FoldableActions 视觉与布局 • 新增 withTopDivider 和 topDividerPadding，仅在存在菜单项时渲染分隔线 • 保持 foldAt 与“更多”菜单逻辑一致，兼顾可读性与适配性
• 🧰 兼容与文档 • 保留原 menuActions/actions 静态参数；推荐迁移到 builders 以获得更高灵活性 • 完善中文注释与使用示例，给出 Provider 场景最佳实践

• ✨ Tree 交互增强 • 新增 toggleOnTitleTap/toggleOnRowTap（默认关闭），支持标题或整行点击展开/收起 • 统一通过 controller.toggleNode() 切换节点，确保交互一致性 • 在挂载/控制器切换时，确保 childrenKey 的 childrenProvider 生效
• 🐛 修复状态刷新问题 • 展开/折叠/切换后统一 notifyDataChanged，修复状态不同步 • expandAll 在视图未挂载时支持下一帧重试，提升鲁棒性
• ♻️ 兼容性改进 • LabeledRadio 使用 RadioGroup 包装以消除废弃 API 警告 • 完善中文注释与配置说明

• 🐛 修复CheckableListTile展示逻辑问题 • 修复ExpandableInfoTile重复显示标题和副标题的问题 • 新增 _getExpandableData() 方法，过滤掉status字段和前两个字段 • 优化分隔线显示逻辑，避免重复显示分隔线 • 简化代码结构，删除冗余的 _getFilteredData() 方法 • 确保可展开区域和操作区域有正确的分隔线布局 • 提升组件展示的清晰度和用户体验

• 🔧 优化Tree组件遍历方法 • 重构树遍历API，提供完整的深度/广度优先遍历方法集合 • 重命名方法提升语义清晰度：traverseDepthFirst → traverseNodesDepthFirst • 新增 traverseDataDepthFirst 方法，支持直接遍历原始数据结构 • 新增 traverseNodesBreadthFirst 和 traverseDataBreadthFirst 广度优先遍历方法 • 使用队列实现广度优先算法，优先查找浅层节点/数据 • 统一visitor模式API设计，保持方法调用一致性 • 完善文档注释和使用示例，明确不同遍历方式的适用场景 • 提供4个完整的遍历方法：节点/数据 × 深度/广度优先

• 🔄 Tree组件重大架构重构 (破坏性变更) • 完全重写Tree组件核心架构，删除4,000+行冗余代码 • 移除 JunnyTreeNode 包装类，统一使用原生 TreeViewNode<T> • 简化 TreeConverter 数据转换系统，提升转换性能 • 重构 TreeController 控制器，优化API设计 • 新增 TreeConfig 配置类，统一组件配置管理 • 新增 TreeUtils 工具类，提供树形数据操作方法 • 优化异常处理机制，增强组件稳定性 • 简化组件使用方式，减少学习成本 • 提供完整的迁移指南和使用文档 • 注意: 此版本包含破坏性API变更，升级前请参考迁移文档

• ✨ 新增Tree组件完整功能模块 • 添加 JunnyTreeView 核心组件，支持层级数据展示 • 实现 JunnyTreeConverter 数据转换系统，支持视图和数据双重管理 • 添加 JunnyTreeController 控制器，提供展开/折叠/筛选功能 • 集成 two_dimensional_scrollables 依赖，支持二维滚动 • 升级 flutter_lints 到 6.0.0 版本 • 完善组件文档和使用示例 • 支持自定义节点渲染和交互 • 提供灵活的筛选和搜索功能 • 支持动态展开/折叠控制 • 包含完整的类型安全实现 • 遵循Dart编码规范和Flutter最佳实践

• 🎨 优化 JunnySectionHeader 分割线对齐和圆角适配 • 修复分割线与标题底部对齐问题，实现完美的延长线效果 • 新增 dividerStartOffset 参数，支持自定义分割线起始位置 • 智能适配圆角装饰，自动从标题中心开始避免圆角区域露出 • 优先使用用户提供的偏移量，未提供时自动计算最佳位置 • 解决分割线断点问题，保持连续性和视觉一致性

• ✨ 新增 JunnySectionHeader 区块标题组件 • 支持文本或 Widget 标题内容 • 可自定义标题容器装饰（背景、圆角、边框等） • 可自定义右侧延伸线条装饰（支持渐变、边框、阴影等） • 支持左中右三种标题位置 • 使用 Stack 布局避免圆角标题与线条的断联问题 • 默认使用主题色，保持视觉统一

• ✨ 优化 CheckableListTile 组件状态字段处理机制 • 支持状态字段通过 content 属性传递内容 • 状态字段固定显示在标题右侧，不在展开区域重复显示 • 标题、副标题和状态字段支持 Widget 类型直接显示 • 优化字段过滤逻辑，正确处理 isStatus 标识 • 完善文档注释，修正参数说明

• ✨ 优化 CheckableListTile 组件布局和交互体验 • 修复副标题和可折叠信息部分的 value 对齐问题 • 调整内容边距从 5px 增加到 12px，提升视觉效果 • 重构布局代码，创建统一的 _buildInfoRow 方法 • 统一标签和值的 flex 比例（2:5）和间距（8px）

• ✨ 增强 ExpandableInfoTile 组件功能 • 新增布局参数：labelFlex、valueFlex、spacing • 支持自定义标签和值的比例及间距 • 提高组件的灵活性和可配置性

• ✨ 扩展 FoldableActions 组件功能 • 新增 menuItemSpacing 参数控制下拉菜单按钮间距 • 新增 mainAxisAlignment 参数控制没有 anchor 时的对齐位置 • 优化 Row 和 Wrap 布局的对齐方式 • 增强组件在不同布局场景下的适应性

• 🎨 优化 ThemeButton 组件视觉效果 • 调整默认内边距为 12x8 像素 • 增加默认圆角半径到 8 像素 • 添加默认背景色和边框样式

• 🐛 修复依赖版本约束问题 • 为 collection、deep_pick、intl、provider 添加具体版本约束 • 解决 pub.dev 发布时的版本约束警告

• 🔧 添加 flutter_test 开发依赖

• 修复 LoadingUtils 在特定情况下无法正常关闭的问题

• 优化 CheckableListTile 组件，增加 checkable 属性控制复选框显示，增加 onLongPress 属性控制长按事件

• 优化 AddressPicker 组件，提升滚动体验

• 优化 LoadingUtils 组件，新增 builder 参数默认实现

• 修复 ScreenAdaptation 组件在特定情况下出现的 constraints 问题

• 新增 DeveloperModeListener 组件，支持开发者模式监听
• 移除 MultiClickGesture 组件，替换为上述组件

• 优化 WheelPicker 组件，提升滚动体验和性能
• 新增 MonthPicker、QuarterPicker、YearPicker 组件
• 更新全局配置参数
• 优化时间选择器相关组件

• 优化 loading 工具类，新增事件监听、优先级队列和超时自动关闭等特性
• 优化工具类实现，替换掉 Map 参数传入方式为 config 方式

• 优化 CheckableListTile 组件，支持自定义卡片形状

• 修正 FoldableActions 组件内的对齐方式

• 隐藏 'typeOf' 方法，避免与其他库冲突

• 移除 joinElement 方法，避免和 utils 冲突

• 添加 JunnyWidgetExtension 扩展函数，方便快速创建 PageRoute 对象

• 优化 CheckableListTile 和 FoldableActions 组件，调整组件参数

• 优化 FoldableActions 组件，移除 actions 参数，改为 menuActions 参数

• 修复 ExpandableWidget 组件未生效的 Align 问题

• 优化 CheckableListTile 组件
  • 调整actions参数的传入方式

• 移除 FoldableActions 的 actions 必填控制，为后续迁移到 menuActions 参数做准备

• 优化 MenuItemButtonParams 的实现，使传入方式更加合理

完善 ExpandableWidget

• 新增 headerBuilder 参数，支持更详细的自定义头部

完善 CheckableListTile

• 新增 icon 参数，支持更详细的自定义图标
• 新增对 data 参数中 status 的判断逻辑

• 新增 CheckableListTile 组件，支持自定义选中状态管理、点击和长按操作、可扩展信息展示区域、可折叠操作按钮区域等功能
• 新增 ExpandableInfoTile 组件，支持标准化内容数据、自定义标题和内容样式

• 修复[showCommonListSheet]中数据勾选时出现的问题

• 修复地址选择器组件逻辑问题，优化工具类方法

• 为TimePickerMode添加时间格式扩展方法

• 调整date_time_picker.dart参数
• 添加date_time_range_picker.dart
• 添加sliding_transition.dart

• 优化 dialog_utils.dart
• 优化 foldable_actions.dart

dialog_utils 添加部分公用方法

添加组件

• arrow_foldable_actions.dart
• more_foldable_actions.dart
• pop_up_menus.dart

添加功能

• dialog_utils.dart
• loading_utils.dart
• toast_utils.dart

• 添加了tap_listener.dart

• 部分配置项调整.

• initial release.