@golemui/gui-validators 1.4.0 → 1.5.0-rc.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## 1.5.0-rc.0 (2026-09-04)
+
+### 🚀 Features
+
+- **gui-components:** add file upload widgets ([#332](https://github.com/golemui/golemui/pull/332))
+
+### ❤️ Thank You
+
+- Raúl Jiménez @Elecash
+
+## 1.4.0 (2026-08-26)
+
+This was a version bump only for gui-validators to align it with other projects, there were no code changes.
+
 ## 1.4.0-rc.0 (2026-08-26)
 
 This was a version bump only for gui-validators to align it with other projects, there were no code changes.

package/index.d.ts

@@ -1,2 +1,2 @@
 export { initValidators } from './lib/validators';
-export type { ArrayValidator, BooleanValidator, CustomValidator, CustomValidatorSchemaFn, CustomValidatorSchemas, NumberValidator, StringValidator, Validator, } from './lib/validators';
+export type { ArrayValidator, BooleanValidator, CustomValidator, CustomValidatorSchemaFn, CustomValidatorSchemas, FileValidator, FilesValidator, NumberValidator, StringValidator, Validator, } from './lib/validators';

package/index.js

@@ -1,206 +1,279 @@
-import { filterTap as S, standardValidate as M, isStandardValidateSuccess as O } from "@golemui/core";
+import { standardValidate as I, isStandardValidateSuccess as b, filterTap as A } from "@golemui/core";
 import "@standard-schema/spec";
-import { iso as d } from "zod";
-import { uuid as $, url as j, ipv6 as E, ipv4 as T, hostname as R, email as F, optional as N, any as g, superRefine as V, array as k, refine as u, minLength as q, maxLength as I, boolean as x, number as y, int as U, minimum as J, maximum as _, string as b, regex as A } from "zod/mini";
-const p = {
-  email: { schema: F() },
-  hostname: { schema: R() },
-  ipv4: { schema: T() },
-  ipv6: { schema: E() },
-  url: { schema: j() },
-  uuid: { schema: $() },
-  date: { schema: d.date() },
-  time: { schema: d.time() },
-  "date-time": { schema: d.datetime({ local: !0, offset: !0 }) },
-  duration: { schema: d.duration() }
-}, w = Object.keys(p), Y = (i) => (n, e) => {
-  switch (n.type) {
+import { iso as g } from "zod";
+import { uuid as _, url as T, ipv6 as $, ipv4 as j, hostname as D, email as N, any as a, superRefine as h, array as l, refine as u, minLength as x, maxLength as M, optional as R, boolean as q, number as S, int as P, minimum as G, maximum as J, string as w, regex as B } from "zod/mini";
+const k = {
+  email: { schema: N() },
+  hostname: { schema: D() },
+  ipv4: { schema: j() },
+  ipv6: { schema: $() },
+  url: { schema: T() },
+  uuid: { schema: _() },
+  date: { schema: g.date() },
+  time: { schema: g.time() },
+  "date-time": { schema: g.datetime({ local: !0, offset: !0 }) },
+  duration: { schema: g.duration() }
+}, L = Object.keys(k), C = ["uploading", "uploaded", "error"], ne = (m) => (t, e) => {
+  switch (t.type) {
     case "string":
-      return B(n, e);
+      return K(t, e);
     case "integer":
     case "number":
-      return K(n, e);
+      return W(t, e);
     case "boolean":
-      return D(n, e);
+      return H(t, e);
     case "array":
-      return G(n, e);
+      return X(t, e);
+    case "file":
+      return Y(t, e);
+    case "files":
+      return Z(t, e);
     case "custom": {
-      if (!i)
+      if (!m)
         throw new Error(
           'Validator type "custom" requires a customValidators object, but it was not supplied.'
         );
-      return H(n, i);
+      return v(t, m);
     }
     default: {
-      const c = n;
+      const c = t;
       throw new Error(
-        `Unknown validator config: ${JSON.stringify(c)}. The "type" property must be one of: "string", "number", "integer", "boolean", "array", "custom".`
+        `Unknown validator config: ${JSON.stringify(c)}. The "type" property must be one of: "string", "number", "integer", "boolean", "array", "file", "files", "custom".`
       );
     }
   }
 };
-function o(i, n) {
-  if (i !== void 0)
-    return typeof i == "string" ? i : n?.translate(i.key, i.params, i.default) ?? i.default;
+function o(m, t) {
+  if (m !== void 0)
+    return typeof m == "string" ? m : t?.translate(m.key, m.params, m.default) ?? m.default;
 }
-function B(i, n) {
-  return f(i, (e) => {
-    const c = o(e.messages?.invalid, n);
-    let s = c ? b(c) : b();
+function K(m, t) {
+  return f(m, (e) => {
+    const c = o(e.messages?.invalid, t);
+    let r = c ? w(c) : w();
     if (e.required === !0) {
-      const r = o(e.messages?.required, n) ?? "This field is required";
-      s = s.check(u((t) => t.length > 0, { error: r }));
+      const s = o(e.messages?.required, t) ?? "This field is required";
+      r = r.check(u((n) => n.length > 0, { error: s }));
     }
     if (typeof e.minLength == "number") {
-      const r = o(e.messages?.minLength, n), t = e.minLength;
-      s = s.check(
-        r ? u((m) => m.length >= t, { error: r }) : q(t)
+      const s = o(e.messages?.minLength, t), n = e.minLength;
+      r = r.check(
+        s ? u((i) => i.length >= n, { error: s }) : x(n)
       );
     }
     if (typeof e.maxLength == "number") {
-      const r = o(e.messages?.maxLength, n), t = e.maxLength;
-      s = s.check(
-        r ? u((m) => m.length <= t, { error: r }) : I(t)
+      const s = o(e.messages?.maxLength, t), n = e.maxLength;
+      r = r.check(
+        s ? u((i) => i.length <= n, { error: s }) : M(n)
       );
     }
     if (typeof e.pattern == "string") {
-      const r = o(e.messages?.pattern, n), t = new RegExp(e.pattern);
-      s = s.check(
-        r ? u((m) => t.test(m), { error: r }) : A(t)
+      const s = o(e.messages?.pattern, t), n = new RegExp(e.pattern);
+      r = r.check(
+        s ? u((i) => n.test(i), { error: s }) : B(n)
       );
     }
     if (e.enum) {
-      const r = e.enum, t = o(e.messages?.enum, n);
-      s = s.check(u((m) => r.includes(m), t ? { error: t } : void 0));
+      const s = e.enum, n = o(e.messages?.enum, t);
+      r = r.check(u((i) => s.includes(i), n ? { error: n } : void 0));
     }
     if (e.const !== void 0) {
-      const r = o(e.messages?.const, n);
-      s = s.check(u((t) => t === e.const, r ? { error: r } : void 0));
+      const s = o(e.messages?.const, t);
+      r = r.check(u((n) => n === e.const, s ? { error: s } : void 0));
     }
     if (e.format !== void 0)
-      if (w.includes(e.format)) {
-        const r = o(e.messages?.format, n);
-        s = s.check(
-          r ? V((t, m) => {
-            const a = M(
-              p[e.format].schema,
-              t
+      if (L.includes(e.format)) {
+        const s = o(e.messages?.format, t);
+        r = r.check(
+          s ? h((n, i) => {
+            const d = I(
+              k[e.format].schema,
+              n
             );
-            O(a) || m.addIssue({ code: "custom", path: [], message: r });
-          }) : p[e.format].schema
+            b(d) || i.addIssue({ code: "custom", path: [], message: s });
+          }) : k[e.format].schema
         );
       } else
         throw new Error(
-          `Unknown string validation format: ${JSON.stringify(e.format)}. The "format" property must be one of: ${w.map((r) => `"${r}"`).join(", ")}.`
+          `Unknown string validation format: ${JSON.stringify(e.format)}. The "format" property must be one of: ${L.map((s) => `"${s}"`).join(", ")}.`
         );
-    return s;
+    return r;
   });
 }
-const C = (i, n) => {
-  if (n === 0)
+const Q = (m, t) => {
+  if (t === 0)
     return !1;
-  const e = i / n;
+  const e = m / t;
   return Math.abs(e - Math.round(e)) < 1e-10;
 };
-function K(i, n) {
-  return f(i, (e) => {
-    const c = o(e.messages?.invalid, n);
-    let s = c ? y(c) : y();
-    if (e.type === "integer" && (s = s.check(U())), e.minimum !== void 0) {
-      const r = o(e.messages?.minimum, n), t = e.minimum;
-      s = s.check(r ? u((m) => m >= t, { error: r }) : J(t));
+function W(m, t) {
+  return f(m, (e) => {
+    const c = o(e.messages?.invalid, t);
+    let r = c ? S(c) : S();
+    if (e.type === "integer" && (r = r.check(P())), e.minimum !== void 0) {
+      const s = o(e.messages?.minimum, t), n = e.minimum;
+      r = r.check(s ? u((i) => i >= n, { error: s }) : G(n));
     }
     if (e.maximum !== void 0) {
-      const r = o(e.messages?.maximum, n), t = e.maximum;
-      s = s.check(r ? u((m) => m <= t, { error: r }) : _(t));
+      const s = o(e.messages?.maximum, t), n = e.maximum;
+      r = r.check(s ? u((i) => i <= n, { error: s }) : J(n));
     }
     if (e.exclusiveMinimum !== void 0) {
-      const r = o(e.messages?.exclusiveMinimum, n), t = e.exclusiveMinimum;
-      s = s.check(u((m) => m > t, r ? { error: r } : void 0));
+      const s = o(e.messages?.exclusiveMinimum, t), n = e.exclusiveMinimum;
+      r = r.check(u((i) => i > n, s ? { error: s } : void 0));
     }
     if (e.exclusiveMaximum !== void 0) {
-      const r = o(e.messages?.exclusiveMaximum, n), t = e.exclusiveMaximum;
-      s = s.check(u((m) => m < t, r ? { error: r } : void 0));
+      const s = o(e.messages?.exclusiveMaximum, t), n = e.exclusiveMaximum;
+      r = r.check(u((i) => i < n, s ? { error: s } : void 0));
     }
     if (e.multipleOf !== void 0) {
-      const r = o(e.messages?.multipleOf, n), t = e.multipleOf;
-      s = s.check(
-        u((m) => C(m, t), r ? { error: r } : void 0)
+      const s = o(e.messages?.multipleOf, t), n = e.multipleOf;
+      r = r.check(
+        u((i) => Q(i, n), s ? { error: s } : void 0)
       );
     }
     if (e.enum) {
-      const r = e.enum, t = o(e.messages?.enum, n);
-      s = s.check(u((m) => r.includes(m), t ? { error: t } : void 0));
+      const s = e.enum, n = o(e.messages?.enum, t);
+      r = r.check(u((i) => s.includes(i), n ? { error: n } : void 0));
     }
     if (e.const !== void 0) {
-      const r = o(e.messages?.const, n);
-      s = s.check(u((t) => t === e.const, r ? { error: r } : void 0));
+      const s = o(e.messages?.const, t);
+      r = r.check(u((n) => n === e.const, s ? { error: s } : void 0));
     }
-    return s;
+    return r;
   });
 }
-function D(i, n) {
-  return f(i, (e) => {
-    const c = o(e.messages?.invalid, n);
-    let s = c ? x(c) : x();
+function H(m, t) {
+  return f(m, (e) => {
+    const c = o(e.messages?.invalid, t);
+    let r = c ? q(c) : q();
     if (e.const !== void 0) {
-      const r = o(e.messages?.const, n);
-      s = s.check(u((t) => t === e.const, r ? { error: r } : void 0));
+      const s = o(e.messages?.const, t);
+      r = r.check(u((n) => n === e.const, s ? { error: s } : void 0));
     }
-    return s;
+    return r;
   });
 }
-function G(i, n) {
-  return f(i, (e) => {
-    const c = o(e.messages?.invalid, n);
-    let s = c ? k(g(), c) : k(g());
+function X(m, t) {
+  return f(m, (e) => {
+    const c = o(e.messages?.invalid, t);
+    let r = c ? l(a(), c) : l(a());
     if (e.required === !0) {
-      const r = o(e.messages?.required, n) ?? "This field is required";
-      s = s.check(u((t) => t.length > 0, { error: r }));
+      const s = o(e.messages?.required, t) ?? "This field is required";
+      r = r.check(u((n) => n.length > 0, { error: s }));
     }
     if (typeof e.minItems == "number") {
-      const r = o(e.messages?.minItems, n), t = e.minItems;
-      s = s.check(
-        r ? u((m) => m.length >= t, { error: r }) : q(t)
+      const s = o(e.messages?.minItems, t), n = e.minItems;
+      r = r.check(
+        s ? u((i) => i.length >= n, { error: s }) : x(n)
       );
     }
     if (typeof e.maxItems == "number") {
-      const r = o(e.messages?.maxItems, n), t = e.maxItems;
-      s = s.check(
-        r ? u((m) => m.length <= t, { error: r }) : I(t)
+      const s = o(e.messages?.maxItems, t), n = e.maxItems;
+      r = r.check(
+        s ? u((i) => i.length <= n, { error: s }) : M(n)
       );
     }
-    return s;
+    return r;
   });
 }
-function H(i, n) {
-  return f(i, (e) => {
-    let c = g();
-    return S(
+const V = "This field is required", U = "Invalid file", F = "Wait for the upload to finish";
+function y(m) {
+  if (m === null || typeof m != "object")
+    return !1;
+  const t = m;
+  return typeof t.id == "string" && typeof t.name == "string" && typeof t.size == "number" && typeof t.type == "string" && typeof t.status == "string" && C.includes(t.status);
+}
+function Y(m, t) {
+  const e = o(m.messages?.invalid, t) ?? U, c = o(m.messages?.required, t) ?? V, r = o(m.messages?.pendingUploads, t) ?? F, s = m.blockPendingUploads !== !1;
+  return a().check(
+    h((n, i) => {
+      if (n == null) {
+        m.required === !0 && i.addIssue({ code: "custom", message: c });
+        return;
+      }
+      if (!y(n)) {
+        i.addIssue({ code: "custom", message: e });
+        return;
+      }
+      s && n.status !== "uploaded" && i.addIssue({ code: "custom", message: r });
+    })
+  );
+}
+function Z(m, t) {
+  const e = o(m.messages?.required, t) ?? V, c = z(m, t, e);
+  return a().check(
+    h((r, s) => {
+      if (r == null) {
+        m.required === !0 && s.addIssue({ code: "custom", message: e });
+        return;
+      }
+      const n = I(
+        c,
+        r
+      );
+      if (!b(n))
+        for (const i of n.issues)
+          s.addIssue({ code: "custom", message: i.message });
+    })
+  );
+}
+function z(m, t, e) {
+  const c = o(m.messages?.invalid, t) ?? U;
+  let r = l(a(), c).check(
+    u((s) => s.every(y), { error: c })
+  );
+  if (m.required === !0 && (r = r.check(u((s) => s.length > 0, { error: e }))), typeof m.minItems == "number") {
+    const s = o(m.messages?.minItems, t), n = m.minItems;
+    r = r.check(
+      s ? u((i) => i.length >= n, { error: s }) : x(n)
+    );
+  }
+  if (typeof m.maxItems == "number") {
+    const s = o(m.messages?.maxItems, t), n = m.maxItems;
+    r = r.check(
+      s ? u((i) => i.length <= n, { error: s }) : M(n)
+    );
+  }
+  if (m.blockPendingUploads !== !1) {
+    const s = o(m.messages?.pendingUploads, t) ?? F;
+    r = r.check(
+      u(
+        (n) => n.every((i) => !y(i) || i.status === "uploaded"),
+        { error: s }
+      )
+    );
+  }
+  return r;
+}
+function v(m, t) {
+  return f(m, (e) => {
+    let c = a();
+    return A(
       Object.keys(e),
       // filter non-custom validator keys
-      (s) => s !== "type" && s !== "required",
-      (s) => {
-        const r = e[s], t = n[s];
-        if (!t) {
-          const a = Object.keys(n).map((h) => `"${h}"`).join(", ");
+      (r) => r !== "type" && r !== "required",
+      (r) => {
+        const s = e[r], n = t[r];
+        if (!n) {
+          const d = Object.keys(t).map((p) => `"${p}"`).join(", ");
           throw new Error(
-            `Unknown custom validator rule "${s}". Registered rules: ${a || "(none)"}.`
+            `Unknown custom validator rule "${r}". Registered rules: ${d || "(none)"}.`
           );
         }
-        const m = t(r);
+        const i = n(s);
         c = c.check(
-          V((a, h) => {
-            const l = M(
-              m,
-              a
+          h((d, p) => {
+            const E = I(
+              i,
+              d
             );
-            if (!O(l)) {
-              const L = l.issues[0];
-              h.addIssue({
+            if (!b(E)) {
+              const O = E.issues[0];
+              p.addIssue({
                 code: "custom",
                 path: [],
-                message: L?.message || `Validation failed for ${s}`
+                message: O?.message || `Validation failed for ${r}`
               });
             }
           })
@@ -209,10 +282,10 @@ function H(i, n) {
     ), c;
   });
 }
-function f(i, n) {
-  const e = n(i);
-  return i.required ? e : N(e);
+function f(m, t) {
+  const e = t(m);
+  return m.required ? e : R(e);
 }
 export {
-  Y as initValidators
+  ne as initValidators
 };

package/index.umd.cjs

@@ -1 +1 @@
-(function(i,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("@golemui/core"),require("@standard-schema/spec"),require("zod"),require("zod/mini")):typeof define=="function"&&define.amd?define(["exports","@golemui/core","@standard-schema/spec","zod","zod/mini"],f):(i=typeof globalThis<"u"?globalThis:i||self,f(i["gui-validators"]={},i.core,null,i.zod,i.mini))})(this,(function(i,f,L,g,n){"use strict";const p={email:{schema:n.email()},hostname:{schema:n.hostname()},ipv4:{schema:n.ipv4()},ipv6:{schema:n.ipv6()},url:{schema:n.url()},uuid:{schema:n.uuid()},date:{schema:g.iso.date()},time:{schema:g.iso.time()},"date-time":{schema:g.iso.datetime({local:!0,offset:!0})},duration:{schema:g.iso.duration()}},y=Object.keys(p),k=u=>(o,e)=>{switch(o.type){case"string":return b(o,e);case"integer":case"number":return M(o,e);case"boolean":return q(o,e);case"array":return V(o,e);case"custom":{if(!u)throw new Error('Validator type "custom" requires a customValidators object, but it was not supplied.');return S(o,u)}default:{const a=o;throw new Error(`Unknown validator config: ${JSON.stringify(a)}. The "type" property must be one of: "string", "number", "integer", "boolean", "array", "custom".`)}}};function m(u,o){if(u!==void 0)return typeof u=="string"?u:o?.translate(u.key,u.params,u.default)??u.default}function b(u,o){return d(u,e=>{const a=m(e.messages?.invalid,o);let s=a?n.string(a):n.string();if(e.required===!0){const r=m(e.messages?.required,o)??"This field is required";s=s.check(n.refine(t=>t.length>0,{error:r}))}if(typeof e.minLength=="number"){const r=m(e.messages?.minLength,o),t=e.minLength;s=s.check(r?n.refine(c=>c.length>=t,{error:r}):n.minLength(t))}if(typeof e.maxLength=="number"){const r=m(e.messages?.maxLength,o),t=e.maxLength;s=s.check(r?n.refine(c=>c.length<=t,{error:r}):n.maxLength(t))}if(typeof e.pattern=="string"){const r=m(e.messages?.pattern,o),t=new RegExp(e.pattern);s=s.check(r?n.refine(c=>t.test(c),{error:r}):n.regex(t))}if(e.enum){const r=e.enum,t=m(e.messages?.enum,o);s=s.check(n.refine(c=>r.includes(c),t?{error:t}:void 0))}if(e.const!==void 0){const r=m(e.messages?.const,o);s=s.check(n.refine(t=>t===e.const,r?{error:r}:void 0))}if(e.format!==void 0)if(y.includes(e.format)){const r=m(e.messages?.format,o);s=s.check(r?n.superRefine((t,c)=>{const h=f.standardValidate(p[e.format].schema,t);f.isStandardValidateSuccess(h)||c.addIssue({code:"custom",path:[],message:r})}):p[e.format].schema)}else throw new Error(`Unknown string validation format: ${JSON.stringify(e.format)}. The "format" property must be one of: ${y.map(r=>`"${r}"`).join(", ")}.`);return s})}const w=(u,o)=>{if(o===0)return!1;const e=u/o;return Math.abs(e-Math.round(e))<1e-10};function M(u,o){return d(u,e=>{const a=m(e.messages?.invalid,o);let s=a?n.number(a):n.number();if(e.type==="integer"&&(s=s.check(n.int())),e.minimum!==void 0){const r=m(e.messages?.minimum,o),t=e.minimum;s=s.check(r?n.refine(c=>c>=t,{error:r}):n.minimum(t))}if(e.maximum!==void 0){const r=m(e.messages?.maximum,o),t=e.maximum;s=s.check(r?n.refine(c=>c<=t,{error:r}):n.maximum(t))}if(e.exclusiveMinimum!==void 0){const r=m(e.messages?.exclusiveMinimum,o),t=e.exclusiveMinimum;s=s.check(n.refine(c=>c>t,r?{error:r}:void 0))}if(e.exclusiveMaximum!==void 0){const r=m(e.messages?.exclusiveMaximum,o),t=e.exclusiveMaximum;s=s.check(n.refine(c=>c<t,r?{error:r}:void 0))}if(e.multipleOf!==void 0){const r=m(e.messages?.multipleOf,o),t=e.multipleOf;s=s.check(n.refine(c=>w(c,t),r?{error:r}:void 0))}if(e.enum){const r=e.enum,t=m(e.messages?.enum,o);s=s.check(n.refine(c=>r.includes(c),t?{error:t}:void 0))}if(e.const!==void 0){const r=m(e.messages?.const,o);s=s.check(n.refine(t=>t===e.const,r?{error:r}:void 0))}return s})}function q(u,o){return d(u,e=>{const a=m(e.messages?.invalid,o);let s=a?n.boolean(a):n.boolean();if(e.const!==void 0){const r=m(e.messages?.const,o);s=s.check(n.refine(t=>t===e.const,r?{error:r}:void 0))}return s})}function V(u,o){return d(u,e=>{const a=m(e.messages?.invalid,o);let s=a?n.array(n.any(),a):n.array(n.any());if(e.required===!0){const r=m(e.messages?.required,o)??"This field is required";s=s.check(n.refine(t=>t.length>0,{error:r}))}if(typeof e.minItems=="number"){const r=m(e.messages?.minItems,o),t=e.minItems;s=s.check(r?n.refine(c=>c.length>=t,{error:r}):n.minLength(t))}if(typeof e.maxItems=="number"){const r=m(e.messages?.maxItems,o),t=e.maxItems;s=s.check(r?n.refine(c=>c.length<=t,{error:r}):n.maxLength(t))}return s})}function S(u,o){return d(u,e=>{let a=n.any();return f.filterTap(Object.keys(e),s=>s!=="type"&&s!=="required",s=>{const r=e[s],t=o[s];if(!t){const h=Object.keys(o).map(l=>`"${l}"`).join(", ");throw new Error(`Unknown custom validator rule "${s}". Registered rules: ${h||"(none)"}.`)}const c=t(r);a=a.check(n.superRefine((h,l)=>{const x=f.standardValidate(c,h);if(!f.isStandardValidateSuccess(x)){const O=x.issues[0];l.addIssue({code:"custom",path:[],message:O?.message||`Validation failed for ${s}`})}}))}),a})}function d(u,o){const e=o(u);return u.required?e:n.optional(e)}i.initValidators=k,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));
+(function(i,d){typeof exports=="object"&&typeof module<"u"?d(exports,require("@golemui/core"),require("@standard-schema/spec"),require("zod"),require("zod/mini")):typeof define=="function"&&define.amd?define(["exports","@golemui/core","@standard-schema/spec","zod","zod/mini"],d):(i=typeof globalThis<"u"?globalThis:i||self,d(i["gui-validators"]={},i.core,null,i.zod,i.mini))})(this,(function(i,d,j,h,o){"use strict";const p={email:{schema:o.email()},hostname:{schema:o.hostname()},ipv4:{schema:o.ipv4()},ipv6:{schema:o.ipv6()},url:{schema:o.url()},uuid:{schema:o.uuid()},date:{schema:h.iso.date()},time:{schema:h.iso.time()},"date-time":{schema:h.iso.datetime({local:!0,offset:!0})},duration:{schema:h.iso.duration()}},k=Object.keys(p),S=["uploading","uploaded","error"],q=u=>(t,e)=>{switch(t.type){case"string":return E(t,e);case"integer":case"number":return L(t,e);case"boolean":return w(t,e);case"array":return O(t,e);case"file":return T(t,e);case"files":return U(t,e);case"custom":{if(!u)throw new Error('Validator type "custom" requires a customValidators object, but it was not supplied.');return A(t,u)}default:{const m=t;throw new Error(`Unknown validator config: ${JSON.stringify(m)}. The "type" property must be one of: "string", "number", "integer", "boolean", "array", "file", "files", "custom".`)}}};function a(u,t){if(u!==void 0)return typeof u=="string"?u:t?.translate(u.key,u.params,u.default)??u.default}function E(u,t){return f(u,e=>{const m=a(e.messages?.invalid,t);let r=m?o.string(m):o.string();if(e.required===!0){const s=a(e.messages?.required,t)??"This field is required";r=r.check(o.refine(n=>n.length>0,{error:s}))}if(typeof e.minLength=="number"){const s=a(e.messages?.minLength,t),n=e.minLength;r=r.check(s?o.refine(c=>c.length>=n,{error:s}):o.minLength(n))}if(typeof e.maxLength=="number"){const s=a(e.messages?.maxLength,t),n=e.maxLength;r=r.check(s?o.refine(c=>c.length<=n,{error:s}):o.maxLength(n))}if(typeof e.pattern=="string"){const s=a(e.messages?.pattern,t),n=new RegExp(e.pattern);r=r.check(s?o.refine(c=>n.test(c),{error:s}):o.regex(n))}if(e.enum){const s=e.enum,n=a(e.messages?.enum,t);r=r.check(o.refine(c=>s.includes(c),n?{error:n}:void 0))}if(e.const!==void 0){const s=a(e.messages?.const,t);r=r.check(o.refine(n=>n===e.const,s?{error:s}:void 0))}if(e.format!==void 0)if(k.includes(e.format)){const s=a(e.messages?.format,t);r=r.check(s?o.superRefine((n,c)=>{const g=d.standardValidate(p[e.format].schema,n);d.isStandardValidateSuccess(g)||c.addIssue({code:"custom",path:[],message:s})}):p[e.format].schema)}else throw new Error(`Unknown string validation format: ${JSON.stringify(e.format)}. The "format" property must be one of: ${k.map(s=>`"${s}"`).join(", ")}.`);return r})}const V=(u,t)=>{if(t===0)return!1;const e=u/t;return Math.abs(e-Math.round(e))<1e-10};function L(u,t){return f(u,e=>{const m=a(e.messages?.invalid,t);let r=m?o.number(m):o.number();if(e.type==="integer"&&(r=r.check(o.int())),e.minimum!==void 0){const s=a(e.messages?.minimum,t),n=e.minimum;r=r.check(s?o.refine(c=>c>=n,{error:s}):o.minimum(n))}if(e.maximum!==void 0){const s=a(e.messages?.maximum,t),n=e.maximum;r=r.check(s?o.refine(c=>c<=n,{error:s}):o.maximum(n))}if(e.exclusiveMinimum!==void 0){const s=a(e.messages?.exclusiveMinimum,t),n=e.exclusiveMinimum;r=r.check(o.refine(c=>c>n,s?{error:s}:void 0))}if(e.exclusiveMaximum!==void 0){const s=a(e.messages?.exclusiveMaximum,t),n=e.exclusiveMaximum;r=r.check(o.refine(c=>c<n,s?{error:s}:void 0))}if(e.multipleOf!==void 0){const s=a(e.messages?.multipleOf,t),n=e.multipleOf;r=r.check(o.refine(c=>V(c,n),s?{error:s}:void 0))}if(e.enum){const s=e.enum,n=a(e.messages?.enum,t);r=r.check(o.refine(c=>s.includes(c),n?{error:n}:void 0))}if(e.const!==void 0){const s=a(e.messages?.const,t);r=r.check(o.refine(n=>n===e.const,s?{error:s}:void 0))}return r})}function w(u,t){return f(u,e=>{const m=a(e.messages?.invalid,t);let r=m?o.boolean(m):o.boolean();if(e.const!==void 0){const s=a(e.messages?.const,t);r=r.check(o.refine(n=>n===e.const,s?{error:s}:void 0))}return r})}function O(u,t){return f(u,e=>{const m=a(e.messages?.invalid,t);let r=m?o.array(o.any(),m):o.array(o.any());if(e.required===!0){const s=a(e.messages?.required,t)??"This field is required";r=r.check(o.refine(n=>n.length>0,{error:s}))}if(typeof e.minItems=="number"){const s=a(e.messages?.minItems,t),n=e.minItems;r=r.check(s?o.refine(c=>c.length>=n,{error:s}):o.minLength(n))}if(typeof e.maxItems=="number"){const s=a(e.messages?.maxItems,t),n=e.maxItems;r=r.check(s?o.refine(c=>c.length<=n,{error:s}):o.maxLength(n))}return r})}const b="This field is required",I="Invalid file",x="Wait for the upload to finish";function l(u){if(u===null||typeof u!="object")return!1;const t=u;return typeof t.id=="string"&&typeof t.name=="string"&&typeof t.size=="number"&&typeof t.type=="string"&&typeof t.status=="string"&&S.includes(t.status)}function T(u,t){const e=a(u.messages?.invalid,t)??I,m=a(u.messages?.required,t)??b,r=a(u.messages?.pendingUploads,t)??x,s=u.blockPendingUploads!==!1;return o.any().check(o.superRefine((n,c)=>{if(n==null){u.required===!0&&c.addIssue({code:"custom",message:m});return}if(!l(n)){c.addIssue({code:"custom",message:e});return}s&&n.status!=="uploaded"&&c.addIssue({code:"custom",message:r})}))}function U(u,t){const e=a(u.messages?.required,t)??b,m=F(u,t,e);return o.any().check(o.superRefine((r,s)=>{if(r==null){u.required===!0&&s.addIssue({code:"custom",message:e});return}const n=d.standardValidate(m,r);if(!d.isStandardValidateSuccess(n))for(const c of n.issues)s.addIssue({code:"custom",message:c.message})}))}function F(u,t,e){const m=a(u.messages?.invalid,t)??I;let r=o.array(o.any(),m).check(o.refine(s=>s.every(l),{error:m}));if(u.required===!0&&(r=r.check(o.refine(s=>s.length>0,{error:e}))),typeof u.minItems=="number"){const s=a(u.messages?.minItems,t),n=u.minItems;r=r.check(s?o.refine(c=>c.length>=n,{error:s}):o.minLength(n))}if(typeof u.maxItems=="number"){const s=a(u.messages?.maxItems,t),n=u.maxItems;r=r.check(s?o.refine(c=>c.length<=n,{error:s}):o.maxLength(n))}if(u.blockPendingUploads!==!1){const s=a(u.messages?.pendingUploads,t)??x;r=r.check(o.refine(n=>n.every(c=>!l(c)||c.status==="uploaded"),{error:s}))}return r}function A(u,t){return f(u,e=>{let m=o.any();return d.filterTap(Object.keys(e),r=>r!=="type"&&r!=="required",r=>{const s=e[r],n=t[r];if(!n){const g=Object.keys(t).map(y=>`"${y}"`).join(", ");throw new Error(`Unknown custom validator rule "${r}". Registered rules: ${g||"(none)"}.`)}const c=n(s);m=m.check(o.superRefine((g,y)=>{const M=d.standardValidate(c,g);if(!d.isStandardValidateSuccess(M)){const _=M.issues[0];y.addIssue({code:"custom",path:[],message:_?.message||`Validation failed for ${r}`})}}))}),m})}function f(u,t){const e=t(u);return u.required?e:o.optional(e)}i.initValidators=q,Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})}));

package/lib/validators.d.ts

@@ -65,6 +65,26 @@ export interface ArrayValidator extends BaseValidator {
     uniqueItems?: boolean;
     items?: Validator;
 }
+/**
+ * Validates the envelope stored by the `fileUpload` widget (`FileItem | null`).
+ * `blockPendingUploads` (default `true`) fails while the item's status is not
+ * `uploaded`, so an in-progress or failed upload cannot be submitted.
+ */
+export interface FileValidator extends BaseValidator {
+    type: 'file';
+    blockPendingUploads?: boolean;
+}
+/**
+ * Validates the envelope array stored by the `multiFileUpload` widget
+ * (`FileItem[]`). `required` means non-empty, like `array`. An absent value
+ * (`undefined` or `null`) counts as empty.
+ */
+export interface FilesValidator extends BaseValidator {
+    type: 'files';
+    minItems?: number;
+    maxItems?: number;
+    blockPendingUploads?: boolean;
+}
 export interface CustomValidator {
     type: 'custom';
     required?: boolean;
@@ -74,6 +94,6 @@ export type CustomValidatorSchemaFn = (input: any) => StandardSchemaV1;
 export type CustomValidatorSchemas = {
     [key: string]: CustomValidatorSchemaFn;
 };
-export type Validator = StringValidator | NumberValidator | BooleanValidator | ArrayValidator | CustomValidator;
+export type Validator = StringValidator | NumberValidator | BooleanValidator | ArrayValidator | FileValidator | FilesValidator | CustomValidator;
 export declare const initValidators: (customValidators?: CustomValidatorSchemas) => ValidatorFn<Validator>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@golemui/gui-validators",
-  "version": "1.4.0",
+  "version": "1.5.0-rc.1",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -26,7 +26,7 @@
   "peerDependencies": {
     "zod": "^4.0.0",
     "@standard-schema/spec": "^1.0.0",
-    "@golemui/core": "1.4.0"
+    "@golemui/core": "1.5.0-rc.1"
   },
   "repository": {
     "type": "git",