cogsbox-state 0.5.432 → 0.5.435

package/dist/Functions.d.ts

@@ -1,22 +1,9 @@
-import { EffectiveSetState, FormElementParams, FormOptsType, UpdateArg } from './CogsState';
+import { FormOptsType } from './CogsState';
 import { default as React } from 'react';
 import { getGlobalStore } from './store';
 
-export declare function updateFn<U>(setState: EffectiveSetState<U>, payload: UpdateArg<U>, path: string[], validationKey?: string): void;
-export declare function pushFunc<U>(setState: EffectiveSetState<U>, payload: UpdateArg<U>, path: string[], stateKey: string, index?: number): void;
-export declare function cutFunc<U>(setState: EffectiveSetState<U>, path: string[], stateKey: string, index: number): void;
 export declare const useStoreSubscription: <T>(fullPath: string, selector: (store: ReturnType<typeof getGlobalStore.getState>, path: string) => T, compare?: (a: T, b: T) => boolean) => T;
 export declare const useGetValidationErrors: (validationKey: string, path: string[], validIndices?: number[]) => string[];
-export declare const useGetSyncInfo: (key: string, path: string[]) => import('./CogsState').SyncInfo | null;
-export declare const useGetKeyState: (key: string, path: string[]) => any;
-interface FormControlComponentProps<TStateObject> {
-    setState: EffectiveSetState<TStateObject>;
-    path: string[];
-    child: (obj: FormElementParams<TStateObject>) => JSX.Element;
-    formOpts?: FormOptsType;
-    stateKey: string;
-}
-export declare const FormControlComponent: <TStateObject>({ setState, path, child, formOpts, stateKey, }: FormControlComponentProps<TStateObject>) => import("react/jsx-runtime").JSX.Element;
 export type ValidationWrapperProps = {
     formOpts?: FormOptsType;
     path: string[];
@@ -25,4 +12,3 @@ export type ValidationWrapperProps = {
     validIndices?: number[];
 };
 export declare function ValidationWrapper({ formOpts, path, stateKey, children, validIndices, }: ValidationWrapperProps): import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/Functions.jsx

@@ -1,201 +1,53 @@
-import { jsx as V, Fragment as C } from "react/jsx-runtime";
-import "./CogsState.jsx";
-import { isFunction as G, getNestedValue as R, updateNestedPropertyIds as w } from "./utility.js";
-import k, { useRef as b, useState as D, useEffect as T } from "react";
-import { getGlobalStore as m, formRefStore as x } from "./store.js";
-import { validateZodPathFunc as K } from "./useValidateZodPath.js";
-import { ulid as L } from "ulid";
-function F(n, e, t, r) {
-  n(
-    (i) => {
-      if (G(e)) {
-        const s = e(R(i, t));
-        console.group("nestedValue", t, s);
-        let o = w(t, i, s);
-        return console.group("updateFn", o), typeof o == "string" && (o = o.trim()), o;
-      } else {
-        let s = !t || t.length == 0 ? e : w(t, i, e);
-        return typeof s == "string" && (s = s.trim()), s;
-      }
-    },
-    t,
-    { updateType: "update" },
-    r
-  );
-}
-function te(n, e, t, r, i) {
-  const s = m.getState().getNestedState(r, t) || [], o = G(e) ? e(s) : e;
-  typeof o == "object" && o !== null && !o.id && (o.id = L());
-  const f = o.id;
-  n(
-    (c) => {
-      const u = [...R(c, [...t]) || []];
-      return u.splice(u.length, 0, o), w([...t], c, u);
-    },
-    [...t, `id:${f}`],
-    // Now we use the ID that is guaranteed to be correct.
-    {
-      updateType: "insert"
-    }
-  );
-}
-function ne(n, e, t, r) {
-  const i = [t, ...e].join("."), o = m.getState().shadowStateStore.get(i)?.arrayKeys?.[r];
-  if (!o)
-    throw new Error(`No ID found for index ${r} in array`);
-  n(
-    (f) => {
-      const c = R(f, [...e]);
-      if (r < 0 || r >= c?.length)
-        throw new Error(`Index ${r} does not exist in the array.`);
-      const d = [
-        ...c.slice(0, r),
-        ...c.slice(r + 1)
-      ];
-      return e.length == 0 ? d : w([...e], f, d);
-    },
-    [...e, o],
-    // Use the ID here!
-    { updateType: "cut" }
-  );
-}
-const I = (n, e, t = (r, i) => JSON.stringify(r) === JSON.stringify(i)) => {
-  const [r, i] = D(
-    () => e(m.getState(), n)
-  ), s = b(r), o = b(n);
-  return T(() => {
-    o.current = n, i(e(m.getState(), n));
-    const f = (d) => {
-      const u = e(d, o.current);
-      t(s.current, u) || (s.current = u, i(u));
-    }, c = m.subscribe(f);
+import { jsx as m, Fragment as S } from "react/jsx-runtime";
+import d, { useState as v, useRef as f, useEffect as b } from "react";
+import { getGlobalStore as l } from "./store.js";
+const E = (t, e, r = (n, o) => JSON.stringify(n) === JSON.stringify(o)) => {
+  const [n, o] = v(
+    () => e(l.getState(), t)
+  ), a = f(n), s = f(t);
+  return b(() => {
+    s.current = t, o(e(l.getState(), t));
+    const g = (c) => {
+      const i = e(c, s.current);
+      r(a.current, i) || (a.current = i, o(i));
+    }, u = l.subscribe(g);
     return () => {
-      c();
+      u();
     };
-  }, [n]), r;
-}, W = (n, e, t) => {
-  const r = n + "." + (e.length > 0 ? [e.join(".")] : []) + (t && t.length > 0 ? "." + t : "");
-  return I(
-    r,
-    (s, o) => s.getValidationErrors(o) || []
+  }, [t]), n;
+}, V = (t, e, r) => {
+  const n = t + "." + (e.length > 0 ? [e.join(".")] : []) + (r && r.length > 0 ? "." + r : "");
+  return E(
+    n,
+    (a, s) => a.getValidationErrors(s) || []
   );
-}, Z = (n, e) => {
-  const t = `${n}:${e.join(".")}`;
-  return I(
-    t,
-    (r, i) => r.getSyncInfo(i)
-  );
-}, p = (n, e) => I(
-  `${n}:${e.join(".")}`,
-  (t, r) => t.getNestedState(n, e)
-), re = ({
-  setState: n,
-  // This is the real effectiveSetState from the hook
-  path: e,
-  child: t,
-  formOpts: r,
-  stateKey: i
-}) => {
-  const { registerFormRef: s, getFormRef: o } = x.getState(), {
-    getValidationErrors: f,
-    addValidationError: c,
-    getInitialOptions: d,
-    removeValidationError: u
-  } = m.getState(), N = i + "." + e.join("."), $ = b(null), B = o(N);
-  B || s(N, $);
-  const O = B || $, y = p(i, e), [E, M] = D(y), S = b(!1), a = b(null);
-  T(() => {
-    !S.current && y !== E && M(y);
-  }, [y]), T(() => () => {
-    a.current && (clearTimeout(a.current), a.current = null, S.current = !1);
-  }, []);
-  const U = (l) => {
-    if (M(l), S.current = !0, l === "") {
-      a.current && (clearTimeout(a.current), a.current = null), F(n, l, e, g), S.current = !1;
-      return;
-    }
-    a.current && clearTimeout(a.current), a.current = setTimeout(
-      () => {
-        S.current = !1, F(n, l, e, g);
-      },
-      r?.debounceTime ?? (typeof y == "boolean" ? 20 : 200)
-    );
-  }, v = d(i);
-  if (!v?.validation?.key)
-    throw new Error("Validation key not found.");
-  const g = v.validation.key, z = v.validation.onBlur === !0, A = async () => {
-    if (a.current && (clearTimeout(a.current), a.current = null, S.current = !1, F(n, E, e, g)), !(!v.validation?.zodSchema || !z)) {
-      u(g + "." + e.join("."));
-      try {
-        const l = m.getState().getNestedState(i, e);
-        await K(
-          g,
-          v.validation.zodSchema,
-          e,
-          l
-        );
-      } catch (l) {
-        console.error("Validation error on blur:", l);
-      }
-    }
-  }, j = Z(i, e), J = j ? { ...j, date: new Date(j.timeStamp) } : null, P = t({
-    // --- START CHANGES ---
-    get: () => E,
-    // Get should return the immediate local value
-    set: U,
-    // Use the new debounced updater
-    // --- END CHANGES ---
-    syncStatus: J,
-    path: e,
-    validationErrors: () => f(g + "." + e.join(".")),
-    addValidationError: (l) => {
-      u(g + "." + e.join(".")), c(g + "." + e.join("."), l ?? "");
-    },
-    inputProps: {
-      // --- START CHANGES ---
-      value: E ?? "",
-      // Input value is always the local state
-      onChange: (l) => U(l.target.value),
-      // Use debounced updater
-      // --- END CHANGES ---
-      onBlur: A,
-      ref: O
-    }
-  });
-  return /* @__PURE__ */ V(C, { children: /* @__PURE__ */ V(q, { formOpts: r, path: e, stateKey: i, children: P }) });
 };
-function q({
-  formOpts: n,
+function y({
+  formOpts: t,
   path: e,
-  stateKey: t,
-  children: r,
-  validIndices: i
+  stateKey: r,
+  children: n,
+  validIndices: o
 }) {
-  const { getInitialOptions: s } = m.getState(), o = s(t), f = o?.validation?.key ?? t, c = W(
-    f,
+  const { getInitialOptions: a } = l.getState(), s = a(r), g = s?.validation?.key ?? r, u = V(
+    g,
     e,
-    i
-  ), d = [];
-  if (c) {
-    const u = c.join(", ");
-    d.includes(u) || d.push(u);
+    o
+  ), c = [];
+  if (u) {
+    const i = u.join(", ");
+    c.includes(i) || c.push(i);
   }
-  return /* @__PURE__ */ V(C, { children: o?.formElements?.validation && !n?.validation?.disable ? o.formElements.validation({
-    children: /* @__PURE__ */ V(k.Fragment, { children: r }, e.toString()),
-    active: c.length > 0,
-    message: n?.validation?.hideMessage ? "" : n?.validation?.message ? n?.validation?.message : d.map((u) => u).join(", "),
+  return /* @__PURE__ */ m(S, { children: s?.formElements?.validation && !t?.validation?.disable ? s.formElements.validation({
+    children: /* @__PURE__ */ m(d.Fragment, { children: n }, e.toString()),
+    active: u.length > 0,
+    message: t?.validation?.hideMessage ? "" : t?.validation?.message ? t?.validation?.message : c.map((i) => i).join(", "),
     path: e
-  }) : /* @__PURE__ */ V(k.Fragment, { children: r }, e.toString()) });
+  }) : /* @__PURE__ */ m(d.Fragment, { children: n }, e.toString()) });
 }
 export {
-  re as FormControlComponent,
-  q as ValidationWrapper,
-  ne as cutFunc,
-  te as pushFunc,
-  F as updateFn,
-  p as useGetKeyState,
-  Z as useGetSyncInfo,
-  W as useGetValidationErrors,
-  I as useStoreSubscription
+  y as ValidationWrapper,
+  V as useGetValidationErrors,
+  E 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 {\r\n  getNestedValue,\r\n  isFunction,\r\n  updateNestedProperty,\r\n  updateNestedPropertyIds,\r\n} 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\nimport { ulid } from \"ulid\";\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        console.group(\"nestedValue\", path, nestedValue);\r\n        let value = updateNestedPropertyIds(path, prevState, nestedValue);\r\n        console.group(\"updateFn\", value);\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            : updateNestedPropertyIds(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\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  // --- THE FIX ---\r\n  // 1. Determine the newItem and its ID BEFORE calling setState.\r\n  const arrayBeforeUpdate =\r\n    (getGlobalStore.getState().getNestedState(stateKey, path) as any[]) || [];\r\n\r\n  const newItem = isFunction<U>(payload)\r\n    ? payload(arrayBeforeUpdate as any)\r\n    : payload;\r\n\r\n  // 2. Ensure it has an ID.\r\n  if (typeof newItem === \"object\" && newItem !== null && !(newItem as any).id) {\r\n    (newItem as any).id = ulid();\r\n  }\r\n  const finalId = (newItem as any).id;\r\n  // --- END OF FIX ---\r\n\r\n  setState(\r\n    (prevState) => {\r\n      // The logic inside here is now much simpler.\r\n      // We already have the final `newItem`.\r\n      const arrayToUpdate = getNestedValue(prevState, [...path]) || [];\r\n      const newArray = [...arrayToUpdate];\r\n      newArray.splice(index ?? newArray.length, 0, newItem);\r\n      return updateNestedPropertyIds([...path], prevState, newArray);\r\n    },\r\n    [...path, `id:${finalId}`], // Now we use the ID that is guaranteed to be correct.\r\n    {\r\n      updateType: \"insert\",\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  // Get the ordered IDs to find the ID for this index\r\n  const arrayKey = [stateKey, ...path].join(\".\");\r\n  const arrayMeta = getGlobalStore.getState().shadowStateStore.get(arrayKey);\r\n  const itemId = arrayMeta?.arrayKeys?.[index];\r\n\r\n  if (!itemId) {\r\n    throw new Error(`No ID found for index ${index} in array`);\r\n  }\r\n\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\r\n      const updatedArray = [\r\n        ...arrayToUpdate.slice(0, index),\r\n        ...arrayToUpdate.slice(index + 1),\r\n      ] as U;\r\n\r\n      return path.length == 0\r\n        ? updatedArray\r\n        : updateNestedPropertyIds([...path], prevState, updatedArray);\r\n    },\r\n    [...path, itemId], // Use the ID here!\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        debounceTimeoutRef.current = null; // Explicitly nullify\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;\r\n\r\n    if (payload === \"\") {\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current); // Clear pending timer\r\n        debounceTimeoutRef.current = null;\r\n      }\r\n      updateFn(setState, payload, path, validationKey); // Update global state NOW\r\n      isCurrentlyDebouncing.current = false; // No longer debouncing\r\n      return; // Don't proceed to set another timeout\r\n    }\r\n\r\n    // If not empty, proceed with normal debouncing\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;\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  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); // Clear pending timer\r\n      debounceTimeoutRef.current = null;\r\n      isCurrentlyDebouncing.current = false;\r\n      // Ensure the absolute latest local value is committed on blur\r\n      updateFn(setState, localValue, path, validationKey);\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, stateKey }}>\r\n        {childElement}\r\n      </ValidationWrapper>\r\n    </>\r\n  );\r\n};\r\nexport type ValidationWrapperProps = {\r\n  formOpts?: FormOptsType;\r\n  path: string[];\r\n  stateKey: string;\r\n  children: React.ReactNode;\r\n  validIndices?: number[];\r\n};\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n\r\n  stateKey,\r\n  children,\r\n  validIndices,\r\n}: ValidationWrapperProps) {\r\n  const { getInitialOptions } = getGlobalStore.getState();\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n  const validationKey = thisStateOpts?.validation?.key ?? stateKey!;\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\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      ) : (\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","updateNestedPropertyIds","pushFunc","stateKey","index","arrayBeforeUpdate","getGlobalStore","newItem","ulid","finalId","newArray","cutFunc","arrayKey","itemId","arrayToUpdate","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","thisStateOpts","validationErrors","thesMessages","newMessage","React","m"],"mappings":"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"}
+{"version":3,"file":"Functions.jsx","sources":["../src/Functions.tsx"],"sourcesContent":["import { type FormOptsType } from './CogsState';\r\n\r\nimport { useEffect, useRef, useState } from 'react';\r\nimport React from 'react';\r\nimport { getGlobalStore } from './store';\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\n// Find FormControlComponent in your Functions.ts or equivalent file\r\n\r\n// export 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//   rebuildStateShape,\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//   const stateKeyPathKey = [stateKey, ...path].join('.');\r\n//   const [, forceUpdate] = useState<any>();\r\n//   getGlobalStore.getState().subscribeToPath(stateKeyPathKey, () => {\r\n//     forceUpdate({});\r\n//   });\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 = getGlobalStore\r\n//     .getState()\r\n//     .getShadowValue(stateKeyPathKey);\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//         debounceTimeoutRef.current = null; // Explicitly nullify\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;\r\n\r\n//     if (payload === '') {\r\n//       if (debounceTimeoutRef.current) {\r\n//         clearTimeout(debounceTimeoutRef.current); // Clear pending timer\r\n//         debounceTimeoutRef.current = null;\r\n//       }\r\n\r\n//       setState(payload, path, { updateType: 'update' });\r\n//       isCurrentlyDebouncing.current = false; // No longer debouncing\r\n//       return; // Don't proceed to set another timeout\r\n//     }\r\n\r\n//     // If not empty, proceed with normal debouncing\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;\r\n//         console.log('debouncedUpdater', payload);\r\n//         setState(payload, path, { updateType: 'update' });\r\n//       },\r\n//       formOpts?.debounceTime ??\r\n//         (typeof globalStateValue == 'boolean' ? 20 : 200)\r\n//     );\r\n//   };\r\n\r\n//   const initialOptions = getInitialOptions(stateKey);\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); // Clear pending timer\r\n//       debounceTimeoutRef.current = null;\r\n//       isCurrentlyDebouncing.current = false;\r\n//       // Ensure the absolute latest local value is committed on blur\r\n//       setState(localValue, path, { updateType: 'update' });\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//       if (!validationKey) return;\r\n//       const fieldValue = getGlobalStore\r\n//         .getState()\r\n//         .getShadowValue(stateKeyPathKey);\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 childElement = child({\r\n//     state: setter,\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\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, stateKey }}>\r\n//         {childElement}\r\n//       </ValidationWrapper>\r\n//     </>\r\n//   );\r\n// };\r\nexport type ValidationWrapperProps = {\r\n  formOpts?: FormOptsType;\r\n  path: string[];\r\n  stateKey: string;\r\n  children: React.ReactNode;\r\n  validIndices?: number[];\r\n};\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n\r\n  stateKey,\r\n  children,\r\n  validIndices,\r\n}: ValidationWrapperProps) {\r\n  const { getInitialOptions } = getGlobalStore.getState();\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n  const validationKey = thisStateOpts?.validation?.key ?? stateKey!;\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\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      ) : (\r\n        <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n      )}\r\n    </>\r\n  );\r\n}\r\n"],"names":["useStoreSubscription","fullPath","selector","compare","a","b","value","setValue","useState","getGlobalStore","previousValueRef","useRef","fullPathRef","useEffect","callback","store","newValue","unsubscribe","useGetValidationErrors","validationKey","path","validIndices","ValidationWrapper","formOpts","stateKey","children","getInitialOptions","thisStateOpts","validationErrors","thesMessages","newMessage","jsx","Fragment","React","m"],"mappings":";;;AAMO,MAAMA,IAAuB,CAClCC,GACAC,GAIAC,IAAmC,CAACC,GAAGC,MACrC,KAAK,UAAUD,CAAC,MAAM,KAAK,UAAUC,CAAC,MACrC;AACG,QAAA,CAACC,GAAOC,CAAQ,IAAIC;AAAA,IAAY,MACpCN,EAASO,EAAe,SAAA,GAAYR,CAAQ;AAAA,EAC9C,GACMS,IAAmBC,EAAUL,CAAK,GAClCM,IAAcD,EAAOV,CAAQ;AACnC,SAAAY,EAAU,MAAM;AACd,IAAAD,EAAY,UAAUX,GAEtBM,EAASL,EAASO,EAAe,SAAS,GAAGR,CAAQ,CAAC;AAEhD,UAAAa,IAAW,CAACC,MAAe;AAC/B,YAAMC,IAAWd,EAASa,GAAOH,EAAY,OAAO;AAEpD,MAAKT,EAAQO,EAAiB,SAASM,CAAQ,MAC7CN,EAAiB,UAAUM,GAC3BT,EAASS,CAAQ;AAAA,IAErB,GACMC,IAAcR,EAAe,UAAUK,CAAQ;AACrD,WAAO,MAAM;AACC,MAAAG,EAAA;AAAA,IACd;AAAA,EAAA,GACC,CAAChB,CAAQ,CAAC,GACNK;AACT,GACaY,IAAyB,CACpCC,GACAC,GACAC,MACG;AACH,QAAMpB,IACJkB,IACA,OACCC,EAAK,SAAS,IAAI,CAACA,EAAK,KAAK,GAAG,CAAC,IAAI,CACrC,MAAAC,KAAgBA,EAAa,SAAS,IAAI,MAAMA,IAAe;AAO3D,SALcrB;AAAA,IACnBC;AAAA,IACA,CAACc,GAAOK,MAASL,EAAM,oBAAoBK,CAAI,KAAK,CAAA;AAAA,EACtD;AAGF;AAwKO,SAASE,EAAkB;AAAA,EAChC,UAAAC;AAAA,EACA,MAAAH;AAAA,EAEA,UAAAI;AAAA,EACA,UAAAC;AAAA,EACA,cAAAJ;AACF,GAA2B;AACzB,QAAM,EAAE,mBAAAK,EAAA,IAAsBjB,EAAe,SAAS,GAChDkB,IAAgBD,EAAkBF,CAAS,GAC3CL,IAAgBQ,GAAe,YAAY,OAAOH,GAClDI,IAAmBV;AAAA,IACvBC;AAAA,IACAC;AAAA,IACAC;AAAA,EACF,GAQMQ,IAAyB,CAAC;AAEhC,MAAID,GAAkB;AACd,UAAAE,IAAaF,EAAkB,KAAK,IAAI;AAC9C,IAAKC,EAAa,SAASC,CAAU,KACnCD,EAAa,KAAKC,CAAU;AAAA,EAC9B;AAIA,SAAA,gBAAAC,EAAAC,GAAA,EACG,UAAeL,GAAA,cAAc,cAC9B,CAACJ,GAAU,YAAY,UACrBI,EAAc,aAAc,WAAY;AAAA,IACtC,4BACGM,EAAM,UAAN,EAAsC,UAAAR,KAAlBL,EAAK,UAAsB;AAAA,IAElD,QAAQQ,EAAiB,SAAS;AAAA,IAClC,SAASL,GAAU,YAAY,cAC3B,KACAA,GAAU,YAAY,UACpBA,GAAU,YAAY,UACtBM,EAAa,IAAI,CAACK,MAAMA,CAAC,EAAE,KAAK,IAAI;AAAA,IAC1C,MAAAd;AAAA,EAAA,CACD,IAED,gBAAAW,EAACE,EAAM,UAAN,EAAsC,UAAAR,EAAlB,GAAAL,EAAK,SAAsB,CAAA,GAEpD;AAEJ;"}

package/dist/index.js

@@ -1,31 +1,30 @@
-import { $cogsSignal as r, $cogsSignalStore as o, addStateOptions as s, createCogsState as n, notifyComponent as a, useCogsStateFn as i } from "./CogsState.jsx";
-import { CogsStateClient as f, config as c, useCogsConfig as p } from "./CogsStateClient.jsx";
-import { debounce as u, deleteNestedProperty as y, getArrayLengthDifferences as C, getArrayLengthDifferencesArray as S, getDifferences as l, getDifferencesArray as m, getNestedValue as A, isArray as D, isDeepEqual as x, isFunction as N, isObject as F, transformStateFunc as L, updateNestedProperty as P, updateNestedPropertyIds as b } from "./utility.js";
+import { $cogsSignal as r, addStateOptions as o, createCogsState as n, notifyComponent as s, useCogsStateFn as a } from "./CogsState.jsx";
+import { CogsStateClient as g, config as f, useCogsConfig as c } from "./CogsStateClient.jsx";
+import { debounce as d, deepMerge as u, deleteNestedProperty as y, getArrayLengthDifferences as C, getArrayLengthDifferencesArray as l, getDifferences as m, getDifferencesArray as S, getNestedValue as A, isArray as D, isDeepEqual as x, isFunction as F, isObject as L, transformStateFunc as N, updateNestedProperty as b } from "./utility.js";
 import { useCogsTrpcValidationLink as O } from "./TRPCValidationLink.js";
 export {
   r as $cogsSignal,
-  o as $cogsSignalStore,
-  f as CogsStateClient,
-  s as addStateOptions,
-  c as config,
+  g as CogsStateClient,
+  o as addStateOptions,
+  f as config,
   n as createCogsState,
-  u as debounce,
+  d as debounce,
+  u as deepMerge,
   y as deleteNestedProperty,
   C as getArrayLengthDifferences,
-  S as getArrayLengthDifferencesArray,
-  l as getDifferences,
-  m as getDifferencesArray,
+  l as getArrayLengthDifferencesArray,
+  m as getDifferences,
+  S as getDifferencesArray,
   A as getNestedValue,
   D as isArray,
   x as isDeepEqual,
-  N as isFunction,
-  F as isObject,
-  a as notifyComponent,
-  L as transformStateFunc,
-  P as updateNestedProperty,
-  b as updateNestedPropertyIds,
-  p as useCogsConfig,
-  i as useCogsStateFn,
+  F as isFunction,
+  L as isObject,
+  s as notifyComponent,
+  N as transformStateFunc,
+  b as updateNestedProperty,
+  c as useCogsConfig,
+  a as useCogsStateFn,
   O as useCogsTrpcValidationLink
 };
 //# sourceMappingURL=index.js.map

package/dist/store.d.ts

@@ -1,29 +1,17 @@
-import { OptionsType, ReactivityType, StateKeys, SyncActionsType, SyncInfo, UpdateTypeDetail } from './CogsState.js';
+import { OptionsType, ReactivityType, SyncInfo, UpdateTypeDetail } from './CogsState.js';
+import { ReactNode } from 'react';
 
-type StateUpdater<StateValue> = StateValue | ((prevValue: StateValue) => StateValue);
 export type FreshValuesObject = {
     pathsToValues?: string[];
     prevValue?: any;
     newValue?: any;
     timeStamp: number;
 };
-type SyncLogType = {
-    timeStamp: number;
-};
 type StateValue = any;
 export type TrieNode = {
     subscribers: Set<string>;
     children: Map<string, TrieNode>;
 };
-export type ComponentsType = {
-    components: Map<string, {
-        forceUpdate: () => void;
-        paths: Set<string>;
-        deps?: any[];
-        depsFunction?: (state: any) => any[] | true;
-        reactiveType: ReactivityType[] | ReactivityType;
-    }>;
-};
 export type FormRefStoreState = {
     formRefs: Map<string, React.RefObject<any>>;
     registerFormRef: (id: string, ref: React.RefObject<any>) => void;
@@ -32,9 +20,24 @@ export type FormRefStoreState = {
     getFormRefsByStateKey: (stateKey: string) => Map<string, React.RefObject<any>>;
 };
 export declare const formRefStore: import('zustand').UseBoundStore<import('zustand').StoreApi<FormRefStoreState>>;
+export type ComponentsType = {
+    components?: Map<string, {
+        forceUpdate: () => void;
+        paths: Set<string>;
+        deps?: any[];
+        prevDeps?: any[];
+        depsFunction?: (state: any) => any[] | true;
+        reactiveType: ReactivityType[] | ReactivityType;
+    }>;
+};
 export type ShadowMetadata = {
-    id: string;
+    id?: string;
+    stateSource?: 'default' | 'server' | 'localStorage';
+    lastServerSync?: number;
+    isDirty?: boolean;
+    baseServerState?: any;
     arrayKeys?: string[];
+    fields?: Record<string, any>;
     virtualizer?: {
         itemHeight?: number;
         domRef?: HTMLElement | null;
@@ -43,113 +46,112 @@ export type ShadowMetadata = {
         status: string;
     };
     lastUpdated?: number;
+    value?: any;
+    classSignals?: Array<{
+        id: string;
+        effect: string;
+        lastClasses: string;
+        deps: any[];
+    }>;
+    signals?: Array<{
+        instanceId: string;
+        parentId: string;
+        position: number;
+        effect?: string;
+    }>;
+    mapWrappers?: Array<{
+        instanceId: string;
+        path: string[];
+        componentId: string;
+        meta?: any;
+        mapFn: (setter: any, index: number, arraySetter: any) => ReactNode;
+        containerRef: HTMLDivElement | null;
+        rebuildStateShape: any;
+    }>;
+    transformCaches?: Map<string, {
+        validIds: string[];
+        computedAt: number;
+        transforms: Array<{
+            type: 'filter' | 'sort';
+            fn: Function;
+        }>;
+    }>;
+    pathComponents?: Set<string>;
+    streams?: Map<string, {
+        buffer: any[];
+        flushTimer: NodeJS.Timeout | null;
+    }>;
+} & ComponentsType;
+export type CogsEvent = {
+    type: 'INSERT';
+    path: string;
+    itemKey: string;
+    index: number;
+} | {
+    type: 'REMOVE';
+    path: string;
+    itemKey: string;
+} | {
+    type: 'UPDATE';
+    path: string;
+    newValue: any;
+} | {
+    type: 'ITEMHEIGHT';
+    itemKey: string;
+    height: number;
+} | {
+    type: 'RELOAD';
+    path: string;
 };
 export type CogsGlobalState = {
     shadowStateStore: Map<string, ShadowMetadata>;
+    markAsDirty: (key: string, path: string[], options: {
+        bubble: boolean;
+    }) => void;
     initializeShadowState: (key: string, initialState: any) => void;
     updateShadowAtPath: (key: string, path: string[], newValue: any) => void;
     insertShadowArrayElement: (key: string, arrayPath: string[], newItem: any) => void;
     removeShadowArrayElement: (key: string, arrayPath: string[]) => void;
+    getShadowValue: (key: string, validArrayIds?: string[]) => any;
     getShadowMetadata: (key: string, path: string[]) => ShadowMetadata | undefined;
-    setShadowMetadata: (key: string, path: string[], metadata: Omit<ShadowMetadata, "id">) => void;
-    shadowStateSubscribers: Map<string, Set<() => void>>;
-    subscribeToShadowState: (key: string, callback: () => void) => () => void;
-    selectedIndicesMap: Map<string, Map<string, number>>;
-    getSelectedIndex: (stateKey: string, parentPath: string) => number | undefined;
-    setSelectedIndex: (stateKey: string, parentPath: string, index: number | undefined) => void;
-    clearSelectedIndex: ({ stateKey, path, }: {
-        stateKey: string;
-        path: string[];
+    setShadowMetadata: (key: string, path: string[], metadata: Omit<ShadowMetadata, 'id'>) => void;
+    setTransformCache: (key: string, path: string[], cacheKey: string, cacheData: any) => void;
+    pathSubscribers: Map<string, Set<(newValue: any) => void>>;
+    subscribeToPath: (path: string, callback: (newValue: any) => void) => () => void;
+    notifyPathSubscribers: (updatedPath: string, newValue: any) => void;
+    selectedIndicesMap: Map<string, string>;
+    getSelectedIndex: (stateKey: string, validArrayIds?: string[]) => number;
+    setSelectedIndex: (key: string, itemKey: string) => void;
+    clearSelectedIndex: ({ arrayKey }: {
+        arrayKey: string;
     }) => void;
     clearSelectedIndexesForState: (stateKey: string) => void;
-    updaterState: {
-        [key: string]: any;
-    };
     initialStateOptions: {
         [key: string]: OptionsType;
     };
-    cogsStateStore: {
-        [key: string]: StateValue;
-    };
-    isLoadingGlobal: {
-        [key: string]: boolean;
-    };
     initialStateGlobal: {
         [key: string]: StateValue;
     };
-    iniitialCreatedState: {
-        [key: string]: StateValue;
-    };
-    serverState: {
-        [key: string]: StateValue;
-    };
-    getUpdaterState: (key: string) => StateUpdater<StateValue>;
-    setUpdaterState: (key: string, newUpdater: any) => void;
-    getKeyState: <StateKey extends StateKeys>(key: StateKey) => StateValue;
-    getNestedState: <StateKey extends StateKeys>(key: StateKey, path: string[]) => StateValue;
-    setState: <StateKey extends StateKeys>(key: StateKey, value: StateUpdater<StateValue>) => void;
-    setInitialStates: (initialState: StateValue) => void;
-    setCreatedState: (initialState: StateValue) => void;
     updateInitialStateGlobal: (key: string, newState: StateValue) => void;
-    updateInitialCreatedState: (key: string, newState: StateValue) => void;
-    setIsLoadingGlobal: (key: string, value: boolean) => void;
-    setServerState: <StateKey extends StateKeys>(key: StateKey, value: StateValue) => void;
     getInitialOptions: (key: string) => OptionsType | undefined;
     setInitialStateOptions: (key: string, value: OptionsType) => void;
     validationErrors: Map<string, string[]>;
     addValidationError: (path: string, message: string) => void;
     getValidationErrors: (path: string) => string[];
     removeValidationError: (path: string) => void;
-    serverSyncActions: {
-        [key: string]: SyncActionsType<any>;
-    };
-    serverSyncLog: {
-        [key: string]: SyncLogType[];
-    };
+    serverStateUpdates: Map<string, {
+        data: any;
+        status: 'loading' | 'success' | 'error';
+        timestamp: number;
+    }>;
+    setServerStateUpdate: (key: string, serverState: any) => void;
     stateLog: {
         [key: string]: UpdateTypeDetail[];
     };
     syncInfoStore: Map<string, SyncInfo>;
-    serverSideOrNot: {
-        [key: string]: boolean;
-    };
-    setServerSyncLog: (key: string, newValue: SyncLogType) => void;
-    setServerSideOrNot: (key: string, value: boolean) => void;
-    getServerSideOrNot: (key: string) => boolean | undefined;
-    getThisLocalUpdate: (key: string) => UpdateTypeDetail[] | undefined;
-    setServerSyncActions: (key: string, value: SyncActionsType<any>) => void;
     setStateLog: (key: string, updater: (prevUpdates: UpdateTypeDetail[]) => UpdateTypeDetail[]) => void;
     setSyncInfo: (key: string, syncInfo: SyncInfo) => void;
     getSyncInfo: (key: string) => SyncInfo | null;
-    signalDomElements: Map<string, Set<{
-        instanceId: string;
-        parentId: string;
-        position: number;
-        effect?: string;
-        map?: string;
-    }>>;
-    addSignalElement: (signalId: string, elementInfo: {
-        instanceId: string;
-        parentId: string;
-        position: number;
-        effect?: string;
-        map?: string;
-    }) => void;
-    removeSignalElement: (signalId: string, instanceId: string) => void;
-    stateComponents: Map<string, ComponentsType>;
-    reRenderTriggerPrevValue: Record<string, any>;
-    reactiveDeps: Record<string, {
-        deps: any[];
-        updaters: Set<() => void>;
-        depsFunction: ((state: any) => any[] | true) | null;
-    }>;
-    setReactiveDeps: (key: string, record: {
-        deps: any[];
-        updaters: Set<() => void>;
-        depsFunction: ((state: any) => any[] | true) | null;
-    }) => void;
-    deleteReactiveDeps: (key: string) => void;
-    subscribe: (listener: () => void) => () => void;
 };
 export declare const getGlobalStore: import('zustand').UseBoundStore<import('zustand').StoreApi<CogsGlobalState>>;
 export {};