# Tag changelog

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

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

<a id="v125-2026-10-23"></a>

### v1.2.5 (2026-10-23)

- Arrow canvases retain fractional host layout dimensions, preventing integer rounding from extending the outline beyond its shell and reducing spacing between tags. Parent transforms are not counted twice; the arrow formula and internal Tag zero spacing remain unchanged.

- 2026-10-23: Existing tag-group examples reuse Frame single-line layout and local ScrollArea horizontal scrolling, keeping at least 4px between tags. Internal Tag zero spacing, arrows, closing and toggle behavior remain unchanged; documentation and caller-example revision only.

<a id="v124-2026-10-20"></a>

### v1.2.4 (2026-10-20)

- The built-in close button name follows LocaleProvider and supports Provider messages overrides. The caller still owns tag content and removal after onClose.

- 2026-10-05: Changed the former default Indigo palette to Brand (`--brand`), retaining opacity, states, and override behavior.

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

<a id="v123-2026-09-20"></a>

### v1.2.3 (2026-09-20)

- The close button no longer has a minimum content width and takes no space at rest. On exit it fades out before narrowing; keyboard focus keeps it expanded.

<a id="v122-2026-08-30"></a>

### v1.2.2 (2026-08-30)

- Fixed an extra right-side gap in closable Tags: when not hovered, the shared `flex` shorthand had restored a 12px slot for the hidden X.

<a id="v121-2026-08-16"></a>

### v1.2.1 (2026-08-16)

- Restored the full transition channels for the Tag root and closable state, and explicitly retained the hover-overlay transition.

<a id="v120-2026-05-22"></a>

### v1.2.0 (2026-05-22)

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

#### Fixes

- **TAG-Shape.3** `shape="left-arrow" / "right-arrow"` now uses an internal SVG background path that generates a fully rounded arrow outline from the current Tag width and height. All outside corners are rounded, avoiding the square body-side corner left by the previous body-plus-pseudo-element construction.

<a id="v112-2026-05-21"></a>

### v1.1.2 (2026-05-21)

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

#### Fixes

- **TAG-Close.3** The built-in X uses `ComponentIcon name="close"` and the Components package’s plain X default icon; IconProvider can replace it centrally. The default shape still comes from `close-regular.svg` and Workshop 12×12.
- **TAG-Close.4** The built-in X in the active state now uses `--secondary-indigo`: 40% when X is not hovered and 100% when it is, preventing X from turning black on hover inside an active Tag.

<a id="v111-2026-05-21"></a>

### v1.1.1 (2026-05-21)

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

#### Fixes

- **TAG-Close.2** The built-in X now reuses the shared `.snowui-clear-icon-btn` base class and `<XCircle weight="fill" />`, providing `opacity: 0.4 → 1` feedback when X itself is hovered.

<a id="v110-2026-05-21"></a>

### v1.1.0 (2026-05-21)

<a id="新增"></a>

#### Added

- **TAG-Toggle.1** Added the `toggle` prop as Button-style shorthand. It injects `Click={{ Idle: "Active", Active: "Idle" }}` and `whileClick=false` by default, switching between normal and active states on click.

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

#### Fixes

- **TAG-State.1** Default `variant="default"` no longer locks the controlled Frame to `Idle`; an explicit `Click` state machine can drive `data-state="Active"` normally.

<a id="v100-2026-05-21"></a>

### v1.0.0 (2026-05-21)

<a id="新增-1"></a>

#### Added

- **TAG-Init.1** Created Tag with `default` and `active` visual variants.
- **TAG-Layout.1** Added an inline shell layout matching Button, without a built-in leading Icon.
- **TAG-Close.1** Added the built-in `closable` X: it appears on Tag hover, uses currentColor and default opacity 0.4, and reaches opacity 1 when X itself is hovered. Clicking triggers `onClose` and `stopPropagation`.
- **TAG-Shape.1** Added `shape="left-arrow" / "right-arrow"` path-fragment shapes using CSS clip-path.
- **TAG-Shape.2** Rounded the arrow path outline according to Workshop `node-id=11887-37739`, while retaining pure CSS pseudo-elements and `clip-path: path()` to avoid gaps or overlap between SVG and body.
- **TAG-A11y.1** Automatically emits `aria-pressed` like Button (based on currentState, injected by frame-dom-runtime); externally supplied `aria-pressed` / `aria-selected` take priority.
- **TAG-Color.1** The active background uses `--secondary-indigo` at 10% with `--secondary-indigo` text, matching Button `.snowui-button-active` exactly.

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