Components/Component Changelog & Lifecycle

Component Changelog & Lifecycle

TuffEx release history and the version that introduced each component.

Since 0.3.4BETA

Overview

ItemValue
Source version0.9.4
Release version0.9.4 (latest npm release)
Component modules192: 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:
    • TxFormItem gains hint: field help sits behind a ? beside the label and opens on hover or keyboard focus.
    • TxText gains scroll="loop" and loopEdge edge effects (gap, clip, fade, wrap).
    • TxImagePreview gains loadingEffect and a loading slot: 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 / TxDrawer stays open; Escape from a form field no longer closes the dialog.
    • TxMiko loads each state lazily; its default color is the lighter #9726D9.
    • TxOfflineState forwards primary / secondary; TxWorkingIndicator and TxToolCallCard stop ticking while off screen.
    • Fixes: the TxRadioGroup indicator re-measures when the group resizes, TxSensitiveInput stays revealed while focus moves to its copy button, TxBlowDialog clears 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, and scroll="hover" truncates at rest and slides the rest in on hover. On touch, hover becomes a tap toggle, and both scroll modes stop under reduced motion.
    • New TxTouchSurface and useLiquidTouch: a surface that behaves like a drop of liquid glass under a hovering or pressing pointer.
    • New TxMiko, the desktop companion cat.
    • TxIconPicker and TxMarkdownEditor accept emojiPacks: the picker stores a picked emoji as a url: identifier, and the editor inserts :name: and renders it as an image; shortcodes are 2–40 characters.
    • TxGlassSurface gains engine="lens" (the default stays classic), and useLiquidDrag is new.
    • TxChainOfThought streams its thinking text at a steady pace.
    • Fixes the TxStreamMarkdown table copy-as-CSV button, which a sticky header used to half-cover.

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:
    • TxForm and TxFormItem are rewritten. layout moves labels beside or above fields by the form's own width; rules gain type, min / max, length and pattern; level: 'warning' reports without blocking submit, and deps revalidates 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.
    • TxForm gains drafts (persist), autosave (autosave) and readonly: drafts are keyed by the form's id, survive a reload or a closed tab, and are dropped after a successful submit or reset().
    • New TxModalForm and TxDrawerForm edit a record in a dialog or a drawer, always on a copy of initialValues, and close only after a successful submit. New TxStepsForm and TxFormStep split one form across steps: it takes v-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. TxImageGallery and TxAttachmentTray route through it and load it the first time it is needed.
    • TxDrawer panels use a solid surface by default (surface defaults to pure), so the page behind no longer shows through; pass surface="refraction" for the glass look.
    • Chart labels can follow the interface language: TxTimeseriesChart and TxSankeyChart gain labels entries, TxMonoChart gains formatX.
    • One Tab-cycle rule across dialogs: only visible, tabbable controls are stops, skipping hidden ones, inert subtrees and tabindex="-1"; TxDrawer moves 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:
    • TxGlassSurface draws 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.
    • refraction uses the css renderer by default and draws no SVG glass layer. Pass refractionRenderer="svg" where the refraction should show, and set its strength with the new refractionGlassOpacity (0.3 by default). TxCard forwards both props.
    • setSurfacePerformanceMode('max') gives every costly material on the page a solid fill, except on systemBackdrop surfaces.
    • TxCard's SVG glass layer no longer disappears when a host clips the card with overflow: hidden or 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:
    • TxLearningCurve supports 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:
    • TxFlowLight supports corners / rim / aurora, with fixed brand-color lighting forwarded by BaseSurface, Card and menu panels; hidden in high-contrast mode
    • TxVoiceClip provides playback, waveform seeking, keyboard controls, local recording decoding and one-at-a-time playback; TxVoiceBeam adds independent organic motion and respects reduced-motion preferences
    • TxButton adds progress, showProgress and formatProgress; TxConversationStream measures restored conversation rows on mount
    • TxDataTable adds semantic column type, per-column filter / filterOptions, controlled filter / defaultFilter, and update:filter / filterChange. Client-side filtering is on by default; filterOnClient=false delegates filtering to the caller, and autoStickyActions fixes action columns to the right by default
    • TxSelect enables search at searchThreshold options (8 by default) when searchable is omitted; explicit false or 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 /motion component subpath imports TxMotion and 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) and useMorphBox; 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

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.

Version 0.6.2 (2026-09-28)

Interactive visual effects and admin data-container enhancements.

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.

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.

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.

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.

