cogsbox-state 0.5.126 → 0.5.127

package/dist/Functions.jsx

@@ -1,39 +1,39 @@
-import { jsx as v, Fragment as I } from "react/jsx-runtime";
+import { jsx as V, Fragment as M } from "react/jsx-runtime";
 import "./CogsState.jsx";
-import { getNestedValue as F, isFunction as B, updateNestedProperty as V } from "./utility.js";
-import G, { useState as N, useRef as y, useEffect as b } from "react";
-import { getGlobalStore as l, formRefStore as W } from "./store.js";
-import { validateZodPathFunc as Y } from "./useValidateZodPath.js";
-function Z(o, t, n, r) {
-  o(
-    (e) => {
-      if (B(t)) {
-        const s = t(F(e, n));
-        let i = V(n, e, s);
+import { getNestedValue as R, isFunction as U, updateNestedProperty as F } from "./utility.js";
+import G, { useRef as b, useState as z, useEffect as j } from "react";
+import { getGlobalStore as d, formRefStore as O } from "./store.js";
+import { validateZodPathFunc as W } from "./useValidateZodPath.js";
+function I(n, e, t, r) {
+  n(
+    (o) => {
+      if (U(e)) {
+        const s = e(R(o, t));
+        let i = F(t, o, s);
         return typeof i == "string" && (i = i.trim()), i;
       } else {
-        let s = !n || n.length == 0 ? t : V(n, e, t);
+        let s = !t || t.length == 0 ? e : F(t, o, e);
         return typeof s == "string" && (s = s.trim()), s;
       }
     },
-    n,
+    t,
     { updateType: "update" },
     r
   );
 }
-function tt(o, t, n, r, e) {
-  const s = l.getState().getNestedState(r, n);
-  o(
+function p(n, e, t, r, o) {
+  const s = d.getState().getNestedState(r, t);
+  n(
     (i) => {
-      let u = !n || n.length == 0 ? i : F(i, [...n]), c = [...u];
+      let u = !t || t.length == 0 ? i : R(i, [...t]), c = [...u];
       return c.splice(
-        Number(e) == 0 ? e : u.length,
+        Number(o) == 0 ? o : u.length,
         0,
-        B(t) ? t(u) : t
-      ), n.length == 0 ? c : V([...n], i, c);
+        U(e) ? e(u) : e
+      ), t.length == 0 ? c : F([...t], i, c);
     },
     [
-      ...n,
+      ...t,
       (s.length - 1).toString()
     ],
     {
@@ -41,173 +41,162 @@ function tt(o, t, n, r, e) {
     }
   );
 }
-function et(o, t, n, r) {
-  const e = l.getState().getNestedState(n, t);
-  o(
+function ee(n, e, t, r) {
+  const o = d.getState().getNestedState(t, e);
+  n(
     (s) => {
-      const i = F(s, [...t]);
+      const i = R(s, [...e]);
       if (r < 0 || r >= i?.length)
         throw new Error(`Index ${r} does not exist in the array.`);
       const u = r || Number(r) == 0 ? r : i.length - 1, c = [
         ...i.slice(0, u),
         ...i.slice(u + 1)
       ];
-      return t.length == 0 ? c : V([...t], s, c);
+      return e.length == 0 ? c : F([...e], s, c);
     },
     [
-      ...t,
-      r || r === 0 ? r?.toString() : (e.length - 1).toString()
+      ...e,
+      r || r === 0 ? r?.toString() : (o.length - 1).toString()
     ],
     { updateType: "cut" }
   );
 }
-const R = (o, t, n = (r, e) => JSON.stringify(r) === JSON.stringify(e)) => {
-  const [r, e] = N(
-    () => t(l.getState(), o)
-  ), s = y(r), i = y(o);
-  return b(() => {
-    i.current = o, e(t(l.getState(), o));
-    const u = (d) => {
-      const a = t(d, i.current);
-      n(s.current, a) || (s.current = a, e(a));
-    }, c = l.subscribe(u);
+const N = (n, e, t = (r, o) => JSON.stringify(r) === JSON.stringify(o)) => {
+  const [r, o] = z(
+    () => e(d.getState(), n)
+  ), s = b(r), i = b(n);
+  return j(() => {
+    i.current = n, o(e(d.getState(), n));
+    const u = (f) => {
+      const l = e(f, i.current);
+      t(s.current, l) || (s.current = l, o(l));
+    }, c = d.subscribe(u);
     return () => {
       c();
     };
-  }, [o]), r;
-}, _ = (o, t, n) => {
-  const r = o + "." + (t.length > 0 ? [t.join(".")] : []) + (n && n.length > 0 ? "." + n : "");
-  return R(
+  }, [n]), r;
+}, Z = (n, e, t) => {
+  const r = n + "." + (e.length > 0 ? [e.join(".")] : []) + (t && t.length > 0 ? "." + t : "");
+  return N(
     r,
     (s, i) => s.getValidationErrors(i) || []
   );
-}, q = (o, t) => {
-  const n = `${o}:${t.join(".")}`;
-  return R(
-    n,
-    (r, e) => r.getSyncInfo(e)
+}, q = (n, e) => {
+  const t = `${n}:${e.join(".")}`;
+  return N(
+    t,
+    (r, o) => r.getSyncInfo(o)
   );
-}, H = (o, t) => R(
-  `${o}:${t.join(".")}`,
-  (n, r) => n.getNestedState(o, t)
-), nt = ({
-  setState: o,
-  path: t,
-  child: n,
+}, H = (n, e) => N(
+  `${n}:${e.join(".")}`,
+  (t, r) => t.getNestedState(n, e)
+), te = ({
+  setState: n,
+  // This is the real effectiveSetState from the hook
+  path: e,
+  child: t,
   formOpts: r,
-  stateKey: e
+  stateKey: o
 }) => {
-  const [s, i] = N({}), { registerFormRef: u, getFormRef: c } = W.getState(), d = e + "." + t.join("."), a = y(null), T = c(d);
-  T || u(e + "." + t.join("."), a);
-  const M = T || a, {
-    getValidationErrors: U,
-    addValidationError: z,
-    getInitialOptions: A,
-    removeValidationError: w
-  } = l.getState(), E = H(e, t), [k, C] = N(
-    l.getState().getNestedState(e, t)
-  ), m = A(e);
-  if (!m?.validation?.key)
-    throw new Error(
-      "Validation key not found. You need to set it in the options for the createCogsState function"
-    );
-  const f = m.validation.key;
-  m.validation.onBlur, b(() => {
-    C(E);
-  }, [e, t.join("."), E]);
-  const S = y();
-  let $ = (g, O) => {
-    C(g), S.current && clearTimeout(S.current), S.current = setTimeout(
+  const { registerFormRef: s, getFormRef: i } = O.getState(), {
+    getValidationErrors: u,
+    addValidationError: c,
+    getInitialOptions: f,
+    removeValidationError: l
+  } = d.getState(), w = o + "." + e.join("."), k = b(null), C = i(w);
+  C || s(w, k);
+  const A = C || k, S = H(o, e), [E, $] = z(S), y = b(!1), m = b(null);
+  j(() => {
+    !y.current && S !== E && $(S);
+  }, [S]), j(() => () => {
+    m.current && (clearTimeout(m.current), y.current = !1);
+  }, []);
+  const B = (a) => {
+    $(a), y.current = !0, m.current && clearTimeout(m.current), m.current = setTimeout(
       () => {
-        Z(o, g, t, f);
+        y.current = !1, I(n, a, e, g);
       },
-      r?.debounceTime ?? (typeof E == "boolean" ? 20 : 200)
+      r?.debounceTime ?? (typeof S == "boolean" ? 20 : 200)
     );
-  };
-  const J = async () => {
-    if (m.validation?.zodSchema) {
-      w(f + "." + t.join("."));
+  }, v = f(o);
+  if (!v?.validation?.key)
+    throw new Error("Validation key not found.");
+  const g = v.validation.key, D = v.validation.onBlur === !0, J = async () => {
+    if (m.current && (clearTimeout(m.current), y.current = !1, I(n, E, e, g)), !(!v.validation?.zodSchema || !D)) {
+      l(g + "." + e.join("."));
       try {
-        const g = l.getState().getNestedState(e, t);
-        await Y(
-          f,
-          m.validation.zodSchema,
-          t,
-          g
-        ), i({});
-      } catch (g) {
-        console.error("Validation error:", g);
+        const a = d.getState().getNestedState(o, e);
+        await W(
+          g,
+          v.validation.zodSchema,
+          e,
+          a
+        );
+      } catch (a) {
+        console.error("Validation error on blur:", a);
       }
     }
-  };
-  b(() => () => {
-    S.current && clearTimeout(S.current);
-  }, []);
-  const j = q(e, t), P = j ? {
-    ...j,
-    date: new Date(j.timeStamp)
-  } : null, D = n({
-    get: () => k || l.getState().getNestedState(e, t),
-    set: $,
+  }, T = q(o, e), P = T ? { ...T, date: new Date(T.timeStamp) } : null, L = t({
+    // --- START CHANGES ---
+    get: () => E,
+    // Get should return the immediate local value
+    set: B,
+    // Use the new debounced updater
+    // --- END CHANGES ---
     syncStatus: P,
-    path: t,
-    validationErrors: () => U(f + "." + t.join(".")),
-    addValidationError: (g) => {
-      w(f + "." + t.join(".")), z(f + "." + t.join("."), g ?? "");
+    path: e,
+    validationErrors: () => u(g + "." + e.join(".")),
+    addValidationError: (a) => {
+      l(g + "." + e.join(".")), c(g + "." + e.join("."), a ?? "");
     },
     inputProps: {
-      value: k || l.getState().getNestedState(e, t) || "",
-      onChange: (g) => $(g.target.value),
+      // --- START CHANGES ---
+      value: E ?? "",
+      // Input value is always the local state
+      onChange: (a) => B(a.target.value),
+      // Use debounced updater
+      // --- END CHANGES ---
       onBlur: J,
-      ref: M
+      ref: A
     }
   });
-  return /* @__PURE__ */ v(I, { children: /* @__PURE__ */ v(
-    L,
-    {
-      formOpts: r,
-      path: t,
-      validationKey: f,
-      stateKey: e,
-      children: D
-    }
-  ) });
+  return /* @__PURE__ */ V(M, { children: /* @__PURE__ */ V(Q, { formOpts: r, path: e, validationKey: g, stateKey: o, children: L }) });
 };
-function L({
-  formOpts: o,
-  path: t,
-  validationKey: n,
+function Q({
+  formOpts: n,
+  path: e,
+  validationKey: t,
   stateKey: r,
-  children: e,
+  children: o,
   validIndices: s
 }) {
-  const { getInitialOptions: i } = l.getState(), u = _(
-    n,
+  const { getInitialOptions: i } = d.getState(), u = Z(
     t,
+    e,
     s
   ), c = [];
   if (u) {
-    const a = u.join(", ");
-    c.includes(a) || c.push(a);
+    const l = u.join(", ");
+    c.includes(l) || c.push(l);
   }
-  const d = i(r);
-  return /* @__PURE__ */ v(I, { children: d?.formElements?.validation && !o?.validation?.disable ? d.formElements.validation({
-    children: /* @__PURE__ */ v(G.Fragment, { children: e }, t.toString()),
+  const f = i(r);
+  return /* @__PURE__ */ V(M, { children: f?.formElements?.validation && !n?.validation?.disable ? f.formElements.validation({
+    children: /* @__PURE__ */ V(G.Fragment, { children: o }, e.toString()),
     active: u.length > 0,
-    message: o?.validation?.hideMessage ? "" : o?.validation?.message ? o?.validation?.message : c.map((a) => a).join(", "),
-    path: t,
-    ...o?.key && { key: o?.key }
-  }) : /* @__PURE__ */ v(G.Fragment, { children: e }, t.toString()) });
+    message: n?.validation?.hideMessage ? "" : n?.validation?.message ? n?.validation?.message : c.map((l) => l).join(", "),
+    path: e,
+    ...n?.key && { key: n?.key }
+  }) : /* @__PURE__ */ V(G.Fragment, { children: o }, e.toString()) });
 }
 export {
-  nt as FormControlComponent,
-  L as ValidationWrapper,
-  et as cutFunc,
-  tt as pushFunc,
-  Z as updateFn,
+  te as FormControlComponent,
+  Q as ValidationWrapper,
+  ee as cutFunc,
+  p as pushFunc,
+  I as updateFn,
   H as useGetKeyState,
   q as useGetSyncInfo,
-  _ as useGetValidationErrors,
-  R as useStoreSubscription
+  Z as useGetValidationErrors,
+  N as useStoreSubscription
 };
 //# sourceMappingURL=Functions.jsx.map

package/dist/Functions.jsx.map

@@ -1 +1 @@
-{"version":3,"file":"Functions.jsx","sources":["../src/Functions.tsx"],"sourcesContent":["import {\r\n  notifyComponent,\r\n  type EffectiveSetState,\r\n  type FormElementParams,\r\n  type FormOptsType,\r\n  type UpdateArg,\r\n  type UpdateOpts,\r\n} from \"./CogsState\";\r\n\r\nimport { getNestedValue, isFunction, updateNestedProperty } from \"./utility\";\r\nimport { useEffect, useRef, useState } from \"react\";\r\nimport React from \"react\";\r\nimport { getGlobalStore, formRefStore } from \"./store\";\r\nimport { validateZodPathFunc } from \"./useValidateZodPath\";\r\n\r\nexport function updateFn<U>(\r\n  setState: EffectiveSetState<U>,\r\n  payload: UpdateArg<U>,\r\n  path: string[],\r\n  validationKey?: string\r\n): void {\r\n  setState(\r\n    (prevState) => {\r\n      if (isFunction<U>(payload)) {\r\n        const nestedValue = payload(getNestedValue(prevState, path));\r\n        let value = updateNestedProperty(path, prevState, nestedValue);\r\n        if (typeof value == \"string\") {\r\n          value = value.trim();\r\n        }\r\n        return value;\r\n      } else {\r\n        let value =\r\n          !path || path.length == 0\r\n            ? payload\r\n            : updateNestedProperty(path, prevState, payload);\r\n        if (typeof value == \"string\") {\r\n          value = value.trim();\r\n        }\r\n        return value;\r\n      }\r\n    },\r\n    path,\r\n    { updateType: \"update\" },\r\n    validationKey\r\n  );\r\n}\r\n\r\nexport function pushFunc<U>(\r\n  setState: EffectiveSetState<U>,\r\n  payload: UpdateArg<U>,\r\n  path: string[],\r\n  stateKey: string,\r\n  index?: number\r\n): void {\r\n  const array = getGlobalStore.getState().getNestedState(stateKey, path) as U[];\r\n  setState(\r\n    (prevState) => {\r\n      let arrayToUpdate =\r\n        !path || path.length == 0\r\n          ? prevState\r\n          : getNestedValue(prevState, [...path]);\r\n      let returnedArray = [...arrayToUpdate];\r\n\r\n      returnedArray.splice(\r\n        index || Number(index) == 0 ? index : arrayToUpdate.length,\r\n        0,\r\n        isFunction<U>(payload)\r\n          ? payload(index == -1 ? undefined : arrayToUpdate)\r\n          : payload\r\n      );\r\n      const value =\r\n        path.length == 0\r\n          ? returnedArray\r\n          : updateNestedProperty([...path], prevState, returnedArray);\r\n\r\n      return value as U;\r\n    },\r\n    [\r\n      ...path,\r\n      index || index === 0 ? index?.toString() : (array!.length - 1).toString(),\r\n    ],\r\n    {\r\n      updateType: \"insert\",\r\n    }\r\n  );\r\n}\r\n\r\nexport function cutFunc<U>(\r\n  setState: EffectiveSetState<U>,\r\n  path: string[],\r\n  stateKey: string,\r\n  index: number\r\n): void {\r\n  const array = getGlobalStore.getState().getNestedState(stateKey, path) as U[];\r\n  setState(\r\n    (prevState) => {\r\n      const arrayToUpdate = getNestedValue(prevState, [...path]);\r\n      if (index < 0 || index >= arrayToUpdate?.length) {\r\n        throw new Error(`Index ${index} does not exist in the array.`);\r\n      }\r\n      const indexToCut =\r\n        index || Number(index) == 0 ? index : arrayToUpdate.length - 1;\r\n\r\n      const updatedArray = [\r\n        ...arrayToUpdate.slice(0, indexToCut),\r\n        ...arrayToUpdate.slice(indexToCut + 1),\r\n      ] as U;\r\n\r\n      return path.length == 0\r\n        ? updatedArray\r\n        : updateNestedProperty([...path], prevState, updatedArray);\r\n    },\r\n    [\r\n      ...path,\r\n      index || index === 0 ? index?.toString() : (array!.length - 1).toString(),\r\n    ],\r\n    { updateType: \"cut\" }\r\n  );\r\n}\r\n\r\nexport const useStoreSubscription = <T,>(\r\n  fullPath: string,\r\n  selector: (\r\n    store: ReturnType<typeof getGlobalStore.getState>,\r\n    path: string\r\n  ) => T,\r\n  compare: (a: T, b: T) => boolean = (a, b) =>\r\n    JSON.stringify(a) === JSON.stringify(b)\r\n) => {\r\n  const [value, setValue] = useState<T>(() =>\r\n    selector(getGlobalStore.getState(), fullPath)\r\n  );\r\n  const previousValueRef = useRef<T>(value);\r\n  const fullPathRef = useRef(fullPath);\r\n  useEffect(() => {\r\n    fullPathRef.current = fullPath; // Ensure latest fullPath is always used\r\n\r\n    setValue(selector(getGlobalStore.getState(), fullPath));\r\n\r\n    const callback = (store: any) => {\r\n      const newValue = selector(store, fullPathRef.current);\r\n\r\n      if (!compare(previousValueRef.current, newValue)) {\r\n        previousValueRef.current = newValue;\r\n        setValue(newValue);\r\n      }\r\n    };\r\n    const unsubscribe = getGlobalStore.subscribe(callback);\r\n    return () => {\r\n      unsubscribe();\r\n    };\r\n  }, [fullPath]);\r\n  return value;\r\n};\r\nexport const useGetValidationErrors = (\r\n  validationKey: string,\r\n  path: string[],\r\n  validIndices?: number[]\r\n) => {\r\n  const fullPath =\r\n    validationKey +\r\n    \".\" +\r\n    (path.length > 0 ? [path.join(\".\")] : []) +\r\n    (validIndices && validIndices.length > 0 ? \".\" + validIndices : \"\");\r\n\r\n  const returnresult = useStoreSubscription(\r\n    fullPath,\r\n    (store, path) => store.getValidationErrors(path) || []\r\n  );\r\n\r\n  return returnresult;\r\n};\r\n\r\nexport const useGetSyncInfo = (key: string, path: string[]) => {\r\n  const syncKey = `${key}:${path.join(\".\")}`;\r\n  return useStoreSubscription(syncKey, (store, path) =>\r\n    store.getSyncInfo(path)\r\n  );\r\n};\r\nexport const useGetKeyState = (key: string, path: string[]) => {\r\n  return useStoreSubscription(`${key}:${path.join(\".\")}`, (store, fullPath) =>\r\n    store.getNestedState(key, path)\r\n  );\r\n};\r\ninterface FormControlComponentProps<TStateObject> {\r\n  setState: EffectiveSetState<TStateObject>;\r\n\r\n  path: string[];\r\n  child: (obj: FormElementParams<TStateObject>) => JSX.Element;\r\n  formOpts?: FormOptsType;\r\n  stateKey: string;\r\n}\r\n\r\nexport const FormControlComponent = <TStateObject,>({\r\n  setState,\r\n  path,\r\n  child,\r\n  formOpts,\r\n  stateKey,\r\n}: FormControlComponentProps<TStateObject>) => {\r\n  const [_, forceUpdate] = useState({});\r\n  const { registerFormRef, getFormRef } = formRefStore.getState();\r\n  const refKey = stateKey + \".\" + path.join(\".\");\r\n\r\n  // Create a local ref\r\n  const localFormRef = useRef<HTMLInputElement>(null);\r\n\r\n  // Get existing ref from the store (if any)\r\n  const existingRef = getFormRef(refKey);\r\n  if (!existingRef) {\r\n    registerFormRef(stateKey + \".\" + path.join(\".\"), localFormRef);\r\n  }\r\n  // Use the existing ref if available, otherwise use the local one\r\n  const formRef = existingRef || localFormRef;\r\n\r\n  const {\r\n    getValidationErrors,\r\n    addValidationError,\r\n    getInitialOptions,\r\n    removeValidationError,\r\n  } = getGlobalStore.getState();\r\n  const stateValue = useGetKeyState(stateKey, path);\r\n  const [inputValue, setInputValue] = useState<any>(\r\n    getGlobalStore.getState().getNestedState(stateKey, path)\r\n  );\r\n\r\n  const initialOptions = getInitialOptions(stateKey);\r\n\r\n  if (!initialOptions?.validation?.key) {\r\n    throw new Error(\r\n      \"Validation key not found. You need to set it in the options for the createCogsState function\"\r\n    );\r\n  }\r\n  const validationKey = initialOptions.validation.key;\r\n  const validateOnBlur = initialOptions.validation.onBlur === true;\r\n  initialOptions;\r\n  useEffect(() => {\r\n    setInputValue(stateValue);\r\n  }, [stateKey, path.join(\".\"), stateValue]);\r\n\r\n  const timeoutRef = useRef<NodeJS.Timeout>();\r\n\r\n  // Standard updater function (unchanged)\r\n  let updater = (\r\n    payload: UpdateArg<TStateObject>,\r\n    opts?: UpdateOpts<TStateObject>\r\n  ) => {\r\n    setInputValue(payload);\r\n\r\n    if (timeoutRef.current) {\r\n      clearTimeout(timeoutRef.current);\r\n    }\r\n\r\n    timeoutRef.current = setTimeout(\r\n      () => {\r\n        updateFn(setState, payload, path, validationKey);\r\n      },\r\n      formOpts?.debounceTime ?? (typeof stateValue == \"boolean\" ? 20 : 200)\r\n    );\r\n  };\r\n\r\n  // Handle blur event\r\n  const handleBlur = async () => {\r\n    if (!initialOptions.validation?.zodSchema) return;\r\n    removeValidationError(validationKey + \".\" + path.join(\".\"));\r\n    try {\r\n      // Get the current field value\r\n      const fieldValue = getGlobalStore\r\n        .getState()\r\n        .getNestedState(stateKey, path);\r\n\r\n      // Use your existing validateZodPathFunc\r\n      await validateZodPathFunc(\r\n        validationKey,\r\n        initialOptions.validation.zodSchema,\r\n        path,\r\n        fieldValue\r\n      );\r\n\r\n      forceUpdate({});\r\n    } catch (error) {\r\n      console.error(\"Validation error:\", error);\r\n    }\r\n  };\r\n\r\n  // Clear timeout on unmount\r\n  useEffect(() => {\r\n    return () => {\r\n      if (timeoutRef.current) {\r\n        clearTimeout(timeoutRef.current);\r\n      }\r\n    };\r\n  }, []);\r\n\r\n  const rawSyncStatus = useGetSyncInfo(stateKey, path);\r\n  const syncStatus = rawSyncStatus\r\n    ? {\r\n        ...rawSyncStatus,\r\n        date: new Date(rawSyncStatus.timeStamp),\r\n      }\r\n    : null;\r\n\r\n  const childElement = child({\r\n    get: () =>\r\n      inputValue || getGlobalStore.getState().getNestedState(stateKey, path),\r\n    set: updater,\r\n    syncStatus,\r\n    path: path,\r\n    validationErrors: () =>\r\n      getValidationErrors(validationKey + \".\" + path.join(\".\")),\r\n    addValidationError: (message?: string) => {\r\n      removeValidationError(validationKey + \".\" + path.join(\".\"));\r\n      addValidationError(validationKey + \".\" + path.join(\".\"), message ?? \"\");\r\n    },\r\n\r\n    inputProps: {\r\n      value:\r\n        inputValue ||\r\n        getGlobalStore.getState().getNestedState(stateKey, path) ||\r\n        \"\",\r\n      onChange: (e: any) => updater(e.target.value),\r\n      onBlur: handleBlur,\r\n      ref: formRef,\r\n    },\r\n  });\r\n\r\n  return (\r\n    <>\r\n      <ValidationWrapper\r\n        {...{\r\n          formOpts,\r\n          path,\r\n          validationKey,\r\n          stateKey,\r\n        }}\r\n      >\r\n        {childElement}\r\n      </ValidationWrapper>\r\n    </>\r\n  );\r\n};\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n  validationKey,\r\n  stateKey,\r\n  children,\r\n  validIndices,\r\n}: {\r\n  formOpts?: FormOptsType;\r\n  path: string[];\r\n  validationKey: string;\r\n  stateKey?: string;\r\n  children: React.ReactNode;\r\n  validIndices?: number[];\r\n}) {\r\n  const { getInitialOptions } = getGlobalStore.getState();\r\n\r\n  const validationErrors = useGetValidationErrors(\r\n    validationKey,\r\n    path,\r\n    validIndices\r\n  );\r\n  // console.log(\r\n  //   \"validationErrors ValidationWrapper\",\r\n  //   stateKey,\r\n  //   validationKey,\r\n  //   path,\r\n  //   validationErrors\r\n  // );\r\n  const thesMessages: string[] = [];\r\n\r\n  if (validationErrors) {\r\n    const newMessage = validationErrors!.join(\", \");\r\n    if (!thesMessages.includes(newMessage)) {\r\n      thesMessages.push(newMessage);\r\n    }\r\n  }\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n\r\n  return (\r\n    <>\r\n      {thisStateOpts?.formElements?.validation &&\r\n      !formOpts?.validation?.disable ? (\r\n        thisStateOpts.formElements!.validation!({\r\n          children: (\r\n            <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n          ),\r\n          active: validationErrors.length > 0 ? true : false,\r\n          message: formOpts?.validation?.hideMessage\r\n            ? \"\"\r\n            : formOpts?.validation?.message\r\n              ? formOpts?.validation?.message\r\n              : thesMessages.map((m) => m).join(\", \"),\r\n          path: path,\r\n\r\n          ...(formOpts?.key && { key: formOpts?.key }),\r\n        })\r\n      ) : (\r\n        <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n      )}\r\n    </>\r\n  );\r\n}\r\n"],"names":["updateFn","setState","payload","path","validationKey","prevState","isFunction","nestedValue","getNestedValue","value","updateNestedProperty","pushFunc","stateKey","index","array","getGlobalStore","arrayToUpdate","returnedArray","cutFunc","indexToCut","updatedArray","useStoreSubscription","fullPath","selector","compare","a","b","setValue","useState","previousValueRef","useRef","fullPathRef","useEffect","callback","store","newValue","unsubscribe","useGetValidationErrors","validIndices","useGetSyncInfo","key","syncKey","useGetKeyState","FormControlComponent","child","formOpts","_","forceUpdate","registerFormRef","getFormRef","formRefStore","refKey","localFormRef","existingRef","formRef","getValidationErrors","addValidationError","getInitialOptions","removeValidationError","stateValue","inputValue","setInputValue","initialOptions","timeoutRef","updater","opts","handleBlur","fieldValue","validateZodPathFunc","error","rawSyncStatus","syncStatus","childElement","message","e","jsx","Fragment","ValidationWrapper","children","validationErrors","thesMessages","newMessage","thisStateOpts","React","m"],"mappings":"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"}
+{"version":3,"file":"Functions.jsx","sources":["../src/Functions.tsx"],"sourcesContent":["import {\r\n  notifyComponent,\r\n  type EffectiveSetState,\r\n  type FormElementParams,\r\n  type FormOptsType,\r\n  type UpdateArg,\r\n  type UpdateOpts,\r\n} from \"./CogsState\";\r\n\r\nimport { getNestedValue, isFunction, updateNestedProperty } from \"./utility\";\r\nimport { useEffect, useRef, useState } from \"react\";\r\nimport React from \"react\";\r\nimport { getGlobalStore, formRefStore } from \"./store\";\r\nimport { validateZodPathFunc } from \"./useValidateZodPath\";\r\n\r\nexport function updateFn<U>(\r\n  setState: EffectiveSetState<U>,\r\n  payload: UpdateArg<U>,\r\n  path: string[],\r\n  validationKey?: string\r\n): void {\r\n  setState(\r\n    (prevState) => {\r\n      if (isFunction<U>(payload)) {\r\n        const nestedValue = payload(getNestedValue(prevState, path));\r\n        let value = updateNestedProperty(path, prevState, nestedValue);\r\n        if (typeof value == \"string\") {\r\n          value = value.trim();\r\n        }\r\n        return value;\r\n      } else {\r\n        let value =\r\n          !path || path.length == 0\r\n            ? payload\r\n            : updateNestedProperty(path, prevState, payload);\r\n        if (typeof value == \"string\") {\r\n          value = value.trim();\r\n        }\r\n        return value;\r\n      }\r\n    },\r\n    path,\r\n    { updateType: \"update\" },\r\n    validationKey\r\n  );\r\n}\r\n\r\nexport function pushFunc<U>(\r\n  setState: EffectiveSetState<U>,\r\n  payload: UpdateArg<U>,\r\n  path: string[],\r\n  stateKey: string,\r\n  index?: number\r\n): void {\r\n  const array = getGlobalStore.getState().getNestedState(stateKey, path) as U[];\r\n  setState(\r\n    (prevState) => {\r\n      let arrayToUpdate =\r\n        !path || path.length == 0\r\n          ? prevState\r\n          : getNestedValue(prevState, [...path]);\r\n      let returnedArray = [...arrayToUpdate];\r\n\r\n      returnedArray.splice(\r\n        index || Number(index) == 0 ? index : arrayToUpdate.length,\r\n        0,\r\n        isFunction<U>(payload)\r\n          ? payload(index == -1 ? undefined : arrayToUpdate)\r\n          : payload\r\n      );\r\n      const value =\r\n        path.length == 0\r\n          ? returnedArray\r\n          : updateNestedProperty([...path], prevState, returnedArray);\r\n\r\n      return value as U;\r\n    },\r\n    [\r\n      ...path,\r\n      index || index === 0 ? index?.toString() : (array!.length - 1).toString(),\r\n    ],\r\n    {\r\n      updateType: \"insert\",\r\n    }\r\n  );\r\n}\r\n\r\nexport function cutFunc<U>(\r\n  setState: EffectiveSetState<U>,\r\n  path: string[],\r\n  stateKey: string,\r\n  index: number\r\n): void {\r\n  const array = getGlobalStore.getState().getNestedState(stateKey, path) as U[];\r\n  setState(\r\n    (prevState) => {\r\n      const arrayToUpdate = getNestedValue(prevState, [...path]);\r\n      if (index < 0 || index >= arrayToUpdate?.length) {\r\n        throw new Error(`Index ${index} does not exist in the array.`);\r\n      }\r\n      const indexToCut =\r\n        index || Number(index) == 0 ? index : arrayToUpdate.length - 1;\r\n\r\n      const updatedArray = [\r\n        ...arrayToUpdate.slice(0, indexToCut),\r\n        ...arrayToUpdate.slice(indexToCut + 1),\r\n      ] as U;\r\n\r\n      return path.length == 0\r\n        ? updatedArray\r\n        : updateNestedProperty([...path], prevState, updatedArray);\r\n    },\r\n    [\r\n      ...path,\r\n      index || index === 0 ? index?.toString() : (array!.length - 1).toString(),\r\n    ],\r\n    { updateType: \"cut\" }\r\n  );\r\n}\r\n\r\nexport const useStoreSubscription = <T,>(\r\n  fullPath: string,\r\n  selector: (\r\n    store: ReturnType<typeof getGlobalStore.getState>,\r\n    path: string\r\n  ) => T,\r\n  compare: (a: T, b: T) => boolean = (a, b) =>\r\n    JSON.stringify(a) === JSON.stringify(b)\r\n) => {\r\n  const [value, setValue] = useState<T>(() =>\r\n    selector(getGlobalStore.getState(), fullPath)\r\n  );\r\n  const previousValueRef = useRef<T>(value);\r\n  const fullPathRef = useRef(fullPath);\r\n  useEffect(() => {\r\n    fullPathRef.current = fullPath; // Ensure latest fullPath is always used\r\n\r\n    setValue(selector(getGlobalStore.getState(), fullPath));\r\n\r\n    const callback = (store: any) => {\r\n      const newValue = selector(store, fullPathRef.current);\r\n\r\n      if (!compare(previousValueRef.current, newValue)) {\r\n        previousValueRef.current = newValue;\r\n        setValue(newValue);\r\n      }\r\n    };\r\n    const unsubscribe = getGlobalStore.subscribe(callback);\r\n    return () => {\r\n      unsubscribe();\r\n    };\r\n  }, [fullPath]);\r\n  return value;\r\n};\r\nexport const useGetValidationErrors = (\r\n  validationKey: string,\r\n  path: string[],\r\n  validIndices?: number[]\r\n) => {\r\n  const fullPath =\r\n    validationKey +\r\n    \".\" +\r\n    (path.length > 0 ? [path.join(\".\")] : []) +\r\n    (validIndices && validIndices.length > 0 ? \".\" + validIndices : \"\");\r\n\r\n  const returnresult = useStoreSubscription(\r\n    fullPath,\r\n    (store, path) => store.getValidationErrors(path) || []\r\n  );\r\n\r\n  return returnresult;\r\n};\r\n\r\nexport const useGetSyncInfo = (key: string, path: string[]) => {\r\n  const syncKey = `${key}:${path.join(\".\")}`;\r\n  return useStoreSubscription(syncKey, (store, path) =>\r\n    store.getSyncInfo(path)\r\n  );\r\n};\r\nexport const useGetKeyState = (key: string, path: string[]) => {\r\n  return useStoreSubscription(`${key}:${path.join(\".\")}`, (store, fullPath) =>\r\n    store.getNestedState(key, path)\r\n  );\r\n};\r\ninterface FormControlComponentProps<TStateObject> {\r\n  setState: EffectiveSetState<TStateObject>;\r\n\r\n  path: string[];\r\n  child: (obj: FormElementParams<TStateObject>) => JSX.Element;\r\n  formOpts?: FormOptsType;\r\n  stateKey: string;\r\n}\r\n// Find FormControlComponent in your Functions.ts or equivalent file\r\n\r\nexport const FormControlComponent = <TStateObject,>({\r\n  setState, // This is the real effectiveSetState from the hook\r\n  path,\r\n  child,\r\n  formOpts,\r\n  stateKey,\r\n}: FormControlComponentProps<TStateObject>) => {\r\n  const { registerFormRef, getFormRef } = formRefStore.getState();\r\n  const {\r\n    getValidationErrors,\r\n    addValidationError,\r\n    getInitialOptions,\r\n    removeValidationError,\r\n  } = getGlobalStore.getState();\r\n\r\n  const refKey = stateKey + \".\" + path.join(\".\");\r\n  const localFormRef = useRef<HTMLInputElement>(null);\r\n  const existingRef = getFormRef(refKey);\r\n  if (!existingRef) {\r\n    registerFormRef(refKey, localFormRef);\r\n  }\r\n  const formRef = existingRef || localFormRef;\r\n\r\n  // --- START CHANGES ---\r\n\r\n  const globalStateValue = useGetKeyState(stateKey, path);\r\n  const [localValue, setLocalValue] = useState<any>(globalStateValue);\r\n  const isCurrentlyDebouncing = useRef(false);\r\n  const debounceTimeoutRef = useRef<NodeJS.Timeout | null>(null);\r\n\r\n  // Effect to sync local state if global state changes externally\r\n  useEffect(() => {\r\n    // Only update local if not actively debouncing a local change\r\n    if (!isCurrentlyDebouncing.current && globalStateValue !== localValue) {\r\n      setLocalValue(globalStateValue);\r\n    }\r\n  }, [globalStateValue]); // Removed localValue dependency\r\n\r\n  // Effect for cleanup\r\n  useEffect(() => {\r\n    return () => {\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current);\r\n        isCurrentlyDebouncing.current = false;\r\n      }\r\n    };\r\n  }, []);\r\n\r\n  const debouncedUpdater = (payload: UpdateArg<TStateObject>) => {\r\n    setLocalValue(payload); // Update local state immediately\r\n    isCurrentlyDebouncing.current = true; // Mark as debouncing\r\n\r\n    if (debounceTimeoutRef.current) {\r\n      clearTimeout(debounceTimeoutRef.current);\r\n    }\r\n\r\n    debounceTimeoutRef.current = setTimeout(\r\n      () => {\r\n        isCurrentlyDebouncing.current = false; // Debounce finished\r\n        // Use the state value AT THE TIME OF THE SETTIMEOUT FIRING\r\n        // which `payload` captured via closure is correct.\r\n        updateFn(setState, payload, path, validationKey);\r\n      },\r\n      formOpts?.debounceTime ??\r\n        (typeof globalStateValue == \"boolean\" ? 20 : 200)\r\n    );\r\n  };\r\n\r\n  // --- END CHANGES ---\r\n\r\n  const initialOptions = getInitialOptions(stateKey);\r\n  if (!initialOptions?.validation?.key) {\r\n    throw new Error(\"Validation key not found.\");\r\n  }\r\n  const validationKey = initialOptions.validation.key;\r\n  const validateOnBlur = initialOptions.validation.onBlur === true;\r\n\r\n  const handleBlur = async () => {\r\n    // --- Ensure latest value is flushed if debouncing ---\r\n    if (debounceTimeoutRef.current) {\r\n      clearTimeout(debounceTimeoutRef.current);\r\n      isCurrentlyDebouncing.current = false;\r\n      updateFn(setState, localValue, path, validationKey); // Use current localValue\r\n    }\r\n    // --- End modification ---\r\n\r\n    if (!initialOptions.validation?.zodSchema || !validateOnBlur) return;\r\n    removeValidationError(validationKey + \".\" + path.join(\".\"));\r\n    try {\r\n      // Use the potentially just flushed value\r\n      const fieldValue = getGlobalStore\r\n        .getState()\r\n        .getNestedState(stateKey, path);\r\n      await validateZodPathFunc(\r\n        validationKey,\r\n        initialOptions.validation.zodSchema,\r\n        path,\r\n        fieldValue\r\n      );\r\n      // forceUpdate might be needed if validation state update doesn't trigger render\r\n      // Consider using useGetValidationErrors hook result directly for validation display\r\n    } catch (error) {\r\n      console.error(\"Validation error on blur:\", error);\r\n    }\r\n  };\r\n\r\n  const rawSyncStatus = useGetSyncInfo(stateKey, path);\r\n  const syncStatus = rawSyncStatus\r\n    ? { ...rawSyncStatus, date: new Date(rawSyncStatus.timeStamp) }\r\n    : null;\r\n\r\n  const childElement = child({\r\n    // --- START CHANGES ---\r\n    get: () => localValue, // Get should return the immediate local value\r\n    set: debouncedUpdater, // Use the new debounced updater\r\n    // --- END CHANGES ---\r\n    syncStatus,\r\n    path: path,\r\n    validationErrors: () =>\r\n      getValidationErrors(validationKey + \".\" + path.join(\".\")),\r\n    addValidationError: (message?: string) => {\r\n      removeValidationError(validationKey + \".\" + path.join(\".\"));\r\n      addValidationError(validationKey + \".\" + path.join(\".\"), message ?? \"\");\r\n    },\r\n    inputProps: {\r\n      // --- START CHANGES ---\r\n      value: localValue ?? \"\", // Input value is always the local state\r\n      onChange: (e: any) => debouncedUpdater(e.target.value), // Use debounced updater\r\n      // --- END CHANGES ---\r\n      onBlur: handleBlur,\r\n      ref: formRef,\r\n    },\r\n  });\r\n\r\n  return (\r\n    <>\r\n      <ValidationWrapper {...{ formOpts, path, validationKey, stateKey }}>\r\n        {childElement}\r\n      </ValidationWrapper>\r\n    </>\r\n  );\r\n};\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n  validationKey,\r\n  stateKey,\r\n  children,\r\n  validIndices,\r\n}: {\r\n  formOpts?: FormOptsType;\r\n  path: string[];\r\n  validationKey: string;\r\n  stateKey?: string;\r\n  children: React.ReactNode;\r\n  validIndices?: number[];\r\n}) {\r\n  const { getInitialOptions } = getGlobalStore.getState();\r\n\r\n  const validationErrors = useGetValidationErrors(\r\n    validationKey,\r\n    path,\r\n    validIndices\r\n  );\r\n  // console.log(\r\n  //   \"validationErrors ValidationWrapper\",\r\n  //   stateKey,\r\n  //   validationKey,\r\n  //   path,\r\n  //   validationErrors\r\n  // );\r\n  const thesMessages: string[] = [];\r\n\r\n  if (validationErrors) {\r\n    const newMessage = validationErrors!.join(\", \");\r\n    if (!thesMessages.includes(newMessage)) {\r\n      thesMessages.push(newMessage);\r\n    }\r\n  }\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n\r\n  return (\r\n    <>\r\n      {thisStateOpts?.formElements?.validation &&\r\n      !formOpts?.validation?.disable ? (\r\n        thisStateOpts.formElements!.validation!({\r\n          children: (\r\n            <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n          ),\r\n          active: validationErrors.length > 0 ? true : false,\r\n          message: formOpts?.validation?.hideMessage\r\n            ? \"\"\r\n            : formOpts?.validation?.message\r\n              ? formOpts?.validation?.message\r\n              : thesMessages.map((m) => m).join(\", \"),\r\n          path: path,\r\n\r\n          ...(formOpts?.key && { key: formOpts?.key }),\r\n        })\r\n      ) : (\r\n        <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n      )}\r\n    </>\r\n  );\r\n}\r\n"],"names":["updateFn","setState","payload","path","validationKey","prevState","isFunction","nestedValue","getNestedValue","value","updateNestedProperty","pushFunc","stateKey","index","array","getGlobalStore","arrayToUpdate","returnedArray","cutFunc","indexToCut","updatedArray","useStoreSubscription","fullPath","selector","compare","a","b","setValue","useState","previousValueRef","useRef","fullPathRef","useEffect","callback","store","newValue","unsubscribe","useGetValidationErrors","validIndices","useGetSyncInfo","key","syncKey","useGetKeyState","FormControlComponent","child","formOpts","registerFormRef","getFormRef","formRefStore","getValidationErrors","addValidationError","getInitialOptions","removeValidationError","refKey","localFormRef","existingRef","formRef","globalStateValue","localValue","setLocalValue","isCurrentlyDebouncing","debounceTimeoutRef","debouncedUpdater","initialOptions","validateOnBlur","handleBlur","fieldValue","validateZodPathFunc","error","rawSyncStatus","syncStatus","childElement","message","e","jsx","Fragment","ValidationWrapper","children","validationErrors","thesMessages","newMessage","thisStateOpts","React","m"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cogsbox-state",
-  "version": "0.5.126",
+  "version": "0.5.127",
   "description": "React state management library with form controls and server sync",
   "type": "module",
   "main": "./dist/index.js",