@augmentcode/ag-redux-toolkit
Version:
Redux + Saga state management for Svelte apps — designed for AI agents. Includes runtime TypeScript source, AI skills, and reference documentation for robust, observable, high-performance state management.
126 lines (102 loc) • 4.37 kB
Markdown
---
name: react/migration/component-migration
description: >-
Migrate React JSX/TSX components and custom hooks to ReactStore selectors and
Store-first dispatch. Prefer direct selector signals in components/hooks, use
selector .useValue(...args) only for necessary hook/plain-value fallback reads,
.select(state, ...args) in handlers/tests, and document that Svelte
template/readable migration rules are non-applicable contrasts.
type: sub-skill
requires:
- react/component-integration
- react/migration
triggers:
- migrate React component
- replace React state import
- selector .useValue component migration
---
Replace old React state/context/custom-hook reads with `ReactStore` selectors,
read in components and custom hooks via direct selector signals where possible,
use `.useValue(...args)` only when a plain value is necessary, and dispatch through the
configured `ReactStore` instance.
Svelte `$selector` template syntax, readable initialization rules, `onDestroy`,
and `lifecycle_outside_component` guidance are not active React migration steps.
```tsx
import { useCartContext } from "./CartProvider";
export function CartButton({ id }: { id: string }) {
const { items, addItem, removeItem } = useCartContext();
const item = items.find((candidate) => candidate.id === id);
return <button onClick={() => item ? removeItem(id) : addItem(id)}>{item ? "Remove" : "Add"}</button>;
}
```
```tsx
import { reactStore } from "../store/react-store";
import { addItem, removeItem } from "../store/cart/cart-slice";
import { selectCartItemById } from "../store/cart/cart-selectors";
export function CartButton({ id }: { id: string }) {
const item = selectCartItemById(id);
return (
<button onClick={() => reactStore.dispatch(item.value ? removeItem(id) : addItem(id))}>
{item.value ? "Remove" : "Add"}
</button>
);
}
```
Prefer returning signals from migrated custom hooks when callers can accept them.
Use `.useValue(...args)` only for legacy hook contracts that must return plain values.
```tsx
import { selectCartTotal, selectIsCartSaving } from "../store/cart/cart-selectors";
export function useCartSummary() {
const total = selectCartTotal();
const isSaving = selectIsCartSaving();
return { total, isSaving };
}
```
Handlers should not call `.useValue(...args)` and should not create direct signals just
to read once. Use `.select(reactStore.state, ...args)`.
```tsx
import { reactStore } from "../store/react-store";
import { checkoutRequested } from "../store/cart/cart-slice";
import { selectCanCheckout } from "../store/cart/cart-selectors";
export function CheckoutButton() {
function onCheckout() {
if (selectCanCheckout.select(reactStore.state)) {
reactStore.dispatch(checkoutRequested());
}
}
return <button onClick={onCheckout}>Checkout</button>;
}
```
1. Replace old state/context/custom-hook imports with the new slice actions,selectors, and configured `reactStore` instance.
2. Replace render-time reads with direct selector signals; use `.useValue(...args)` only
for necessary plain-value boundaries.
3. Replace writes with `reactStore.dispatch(actionCreator(...))`.
4. Replace handler/test one-shot reads with `.select(reactStore.state, ...args)`.
5. Keep single-component ephemeral UI state in React component state.
6. Remove obsolete providers/hooks only after all consumers migrate.
```tsx
// BAD: .useValue belongs in React components/custom hooks during render, not handlers.
function onSubmit() {
const canCheckout = selectCanCheckout.useValue();
if (canCheckout) reactStore.dispatch(checkoutRequested());
}
```
```tsx
// BAD: writing context state and ReactStore state makes ownership ambiguous.
function badAdd(id: string) {
legacyCartContext.addItem(id);
reactStore.dispatch(addItem(id));
}
```
- `../../component-integration/SKILL.md` — React app bootstrap and dispatch rules.
- `../../selector-lifecycle/SKILL.md` — call-mode guardrails.
- `../cleanup/SKILL.md` — removing obsolete providers/hooks after migration.