# Text changelog

Read the complete [LICENSE](https://snowui.dev/LICENSE) for the installed version before use.

Reviewed against Chinese source SHA-256 `bad0bfa2217badddc400a36ba52597bf63bd5accfdc28603dce545456a16800d`. For version differences, check the installed package as well.

<a id="v354-2026-10-22"></a>

### v3.5.4 (2026-10-22)

- Single-line Tooltip Hug anchors stay vertically centered within an explicit singleLine host. Ordinary text flow and column layouts remain unchanged.
- Single-line truncation retains complete assistive text so button, link and native-label names do not shrink to the visible prefix. Text continues to own visual fitting, the ellipsis and full-text hints.

<a id="v353-2026-10-12"></a>

### v3.5.3 (2026-10-12)

- Incoming children now use a distinct internal name to avoid self-reference to Frame's identically named Snippet. This fixes recursion during package SSR for ordinary text such as category headings without changing public content or breakpoint props.

- 2026-09-21: Aligned the usage guide, source Prop table, and Site / AI reading entry. Documentation only; component behavior is unchanged.

<a id="v352-2026-08-15"></a>

### v3.5.2 (2026-08-15)

- Semantic `p / h1…h6` hosts explicitly enable `overflow-wrap: break-word`, protecting long words even without optional `snowui-base.css`; `tag="code"` still allows application-level code initialization.

<a id="v351-2026-08-06"></a>

### v3.5.1 (2026-08-06)

- Without `lines`, the truncation controller remains entirely dormant: it reads no text and creates no observation target. Enabling truncation dynamically still activates the existing protocol.

<a id="v350-2026-07-04"></a>

### v3.5.0 (2026-07-04)

- Added an opt-in built-in `more` Button for `lines=0`, styled after the ArrowLineDown button in example 6.
- The built-in more Button enables `backgroundBlur` with the same strength as the BarChart blurred overlay.
- Added `parts.Button`; an explicit `Button as="more"` can replace the built-in button.
- Without more, shared `.snowui-scroll-mask` and `useOverlayScrollbar` provide top/bottom fades and the same overlay scrollbar rules as Textarea. With more, Text stays in expand mode without a scrollbar.

<a id="v340-2026-06-23"></a>

### v3.4.0 (2026-06-23)

<a id="修复"></a>

#### Fixes

- **TX-Fix.57** Changed `lines={1}` to shared boundary fitting plus an explicit inline ellipsis. This fixes missing ellipsis with automatic Tooltip and avoids splitting words, Han characters, emoji, or combining characters.
- **TX-Fix.58** Separated the line-clamp content layer from Tooltip for `lines={2|3}`, preventing text after the ellipsis from showing. Real truncation consistently displays Tooltip and pointer cursor. Multiline hosts return to block layout to remove inline-baseline bottom space. Restored the controller's initial `lines` to fix missing bottom fade when `lines={0}` is collapsed.
- **TX-Fix.60** `lines={2|3}` uses `text-box-trim: trim-end` and `text-box-edge: text` to trim half-leading below the last line. This removes the impression of larger bottom padding from asymmetric font ascent/descent while preserving descender space.
- **TX-Fix.61** Fixed `.snowui-text-inline-block` still overriding multiline hosts. The `lines={2|3}` root now uses block layout without inline-baseline bottom space. Collapse height is applied to the real multiline content layer to avoid a height feedback loop between root and content.
- **TX-Test.59** Example 4 now uses `tooltip="Full content…"` to avoid registering both a child Tooltip and Text's automatic Tooltip in the shared overlay; mouseleave closes it again.
- **TX-Fix.56** Added a local content-opacity bridge for ButtonGroup to Text's base opacity chain, so a disabled ButtonGroup applies `opacity: 0.2` only once at its shell.
- **Text-Docs.2026-05-25** Archived the historical changelog from the source header. New changes belong in this document's changelog; the source header retains only its role, current key architecture, and documentation path.
- **TX-Adjust.55** Internalized expansion through `Button as="more"`: the example no longer passes `Click.run` to change host height. A Button inside `Text lines={0}` with `as="more"` triggers the expansion animation and hides itself through Text context.
- **TX-Adjust.54** Added host-height animation when `Button as="more"` expands. Like Accordion content size motion, height transitions from current to full content. Collapsed state and more Button stay visible during animation; only afterward does Text switch to expanded and hide the button, preserving the animation starting point rather than letting the example set `height:auto` immediately.
- **TX-Adjust.53** `Button as="more"` now uses automatic layout Pin. It is still declared inside Text content, internally mapped to `pin-bottom-right`, and lifted to the root after Text mounts to avoid the content mask. It hides after expansion or when content is not truncated.
- **TX-Adjust.52** `lines=0` fade now reuses shared transparent-mask capability from `.snowui-scroll-mask` in `layout.css` rather than drawing a background-color gradient overlay through `::after`.

<a id="v3335-2026-03-16"></a>

### v3.3.35 (2026-03-16)

<a id="调整"></a>

#### Changes

- **TX-Adjust.51** Disabled Text's own default hover on request: `interactive` now defaults to `false`, and `snowui-text-hover-enabled` is attached only with explicit `interactive={true}`.

<a id="v3334-2026-03-06"></a>

### v3.3.34 (2026-03-06)

<a id="调整-1"></a>

#### Changes

- **TX-Adjust.50** Fixed missing easing on `lines=0/2/3` hover by extending the default `--snowui-text-collapse-transition` to a combined list of `max-height/min-height/height + margin/transform`, preventing inline truncation transitions from overriding hover.

<a id="v3333-2026-03-06"></a>

### v3.3.33 (2026-03-06)

<a id="调整-2"></a>

#### Changes

- **TX-Adjust.48** Reverted the policy of disabling hover while truncated. Text again follows only `interactive`, retaining hover motion across truncation and expansion states.
- **TX-Adjust.49** Removed `[data-truncated="true"]` exclusion from hover selectors so `lines=1` and expanded `lines=0` use consistent entry/exit transitions.

<a id="v3332-2026-03-06"></a>

### v3.3.32 (2026-03-06)

<a id="调整-3"></a>

#### Changes

- **TX-Adjust.47** Isolated hover in single-line truncated state by explicitly excluding `[data-truncated="true"]` from selectors, avoiding movement during asynchronous truncation measurement.

<a id="v3331-2026-03-06"></a>

### v3.3.31 (2026-03-06)

<a id="调整-4"></a>

#### Changes

- **TX-Adjust.45** Removed hover movement while truly truncated: Text attaches `snowui-text-hover-enabled` only when `interactive !== false && !isTruncated`.
- **TX-Adjust.46** Split truncation/expansion transition variables into `snowui-text-collapse-motion-enabled` so preserving collapse animation does not accidentally restore hover while truncated.

<a id="v3330-2026-03-06"></a>

### v3.3.30 (2026-03-06)

<a id="调整-5"></a>

#### Changes

- **TX-Adjust.42** Restored Text's own hover transition chain. `hover-enabled` again declares explicit `margin/transform` transitions so appearance does not fall back entirely to Frame's default motion.
- **TX-Adjust.43** Restored explicit transition variables in the truncation path: `--snowui-text-collapse-transition` now lists targeted `max-height/min-height/height` properties instead of `transition: all`.
- **TX-Adjust.44** Hover rules now exclude `.snowui-disabled` and `:disabled`, preventing additional hover movement when disabled.

<a id="v3329-2026-02-25"></a>

### v3.3.29 (2026-02-25)

<a id="调整-6"></a>

#### Changes

- **TX-Adjust.41** Removed the `:not(code)` patch from `Text.svelte` and `layout.css` on request, returning to the original typography strategy. Future base-style override issues should be solved at the style-layer architecture rather than by selector patches.

<a id="v3328-2026-02-25"></a>

### v3.3.28 (2026-02-25)

<a id="修复-1"></a>

#### Fixes

- **TX-Fix.40** Fixed `Text tag="code"` not being overridden by `snowui.css` code rules. Component default typography was limited to `:not(code)`, and Container baseline typography in `layout.css` excluded `code` to avoid overriding `@layer base` code styles.

<a id="v3327-2026-02-25"></a>

### v3.3.27 (2026-02-25)

<a id="修复-2"></a>

#### Fixes

- **TX-Fix.39** Historical approach: the component once forced code typography with `code.snowui-text`; v3.3.28 replaced it with natural override by `snowui.css`.

<a id="v3326-2026-02-25"></a>

### v3.3.26 (2026-02-25)

<a id="修复-3"></a>

#### Fixes

- **TX-Fix.37** Fixed inline truncation styles overriding hover transitions for `lines=2/3/0`. `text-collapse` transition became variable-driven through `--snowui-text-collapse-transition`, with Text injecting `all 1000ms ease-out` while hover-enabled.

<a id="样式优化"></a>

#### Style refinements

- **TX-Doc.38** Completed Text style documentation covering hover-state styles, `Button as="more"` positioning, `lines=0` fade mask, `lines=2/3` truncation fallback, and selector mapping.

<a id="v3325-2026-02-25"></a>

### v3.3.25 (2026-02-25)

<a id="修复-4"></a>

#### Fixes

- **TX-Fix.35** Fixed hover still running with `interactive={false}` by restoring `interactive` as the hover switch, on by default and disabled by explicit `false`.
- **TX-Fix.36** Unified inconsistent hover transition durations across examples with `transition: all 1000ms ease-out` on the resting `.snowui-text-hover-enabled` class.

<a id="v3324-2026-02-25"></a>

### v3.3.24 (2026-02-25)

<a id="修复-5"></a>

#### Fixes

- **TX-Fix.34** Made hover perceptible in the basic centered-text example by adding `--snowui-text-hover-shift-x` while retaining margin hover rules.

<a id="v3323-2026-02-25"></a>

### v3.3.23 (2026-02-25)

<a id="调整-7"></a>

#### Changes

- **TX-Adjust.32** Simplified interaction policy: `interactive` remained for compatibility but no longer controlled Text hover; all Text applied transitions and margin changes on hover by default.
- **TX-Adjust.33** Removed forced pointer cursors inside Text. Ordinary hover, truncation, and tooltip states no longer inject `cursor:pointer`.

<a id="v3322-2026-02-25"></a>

### v3.3.22 (2026-02-25)

<a id="修复-6"></a>

#### Fixes

- **TX-Fix.31** Resolved `lines=0` host detection regressions between examples 6 and 9-4. Computed height in pixels is no longer treated alone as an explicit constraint; instead detect inline `height/max-height`, computed `max-height`, height utilities (`h-* / max-h-* / min-h-* / size-*`), and overflow constraints.

<a id="v3321-2026-02-25"></a>

### v3.3.21 (2026-02-25)

<a id="修复-7"></a>

#### Fixes

- **TX-Fix.30** Fixed a regression for a fixed-height outer container with `lines=0` (example 6). A constraint host must itself truly clip content, avoiding misclassification of an unclipped Text as the host and restoring truncated state and the `more` button.

<a id="v3320-2026-02-25"></a>

### v3.3.20 (2026-02-25)

<a id="修复-8"></a>

#### Fixes

- **TX-Fix.29** Fixed `lines=0` failing to truncate without an outer container when Text's own class sets height such as `h-*`. `findConstraintHost` now prioritizes computed height constraints on Text itself instead of selecting an outer scroll container.

<a id="v3319-2026-02-25"></a>

### v3.3.19 (2026-02-25)

<a id="修复-9"></a>

#### Fixes

- **TX-Fix.27** Fixed occasional missed truncation for `lines=2/3` with only Text's own constraints. Multiline mode now writes stable `max-height + overflow:hidden`; the previous `min-height` fallback alone could not guarantee visible clipping.
- **TX-Fix.28** Reverted incorrect forced fallback overrides: removed `width:auto/height:auto` for `truncate-container/collapsed` inside Text so user `w-*/h-*` constraints are not reversed and `lines=0` works.

<a id="v3318-2026-02-25"></a>

### v3.3.18 (2026-02-25)

<a id="修复-10"></a>

#### Fixes

- **TX-Fix.26** Removed global truncation rules in `layout.css` that forcibly changed Text width/height, and added a fallback in Text so `lines=3/0` truncates reliably with only its own width/height constraints.

<a id="v3317-2026-02-25"></a>

### v3.3.17 (2026-02-25)

<a id="修复-11"></a>

#### Fixes

- **TX-Fix.25** Fixed missed `lines=3/0` truncation when width and height were declared only on Text itself. Removed `width:100%` and collapsed `lines=0` global `height:100%` rules that overrode user constraints, giving Text's own dimensions priority.

<a id="v3316-2026-02-25"></a>

### v3.3.16 (2026-02-25)

<a id="修复-12"></a>

#### Fixes

- **TX-Fix.24** `lines=0` fade appears only when content is truly truncated and not expanded, preventing masks on untruncated text from disrupting button visibility or readability.

<a id="v3315-2026-02-25"></a>

### v3.3.15 (2026-02-25)

<a id="修复-13"></a>

#### Fixes

- **TX-Fix.23** Removed the built-in “+5 lines” expansion rule. `TextTruncation.handleExpand` returned to generic expansion; examples or applications can implement staged container growth through Frame events.

<a id="v3314-2026-02-25"></a>

### v3.3.14 (2026-02-25)

<a id="修复-14"></a>

#### Fixes

- **TX-Fix.22** Historical approach: the component once implemented staged growth for `lines=0` plus `Button as="more"`; v3.3.15 moved it to the example layer.

<a id="v3313-2026-02-25"></a>

### v3.3.13 (2026-02-25)

<a id="修复-15"></a>

#### Fixes

- **TX-Fix.21** Strengthened positioning of `Button as="more"` by explicitly placing `.snowui-text-expand-button` at Text's bottom-right, preventing Button base positioning from returning it to the text flow.

<a id="v3312-2026-02-25"></a>

### v3.3.12 (2026-02-25)

<a id="修复-16"></a>

#### Fixes

- **TX-Fix.19** Updated the newer contract: `more` is no longer a visibility switch; presence of `<Button as="more">` in Text content determines both button visibility and what it shows.
- **TX-Fix.20** Text adds a button stacking constraint (`z-index`) for `Button as="more"` in `lines=0`, keeping the button above the fade layer.

<a id="v3311-2026-02-25"></a>

### v3.3.11 (2026-02-25)

<a id="修复-17"></a>

#### Fixes

- **TX-Fix.18** Aligned collapsed `lines=0` height with Text2: forced `snowui-truncate-container` to `height:100%` while collapsed for a stable clipping basis, fixing missing fade/more button during initial measurement.

<a id="v3310-2026-02-25"></a>

### v3.3.10 (2026-02-25)

<a id="修复-18"></a>

#### Fixes

- **TX-Fix.17** Fixed `lines=0` host detection regression. `findConstraintHost` excludes Text's internal `height:100%` control value and prioritizes explicit parent height constraints (`max-height` or `overflow + fixed height`), restoring truncation detection and bottom fade/more button.

<a id="v339-2026-02-25"></a>

### v3.3.9 (2026-02-25)

<a id="修复-19"></a>

#### Fixes

- **TX-Fix.14** Matched Text2's `more` behavior: removed suppression of the default button when custom `as="more"` is detected, keeping the default more button visible when `lines=0` is collapsed and truncated.
- **TX-Fix.15** Changed the default more icon from `CaretDown` to `ArrowLineDown` and updated Test example assets.
- **TX-Fix.16** `findConstraintHost` now prefers explicit height constraints (`max-height` or `overflow + fixed height`), reducing mistaken truncation when the constraint host shifts under `lines=0`.

<a id="v338-2026-02-25"></a>

### v3.3.8 (2026-02-25)

<a id="修复-20"></a>

#### Fixes

- **TX-Fix.12** Corrected truncation detection with padding on an outer container for `lines=0`. `checkCollapse` computes visible height as `min(constraintHeight, measureClientHeight)` to restore `isTruncated/isCollapsed` and reveal the more button.
- **TX-Fix.13** The default more icon uses `ComponentIcon name="arrow-line-down"`, resolved through Components built-in fallback and IconProvider rather than inline SVG or a forced external resource package.

<a id="v337-2026-02-25"></a>

### v3.3.7 (2026-02-25)

<a id="修复-21"></a>

#### Fixes

- **TX-Fix.11** Fixed missing fade from a misidentified constraint host. `lines=0` now detects truncation against a container that actually clips content instead of mistaking Text's own auto height for a host constraint.

<a id="v336-2026-02-25"></a>

### v3.3.6 (2026-02-25)

<a id="修复-22"></a>

#### Fixes

- **TX-Fix.10** Stabilized the `lines=0` fade layer while collapsed, changed the gradient to `linear-gradient(transparent -> background color)`, and raised its `z-index`, avoiding missing fades from `color-mix/mask` compatibility differences.

<a id="v335-2026-02-25"></a>

### v3.3.5 (2026-02-25)

<a id="修复-23"></a>

#### Fixes

- **TX-Fix.9** Removed interfering same-layer `mask-image` from the `lines=0` fade and used one `::after` gradient overlay for reliable visibility.

<a id="v334-2026-02-25"></a>

### v3.3.4 (2026-02-25)

<a id="修复-24"></a>

#### Fixes

- **TX-Fix.8** Added a `::after` gradient overlay alongside `mask-image` as a `lines=0` fade fallback, keeping the last-line fade visible across environments.

<a id="v333-2026-02-25"></a>

### v3.3.3 (2026-02-25)

<a id="修复-25"></a>

#### Fixes

- **TX-Fix.7** Added bottom-mask fading of the final visible line for `lines=0`, following Text2 to signal undisplayed content.

<a id="v332-2026-02-25"></a>

### v3.3.2 (2026-02-25)

<a id="修复-26"></a>

#### Fixes

- **TX-Fix.5** Added a multiline truncation CSS fallback for `lines=2/3` when `display:block` could override block-mode clamping.
- **TX-Fix.6** Expanded nested-container height detection to include the current container's actual height, entering truncation when space is insufficient.

<a id="v331-2026-02-25"></a>

### v3.3.1 (2026-02-25)

<a id="修复-27"></a>

#### Fixes

- **TX-Fix.4** Fixed `lines=2/3` truncation with Tooltip by preventing `inline-flex` from overriding line-clamp display.

<a id="v330-2026-02-25"></a>

### v3.3.0 (2026-02-25)

<a id="修复-28"></a>

#### Fixes

- **TX-Fix.1** Restored the `lines=0` truncation mask and default expand-button path.
- **TX-Fix.2** Restored automatic Tooltip inference: truncated `lines=1/2/3` shows full text by default.
- **TX-Fix.3** Added compatibility inputs `tooltip` / `more` while retaining role-based composition.

<a id="v320-2026-02-23"></a>

### v3.2.0 (2026-02-23)

<a id="架构重构"></a>

#### Architecture refactoring

- **TX-Migration.1** Moved truncation from Frame to Text; Text now directly supports `lines` / `onTruncate`.
- **TX-Migration.2** Added `TextTruncation` inside Text to manage truncation action, state context, and class/style output consistently.
- **TX-Migration.3** Removed dependency on `enableTruncation`; default capability switches are now `enableResponsive` / `enableContext` / `enableScaleObserver`.

<a id="v310-2026-02-23"></a>

### v3.1.0 (2026-02-23)

<a id="精简"></a>

#### Simplification

- **TX-Refactor.1** Removed context and state logic duplicated with Frame (`getInteraction`/`getSkeleton`/`getSize`/`isLoading`/`isDisabled`).
- **TX-Refactor.2** Changed `enableContext` from `false` to `true`, letting Frame handle context awareness automatically.
- **TX-Refactor.3** Stopped manually forwarding `loading`/`disabled`/`size`/`renderHints`, reducing the script from 97 to 65 lines.

<a id="v302-2026-02-03"></a>

### v3.0.2 (2026-02-03)

<a id="修复-29"></a>

#### Fixes

- **TX-Fix.1** Passed Frame CSS behavior and capability switches explicitly.

<a id="v300-2026-01-21"></a>

### v3.0.0 (2026-01-21)

<a id="架构重构-1"></a>

#### Architecture refactoring

- **Delegated truncation**: Removed internal `lines` handling, `ResponsiveController`, and `ResizeObserver`; Frame became the owner of all three at that stage.
- **Context refinement**: Removed `setContext` and used `context.ts` automatic fallback to reuse Frame's `TruncationContext`.

<a id="样式优化-1"></a>

#### Style refinements

- **Inline CSS**: Truncation styles were inlined into `Frame.svelte` at that stage.

<a id="v200-previous"></a>

### v2.0.0 (Previous)

- Added intelligent truncation (`lines`).
- Supported role-based Tooltip/Button composition.

[Component guide](https://snowui.dev/llms/en/components/text.md) · [Full reference](https://snowui.dev/llms/en/components/text/reference.md)