@envisiongroup/porygon 1.0.2 → 1.0.4

package/dist/react-components/forms/EFWForm/EFWForm.utils.d.ts

@@ -1,8 +1,33 @@
-import { EFWFormFieldUpdate, EFWFormFieldProps, GetFieldValue, ExtractFieldNames, EFWFormValues, EFWUpdateFieldFunction, EFWFieldLogicContext, GridTemplateColumnsType } from './EFWForm.types';
+import { EFWFormFieldUpdate, EFWFormFieldProps, GetFieldValue, ExtractFieldNames, EFWFormValues, EFWUpdateFieldFunction, EFWFieldLogicContext, EFWFormFieldType, EFWFormFieldValue, GridTemplateColumnsType } from './EFWForm.types';
 import { ValidationMessage, ValidationState } from '../../fields/_shared/EFWField/EFWField.types';
 import { EFWFormLocaleText } from '../../i18n';
 
 export declare const generateGridTemplateColumns: (config: GridTemplateColumnsType) => string;
+/**
+ * Devuelve un valor "vacío" normalizado FRESCO para un tipo de campo.
+ *
+ * Es la fuente única de verdad para el valor por defecto de un campo sin valor,
+ * compartida entre `EFWForm` (valor inicial de campos) y `EFWTable` (completado
+ * de items creados desde un formulario con un subconjunto de fields).
+ *
+ * Los tipos array (`Choice`, `MultiChoice`, `Date`, `Attachments`) devuelven
+ * SIEMPRE un array nuevo, de modo que dos llamadas (y por tanto dos items
+ * completados) no compartan la misma referencia. Esto evita que una mutación
+ * accidental en un item contamine a los demás.
+ *
+ * Coherente con `commons/valueNormalization`: texto vacío es `''`, arrays
+ * vacíos son `[]`, numérico es `null` y booleano es `false`.
+ */
+export declare const getEmptyValueForFieldType: (typeAsString: EFWFormFieldType) => EFWFormFieldValue;
+/**
+ * Snapshot congelado de los valores vacíos por tipo, solo de referencia/inspección.
+ *
+ * Los arrays internos están congelados para que mutarlos falle (modo estricto)
+ * o sea no-op (modo sloppy). **No usar este mapa como fuente de valores
+ * consumibles**: para obtener valores vacíos sin identidad compartida usar
+ * `getEmptyValueForFieldType`, que devuelve arrays frescos en cada llamada.
+ */
+export declare const EMPTY_VALUE_BY_FIELD_TYPE: Readonly<Record<EFWFormFieldType, EFWFormFieldValue>>;
 declare const EFWFormFieldWrapperInner: <T extends readonly EFWFormFieldProps[]>({ field, initialValue, onValueChange, registerUpdateProps, unregisterUpdateProps, getFieldLogicByName, isControlled, getAllValues, updateFieldProps, localeText, onValidationChange, }: {
     field: T[number];
     initialValue: GetFieldValue<T, T[number]["internalName"]>;

package/dist/react-components/forms/EFWForm/EFWForm.utils.js

@@ -1,15 +1,15 @@
 import { jsx as s } from "react/jsx-runtime";
-import { memo as H, useRef as B, useState as k, useCallback as R, useEffect as z, useMemo as J } from "react";
-import { useIsomorphicLayoutEffect as K } from "../../hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.js";
-import { normalizeArrayValue as T } from "../../commons/valueNormalization.js";
-import { EFWInputField as Q } from "../../fields/Input/EFWInputField.js";
-import { EFWNumberInputField as X } from "../../fields/NumberInput/EFWNumberInputField.js";
-import { EFWTextAreaField as Y } from "../../fields/TextArea/EFWTextAreaField.js";
-import { EFWSwitchField as Z } from "../../fields/Switch/EFWSwitchField.js";
-import { EFWTagPickerField as _ } from "../../fields/TagPicker/EFWTagPickerField.js";
+import { memo as $, useRef as W, useState as B, useCallback as R, useEffect as j, useMemo as Y } from "react";
+import { useIsomorphicLayoutEffect as H } from "../../hooks/useIsomorphicLayoutEffect/useIsomorphicLayoutEffect.js";
+import { normalizeArrayValue as D } from "../../commons/valueNormalization.js";
+import { EFWInputField as J } from "../../fields/Input/EFWInputField.js";
+import { EFWNumberInputField as K } from "../../fields/NumberInput/EFWNumberInputField.js";
+import { EFWTextAreaField as Q } from "../../fields/TextArea/EFWTextAreaField.js";
+import { EFWSwitchField as X } from "../../fields/Switch/EFWSwitchField.js";
+import { EFWTagPickerField as Z } from "../../fields/TagPicker/EFWTagPickerField.js";
 import { EFWDatePickerField as U } from "../../fields/DatePicker/EFWDatePickerField.js";
 import { EFWAttachmentsField as p } from "../../fields/Attachments/EFWAttachmentsField.js";
-const Fe = (t) => {
+const Se = (t) => {
   if (typeof t == "number")
     return t > 1 ? `repeat(${t}, 1fr)` : "1fr";
   if (typeof t == "string")
@@ -19,68 +19,94 @@ const Fe = (t) => {
     return n ? `repeat(auto-fit, minmax(clamp(${e}, 100% / ${n + 1}, 100% / 1), 1fr))` : `repeat(auto-fit, minmax(${e}, 1fr))`;
   }
   return "1fr";
-}, ee = ({
+}, fe = (t) => {
+  switch (t) {
+    case "Text":
+    case "Note":
+      return "";
+    case "Number":
+      return null;
+    case "Boolean":
+      return !1;
+    case "Choice":
+    case "MultiChoice":
+    case "Date":
+    case "Attachments":
+      return [];
+    default:
+      return "";
+  }
+}, Me = Object.freeze({
+  Text: "",
+  Number: null,
+  Note: "",
+  Choice: Object.freeze([]),
+  Date: Object.freeze([]),
+  Boolean: !1,
+  Attachments: Object.freeze([]),
+  MultiChoice: Object.freeze([])
+}), ee = ({
   field: t,
   initialValue: e,
   onValueChange: n,
   registerUpdateProps: i,
   unregisterUpdateProps: l,
   getFieldLogicByName: r,
-  isControlled: j,
-  getAllValues: x,
-  updateFieldProps: q,
+  isControlled: k,
+  getAllValues: T,
+  updateFieldProps: C,
   localeText: G,
   onValidationChange: L
 }) => {
-  const d = t.internalName, F = B(e), [c, C] = k(() => F.current), f = !!j, [I, P] = k(
+  const d = t.internalName, S = W(e), [c, q] = B(() => S.current), f = !!k, [I, P] = B(
     {}
-  ), N = B({
+  ), N = W({
     editable: t.editable,
     disabled: t.disabled,
     hidden: t.hidden,
     required: t.required
   }), m = R(
     (a) => {
-      C(a), F.current = a;
+      q(a), S.current = a;
     },
     []
   );
-  z(() => {
-    f || (C(e), F.current = e);
+  j(() => {
+    f || (q(e), S.current = e);
   }, [e, f]);
   const u = R(
     (a) => {
-      const v = F.current;
+      const v = S.current;
       m(a), n(d, a, { silent: !0 });
       const y = r?.(d);
-      let S = a;
+      let F = a;
       if (y) {
-        const M = x();
-        y(a, q, {
+        const M = T();
+        y(a, C, {
           allValues: M,
           trigger: "change",
           fieldName: d,
           previousValue: v,
           isControlled: f
-        }), S = x()[d];
+        }), F = T()[d];
       }
-      n(d, S);
+      n(d, F);
     },
     [
       m,
       r,
-      x,
+      T,
       d,
       f,
       n,
-      q
+      C
     ]
   ), b = R(
     (a) => {
       L?.(d, a);
     },
     [d, L]
-  ), A = R(
+  ), x = R(
     (a) => {
       P((v) => ({ ...v, ...a })), "value" in a ? m(
         a.value
@@ -94,16 +120,16 @@ const Fe = (t) => {
     },
     [m]
   );
-  K(() => (i(d, A), () => {
-    l(d, A);
-  }), [d, i, l, A]), z(() => {
-    const a = N.current, v = a.editable !== t.editable, y = a.disabled !== t.disabled, S = a.hidden !== t.hidden, M = a.required !== t.required;
-    !v && !y && !S && !M || (P((w) => {
-      let E = !1;
-      const D = { ...w }, O = (V, W) => {
-        V && W in D && (delete D[W], E = !0);
+  H(() => (i(d, x), () => {
+    l(d, x);
+  }), [d, i, l, x]), j(() => {
+    const a = N.current, v = a.editable !== t.editable, y = a.disabled !== t.disabled, F = a.hidden !== t.hidden, M = a.required !== t.required;
+    !v && !y && !F && !M || (P((E) => {
+      let w = !1;
+      const A = { ...E }, O = (_, z) => {
+        _ && z in A && (delete A[z], w = !0);
       };
-      return O(v, "editable"), O(y, "disabled"), O(S, "hidden"), O(M, "required"), E ? D : w;
+      return O(v, "editable"), O(y, "disabled"), O(F, "hidden"), O(M, "required"), w ? A : E;
     }), N.current = {
       editable: t.editable,
       disabled: t.disabled,
@@ -111,7 +137,7 @@ const Fe = (t) => {
       required: t.required
     });
   }, [t.editable, t.disabled, t.hidden, t.required]);
-  const g = J(
+  const h = Y(
     () => ({
       ...t,
       ...I
@@ -120,13 +146,13 @@ const Fe = (t) => {
   );
   if (t.typeAsString === "Text")
     return /* @__PURE__ */ s(
-      Q,
+      J,
       {
         "data-field-internalname": t.internalName,
         "data-field-typeasstring": t.typeAsString,
         ...te(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -135,13 +161,13 @@ const Fe = (t) => {
     );
   if (t.typeAsString === "Number")
     return /* @__PURE__ */ s(
-      X,
+      K,
       {
         "data-field-internalname": t.internalName,
         "data-field-typeasstring": t.typeAsString,
         ...ae(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -150,13 +176,13 @@ const Fe = (t) => {
     );
   if (t.typeAsString === "Note")
     return /* @__PURE__ */ s(
-      Y,
+      Q,
       {
         "data-field-internalname": t.internalName,
         "data-field-typeasstring": t.typeAsString,
         ...ne(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -165,13 +191,13 @@ const Fe = (t) => {
     );
   if (t.typeAsString === "Boolean")
     return /* @__PURE__ */ s(
-      Z,
+      X,
       {
         "data-field-internalname": t.internalName,
         "data-field-typeasstring": t.typeAsString,
         ...de(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -180,13 +206,13 @@ const Fe = (t) => {
     );
   if (t.typeAsString === "Choice" || t.typeAsString === "MultiChoice")
     return /* @__PURE__ */ s(
-      _,
+      Z,
       {
         "data-field-internalname": t.internalName,
         "data-field-typeasstring": t.typeAsString,
         ...ie(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -201,7 +227,7 @@ const Fe = (t) => {
         "data-field-typeasstring": t.typeAsString,
         ...le(
           t,
-          g,
+          h,
           c,
           u,
           b
@@ -216,16 +242,16 @@ const Fe = (t) => {
         "data-field-typeasstring": t.typeAsString,
         ...re(
           t,
-          g,
+          h,
           c,
           u,
           b
         )
       }
     );
-  const $ = t.typeAsString ?? "unknown";
-  return /* @__PURE__ */ s("div", { children: G.unsupportedFieldType(String($)) });
-}, fe = H(
+  const V = t.typeAsString ?? "unknown";
+  return /* @__PURE__ */ s("div", { children: G.unsupportedFieldType(String(V)) });
+}, Oe = $(
   ee
 ), o = (t, e) => {
   if (!t) return e;
@@ -239,7 +265,7 @@ const Fe = (t) => {
       break;
     }
   return i ? { ...t, ...e } : t;
-}, h = (t, e) => "validationMessageIcon" in e ? e.validationMessageIcon : t.validationMessageIcon, te = (t, e, n, i, l) => ({
+}, g = (t, e) => "validationMessageIcon" in e ? e.validationMessageIcon : t.validationMessageIcon, te = (t, e, n, i, l) => ({
   title: e.title || t.title,
   type: e.type ?? "text",
   formatType: e.formatType,
@@ -260,7 +286,7 @@ const Fe = (t) => {
   disabled: e.disabled || !1,
   validationState: e.validationState || "none",
   validationMessage: e.validationMessage || "",
-  validationMessageIcon: h(t, e),
+  validationMessageIcon: g(t, e),
   formatFunction: e.formatFunction,
   labels: o(t.labels, e.labels),
   readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer,
@@ -291,7 +317,7 @@ const Fe = (t) => {
   disabled: e.disabled || !1,
   validationState: e.validationState || "none",
   validationMessage: e.validationMessage || "",
-  validationMessageIcon: h(t, e),
+  validationMessageIcon: g(t, e),
   labels: o(t.labels, e.labels),
   readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer,
   validationMessages: o(
@@ -314,7 +340,7 @@ const Fe = (t) => {
     disabled: e.disabled || !1,
     validationState: e.validationState || "none",
     validationMessage: e.validationMessage || "",
-    validationMessageIcon: h(t, e),
+    validationMessageIcon: g(t, e),
     formatFunction: e.formatFunction,
     labels: o(t.labels, e.labels),
     readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer,
@@ -324,7 +350,7 @@ const Fe = (t) => {
     )
   };
 }, ie = (t, e, n, i, l) => {
-  const r = T(
+  const r = D(
     n ?? e.selectedOptions ?? t.selectedOptions
   );
   return {
@@ -340,15 +366,16 @@ const Fe = (t) => {
     disabled: e.disabled || !1,
     validationState: e.validationState || "none",
     validationMessage: e.validationMessage || "",
-    validationMessageIcon: h(t, e),
+    validationMessageIcon: g(t, e),
     multiple: e.multiple ?? t.multiple,
     options: e.options ?? t.options ?? [],
+    renderOptionMedia: e.renderOptionMedia !== void 0 ? e.renderOptionMedia : t.renderOptionMedia,
     selectedOptions: r,
     beforeRenderOptions: e.beforeRenderOptions ?? t.beforeRenderOptions,
     readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer
   };
 }, le = (t, e, n, i, l) => {
-  const r = T(
+  const r = D(
     n ?? e.selectedDates ?? t.selectedDates
   );
   return {
@@ -364,7 +391,7 @@ const Fe = (t) => {
     disabled: e.disabled || !1,
     validationState: e.validationState || "none",
     validationMessage: e.validationMessage || "",
-    validationMessageIcon: h(t, e),
+    validationMessageIcon: g(t, e),
     selectedDates: r,
     localizedStrings: e.localizedStrings ?? t.localizedStrings,
     allowTextInput: e.allowTextInput ?? t.allowTextInput,
@@ -382,7 +409,7 @@ const Fe = (t) => {
     readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer
   };
 }, re = (t, e, n, i, l) => {
-  const r = T(n ?? e.files);
+  const r = D(n ?? e.files);
   return {
     title: e.title || t.title,
     onChange: i,
@@ -395,7 +422,7 @@ const Fe = (t) => {
     disabled: e.disabled || !1,
     validationState: e.validationState || "none",
     validationMessage: e.validationMessage || "",
-    validationMessageIcon: h(t, e),
+    validationMessageIcon: g(t, e),
     files: r,
     multiple: e.multiple ?? t.multiple,
     acceptedTypes: e.acceptedTypes ?? t.acceptedTypes,
@@ -418,10 +445,12 @@ const Fe = (t) => {
   disabled: e.disabled || !1,
   validationState: e.validationState || "none",
   validationMessage: e.validationMessage || "",
-  validationMessageIcon: h(t, e),
+  validationMessageIcon: g(t, e),
   readOnlyRenderer: e.readOnlyRenderer ?? t.readOnlyRenderer
 });
 export {
-  fe as EFWFormFieldWrapper,
-  Fe as generateGridTemplateColumns
+  Oe as EFWFormFieldWrapper,
+  Me as EMPTY_VALUE_BY_FIELD_TYPE,
+  Se as generateGridTemplateColumns,
+  fe as getEmptyValueForFieldType
 };

package/dist/react-components/forms/EFWForm/index.d.ts

@@ -1,7 +1,8 @@
-export type { EFWFieldLogic, EFWFormProps, EFWFormValues, EFWFormFieldValue, EFWFormFieldProps, EFWFormMethods, EFWFormRef, EFWFormFieldUpdate, EFWFormFieldType, EFWFieldLogicContext, EFWFieldLogicTrigger, EFWUpdateFieldFunction, EFWFormFieldAnimationConfig } from './EFWForm.types';
+export type { EFWFieldLogic, EFWFormProps, EFWFormValues, EFWFormFieldValue, EFWFormFieldProps, EFWFormMethods, EFWFormRef, EFWFormFieldUpdate, EFWFormFieldType, EFWFieldLogicContext, EFWFieldLogicTrigger, EFWUpdateFieldFunction, EFWFormFieldAnimationConfig, } from './EFWForm.types';
 export type { EFWFormLocaleText } from '../../i18n';
 export { getFormFieldDisplayText } from './EFWForm.converter';
+export { getEmptyValueForFieldType, EMPTY_VALUE_BY_FIELD_TYPE, } from './EFWForm.utils';
 export { useFormController } from './EFWForm.hooks';
 export { EFWForm } from './EFWForm';
-export { flatToEFWValues, EFWValuesToFlat, EFWConversionError } from './EFWForm.flatConverter';
-export type { FlatValues, FlatValueOfField, FlatToEFWOptions, EFWToFlatOptions, EFWConversionErrorCode, DateSerializeFunction } from './EFWForm.flatConverter';
+export { flatToEFWValues, EFWValuesToFlat, EFWConversionError, } from './EFWForm.flatConverter';
+export type { FlatValues, FlatValueOfField, FlatToEFWOptions, EFWToFlatOptions, EFWConversionErrorCode, DateSerializeFunction, } from './EFWForm.flatConverter';

package/dist/react-components/forms/EFWForm/index.js

@@ -1,12 +1,15 @@
 import { getFormFieldDisplayText as e } from "./EFWForm.converter.js";
-import { useFormController as F } from "./EFWForm.hooks.js";
-import { EFWForm as m } from "./EFWForm.js";
-import { EFWConversionError as f, EFWValuesToFlat as p, flatToEFWValues as s } from "./EFWForm.flatConverter.js";
+import { EMPTY_VALUE_BY_FIELD_TYPE as F, getEmptyValueForFieldType as l } from "./EFWForm.utils.js";
+import { useFormController as m } from "./EFWForm.hooks.js";
+import { EFWForm as a } from "./EFWForm.js";
+import { EFWConversionError as x, EFWValuesToFlat as T, flatToEFWValues as s } from "./EFWForm.flatConverter.js";
 export {
-  f as EFWConversionError,
-  m as EFWForm,
-  p as EFWValuesToFlat,
+  x as EFWConversionError,
+  a as EFWForm,
+  T as EFWValuesToFlat,
+  F as EMPTY_VALUE_BY_FIELD_TYPE,
   s as flatToEFWValues,
+  l as getEmptyValueForFieldType,
   e as getFormFieldDisplayText,
-  F as useFormController
+  m as useFormController
 };