@holo-js/forms 0.3.12 → 0.3.15

package/dist/internal/client.d.ts

@@ -1,7 +1,26 @@
-import { g as FormSubmissionResult, S as SerializedFormSubmission, c as FormFailurePayload, i as FormSuccessPayload } from '../contracts-BOhBkI9c.js';
-import { WebFileLike, SchemaInputShape, FieldBuilderInput, InferFieldOutput, ValidationErrorBag } from '@holo-js/validation';
+import { S as SerializedFormSubmission, c as FormFailurePayload, i as FormSuccessPayload, g as FormSubmissionResult } from '../contracts-BOhBkI9c.js';
+import { ValidationErrorBag, WebFileLike, SchemaInputShape, FieldBuilderInput, InferFieldOutput } from '@holo-js/validation';
 import { FormSchema, InferFormData } from '../schema.js';
 
+declare function collectFormDirtyPaths(current: unknown, initial: unknown, prefix?: string): readonly string[];
+declare class FormClientState<TValues, TSuccess = unknown> {
+    #private;
+    values: TValues;
+    initialValues: TValues;
+    flattenedErrors: Record<string, readonly string[]>;
+    touched: Set<string>;
+    dirty: Set<string>;
+    lastSubmission?: SerializedFormSubmission<TValues> | FormFailurePayload<TValues> | FormSuccessPayload<TSuccess>;
+    readonly listeners: Set<() => void>;
+    validationSequence: number;
+    constructor(values: TValues, initialState?: SerializedFormSubmission<TValues> | FormFailurePayload<TValues>);
+    get submitting(): boolean;
+    get errors(): ValidationErrorBag<TValues>;
+    get dirtyPaths(): readonly string[];
+    replace(values: TValues, initialValues: TValues, errors: Record<string, readonly string[]>, touched: ReadonlySet<string>): void;
+    startSubmission(signal?: AbortSignal): () => void;
+}
+
 type PrimitiveLike = string | number | boolean | bigint | symbol | null | undefined | Date | Blob | WebFileLike;
 type ValidateOnMode = 'submit' | 'blur' | 'change';
 interface ClientSubmitContext<TData> {
@@ -66,4 +85,4 @@ declare function runWithBrowserFormElement<TData, TSuccess>(formClient: Pick<Use
  */
 declare function createFormClient<TSchema extends FormSchema, TSuccess = unknown>(schemaDefinition: TSchema, options?: UseFormOptions<InferFormData<TSchema>, TSuccess>): UseFormResult<InferFormData<TSchema>, TSuccess, InferFormFieldTree<TSchema>>;
 
-export { type ClientSubmitContext, type ClientSubmitResult, type FormFieldState, type FormFieldTree, type InferFormFieldTree, type UseFormOptions, type UseFormResult, type ValidateOnMode, createFormClient, markClientSubmitControlFlowError, runWithBrowserFormElement };
+export { type ClientSubmitContext, type ClientSubmitResult, FormClientState, type FormFieldState, type FormFieldTree, type InferFormFieldTree, type UseFormOptions, type UseFormResult, type ValidateOnMode, collectFormDirtyPaths, createFormClient, markClientSubmitControlFlowError, runWithBrowserFormElement };

package/dist/internal/client.mjs

@@ -16,7 +16,7 @@ import {
 
 // src/internal/client.ts
 import {
-  createErrorBag,
+  createErrorBag as createErrorBag2,
   safeParse
 } from "@holo-js/validation";
 
@@ -72,9 +72,9 @@ async function getClientCsrfField() {
 
 // src/internal/validation-exception.ts
 import {
-  isValidationException,
-  validationInternals
+  isValidationException
 } from "@holo-js/validation";
+import { parseValidationExceptionDigest } from "@holo-js/validation/internal/compiled";
 function isPlainObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value);
 }
@@ -104,7 +104,7 @@ function formFailurePayloadFromError(error) {
   return candidates.find((candidate) => isFormFailurePayload(candidate));
 }
 function validationExceptionToFailure(error, fallbackValues = {}) {
-  const payload = isValidationException(error) ? error.toJSON() : validationInternals.parseValidationExceptionDigest(error);
+  const payload = isValidationException(error) ? error.toJSON() : parseValidationExceptionDigest(error);
   if (payload) {
     return {
       ok: false,
@@ -133,6 +133,9 @@ function validationExceptionToFailure(error, fallbackValues = {}) {
   return void 0;
 }
 
+// src/internal/state.ts
+import { createErrorBag } from "@holo-js/validation";
+
 // src/internal/formValues.ts
 function isPlainFormObject(value) {
   return !!value && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !(value instanceof Blob);
@@ -250,6 +253,69 @@ function buildFormData(value, path = "", formData = new FormData()) {
   return formData;
 }
 
+// src/internal/state.ts
+function collectFormDirtyPaths(current, initial, prefix = "") {
+  if (areFormValuesEqual(current, initial)) return [];
+  if (Array.isArray(current) && Array.isArray(initial)) {
+    const paths = Array.from(
+      { length: Math.max(current.length, initial.length) },
+      (_, index) => collectFormDirtyPaths(current[index], initial[index], prefix ? `${prefix}.${index}` : String(index))
+    ).flat();
+    return paths.length > 0 ? paths : [prefix];
+  }
+  if (isPlainFormObject(current) && isPlainFormObject(initial)) {
+    return [.../* @__PURE__ */ new Set([...Object.keys(current), ...Object.keys(initial)])].flatMap(
+      (key) => collectFormDirtyPaths(current[key], initial[key], prefix ? `${prefix}.${key}` : key)
+    );
+  }
+  return prefix ? [prefix] : [];
+}
+var FormClientState = class {
+  values;
+  initialValues;
+  flattenedErrors;
+  touched = /* @__PURE__ */ new Set();
+  dirty = /* @__PURE__ */ new Set();
+  lastSubmission;
+  listeners = /* @__PURE__ */ new Set();
+  validationSequence = 0;
+  #submissions = /* @__PURE__ */ new Set();
+  constructor(values, initialState) {
+    this.values = cloneFormValue(values);
+    this.initialValues = cloneFormValue(values);
+    this.flattenedErrors = { ...initialState?.errors };
+    this.lastSubmission = initialState;
+  }
+  get submitting() {
+    return this.#submissions.size > 0;
+  }
+  get errors() {
+    return createErrorBag(this.flattenedErrors);
+  }
+  get dirtyPaths() {
+    return collectFormDirtyPaths(this.values, this.initialValues);
+  }
+  replace(values, initialValues, errors, touched) {
+    this.values = values;
+    this.initialValues = initialValues;
+    this.flattenedErrors = errors;
+    this.touched = new Set(touched);
+    this.dirty = new Set(this.dirtyPaths);
+  }
+  startSubmission(signal) {
+    const id = /* @__PURE__ */ Symbol();
+    const finish = () => {
+      signal?.removeEventListener("abort", finish);
+      this.#submissions.delete(id);
+    };
+    if (!signal?.aborted) {
+      this.#submissions.add(id);
+      signal?.addEventListener("abort", finish, { once: true });
+    }
+    return finish;
+  }
+};
+
 // src/internal/client.ts
 var browserFormSubmitSymbol = /* @__PURE__ */ Symbol("browserFormSubmit");
 var clientSubmitControlFlowErrors = /* @__PURE__ */ new WeakSet();
@@ -322,14 +388,14 @@ function createSubmission(valid, values, errors, failureStatus = 422, schemaDefi
   });
 }
 function createSuccessfulSubmission(schemaDefinition, data) {
-  return createSubmission(true, data, createErrorBag(), 422, schemaDefinition);
+  return createSubmission(true, data, createErrorBag2(), 422, schemaDefinition);
 }
 function createFailedSubmission(schemaDefinition, values, flattenedErrors, status = 422) {
   void schemaDefinition;
   return createSubmission(
     false,
     values,
-    createErrorBag(flattenedErrors),
+    createErrorBag2(flattenedErrors),
     normalizeStatus(status, 422),
     schemaDefinition
   );
@@ -380,9 +446,6 @@ async function runWithBrowserFormElement(formClient, form) {
   }
   return await formClient.submit();
 }
-function createTypedErrorBag(flattenedErrors) {
-  return createErrorBag(flattenedErrors);
-}
 function notifyListeners(state) {
   for (const listener of state.listeners) {
     listener();
@@ -634,17 +697,7 @@ function createFormClient(schemaDefinition, options = {}) {
     normalizeFormObject(options.initialValues),
     normalizeFormObject(initialState?.values)
   );
-  const state = {
-    values: cloneFormValue(initialValues),
-    initialValues: cloneFormValue(initialValues),
-    flattenedErrors: { ...initialState?.errors ?? {} },
-    touched: /* @__PURE__ */ new Set(),
-    dirty: /* @__PURE__ */ new Set(),
-    submitting: false,
-    lastSubmission: initialState,
-    listeners: /* @__PURE__ */ new Set(),
-    validationSequence: 0
-  };
+  const state = new FormClientState(initialValues, initialState);
   const validateOn = options.validateOn ?? "submit";
   const fieldPaths = flattenFormLeafPaths(schemaDefinition.fields);
   const fields = buildFieldsTree(
@@ -702,7 +755,7 @@ function createFormClient(schemaDefinition, options = {}) {
     return normalizedSubmission;
   }
   async function submit(browserForm) {
-    state.submitting = true;
+    const finishSubmission = state.startSubmission();
     notifyListeners(state);
     try {
       const submitter = options.submitter ?? defaultSubmitter;
@@ -743,7 +796,7 @@ function createFormClient(schemaDefinition, options = {}) {
         data: void 0
       });
     } finally {
-      state.submitting = false;
+      finishSubmission();
       notifyListeners(state);
     }
   }
@@ -753,7 +806,7 @@ function createFormClient(schemaDefinition, options = {}) {
       return state.values;
     },
     get errors() {
-      return createTypedErrorBag(state.flattenedErrors);
+      return state.errors;
     },
     get submitting() {
       return state.submitting;
@@ -813,6 +866,8 @@ function createFormClient(schemaDefinition, options = {}) {
   });
 }
 export {
+  FormClientState,
+  collectFormDirtyPaths,
   createFormClient,
   markClientSubmitControlFlowError,
   runWithBrowserFormElement

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/forms",
-  "version": "0.3.12",
+  "version": "0.3.15",
   "description": "Holo-JS Framework - forms-first validation and submission contracts",
   "type": "module",
   "license": "MIT",
@@ -33,10 +33,10 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/validation": "^0.3.12"
+    "@holo-js/validation": "^0.3.15"
   },
   "peerDependencies": {
-    "@holo-js/security": "^0.3.12"
+    "@holo-js/security": "^0.3.15"
   },
   "peerDependenciesMeta": {
     "@holo-js/security": {
@@ -48,5 +48,8 @@
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^4.1.5"
+  },
+  "engines": {
+    "node": ">=22.12.0"
   }
 }