Skip to content
CAI
Software that uses CAICheck a score

Tencent/tdesign-flutter

49.9

Weak · 5 November 2026

95.4k

lines of production code

Dart

primary language

4

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Action Sheet now supports paginated and horizontal-scrolling grid layouts

The Action Sheet component has been updated to support three grid layout modes: fixed, paginated, and horizontal-scrolling. Users can now display action items in a paginated grid with page indicators, or in a horizontally scrolling grid with optional section titles. The component also introduces a new theme extension for customizing grid item heights, icon sizes, and panel radius, while maintaining existing list and cancel button behaviors.

_tdesign-component/lib/src/components/action\sheet · high confidence

Added HarmonyOS example app scaffolding

The example application now includes a complete project structure for building on HarmonyOS, featuring necessary configuration files (build-profile, hvigor, package manifests), signing configurations, and a setup guide for the required development environment.

tdesign-component/example/ohos · high confidence

Initial HarmonyOS (OpenHarmony) example app entry structure

The entry module for the HarmonyOS example app is now established, providing the foundational structure to run the TDesign Flutter example on OpenHarmony devices. This includes the EntryAbility to initialize the Flutter engine and register plugins, the main Index page to host the Flutter view, and the necessary module configuration (module.json5) to define the application entry point and request internet permissions. Additionally, a test module (entry\_test) is included with a TestAbility and Hypium-based test runner to support automated testing of the application on the platform.

tdesign-component/example/ohos/entry · high confidence

Initial release of the TDesign Flutter component library

The \tdesign\_flutter.dart\ library is introduced, providing a comprehensive set of UI components for Flutter applications. This release exports a wide range of widgets including ActionSheet, Avatar, BackTop, Badge, Button, Calendar, Cascader, Cell, Checkbox, Collapse, DateTimePicker, Dialog, Divider, Drawer, DropdownMenu, Empty, FAB, Footer, Form, Icon, Image, ImageViewer, Indexes, Input, Link, Loading, Message, NavBar, NoticeBar, Picker, Popover, Popup, Progress, Radio, Rate, PullDownRefresh, Result, SearchBar, Sidebar, Skeleton, Slider, Stepper, Steps, SwipeCell, Swiper, Switch, TabBar, Table, Tabs, Tag, Text, Textarea, TimeCounter, and Toast, along with their respective theme data and type definitions.

tdesign-component/lib · high confidence

Introduce TCascader component with themeable step/tab navigation

The TCascader component is now available, providing a cascading selection interface that supports two display modes: step (vertical) and tab (horizontal). The component is fully themeable via TCascaderThemeData, allowing customization of height, background color, border radius, text styles for normal/active/disabled states, indicator color, navigation padding, and divider color. It uses a controlled value pattern where the caller manages the selected path and receives change callbacks, with automatic level advancement based on the selected options.

tdesign-component/lib/src/components/cascader · high confidence

Introduce TDesign Tabs component with multiple visual variants

The tabs component location now provides a new TDesign-styled tab bar implementation (\TTabsBar\) that supports three visual variants: line (default), tag (capsule), and card. Users can control the text size via a \size\ property (small or large) and customize appearance through a dedicated theme extension (\TTabsBarThemeData\) for colors, padding, and indicators. The component includes a new \TTab\ widget that supports text, icons, or custom children, and adds an \enabled\ property to disable specific tabs. A corresponding \TTabsBarView\ is provided to display synchronized content.

tdesign-component/lib/src/components/tabs · high confidence

Introduce TFab floating action button with drag, magnet, and theme support

The TFab component is now available, providing a floating action button that can be fixed or dragged within a Stack. It supports configurable drag axes (horizontal, vertical, or all), edge magnet snapping with customizable animation duration, and boundary constraints. The button automatically renders as a circle for icons-only or a rounded capsule when text is present, using a default large, filled, primary style. Positioning defaults to 16px from the right and 32px from the bottom, respecting safe areas by default. Theme customization is handled via TFabThemeData, allowing overrides for default offsets, bounds, drag thresholds, and magnet duration.

tdesign-component/lib/src/components/fab · high confidence

Introduce TImageViewer component for fullscreen image preview

Added the TImageViewer component, enabling users to display a fullscreen, swipeable image preview with support for zooming and drag-to-dismiss interactions. The component allows configuration of initial index, looping, autoplay, and custom builders for navigation bar leading/trailing areas, while exposing a dedicated theme extension (TImageViewerThemeData) to customize background colors, icon colors, text styles, and viewer dimensions.

_tdesign-component/lib/src/components/image\viewer · high confidence

Introduce TIndexes component with safe area support and theme customization

The TIndexes component is now available, providing an indexable list view with sticky anchors and a side bar for selection. It includes a new TIndexesThemeData class allowing customization of colors, fonts, and spacing for indices, anchors, and tips. A key feature is the useSafeArea option, which allows the component to respect system safe areas, and the ability to customize the anchor and index builders for flexible UI design.

tdesign-component/lib/src/components/indexes · high confidence

The TLink widget is now available, providing a link component that supports configurable sizes (small, medium, large) and color presets (primary, default, danger, warning, success). It features a new theme system via TLinkThemeData, allowing customization of text styles, icon sizes, and icon gaps through the global theme. The component handles interaction states (hover, focus, press) to dynamically resolve colors and includes support for prefix/suffix icons, underlines, tooltips, and semantic accessibility labels.

tdesign-component/lib/src/components/link · high confidence

Introduce TMessage component with command-line API and theme support

Adds the TMessage notification component, providing a command-line API via \TMessage.show()\ that returns a handle for programmatic dismissal and status checking. The component supports configurable display duration, icons, action widgets, and a marquee mode for long text. It includes a dedicated \TMessageThemeData\ extension allowing customization of background color, shape, and elevation, and exposes semantic status types (info, success, warning, error) to guide visual presentation.

tdesign-component/lib/src/components/message · high confidence

Introduce TNoticeBar component with themeable status and marquee support

Added the TNoticeBar component, which supports horizontal marquee scrolling and vertical item rotation. The component exposes a TNoticeBarThemeData extension allowing customization of height, background color, text style, icon colors, and padding. It distinguishes between four business statuses (info, success, warning, error) that drive default color schemes and prefix icons, while also supporting custom prefix, operation, and suffix icon widgets with a unified tap target callback.

_tdesign-component/lib/src/components/notice\bar · high confidence

Introduce TPullDownRefresh component with external controller and timeout support

A new TPullDownRefresh widget is added to the refresh component library, providing a pull-down-to-refresh capability that supports both pull-down refresh and bottom-load-more callbacks. The component introduces an external TPullDownRefreshController, allowing pages to programmatically trigger refreshes, and includes a configurable refreshTimeout (defaulting to 3 seconds) to automatically abort hanging refresh operations. It also exposes a TPullDownRefreshState enum for detailed state tracking (inactive, dragging, ready, refreshing, done, timeout) and allows customization of the four-stage prompt texts via TPullDownRefreshTexts.

tdesign-component/lib/src/components/refresh · high confidence

Introduce TResult component with themeable status and styling

Added the TResult widget, a new component for displaying result states (info, success, warning, error) with corresponding icons and text. The component supports customization of title and description styles, as well as icon size, via a new TResultThemeData extension, allowing developers to align the result display with the application's global theme.

tdesign-component/lib/src/components/result · high confidence

Introduce TTimeCounter component with customizable timing and theming

Added the TTimeCounter widget, a new component for displaying countdown or count-up timers. It supports configurable time formats (days, hours, minutes, seconds, milliseconds), directional timing (up or down), and programmatic control via a TTimeCounterController (start, pause, reset). The component offers four visual variants (plain, highlight, round, square) and three sizes (small, medium, large), with styling fully integrated into the global TDesign theme system via TTimeCounterThemeData for consistent customization.

_tdesign-component/lib/src/components/time\counter · high confidence

Introduce TTreeSelect component with customizable theme and column widths

