@mittwald/flow-react-components 1.2.0-next.0 → 1.2.0-next.2

package/AGENTS.md

@@ -358,7 +358,7 @@ Easy-to-miss conventions not spelled out above. Full details and examples in
   on `:has(.icon)`; eleven components set `Icon` defaults through
   `PropsContext`) never gets the `flow--icon` class, so icon sizing and
   icon-only padding silently do not apply. Wrap it — `<Icon><IconFoo /></Icon>`
-  — as the [Icon page](https://flow.mittwald.de/04-components/content/icon)
+  — as the [Icon page](https://flow.mittwald.de/components/content/icon)
   documents. Nothing errors: types, lint and the console stay clean.
 - **Universal exports are deliberately explicit** — remote-safe values and their
   types are curated in `flr-universal.ts` independently of the main public

package/MIGRATION.md

@@ -635,11 +635,11 @@ whose callbacks are typed from your own data shape.
 We've replaced the `react-syntax-highlighter` library, which means many
 properties have been removed and the remaining ones have been simplified. See
 the
-[CodeBlock documentation](https://flow.mittwald.de/04-components/content/code-block/overview)
+[CodeBlock documentation](https://flow.mittwald.de/components/content/code-block)
 for details on what's now supported.
 
 **Apply:** Check every `CodeBlock` usage against the current props (see the
-[CodeBlock documentation](https://flow.mittwald.de/04-components/content/code-block/overview))
+[CodeBlock documentation](https://flow.mittwald.de/components/content/code-block))
 and remove or replace props the new implementation does not support.
 
 ---
@@ -774,9 +774,41 @@ prop. At runtime the old prop still works: `Action` maps it to `onAction` and
 logs a deprecation warning, and an explicit `onAction` wins. The fallback will
 be removed in a future major version.
 
-A codemod renames the prop on `Action`.
+#### The type changed too
 
-**Apply:** Rename the `action` prop on `Action` to `onAction`.
+`onAction` is typed `ActionFn`, which is `(...args: unknown[]) => unknown`. A
+function that declares a parameter of any narrower type is not assignable to it,
+because the parameter would receive `unknown`:
+
+```
+Type '(options?: CloseOptions | undefined) => void' is not assignable to type 'ActionFn'.
+  Types of parameters 'options' and 'args' are incompatible.
+    Type 'unknown' is not assignable to type 'CloseOptions | undefined'.
+```
+
+Wrap the call instead of passing the reference:
+
+```diff
+- <Action onAction={controller.close}>
++ <Action onAction={() => controller.close()}>
+```
+
+Only function **references** are affected. An inline arrow
+(`onAction={() => …}`), a zero-parameter function, and anything already
+accepting `unknown` are all fine.
+
+A codemod renames the prop. It deliberately does not wrap: whether the
+referenced function declares a parameter cannot be decided from the source —
+that needs type information — and wrapping everything would silently drop the
+arguments `Action` passes to handlers that do accept them.
+
+**Apply:** Rename the `action` prop on `Action` to `onAction`. Not only a
+rename: the new prop is typed `ActionFn` (`(...args: unknown[]) => unknown`), so
+a function _reference_ that declares a parameter no longer type-checks and needs
+wrapping — `onAction={() => controller.close()}` rather than
+`onAction={controller.close}`. Check every site where you passed a reference
+rather than an inline arrow; the codemod renames the prop but cannot decide this
+one from the source.
 
 ```shell
 npx @mittwald/flow-codemods@latest action-prop-to-on-action src

package/USAGE.md

@@ -11,12 +11,12 @@ The prose that decides most questions — which component covers a use case, how
 spacing is composed, which pattern applies — lives on the docs site and is
 published for machine consumption:
 
-| URL                                      | What it is                                                        |
-| ---------------------------------------- | ----------------------------------------------------------------- |
-| `https://flow.mittwald.de/llms.txt`      | Index of every page, grouped by section                           |
-| `https://flow.mittwald.de/llms.json`     | Manifest: title, description, page URL, Markdown URL per page     |
-| `https://flow.mittwald.de/raw/<path>.md` | One page as Markdown, e.g. `/raw/04-components/actions/button.md` |
-| `https://flow.mittwald.de/llms-full.txt` | Every page in one file (~1.7 MB)                                  |
+| URL                                      | What it is                                                     |
+| ---------------------------------------- | -------------------------------------------------------------- |
+| `https://flow.mittwald.de/llms.txt`      | Index of every page, grouped by section                        |
+| `https://flow.mittwald.de/llms.json`     | Manifest: title, description, page URL, Markdown URL per page  |
+| `https://flow.mittwald.de/raw/<path>.md` | One page as Markdown, e.g. `/raw/components/actions/button.md` |
+| `https://flow.mittwald.de/llms-full.txt` | Every page in one file (~1.7 MB)                               |
 
 **Fetch a page before answering a design question.** The pages are **written in
 German**; component names and design-system terms (Variants, Colors, Sizes,
@@ -24,12 +24,12 @@ States, Props) are not translated.
 
 Start with these:
 
-- `/raw/02-foundations/02-structure/01-layout.md` and `02-spacing.md` — how
-  layout and spacing are meant to be composed
-- `/raw/03-patterns/01-patterns/forms.md`, `detail-page.md`, `errorhandling.md`,
+- `/raw/foundations/structure/layout.md` and `spacing.md` — how layout and
+  spacing are meant to be composed
+- `/raw/patterns/patterns/forms.md`, `detail-page.md`, `errorhandling.md`,
   `list-tile-table.md` — the recurring flows
-- `/raw/02-foundations/03-content-guidelines/01-sprach-guide.md` — UI wording
-- `/raw/01-get-started/versioning.md` — what you may depend on
+- `/raw/foundations/content-guidelines/sprach-guide.md` — UI wording
+- `/raw/get-started/versioning.md` — what you may depend on
 
 ## Setup
 
@@ -148,7 +148,7 @@ not a value to hard-code.
 
 The version contract deliberately leaves several surfaces unguaranteed. They can
 change in **any** release (see
-`https://flow.mittwald.de/raw/01-get-started/versioning.md`):
+`https://flow.mittwald.de/raw/get-started/versioning.md`):
 
 - **CSS class names** (`.flow--button`, …) — never write selectors against them.
 - **Design-token names and values** (`--size-px--m`, `--color--gray--500`) —