@dynamicforms/vue-forms 0.17.0 → 0.17.1

package/dist/index.d.ts

@@ -7,7 +7,8 @@ import { Ref } from 'vue';
 /**
  * Thrown from a handler to end the run it is in. What the trigger answers with is the exception itself rather than
  * `null`, so a caller can tell a run a handler ended from one that reached no handler at all - and the setters
- * that ask a `*Changing*` handler read it as a refusal and write nothing.
+ * that ask a `*Changing*` handler read it as a refusal and write nothing. The answer carries it directly where the
+ * chain ran synchronously, and as what the answered promise resolves to where a handler in it was asynchronous.
  */
 export declare class AbortEventHandlingException extends Error {
 }
@@ -45,7 +46,8 @@ export declare class Action<T extends ActionValue = ActionValue, X extends objec
      *
      * The answer is a promise whatever the handler returns, so a handler that throws rejects it rather than throwing
      * out of this call: a caller that does not await the answer and does not attach a catch handler leaves that
-     * rejection unhandled.
+     * rejection unhandled. An `AbortEventHandlingException` is the one exception that does not reject: the answer
+     * resolves with it, in a synchronous chain as in an asynchronous one.
      */
     execute(params?: any): Promise<any>;
 }
@@ -103,10 +105,24 @@ export declare class ActionsMap {
     bindTo(owner: FieldBase): void;
     /** True where no eager action of `identifier` stands after `index`, which makes `index` the group's entry. */
     private static outermostEager;
+    /**
+     * True where `value` is a promise, which is what a walk through an asynchronous handler answers with. The test is
+     * the type rather than a `then` member: a handler may answer with a value object that carries one, and calling
+     * `then` on such an object replaces the answer with whatever that call returns.
+     */
+    private static isPromise;
+    /**
+     * Answers an abort with itself on the asynchronous path as well. Where a handler in the chain is asynchronous, the
+     * walk answers with a promise and the abort raised under it arrives as that promise's rejection; this turns it back
+     * into the value the caller receives, so a promise the trigger answers with resolves to the exception instead of
+     * rejecting with it. Anything else keeps rejecting.
+     */
+    private static answerAbort;
     /**
      * Enters a group at its outermost action. An abort ends the run and is answered with rather than raised: the
-     * exception is what the caller receives, so a run a handler ended is told apart from one that reached no handler
-     * and from one whose handler answered null.
+     * exception is what the caller receives - directly where the chain ran synchronously, as what the answered promise
+     * resolves to where it did not - so a run a handler ended is told apart from one that reached no handler and from
+     * one whose handler answered null.
      */
     private run;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dynamicforms/vue-forms",
   "private": false,
-  "version": "0.17.0",
+  "version": "0.17.1",
   "type": "module",
   "description": "A lightweight Vue.js library for form state management with built-in validation, conditional logic, nested structures, and a rich event system. UI-agnostic and TypeScript-first.",
   "author": "Jure Erzno\u017enik",