A new TTreeSelect widget is added to the tree component library, enabling users to select nodes from a hierarchical tree structure. The component supports single and multi-selection modes, controlled value paths, and customizable column widths (root, intermediate, and leaf) to align with design specifications. It includes a dedicated TTreeSelectThemeData extension for styling panel height, item height, background colors, text styles, and indicator colors, allowing for consistent theming across the application.

tdesign-component/lib/src/components/tree · high confidence

Introduce css2token package for converting TDesign CSS to Flutter theme tokens

Added the \css2token\ package, a pure Dart library that converts TDesign CSS variable declarations into JSON-serializable Flutter theme token overrides. The library supports separate light and dark mode CSS inputs, handles semantic color references, font stacks, radii, shadows, and global sizes, and outputs sparse token maps that can be merged into existing Flutter themes without requiring Flutter or DOM dependencies at runtime.

packages/css2token · high confidence

Introduce new TCheckbox and TCheckboxGroup components with card mode and theme support

The checkbox component location now provides a new implementation of the checkbox UI, including the TCheckbox widget, a data-driven TCheckboxGroup, and a TCheckboxThemeData for styling. Users can now use a card mode for checkboxes, which displays them in a card-like container with a selection mark. The new components support various sizes (small, medium, large), custom icons, and multiple lines of text. The TCheckboxThemeData allows for customization of colors, spacing, and other visual properties. The TCheckboxGroup provides a convenient way to manage a list of checkbox options, with support for vertical and horizontal layouts, and a maximum selection limit. Also in this area: Components now grow with text size and ensure vertical centering.

tdesign-component/lib/src/components/checkbox · high confidence

Introduce new TSideBar component with themeable variants and badge support

Adds a new controlled sidebar navigation component (TSideBar) that supports two visual variants: a line indicator style and a rounded tag style. The component allows configuration of width, height, and loading states, and integrates with TBadgeConfig to display badges on items. It includes a dedicated TSideBarThemeData extension for customizing text styles, background colors, and content padding, ensuring consistent theming across the sidebar and its items.

tdesign-component/lib/src/components/sidebar · high confidence

Introduces standardized global design tokens and theme infrastructure

The theme layer now provides a comprehensive, standardized system for managing visual design tokens. This includes a new \TThemeData\ model that exposes global tokens for colors (brand, error, warning, success, gray scales), typography (font sizes, line heights, weights, and families with platform-specific resolution), spacing, border radii, and shadows. A new \TResourceManager\ allows for centralized, context-aware internationalization of component strings (e.g., upload states, dialog buttons, calendar labels). The system also introduces a \TStyleResolver\ and \TThemeBuilder\ to map these tokens into Flutter's native \ThemeData\, supporting both light and dark modes via a unified token source.

tdesign-component/lib/src/theme · high confidence

Introduction of TBackTop component with customizable shapes and theme support

The TBackTop component is now available, providing a floating action button to scroll to the top of the page. It supports two visual shapes: a standard 48x48 circle and a half-circle variant anchored to the screen's right edge. Users can configure visibility based on scroll offset via the \visibilityOffset\ property, toggle text labels with \showText\, and apply light or dark color presets using \colorPreset\. The component integrates with the global theme system through \TBackTopThemeData\, allowing customization of background, border, and content colors, as well as dimensions like icon size and border width, ensuring consistent styling across the application.

tdesign-component/lib/src/components/backtop · high confidence

Introduction of TCell and TCellGroup components with global token theming

This change introduces the TCell and TCellGroup components for the Flutter UI library. TCell provides a structured layout for list items with support for titles, subtitles, notes, images, and trailing widgets, while TCellGroup allows grouping cells with optional dividers, card styling, and scrollable lists. The components are fully integrated with the new global design tokens, using them for typography, colors, and spacing, and expose a TCellThemeData extension for customizing styles like title/subtitle/note fonts, border colors, and padding.

tdesign-component/lib/src/components/cell · high confidence

Introduction of TIcon component with TDesign-specific theming

A new TIcon widget has been added to the icon component library, serving as a thin wrapper around Material's Icon but enforcing TDesign's visual standards. It defaults to a 24dp size and derives its color from the TDesign global token (textColorPrimary) rather than the surrounding Material IconTheme, ensuring consistent styling across the design system. The component supports explicit size and color overrides, accessibility labels, and dynamic icon lookup via name using the tdesign\_flutter\_icons package.

tdesign-component/lib/src/components/icon · high confidence

Introduction of TSearchBar component with theme-driven styling

A new TSearchBar widget has been added to the component library, providing a customizable search input field. The component supports standard text input behaviors including controllers, initial values, change/submit callbacks, and focus management. It features a clearable state, action text on the right side, and configurable variants (defaulting to square). Styling is driven by a new TSearchBarThemeData extension, allowing customization of height, input background color, content padding, text styles (input, hint, action), icon themes (search and clear), and action gap. The component integrates with the global theme tokens for colors and typography.

tdesign-component/lib/src/components/search · high confidence

Introduction of the TInput component with dedicated theming and status support

This change introduces the new \TInput\ widget, providing a configurable text input field with support for prefixes, suffixes, clear buttons, and password visibility toggles. It includes a new \TInputThemeData\ class that allows component-level customization of borders, padding, colors, and hint styles, ensuring inputs are isolated from global decoration themes. The component also defines \TInputStatus\ (normal, success, warning, error) to visually indicate semantic states and \TInputClearButtonMode\ to control when the clear button appears, offering users precise control over input behavior and appearance.

tdesign-component/lib/src/components/input · high confidence

Introduction of the TStepper component with themeable variants and sizes

The TStepper component is now available, allowing users to increment or decrement numeric values via buttons or direct input. It supports three sizes (small, medium, large) and three visual variants (normal, filled, outline), with styling fully customizable through the TStepperThemeData extension. The component handles controlled value updates, respects min/max/step constraints, and integrates with the global TDesign token system for consistent theming.

tdesign-component/lib/src/components/stepper · high confidence

New API documentation generation tooling and scripts

This change introduces a new API documentation generation tool within the \tdesign-component/demo\_tool\ directory. It adds a \version\ file specifying Dart SDK 3.16.9, a shell script \all\_build.sh\ that acts as a compatibility entry point to the Node.js-based \generate\_api.mjs\ script, and a \README.md\ detailing the configuration in \components.json\, component annotation requirements, and usage commands for generating API docs and example code. This provides a standardized way to generate and maintain API documentation and demo code for the component library.

_tdesign-component/demo\tool · high confidence

New Swipe Cell component with action customization and theme support

The Swipe Cell component is now available, allowing users to swipe to reveal action panels on either side. It supports programmatic control via a controller, automatic panel closing on scroll, and customizable action items with icons, labels, and background colors. The component also includes a dedicated theme extension for shared action padding and respects text direction for proper layout.

_tdesign-component/lib/src/components/swipe\cell · high confidence

New TDateTimePicker component with flexible date/time modes and wheel interaction

The \t\_date\_time\_picker\ directory now contains a new \TDateTimePicker\ widget that replaces the previous implementation. Users can configure the picker's column structure using \DateTimePickerMode\ (combining \DateMode\ like year/month/day/monthDay and \TimeMode\ like hour/minute/second) to show only the desired date or time fields. The component supports configurable \start\ and \end\ ranges, step values for each column, and a \showWeek\ option to append weekday labels to the day column. It features a custom wheel interaction that updates options locally without full rebuilds, handles controlled value synchronization, and provides an \onChanged\ callback for real-time selection updates.

_tdesign-component/lib/src/components/date\_time\picker · high confidence

New TImage component with shape and theme customization

The \t\_image.dart\ and \t\_image\_theme\_data.dart\ files introduce a new \TImage\ widget for displaying images from network URLs, assets, or local files. Users can now control the image shape (square, rounded square, or circle) via the \TImageShape\ enum and customize visual properties like color overlay, blend mode, and anti-aliasing through the new \TImageThemeData\ theme extension. The component supports standard image behaviors including loading and error state widgets, click callbacks, and semantic labeling.

tdesign-component/lib/src/components/image · high confidence

New TLoading component with multiple indicator styles and global overlay support

