@envisiongroup/porygon 1.0.0-rc.40 → 1.0.0-rc.41

package/dist/index.js

@@ -1,17 +1,17 @@
-import { formatFileSize as o, getErrorMessage as t, getFileIconUrl as m } from "./react-components/commons/utils.js";
+import { formatFileSize as o, getErrorMessage as t, getFileIconUrl as F } from "./react-components/commons/utils.js";
 import { EFWMessageBarManager as a } from "./react-components/forms/EFWMessageBarManager/EFWMessageBarManager.js";
-import { EFWButton as E } from "./react-components/buttons/EFWButton/EFWButton.js";
-import { useEFWButton as f } from "./react-components/buttons/EFWButton/EFWButton.hooks.js";
+import { EFWButton as p } from "./react-components/buttons/EFWButton/EFWButton.js";
+import { useEFWButton as l } from "./react-components/buttons/EFWButton/EFWButton.hooks.js";
 import { EFWDrawerButton as u } from "./react-components/buttons/EFWDrawerButton/EFWDrawerButton.js";
 import { EFWGroupButton as i } from "./react-components/buttons/EFWGroupButton/EFWGroupButton.js";
-import { EFWField as W } from "./react-components/fields/_shared/EFWField/EFWField.js";
+import { EFWField as L } from "./react-components/fields/_shared/EFWField/EFWField.js";
 import { EFWAttachment as s } from "./react-components/fields/Attachments/EFWAttachments.js";
 import { getAttachmentsFormattedValue as g } from "./react-components/fields/Attachments/EFWAttachments.utils.js";
 import { EFWAttachmentsField as d } from "./react-components/fields/Attachments/EFWAttachmentsField.js";
 import { EFWDatePicker as O } from "./react-components/fields/DatePicker/EFWDatePicker.js";
-import { enLocalizedStrings as D, esLocalizedStrings as B, getDatePickerFormattedValue as S, ptLocalizedStrings as C } from "./react-components/fields/DatePicker/EFWDatePicker.utils.js";
+import { enLocalizedStrings as D, esLocalizedStrings as B, getDatePickerFormattedValue as C, ptLocalizedStrings as S } from "./react-components/fields/DatePicker/EFWDatePicker.utils.js";
 import { EFWDatePickerField as N } from "./react-components/fields/DatePicker/EFWDatePickerField.js";
-import { EFWInput as V } from "./react-components/fields/Input/EFWInput.js";
+import { EFWInput as b } from "./react-components/fields/Input/EFWInput.js";
 import { getInputFormattedValue as k } from "./react-components/fields/Input/EFWInput.utils.js";
 import { EFWInputField as R } from "./react-components/fields/Input/EFWInputField.js";
 import { EFWNumberInput as w } from "./react-components/fields/NumberInput/EFWNumberInput.js";
@@ -24,76 +24,80 @@ import { EFWTagPicker as Q } from "./react-components/fields/TagPicker/EFWTagPic
 import { getTagPickerFormattedValue as $ } from "./react-components/fields/TagPicker/EFWTagPicker.utils.js";
 import { EFWTagPickerField as re } from "./react-components/fields/TagPicker/EFWTagPickerField.js";
 import { EFWTextArea as te } from "./react-components/fields/TextArea/EFWTextArea.js";
-import { getTextAreaFormattedValue as Fe } from "./react-components/fields/TextArea/EFWTextArea.utils.js";
-import { EFWTextAreaField as pe } from "./react-components/fields/TextArea/EFWTextAreaField.js";
+import { getTextAreaFormattedValue as me } from "./react-components/fields/TextArea/EFWTextArea.utils.js";
+import { EFWTextAreaField as Ee } from "./react-components/fields/TextArea/EFWTextAreaField.js";
 import { getFormFieldDisplayText as xe } from "./react-components/forms/EFWForm/EFWForm.converter.js";
-import { useFormController as le } from "./react-components/forms/EFWForm/EFWForm.hooks.js";
+import { useFormController as fe } from "./react-components/forms/EFWForm/EFWForm.hooks.js";
 import { EFWForm as Te } from "./react-components/forms/EFWForm/EFWForm.js";
