submit _event_ not passed to @submit event

[SampsonCrowley]

I'm actually surprised nobody else has had this issue. it's wild to me that the @submit handler for https://formkit.com/inputs/form#submitting doesn't include the actual submit event in any way.

the only way to access the real submit event is via @submit-raw so accessing the event in the submit handler to do things that are simple in a native form opens the door for race conditions.

for instance to detect the clicked button in a form with multiple buttons I could do the following:

<script setup>
const triggerSubmit = (event) => {
  logger.debug('[PDF] Submitting Form', event)
  const category = event?.submitter?.dataset?.customize ? 'review' : 'default'
   ...
   ...
}
</script>

<template>
<form @submit=triggerSubmit>
  ...
  ...
  <button type="submit" data-customize=true>Customize</button>
  <button type="submit">Generate</button>
</form>

and easily have access to the button that clicked submit if the "alternate" was clicked

via Formkit it involves more handling or custom button click handling

from an accessibility standpoint I'd much prefer leaving both submit buttons as type=submit and have a way to access the event directly in @submit instead of only via raw

my proposal would be simply adding it as a 3rd parameter

changing the current signature from

(event:'submit', data: any, node: FormKitNode)

to

(event:'submit', data: any, node: FormKitNode, e: Event)
onSubmit: (data: any, node: FormKitNode, event: Event) => any;