@envisiongroup/porygon 1.0.0-rc.9 → 1.0.1

package/dist/react-components/buttons/EFWGroupButton/EFWGroupButton.js

@@ -1,129 +1,164 @@
-import { jsx as e, jsxs as k } from "react/jsx-runtime";
-import F, { Suspense as W } from "react";
-import { Button as x, CompoundButton as P, Menu as C, MenuTrigger as S, SplitButton as D, MenuPopover as g, MenuList as E, MenuItem as w, MenuButton as H } from "@fluentui/react-components";
-import { EFWButton as j } from "../EFWButton/EFWButton.js";
-const z = F.lazy(
-  () => import("../EFWDrawerButton/EFWDrawerButton.js").then((f) => ({ default: f.EFWDrawerButton }))
-), R = ({
+import { jsx as r, jsxs as C } from "react/jsx-runtime";
+import E, { Suspense as I } from "react";
+import { Button as P, CompoundButton as D, Menu as T, MenuTrigger as x, SplitButton as H, MenuPopover as S, MenuList as b, MenuItem as g, MenuButton as j } from "@fluentui/react-components";
+import { useButtonsLocaleText as z } from "../../i18n/PorygonI18nProvider.js";
+import { EFWButton as A } from "../EFWButton/EFWButton.js";
+const _ = E.lazy(
+  () => import("../EFWDrawerButton/EFWDrawerButton.js").then((f) => ({
+    default: f.EFWDrawerButton
+  }))
+), p = (f) => f.length, Q = ({
   buttons: f,
   onClickParams: c,
   style: M,
-  gap: T = "8px",
-  className: $
+  gap: w = "8px",
+  className: $,
+  labels: F
 }) => {
-  const b = {
+  const m = z().groupButton.labels.invalidButtonText, y = F?.invalidButtonText, W = {
     display: "flex",
-    gap: T,
+    width: "100%",
+    gap: w,
     ...M
-  }, a = (m) => m.length;
-  return /* @__PURE__ */ e("div", { style: b, className: $, children: f.map((m, B) => {
-    const { kind: h, props: o } = m, u = o.id ? `${o.id}-${B}` : `button-${B}`;
-    if (h === "Button") {
-      const r = o, i = {
-        ...r,
-        ...r.onClick && {
+  }, L = E.useMemo(
+    () => y ?? m,
+    [y, m]
+  );
+  return /* @__PURE__ */ r("div", { style: W, className: $, children: f.map((v, k) => {
+    const { kind: a, props: o } = v, u = o.id ? `${o.id}-${k}` : `button-${k}`;
+    if (a === "Button") {
+      const e = o, i = {
+        ...e,
+        ...e.onClick && {
           onClick: (n) => {
-            const t = r.onClick;
-            a(t) >= 2 && c ? t(n, c) : t(n);
+            const t = e.onClick;
+            p(t) >= 2 && c ? t(n, c) : t(n);
           }
         }
       };
-      return /* @__PURE__ */ e(x, { ...i, children: o.children }, u);
+      return /* @__PURE__ */ r(P, { ...i, children: o.children }, u);
     }
-    if (h === "CompoundButton") {
-      const r = o, i = {
-        ...r,
-        ...r.onClick && {
+    if (a === "CompoundButton") {
+      const e = o, i = {
+        ...e,
+        ...e.onClick && {
           onClick: (n) => {
-            const t = r.onClick;
-            a(t) >= 2 && c ? t(n, c) : t(n);
+            const t = e.onClick;
+            p(t) >= 2 && c ? t(n, c) : t(n);
           }
         }
       };
-      return /* @__PURE__ */ e(P, { ...i, children: o.children }, u);
+      return /* @__PURE__ */ r(
+        D,
+        {
+          ...i,
+          children: o.children
+        },
+        u
+      );
     }
-    if (h === "SplitButton") {
-      const r = o, i = (() => {
-        const { onClick: n, menuTriggers: t, ...l } = r, p = (s) => (y) => {
-          a(s) >= 2 && c ? s(y, c) : s(y);
+    if (a === "SplitButton") {
+      const e = o, i = (() => {
+        const { onClick: n, menuTriggers: t, ...d } = e, h = (l) => (B) => {
+          p(l) >= 2 && c ? l(B, c) : l(B);
         };
-        if (!n && !t) return r;
-        const d = { ...l };
-        return n && (d.primaryActionButton = {
-          onClick: p(n)
-        }), t && t.length && (d.menuTriggers = t.map(
-          (s) => s.onClick ? { ...s, onClick: p(s.onClick) } : s
-        )), d;
+        if (!n && !t) return e;
+        const s = { ...d };
+        return n && (s.primaryActionButton = {
+          onClick: h(n)
+        }), t && t.length && (s.menuTriggers = t.map(
+          (l) => l.onClick ? {
+            ...l,
+            onClick: h(
+              l.onClick
+            )
+          } : l
+        )), s;
       })();
-      return /* @__PURE__ */ k(C, { positioning: "below-end", children: [
-        /* @__PURE__ */ e(S, { disableButtonEnhancement: !0, children: (n) => /* @__PURE__ */ e(
-          D,
+      return /* @__PURE__ */ C(T, { positioning: "below-end", children: [
+        /* @__PURE__ */ r(x, { disableButtonEnhancement: !0, children: (n) => /* @__PURE__ */ r(
+          H,
           {
             menuButton: n,
             ...i,
             children: o.children
           }
         ) }),
-        /* @__PURE__ */ e(g, { children: /* @__PURE__ */ e(E, { children: (i.menuTriggers || []).map(
-          (n, t) => /* @__PURE__ */ e(w, { ...n, children: n.children }, `${u}-menu-item-${t}`)
+        /* @__PURE__ */ r(S, { children: /* @__PURE__ */ r(b, { children: (i.menuTriggers || []).map(
+          (n, t) => /* @__PURE__ */ r(
+            g,
+            {
+              ...n,
+              children: n.children
+            },
+            `${u}-menu-item-${t}`
+          )
         ) }) })
       ] }, u);
     }
-    if (h === "MenuButton") {
-      const r = o, i = (() => {
-        const { menuTriggers: n, ...t } = r, l = (d) => (s) => {
-          a(d) >= 2 && c ? d(s, c) : d(s);
+    if (a === "MenuButton") {
+      const e = o, i = (() => {
+        const { menuTriggers: n, ...t } = e, d = (s) => (l) => {
+          p(s) >= 2 && c ? s(l, c) : s(l);
         };
-        if (!n) return r;
-        const p = { ...t };
-        return n && (p.menuTriggers = n.map(
-          (d) => d.onClick ? { ...d, onClick: l(d.onClick) } : d
-        )), p;
+        if (!n) return e;
+        const h = { ...t };
+        return n && (h.menuTriggers = n.map(
+          (s) => s.onClick ? {
+            ...s,
+            onClick: d(
+              s.onClick
+            )
+          } : s
+        )), h;
       })();
-      return /* @__PURE__ */ k(C, { positioning: "below-end", children: [
-        /* @__PURE__ */ e(S, { disableButtonEnhancement: !0, children: /* @__PURE__ */ e(
-          H,
-          {
-            ...i,
-            children: o.children
-          }
-        ) }),
-        /* @__PURE__ */ e(g, { children: /* @__PURE__ */ e(E, { children: (i.menuTriggers || []).map((n, t) => /* @__PURE__ */ e(w, { ...n, children: n.children }, `${u}-menu-item-${t}`)) }) })
+      return /* @__PURE__ */ C(T, { positioning: "below-end", children: [
+        /* @__PURE__ */ r(x, { disableButtonEnhancement: !0, children: /* @__PURE__ */ r(j, { ...i, children: o.children }) }),
+        /* @__PURE__ */ r(S, { children: /* @__PURE__ */ r(b, { children: (i.menuTriggers || []).map(
+          (n, t) => /* @__PURE__ */ r(
+            g,
+            {
+              ...n,
+              children: n.children
+            },
+            `${u}-menu-item-${t}`
+          )
+        ) }) })
       ] }, u);
     }
-    if (h == "EFWButton") {
-      const r = o, i = {
-        ...r,
-        ...r.onClick && {
+    if (a == "EFWButton") {
+      const e = o, i = {
+        ...e,
+        ...e.onClick && {
           onClick: (n) => {
-            const t = r.onClick;
-            return a(t) >= 2 && c ? t(n, c) : t(n);
+            const t = e.onClick;
+            return p(t) >= 2 && c ? t(n, c) : t(n);
           }
         }
       };
-      return /* @__PURE__ */ e(j, { ...i, children: o.children }, u);
+      return /* @__PURE__ */ r(A, { ...i, children: o.children }, u);
     }
-    if (h == "EFWDrawerButton") {
-      const r = o, i = {
-        ...r,
-        ...r.onClick && {
+    if (a == "EFWDrawerButton") {
+      const e = o, i = {
+        ...e,
+        ...e.onClick && {
           onClick: (n, t) => {
-            const l = r.onClick;
-            return a(l) >= 3 && c !== void 0 ? l(
-              n,
-              t,
-              c
-            ) : l(
-              n,
-              t
-            );
+            const d = e.onClick;
+            return p(d) >= 3 && c !== void 0 ? d(n, t, c) : d(n, t);
           }
         }
       };
-      return /* @__PURE__ */ e(W, { fallback: null, children: /* @__PURE__ */ e(z, { ...i, children: o.children }) }, u);
-    } else return /* @__PURE__ */ e("div", { children: "Botón inválido (missing or unknown 'kind' property)" }, u);
+      return /* @__PURE__ */ r(I, { fallback: null, children: /* @__PURE__ */ r(
+        _,
+        {
+          ...i,
+          children: o.children
+        }
+      ) }, u);
+    }
+    return /* @__PURE__ */ r("div", { children: L }, u);
   }) });
 };
 export {
-  R as EFWGroupButton
+  Q as EFWGroupButton
 };

package/dist/react-components/buttons/EFWGroupButton/EFWGroupButton.types.d.ts

@@ -3,6 +3,9 @@ import { EFWButtonProps, EFWButtonActionResult } from '../EFWButton';
 import { EFWDrawerButtonProps } from '../EFWDrawerButton/EFWDrawerButton.types';
 import { DrawerOpenHandler } from '../../hooks/useDrawer';
 
+export interface EFWGroupButtonLabels {
+    invalidButtonText?: string;
+}
 /**
  * Tipo genérico para manejadores de eventos click flexibles en botones estándar de Fluent UI.
  * |
@@ -78,7 +81,6 @@ export type EFWDrawerButtonClickHandler<T = undefined> = T extends undefined ? (
  * };
  * ```
  */
-export type EFWDrawerHandler<T = undefined> = (() => void) | ((params: T) => void);
 /**
  * Configuración para un botón individual dentro de EFWGroupButton.
  *
@@ -229,4 +231,8 @@ export interface EFWGroupButtonProps<T = undefined> {
      * Clase CSS opcional para el contenedor
      */
     className?: string;
+    /**
+     * Textos de UI internos del componente para localización.
+     */
+    labels?: EFWGroupButtonLabels;
 }

package/dist/react-components/buttons/EFWGroupButton/index.d.ts

@@ -1,2 +1,2 @@
 export { EFWGroupButton } from './EFWGroupButton';
-export type { EFWGroupButtonProps, NormalClickHandler, EFWClickHandler, EFWGroupButtonConfig } from './EFWGroupButton.types';
+export type { EFWGroupButtonProps, EFWGroupButtonLabels, NormalClickHandler, EFWClickHandler, EFWGroupButtonConfig } from './EFWGroupButton.types';

package/dist/react-components/commons/caretPositioning.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Utilidades compartidas para preservar la posición del caret cuando un input
+ * controlado reformatea su valor en `onChange` (máscaras, separadores de miles,
+ * etc.). Al reescribir el `value`, React/el navegador mueven el caret al final;
+ * estas funciones calculan dónde debería quedar para no interrumpir la edición.
+ *
+ * El core es agnóstico al formato: cada componente aporta su propio predicado
+ * `isPayloadChar` que distingue los datos reales (lo que la persona escribe) de
+ * la decoración que el formato inserta.
+ */
+/**
+ * Determina si un carácter forma parte del "payload" (dato real escrito por la
+ * persona) en lugar de ser decoración estática insertada por el formato.
+ */
+export type PayloadCharTester = (char: string) => boolean;
+/**
+ * Calcula la posición de caret en `nextFormatted` tras una edición, preservando
+ * la posición lógica respecto al payload que la persona está editando.
+ *
+ * Estrategia (estilo cleave.js, robusta ante decoración insertada o removida):
+ * - Si el caret quedó al final del texto tecleado, se mantiene al final del
+ *   texto formateado (cubre tipear al final y formatos que sintetizan prefijo).
+ * - En otro caso se cuenta cuántos caracteres de payload hay a la izquierda del
+ *   caret y se reubica justo después de esa misma cantidad de payload en el
+ *   texto formateado resultante.
+ *
+ * Es una función pura: no toca el DOM. El llamador decide cuándo aplicarla
+ * (típicamente en un layout effect, solo si el input sigue enfocado).
+ */
+export declare const computeCaretAfterReformat: ({ previousCaret, typedValue, nextFormatted, isPayloadChar, }: {
+    previousCaret: number;
+    typedValue: string;
+    nextFormatted: string;
+    isPayloadChar: PayloadCharTester;
+}) => number;

package/dist/react-components/commons/caretPositioning.js

@@ -0,0 +1,28 @@
+const c = ({
+  previousCaret: i,
+  typedValue: f,
+  nextFormatted: n,
+  isPayloadChar: e
+}) => {
+  const t = (l) => Math.max(0, Math.min(l, n.length));
+  if (i >= f.length)
+    return n.length;
+  let h = 0;
+  const r = Math.min(i, f.length);
+  for (let l = 0; l < r; l++)
+    e(f[l]) && h++;
+  if (h === 0) {
+    let l = 0;
+    for (; l < n.length && !e(n[l]); )
+      l++;
+    return t(l);
+  }
+  let g = 0;
+  for (let l = 0; l < n.length; l++)
+    if (e(n[l]) && (g++, g === h))
+      return t(l + 1);
+  return n.length;
+};
+export {
+  c as computeCaretAfterReformat
+};

package/dist/react-components/commons/utils.d.ts

@@ -52,4 +52,4 @@ export declare const getFileIconUrl: (doctype: string, size?: number) => string;
  * getErrorMessage(undefined); // "Error desconocido"
  * getErrorMessage(42); // "42"
  */
-export declare const getErrorMessage: (error: any) => any;
+export declare const getErrorMessage: (error: any) => string;

package/dist/react-components/commons/utils.js

@@ -9,7 +9,7 @@ const r = (t, e = 256) => {
   return t = t.toLowerCase(), t == "folder" ? s + e + "/folder.svg" : t == "url" ? s + e + "/link.png" : t == "listitem" ? s + e + "/spo.png" : t == "txt" ? s + e + "/txt.png" : /doc|docm|docx|dot|dotm|dotx|odt/i.test(t) ? s + e + "/docx.png" : /odp|pot|potm|potx|ppa|ppam|pps|ppsm|ppsx|ppt|pptm|pptx/i.test(t) ? s + e + "/pptx.png" : /ods|csv|xla|xlam|xll|xls|xlsb|xlsm|xlsx|xlt|xltm|xltx/i.test(t) ? s + e + "/xlsx.png" : /jpg|jpeg|tiff|tif|png|gif|cr2/i.test(t) ? s + e + "/photo.png" : /wmv|ismv|m2v|mpeg|mpg|xesc|vob|ts|mod|avi|mts|m2ts|asf|3gp|3g2|3gp2|mp4|mov/i.test(t) ? s + e + "/video.png" : /pdf/i.test(t) ? s + e + "/pdf.png" : /psd/i.test(t) ? s + e + "/photo.png" : /ai/i.test(t) ? s + e + "/vector.png" : /msg|eml/i.test(t) ? s + e + "/email.png" : /zip/i.test(t) ? s + e + "/zip.png" : /aspx/i.test(t) ? s + e + "/spo.png" : s + e + "/genericfile.png";
 }, f = (t) => {
   let e;
-  return t instanceof Error ? e = t.message : typeof t == "string" ? e = t : t && typeof t == "object" && "message" in t ? e = t.message : e = String(t) || "Error desconocido", e;
+  return t instanceof Error ? e = t.message : typeof t == "string" ? e = t : t && typeof t == "object" && "message" in t ? e = String(t.message) : e = String(t) || "Error desconocido", e;
 };
 export {
   p as formatFileSize,

package/dist/react-components/commons/valueNormalization.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Determina si un valor debe considerarse vacío para validaciones semánticas.
+ * Los strings compuestos solo por whitespace se consideran vacíos.
+ */
+export declare const isSemanticallyEmptyValue: (value: unknown) => boolean;
+/**
+ * Normaliza listas opcionales a arrays para evitar null checks repetidos.
+ */
+export declare const normalizeArrayValue: <T>(value: T[] | null | undefined) => T[];
+/**
+ * Determina si el valor de un campo debe considerarse vacío a efectos de
+ * validación de obligatoriedad (required).
+ *
+ * Mantiene un único criterio de "vacío" coherente para todo el formulario:
+ * - Para `Text` y `Note` se usa `isSemanticallyEmptyValue`, de modo que los
+ *   strings compuestos solo por whitespace también cuentan como vacíos.
+ * - Para el resto de tipos se considera vacío `undefined`, `null`, `""` o un
+ *   array sin elementos.
+ *
+ * Es la fuente única de verdad que usan tanto `EFWForm.validateForm` como la
+ * limpieza del error de obligatoriedad al escribir (`handleValueChange`),
+ * evitando duplicar la lógica de vacío entre ambos.
+ *
+ * @param value - Valor actual del campo.
+ * @param typeAsString - Tipo del campo (`EFWFormFieldType`).
+ * @returns `true` si el valor se considera vacío para validar obligatoriedad.
+ */
+export declare const isFieldEmptyForValidation: (value: unknown, typeAsString: string) => boolean;

package/dist/react-components/commons/valueNormalization.js

@@ -0,0 +1,6 @@
+const i = (r) => r == null ? !0 : typeof r == "string" ? r.trim() === "" : Array.isArray(r) ? r.length === 0 : !1, n = (r) => Array.isArray(r) ? r : [], o = (r, t) => t === "Text" || t === "Note" ? i(r) : r == null || r === "" || Array.isArray(r) && r.length === 0;
+export {
+  o as isFieldEmptyForValidation,
+  i as isSemanticallyEmptyValue,
+  n as normalizeArrayValue
+};

package/dist/react-components/fields/Attachments/EFWAttachments.js

@@ -0,0 +1,205 @@
+import { jsx as l, jsxs as V } from "react/jsx-runtime";
+import { makeStyles as _, mergeClasses as ee, Text as te, CardFooter as ae, Button as ne } from "@fluentui/react-components";
+import { useMemo as $, useId as oe, useRef as le, useState as se, useEffect as j, useCallback as f } from "react";
+import { EFWAttachmentsContainer as q } from "./EFWAttachmentsCard.js";
+import { Attach20Regular as ce } from "@fluentui/react-icons";
+import { formatFileSize as me } from "../../commons/utils.js";
+import { v4 as re } from "uuid";
+import { getAttachmentsFormattedValue as v } from "./EFWAttachments.utils.js";
+import { normalizeArrayValue as O } from "../../commons/valueNormalization.js";
+import { useFieldsLocaleText as ie } from "../../i18n/PorygonI18nProvider.js";
+const de = _({
+  efwAttachmentError: {
+    //...
+  },
+  efwAttachmentInput: {
+    display: "none"
+  },
+  efwAttachmentsButton: {
+    margin: "0px 0px 5px"
+  },
+  efwAttachmentsContainer: {
+    display: "flex"
+  }
+}), Ae = (P) => {
+  const {
+    editable: U = !0,
+    disabled: c = !1,
+    files: L,
+    defaultFiles: h,
+    className: G = "",
+    validationState: H = "none",
+    setParentComponentState: p,
+    multiple: M = !0,
+    acceptedTypes: J = "*/*",
+    maxFileSize: m = 100 * 1024 * 1024,
+    // 100MB por defecto
+    labels: r,
+    onChange: i,
+    onRemoveAttachment: b,
+    readOnlyRenderer: K
+  } = P, d = ie().attachments.labels, A = d.attachButtonLabel, F = d.emptyMessage, w = d.downloadMenuItemLabel, E = d.removeMenuItemLabel, z = d.maxFileSizeExceededMessage, I = r?.attachButtonLabel, S = r?.emptyMessage, R = r?.downloadMenuItemLabel, C = r?.removeMenuItemLabel, B = r?.maxFileSizeExceededMessage, o = $(() => ({
+    attachButtonLabel: I ?? A,
+    emptyMessage: S ?? F,
+    downloadMenuItemLabel: R ?? w,
+    removeMenuItemLabel: C ?? E,
+    maxFileSizeExceededMessage: B ?? z
+  }), [
+    I,
+    S,
+    R,
+    C,
+    B,
+    A,
+    F,
+    w,
+    E,
+    z
+  ]), Q = oe(), g = de(), u = le(null), s = L !== void 0, N = $(
+    () => h ?? [],
+    [h]
+  ), [X, x] = se(() => h ?? []), n = s ? L ?? [] : X;
+  j(() => {
+    s || x(N);
+  }, [s, N]);
+  const W = f(
+    (a) => {
+      for (const e of a)
+        if (e.size !== void 0 && e.size > m)
+          return !1;
+      return !0;
+    },
+    [m]
+  ), k = f(() => {
+    const a = me(m), e = o.maxFileSizeExceededMessage;
+    return typeof e == "function" ? e(m, a) : typeof e == "string" && e.trim().length > 0 ? e : `Existe un adjunto que excede el peso máximo de ${a}.`;
+  }, [m, o.maxFileSizeExceededMessage]);
+  j(() => {
+    n.length > 0 && !W(n) ? p?.("error", k()) : p?.("none");
+  }, [
+    n,
+    W,
+    p,
+    k
+  ]);
+  const Y = f(() => {
+    u.current && !c && u.current.click();
+  }, [c]), T = f(
+    async (a) => {
+      const e = n.find((t) => t.id === a);
+      if (!e) {
+        console.warn(
+          `[EFWAttachment]: Attachment with id ${a} not found`
+        );
+        return;
+      }
+      try {
+        if (b && !await b(e)) {
+          console.log(
+            `[EFWAttachment]: Removal of file ${a} was cancelled`
+          );
+          return;
+        }
+        const t = n.filter(
+          (D) => D.id !== a
+        );
+        s || x(t), i && i(
+          t,
+          v(
+            O(t)
+          )
+        ), console.log(
+          `[EFWAttachment]: File ${a} removed successfully`
+        );
+      } catch (t) {
+        console.error("[EFWAttachment]: Detele file error:", t);
+      }
+    },
+    [n, b, i, s]
+  ), Z = f(
+    (a) => {
+      const e = Array.from(
+        a.target.files || []
+      ).map((t) => ({
+        id: re(),
+        name: t.name,
+        size: t.size,
+        type: t.type,
+        lastModified: t.lastModified,
+        file: t
+      }));
+      if (e.length > 0) {
+        const t = M ? [...n, ...e] : e;
+        s || x(t), i?.(
+          t,
+          v(O(t))
+        );
+      }
+      u.current && (u.current.value = "");
+    },
+    [n, M, i, s]
+  ), y = ee(
+    G,
+    H === "error" && g.efwAttachmentError
+  );
+  if (!U) {
+    const a = v(n) || o.emptyMessage, e = K?.(
+      n,
+      a
+    );
+    return e != null ? /* @__PURE__ */ l("div", { className: y, children: e }) : /* @__PURE__ */ l("div", { className: y, children: n.length === 0 ? /* @__PURE__ */ l(te, { style: { opacity: 0.7 }, children: o.emptyMessage }) : /* @__PURE__ */ l(
+      q,
+      {
+        enableRemoveButtons: !1,
+        onRemoveAttachment: T,
+        attachments: n,
+        emptyMessage: o.emptyMessage,
+        downloadMenuItemLabel: o.downloadMenuItemLabel,
+        removeMenuItemLabel: o.removeMenuItemLabel
+      }
+    ) });
+  }
+  return /* @__PURE__ */ V("div", { className: y, children: [
+    /* @__PURE__ */ V(ae, { style: { display: "disabled" }, children: [
+      /* @__PURE__ */ l(
+        "input",
+        {
+          ref: u,
+          id: Q,
+          type: "file",
+          "aria-label": o.attachButtonLabel,
+          className: g.efwAttachmentInput,
+          accept: J,
+          multiple: M,
+          onChange: Z,
+          disabled: c
+        }
+      ),
+      /* @__PURE__ */ l(
+        ne,
+        {
+          size: "medium",
+          onClick: Y,
+          icon: /* @__PURE__ */ l(ce, {}),
+          disabled: c,
+          className: g.efwAttachmentsButton,
+          children: o.attachButtonLabel
+        }
+      )
+    ] }),
+    /* @__PURE__ */ l(
+      q,
+      {
+        enableRemoveButtons: !c,
+        onRemoveAttachment: T,
+        attachments: n,
+        emptyMessage: o.emptyMessage,
+        downloadMenuItemLabel: o.downloadMenuItemLabel,
+        removeMenuItemLabel: o.removeMenuItemLabel
+      }
+    )
+  ] });
+};
+export {
+  Ae as EFWAttachment
+};

package/dist/react-components/fields/{EFWAttachments → Attachments}/EFWAttachments.types.d.ts

@@ -1,4 +1,5 @@
-import { EFWFieldChildrenProps } from '../EFWField/EFWField.types';
+import { EFWFieldChildrenProps } from '../_shared/EFWField/EFWField.types';
+import { ReactNode } from 'react';
 
 /**
  * Valor que representa un archivo adjunto en el componente EFWAttachments.
@@ -25,9 +26,28 @@ export type EFWAttachmentsValue = {
 /**
  * Función callback ejecutada cuando cambia la lista de archivos adjuntos.
  * @param values - Array de archivos adjuntos actualizados
- * @param displayValue - Valor de visualización opcional
+ * @param displayValue - Texto formateado de la lista de adjuntos
  */
 export type EFWAttachmentsOnChange = (values: EFWAttachmentsValue[], displayValue?: string) => void;
+export type EFWAttachmentsNonEditableRenderer = (value: EFWAttachmentsValue[], displayValue: string) => ReactNode;
+/**
+ * Textos de la UI del componente EFWAttachments.
+ */
+export interface EFWAttachmentsLabels {
+    /** Texto del botón para adjuntar archivos. */
+    attachButtonLabel?: string;
+    /** Mensaje mostrado cuando no hay archivos adjuntos. */
+    emptyMessage?: string;
+    /** Texto del item de menú para descargar un archivo. */
+    downloadMenuItemLabel?: string;
+    /** Texto del item de menú para quitar un archivo adjunto. */
+    removeMenuItemLabel?: string;
+    /**
+     * Mensaje de error cuando un archivo excede el tamaño máximo permitido.
+     * Si se define como función, recibe el tamaño máximo en bytes y formateado.
+     */
+    maxFileSizeExceededMessage?: string | ((maxFileSize: number, maxFileSizeFormatted: string) => string);
+}
 /**
  * Propiedades del componente EFWAttachments para gestionar archivos adjuntos.
  */
@@ -68,6 +88,11 @@ export interface EFWAttachmentsProps extends EFWFieldChildrenProps {
      * @default 104857600 (100MB)
      */
     maxFileSize?: number;
+    /**
+     * Textos personalizables de la UI del componente.
+     * Permite sobreescribir los textos por defecto para internacionalización.
+     */
+    labels?: EFWAttachmentsLabels;
     /**
      * Callback ejecutado al intentar eliminar un adjunto.
      * Debe retornar una promesa que resuelve a true para confirmar la eliminación.
@@ -81,4 +106,9 @@ export interface EFWAttachmentsProps extends EFWFieldChildrenProps {
      * @param displayValue - Valor de visualización opcional
      */
     onChange?: EFWAttachmentsOnChange;
+    /**
+     * Renderiza contenido custom cuando `editable={false}`.
+     * Si retorna `null` o `undefined`, se utiliza el render no editable por defecto.
+     */
+    readOnlyRenderer?: EFWAttachmentsNonEditableRenderer;
 }