diff --git a/.changeset/goofy-parents-trade.md b/.changeset/goofy-parents-trade.md new file mode 100644 index 00000000000..a845151cc84 --- /dev/null +++ b/.changeset/goofy-parents-trade.md @@ -0,0 +1,2 @@ +--- +--- diff --git a/packages/mosaic/AGENTS.md b/packages/mosaic/AGENTS.md index ffe933bff8b..0a5c9c4bf44 100644 --- a/packages/mosaic/AGENTS.md +++ b/packages/mosaic/AGENTS.md @@ -36,6 +36,7 @@ Most problems a feature hits already have a shared answer. Find the row for your | ------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------- | | An async action from a button or row: pending, an error, one lock | `usePendingAction` (`src/hooks/`) | | Direct actions and confirmation dialogs that must exclude each other | `usePendingAction.guard` on the confirmation (`src/hooks/`, `src/blocks/confirm/`) | +| A machine-driven step that a lock or caller must await | `waitFor` (`src/machine/wait-for.ts`), inside `usePendingAction.run` | | A form: values, validation, submit, field errors, success UI | `useForm` (`src/components/form/`), with `validateAsync` for server checks and `onSuccess` for mounted success UI | | A `