-import { EFWFormMessageBarGroup as Le } from "./react-components/forms/EFWFormMessageBarGroup/EFWFormMessageBarGroup.js";
-import { useDrawer as ne } from "./react-components/hooks/useDrawer/useDrawer.js";
-import { PorygonI18nProvider as _e, useButtonsLocaleText as ge, useFieldsLocaleText as ce, useFormLocaleText as de, usePorygonLocaleText as Ae, useTableLocaleText as Oe } from "./react-components/i18n/PorygonI18nProvider.js";
-import { DEFAULT_EFW_BUTTONS_LOCALE_TEXT as De, DEFAULT_EFW_FIELDS_LOCALE_TEXT as Be, DEFAULT_EFW_FORM_LOCALE_TEXT as Se, DEFAULT_EFW_TABLE_LOCALE_TEXT as Ce } from "./react-components/i18n/defaultLocaleText.js";
-import { PORYGON_LOCALES as Ne, PORYGON_LOCALE_EN as be, PORYGON_LOCALE_ES as Ve, PORYGON_LOCALE_PT_BR as he } from "./react-components/i18n/localePresets.js";
-import { EFWTable as Ge } from "./react-components/tables/EFWTable/EFWTable.js";
-import { useTableController as Ue } from "./react-components/tables/EFWTable/hooks/useTableController/useTableController.js";
-import { useDefaultFilterButton as ye } from "./react-components/tables/EFWTable/hooks/useDefaultFilterButton/useDefaultFilterButton.js";
-import { EFWTableEmpty as ze, EFWTableOverlay as Xe } from "./react-components/tables/EFWTable/components/EFWTableOverlay/EFWTableOverlay.js";
+import { EFWConversionError as We, EFWValuesToFlat as Le, flatToEFWValues as ne } from "./react-components/forms/EFWForm/EFWForm.flatConverter.js";
+import { EFWFormMessageBarGroup as _e } from "./react-components/forms/EFWFormMessageBarGroup/EFWFormMessageBarGroup.js";
+import { useDrawer as ce } from "./react-components/hooks/useDrawer/useDrawer.js";
+import { PorygonI18nProvider as Ae, useButtonsLocaleText as Oe, useFieldsLocaleText as Pe, useFormLocaleText as De, usePorygonLocaleText as Be, useTableLocaleText as Ce } from "./react-components/i18n/PorygonI18nProvider.js";
+import { DEFAULT_EFW_BUTTONS_LOCALE_TEXT as Ie, DEFAULT_EFW_FIELDS_LOCALE_TEXT as Ne, DEFAULT_EFW_FORM_LOCALE_TEXT as Ve, DEFAULT_EFW_TABLE_LOCALE_TEXT as be } from "./react-components/i18n/defaultLocaleText.js";
+import { PORYGON_LOCALES as ke, PORYGON_LOCALE_EN as Ge, PORYGON_LOCALE_ES as Re, PORYGON_LOCALE_PT_BR as Ue } from "./react-components/i18n/localePresets.js";
+import { EFWTable as ye } from "./react-components/tables/EFWTable/EFWTable.js";
+import { useTableController as ze } from "./react-components/tables/EFWTable/hooks/useTableController/useTableController.js";
+import { useDefaultFilterButton as Ye } from "./react-components/tables/EFWTable/hooks/useDefaultFilterButton/useDefaultFilterButton.js";
+import { EFWTableEmpty as je, EFWTableOverlay as qe } from "./react-components/tables/EFWTable/components/EFWTableOverlay/EFWTableOverlay.js";
 export {
-  De as DEFAULT_EFW_BUTTONS_LOCALE_TEXT,
-  Be as DEFAULT_EFW_FIELDS_LOCALE_TEXT,
-  Se as DEFAULT_EFW_FORM_LOCALE_TEXT,
-  Ce as DEFAULT_EFW_TABLE_LOCALE_TEXT,
+  Ie as DEFAULT_EFW_BUTTONS_LOCALE_TEXT,
+  Ne as DEFAULT_EFW_FIELDS_LOCALE_TEXT,
+  Ve as DEFAULT_EFW_FORM_LOCALE_TEXT,
+  be as DEFAULT_EFW_TABLE_LOCALE_TEXT,
   s as EFWAttachment,
   d as EFWAttachmentsField,
-  E as EFWButton,
+  p as EFWButton,
+  We as EFWConversionError,
   O as EFWDatePicker,
   N as EFWDatePickerField,
   u as EFWDrawerButton,
-  W as EFWField,
+  L as EFWField,
   Te as EFWForm,
-  Le as EFWFormMessageBarGroup,
+  _e as EFWFormMessageBarGroup,
   i as EFWGroupButton,
-  V as EFWInput,
+  b as EFWInput,
   R as EFWInputField,
   a as EFWMessageBarManager,
   w as EFWNumberInput,
   X as EFWNumberInputField,
   v as EFWSwitch,
   J as EFWSwitchField,
-  Ge as EFWTable,
-  ze as EFWTableEmpty,
-  Xe as EFWTableOverlay,
+  ye as EFWTable,
+  je as EFWTableEmpty,
+  qe as EFWTableOverlay,
   Q as EFWTagPicker,
   re as EFWTagPickerField,
   te as EFWTextArea,
-  pe as EFWTextAreaField,
-  Ne as PORYGON_LOCALES,
-  be as PORYGON_LOCALE_EN,
-  Ve as PORYGON_LOCALE_ES,
-  he as PORYGON_LOCALE_PT_BR,
-  _e as PorygonI18nProvider,
+  Ee as EFWTextAreaField,
+  Le as EFWValuesToFlat,
+  ke as PORYGON_LOCALES,
+  Ge as PORYGON_LOCALE_EN,
+  Re as PORYGON_LOCALE_ES,
+  Ue as PORYGON_LOCALE_PT_BR,
+  Ae as PorygonI18nProvider,
   D as enLocalizedStrings,
   B as esLocalizedStrings,
+  ne as flatToEFWValues,
   o as formatFileSize,
   g as getAttachmentsFormattedValue,
-  S as getDatePickerFormattedValue,
+  C as getDatePickerFormattedValue,
   t as getErrorMessage,
-  m as getFileIconUrl,
+  F as getFileIconUrl,
   xe as getFormFieldDisplayText,
   k as getInputFormattedValue,
   M as getNumberInputFormattedValue,
   q as getSwitchFormattedValue,
   $ as getTagPickerFormattedValue,
-  Fe as getTextAreaFormattedValue,
-  C as ptLocalizedStrings,
-  ge as useButtonsLocaleText,
-  ye as useDefaultFilterButton,
-  ne as useDrawer,
-  f as useEFWButton,
-  ce as useFieldsLocaleText,
-  le as useFormController,
-  de as useFormLocaleText,
-  Ae as usePorygonLocaleText,
-  Ue as useTableController,
-  Oe as useTableLocaleText
+  me as getTextAreaFormattedValue,
+  S as ptLocalizedStrings,
+  Oe as useButtonsLocaleText,
+  Ye as useDefaultFilterButton,
+  ce as useDrawer,
+  l as useEFWButton,
+  Pe as useFieldsLocaleText,
+  fe as useFormController,
+  De as useFormLocaleText,
+  Be as usePorygonLocaleText,
+  ze as useTableController,
+  Ce as useTableLocaleText
 };

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

