@digigov/form 2.0.0-8de46296 → 2.0.0-a0ac149e

package/cjs/validators/utils/text_limit/index.js

@@ -1,12 +1,28 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var text_limit_exports = {};
+__export(text_limit_exports, {
+  TEXT_LIMIT_VALIDATOR: () => TEXT_LIMIT_VALIDATOR,
+  validateText: () => validateText
 });
-exports.TEXT_LIMIT_VALIDATOR = void 0;
-exports.validateText = validateText;
+module.exports = __toCommonJS(text_limit_exports);
 function validateText(value, min, max) {
-  var validator;
+  let validator;
   if (min || max) {
     if (value.length < min || value.length > max) {
       return validator = false;
@@ -16,39 +32,38 @@ function validateText(value, min, max) {
   }
   return validator;
 }
-var TEXT_LIMIT_VALIDATOR = exports.TEXT_LIMIT_VALIDATOR = function TEXT_LIMIT_VALIDATOR(field) {
-  var _field$extra, _field$extra$limit, _field$extra2, _field$extra2$limit;
-  var min = field === null || field === void 0 ? void 0 : (_field$extra = field.extra) === null || _field$extra === void 0 ? void 0 : (_field$extra$limit = _field$extra.limit) === null || _field$extra$limit === void 0 ? void 0 : _field$extra$limit.min;
-  var max = field === null || field === void 0 ? void 0 : (_field$extra2 = field.extra) === null || _field$extra2 === void 0 ? void 0 : (_field$extra2$limit = _field$extra2.limit) === null || _field$extra2$limit === void 0 ? void 0 : _field$extra2$limit.max;
+const TEXT_LIMIT_VALIDATOR = (field) => {
+  const min = field?.extra?.limit?.min;
+  const max = field?.extra?.limit?.max;
   return {
-    name: 'text-limit-validator',
-    message: function message(v) {
+    name: "text-limit-validator",
+    message: (v) => {
       if (min || max) {
         if (v.value.length < min) {
-          var _field$extra3, _field$extra3$limit;
           return {
-            key: 'form.error.text.less_than',
-            context: {
-              min: field === null || field === void 0 ? void 0 : (_field$extra3 = field.extra) === null || _field$extra3 === void 0 ? void 0 : (_field$extra3$limit = _field$extra3.limit) === null || _field$extra3$limit === void 0 ? void 0 : _field$extra3$limit.min
-            }
+            key: "form.error.text.less_than",
+            context: { min: field?.extra?.limit?.min }
           };
         }
         if (v.value.length > max) {
-          var _field$extra4, _field$extra4$limit;
           return {
-            key: 'form.error.text.more_than',
-            context: {
-              max: field === null || field === void 0 ? void 0 : (_field$extra4 = field.extra) === null || _field$extra4 === void 0 ? void 0 : (_field$extra4$limit = _field$extra4.limit) === null || _field$extra4$limit === void 0 ? void 0 : _field$extra4$limit.max
-            }
+            key: "form.error.text.more_than",
+            context: { max: field?.extra?.limit?.max }
           };
         }
       }
     },
-    test: function test(value) {
+    test: (value) => {
       if (!value) {
         return true;
       }
       return validateText(value, min, max);
     }
   };
-};
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TEXT_LIMIT_VALIDATOR,
+  validateText
+});
+//# sourceMappingURL=text_limit.js.map

package/cjs/validators/utils/text_limit.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/validators/utils/text_limit.ts"],
+  "sourcesContent": ["import type { FieldSpec } from '@digigov/form/types';\nimport type { ValidatorSchema } from '@digigov/form/validators/types';\n\nexport function validateText(value: string, min: number, max: number): boolean {\n  let validator;\n  if (min || max) {\n    if (value.length < min || value.length > max) {\n      return (validator = false);\n    } else {\n      return (validator = true);\n    }\n  }\n  return validator;\n}\n\nexport const TEXT_LIMIT_VALIDATOR = (field: FieldSpec): ValidatorSchema => {\n  const min: number = field?.extra?.limit?.min;\n  const max: number = field?.extra?.limit?.max;\n  return {\n    name: 'text-limit-validator',\n    message: (v: any): any => {\n      if (min || max) {\n        if (v.value.length < min) {\n          return {\n            key: 'form.error.text.less_than',\n            context: { min: field?.extra?.limit?.min },\n          };\n        }\n        if (v.value.length > max) {\n          return {\n            key: 'form.error.text.more_than',\n            context: { max: field?.extra?.limit?.max },\n          };\n        }\n      }\n    },\n    test: (value: string): boolean => {\n      if (!value) {\n        return true;\n      }\n      return validateText(value, min as number, max as number);\n    },\n  };\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAGO,SAAS,aAAa,OAAe,KAAa,KAAsB;AAC7E,MAAI;AACJ,MAAI,OAAO,KAAK;AACd,QAAI,MAAM,SAAS,OAAO,MAAM,SAAS,KAAK;AAC5C,aAAQ,YAAY;AAAA,IACtB,OAAO;AACL,aAAQ,YAAY;AAAA,IACtB;AAAA,EACF;AACA,SAAO;AACT;AAEO,MAAM,uBAAuB,CAAC,UAAsC;AACzE,QAAM,MAAc,OAAO,OAAO,OAAO;AACzC,QAAM,MAAc,OAAO,OAAO,OAAO;AACzC,SAAO;AAAA,IACL,MAAM;AAAA,IACN,SAAS,CAAC,MAAgB;AACxB,UAAI,OAAO,KAAK;AACd,YAAI,EAAE,MAAM,SAAS,KAAK;AACxB,iBAAO;AAAA,YACL,KAAK;AAAA,YACL,SAAS,EAAE,KAAK,OAAO,OAAO,OAAO,IAAI;AAAA,UAC3C;AAAA,QACF;AACA,YAAI,EAAE,MAAM,SAAS,KAAK;AACxB,iBAAO;AAAA,YACL,KAAK;AAAA,YACL,SAAS,EAAE,KAAK,OAAO,OAAO,OAAO,IAAI;AAAA,UAC3C;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IACA,MAAM,CAAC,UAA2B;AAChC,UAAI,CAAC,OAAO;AACV,eAAO;AAAA,MACT;AACA,aAAO,aAAa,OAAO,KAAe,GAAa;AAAA,IACzD;AAAA,EACF;AACF;",
+  "names": []
+}

package/cjs/validators/utils/uuid4/index.js

@@ -1,25 +1,46 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var uuid4_exports = {};
+__export(uuid4_exports, {
+  UUID4_VALIDATOR: () => UUID4_VALIDATOR,
+  validateUUID4: () => validateUUID4
 });
-exports.UUID4_VALIDATOR = void 0;
-exports.validateUUID4 = validateUUID4;
-var UUID4_PATTERN = /^[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
+module.exports = __toCommonJS(uuid4_exports);
+const UUID4_PATTERN = /^[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;
 function validateUUID4(uuid4) {
   if (uuid4.length !== 36) {
-    // This uuid4 should be 36 characters long
     return false;
   }
   return UUID4_PATTERN.test(uuid4);
 }
-var UUID4_VALIDATOR = exports.UUID4_VALIDATOR = {
-  name: 'uuid4-validator',
-  message: 'form.error.uuid4',
-  test: function test(value) {
+const UUID4_VALIDATOR = {
+  name: "uuid4-validator",
+  message: "form.error.uuid4",
+  test: (value) => {
     if (value) {
       return validateUUID4(value);
     }
     return true;
   }
-};
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  UUID4_VALIDATOR,
+  validateUUID4
+});
+//# sourceMappingURL=uuid4.js.map

package/cjs/validators/utils/uuid4.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/validators/utils/uuid4.ts"],
+  "sourcesContent": ["const UUID4_PATTERN =\n  /^[0-9A-F]{8}-[0-9A-F]{4}-[4][0-9A-F]{3}-[89AB][0-9A-F]{3}-[0-9A-F]{12}$/i;\n\nexport function validateUUID4(uuid4: string): boolean {\n  if (uuid4.length !== 36) {\n    // This uuid4 should be 36 characters long\n    return false;\n  }\n\n  return UUID4_PATTERN.test(uuid4);\n}\n\nexport const UUID4_VALIDATOR = {\n  name: 'uuid4-validator',\n  message: 'form.error.uuid4',\n  test: (value): boolean => {\n    if (value) {\n      return validateUUID4(value);\n    }\n    return true;\n  },\n};\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAAM,gBACJ;AAEK,SAAS,cAAc,OAAwB;AACpD,MAAI,MAAM,WAAW,IAAI;AAEvB,WAAO;AAAA,EACT;AAEA,SAAO,cAAc,KAAK,KAAK;AACjC;AAEO,MAAM,kBAAkB;AAAA,EAC7B,MAAM;AAAA,EACN,SAAS;AAAA,EACT,MAAM,CAAC,UAAmB;AACxB,QAAI,OAAO;AACT,aAAO,cAAc,KAAK;AAAA,IAC5B;AACA,WAAO;AAAA,EACT;AACF;",
+  "names": []
+}

package/hooks/useFieldFocusManager/index.js

@@ -0,0 +1,116 @@
+import { useCallback, useEffect, useRef } from "react";
+import {
+  extractFieldEntries,
+  mapElementsToFields,
+  sortElementsByPosition
+} from "@digigov/form/hooks/utils";
+function useFieldFocusManager({
+  enabled = true,
+  control,
+  subscribe,
+  setFocus
+}) {
+  const customFocusableElements = useRef(/* @__PURE__ */ new Map());
+  const focusableElements = useRef(/* @__PURE__ */ new Map());
+  useEffect(() => {
+    if (!enabled) {
+      customFocusableElements.current.clear();
+      focusableElements.current.clear();
+      return;
+    }
+  }, [enabled]);
+  const updateFocusableElements = useCallback(() => {
+    focusableElements.current.clear();
+    const formElements = extractFieldEntries(control._fields);
+    const customFieldRefs = mapElementsToFields(
+      customFocusableElements.current
+    );
+    const customElements = extractFieldEntries(customFieldRefs);
+    const combinedElements = new Map(formElements);
+    customElements.forEach((element, fieldName) => {
+      combinedElements.set(fieldName, element);
+    });
+    focusableElements.current = sortElementsByPosition(combinedElements);
+  }, [control._fields]);
+  const registerCustomFocusableElement = useCallback(
+    (fieldName, element) => {
+      if (fieldName && element) {
+        customFocusableElements.current.set(fieldName, element);
+        updateFocusableElements();
+      }
+      return function unregister() {
+        customFocusableElements.current.delete(fieldName);
+        updateFocusableElements();
+      };
+    },
+    [updateFocusableElements]
+  );
+  useEffect(() => {
+    if (!enabled || !subscribe) return;
+    const callback = subscribe({
+      formState: {
+        errors: true
+        // Subscribe to any form state change that might indicate field structure changes
+      },
+      callback: () => {
+        setTimeout(updateFocusableElements, 0);
+      }
+    });
+    updateFocusableElements();
+    return () => callback();
+  }, [enabled, updateFocusableElements, subscribe]);
+  const focusOnError = useCallback(
+    (errors) => {
+      if (!enabled) return;
+      if (!errors || Object.keys(errors).length === 0) return;
+      for (const [fieldName, element] of Array.from(
+        focusableElements.current
+      )) {
+        if (hasFieldError(errors, fieldName)) {
+          if (element && typeof element.focus === "function") {
+            element.focus();
+            return;
+          } else if (element && element.name) {
+            setFocus(fieldName);
+            return;
+          }
+        }
+      }
+    },
+    [enabled, setFocus]
+  );
+  return {
+    /**
+     * Registers a custom focusable element with the given field name.
+     *
+     * Returns a callback function to unregister the element by field name.
+     *
+     * @param fieldName - The name of the field to associate with the element.
+     * @param element - The HTML element to register as focusable.
+     */
+    registerCustomFocusableElement,
+    focusOnError
+  };
+}
+function hasFieldError(errors, fieldName) {
+  if (!errors || typeof errors !== "object") return false;
+  if (errors[fieldName]) {
+    return true;
+  }
+  const keys = fieldName.split(/[.[\]]+/).filter(Boolean);
+  let current = errors;
+  for (const key of keys) {
+    if (current && typeof current === "object") {
+      current = current[key];
+    } else {
+      return false;
+    }
+  }
+  return !!current;
+}
+var useFieldFocusManager_default = useFieldFocusManager;
+export {
+  useFieldFocusManager_default as default,
+  useFieldFocusManager
+};
+//# sourceMappingURL=useFieldFocusManager.js.map

package/hooks/useFieldFocusManager/package.json

@@ -0,0 +1,6 @@
+{
+  "sideEffects": false,
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "main": "../../cjs/hooks/useFieldFocusManager/index.js"
+}

package/hooks/useFieldFocusManager.d.ts

@@ -0,0 +1,25 @@
+import type { Control, FieldValues, UseFormReturn } from 'react-hook-form';
+export interface UseFieldFocusManagerProps<T extends FieldValues> {
+    enabled?: boolean;
+    control: Control<T>;
+    subscribe: UseFormReturn['subscribe'];
+    setFocus: UseFormReturn['setFocus'];
+}
+/**
+ * Custom hook to manage focus on form fields.
+ *
+ * It collects all focusable elements from the form fields and sorts them according to their position in the DOM.
+ */
+export declare function useFieldFocusManager<T extends FieldValues>({ enabled, control, subscribe, setFocus, }: UseFieldFocusManagerProps<T>): {
+    /**
+     * Registers a custom focusable element with the given field name.
+     *
+     * Returns a callback function to unregister the element by field name.
+     *
+     * @param fieldName - The name of the field to associate with the element.
+     * @param element - The HTML element to register as focusable.
+     */
+    registerCustomFocusableElement: (fieldName: string, element: HTMLElement) => () => void;
+    focusOnError: (errors: Record<string, any>) => void;
+};
+export default useFieldFocusManager;

package/hooks/useFieldFocusManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/useFieldFocusManager.ts"],
+  "sourcesContent": ["import { useCallback, useEffect, useRef } from 'react';\nimport type { Control, FieldValues, Ref, UseFormReturn } from 'react-hook-form';\nimport {\n  extractFieldEntries,\n  mapElementsToFields,\n  sortElementsByPosition,\n} from '@digigov/form/hooks/utils';\n\nexport interface UseFieldFocusManagerProps<T extends FieldValues> {\n  enabled?: boolean;\n  control: Control<T>;\n  subscribe: UseFormReturn['subscribe'];\n  setFocus: UseFormReturn['setFocus'];\n}\n\n/**\n * Custom hook to manage focus on form fields.\n *\n * It collects all focusable elements from the form fields and sorts them according to their position in the DOM.\n */\nexport function useFieldFocusManager<T extends FieldValues>({\n  enabled = true,\n  control,\n  subscribe,\n  setFocus,\n}: UseFieldFocusManagerProps<T>) {\n  /** Array to hold any external focusable elements registered by the user */\n  const customFocusableElements = useRef(new Map<string, HTMLElement>());\n  /** Map to hold focusable elements by field name */\n  const focusableElements = useRef(new Map<string, Ref>());\n\n  // When disabled, clear custom focusable elements and focusable elements map\n  useEffect(() => {\n    if (!enabled) {\n      customFocusableElements.current.clear();\n      focusableElements.current.clear();\n      return;\n    }\n  }, [enabled]);\n\n  const updateFocusableElements = useCallback(() => {\n    // Clear existing focusable elements\n    focusableElements.current.clear();\n    // Extract from form fields\n    const formElements = extractFieldEntries(control._fields);\n    // Extract from custom elements (convert to FieldRefs format first)\n    const customFieldRefs = mapElementsToFields(\n      customFocusableElements.current\n    );\n    const customElements = extractFieldEntries(customFieldRefs);\n\n    // Combine both maps\n    const combinedElements = new Map(formElements);\n    customElements.forEach((element, fieldName) => {\n      combinedElements.set(fieldName, element);\n    });\n\n    // Sort once by DOM position\n    focusableElements.current = sortElementsByPosition(combinedElements);\n  }, [control._fields]);\n\n  // Register / unregister custom focusable elements\n  const registerCustomFocusableElement = useCallback(\n    (fieldName: string, element: HTMLElement) => {\n      if (fieldName && element) {\n        customFocusableElements.current.set(fieldName, element);\n        updateFocusableElements();\n      }\n\n      return function unregister() {\n        customFocusableElements.current.delete(fieldName);\n        updateFocusableElements();\n      };\n    },\n    [updateFocusableElements]\n  );\n\n  // Collect focusable elements when fields change\n  useEffect(() => {\n    if (!enabled || !subscribe) return;\n    const callback = subscribe({\n      formState: {\n        errors: true,\n        // Subscribe to any form state change that might indicate field structure changes\n      },\n      callback: () => {\n        // Defer to next tick to ensure DOM is updated\n        setTimeout(updateFocusableElements, 0);\n      },\n    });\n\n    // Initial update\n    updateFocusableElements();\n\n    return () => callback();\n  }, [enabled, updateFocusableElements, subscribe]);\n\n  // Subscribe to errors and focus the first field (according to the DOM) with an error\n  const focusOnError = useCallback(\n    (errors: Record<string, any>) => {\n      if (!enabled) return;\n      if (!errors || Object.keys(errors).length === 0) return;\n      for (const [fieldName, element] of Array.from(\n        focusableElements.current\n      )) {\n        if (hasFieldError(errors, fieldName)) {\n          if (element && typeof element.focus === 'function') {\n            element.focus(); // Focus the element directly\n            return;\n          } else if (element && element.name) {\n            setFocus(fieldName); // Field is registered with react-hook-form\n            return;\n          }\n        }\n      }\n    },\n    [enabled, setFocus]\n  );\n\n  return {\n    /**\n     * Registers a custom focusable element with the given field name.\n     *\n     * Returns a callback function to unregister the element by field name.\n     *\n     * @param fieldName - The name of the field to associate with the element.\n     * @param element - The HTML element to register as focusable.\n     */\n    registerCustomFocusableElement,\n    focusOnError,\n  };\n}\n\n// Helper function to check for nested field errors\nfunction hasFieldError(\n  errors: Record<string, any>,\n  fieldName: string\n): boolean {\n  if (!errors || typeof errors !== 'object') return false;\n\n  // Handle direct field names first\n  if (errors[fieldName]) {\n    return true;\n  }\n\n  // Split the field name and traverse the error object\n  const keys = fieldName.split(/[.[\\]]+/).filter(Boolean);\n  let current = errors;\n\n  for (const key of keys) {\n    if (current && typeof current === 'object') {\n      current = current[key];\n    } else {\n      return false;\n    }\n  }\n\n  // Check if we found a truthy error value\n  return !!current;\n}\n\nexport default useFieldFocusManager;\n"],
+  "mappings": "AAAA,SAAS,aAAa,WAAW,cAAc;AAE/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAcA,SAAS,qBAA4C;AAAA,EAC1D,UAAU;AAAA,EACV;AAAA,EACA;AAAA,EACA;AACF,GAAiC;AAE/B,QAAM,0BAA0B,OAAO,oBAAI,IAAyB,CAAC;AAErE,QAAM,oBAAoB,OAAO,oBAAI,IAAiB,CAAC;AAGvD,YAAU,MAAM;AACd,QAAI,CAAC,SAAS;AACZ,8BAAwB,QAAQ,MAAM;AACtC,wBAAkB,QAAQ,MAAM;AAChC;AAAA,IACF;AAAA,EACF,GAAG,CAAC,OAAO,CAAC;AAEZ,QAAM,0BAA0B,YAAY,MAAM;AAEhD,sBAAkB,QAAQ,MAAM;AAEhC,UAAM,eAAe,oBAAoB,QAAQ,OAAO;AAExD,UAAM,kBAAkB;AAAA,MACtB,wBAAwB;AAAA,IAC1B;AACA,UAAM,iBAAiB,oBAAoB,eAAe;AAG1D,UAAM,mBAAmB,IAAI,IAAI,YAAY;AAC7C,mBAAe,QAAQ,CAAC,SAAS,cAAc;AAC7C,uBAAiB,IAAI,WAAW,OAAO;AAAA,IACzC,CAAC;AAGD,sBAAkB,UAAU,uBAAuB,gBAAgB;AAAA,EACrE,GAAG,CAAC,QAAQ,OAAO,CAAC;AAGpB,QAAM,iCAAiC;AAAA,IACrC,CAAC,WAAmB,YAAyB;AAC3C,UAAI,aAAa,SAAS;AACxB,gCAAwB,QAAQ,IAAI,WAAW,OAAO;AACtD,gCAAwB;AAAA,MAC1B;AAEA,aAAO,SAAS,aAAa;AAC3B,gCAAwB,QAAQ,OAAO,SAAS;AAChD,gCAAwB;AAAA,MAC1B;AAAA,IACF;AAAA,IACA,CAAC,uBAAuB;AAAA,EAC1B;AAGA,YAAU,MAAM;AACd,QAAI,CAAC,WAAW,CAAC,UAAW;AAC5B,UAAM,WAAW,UAAU;AAAA,MACzB,WAAW;AAAA,QACT,QAAQ;AAAA;AAAA,MAEV;AAAA,MACA,UAAU,MAAM;AAEd,mBAAW,yBAAyB,CAAC;AAAA,MACvC;AAAA,IACF,CAAC;AAGD,4BAAwB;AAExB,WAAO,MAAM,SAAS;AAAA,EACxB,GAAG,CAAC,SAAS,yBAAyB,SAAS,CAAC;AAGhD,QAAM,eAAe;AAAA,IACnB,CAAC,WAAgC;AAC/B,UAAI,CAAC,QAAS;AACd,UAAI,CAAC,UAAU,OAAO,KAAK,MAAM,EAAE,WAAW,EAAG;AACjD,iBAAW,CAAC,WAAW,OAAO,KAAK,MAAM;AAAA,QACvC,kBAAkB;AAAA,MACpB,GAAG;AACD,YAAI,cAAc,QAAQ,SAAS,GAAG;AACpC,cAAI,WAAW,OAAO,QAAQ,UAAU,YAAY;AAClD,oBAAQ,MAAM;AACd;AAAA,UACF,WAAW,WAAW,QAAQ,MAAM;AAClC,qBAAS,SAAS;AAClB;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,IACA,CAAC,SAAS,QAAQ;AAAA,EACpB;AAEA,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASL;AAAA,IACA;AAAA,EACF;AACF;AAGA,SAAS,cACP,QACA,WACS;AACT,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAGlD,MAAI,OAAO,SAAS,GAAG;AACrB,WAAO;AAAA,EACT;AAGA,QAAM,OAAO,UAAU,MAAM,SAAS,EAAE,OAAO,OAAO;AACtD,MAAI,UAAU;AAEd,aAAW,OAAO,MAAM;AACtB,QAAI,WAAW,OAAO,YAAY,UAAU;AAC1C,gBAAU,QAAQ,GAAG;AAAA,IACvB,OAAO;AACL,aAAO;AAAA,IACT;AAAA,EACF;AAGA,SAAO,CAAC,CAAC;AACX;AAEA,IAAO,+BAAQ;",
+  "names": []
+}

package/hooks/utils/index.js

@@ -0,0 +1,73 @@
+function extractFieldEntries(fields, prefix = "") {
+  const elementMap = /* @__PURE__ */ new Map();
+  const fieldEntries = Object.entries(fields);
+  if (fieldEntries.length === 0) return elementMap;
+  Object.entries(fields).forEach(([fieldName, field]) => {
+    if (!field) return;
+    const fullFieldName = prefix ? `${prefix}.${fieldName}` : fieldName;
+    if (isField(field)) {
+      const element = field._f.ref;
+      if (element) {
+        elementMap.set(fullFieldName, element);
+      }
+    } else if (isFieldRefs(field)) {
+      const keys = Object.keys(field);
+      const numericKeys = keys.filter((key) => /^\d+$/.test(key));
+      const hasNumericKeys = numericKeys.length > 0;
+      if (hasNumericKeys) {
+        numericKeys.forEach((index) => {
+          const arrayItem = field[index];
+          if (arrayItem && isFieldRefs(arrayItem)) {
+            const nestedEntries = extractFieldEntries(
+              arrayItem,
+              `${fullFieldName}.${index}`
+            );
+            nestedEntries.forEach((element, fieldName2) => {
+              elementMap.set(fieldName2, element);
+            });
+          }
+        });
+      } else {
+        const nestedEntries = extractFieldEntries(field, fullFieldName);
+        nestedEntries.forEach((element, fieldName2) => {
+          elementMap.set(fieldName2, element);
+        });
+      }
+    }
+  });
+  return elementMap;
+}
+const isField = (fieldRef) => Boolean(
+  fieldRef && typeof fieldRef === "object" && "_f" in fieldRef && fieldRef._f && "ref" in fieldRef._f
+);
+const isFieldRefs = (fieldRef) => Boolean(fieldRef && typeof fieldRef === "object" && !isField(fieldRef));
+function sortElementsByPosition(elements) {
+  const sortedEntries = Array.from(elements.entries()).sort(([, a], [, b]) => {
+    if (isActualHTMLElement(a) && isActualHTMLElement(b)) {
+      const aPosition = a.compareDocumentPosition(b);
+      if (aPosition & Node.DOCUMENT_POSITION_FOLLOWING) return -1;
+      if (aPosition & Node.DOCUMENT_POSITION_PRECEDING) return 1;
+    }
+    return 0;
+  });
+  return new Map(sortedEntries);
+}
+const isActualHTMLElement = (ref) => ref instanceof HTMLElement && typeof ref.focus === "function";
+function mapElementsToFields(elements) {
+  const fields = {};
+  elements.forEach((element, fieldName) => {
+    fields[fieldName] = {
+      _f: {
+        ref: element,
+        name: fieldName
+      }
+    };
+  });
+  return fields;
+}
+export {
+  extractFieldEntries,
+  mapElementsToFields,
+  sortElementsByPosition
+};
+//# sourceMappingURL=utils.js.map

package/{Field → hooks}/utils/package.json

@@ -2,5 +2,5 @@
   "sideEffects": false,
   "module": "./index.js",
   "types": "./index.d.ts",
-  "main": "../../cjs/Field/utils/index.js"
+  "main": "../../cjs/hooks/utils/index.js"
 }

package/hooks/utils.d.ts

@@ -0,0 +1,18 @@
+import type { Field, FieldRefs, Ref } from 'react-hook-form';
+/**
+ * Recursively extracts field entries from nested form field structure.
+ * Handles both regular nested objects and array-like structures.
+ */
+export declare function extractFieldEntries(fields: FieldRefs, prefix?: string): Map<string, Ref>;
+/**
+ * Sorts a map of HTML elements by their position in the DOM.
+ * Elements appearing earlier in the document order come first.
+ */
+export declare function sortElementsByPosition(elements: Map<string, Ref>): Map<string, Ref>;
+/**
+ * Maps a collection of HTML elements to a FieldRefs structure.
+ *
+ * It's not a direct conversion, but rather a way to create a simple FieldRefs
+ * structure that can be used with React Hook Form.
+ */
+export declare function mapElementsToFields(elements: Map<string, HTMLElement>): Record<string, Field>;

package/hooks/utils.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/hooks/utils.ts"],
+  "sourcesContent": ["import type { Field, FieldRefs, Ref } from 'react-hook-form';\n\n/**\n * Recursively extracts field entries from nested form field structure.\n * Handles both regular nested objects and array-like structures.\n */\nexport function extractFieldEntries(\n  fields: FieldRefs,\n  prefix = ''\n): Map<string, Ref> {\n  const elementMap = new Map<string, Ref>();\n\n  const fieldEntries = Object.entries(fields);\n  if (fieldEntries.length === 0) return elementMap;\n\n  Object.entries(fields).forEach(([fieldName, field]) => {\n    if (!field) return;\n    const fullFieldName = prefix ? `${prefix}.${fieldName}` : fieldName;\n\n    // Handle direct field with ref\n    if (isField(field)) {\n      const element = field._f.ref;\n      if (element) {\n        elementMap.set(fullFieldName, element);\n      }\n    }\n\n    // Handle array fields (numeric keys indicate array indices)\n    else if (isFieldRefs(field)) {\n      // Check if any keys are numeric (indicating an array structure)\n      // Filter out non-numeric keys like '_f' which contains field metadata\n      const keys = Object.keys(field);\n      const numericKeys = keys.filter((key) => /^\\d+$/.test(key));\n      const hasNumericKeys = numericKeys.length > 0;\n\n      if (hasNumericKeys) {\n        // Process only the numeric array indices, ignore metadata keys like '_f'\n        numericKeys.forEach((index) => {\n          const arrayItem = field[index];\n          if (arrayItem && isFieldRefs(arrayItem)) {\n            const nestedEntries = extractFieldEntries(\n              arrayItem,\n              `${fullFieldName}.${index}`\n            );\n            // Merge nested entries into main map\n            nestedEntries.forEach((element, fieldName) => {\n              elementMap.set(fieldName, element);\n            });\n          }\n        });\n      } else {\n        // Handle regular nested objects\n        const nestedEntries = extractFieldEntries(field, fullFieldName);\n        // Merge nested entries into main map\n        nestedEntries.forEach((element, fieldName) => {\n          elementMap.set(fieldName, element);\n        });\n      }\n    }\n  });\n\n  return elementMap;\n}\n\n/** Type guard to check if a ref is a Field object */\nconst isField = (fieldRef: FieldRefs[keyof FieldRefs]): fieldRef is Field =>\n  Boolean(\n    fieldRef &&\n      typeof fieldRef === 'object' &&\n      '_f' in fieldRef &&\n      fieldRef._f &&\n      'ref' in fieldRef._f\n  );\n\n/** Type guard to check if a ref is a FieldRefs object (nested fields) */\nconst isFieldRefs = (\n  fieldRef: FieldRefs[keyof FieldRefs]\n): fieldRef is FieldRefs =>\n  Boolean(fieldRef && typeof fieldRef === 'object' && !isField(fieldRef));\n\n/**\n * Sorts a map of HTML elements by their position in the DOM.\n * Elements appearing earlier in the document order come first.\n */\nexport function sortElementsByPosition(\n  elements: Map<string, Ref>\n): Map<string, Ref> {\n  const sortedEntries = Array.from(elements.entries()).sort(([, a], [, b]) => {\n    if (isActualHTMLElement(a) && isActualHTMLElement(b)) {\n      const aPosition = a.compareDocumentPosition(b);\n      if (aPosition & Node.DOCUMENT_POSITION_FOLLOWING) return -1;\n      if (aPosition & Node.DOCUMENT_POSITION_PRECEDING) return 1;\n    }\n    return 0; // keep original order\n  });\n  return new Map(sortedEntries);\n}\n\n/** Type guard to check if a ref is an actual HTML element */\nconst isActualHTMLElement = (ref: Ref): ref is Ref & HTMLElement =>\n  ref instanceof HTMLElement && typeof ref.focus === 'function';\n\n/**\n * Maps a collection of HTML elements to a FieldRefs structure.\n *\n * It's not a direct conversion, but rather a way to create a simple FieldRefs\n * structure that can be used with React Hook Form.\n */\nexport function mapElementsToFields(\n  elements: Map<string, HTMLElement>\n): Record<string, Field> {\n  const fields = {};\n  elements.forEach((element, fieldName) => {\n    fields[fieldName] = {\n      _f: {\n        ref: element,\n        name: fieldName,\n      },\n    };\n  });\n  return fields;\n}\n"],
+  "mappings": "AAMO,SAAS,oBACd,QACA,SAAS,IACS;AAClB,QAAM,aAAa,oBAAI,IAAiB;AAExC,QAAM,eAAe,OAAO,QAAQ,MAAM;AAC1C,MAAI,aAAa,WAAW,EAAG,QAAO;AAEtC,SAAO,QAAQ,MAAM,EAAE,QAAQ,CAAC,CAAC,WAAW,KAAK,MAAM;AACrD,QAAI,CAAC,MAAO;AACZ,UAAM,gBAAgB,SAAS,GAAG,MAAM,IAAI,SAAS,KAAK;AAG1D,QAAI,QAAQ,KAAK,GAAG;AAClB,YAAM,UAAU,MAAM,GAAG;AACzB,UAAI,SAAS;AACX,mBAAW,IAAI,eAAe,OAAO;AAAA,MACvC;AAAA,IACF,WAGS,YAAY,KAAK,GAAG;AAG3B,YAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,YAAM,cAAc,KAAK,OAAO,CAAC,QAAQ,QAAQ,KAAK,GAAG,CAAC;AAC1D,YAAM,iBAAiB,YAAY,SAAS;AAE5C,UAAI,gBAAgB;AAElB,oBAAY,QAAQ,CAAC,UAAU;AAC7B,gBAAM,YAAY,MAAM,KAAK;AAC7B,cAAI,aAAa,YAAY,SAAS,GAAG;AACvC,kBAAM,gBAAgB;AAAA,cACpB;AAAA,cACA,GAAG,aAAa,IAAI,KAAK;AAAA,YAC3B;AAEA,0BAAc,QAAQ,CAAC,SAASA,eAAc;AAC5C,yBAAW,IAAIA,YAAW,OAAO;AAAA,YACnC,CAAC;AAAA,UACH;AAAA,QACF,CAAC;AAAA,MACH,OAAO;AAEL,cAAM,gBAAgB,oBAAoB,OAAO,aAAa;AAE9D,sBAAc,QAAQ,CAAC,SAASA,eAAc;AAC5C,qBAAW,IAAIA,YAAW,OAAO;AAAA,QACnC,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF,CAAC;AAED,SAAO;AACT;AAGA,MAAM,UAAU,CAAC,aACf;AAAA,EACE,YACE,OAAO,aAAa,YACpB,QAAQ,YACR,SAAS,MACT,SAAS,SAAS;AACtB;AAGF,MAAM,cAAc,CAClB,aAEA,QAAQ,YAAY,OAAO,aAAa,YAAY,CAAC,QAAQ,QAAQ,CAAC;AAMjE,SAAS,uBACd,UACkB;AAClB,QAAM,gBAAgB,MAAM,KAAK,SAAS,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM;AAC1E,QAAI,oBAAoB,CAAC,KAAK,oBAAoB,CAAC,GAAG;AACpD,YAAM,YAAY,EAAE,wBAAwB,CAAC;AAC7C,UAAI,YAAY,KAAK,4BAA6B,QAAO;AACzD,UAAI,YAAY,KAAK,4BAA6B,QAAO;AAAA,IAC3D;AACA,WAAO;AAAA,EACT,CAAC;AACD,SAAO,IAAI,IAAI,aAAa;AAC9B;AAGA,MAAM,sBAAsB,CAAC,QAC3B,eAAe,eAAe,OAAO,IAAI,UAAU;AAQ9C,SAAS,oBACd,UACuB;AACvB,QAAM,SAAS,CAAC;AAChB,WAAS,QAAQ,CAAC,SAAS,cAAc;AACvC,WAAO,SAAS,IAAI;AAAA,MAClB,IAAI;AAAA,QACF,KAAK;AAAA,QACL,MAAM;AAAA,MACR;AAAA,IACF;AAAA,EACF,CAAC;AACD,SAAO;AACT;",
+  "names": ["fieldName"]
+}

package/index.d.ts

@@ -1,3 +1,6 @@
-export * from '@digigov/form/internal';
+export { default as Field } from '@digigov/form/Field';
+export { default as Fieldset } from '@digigov/form/Fieldset';
+export * from '@digigov/form/inputs/Label';
 import FormBuilder from '@digigov/form/FormBuilder';
+export * from '@digigov/form/types';
 export default FormBuilder;

package/index.js

@@ -1,8 +1,17 @@
-/** @license Digigov v2.0.0-8de46296
+/** @license Digigov v2.0.0-a0ac149e
  *
  * This source code is licensed under the BSD-2-Clause license found in the
  * LICENSE file in the root directory of this source tree.
  */
-export * from '@digigov/form/internal';
-import FormBuilder from '@digigov/form/FormBuilder';
-export default FormBuilder;
+import { default as default2 } from "@digigov/form/Field";
+import { default as default3 } from "@digigov/form/Fieldset";
+export * from "@digigov/form/inputs/Label";
+import FormBuilder from "@digigov/form/FormBuilder";
+export * from "@digigov/form/types";
+var src_default = FormBuilder;
+export {
+  default2 as Field,
+  default3 as Fieldset,
+  src_default as default
+};
+//# sourceMappingURL=index.js.map

package/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/index.ts"],
+  "sourcesContent": ["export { default as Field } from '@digigov/form/Field';\nexport { default as Fieldset } from '@digigov/form/Fieldset';\nexport * from '@digigov/form/inputs/Label';\nimport FormBuilder from '@digigov/form/FormBuilder';\nexport * from '@digigov/form/types';\nexport default FormBuilder;\n"],
+  "mappings": "AAAA,SAAoB,WAAXA,gBAAwB;AACjC,SAAoB,WAAXA,gBAA2B;AACpC,cAAc;AACd,OAAO,iBAAiB;AACxB,cAAc;AACd,IAAO,cAAQ;",
+  "names": ["default"]
+}

package/inputs/AutoCompleteInput/AutoComplete.stories.d.ts

@@ -1,8 +1,11 @@
 declare namespace _default {
     export let title: string;
     export { AutoComplete as component };
+    export let tags: string[];
+    export { doc as markdown };
     export let displayName: string;
 }
 export default _default;
-export * from "@digigov/form/inputs/AutoCompleteInput/__stories__/Default";
+export { Default } from "@digigov/form/inputs/AutoCompleteInput/__stories__/Default";
+export { Multiple } from "@digigov/form/inputs/AutoCompleteInput/__stories__/Multiple";
 import AutoComplete from '@digigov/form/inputs/AutoCompleteInput';

package/inputs/AutoCompleteInput/__stories__/Default.d.ts

@@ -1,2 +1,3 @@
-/// <reference types="react" />
-export declare const Default: () => JSX.Element;
+import React from 'react';
+export declare const Default: (_: any) => React.JSX.Element;
+export default Default;

package/inputs/AutoCompleteInput/__stories__/Multiple.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+export declare const Multiple: (_: any) => React.JSX.Element;
+export default Multiple;

package/inputs/AutoCompleteInput/index.d.ts

@@ -1,14 +1,14 @@
 import React from 'react';
-import { ControlledFieldProps } from '@digigov/form/Field/types';
-import { FieldOptionProps } from '@digigov/form/inputs/Label';
-import { AutoCompleteProps as UIAutoCompleteProps } from '@digigov/ui/form/AutoComplete';
+import type { ControlledFieldProps } from '@digigov/form/Field/types';
+import type { FieldOptionProps } from '@digigov/form/inputs/Label';
+import type { AutoCompleteProps as UIAutoCompleteProps } from '@digigov/ui/form/AutoComplete';
 export interface AutoCompleteInputExtra extends Omit<UIAutoCompleteProps, 'source' | 'id' | 'templates' | 'defaultValue' | 'onConfirm' | 'dropdownArrow'> {
-    options: Array<FieldOptionProps>;
+    options: FieldOptionProps[];
 }
 export interface AutoCompleteInputProps extends Omit<ControlledFieldProps, 'value' | 'onChange' | 'extra'> {
     extra: AutoCompleteInputExtra;
     value: string;
-    onChange: (v: string) => void;
+    onChange: (v: string | string[] | undefined) => void;
 }
 export declare const AutoCompleteInput: React.FC<AutoCompleteInputProps>;
 export default AutoCompleteInput;