The loading component area now introduces a comprehensive TLoading widget that supports three preset indicator styles (circle, point bounce, and iOS-style activity indicator) alongside custom icons and accompanying text. The component allows configuration of size, icon color, text color, layout axis, and animation duration, with defaults drawn from the global theme tokens. A TLoadingController is also provided to programmatically show or dismiss a global loading overlay via the widget tree's Overlay, ensuring a consistent loading experience across the application.

tdesign-component/lib/src/components/loading · high confidence

New TNavBar component with themeable styling and border support

The TNavBar component has been introduced as a new widget, replacing previous implementations. It provides a customizable navigation bar with support for leading and action items, a title, and optional below-title content. The component now supports a dedicated theme extension (TNavBarThemeData) allowing users to customize title color, back icon color, background color, padding, opacity, and box shadows. A new border configuration (TNavBarBorder) is available when useBorderStyle is enabled, allowing control over border width, radius, color, and padding. The component also respects safe area insets and provides a default back button behavior that can be overridden.

tdesign-component/lib/src/components/navbar · high confidence

New TSwiper component with unified state and pagination theming

The \tdesign-component\ library introduces a new \TSwiper\ widget (along with \TSwiperController\, \TSwiperThemeData\, and related types) to replace the previous implementation. This new component provides a unified API for controlling carousel state via \TSwiperController\ (supporting \jumpTo\, \animateTo\, \next\, \previous\) and offers extensive theming for pagination indicators (dots, bars, fractions, controls) through \TSwiperThemeData\. It supports features like looping, autoplay, custom page effects (card margin, scale, scale-and-fade), and flexible pagination placement (overlay or outside).

tdesign-component/lib/src/components/swiper · high confidence

New TTable component with row selection, sorting, and theming

A new TTable widget is introduced, providing a data grid with support for row selection (single/multiple modes), column sorting, and fixed columns. The component exposes a comprehensive API for customization, including cell spanning, row/cell tap callbacks, and visual theming via TTableThemeData (controlling row height, header height, colors, and padding). It integrates with the global token system for consistent styling and supports controlled state for both selection and sorting.

tdesign-component/lib/src/components/table · high confidence

New utility extensions and platform-aware helpers

The \tdesign-component/lib/src/util\ directory now includes a suite of new utility extensions and helpers to support component development. This adds screen-width scaling extensions (\auto\_size.dart\) for responsive layout calculations, context extensions (\context\_extension.dart\) for easier theme resource access, and various collection extensions (\iterable\_ext.dart\, \list\_ext.dart\, \map\_ext.dart\) providing safer data manipulation methods like \firstWhereOrNull\, \chunk\, \groupBy\, and typed value extraction from maps. It also introduces \PlatformUtil\ for detecting specific platforms including HarmonyOS (\isOhos\), \VersionUtil\ for Dart version checking, \Throttle\ for rate-limiting callbacks, and \TToolbarPressable\ for consistent toolbar interaction feedback. Additionally, \string\_util.dart\ was updated to safely handle 3-digit hex colors and transparent values, returning null on invalid input instead of throwing. Also in this area: TDesign Flutter 1.0 release with breaking migration guide and demo updates.

tdesign-component/lib/src/util · high confidence

Repository initialization and contributor onboarding documentation

The repository has been initialized with essential contributor documentation, including \CONTRIBUTING.md\ (defining development, PR, and changelog standards), \AGENTS.md\ (AI assistant collaboration guidelines), \PUBLISH.md\ (release workflow), and \CODE\_OF\_CONDUCT.md\. The \README.md\ has been expanded to include detailed installation instructions, theme configuration examples (JSON and Theme Generator), dark mode support, and internationalization setup. Additionally, CI/CD configuration via \.cnb.yml\ and Flutter version management via \.fvmrc\ have been added to support the development environment.

(repo-wide) · high confidence

Removals

Removal of Android and iOS native plugin implementations

The native platform-specific code for the Flutter component plugin has been removed. This includes the Android Kotlin implementation (FlutterComponentPlugin.kt), the Android manifest, and the iOS Objective-C implementation (FlutterComponentPlugin.h/m), along with their respective configuration and ignore files. Users relying on this specific native bridge for platform version detection or other native interactions will no longer have this functionality available in this package.

android, ios · high confidence

Removal of TDEmpty component

The TDEmpty widget, previously used to display empty states with optional images, text, and operation buttons, has been removed from the library. This deletion eliminates the component's layout logic and styling, meaning users can no longer import or utilize TDEmpty for presenting empty content scenarios.

lib/src/components/empty · high confidence

Removal of TDRadio component

The \TDRadio\ widget, which previously provided a selectable radio button with circle, square, or check styles, has been removed from the codebase. This deletion eliminates the component's ability to toggle selection states and notify listeners via \onCheckValueChanged\.

lib/src/components/radio · high confidence

Removal of TDTag component

The TDTag widget, which previously rendered styled labels with configurable types (such as NORMAL, SUCCESS, WARNING, ERROR, MESSAGE, WIREFRAME, and LIGHT\_BACKGROUND), sizes (LARGE, MIDDLE, SMALL, CUSTOM), and visual properties (border radius, padding, colors, and font weights), has been removed from the codebase.

lib/src/components/tags · high confidence

Removal of legacy Avatar component implementation

The \TDAvatar\ widget and its associated enums (\TDAvatarSize\, \TDAvatarType\) have been removed from the codebase. This deletion eliminates the previous implementation that handled avatar rendering via specific size presets (Large, Medium, Small) and types (Default, User, Circle, Square, CustomText), effectively stripping this component from the library's public API.

lib/src/components/avatar · high confidence

Removal of legacy ImageWidget and TDImage components

The \lib/src/components/image\ directory has removed the legacy \ImageWidget\ and \TDImage\ components. This deletion eliminates the custom image loading logic that previously handled network requests, loading states, and error fallbacks via a dedicated stateful widget, as well as the \TDImage\ wrapper that provided predefined sizes (XS through XL) and shape types (clip, fitHeight, stretch, square, roundedSquare, circle). Users relying on these specific components will need to migrate to the current image implementation.

lib/src/components/image · high confidence

Removal of legacy Picker components and supporting files

The legacy picker implementation files have been removed from the codebase. This includes the \TDPicker\ static facade, the \TDDatePicker\ and \TDMultiPicker\ widget classes, the \TDItemWidget\ for rendering picker items, and the \NoWaveBehavior\ scroll behavior helper. Users relying on these specific classes for date selection, multi-column selection, or linked multi-column selection will no longer have access to these components in this location.

lib/src/components/picker · high confidence

Removal of legacy TDBadge component

The legacy TDBadge widget (td\_badge.dart) has been removed from the codebase. This component previously provided badge indicators with support for red dots, reminders, and message counts, featuring specific styling for single-digit (circular), two-digit, and three-digit numbers, as well as customizable colors, border radii, and 'New' text labels. Its removal indicates a shift away from this specific implementation, likely in favor of a newer or refactored badge component elsewhere in the library.

lib/src/components/badge · high confidence

Removal of legacy TDButton component

The legacy \TDButton\ widget and its associated enums (size, theme, shape, type) have been removed from the codebase. This deletion indicates that the component is no longer part of the library's public API, likely replaced by a newer implementation or refactored structure elsewhere in the package.

lib/src/components/button · high confidence

Removal of legacy TDSearchBar component

The legacy \TDSearchBar\ widget has been removed from the codebase. This component, which previously provided a search input with placeholder, clear button, and cancel button functionality, is no longer available for use. Users relying on this specific component will need to migrate to the current search implementation.

lib/src/components/search · high confidence

Removal of legacy TDTab and TDTabBar components

The legacy \TDTab\ and \TDTabBar\ components located in \lib/src/components/tabbar\ have been removed from the codebase. This deletion eliminates the custom wrapper classes and their associated state management, indicator painting logic, and theme-dependent styling that previously handled tab bar rendering and label padding.

lib/src/components/tabbar · high confidence

Removal of legacy TDText component