ComponentInstallation barrelSince
agent-screenai0.6.0
agent-traceai0.3.9
agentsai0.3.4
ai-elementsai0.3.9
alertbase0.3.4
allocation-barpro0.3.9
approval-cardai0.3.9
attachment-trayai0.3.9
auto-sizerpro0.3.4
avatarbase0.3.4
badgebase0.3.4
base-anchorpro0.3.4
base-surfacepro0.3.4
blank-slatebase0.3.4
border-beampro0.3.9
bot-avatarai0.6.2
breadcrumbbase0.3.4
buttonbase0.3.4
cardbase0.3.4
card-itembase0.3.4
card-spreadpro0.7.0
carousel-3dpro0.7.0
cascaderbase0.3.4
cell-linkbase0.3.9
chain-of-thoughtai0.3.9
chartspro0.6.0
chatai0.3.4
checkboxbase0.3.4
choice-cardai0.6.0
code-editorpro0.3.4
code-streamai0.3.9
collapsebase0.3.4
command-palettepro0.3.4
containerbase0.3.4
context-cardsai0.3.9
context-indicatorai0.3.9
context-menubase0.3.4
conversation-streamai0.3.9
corner-overlaypro0.3.4
data-tablebase0.3.4
date-pickerbase0.3.4
descriptionsbase0.6.3
dialogbase0.3.4
diff-tablepro0.3.9
dividerbase0.3.7
dot-indicatorbase0.3.9
drawerbase0.3.4
drawer-formbase0.9.2
dropdown-menubase0.3.4
edge-fade-maskpro0.3.4
emptybase0.3.4
empty-statebase0.3.4
error-statebase0.3.4
file-uploaderbase0.3.4
filter-chipsbase0.3.9
fine-tune-cardai0.3.9
flat-dropdownbase0.3.9
flat-radiobase0.3.4
flat-selectbase0.3.4
flexbase0.3.4
flip-bookpro0.7.0
flip-overlaypro0.3.4
floatingpro0.3.4
flow-lightpro0.8.0
flowchartai0.6.0
formbase0.3.4
fusionpro0.3.4
fusion-surfacepro0.6.0
glass-surfacepro0.3.4
glow-textpro0.3.4
gradient-borderpro0.3.4
gradual-blurpro0.3.4
gridbase0.3.4
grid-layoutbase0.3.4
group-blockbase0.3.4
guide-statebase0.3.4
iconbase0.3.4
icon-chipbase0.3.9
icon-morphpro0.6.0
icon-pickerbase0.6.0
image-gallerybase0.3.4
image-generationpro0.6.2
image-previewbase0.9.2
image-uploaderbase0.3.4
inline-citationai0.3.9
inputbase0.3.4
insight-cardsai0.3.9
kbdbase0.3.7
keyframe-stroke-textpro0.3.4
layout-skeletonbase0.3.4
liquidpro0.3.9
loading-overlaybase0.3.4
loading-statebase0.3.4
markdown-editorpro0.3.9
markdown-viewbase0.3.4
message-actionsai0.3.9
metal-fxpro0.6.2
mikoai0.9.3
modalbase0.3.4
modal-formbase0.9.2
mode-chipai0.6.0
morphpro0.7.0
motionpro0.7.0
motion-buttonpro0.7.0
motion-controlpro0.7.0
motion-dockpro0.7.0
motion-formpro0.7.0
motion-loaderpro0.7.0
motion-metricpro0.7.0
motion-textpro0.7.0
motion-togglepro0.7.0
motion-transitionpro0.7.0
nav-barbase0.3.4
no-database0.3.4
no-selectionbase0.3.4
number-inputbase0.3.7
offline-statebase0.3.4
outline-borderpro0.3.4
paginationbase0.3.4
permission-statebase0.3.4
physics-motionpro0.7.0
pickerbase0.3.4
popoverbase0.3.4
prism-glowpro0.6.0
progressbase0.3.4
progress-barbase0.3.4
prompt-barai0.3.9
radiobase0.3.4
ratingbase0.3.4
reasoning-disclosureai0.3.9
recommendation-cardai0.3.9
resize-boxpro0.3.9
scrollbase0.3.4
scrub-fieldbase0.3.9
search-emptybase0.3.4
search-inputbase0.3.4
search-panelpro0.3.9
search-selectbase0.3.4
segmented-sliderbase0.3.4
selectbase0.3.4
selection-actionsbase0.3.9
sensitive-inputbase0.6.0
sidebar-navbase0.3.9
signal-meterpro0.3.9
skeletonbase0.3.4
sliderbase0.3.4
sortable-listbase0.3.4
sourcesai0.3.9
spark-chartpro0.3.9
spinnerbase0.3.4
splitterbase0.3.4
stackbase0.3.4
staggerpro0.3.4
stat-cardbase0.3.4
status-badgebase0.3.4
status-hintbase0.6.1
stepsbase0.3.4
steps-formbase0.9.2
stream-elementai0.6.3
stream-markdownai0.3.9
stream-textai0.6.3
suggestion-chipsai0.3.9
switchbase0.3.4
tab-barbase0.3.4
tabsbase0.3.4
tagbase0.3.4
tag-inputbase0.3.4
task-rowsai0.3.9
terminalpro0.7.0
textbase0.9.3
text-morphpro0.6.0
text-transformerpro0.3.4
textareabase0.3.7
thinking-orbai0.3.9
timelinebase0.3.4
toastbase0.3.4
toast-panelbase0.6.0
tool-call-cardai0.3.9
tool-chipsai0.3.9
tool-confirmationai0.3.9
tooltipbase0.3.4
touch-surfacepro0.9.3
transferbase0.3.4
transitionpro0.3.4
treebase0.3.4
tree-selectbase0.3.4
tuff-logo-strokepro0.3.4
version-capsulepro0.3.9
virtual-listpro0.3.4
voice-beampro0.6.2
voice-clipai0.8.0
working-indicatorai0.3.9

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 componentDocumentation suiteSince
dither-chartMotion0.7.0
mono-chartData0.7.0

Version Gate and Standards

RuleEnforced by
A version bump adds a matching chapter to CHANGELOG.md and this pageaudit:changelog, blocking CI and publish
Each version chapter lists the components it added or updatedaudit:changelog
Component doc Since values match this index and never exceed the current versionaudit:changelog
Chinese and English pages keep the same heading structureCI static check