Component Changelog & Lifecycle
TuffEx release history and the version that introduced each component.
Overview
| Item | Value |
|---|---|
| Source version | 0.9.4 |
| Release version | 0.9.4 (latest npm release) |
| Component modules | 192: Base 99 · Pro 57 · AI 36 |
Release History
Version 0.9.4 (2026-11-16)
Form controls on one spec, Escape ownership, and component behavior fixed alongside the docs alignment.
- New components: none
- Main updated components: form, text, image-preview, image-generation, input, textarea, number-input, select, flat-select, date-picker, cascader, tag-input, tree-select, sensitive-input, base-anchor, dialog, modal, drawer, radio, miko, offline-state, working-indicator, tool-call-card, grid-layout, motion-control, skeleton, toast, toast-panel, text-morph, text-transformer
- Key features:
TxFormItemgainshint: field help sits behind a?beside the label and opens on hover or keyboard focus.TxTextgainsscroll="loop"andloopEdgeedge effects (gap,clip,fade,wrap).TxImagePreviewgainsloadingEffectand aloadingslot: while loading it shows a TxImageGeneration preset, a skeleton, or nothing.- Form controls follow
TxInput: number input, date field, flat select and multi select are 32px tall, corners are 12px, and edges are inset rings that keep the box size. - An open anchored layer handles Escape first, so the surrounding
TxModal/TxDrawerstays open; Escape from a form field no longer closes the dialog. TxMikoloads each state lazily; its default color is the lighter#9726D9.TxOfflineStateforwardsprimary/secondary;TxWorkingIndicatorandTxToolCallCardstop ticking while off screen.- Fixes: the
TxRadioGroupindicator re-measures when the group resizes,TxSensitiveInputstays revealed while focus moves to its copy button,TxBlowDialogclears the page zoom on unmount, and skeletons and collapsed toasts are hidden from screen readers.
Version 0.9.3 (2026-11-03)
Touch surfaces, the Miko desktop companion, text overflow, and custom emoji packs.
- New components: touch-surface, miko, text
- Main updated components: chain-of-thought, glass-surface, stream-markdown, icon-picker, markdown-editor, icon
- Key features:
- New
TxText: the ellipsis can sit at the start, middle or end of overflowing text (overflow);scroll="auto"loops the text back and forth, andscroll="hover"truncates at rest and slides the rest in on hover. On touch,hoverbecomes a tap toggle, and both scroll modes stop under reduced motion. - New
TxTouchSurfaceanduseLiquidTouch: a surface that behaves like a drop of liquid glass under a hovering or pressing pointer. - New
TxMiko, the desktop companion cat. TxIconPickerandTxMarkdownEditoracceptemojiPacks: the picker stores a picked emoji as aurl:identifier, and the editor inserts:name:and renders it as an image; shortcodes are 2–40 characters.TxGlassSurfacegainsengine="lens"(the default staysclassic), anduseLiquidDragis new.TxChainOfThoughtstreams its thinking text at a steady pace.- Fixes the
TxStreamMarkdowntable copy-as-CSV button, which a sticky header used to half-cover.
- New
Version 0.9.2 (2026-10-27)
A rewritten form system, a full-window image preview, and solid drawer surfaces by default.
- New components: drawer-form, image-preview, modal-form, steps-form
- Main updated components: attachment-tray, base-surface, charts, command-palette, dialog, drawer, flip-overlay, form, image-gallery, input, modal, motion-transition, number-input, select, sensitive-input, stream-markdown, switch, textarea
- Key features:
TxFormandTxFormItemare rewritten.layoutmoves labels beside or above fields by the form's own width; rules gaintype,min/max, length andpattern;level: 'warning'reports without blocking submit, anddepsrevalidates a field when the fields it depends on change. Controls inside a form item pick up its label, required state, error and readonly state automatically.TxFormgains drafts (persist), autosave (autosave) andreadonly: drafts are keyed by the form'sid, survive a reload or a closed tab, and are dropped after a successful submit orreset().- New
TxModalFormandTxDrawerFormedit a record in a dialog or a drawer, always on a copy ofinitialValues, and close only after a successful submit. NewTxStepsFormandTxFormStepsplit one form across steps: it takesv-model, validates each step before moving on, and submits the whole form at the end. - New
TxImagePreview: wheel and pinch zoom, pan with momentum once zoomed, horizontal swipe to page while unzoomed, drag up or down to close, and a flight from the thumbnail.TxImageGalleryandTxAttachmentTrayroute through it and load it the first time it is needed. TxDrawerpanels use a solid surface by default (surfacedefaults topure), so the page behind no longer shows through; passsurface="refraction"for the glass look.- Chart labels can follow the interface language:
TxTimeseriesChartandTxSankeyChartgainlabelsentries,TxMonoChartgainsformatX. - One Tab-cycle rule across dialogs: only visible, tabbable controls are stops, skipping hidden ones,
inertsubtrees andtabindex="-1";TxDrawermoves focus into the panel when it opens. - dompurify is upgraded past its critical and high advisories.
Version 0.9.1 (2026-10-21)
Fixes the refraction-surface jank that 0.9.0 brought to large panels.
- New components: None.
- Main updated components: base-surface, card, glass-surface
- Key features:
TxGlassSurfacedraws its displacement map as a bitmap at most 256px on its long side and stretches it. Chromium rasterizes the map on the CPU for every frame; the full-size map cost a large panel 100–200ms a frame, the bitmap under 1ms.refractionuses thecssrenderer by default and draws no SVG glass layer. PassrefractionRenderer="svg"where the refraction should show, and set its strength with the newrefractionGlassOpacity(0.3by default).TxCardforwards both props.setSurfacePerformanceMode('max')gives every costly material on the page a solid fill, except onsystemBackdropsurfaces.TxCard's SVG glass layer no longer disappears when a host clips the card withoverflow: hiddenor nests it in a rounded clipping container.
Version 0.9.0 (2026-10-20)
Learning curves, gesture interactions and refraction surfaces, including the previously unreleased component changes.
- New components: No new standalone component modules; the learning curve is exported from
charts. - Main updated components: alert, allocation-bar, attachment-tray, base-surface, card-spread, carousel-3d, charts, command-palette, dialog, drawer, fine-tune-card, flip-book, image-gallery, markdown-editor, modal, motion-dock, physics-motion, stream-element, stream-markdown, stream-text, thinking-orb, toast
- Key features:
TxLearningCurvesupports smoothing, multi-seed bands and viewport windows. Charts add press-to-read, zoom, pan and keyboard controls; the learning curve's Y-axis name no longer overlaps its ticks.- Carousel, flip book, card spread and physics motion support direct dragging and momentum release; Motion Dock updates its surface and magnification layout.
- Modal, Drawer, Command Palette and dialogs use refraction surfaces; transparent windows can enable
systemBackdrop. - Markdown Editor supports block editing, lazy-loaded CodeMirror, image uploads, AI rewrites, comments and collaboration interfaces.
- Attachment Tray and Image Gallery share a previewer with focus restoration, failure states and accessible icon-button labels; Thinking Orb adds gradient palettes.
Version 0.8.0 (2026-10-14)
Fixed brand-color surface lighting, voice-message playback, semantic data tables and form sizing fixes.
- New components (2): flow-light, voice-clip
- Updated components (13): base-anchor, base-surface, button, card, conversation-stream, data-table, dropdown-menu, input, number-input, select, tag-input, textarea, voice-beam
- Key features:
TxFlowLightsupports corners / rim / aurora, with fixed brand-color lighting forwarded by BaseSurface, Card and menu panels; hidden in high-contrast modeTxVoiceClipprovides playback, waveform seeking, keyboard controls, local recording decoding and one-at-a-time playback;TxVoiceBeamadds independentorganicmotion and respects reduced-motion preferencesTxButtonaddsprogress,showProgressandformatProgress;TxConversationStreammeasures restored conversation rows on mountTxDataTableadds semantic columntype, per-columnfilter/filterOptions, controlledfilter/defaultFilter, andupdate:filter/filterChange. Client-side filtering is on by default;filterOnClient=falsedelegates filtering to the caller, andautoStickyActionsfixes action columns to the right by defaultTxSelectenables search atsearchThresholdoptions (8 by default) whensearchableis omitted; explicitfalseor a nonpositive threshold disables automatic search- Input, Textarea, Select, NumberInput and TagInput explicitly use
border-box, without relying on a host reset or injecting a global wildcard reset - After extracting DataTable data state and deduplicating its styles, component JS is 42.9 KiB and full / on-demand CSS is 749.0 / 719.6 KiB; aggregate baselines are 750 / 720.5 KiB, with per-file budgets and import restrictions unchanged
Version 0.7.0 (2026-10-09)
Motion primitives and the Motion suite, a hover bridge for hover panels, and a terminal display component.
- New components (16): card-spread, carousel-3d, flip-book, morph, motion, motion-button, motion-control, motion-dock, motion-form, motion-loader, motion-metric, motion-text, motion-toggle, motion-transition, physics-motion, terminal
- Updated components (18): ai-elements, base-anchor, button, charts, chat, code-stream, flat-dropdown, fusion-surface, icon-chip, icon-morph, liquid, popover, rating, slider, steps, switch, tooltip, transition
- Motion documentation suite: navigation adds Motion, with individually resettable live specimens and bilingual category, sidebar, overview and demo registration
- Existing charts module additions: dither-chart in Motion and mono-chart in Data, both exported through
@talex-touch/tuffex/charts - Installation boundaries: still the three Base, Pro and AI barrels. Motion is a documentation suite; the
/motioncomponent subpath importsTxMotionand is not a fourth barrel. Composite forms, controls and metrics belong to Pro - Sources and licensing: callers own labels, content, items, models and data. Continuous effects share visibility, reduced-motion and cleanup handling; springs and changing text reuse the existing engines. Adaptations keep Amicro's MIT attribution and source-file Apache-2.0 notices; the 46 preserved Lucide glyphs keep ISC and applicable Feather-MIT notices, with no React or Lucide runtime dependency
- Key features:
- Closed-form springs (
solveSpring,createSpringTrack) anduseMorphBox; TxMorph keeps one shape across states; TxTransitionSmoothSize runs on springs and gains a blur transition - Hover panels render a bridge to their trigger and guard diagonal travel with a safe triangle; the anchor family draws no arrow by default, and the expand bounce is capped by panel height
- TuffSwitch's thumb rides the glide material, TxSlider overdrags on a rubber band, TxLineSeries draws its stroke in, TxIconMorph adds play and pause, and TxCopyButton morphs between copy, copied and failed
- TxTerminal shares ANSI / Unicode terminal display between the web and Electron
- Closed-form springs (
Version 0.6.3 (2026-10-01)
Streaming content and menu confirmation feedback; first tested with the client beta, then published to npm on 2026-10-03.
- New components (3): descriptions, stream-element, stream-text
- Updated components (6): code-stream, context-menu, data-table, dropdown-menu, pagination, stream-markdown
- Key features: shared pacing for text, code and answers, with citation and slot support; confirmation feedback for menu items that close on select; a label/value list for record details; skeleton loading for data tables; a page-size selector for pagination
Version 0.6.2 (2026-09-28)
Interactive visual effects and admin data-container enhancements.
- New components (4): bot-avatar, image-generation, metal-fx, voice-beam
- Updated components (4): card, empty-state, progress-bar, status-badge
- Key features:
- Agent avatars, image-generation reveals, liquid metal and audio-reactive voice beams
- TxProgressBar supports segmented values; admin cards and empty states share one container system
Version 0.6.1 (2026-09-28)
One accessible hint for short-lived outcomes such as copied, pinned and failed.
- New components (1): status-hint
- Key features:
- TxStatusHint supports tone washes, character-level text morphing and retrigger emphasis
- Supports light and dark themes, reduced motion, and a single accessible live region
Version 0.6.0 (2026-09-12)
Tactile interaction overhaul, a visual effects suite, and a stacked toast rewrite.
- New components (12): agent-screen, charts, choice-card, flowchart, fusion-surface, icon-morph, icon-picker, mode-chip, prism-glow, sensitive-input, text-morph, toast-panel
- Updated components (17): alert, badge, cascader, date-picker, flat-radio, group-block, picker, progress-bar, slider, sortable-list, stream-markdown, tab-bar, text-transformer, toast, toast-panel, transfer, tree
- Key features:
- TxTextMorph character-level morphing, removing the third-party number-flow dependency
- TxToastHost rewritten as a stackable toast system with swipe-to-dismiss and countdown pauses
- TxSortableList handle and keyboard sorting with live drag preview
- TxDatePicker and TxCascader range selection and chained floating panels
- The TxPrismGlow visual effect
Version 0.5.0 (2026-09-07)
Interaction feedback refinement and performance work.
- Updated components (5): card-item, dropdown-menu, filter-chips, slider, stream-markdown
- Key features:
- TxFilterChips sliding fill and icon-only mode
- Floating panels positioned with transforms, with sizing middleware
- Standardized interactive cursors and clean PostCSS build output
Version 0.4.0 (2026-09-01)
Component family consolidation and docs migration.
- Updated components (2): button, icon
- Key features:
- Consolidated the TxButton and TxIcon families, removing legacy subpaths
- Removed deprecated TuffFlatButton in favor of TxButton variant="flat"
- Runtime demos and documentation moved to Nexus
Version 0.3.9 (2026-06-12)
AI-native suite and on-demand stylesheets.
- New components (43): agent-trace, ai-elements, allocation-bar, approval-card, attachment-tray, border-beam, cell-link, chain-of-thought, code-stream, context-cards, context-indicator, conversation-stream, diff-table, dot-indicator, filter-chips, fine-tune-card, flat-dropdown, icon-chip, inline-citation, insight-cards, liquid, markdown-editor, message-actions, prompt-bar, reasoning-disclosure, recommendation-card, resize-box, scrub-field, search-panel, selection-actions, sidebar-nav, signal-meter, sources, spark-chart, stream-markdown, suggestion-chips, task-rows, thinking-orb, tool-call-card, tool-chips, tool-confirmation, version-capsule, working-indicator
- Updated components (8): base-anchor, base-surface, code-editor, empty-state, flip-overlay, radio, scroll, tabs
- Key features:
- 43 AI chat, agent and reasoning components
@talex-touch/tuffex/<component>subpath exportsbase.cssfor loading shared tokens on their own
Version 0.3.8 (2026-05-29)
Drawer and divider enhancements.
- Updated components (2): divider, drawer
- Key features:
- TxDrawer slides out from four directions and supports a full-screen modal
- TxDivider adds a gradient alpha fade mode
Version 0.3.7 (2026-05-28)
Foundational input and layout batch.
- New components (4): divider, kbd, number-input, textarea
- Updated components (16): avatar, chat,
flat-input, flat-radio, flat-select, flip-overlay, glass-surface, group-block, icon, input, scroll, slider, stagger, stat-card, tabs, transfer - Key features:
- Added TxTextarea, TxNumberInput, TxDivider and TxKbd
- Fixed client hydration parity under SSR
Version 0.3.4 (2026-03-08)
Initial standalone package baseline.
- Initial components (101): the first 101 core exported components, across basic, form, layout and navigation
Component Since Index
Introduction versions and installation barrels for all 192 component modules. Documentation suites are listed in the component hub.
Charts module additions
These chart components belong to the existing charts aggregate, import through @talex-touch/tuffex/charts, and don't add to the module count.
| Chart component | Documentation suite | Since |
|---|---|---|
dither-chart | Motion | 0.7.0 |
mono-chart | Data | 0.7.0 |
Version Gate and Standards
| Rule | Enforced by |
|---|---|
A version bump adds a matching chapter to CHANGELOG.md and this page | audit:changelog, blocking CI and publish |
| Each version chapter lists the components it added or updated | audit:changelog |
| Component doc Since values match this index and never exceed the current version | audit:changelog |
| Chinese and English pages keep the same heading structure | CI static check |