@@ -0,0 +1,130 @@
+import { EFWAttachmentsValue } from '../../fields/Attachments';
+import { EFWFormFieldProps, EFWFormValues, EFWFormDatePickerFieldProps } from './EFWForm.types';
+
+/**
+ * Tipo derivado del array de fields que describe el shape "plano" natural
+ * para el consumer: primitivos, booleanos o arrays simples por field.
+ *
+ * Mapping por `typeAsString`:
+ * - `Text` / `Note` / `Choice` / `Date`     → `string`
+ * - `Number`                                 → `number`
+ * - `Boolean`                                → `boolean`
+ * - `MultiChoice`                            → `readonly string[]`
+ * - `Attachments`                            → `readonly EFWAttachmentsValue[]`
+ *
+ * Para `Choice` plano se usa la `key` del item seleccionado y para `MultiChoice`
+ * un array de `key`s, ya que `key` es el identificador estable.
+ */
+export type FlatValues<F extends readonly EFWFormFieldProps[] = EFWFormFieldProps[]> = {
+    [K in F[number] as K['internalName']]?: FlatValueOfField<K>;
+};
+export type FlatValueOfField<P extends EFWFormFieldProps> = P['typeAsString'] extends 'Text' ? string : P['typeAsString'] extends 'Number' ? number : P['typeAsString'] extends 'Note' ? string : P['typeAsString'] extends 'Boolean' ? boolean : P['typeAsString'] extends 'Choice' ? string : P['typeAsString'] extends 'MultiChoice' ? readonly string[] : P['typeAsString'] extends 'Date' ? string : P['typeAsString'] extends 'Attachments' ? readonly EFWAttachmentsValue[] : never;
+/**
+ * Función personalizada para serializar un valor de fecha al ir de EFW → flat.
+ */
+export type DateSerializeFunction = (value: Date | string, field: EFWFormDatePickerFieldProps) => string;
+export interface FlatToEFWOptions {
+    /**
+     * Estrategia para resolver opciones en Choice/MultiChoice cuando se recibe
+     * sólo la `key`.
+     *
+     * - `'lookup'` (default): busca la key en `field.options` y arma `{ key, text, ... }`.
+     *   Si la key no aparece, ver `unknownChoiceKey`.
+     * - `'passthrough'`: no busca; siempre genera `{ key, text: key }` directamente
+     *   (útil cuando `field.options` es un loader async o el caller ya validó las keys).
+     */
+    choiceLookup?: 'lookup' | 'passthrough';
+    /**
+     * Qué hacer cuando una `key` de Choice/MultiChoice no existe en `field.options`.
+     *
+     * - `'drop'` (default): omitir el item.
+     * - `'synthesize'`: generar `{ key, text: key }`.
+     * - `'error'`: lanzar `EFWConversionError`.
+     */
+    unknownChoiceKey?: 'drop' | 'synthesize' | 'error';
+    /**
+     * Para Date: cómo interpretar el string ISO al construir el `Date[]` que
+     * espera el field.
+     *
+     * - `'as-utc'` (default): `new Date(flat)`. Strings tipo `'YYYY-MM-DD'` o
+     *   ISO con `Z` se interpretan como UTC.
+     * - `'as-local'`: `new Date(flat)` interpretado por el runtime local.
+     * - `'string'`: no convierte; coloca el string crudo en el array (válido
+     *   porque `EFWDatePickerValue = Date | string`).
+     */
+    dateParse?: 'as-utc' | 'as-local' | 'string';
+}
+export interface EFWToFlatOptions {
+    /**
+     * Para Date: cómo serializar `Date | string` al string plano.
+     *
+     * - `'iso-date'` (default): `'YYYY-MM-DD'` UTC.
+     * - `'iso-datetime'`: ISO 8601 completo (`Date.prototype.toISOString`).
+     * - función custom `(value, field) => string`.
+     */
+    dateSerialize?: 'iso-date' | 'iso-datetime' | DateSerializeFunction;
+    /**
+     * Para campos vacíos / null, decide si la clave se omite del output o se
+     * incluye como `undefined`. Default: `'omit'`.
+     */
+    emptyKeys?: 'omit' | 'include';
+}
+/**
+ * Códigos de error producidos por las conversiones planas de EFWForm.
+ */
+export type EFWConversionErrorCode = 'unknown-choice-key' | 'invalid-date' | 'invalid-number' | 'unsupported-field-type';
+/**
+ * Error lanzado por `flatToEFWValues` / `EFWValuesToFlat` cuando una conversión
+ * falla de forma fatal o las opciones la fuerzan a fallar.
+ */
+export declare class EFWConversionError extends Error {
+    readonly code: EFWConversionErrorCode;
+    readonly fieldName: string;
+    readonly received: unknown;
+    constructor(params: {
+        code: EFWConversionErrorCode;
+        fieldName: string;
+        received: unknown;
+        message?: string;
+    });
+}
+/**
+ * Convierte un objeto plano (`{ field: primitive | array }`) al shape que
+ * espera `EFWForm` para sus `values` / `defaultValues` (ej. `Date` como
+ * `Date[]`, `Choice` como `EFWTagPickerOption[]`).
+ *
+ * - Las claves del input que no matcheen ningún `field.internalName` se
+ *   ignoran silenciosamente.
+ * - Las claves declaradas en `fields` que no estén presentes en el input se
+ *   omiten del output (no se completan con default).
+ * - Cuando una conversión no es posible (ej. Choice con key desconocida), el
+ *   field correspondiente se devuelve como vacío salvo que las opciones
+ *   indiquen lo contrario.
+ *
+ * @example
+ * const fields = [
+ *   { id: '1', typeAsString: 'Text', internalName: 'name' },
+ *   { id: '2', typeAsString: 'Choice', internalName: 'category', options: [{ key: 'a', text: 'A' }] },
+ * ] as const;
+ *
+ * flatToEFWValues(fields, { name: 'John', category: 'a' });
+ * // → { name: 'John', category: [{ key: 'a', text: 'A' }] }
+ */
+export declare function flatToEFWValues<F extends readonly EFWFormFieldProps[]>(fields: F, flat: FlatValues<F> | Partial<FlatValues<F>> | Record<string, unknown>, options?: FlatToEFWOptions): Partial<EFWFormValues<F>>;
+/**
+ * Operación inversa de {@link flatToEFWValues}: toma valores en el shape que
+ * usa `EFWForm` y los reduce a primitivos / arrays planos según el tipo de
+ * cada field.
+ *
+ * - Las claves del input que no matcheen ningún field se ignoran.
+ * - Si un field está ausente o tiene valor vacío equivalente, la clave se
+ *   omite del output (controlable con `emptyKeys: 'include'`).
+ *
+ * @example
+ * EFWValuesToFlat(fields, {
+ *   name: 'John',
+ *   category: [{ key: 'a', text: 'A' }],
+ * });
+ * // → { name: 'John', category: 'a' }
+ */
+export declare function EFWValuesToFlat<F extends readonly EFWFormFieldProps[]>(fields: F, efwValues: Partial<EFWFormValues<F>>, options?: EFWToFlatOptions): Partial<FlatValues<F>>;

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