The legacy \TDText\ widget has been removed from the codebase. This component previously provided a styled text wrapper with specific default behaviors (such as \FontWeight.w500\ and automatic font sizing from \TDTheme\) and features like line-through decoration. Its removal indicates a shift towards using standard Flutter \Text\ widgets or a newer, unified text implementation.

lib/src/components/text · high confidence

Removal of legacy TDToast component

The legacy \TDToast\ class and its internal \\_TDTextToast\ widget have been removed from the codebase. This change eliminates the previous implementation that displayed text toasts using a hardcoded font size and specific theme color references, effectively cleaning up deprecated UI code.

lib/src/components/toast · high confidence

Removal of legacy input components

The legacy input components \TDInputView\ and \TDInput\ have been removed from the codebase. This change eliminates the previous implementation of the input field widget, which previously wrapped a standard Flutter \TextField\ with custom styling and layout support for left/right labels and buttons.

lib/src/components/input · high confidence

Removal of the main library export file

The \lib/td\_export.dart\ file, which previously served as the central entry point to re-export all public components (such as buttons, inputs, and tabs) and theme definitions, has been deleted. Users can no longer import this single file to access the library's API; they must now import individual component or theme files directly.

lib · high confidence

Removed legacy example app scaffolding

The legacy Flutter example application (\flutter\_component\_example\) has been completely removed. This includes the main entry point, the custom route generation logic, all individual component demo pages (such as Avatar, Badge, Button, Input, Picker, TabBar, Tag, Theme, Toast, and Image), and the associated widget tests. Users should no longer rely on this specific example project structure for integration or demonstration purposes.

example · high confidence

TDNavBar component removed

The TDNavBar widget and its associated TDNavBarItem class have been deleted from the library. Users can no longer use this custom navigation bar component in their applications.

_lib/src/components/nav\bar · high confidence

Behavioural changes

1 commit (0 fixes) modifying tdesign-site/site/components, tdesign-site/site/data

A change to existing behaviour in tdesign-site/site/components, tdesign-site/site/data — 1 commit, 2 files: “add site”.

tdesign-site/site/components, tdesign-site/site/data · medium confidence · unverified

10 commits (1 fix) modifying tdesign-site/site/flutter-example-docs

