@mittwald/flow-react-components 0.2.0-alpha.1045 → 0.2.0-alpha.1047

package/AGENTS.md

@@ -56,7 +56,7 @@ export interface ButtonProps
     PropsWithChildren<Omit<Aria.ButtonProps, "children">>,
     FlowComponentProps<HTMLButtonElement> {
   /** The color of the button. @default "primary" */
-  color?: "primary" | "accent" | "secondary" | "danger";
+  color?: "primary" | "success" | "secondary" | "danger";
 }
 
 /** @flr-generate all */

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.2.0-alpha.1047](https://github.com/mittwald/flow/compare/0.2.0-alpha.1046...0.2.0-alpha.1047) (2026-08-24)
+
+### Features
+
+* **Combine:** rename Align to Combine ([#2871](https://github.com/mittwald/flow/issues/2871)) ([8bbf7bf](https://github.com/mittwald/flow/commit/8bbf7bf69b1753180cf91e5901a7f49e8c6b1fd5))
+
+# [0.2.0-alpha.1046](https://github.com/mittwald/flow/compare/0.2.0-alpha.1045...0.2.0-alpha.1046) (2026-08-24)
+
+**Note:** Version bump only for package @mittwald/flow-react-components
+
 # [0.2.0-alpha.1045](https://github.com/mittwald/flow/compare/0.2.0-alpha.1044...0.2.0-alpha.1045) (2026-08-24)
 
 **Note:** Version bump only for package @mittwald/flow-react-components

package/MIGRATION.md

@@ -2,6 +2,89 @@
 
 ---
 
+## From version `0.2.0-alpha.1046` to `>=0.2.0-alpha.1047`
+
+### Align renamed to Combine
+
+`Align` is now called `Combine`. The old name suggested a generic alignment tool
+and clashed with the `align` property of `Flex`; the component actually gives
+known combinations of components a fixed, correct arrangement.
+
+```diff
+- <Align>
++ <Combine>
+    <Avatar />
+    <Text>Max Mustermann</Text>
+- </Align>
++ </Combine>
+```
+
+`Align` (and the `flr-align` remote element) keeps working unchanged, logs a
+deprecation warning at runtime, and will be removed in a future major version.
+
+A codemod renames `Align` to `Combine` and `AlignProps` to `CombineProps`:
+
+```shell
+npx jscodeshift \
+  -t https://raw.githubusercontent.com/mittwald/flow/refs/heads/main/packages/codemods/src/transforms/flowAlphaAlignToCombine.ts \
+  --parser tsx \
+  src
+```
+
+Replace `src` with your sources folder.
+
+The component tokens were renamed along with the component
+(`--align--avatar-text--spacing` is now `--combine--avatar-text--spacing`), and
+so were the CSS class names (`.flow--align` is now `.flow--combine`). Both are
+internal and not covered by Semantic Versioning.
+
+---
+
+## From version `0.2.0-alpha.1045` to `>=0.2.0-alpha.1046`
+
+### Button: color `accent` renamed to `success`
+
+The button color `accent` is now called `success` — the name says what the color
+means instead of how it looks.
+
+```diff
+- <Button color="accent">Speichern</Button>
++ <Button color="success">Speichern</Button>
+```
+
+`color="accent"` keeps working and logs a deprecation warning, but will be
+removed in a future release. A codemod rewrites it on `Button` and
+`SubmitButton`:
+
+```shell
+npx jscodeshift \
+  -t https://raw.githubusercontent.com/mittwald/flow/refs/heads/main/packages/codemods/src/transforms/flowAlphaButtonColorAccentToSuccess.ts \
+  --parser tsx \
+  src
+```
+
+Replace `src` with your sources folder.
+
+The CSS class and the design tokens are renamed **without** a fallback — update
+them by hand if you use `@mittwald/flow-stylesheet` or the token CSS variables
+directly:
+
+```diff
+- <button class="flow--button flow--button--accent">
++ <button class="flow--button flow--button--success">
+```
+
+```diff
+- var(--button--accent-solid-background-color--default)
++ var(--button--success-solid-background-color--default)
+```
+
+The same rename applies to every `--button--accent-{solid,plain,soft,outline}-*`
+variable. `Chat`'s internal class `flow--chat--accent-button` became
+`flow--chat--success-button`.
+
+---
+
 ## From version `0.2.0-alpha.1007` to `>=0.2.0-alpha.1016`
 
 ### TooltipTrigger changed delay type

package/PATTERNS.md

@@ -898,7 +898,7 @@ and consistency enforced by tooling, not maintained by hand.
     remote).
   - ✗ already-structured nodes → preserve them.
 - **Layout primitives over ad-hoc wrappers** `[undocumented]` — `Section`,
-  `ColumnLayout`, `Align`, `Flex`, `Content`.
+  `ColumnLayout`, `Combine`, `Flex`, `Content`.
   - ✓ spacing/align/columns/stack expressible via Flow primitives.
   - ✗ a wrapper needed for semantics/third-party/owned styling → the correct
     semantic element.