rastack 0.0.49 → 0.0.51

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+### [0.0.51](https://github.com/theserverkid/reactapistack/compare/v0.0.50...v0.0.51) (2026-07-16)
+
+### [0.0.50](https://github.com/theserverkid/reactapistack/compare/v0.0.49...v0.0.50) (2026-07-15)
+
 ### [0.0.49](https://github.com/theserverkid/reactapistack/compare/v0.0.48...v0.0.49) (2026-07-14)
 
 ### [0.0.48](https://github.com/theserverkid/reactapistack/compare/v0.0.47...v0.0.48) (2026-07-13)

package/components/auto-form/AutoForm.tsx

@@ -229,6 +229,19 @@ export function AutoForm(props: AutoFormProps): React.JSX.Element {
             justifyContent: "flex-end",
           }}
         >
+          {/* State-machine actions: one button per transition available from
+              the record's current state (feature-detected off the form). */}
+          {model.transitions.map((t) => (
+            <Button
+              key={t.name}
+              type="button"
+              variant="outline"
+              disabled={model.isSubmitting}
+              onClick={() => t.fire()}
+            >
+              {t.label}
+            </Button>
+          ))}
           {onCancel ? (
             <Button
               type="button"

package/components/auto-form/use-auto-form.ts

@@ -37,6 +37,15 @@ export interface AutoFormFieldModel {
   ) => React.ReactNode;
 }
 
+/** One state-machine action the form can fire from the record's current state. */
+export interface AutoFormTransitionModel {
+  name: string;
+  label: React.ReactNode;
+  /** The state the record enters when the action fires. */
+  to: string;
+  fire: () => void;
+}
+
 export interface AutoFormModel {
   fields: AutoFormFieldModel[];
   submit: () => void;
@@ -45,6 +54,11 @@ export interface AutoFormModel {
   /** `true` when the form is valid and not mid-submit. */
   canSubmit: boolean;
   errors: Record<string, unknown>;
+  /**
+   * State-machine actions — feature-detected from `useForm(Entity)` results
+   * whose resource declares `transitions`. Empty on forms without one.
+   */
+  transitions: AutoFormTransitionModel[];
 }
 
 /** Pure model assembly — see {@link useAutoForm}. Testable with a mock form. */
@@ -70,6 +84,19 @@ export function buildAutoFormModel(
     };
   });
 
+  // Feature-detect the state machine: `useForm(Entity)` exposes the declared
+  // transitions available from the record's current state; anything else
+  // (legacy hooks, hand-rolled forms) simply renders no actions.
+  const transitions: AutoFormTransitionModel[] =
+    Array.isArray(form.transitions) && typeof form.transition === "function"
+      ? form.transitions.map((t) => ({
+          name: t.name,
+          label: t.label ?? humanizeKey(t.name),
+          to: t.to,
+          fire: () => form.transition!(t.name),
+        }))
+      : [];
+
   return {
     fields,
     submit: () => form.onSubmit(),
@@ -77,6 +104,7 @@ export function buildAutoFormModel(
     isSubmitting: form.isSubmitting,
     canSubmit: !form.isSubmitDisabled && !form.isSubmitting,
     errors: (form.errors as Record<string, unknown>) ?? {},
+    transitions,
   };
 }
 

package/components/types.ts

@@ -95,4 +95,12 @@ export interface AutoFormLike {
   isSubmitting: boolean;
   /** Formik's error bag, keyed by field name. */
   errors?: Record<string, unknown> | unknown;
+  /**
+   * State-machine actions, feature-detected like everything else: when
+   * `useForm(Entity)` exposes the resource's declared transitions, the
+   * auto-form renders one action button per available edge.
+   */
+  transitions?: Array<{ name: string; label?: string; to: string }>;
+  /** Fire a declared transition (stage the edge's patch and save). */
+  transition?(name: string): void;
 }