A change to existing behaviour in tdesign-site/site/flutter-example-docs — 10 commits (1 fix), 12 files: “docs(site): 补充迁移侧边导航与官方 Demo 体验入口 (\#1167)”; “test(release): 补充迁移主题与 Token 消费验证 (\#1166)”; “refactor(example): 重组全组件 Demo 并映射 Web 文档 (\#1142)”; and 7 more (refs \#1167, \#1166, \#1142, \#1219, \#1204, …).

tdesign-site/site/flutter-example-docs · medium confidence · unverified

17 commits (3 fixes) modifying tdesign-component/lib/src/components/drawer

A change to existing behaviour in tdesign-component/lib/src/components/drawer — 17 commits (3 fixs), 3 files: “breaking(TPopup): 修复 destroyOnClose 的关闭销毁与状态保留 (\#1197)”; “fix(text): 补齐既有文字槽样式并保留原生段落语义 (\#1182)”; “breaking(TDrawer): 收敛为声明式内容组件与 showTDrawer 浮层契约 (\#1080)”; and 14 more (refs \#1197, \#1182, \#1080, \#907, \#1219, …).

tdesign-component/lib/src/components/drawer · medium confidence · unverified

17 commits (4 fixes) modifying tdesign-component/lib/src/components/popover

A change to existing behaviour in tdesign-component/lib/src/components/popover — 17 commits (4 fixs), 4 files: “fix(text): 补齐既有文字槽样式并保留原生段落语义 (\#1182)”; “chore: align example ordering and clean up obsolete V1.0 TODO markers (\#987)”; “fix(TPopover): 对齐四角气泡箭头边距 (\#1129)”; and 14 more (refs \#1182, \#987, \#1129, \#907, \#1143, …).

tdesign-component/lib/src/components/popover · medium confidence · unverified

18 commits (7 fixes) modifying tdesign-component/example/lib/page

A change to existing behaviour in tdesign-component/example/lib/page — 18 commits (7 fixs), 439 files: “breaking(theme): 精简 TThemeData API 并修复主题过渡 (\#1152)”; “fix(ActionSheet): 修复 ActionSheet 安全区并补齐选择器示例 (\#1224)”; “fix(example): 按实际主题键展示功能色板 (\#1206)”; and 15 more (refs \#1152, \#1224, \#1206, \#1160, \#1166, …).

tdesign-component/example/lib/page · medium confidence · unverified

21 commits (3 fixes) modifying tdesign-site/site/plugin-tdoc

A change to existing behaviour in tdesign-site/site/plugin-tdoc — 21 commits (3 fixs), 4 files: “fix(site): 修复主题初始化与文档导航状态恢复 (\#1202)”; “\TDTheme\ : 组件全面适配深色模式,优化调整组件样式 (\#744)”; “feat(code): 更新 prismjs 依赖版本,优化代码高亮 (\#799)”; and 18 more (refs \#1202, \#744, \#799, \#832, \#1166, …).

tdesign-site/site/plugin-tdoc · medium confidence · unverified

3 commits (0 fixes) modifying tdesign-component/example/android

A change to existing behaviour in tdesign-component/example/android — 3 commits, 15 files: “添加证书签名”; “feat: 完善upload组件demo、权限文件和api文档”; “替换文件位置”.

tdesign-component/example/android · medium confidence · unverified

37 commits (3 fixes) modifying tdesign-site/site

A change to existing behaviour in tdesign-site/site — 37 commits (3 fixs), 9 files: “fix(site): 修复主题初始化与文档导航状态恢复 (\#1202)”; “docs(site): 补充迁移侧边导航与官方 Demo 体验入口 (\#1167)”; “添加popover组件菜单”; and 34 more (refs \#1202, \#1167, \#987, \#747, \#1166, …).

tdesign-site/site · medium confidence · unverified

4 commits (0 fixes) modifying tdesign-site/site/scripts

A change to existing behaviour in tdesign-site/site/scripts — 4 commits, 1 file: “docs(site): 补充迁移侧边导航与官方 Demo 体验入口 (\#1167)”; “chore(site): 移除未使用的小程序文档转换链 (\#1185)”; “refactor: consolidate Flutter documentation structure (\#979)”; and 1 more (refs \#1167, \#1185, \#979, \#1210).

tdesign-site/site/scripts · medium confidence · unverified

4 commits (1 fix) modifying tdesign-component/example/lib/annotation

A change to existing behaviour in tdesign-component/example/lib/annotation — 4 commits (1 fix), 1 file: “refactor(example): 重组全组件 Demo 并映射 Web 文档 (\#1142)”; “fix(TStepper): 修复受控交互与主题插值并对齐公开示例 (\#1064)”; “!refactor: migrate v1 implementation (\#967)”; and 1 more (refs \#1142, \#1064, \#967, \#1187).

tdesign-component/example/lib/annotation · medium confidence · unverified

4 commits (2 fixes) modifying tdesign-site/site/utils

A change to existing behaviour in tdesign-site/site/utils — 4 commits (2 fixs), 6 files: “fix(site): 修复主题初始化与文档导航状态恢复 (\#1202)”; “docs(site): 完善可运行接入示例与 Flutter 预览 (\#1204)”; “breaking(theme): 调整组件默认样式并接入全局 Token (\#1174)”; and 1 more (refs \#1202, \#1204, \#1174, \#1132).

tdesign-site/site/utils · medium confidence · unverified

5 commits (1 fix) modifying tdesign-component/example/lib/provider

A change to existing behaviour in tdesign-component/example/lib/provider — 5 commits (1 fix), 2 files: “chore: 更新官网文档 (\#794)”; “shared\_preferences降级,兼容3.16.9版本SDK”; “改造设置页”; and 2 more (refs \#794, \#1132, \#768).

tdesign-component/example/lib/provider · medium confidence · unverified

5 commits (1 fix) modifying tdesign-component/example/lib/util

A change to existing behaviour in tdesign-component/example/lib/util — 5 commits (1 fix), 4 files: “暗色模式联动功能区分平台引入”; “fix(site): 完善 Flutter Demo 主题 Token 控制 (\#1132)”; “!refactor: migrate v1 implementation (\#967)”; and 2 more (refs \#1132, \#967, \#1158, \#1172).

tdesign-component/example/lib/util · medium confidence · unverified

6 commits (0 fixes) modifying tdesign-site/script

A change to existing behaviour in tdesign-site/script — 6 commits, 3 files: “chore: align example ordering and clean up obsolete V1.0 TODO markers (\#987)”; “refactor(example): 重组全组件 Demo 并映射 Web 文档 (\#1142)”; “docs: 更新主题生成器文档,添加视频演示链接 (\#833)”; and 3 more (refs \#987, \#1142, \#833, \#1149, \#853).

tdesign-site/script · medium confidence · unverified

7 commits (1 fix) modifying tdesign-component/example/android/gradle

A change to existing behaviour in tdesign-component/example/android/gradle — 7 commits (1 fix), 1 file: “\TDTheme\ : 组件全面适配深色模式,优化调整组件样式 (\#744)”; “升级gradle”; “修改form”; and 4 more (refs \#744, \#983, \#1002, \#1179).

tdesign-component/example/android/gradle · medium confidence · unverified

8 commits (1 fix) modifying tdesign-component/lib/src/components/collapse

A change to existing behaviour in tdesign-component/lib/src/components/collapse — 8 commits (1 fix), 6 files: “fix(text): 补齐既有文字槽样式并保留原生段落语义 (\#1182)”; “refactor: rename prefix \TD\ to \T\ (\#907)”; “breaking(components): 对齐组件 Demo 与设计规范 (\#1143)”; and 5 more (refs \#1182, \#907, \#1143, \#1157, \#1146, …).

tdesign-component/lib/src/components/collapse · medium confidence · unverified

8 commits (1 fix) modifying tdesign-component/lib/src/components/divider

A change to existing behaviour in tdesign-component/lib/src/components/divider — 8 commits (1 fix), 3 files: “fix(text): 补齐既有文字槽样式并保留原生段落语义 (\#1182)”; “breaking(Divider): 统一默认几何与主题样式契约 (\#1044)”; “refactor: rename prefix \TD\ to \T\ (\#907)”; and 5 more (refs \#1182, \#1044, \#907, \#1101, \#1157, …).

tdesign-component/lib/src/components/divider · medium confidence · unverified

A change to existing behaviour in tdesign-component/lib/src/components/footer — 8 commits (1 fix), 2 files: “breaking(TFooter): consolidate content composition API (\#1088)”; “refactor: rename prefix \TD\ to \T\ (\#907)”; “breaking(components): 对齐组件 Demo 与设计规范 (\#1143)”; and 5 more (refs \#1088, \#907, \#1143, \#1157, \#1113, …).

tdesign-component/lib/src/components/footer · medium confidence · unverified

9 commits (1 fix) modifying scripts

A change to existing behaviour in scripts — 9 commits (1 fix), 5 files: “test(release): 补充迁移主题与 Token 消费验证 (\#1166)”; “docs: 统一迁移指南 (\#1219)”; “docs(site): 完善可运行接入示例与 Flutter 预览 (\#1204)”; and 6 more (refs \#1166, \#1219, \#1204, \#1022, \#887, …).

scripts · medium confidence · unverified

Avatar component redesigned with mobile-aligned API and global theming

The Avatar component has been completely rewritten to align with mobile design standards and integrate with the new global token system. Users can now create avatars using the \TAvatar\ widget, which supports configurable sizes (small, medium, large), shapes (circle, square), and custom content via a \child\ widget. The new \TAvatarGroup\ widget manages layout for multiple avatars, handling overlap spacing, overflow truncation, and cascading order. Visual appearance is controlled through \TAvatarThemeData\, which allows customization of dimensions, colors, border radii, and shadows, all resolving against global theme tokens for consistency.

tdesign-component/lib/src/components/avatar · high confidence

Badge component rewritten with new variants, theming, and layout logic

The Badge component has been completely rewritten to support multiple structural variants (circle, dot, square, bubble, ribbon, and triangle) and sizes (medium, large). It now features a dedicated TBadgeThemeData for sub-tree-level customization of colors, typography, padding, and border radius, while resolving alignment and offset via internal fallback mechanisms to ensure consistent positioning across different contexts.

tdesign-component/lib/src/components/badge · high confidence

Calendar component refactored into a pure, controlled UI with consolidated public API

The Calendar component has been refactored to serve as a pure, controlled UI panel that no longer includes internal popups, toolbars, or confirmation actions. It now exposes a consolidated public API where selection state is managed via a controlled \value\ list and \onChanged\ callback, supporting single, multiple, and range selection modes. The component also provides new customization hooks, including builders for month titles, date cells, and subtitles, along with a dedicated theme data class for styling. Also in this area: TDesign Flutter 1.0 release with breaking migration guide and demo updates; Components now grow with text size and ensure vertical centering.

tdesign-component/lib/src/components/calendar · high confidence

Dialog component restructured with new theming and action styling

The Dialog component has been refactored to support a new theme system and updated action styling. A new \TDialogThemeData\ class allows customization of dialog appearance (background, shape, elevation, text styles, padding, dimensions) via a ThemeExtension. The \TDialogAction\ now uses semantic roles (\normal\, \primary\, \destructive\) to determine default button colors (light fill, brand fill, danger fill respectively) and variants. The \TConfirmDialog\ convenience widget is introduced for single-action confirmations. Action layout logic has been updated: 1-2 text-only actions render as a footer with a separator, while other configurations use a padded action area with specific ordering for primary/destructive actions.

tdesign-component/lib/src/components/dialog · high confidence

The Dropdown Menu component has been replaced with a new v1 implementation that introduces a dedicated \TDropdownThemeData\ for granular visual customization (bar, panel, and option styling) and refines the interaction model. Users will now experience improved animation performance for the overlay and menu transitions, along with corrected layout anchoring and behavior for disabled items in multi-column layouts. The component now exposes a \TDropdownMenuController\ for programmatic open/close/toggle actions and supports custom trigger builders, while maintaining backward compatibility for standard label-based items. Also in this area: Component default styles and theme token integration; Components now grow with text size and ensure vertical centering.

_tdesign-component/lib/src/components/dropdown\menu · high confidence

Empty state component API and theming restructured

The TEmpty component has been migrated to a new implementation that consolidates its content composition API, allowing users to configure the icon, custom image, description text, and operation widgets. Theming is now handled via a dedicated TEmptyThemeData extension, enabling customization of the description text color and font size through the Flutter theme system.

tdesign-component/lib/src/components/empty · high confidence

Example app restructured with new routing, theming, and code-generation tooling

The example application has been reorganized to serve as the central hub for component demos and web documentation. A new routing system (TExampleRoute) normalizes URL paths to match Flutter route names, ensuring kebab-case web links resolve correctly. Theming is now managed via a Provider-based ThemeModeProvider, enabling live light/dark mode switching and system-brightness following, with dedicated test pages for verifying dark mode behavior. Demo code snippets are now structured using @ExampleCode annotations and a manifest-driven generator, allowing source code to be extracted and displayed in the web docs. Additionally, an API documentation viewer (ApiWidget) loads component API details from Markdown assets, and a notification center (TNotification) facilitates cross-widget communication for UI updates like API visibility. Also in this area: TDesign Flutter 1.0 release with breaking migration guide and demo updates.

(repo-wide) · high confidence

Picker component rewritten with strict controlled selection and new scroll-end callback

The Picker component has been completely refactored to function as a strict controlled selection widget, separating the core wheel logic from the popup UI layer. It now supports multi-column independent selection via \TPickerColumns\ and hierarchical linked selection via \TPickerLinked\. A new \onColumnScrollEnd\ callback allows applications to trigger actions (such as on-demand loading) when a column stops scrolling. The visual presentation includes a standardized central highlight bar, gradient fade effects, and improved text centering, while the default popup height is set to 200px with 5 visible items.

tdesign-component/lib/src/components/picker · high confidence

The Popup component has been completely refactored to align with official behavior and standardized theming. It now supports five placement directions (top, bottom, left, right, center) with specific default dimensions (e.g., 240px height for edges, 280px width for drawers, 240x240 for center). A new \useSafeArea\ option allows the popup to respect device notches and safe zones. Theming is now handled via \TPopupThemeData\, allowing global defaults for barrier color, panel radius, background color, and dimensions. The API has changed: overlay behavior is now configured via \TPopupOverlayConfig\ (decoupling \showOverlay\ and \preventTap\), and builders are provided for the bottom header (\headerBuilder\) and center close area (\closeBuilder\). The component uses a new internal route structure (\\_PopupNavigatorRoute\) and a tracker for nested popups. Also in this area: Component default styles and theme token integration; TDesign Flutter 1.0 release with breaking migration guide and demo updates.

tdesign-component/lib/src/components/popup · high confidence

Progress component restructured with new variants, status states, and theme data

The Progress component has been redesigned to support multiple visual forms (linear, plump, circular, microCircular, button, and microButton) and explicit task states (normal, warning, error, success). This change introduces a dedicated TProgressThemeData class, allowing users to customize visual properties such as stroke width, colors, border radius, circle size, and animation durations via the theme system. The component now includes specific constructors for each variant, enabling more granular control over the progress indicator's appearance and behavior, while also supporting semantic labels for accessibility.

tdesign-component/lib/src/components/progress · high confidence

Radio component refactored to use TRadioGroup for state management

The TRadio widget no longer manages its own selection state or change callbacks; it must now be wrapped in a TRadioGroup ancestor, which centralizes the selected value and onChanged logic. This architectural shift enforces a strict parent-child relationship, throwing an error if TRadio is used without a group context. Additionally, the component introduces new visual configuration options including TRadioSize (small, medium, large), TRadioIconType (dot, check, fill), and TRadioVariant (inline, block, card), alongside a dedicated TRadioThemeData for customizing colors and spacing within a theme subtree.

tdesign-component/lib/src/components/radio · high confidence

Rate component migrated to new v1 implementation with standardized theming

The Rate component has been replaced with a new implementation (TRate) that aligns with the updated component contract and standardized global tokens. This change introduces a new TRateThemeData class for component-specific theming (controlling star colors, icon size, gaps, and text styles) and updates the widget API to support controlled value changes with distinct callbacks for interaction start and end, as well as optional half-star selection and value indicators.

tdesign-component/lib/src/components/rate · high confidence

Redesigned Form and Input components with new theming and validation scopes

The form and input components have been rebuilt to align with the new global token system and standardized visual API. This introduces a new \TFieldScope\ and \TFormItemScope\ to manage field states (required, error) and layout context, allowing input components to consume validation errors and adjust padding automatically. The \TForm\ now features a dedicated \TFormController\ and \TFormThemeData\ for granular control over layout (horizontal/vertical), label alignment, and spacing. The \TInput\ component has been updated to support a new \TInputThemeData\ for border, padding, and icon customization, and integrates with the form validation system to display error states within the input field itself.

tdesign-component/lib/src/components/form · high confidence

Redesigned TButton and TTag components with unified theming and new variants

The TButton and TTag components have been completely rewritten to align with TDesign specifications, introducing a new theming system via \ThemeExtension\ and a dedicated style resolver. TButton now supports four variants (fill, outline, text, ghost), four color presets (defaultTheme, primary, danger, light), and four shapes (rectangle, round, square, circle), with a new \TButtonThemeData\ allowing global gradient and icon-text spacing configuration. TTag has been updated with new variants (dark, light, outline, lightOutline), shapes (square, round, mark), and a \TTagThemeData\ for granular control over colors, fonts, padding, and border radius. These changes represent a breaking update to the visual API and structure of these components. Also in this area: Component default styles and theme token integration; TDesign Flutter 1.0 release with breaking migration guide and demo updates.

tdesign-component/lib/src/components/button · high confidence

Removal of custom TDIcon wrapper and icon set

The custom \TDIcon\ wrapper component and the \TDIcons\ icon set (defined in \td\_icon.dart\ and \td\_icons.dart\) have been removed from the library. Users can no longer use \TDIcon\ or the \TDIcons\ static constants; instead, they should use the standard Flutter \Icon\ widget with system or other available icon data directly.

lib/src/components/icon · high confidence

Replaced legacy text component with new TText API and dynamic font loading

The text component location has been completely rewritten to introduce a new \TText\ widget and a dedicated \TFontLoader\ utility. \TText\ replaces the previous implementation, offering a structured style resolution system (\TTextResolve\) that prioritizes instance styles over component theme defaults and global TDesign tokens. The new component supports dynamic font loading from URLs via \TFontLoader\, allowing fonts to be registered before rendering. Additionally, \TTextStyled\ and \TTextStyleScope\ provide internal helpers for composite components to manage text styling and strut behavior, ensuring consistent vertical alignment and typography across the library.

tdesign-component/lib/src/components/text · high confidence

Skeleton component migrated to new T-prefixed API with standardized theme tokens

The Skeleton component has been rewritten to use the new T-prefixed naming convention (e.g., \TSkeleton\, \TSkeletonVariant\, \TSkeletonAnimation\) and integrates with the standardized global Token system. Users now interact with a cleaner API that supports predefined variants (avatar, image, text, paragraph) and custom layouts via \TSkeletonLayout\. Visual customization is handled through \TSkeletonThemeData\, which exposes tokens for block color, highlight color, border radius, and row spacing, ensuring consistent alignment with the design system's visual and animation standards.

tdesign-component/lib/src/components/skeleton · high confidence

Steps component migrated to v1 with unified mode constructors and dot indicator support

The Steps component has been replaced with a new v1 implementation that consolidates progress, selectable, and display behaviors into three named constructors: \TSteps.progress\, \TSteps.selectable\, and \TSteps.display\. This change introduces a \TStepsIndicator.dot\ mode for simplified dot-based progress visualization and enforces vertical layout for the selectable mode. The component now uses a \TStepsItemData\ model for step configuration and delegates rendering to dedicated horizontal and vertical item widgets, ensuring consistent theming via the global token system.

tdesign-component/lib/src/components/steps · high confidence

Sticky header component migrated to a new v1 implementation

The sticky header component in the indexes section has been completely rewritten (migrated to v1) to replace the previous implementation. This change introduces a new internal layout architecture, including a custom \ConstrainedLayoutBuilder\ and dedicated render objects (\RenderSliverStickyHeader\), to manage the pinning and scrolling behavior of headers within slivers. The public API remains consistent via \SliverStickyHeader\ and \SliverStickyHeader.builder\, but the underlying mechanics for calculating scroll percentages and pinning states have been updated, which may affect how the header interacts with its parent scroll view.

_tdesign-component/lib/src/components/indexes/sticky\header · high confidence

TDesign Flutter v1.0.0-alpha.1: Breaking API migration and standardized theming

The tdesign-component package has been updated to version 1.0.0-alpha.1, introducing significant breaking changes. All component prefixes have been renamed from \TD\ to \T\ (e.g., \TDropdownMenu\ is now \TDropdownMenu\), and legacy compatibility parameters have been removed. Theming is now standardized using Flutter's \ThemeData\ and \TDesign ThemeExtension\, supporting application-level tokens, global component themes, and local subtree overrides via \mergeExtension\. Several components have changed their APIs: \TSwiper\ is now driven by \TSwiperController\, \TBadge\ uses a semantic \label\ property, and \Calendar\, \Picker\, \DateTimePicker\, and \Cascader\ have shifted to controlled value patterns or delegated responsibilities (e.g., \Popup\ now uses \TPopupOptions\ and \TPopupHandle\). The package also enforces a minimum Flutter version of 3.32.0 and Dart 3.8.0, and excludes example and documentation assets from the published package via a new \.pubignore\ file.

tdesign-component · high confidence

TSlider and TRangeSlider visual defaults and theme priority fixed

The TSlider and TRangeSlider components now correctly apply default visual styles and respect theme priority, ensuring that component-level theme extensions override global tokens as intended. This change aligns the slider's appearance with the standardized global token system, fixing issues where default visuals might have been inconsistent or incorrectly prioritized over user-defined themes. Also in this area: Components now grow with text size and ensure vertical centering.

tdesign-component/lib/src/components/slider · high confidence

TSwitch component reimplementation with independent loading state and text/icon variants

The TSwitch component has been rewritten to support a new \loading\ state that displays an internal indicator and disables interaction independently of the disabled state, and a new \variant\ property allowing the switch thumb to display text (with customizable \openText\/\closeText\) or icons in addition to the default filled style. The component now uses a dedicated \TSwitchThemeData\ extension for granular styling of track, thumb, and content colors/fonts, and resolves sizes (small/medium/large) with specific dimensions while maintaining native iOS-style behavior via the underlying \TCupertinoSwitch\.

tdesign-component/lib/src/components/switch · high confidence

TTextarea component restructured with new layout and theming support

The TTextarea widget has been updated to support a configurable layout for the relationship between the internal label and the editing area, introducing the TTextareaLayout enum with horizontal and vertical options. The component now integrates with the standardized global Token system and converges its visual API, ensuring consistent theming across the library. Additionally, the widget's implementation has been migrated to the v1 architecture, aligning with the broader refactor that renames the TD prefix to T and refines field validation contracts.

tdesign-component/lib/src/components/textarea · high confidence

TabBar component migrated to new v1 implementation with unified theming

The TabBar component has been replaced with a new implementation that introduces a dedicated \TTabBarThemeData\ for managing visual defaults like bar height, background colors, and divider properties. This change standardizes the component's API and visual contract, aligning it with global design tokens and ensuring consistent behavior for single-level, icon-text, and double-layer menu tabs.

tdesign-component/lib/src/components/tabbar · high confidence

Tag component rewritten with new theming API and added TSelectTag

The Tag component in tdesign-component has been completely rewritten to support a new, granular theming system via TTagThemeData, allowing developers to customize colors (text, background, danger, success), padding per size, font, border radius, and text overflow directly through the Flutter Theme extension. The component now exposes explicit enums for size (TTagSize), shape (TTagShape), color preset (TTagColorPreset), and variant (TTagVariant), replacing previous implicit or less structured styling. Additionally, a new TSelectTag component has been introduced to provide a strictly controlled, selectable tag variant with built-in state management callbacks and semantic accessibility support.

tdesign-component/lib/src/components/tag · high confidence

Theme system refactored with removed legacy files and renamed components

The theme implementation in lib/src/theme has been significantly restructured. Legacy helper files (basic.dart, td\_colors.dart, td\_corners.dart, td\_font\_family.dart, td\_fonts.dart, td\_shadows.dart) and the default theme configuration (td\_default\_theme.dart) have been removed, indicating a consolidation or migration of theme data structures. The main theme widget and data class (td\_theme.dart) remain but are part of this broader cleanup. Commit messages indicate renaming of fontSize theme, TDMargins to TDSpacers, and TDTheme Map fields to prevent ambiguity, suggesting a shift in how theme properties are accessed and named, although the specific new implementations are not fully visible in this diff excerpt.

lib/src/theme · medium confidence

Toast component restructured with unified overlay config and theme data

The Toast component has been refactored to standardize its API and visual configuration. A new \TOverlayConfig\ class now centrally manages overlay behavior, allowing independent control over the visibility of a semi-transparent mask (\showOverlay\) and the prevention of background interaction (\preventScrollThrough\). The component also introduces a \TToastThemeData\ class that exposes granular styling options such as background color, text style, icon size, icon color, border radius, padding, and maximum width, enabling consistent theming across the application. Additionally, the API now supports explicit placement options (top, middle, bottom) and allows for custom widgets to be displayed within the toast.

tdesign-component/lib/src/components/toast · high confidence

Update example app version and add theme configuration assets

The example application's version has been updated to 1.0.0-alpha.5, and a new \publish\_time\ asset has been added to track release timestamps. Additionally, a comprehensive \theme.json\ file has been introduced, defining color tokens and references for both light and dark modes across green and red themes, enabling the app to support dark mode and customizable color schemes.

tdesign-component/example/assets · high confidence

Updated example shell icon assets

The example application's shell icons have been replaced with new SVG assets. These changes update the visual appearance of navigation and action icons (such as arrows, chevrons, and status indicators) used within the example interface.

tdesign-component/example/shell · high confidence

Updated iOS example configuration and file structure

The iOS example project has been updated with a new ExportOptionsDemoPlist.plist file to configure enterprise distribution settings, including manual signing and specific provisioning profiles. Additionally, the .gitignore file has been moved to the tdesign-component/example/ios directory and updated to ignore dgph files.

tdesign-component/example/ios · high confidence

Upload component migrated to v1 with new theming and layout APIs

The TUpload widget has been replaced with a new v1 implementation that introduces a dedicated TUploadThemeData for granular visual customization (including item size, spacing, colors, and border radius) and supports both grid and list layouts. The component now exposes a controlled file list via the files property and provides distinct callbacks for validation errors (onValidationError) and picker exceptions (onError), while removing internal network upload logic to let business code manage upload status.

tdesign-component/lib/src/components/upload · high confidence

iOS example app configuration and metadata updates

The iOS example app bundle has been renamed from 'flutter\_component\_example' to 'tdesign\_flutter\_example' with the display name 'Tdesign Flutter Example'. The app now requests camera, microphone, and photo library permissions required by the upload component demo, and enables view controller-based status bar appearance. Additionally, the app supports indirect input events and disables the minimum frame duration on iPhone to align with modern iOS requirements.

tdesign-component/example/ios/Runner · high confidence

iOS example project updated for Xcode 15 and minimum iOS 12

The iOS example project configuration has been updated to require a minimum deployment target of iOS 12 (up from 9.0) and upgraded to Xcode 15.10 project format. The build system now explicitly includes CocoaPods resource copying and uses a modern manifest lock check script, while the Xcode scheme enables GPU validation mode and configures the LLDB init file for improved debugging support.

tdesign-component/example/ios/Runner.xcodeproj · high confidence

iOS example storyboard files relocated and minor ID corrected

The iOS example project's storyboard files (LaunchScreen.storyboard and Main.storyboard) have been moved from the root example directory to the tdesign-component/example directory. Additionally, a minor identifier typo in Main.storyboard was corrected, changing the scene ID from 'tne-QT-ifu' to 'the-QT-ifu'.

tdesign-component/example/ios/Runner/Base.lproj · high confidence

macOS example app plugin registration updated

The macOS example application now explicitly registers the file\_selector, shared\_preferences, and url\_launcher plugins via the generated Flutter plugin registrant, ensuring these dependencies are correctly initialized at runtime.

tdesign-component/example/macos · high confidence

Fixes

1 commit (1 fix) fixing tdesign-component/example/tool

A fix in tdesign-component/example/tool — 1 commit (1 fix), 1 file: “fix(theme): 修复字体小数解析并补齐生成器导出接入 (\#1176)” (refs \#1176).

tdesign-component/example/tool · medium confidence · unverified

Test coverage

11 commits adding/updating tests in tdesign-component/test/components/picker; 11 commits adding/updating tests in tdesign-component/test/components/toast; 12 commits adding/updating tests in tdesign-component/test/components/dropdown\_menu; 12 commits adding/updating tests in tdesign-component/test/components/popup; 12 commits adding/updating tests in tdesign-component/test/helpers; 13 commits adding/updating tests in tdesign-component/test/components/popover; 14 commits adding/updating tests in tdesign-component/test/components/tabbar; 2 commits adding/updating tests in test; 21 commits adding/updating tests in tdesign-component/test/tool; 40 commits adding/updating tests in tdesign-component/example/lib/component\_test; 6 commits adding/updating tests in tdesign-component/test/components/table; 7 commits adding/updating tests in tdesign-component/test/components/steps; 7 commits adding/updating tests in tdesign-component/test/components/swiper; 8 commits adding/updating tests in tdesign-component/test/components/collapse; 8 commits adding/updating tests in tdesign-component/test/components/dialog; 8 commits adding/updating tests in tdesign-component/test/components/divider; 8 commits adding/updating tests in tdesign-component/test/components/footer; 8 commits adding/updating tests in tdesign-component/test/components/message; 9 commits adding/updating tests in tdesign-component/test/components/drawer; 9 commits adding/updating tests in tdesign-component/test/components/notice\_bar; Add screenshot capture drivers for BackTop, Form, Indexes, and Picker examples; Added acceptance tests for Theme token resolution and priority overrides; Added comprehensive test coverage for TButton component; Added comprehensive test coverage for TDesign text components and font loading; Added comprehensive test coverage for TSwipeCell component; Added golden and unit tests for TImage component states; Added integration and golden tests for component demo pages; Added integration, unit, and wheel tests for TDateTimePicker; Added test coverage for TSwitch and TCupertinoSwitch components; Added test evidence and audit tools for component token runtime verification; Added tests for TAvatar component behavior and theme integration; Added tests for TBackTop component; Added tests for TInput component behavior and theme data; Added tests for TSkeleton preset layouts and custom configurations; Added tests for the TLink component's styling, theming, and interaction behavior; Added tests for theme token ownership, interpolation, and overlay behavior; Added unit and golden tests for TCell component; Added unit and golden tests for TDrawer, TSteps, and Theme infrastructure; Added unit and golden tests for TSlider and TRangeSlider; Added unit and golden tests for TStepper component; Added unit and golden tests for the Calendar component; Added unit tests for ActionSheet components; Added unit tests for Indexes component sticky header and theme data; Added unit tests for TCheckbox and TCheckboxGroup v1 behavior and theming; Added unit tests for TFab component and TFabBounds constructor; Added unit tests for TIcon widget behavior and theme isolation; Added unit tests for TImageViewer component; Added unit tests for TProgress widget variants and theme consumption; Added unit tests for TResult widget rendering and theming; Added unit tests for TSearchBar component behavior; Added unit tests for TTextarea component behavior and styling; Added unit tests for TTimeCounter widget; Added unit tests for TTreeSelect component behavior; Added unit tests for the TEmpty component; Added unit tests for the TRate component; Added visual and unit tests for the TBadge component; Added visual regression and behavioral tests for TCascader; Added visual regression and unit tests for TNavBar; Added visual regression and unit tests for TPullDownRefresh; Added visual regression and unit tests for the TUpload component; Added widget and theme contract tests for TRadio; Added widget and theme tests for TSideBar; Added widget tests for Loading component indicators; Added widget tests for TForm and TFormField behavior; Added widget tests for TTag and TSelectTag components; New tooling for component coverage, visual regression, and demo validation.

Dependencies

Migrate example app to TDesign Flutter and upgrade build toolchains

The example application has been renamed to tdesign\_flutter\_example and migrated to use the tdesign\_flutter package, replacing the previous flutter\_component plugin. This update raises the minimum supported versions to Dart 3.8.0 and Flutter 3.32.0, and upgrades the Android build configuration to use the modern Flutter Gradle plugin with AGP 8.11.1 and Kotlin 2.2.20. The iOS example has been updated to target iOS 12.0 and now includes the image\_picker and shared\_preferences dependencies. Additionally, the site's development dependencies have been updated, including @tdesign/site-components to 0.18.1 and Vite to 6.4.3.

(dependencies) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 44 → 50 (+5.9)
  • Rubric changed (rubric-2026.10.5 → rubric-2026.11.2) — scores are not directly comparable.

Lenses

  • Code Health 50 → 58 (+8.1)
  • Architecture 95 → 95 (-0.7)
  • Maturity 38 → 60 (+22.7)
  • Readiness 36 → 33 (-2.3)
  • Security 59 → 65 (+5.4)
  • Performance 100 → 100 (+0.0)

Resolved (48)

  • (anonymous) (cognitive 18) (tool/audit_miniprogram_tokens.mjs)
  • (anonymous) (cognitive 34) (tool/audit_component_token_consumption.mjs)
  • (anonymous) (cyclomatic 20) (tool/audit_miniprogram_tokens.mjs)
  • (anonymous) (cyclomatic 34) (tool/audit_component_token_consumption.mjs)
  • Critical CVE: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • Documentation: no project overview (README.md)
  • Duplicated block (11 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • Duplicated block (24 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • FileTooLong: tool/audit_miniprogram_tokens.mjs (tool/audit_miniprogram_tokens.mjs)
  • High CVE: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • High CVE: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • High CVE: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • High CVE: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • High vulnerability: [GHSA redacted] (tdesign-site/pnpm-lock.yaml)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • …and 28 more

New (51)

  • Change coupling: t_check_box_group.dart ↔ t_radio.dart (tdesign-component/lib/src/components/checkbox/t_check_box_group.dart)
  • Duplicated block (11 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • Duplicated block (13 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • Duplicated block (14 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • Duplicated block (14 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • Duplicated block (18 lines × 2) (tdesign-component/lib/src/components/slider/t_slider.dart)
  • High secret: WD-SECRET-0005 (tdesign-site/package-lock.json)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • High: security finding (details withheld)
  • …and 31 more

Changes since last survey

  • 38 commits — 20 feature/other, 18 fixes

By area

  • specs/components — 14 commits
  • tdesign-component/example — 6 commits
  • specs/engineering — 5 commits
  • .github/workflows — 3 commits
  • tdesign-component/lib — 2 commits
  • specs/080-generator-theme-import — 1 commit
  • specs/083-dialog-text-slot-restoration — 1 commit
  • tdesign-component/MIGRATION.md — 1 commit
  • tdesign-component/pubspec.yaml — 1 commit
  • tdesign-component/test — 1 commit
  • tdesign-component/tool — 1 commit
  • tdesign-site/package.json — 1 commit
  • tdesign-site/site — 1 commit

Notable commits

  • fix: fix(ActionSheet): 修复 ActionSheet 安全区并补齐选择器示例 (#1224)
  • fix: fix(DropdownMenu): 隔离共享 Controller 的状态与过期回调 (#1203)
  • fix: fix(TCellGroup): 修复 scrollable 在无界高度父级下触发布局异常 (#1162)
  • fix: fix(TDialog): 修复标题与正文的 TText 样式传递 (#1181)
  • fix: fix(TFooter): 修复 Web 链接竖排及换行分隔线异常 (#1113)
  • fix: fix(TPullDownRefresh): 修复静止态 Header 文字溢出绘制到顶部的问题 (#1209)
  • fix: fix(TSlider): 修复滑块端点对齐与受限尺寸交互 (#1212)
  • fix: fix(TTabBar): 修复菜单回调内导航和关闭导致的路由误关 (#1198)
  • fix: fix(ci): 修复 preview 的 PR 识别 (#1215)
  • fix: fix(controller): 修复控制器替换失败与旧实例卸载的绑定清理 (#1191)
  • fix: fix(example): 按实际主题键展示功能色板 (#1206)
  • fix: fix(noticebar): 修复自定义区域点击的手势边界 (#1192)
  • fix: fix(overlay): 修复 Message、Loading 和 Toast 卸载后的资源清理 (#1190)
  • fix: fix(site): 修复主题初始化与文档导航状态恢复 (#1202)
  • fix: fix(text): 统一自定义文字槽默认样式与菜单高度 (#1184)
  • fix: fix(text): 补齐既有文字槽样式并保留原生段落语义 (#1182)
  • fix: fix(theme): 修复 Drawer 与 TabBar 主题内部解析的 implements 兼容性 (#1200)
  • fix: fix(theme): 修复字体小数解析并补齐生成器导出接入 (#1176)
  • change: breaking(TPopup): 修复 destroyOnClose 的关闭销毁与状态保留 (#1197)
  • change: breaking(TPopup): 收敛蒙层配置并补齐 1.0.1 升级说明 (#1199)
  • …and 18 more

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

Tencent/tdesign-flutter was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 5 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit a057663d555789bd44a40060df70139e20d41bfe — the exact code this score is about.
  • Scored under rubric-2026.11.2 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.2+preprod-5c4e66d9318b.