# SplitAction

> A main action with a menu of related ones beside it.

- **Level**: molecule · **Status**: stable · **Role**: action
- **Import**: `import { SplitAction } from "@rrios-forge/ui/molecules/split-action";`
- **Source**: `packages/ui/src/molecules/split-action`

Two independent buttons (main + menu trigger) attached visually. Each is a separate focus stop. Destructive split actions reserve danger for the main button and the matching menu items — never for the menu trigger alone. Patterns consulted: Patterns/Visual Priority · ActionHierarchy, Patterns/Overlays · DropdownVsDialog.

## Use it for

- Toolbar / split action → `Toolbar` or `ActionGroup` / `SplitAction`

## Axes

| Axis | Part | Values | Default | Meaning |
|---|---|---|---|---|
| `size` | — | `sm` `md` `lg` | `md` | Ergonomic scale, in three families (control, text, container). |

## Stories

- [Playground](/?path=/story/components-molecules-splitaction--playground) — interaction test · frame: `/iframe.html?id=components-molecules-splitaction--playground&viewMode=story`
- [Intents](/?path=/story/components-molecules-splitaction--intents) · frame: `/iframe.html?id=components-molecules-splitaction--intents&viewMode=story`
- [Emphases](/?path=/story/components-molecules-splitaction--emphases) · frame: `/iframe.html?id=components-molecules-splitaction--emphases&viewMode=story`
- [Sizes](/?path=/story/components-molecules-splitaction--sizes) · frame: `/iframe.html?id=components-molecules-splitaction--sizes&viewMode=story`
- [With danger menu](/?path=/story/components-molecules-splitaction--with-danger-menu) · frame: `/iframe.html?id=components-molecules-splitaction--with-danger-menu&viewMode=story`
- [In toolbar](/?path=/story/components-molecules-splitaction--in-toolbar) · frame: `/iframe.html?id=components-molecules-splitaction--in-toolbar&viewMode=story`

## Decisions that name it

- ADR-030 — Axis vocabulary: one name, one meaning

## Always

- Tokens only (R04); variants are semantic axes, never appearance (R02).
- Typography and actions are Poesía atoms, never raw HTML with utilities.
- Vibrant panes need a ground and never nest (ADR-027).