Add useMutation API

[x0k]

Example

<script lang="ts">
  import { useForm, FormContent } from '@sjsf/form'
  import { Status, useAction, abortPrevious } from '@sjsf/form/use-action.svelte'

  const action = useAction({
    do: (signal, data) => fetch('/url', { signal, method: 'POST', body: JSON.stringify(data) }).then(r => r.json()),
    combinator: abortPrevious,
    onSuccess: console.log,
    onFailure(failure) {
      if (failure.reason === 'error') {
        console.error(failure.error)
      } else {
        console.warn(failure.reason)
      }
    },
  })

  const form = useForm({
    ...,
    onSubmit: action.run
  })
</script>

<form use:form.enhance>
	<FormContent bind:value={form.formValue} />
	<button type="submit"> Submit </button>
	{#if action.isProcessed}
		<button type="button" onclick={action.abort}> Cancel </button>
	{/if}
	{#if action.isDelayed}
		Processed...
	{/if}
	{#if action.state.status === Status.Failed}
		<div>
			<!-- "error" | "abort" | "timeout" -->
			{action.state.reason}
			{#if action.state.reason === 'error'}
				: {action.state.error}
			{/if}
		</div>
	{/if}
</form>

Questionable points

• Svelte and SvelteKit already have the notion of action. Should we use the more familiar useMutation?
• Should the result of a successful execution be saved to the action state? Normally useMutation does this, but we don't.

[changeset-bot]

🦋 Changeset detected

Latest commit: 52ca9bf

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 12 packages

Name	Type
docs	Minor
@sjsf/form	Minor
@sjsf/ajv8-validator	Minor
@sjsf/daisyui-theme	Minor
@sjsf/flowbite-icons	Minor
@sjsf/flowbite-theme	Minor
@sjsf/lucide-icons	Minor
@sjsf/radix-icons	Minor
@sjsf/shadcn-theme	Minor
@sjsf/skeleton-theme	Minor
testing	Patch
playground	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[x0k]

• Renamed to useMutation
• I don't see the need to save the result of a successful execution to the mutation state