@mittwald/flow-react-components 0.2.0-alpha.921 → 0.2.0-alpha.926

package/AGENTS.md

@@ -4,6 +4,11 @@ Component patterns for the core package. Read the
 [root AGENTS.md](../../AGENTS.md) first for repo-wide rules (generated code,
 Definition of Done, workflow).
 
+> **Full pattern catalog:** [PATTERNS.md](./PATTERNS.md) lists every convention
+> (182 patterns) with per-pattern applicability (when to use / when not), a
+> canonical example each, and a decision cheat-sheet. This guide covers the
+> must-know core; look there when deciding between two approaches.
+
 ## Component anatomy
 
 ```
@@ -224,3 +229,37 @@ props to hide.
   component code.
 - Storybook discovers all `src/**/*.stories.tsx` automatically; there is no
   registry to update.
+
+## Non-obvious conventions
+
+Easy-to-miss conventions not spelled out above. Full details and examples in
+[PATTERNS.md](./PATTERNS.md).
+
+- **`PropsContext` is structural, not just styling** — nested entries,
+  `dynamic` children, semantic defaults (icon size, heading level, status), and
+  contextual `wrapWith` define much of a composite's internal API.
+- **The factory supplies hidden infrastructure** — memoization, nested-context
+  preservation, slot propagation, UI isolation, and tunnel entry/provider
+  wiring are all automatic consequences of `flowComponent`; don't rebuild them.
+- **Raw string children get `Text`-normalized** where typography is
+  context-driven (detect raw strings, wrap in `Text`); explicit structured
+  children are left intact.
+- **Semantic generated CSS classes are coordination points** — scoped modules
+  still use `:global(.flow--…)` when independently rendered Flow descendants
+  must affect layout.
+- **Controllers coexist with declarative props** — overlay-like APIs support
+  controlled/uncontrolled props *and* a controller object, not one or the other.
+- **Complex behavior is split by vocabulary** — `components/` for render,
+  `hooks/` for behavior, `lib/` for pure transforms, `models/` for durable
+  state.
+- **`SettingsProvider` combines async resources, hierarchical MobX stores, and
+  serialized, Suspense-aware writes** — reuse it rather than rolling
+  persistence.
+- **The empty `Default` story is intentional** — realistic args and rendering
+  live in the typed `meta`, so `export const Default: Story = {}` is the norm.
+- **CSS leans on modern relational/low-specificity selectors** — `:has`,
+  `:where`, logical properties, data attributes, and container boundaries
+  reduce the need for runtime styling props.
+- **Universal exports are deliberately explicit** — remote-safe values and
+  their types are curated in `flr-universal.ts` independently of the main
+  public surface; adding to `public.ts` does not add them there.

package/CHANGELOG.md

@@ -3,6 +3,32 @@
 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.926](https://github.com/mittwald/flow/compare/0.2.0-alpha.925...0.2.0-alpha.926) (2026-07-20)
+
+**Note:** Version bump only for package @mittwald/flow-react-components
+
+# [0.2.0-alpha.925](https://github.com/mittwald/flow/compare/0.2.0-alpha.924...0.2.0-alpha.925) (2026-07-17)
+
+**Note:** Version bump only for package @mittwald/flow-react-components
+
+# [0.2.0-alpha.924](https://github.com/mittwald/flow/compare/0.2.0-alpha.923...0.2.0-alpha.924) (2026-07-17)
+
+### Bug Fixes
+
+* **components:** correct placeholder and disabled colors for form fields ([#2663](https://github.com/mittwald/flow/issues/2663)) ([89735c0](https://github.com/mittwald/flow/commit/89735c0e86686cdfee259fc5f43b09350e3a69e1))
+
+# [0.2.0-alpha.923](https://github.com/mittwald/flow/compare/0.2.0-alpha.922...0.2.0-alpha.923) (2026-07-16)
+
+### Features
+
+* **ActionGroup:** add preserveOrder prop for DOM-order layout ([#2652](https://github.com/mittwald/flow/issues/2652)) ([a0f14f1](https://github.com/mittwald/flow/commit/a0f14f11fb0a305e3589fa392f7d5dceacb70b00))
+
+# [0.2.0-alpha.922](https://github.com/mittwald/flow/compare/0.2.0-alpha.921...0.2.0-alpha.922) (2026-07-16)
+
+### Features
+
+* **List:** add optional infinite scroll ([#2650](https://github.com/mittwald/flow/issues/2650)) ([9526b46](https://github.com/mittwald/flow/commit/9526b462dea8165d6f9987db7178545c8c59e035))
+
 # [0.2.0-alpha.921](https://github.com/mittwald/flow/compare/0.2.0-alpha.920...0.2.0-alpha.921) (2026-07-16)
 
 ### Features