@@ -0,0 +1,279 @@
+var T = Object.defineProperty;
+var F = (e, r, n) => r in e ? T(e, r, { enumerable: !0, configurable: !0, writable: !0, value: n }) : e[r] = n;
+var y = (e, r, n) => F(e, typeof r != "symbol" ? r + "" : r, n);
+class o extends Error {
+  constructor(n) {
+    super(
+      n.message ?? `[EFWConversionError:${n.code}] field "${n.fieldName}" received ${a(n.received)}`
+    );
+    y(this, "code");
+    y(this, "fieldName");
+    y(this, "received");
+    this.name = "EFWConversionError", this.code = n.code, this.fieldName = n.fieldName, this.received = n.received;
+  }
+}
+function a(e) {
+  if (e === void 0) return "undefined";
+  if (e === null) return "null";
+  try {
+    const r = JSON.stringify(e);
+    return typeof r == "string" ? r : String(e);
+  } catch {
+    return String(e);
+  }
+}
+function w(e) {
+  const r = /* @__PURE__ */ new Map();
+  for (const n of e)
+    n && typeof n.internalName == "string" && r.set(n.internalName, n);
+  return r;
+}
+function A(e, r) {
+  const n = e.options;
+  if (Array.isArray(n))
+    return n.find((t) => t && t.key === r);
+}
+function m(e) {
+  return e < 10 ? `0${e}` : `${e}`;
+}
+function $(e, r) {
+  if (e instanceof Date) {
+    if (Number.isNaN(e.getTime()))
+      throw new o({
+        code: "invalid-date",
+        fieldName: r,
+        received: e
+      });
+    return `${e.getUTCFullYear()}-${m(e.getUTCMonth() + 1)}-${m(e.getUTCDate())}`;
+  }
+  if (typeof e == "string") {
+    const n = /^(\d{4}-\d{2}-\d{2})/.exec(e);
+    if (n) return n[1];
+    const t = new Date(e);
+    if (Number.isNaN(t.getTime()))
+      throw new o({
+        code: "invalid-date",
+        fieldName: r,
+        received: e
+      });
+    return `${t.getUTCFullYear()}-${m(t.getUTCMonth() + 1)}-${m(t.getUTCDate())}`;
+  }
+  throw new o({
+    code: "invalid-date",
+    fieldName: r,
+    received: e
+  });
+}
+function E(e, r) {
+  const n = e instanceof Date ? e : new Date(e);
+  if (Number.isNaN(n.getTime()))
+    throw new o({
+      code: "invalid-date",
+      fieldName: r,
+      received: e
+    });
+  return n.toISOString();
+}
+const N = {
+  Text: (e) => {
+    if (e != null)
+      return typeof e != "string" ? String(e) : e;
+  },
+  Number: (e, r) => {
+    if (e != null) {
+      if (typeof e != "number")
+        throw new o({
+          code: "invalid-number",
+          fieldName: r.internalName,
+          received: e
+        });
+      if (!Number.isNaN(e))
+        return e;
+    }
+  },
+  Note: (e) => {
+    if (e !== void 0)
+      return e === null ? null : typeof e != "string" ? String(e) : e;
+  },
+  Boolean: (e) => {
+    if (e != null)
+      return !!e;
+  },
+  Choice: (e, r, n) => {
+    if (e == null || e === "") return [];
+    if (typeof e != "string") {
+      if (Array.isArray(e))
+        return e.length === 0 ? [] : (e.length > 1 && console.warn(
+          `[flatToEFWValues] field "${r.internalName}" is Choice but received an array with ${e.length} items; using the first.`
+        ), N.Choice(e[0], r, n));
+      throw new o({
+        code: "unknown-choice-key",
+        fieldName: r.internalName,
+        received: e,
+        message: `[flatToEFWValues] field "${r.internalName}" expected a string key for Choice but received ${a(e)}`
+      });
+    }
+    const t = l(e, r, n);
+    return t ? [t] : [];
+  },
+  MultiChoice: (e, r, n) => {
+    if (e == null) return [];
+    if (!Array.isArray(e))
+      throw new o({
+        code: "unknown-choice-key",
+        fieldName: r.internalName,
+        received: e,
+        message: `[flatToEFWValues] field "${r.internalName}" expected an array of keys for MultiChoice but received ${a(e)}`
+      });
+    const t = [];
+    for (const i of e) {
+      if (typeof i != "string")
+        throw new o({
+          code: "unknown-choice-key",
+          fieldName: r.internalName,
+          received: i,
+          message: `[flatToEFWValues] field "${r.internalName}" MultiChoice array contained a non-string entry: ${a(i)}`
+        });
+      const c = l(i, r, n);
+      c && t.push(c);
+    }
+    return t;
+  },
+  Date: (e, r, n) => {
+    if (e == null || e === "") return [];
+    if (typeof e != "string")
+      throw new o({
+        code: "invalid-date",
+        fieldName: r.internalName,
+        received: e,
+        message: `[flatToEFWValues] field "${r.internalName}" expected an ISO string for Date but received ${a(e)}`
+      });
+    switch (n.dateParse) {
+      case "string":
+        return [e];
+      case "as-utc":
+      case "as-local": {
+        const t = new Date(e);
+        if (Number.isNaN(t.getTime()))
+          throw new o({
+            code: "invalid-date",
+            fieldName: r.internalName,
+            received: e
+          });
+        return [t];
+      }
+      default:
+        return [];
+    }
+  },
+  Attachments: (e) => e == null ? [] : Array.isArray(e) ? [...e] : []
+};
+function l(e, r, n) {
+  if (n.choiceLookup === "passthrough")
+    return { key: e, text: e };
+  const t = A(r, e);
+  if (t) return t;
+  switch (n.unknownChoiceKey) {
+    case "synthesize":
+      return { key: e, text: e };
+    case "error":
+      throw new o({
+        code: "unknown-choice-key",
+        fieldName: r.internalName,
+        received: e,
+        message: `[flatToEFWValues] field "${r.internalName}" received unknown choice key "${e}"`
+      });
+    case "drop":
+    default:
+      return;
+  }
+}
+const C = {
+  Text: (e) => {
+    if (e != null) {
+      if (typeof e != "string") return String(e);
+      if (e !== "")
+        return e;
+    }
+  },
+  Number: (e) => {
+    if (e != null && !(typeof e != "number" || Number.isNaN(e)))
+      return e;
+  },
+  Note: (e) => {
+    if (e != null && e !== "")
+      return e;
+  },
+  Boolean: (e) => {
+    if (e != null)
+      return !!e;
+  },
+  Choice: (e) => {
+    if (!Array.isArray(e) || e.length === 0) return;
+    const r = e[0];
+    if (!(!r || typeof r.key != "string"))
+      return r.key;
+  },
+  MultiChoice: (e) => {
+    if (!Array.isArray(e) || e.length === 0) return;
+    const r = [];
+    for (const n of e)
+      n && typeof n.key == "string" && r.push(n.key);
+    return r.length > 0 ? r : void 0;
+  },
+  Date: (e, r, n) => {
+    if (!Array.isArray(e) || e.length === 0) return;
+    const t = e[0];
+    if (t == null) return;
+    const i = n.dateSerialize;
+    return typeof i == "function" ? i(t, r) : i === "iso-datetime" ? E(t, r.internalName) : $(t, r.internalName);
+  },
+  Attachments: (e) => {
+    if (!(!Array.isArray(e) || e.length === 0))
+      return [...e];
+  }
+}, b = {
+  choiceLookup: "lookup",
+  unknownChoiceKey: "drop",
+  dateParse: "as-utc"
+}, k = {
+  dateSerialize: "iso-date",
+  emptyKeys: "omit"
+};
+function v(e) {
+  const r = e.typeAsString;
+  if (!(r in N))
+    throw new o({
+      code: "unsupported-field-type",
+      fieldName: e.internalName,
+      received: r,
+      message: `[flatToEFWValues] unsupported field type "${r}" on field "${e.internalName}"`
+    });
+}
+function S(e, r, n) {
+  const t = { ...b, ...n }, i = w(e), c = {}, u = r ?? {};
+  for (const [s, d] of i) {
+    if (v(d), !Object.prototype.hasOwnProperty.call(u, s)) continue;
+    const f = u[s], g = N[d.typeAsString], h = g(f, d, t);
+    h !== void 0 && (c[s] = h);
+  }
+  return c;
+}
+function W(e, r, n) {
+  const t = { ...k, ...n }, i = w(e), c = {}, u = r ?? {};
+  for (const [s, d] of i) {
+    v(d);
+    const f = Object.prototype.hasOwnProperty.call(u, s), g = f ? u[s] : void 0, h = C[d.typeAsString], p = h(g, d, t);
+    if (p === void 0) {
+      t.emptyKeys === "include" && f && (c[s] = void 0);
+      continue;
+    }
+    c[s] = p;
+  }
+  return c;
+}
+export {
+  o as EFWConversionError,
+  W as EFWValuesToFlat,
+  S as flatToEFWValues
+};

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

@@ -3,3 +3,5 @@ export type { EFWFormLocaleText } from '../../i18n';
 export { getFormFieldDisplayText } from './EFWForm.converter';
 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';

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

@@ -1,8 +1,12 @@
 import { getFormFieldDisplayText as e } from "./EFWForm.converter.js";
-import { useFormController as t } from "./EFWForm.hooks.js";
-import { EFWForm as l } from "./EFWForm.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";
 export {
-  l as EFWForm,
+  f as EFWConversionError,
+  m as EFWForm,
+  p as EFWValuesToFlat,
+  s as flatToEFWValues,
   e as getFormFieldDisplayText,
-  t as useFormController
+  F as useFormController
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@envisiongroup/porygon",
-  "version": "1.0.0-rc.40",
+  "version": "1.0.0-rc.41",
   "description": "Librerias de componentes de React creados por la empresa Envision",
   "license": "CC-BY-ND-4.0",
   "main": "./dist/index.js",