cogsbox-state 0.5.473 → 0.5.475-canary.0

package/dist/Components.jsx.map

@@ -1 +1 @@
-{"version":3,"file":"Components.jsx","sources":["../src/Components.tsx"],"sourcesContent":["import {\r\n  FormElementParams,\r\n  StateObject,\r\n  UpdateTypeDetail,\r\n  type FormOptsType,\r\n} from './CogsState';\r\nimport { pluginStore } from './pluginStore';\r\nimport { createMetadataContext, toDeconstructedMethods } from './plugins';\r\nimport React, {\r\n  memo,\r\n  RefObject,\r\n  useCallback,\r\n  useEffect,\r\n  useLayoutEffect,\r\n  useRef,\r\n  useState,\r\n  useMemo,\r\n} from 'react';\r\nimport { getGlobalStore, ValidationError, ValidationSeverity } from './store';\r\nimport { useInView } from 'react-intersection-observer';\r\nimport { v4 as uuidv4 } from 'uuid';\r\nimport { isDeepEqual } from './utility';\r\nimport { runValidation } from './validation';\r\n\r\nconst {\r\n  getInitialOptions,\r\n\r\n  getShadowMetadata,\r\n  setShadowMetadata,\r\n  getShadowValue,\r\n\r\n  registerComponent,\r\n  unregisterComponent,\r\n\r\n  notifyPathSubscribers,\r\n  subscribeToPath,\r\n} = getGlobalStore.getState();\r\nconst { stateHandlers, notifyFormUpdate } = pluginStore.getState();\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};\r\n\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n  stateKey,\r\n  children,\r\n}: ValidationWrapperProps) {\r\n  const { getInitialOptions, getShadowMetadata, getShadowValue } =\r\n    getGlobalStore.getState();\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n\r\n  const shadowMeta = getShadowMetadata(stateKey!, path);\r\n  const validationState = shadowMeta?.validation;\r\n\r\n  const status = validationState?.status || 'NOT_VALIDATED';\r\n\r\n  const errors = (validationState?.errors || []).map((err) => ({\r\n    ...err,\r\n    path: path,\r\n  })) as ValidationError[];\r\n  const errorMessages = errors\r\n    .filter((err) => err.severity === 'error')\r\n    .map((err) => err.message);\r\n  const warningMessages = errors\r\n    .filter((err) => err.severity === 'warning')\r\n    .map((err) => err.message);\r\n\r\n  // Use first error, or first warning if no errors\r\n  const message = errorMessages[0] || warningMessages[0];\r\n  const primarySeverity: ValidationSeverity =\r\n    errorMessages.length > 0\r\n      ? 'error'\r\n      : warningMessages.length > 0\r\n        ? 'warning'\r\n        : undefined;\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          status, // Now passes the new ValidationStatus type\r\n          message: formOpts?.validation?.hideMessage\r\n            ? ''\r\n            : formOpts?.validation?.message || message || '',\r\n          severity: primarySeverity,\r\n          hasErrors: errorMessages.length > 0,\r\n          hasWarnings: warningMessages.length > 0,\r\n          allErrors: errors,\r\n          path: path,\r\n          getData: () => getShadowValue(stateKey!, path),\r\n        })\r\n      ) : (\r\n        <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n      )}\r\n    </>\r\n  );\r\n}\r\nexport const MemoizedCogsItemWrapper = memo(\r\n  ListItemWrapper,\r\n  (prevProps, nextProps) => {\r\n    // Re-render if any of these change:\r\n    return (\r\n      prevProps.itemPath.join('.') === nextProps.itemPath.join('.') &&\r\n      prevProps.stateKey === nextProps.stateKey &&\r\n      prevProps.itemComponentId === nextProps.itemComponentId &&\r\n      prevProps.localIndex === nextProps.localIndex\r\n    );\r\n  }\r\n);\r\nexport function ListItemWrapper({\r\n  stateKey,\r\n  itemComponentId,\r\n  itemPath,\r\n  localIndex,\r\n  arraySetter,\r\n  rebuildStateShape,\r\n  renderFn,\r\n}: {\r\n  stateKey: string;\r\n  itemComponentId: string;\r\n  itemPath: string[];\r\n  localIndex: number;\r\n  arraySetter: any;\r\n\r\n  rebuildStateShape: (options: {\r\n    currentState: any;\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (\r\n    setter: any,\r\n    index: number,\r\n\r\n    arraySetter: any\r\n  ) => React.ReactNode;\r\n}) {\r\n  const [, forceUpdate] = useState({});\r\n  const { ref: inViewRef, inView } = useInView();\r\n  const elementRef = useRef<HTMLDivElement | null>(null);\r\n\r\n  const imagesLoaded = useImageLoaded(elementRef);\r\n  const hasReportedInitialHeight = useRef(false);\r\n  const fullKey = [stateKey, ...itemPath].join('.');\r\n  useRegisterComponent(stateKey, itemComponentId, forceUpdate);\r\n\r\n  const setRefs = useCallback(\r\n    (element: HTMLDivElement | null) => {\r\n      elementRef.current = element;\r\n      inViewRef(element); // This is the ref from useInView\r\n    },\r\n    [inViewRef]\r\n  );\r\n\r\n  useEffect(() => {\r\n    const unsubscribe = subscribeToPath(fullKey, (e) => {\r\n      forceUpdate({});\r\n    });\r\n    return () => unsubscribe();\r\n  }, [fullKey]);\r\n  useEffect(() => {\r\n    if (!inView || !imagesLoaded || hasReportedInitialHeight.current) {\r\n      return;\r\n    }\r\n\r\n    const element = elementRef.current;\r\n    if (element && element.offsetHeight > 0) {\r\n      hasReportedInitialHeight.current = true;\r\n      const newHeight = element.offsetHeight;\r\n\r\n      setShadowMetadata(stateKey, itemPath, {\r\n        virtualizer: {\r\n          itemHeight: newHeight,\r\n          domRef: element,\r\n        },\r\n      });\r\n\r\n      const arrayPath = itemPath.slice(0, -1);\r\n      const arrayPathKey = [stateKey, ...arrayPath].join('.');\r\n      notifyPathSubscribers(arrayPathKey, {\r\n        type: 'ITEMHEIGHT',\r\n        itemKey: itemPath.join('.'),\r\n\r\n        ref: elementRef.current,\r\n      });\r\n    }\r\n  }, [inView, imagesLoaded, stateKey, itemPath]);\r\n\r\n  const itemValue = getShadowValue(stateKey, itemPath);\r\n\r\n  if (itemValue === undefined) {\r\n    return null;\r\n  }\r\n\r\n  const itemSetter = rebuildStateShape({\r\n    currentState: itemValue,\r\n    path: itemPath,\r\n    componentId: itemComponentId,\r\n  });\r\n  const children = renderFn(itemSetter, localIndex, arraySetter);\r\n\r\n  return <div ref={setRefs}>{children}</div>;\r\n}\r\n\r\nexport function FormElementWrapper({\r\n  stateKey,\r\n  path,\r\n  rebuildStateShape,\r\n  renderFn,\r\n  formOpts,\r\n  setState,\r\n}: {\r\n  stateKey: string;\r\n  path: string[];\r\n  rebuildStateShape: (options: {\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (params: FormElementParams<any>) => React.ReactNode;\r\n  formOpts?: FormOptsType;\r\n  setState: any;\r\n}) {\r\n  const componentId = useRef(uuidv4()).current;\r\n\r\n  const [, forceUpdate] = useState({});\r\n  const formElementRef = useRef<any>(null);\r\n  const stateKeyPathKey = [stateKey, ...path].join('.');\r\n  useRegisterComponent(stateKey, componentId, forceUpdate);\r\n  // Get the shadow node to access typeInfo and schema\r\n  const shadowNode = getGlobalStore.getState().getShadowNode(stateKey, path);\r\n  const typeInfo = shadowNode?._meta?.typeInfo;\r\n\r\n  const globalStateValue = getShadowValue(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  // 2. Memoize the list of active form wrappers to avoid re-calculating on every render.\r\n  const activeFormWrappers = useMemo(() => {\r\n    return (\r\n      pluginStore\r\n        .getState()\r\n        .getPluginConfigsForState(stateKey)\r\n        // We only care about plugins that have defined a formWrapper\r\n        .filter((config) => typeof config.plugin.formWrapper === 'function')\r\n    );\r\n  }, [stateKey]);\r\n\r\n  useEffect(() => {\r\n    if (\r\n      !isCurrentlyDebouncing.current &&\r\n      !isDeepEqual(globalStateValue, localValue)\r\n    ) {\r\n      setLocalValue(globalStateValue);\r\n    }\r\n  }, [globalStateValue]);\r\n\r\n  useEffect(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Initialize clientActivityState if needed\r\n    const currentMeta = getShadowMetadata(stateKey, path) || {};\r\n    if (!currentMeta.clientActivityState) {\r\n      currentMeta.clientActivityState = { elements: new Map() };\r\n    }\r\n\r\n    // Detect element type from the ref\r\n    const detectElementType = () => {\r\n      const el = formElementRef.current;\r\n      if (!el) return 'input';\r\n      const tagName = el.tagName.toLowerCase();\r\n      if (tagName === 'textarea') return 'textarea';\r\n      if (tagName === 'select') return 'select';\r\n      if (tagName === 'input') {\r\n        const type = (el as HTMLInputElement).type;\r\n        if (type === 'checkbox') return 'checkbox';\r\n        if (type === 'radio') return 'radio';\r\n        if (type === 'range') return 'range';\r\n        if (type === 'file') return 'file';\r\n      }\r\n      return 'input';\r\n    };\r\n\r\n    // Add this element to the Map\r\n    currentMeta.clientActivityState.elements.set(componentId, {\r\n      domRef: formElementRef,\r\n      elementType: detectElementType(),\r\n      inputType: formElementRef.current?.type,\r\n      mountedAt: Date.now(),\r\n    });\r\n\r\n    setShadowMetadata(stateKey, path, currentMeta);\r\n\r\n    // Subscribe to path updates\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(stateKeyPathKey, (newValue) => {\r\n        if (!isCurrentlyDebouncing.current && localValue !== newValue) {\r\n          forceUpdate({});\r\n        }\r\n      });\r\n\r\n    // Cleanup\r\n    return () => {\r\n      unsubscribe();\r\n\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current);\r\n        isCurrentlyDebouncing.current = false;\r\n      }\r\n\r\n      // Remove element from Map\r\n      const meta = getGlobalStore.getState().getShadowMetadata(stateKey, path);\r\n      if (meta?.clientActivityState?.elements) {\r\n        meta.clientActivityState.elements.delete(componentId);\r\n        setShadowMetadata(stateKey, path, meta);\r\n      }\r\n    };\r\n  }, []);\r\n\r\n  const debouncedUpdate = useCallback(\r\n    (newValue: any) => {\r\n      // Type conversion logic (keep existing)\r\n      if (typeInfo) {\r\n        if (typeInfo.type === 'number' && typeof newValue === 'string') {\r\n          newValue =\r\n            newValue === ''\r\n              ? typeInfo.nullable\r\n                ? null\r\n                : (typeInfo.default ?? 0)\r\n              : Number(newValue);\r\n        } else if (\r\n          typeInfo.type === 'boolean' &&\r\n          typeof newValue === 'string'\r\n        ) {\r\n          newValue = newValue === 'true' || newValue === '1';\r\n        } else if (typeInfo.type === 'date' && typeof newValue === 'string') {\r\n          newValue = new Date(newValue);\r\n        }\r\n      } else {\r\n        const currentType = typeof globalStateValue;\r\n        if (currentType === 'number' && typeof newValue === 'string') {\r\n          newValue = newValue === '' ? 0 : Number(newValue);\r\n        }\r\n      }\r\n\r\n      setLocalValue(newValue);\r\n\r\n      // Update input activity details\r\n      const { getShadowMetadata, setShadowMetadata } =\r\n        getGlobalStore.getState();\r\n      const meta = getShadowMetadata(stateKey, path);\r\n      if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n        const element = meta.clientActivityState.elements.get(componentId);\r\n        if (element && element.currentActivity?.type === 'focus') {\r\n          element!.currentActivity.details = {\r\n            ...element!.currentActivity.details,\r\n            value: newValue,\r\n            previousValue:\r\n              element!.currentActivity.details?.value || globalStateValue,\r\n            inputLength:\r\n              typeof newValue === 'string' ? newValue.length : undefined,\r\n            keystrokeCount:\r\n              (element!.currentActivity.details?.keystrokeCount || 0) + 1,\r\n          };\r\n          setShadowMetadata(stateKey, path, meta);\r\n        }\r\n      }\r\n\r\n      // Notify plugins\r\n      notifyFormUpdate({\r\n        stateKey,\r\n        type: 'input',\r\n        path,\r\n        value: newValue,\r\n      });\r\n\r\n      // Validation (keep existing)\r\n      const virtualOperation: UpdateTypeDetail = {\r\n        stateKey,\r\n        path,\r\n        newValue: newValue,\r\n        updateType: 'update',\r\n        timeStamp: Date.now(),\r\n        status: 'new',\r\n        oldValue: globalStateValue,\r\n      };\r\n      runValidation(virtualOperation, 'onChange');\r\n\r\n      // Debounce state update (keep existing)\r\n      isCurrentlyDebouncing.current = true;\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current);\r\n      }\r\n\r\n      const debounceTime = formOpts?.debounceTime ?? 200;\r\n      debounceTimeoutRef.current = setTimeout(() => {\r\n        isCurrentlyDebouncing.current = false;\r\n        setState(newValue, path, {\r\n          updateType: 'update',\r\n          validationTrigger: 'onChange',\r\n        });\r\n      }, debounceTime);\r\n    },\r\n    [\r\n      setState,\r\n      path,\r\n      formOpts?.debounceTime,\r\n      typeInfo,\r\n      globalStateValue,\r\n      stateKey,\r\n      componentId,\r\n    ]\r\n  );\r\n\r\n  const handleFocus = useCallback(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Update element's current activity\r\n    const meta = getShadowMetadata(stateKey, path);\r\n    if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n      const element = meta.clientActivityState.elements.get(componentId)!;\r\n      element.currentActivity = {\r\n        type: 'focus',\r\n        startTime: Date.now(),\r\n        details: {\r\n          value: localValue,\r\n          inputLength:\r\n            typeof localValue === 'string' ? localValue.length : undefined,\r\n        },\r\n      };\r\n      setShadowMetadata(stateKey, path, meta);\r\n    }\r\n\r\n    // Notify plugins\r\n    notifyFormUpdate({\r\n      stateKey,\r\n      type: 'focus',\r\n      path,\r\n      value: localValue,\r\n    });\r\n  }, [stateKey, path, componentId, localValue]);\r\n  const handleBlur = useCallback(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Clear debounce if active\r\n    if (debounceTimeoutRef.current) {\r\n      clearTimeout(debounceTimeoutRef.current);\r\n      debounceTimeoutRef.current = null;\r\n      isCurrentlyDebouncing.current = false;\r\n      setState(localValue, path, {\r\n        updateType: 'update',\r\n        validationTrigger: 'onBlur',\r\n      });\r\n    }\r\n\r\n    // Clear element's current activity\r\n    const meta = getShadowMetadata(stateKey, path);\r\n    if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n      const element = meta.clientActivityState.elements.get(componentId)!;\r\n      element.currentActivity = undefined;\r\n      setShadowMetadata(stateKey, path, meta);\r\n    }\r\n\r\n    // Notify plugins\r\n    notifyFormUpdate({\r\n      stateKey,\r\n      type: 'blur',\r\n      path,\r\n      value: localValue,\r\n    });\r\n\r\n    // Run validation if configured\r\n    const validationOptions = getInitialOptions(stateKey)?.validation;\r\n    if (validationOptions?.onBlur) {\r\n      const virtualOperation: UpdateTypeDetail = {\r\n        stateKey,\r\n        path,\r\n        newValue: localValue,\r\n        updateType: 'update',\r\n        timeStamp: Date.now(),\r\n        status: 'new',\r\n        oldValue: globalStateValue,\r\n      };\r\n      runValidation(virtualOperation, 'onBlur');\r\n    }\r\n  }, [localValue, setState, path, stateKey, componentId, globalStateValue]);\r\n\r\n  const baseState = rebuildStateShape({\r\n    path: path,\r\n    componentId: componentId,\r\n    meta: undefined,\r\n  });\r\n\r\n  const stateWithInputProps = new Proxy(baseState, {\r\n    get(target, prop) {\r\n      if (prop === '$inputProps') {\r\n        return {\r\n          value: localValue ?? '',\r\n          onChange: (e: any) => {\r\n            debouncedUpdate(e.target.value);\r\n          },\r\n          onFocus: handleFocus,\r\n          onBlur: handleBlur,\r\n          ref: formElementRef,\r\n        };\r\n      }\r\n\r\n      return target[prop];\r\n    },\r\n  });\r\n\r\n  const initialElement = renderFn(stateWithInputProps);\r\n\r\n  const wrappedElement = activeFormWrappers.reduceRight(\r\n    (currentElement, config, index) => (\r\n      <PluginWrapper\r\n        stateKey={stateKey}\r\n        path={path}\r\n        pluginName={config.plugin.name}\r\n        wrapperDepth={activeFormWrappers.length - 1 - index}\r\n      >\r\n        {currentElement}\r\n      </PluginWrapper>\r\n    ),\r\n    initialElement\r\n  );\r\n\r\n  return (\r\n    <ValidationWrapper formOpts={formOpts} path={path} stateKey={stateKey}>\r\n      {wrappedElement}\r\n    </ValidationWrapper>\r\n  );\r\n}\r\nexport function useRegisterComponent(\r\n  stateKey: string,\r\n  componentId: string,\r\n  forceUpdate: (o: object) => void\r\n) {\r\n  const fullComponentId = `${stateKey}////${componentId}`;\r\n\r\n  useLayoutEffect(() => {\r\n    // Call the safe, centralized function to register\r\n    registerComponent(stateKey, fullComponentId, {\r\n      forceUpdate: () => forceUpdate({}),\r\n      paths: new Set(),\r\n      reactiveType: ['component'],\r\n    });\r\n\r\n    // The cleanup now calls the safe, centralized unregister function\r\n    return () => {\r\n      unregisterComponent(stateKey, fullComponentId);\r\n    };\r\n  }, [stateKey, fullComponentId]); // Dependencies are stable and correct\r\n}\r\n\r\nconst useImageLoaded = (ref: RefObject<HTMLElement>): boolean => {\r\n  const [loaded, setLoaded] = useState(false);\r\n\r\n  useLayoutEffect(() => {\r\n    if (!ref.current) {\r\n      setLoaded(true);\r\n      return;\r\n    }\r\n\r\n    const images = Array.from(ref.current.querySelectorAll('img'));\r\n\r\n    // If there are no images, we are \"loaded\" immediately.\r\n    if (images.length === 0) {\r\n      setLoaded(true);\r\n      return;\r\n    }\r\n\r\n    let loadedCount = 0;\r\n    const handleImageLoad = () => {\r\n      loadedCount++;\r\n      if (loadedCount === images.length) {\r\n        setLoaded(true);\r\n      }\r\n    };\r\n\r\n    images.forEach((image) => {\r\n      if (image.complete) {\r\n        handleImageLoad();\r\n      } else {\r\n        image.addEventListener('load', handleImageLoad);\r\n        image.addEventListener('error', handleImageLoad);\r\n      }\r\n    });\r\n\r\n    return () => {\r\n      images.forEach((image) => {\r\n        image.removeEventListener('load', handleImageLoad);\r\n        image.removeEventListener('error', handleImageLoad);\r\n      });\r\n    };\r\n  }, [ref.current]);\r\n\r\n  return loaded;\r\n};\r\n// Components.tsx\r\n\r\n// Generic isolated component wrapper\r\nexport function IsolatedComponentWrapper({\r\n  stateKey,\r\n  path,\r\n  rebuildStateShape,\r\n  renderFn,\r\n}: {\r\n  stateKey: string;\r\n  path: string[];\r\n  rebuildStateShape: (options: {\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (state: any) => React.ReactNode;\r\n}) {\r\n  const [componentId] = useState(() => uuidv4());\r\n  const [, forceUpdate] = useState({});\r\n\r\n  const stateKeyPathKey = [stateKey, ...path].join('.');\r\n  useRegisterComponent(stateKey, componentId, forceUpdate);\r\n\r\n  useEffect(() => {\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(stateKeyPathKey, () => {\r\n        forceUpdate({});\r\n      });\r\n    return () => unsubscribe();\r\n  }, [stateKeyPathKey]);\r\n\r\n  const baseState = rebuildStateShape({\r\n    path: path,\r\n    componentId: componentId,\r\n    meta: undefined,\r\n  });\r\n\r\n  return <>{renderFn(baseState)}</>;\r\n}\r\n\r\n// 1. Define the MINIMAL props needed.\r\ntype PluginWrapperProps = {\r\n  children: React.ReactNode;\r\n  stateKey: string;\r\n  path: string[];\r\n  pluginName: string;\r\n  wrapperDepth: number;\r\n};\r\n\r\nconst PluginWrapper = memo(function PluginWrapper({\r\n  children,\r\n  stateKey,\r\n  path,\r\n  pluginName,\r\n  wrapperDepth,\r\n}: PluginWrapperProps) {\r\n  const [, forceUpdate] = useState({});\r\n\r\n  useEffect(() => {\r\n    const fullPathKey = [stateKey, ...path].join('.');\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(fullPathKey, () => {\r\n        forceUpdate({});\r\n      });\r\n    return unsubscribe;\r\n  }, [stateKey, path]);\r\n\r\n  const plugin = pluginStore\r\n    .getState()\r\n    .registeredPlugins.find((p) => p.name === pluginName);\r\n\r\n  const stateHandler: StateObject<any> | undefined = pluginStore\r\n    .getState()\r\n    .stateHandlers.get(stateKey);\r\n\r\n  const typeInfo = getGlobalStore.getState().getShadowNode(stateKey, path)\r\n    ?._meta?.typeInfo;\r\n\r\n  const options = pluginStore\r\n    .getState()\r\n    .pluginOptions.get(stateKey)\r\n    ?.get(pluginName);\r\n\r\n  const hookData = pluginStore.getState().getHookResult(stateKey, pluginName);\r\n\r\n  if (!plugin?.formWrapper || !stateHandler) {\r\n    return <>{children}</>;\r\n  }\r\n\r\n  const metadataContext = createMetadataContext(stateKey, plugin.name);\r\n  const deconstructed = toDeconstructedMethods(stateHandler);\r\n\r\n  return plugin.formWrapper({\r\n    element: children,\r\n    path,\r\n    stateKey,\r\n    pluginName: plugin.name,\r\n    ...deconstructed,\r\n    ...metadataContext,\r\n    options,\r\n    hookData,\r\n    fieldType: typeInfo?.type,\r\n    wrapperDepth,\r\n  });\r\n});\r\n"],"names":["getInitialOptions","getShadowMetadata","setShadowMetadata","getShadowValue","registerComponent","unregisterComponent","notifyPathSubscribers","subscribeToPath","getGlobalStore","stateHandlers","notifyFormUpdate","pluginStore","ValidationWrapper","formOpts","path","stateKey","children","thisStateOpts","validationState","status","errors","err","errorMessages","warningMessages","message","primarySeverity","jsx","Fragment","React","MemoizedCogsItemWrapper","memo","ListItemWrapper","prevProps","nextProps","itemComponentId","itemPath","localIndex","arraySetter","rebuildStateShape","renderFn","forceUpdate","useState","inViewRef","inView","useInView","elementRef","useRef","imagesLoaded","useImageLoaded","hasReportedInitialHeight","fullKey","useRegisterComponent","setRefs","useCallback","element","useEffect","unsubscribe","e","newHeight","arrayPath","arrayPathKey","itemValue","itemSetter","FormElementWrapper","setState","componentId","uuidv4","formElementRef","stateKeyPathKey","typeInfo","globalStateValue","localValue","setLocalValue","isCurrentlyDebouncing","debounceTimeoutRef","activeFormWrappers","useMemo","config","isDeepEqual","currentMeta","detectElementType","el","tagName","type","newValue","meta","debouncedUpdate","runValidation","debounceTime","handleFocus","handleBlur","baseState","stateWithInputProps","target","prop","initialElement","wrappedElement","currentElement","index","PluginWrapper","fullComponentId","useLayoutEffect","ref","loaded","setLoaded","images","loadedCount","handleImageLoad","image","IsolatedComponentWrapper","pluginName","wrapperDepth","fullPathKey","plugin","p","stateHandler","options","hookData","metadataContext","createMetadataContext","deconstructed","toDeconstructedMethods"],"mappings":"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"}
+{"version":3,"file":"Components.jsx","sources":["../src/Components.tsx"],"sourcesContent":["import {\r\n  FormElementParams,\r\n  StateObject,\r\n  UpdateTypeDetail,\r\n  type FormOptsType,\r\n} from './CogsState';\r\nimport { pluginStore } from './pluginStore';\r\nimport {\r\n  createMetadataContext,\r\n  createScopedMetadataContext,\r\n  toDeconstructedMethods,\r\n} from './plugins';\r\nimport React, {\r\n  memo,\r\n  RefObject,\r\n  useCallback,\r\n  useEffect,\r\n  useLayoutEffect,\r\n  useRef,\r\n  useState,\r\n  useMemo,\r\n} from 'react';\r\nimport { getGlobalStore, ValidationError, ValidationSeverity } from './store';\r\nimport { useInView } from 'react-intersection-observer';\r\nimport { v4 as uuidv4 } from 'uuid';\r\nimport { isDeepEqual } from './utility';\r\nimport { runValidation } from './validation';\r\n\r\nconst {\r\n  getInitialOptions,\r\n\r\n  getShadowMetadata,\r\n  setShadowMetadata,\r\n  getShadowValue,\r\n\r\n  registerComponent,\r\n  unregisterComponent,\r\n\r\n  notifyPathSubscribers,\r\n  subscribeToPath,\r\n} = getGlobalStore.getState();\r\nconst { stateHandlers, notifyFormUpdate } = pluginStore.getState();\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};\r\n\r\nexport function ValidationWrapper({\r\n  formOpts,\r\n  path,\r\n  stateKey,\r\n  children,\r\n}: ValidationWrapperProps) {\r\n  const { getInitialOptions, getShadowMetadata, getShadowValue } =\r\n    getGlobalStore.getState();\r\n  const thisStateOpts = getInitialOptions(stateKey!);\r\n\r\n  const shadowMeta = getShadowMetadata(stateKey!, path);\r\n  const validationState = shadowMeta?.validation;\r\n\r\n  const status = validationState?.status || 'NOT_VALIDATED';\r\n\r\n  const errors = (validationState?.errors || []).map((err) => ({\r\n    ...err,\r\n    path: path,\r\n  })) as ValidationError[];\r\n  const errorMessages = errors\r\n    .filter((err) => err.severity === 'error')\r\n    .map((err) => err.message);\r\n  const warningMessages = errors\r\n    .filter((err) => err.severity === 'warning')\r\n    .map((err) => err.message);\r\n\r\n  // Use first error, or first warning if no errors\r\n  const message = errorMessages[0] || warningMessages[0];\r\n  const primarySeverity: ValidationSeverity =\r\n    errorMessages.length > 0\r\n      ? 'error'\r\n      : warningMessages.length > 0\r\n        ? 'warning'\r\n        : undefined;\r\n  const { registeredPlugins } = pluginStore.getState();\r\n  const pluginsApi: any = {};\r\n\r\n  // We iterate over ALL registered plugins in the app.\r\n  registeredPlugins.forEach((plugin) => {\r\n    // A plugin is considered \"active\" for this state key if its name\r\n    // exists as a key in the options (e.g., options.syncPlugin exists).\r\n    if (thisStateOpts && thisStateOpts.hasOwnProperty(plugin.name)) {\r\n      const pluginName = plugin.name;\r\n\r\n      // Now we can safely build the API for this active plugin.\r\n      const hookData = pluginStore\r\n        .getState()\r\n        .getHookResult(stateKey, pluginName);\r\n\r\n      const scopedMetadata = createScopedMetadataContext(\r\n        stateKey,\r\n        pluginName,\r\n        path\r\n      );\r\n\r\n      pluginsApi[pluginName] = {\r\n        hookData,\r\n        getFieldMetaData: scopedMetadata.getFieldMetaData,\r\n        setFieldMetaData: scopedMetadata.setFieldMetaData,\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          status, // Now passes the new ValidationStatus type\r\n          message: formOpts?.validation?.hideMessage\r\n            ? ''\r\n            : formOpts?.validation?.message || message || '',\r\n          severity: primarySeverity,\r\n          hasErrors: errorMessages.length > 0,\r\n          hasWarnings: warningMessages.length > 0,\r\n          allErrors: errors,\r\n          path: path,\r\n          getData: () => getShadowValue(stateKey!, path),\r\n          plugins: pluginsApi,\r\n        })\r\n      ) : (\r\n        <React.Fragment key={path.toString()}>{children}</React.Fragment>\r\n      )}\r\n    </>\r\n  );\r\n}\r\nexport const MemoizedCogsItemWrapper = memo(\r\n  ListItemWrapper,\r\n  (prevProps, nextProps) => {\r\n    // Re-render if any of these change:\r\n    return (\r\n      prevProps.itemPath.join('.') === nextProps.itemPath.join('.') &&\r\n      prevProps.stateKey === nextProps.stateKey &&\r\n      prevProps.itemComponentId === nextProps.itemComponentId &&\r\n      prevProps.localIndex === nextProps.localIndex\r\n    );\r\n  }\r\n);\r\nexport function ListItemWrapper({\r\n  stateKey,\r\n  itemComponentId,\r\n  itemPath,\r\n  localIndex,\r\n  arraySetter,\r\n  rebuildStateShape,\r\n  renderFn,\r\n}: {\r\n  stateKey: string;\r\n  itemComponentId: string;\r\n  itemPath: string[];\r\n  localIndex: number;\r\n  arraySetter: any;\r\n\r\n  rebuildStateShape: (options: {\r\n    currentState: any;\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (\r\n    setter: any,\r\n    index: number,\r\n\r\n    arraySetter: any\r\n  ) => React.ReactNode;\r\n}) {\r\n  const [, forceUpdate] = useState({});\r\n  const { ref: inViewRef, inView } = useInView();\r\n  const elementRef = useRef<HTMLDivElement | null>(null);\r\n\r\n  const imagesLoaded = useImageLoaded(elementRef);\r\n  const hasReportedInitialHeight = useRef(false);\r\n  const fullKey = [stateKey, ...itemPath].join('.');\r\n  useRegisterComponent(stateKey, itemComponentId, forceUpdate);\r\n\r\n  const setRefs = useCallback(\r\n    (element: HTMLDivElement | null) => {\r\n      elementRef.current = element;\r\n      inViewRef(element); // This is the ref from useInView\r\n    },\r\n    [inViewRef]\r\n  );\r\n\r\n  useEffect(() => {\r\n    const unsubscribe = subscribeToPath(fullKey, (e) => {\r\n      forceUpdate({});\r\n    });\r\n    return () => unsubscribe();\r\n  }, [fullKey]);\r\n  useEffect(() => {\r\n    if (!inView || !imagesLoaded || hasReportedInitialHeight.current) {\r\n      return;\r\n    }\r\n\r\n    const element = elementRef.current;\r\n    if (element && element.offsetHeight > 0) {\r\n      hasReportedInitialHeight.current = true;\r\n      const newHeight = element.offsetHeight;\r\n\r\n      setShadowMetadata(stateKey, itemPath, {\r\n        virtualizer: {\r\n          itemHeight: newHeight,\r\n          domRef: element,\r\n        },\r\n      });\r\n\r\n      const arrayPath = itemPath.slice(0, -1);\r\n      const arrayPathKey = [stateKey, ...arrayPath].join('.');\r\n      notifyPathSubscribers(arrayPathKey, {\r\n        type: 'ITEMHEIGHT',\r\n        itemKey: itemPath.join('.'),\r\n\r\n        ref: elementRef.current,\r\n      });\r\n    }\r\n  }, [inView, imagesLoaded, stateKey, itemPath]);\r\n\r\n  const itemValue = getShadowValue(stateKey, itemPath);\r\n\r\n  if (itemValue === undefined) {\r\n    return null;\r\n  }\r\n\r\n  const itemSetter = rebuildStateShape({\r\n    currentState: itemValue,\r\n    path: itemPath,\r\n    componentId: itemComponentId,\r\n  });\r\n  const children = renderFn(itemSetter, localIndex, arraySetter);\r\n\r\n  return <div ref={setRefs}>{children}</div>;\r\n}\r\n\r\nexport function FormElementWrapper({\r\n  stateKey,\r\n  path,\r\n  rebuildStateShape,\r\n  renderFn,\r\n  formOpts,\r\n  setState,\r\n}: {\r\n  stateKey: string;\r\n  path: string[];\r\n  rebuildStateShape: (options: {\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (params: FormElementParams<any>) => React.ReactNode;\r\n  formOpts?: FormOptsType;\r\n  setState: any;\r\n}) {\r\n  const componentId = useRef(uuidv4()).current;\r\n\r\n  const [, forceUpdate] = useState({});\r\n  const formElementRef = useRef<any>(null);\r\n  const stateKeyPathKey = [stateKey, ...path].join('.');\r\n  useRegisterComponent(stateKey, componentId, forceUpdate);\r\n  // Get the shadow node to access typeInfo and schema\r\n  const shadowNode = getGlobalStore.getState().getShadowNode(stateKey, path);\r\n  const typeInfo = shadowNode?._meta?.typeInfo;\r\n\r\n  const globalStateValue = getShadowValue(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  useEffect(() => {\r\n    if (\r\n      !isCurrentlyDebouncing.current &&\r\n      !isDeepEqual(globalStateValue, localValue)\r\n    ) {\r\n      setLocalValue(globalStateValue);\r\n    }\r\n  }, [globalStateValue]);\r\n\r\n  useEffect(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Initialize clientActivityState if needed\r\n    const currentMeta = getShadowMetadata(stateKey, path) || {};\r\n    if (!currentMeta.clientActivityState) {\r\n      currentMeta.clientActivityState = { elements: new Map() };\r\n    }\r\n\r\n    // Detect element type from the ref\r\n    const detectElementType = () => {\r\n      const el = formElementRef.current;\r\n      if (!el) return 'input';\r\n      const tagName = el.tagName.toLowerCase();\r\n      if (tagName === 'textarea') return 'textarea';\r\n      if (tagName === 'select') return 'select';\r\n      if (tagName === 'input') {\r\n        const type = (el as HTMLInputElement).type;\r\n        if (type === 'checkbox') return 'checkbox';\r\n        if (type === 'radio') return 'radio';\r\n        if (type === 'range') return 'range';\r\n        if (type === 'file') return 'file';\r\n      }\r\n      return 'input';\r\n    };\r\n\r\n    // Add this element to the Map\r\n    currentMeta.clientActivityState.elements.set(componentId, {\r\n      domRef: formElementRef,\r\n      elementType: detectElementType(),\r\n      inputType: formElementRef.current?.type,\r\n      mountedAt: Date.now(),\r\n    });\r\n\r\n    setShadowMetadata(stateKey, path, currentMeta);\r\n\r\n    // Subscribe to path updates\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(stateKeyPathKey, (newValue) => {\r\n        if (!isCurrentlyDebouncing.current && localValue !== newValue) {\r\n          forceUpdate({});\r\n        }\r\n      });\r\n\r\n    // Cleanup\r\n    return () => {\r\n      unsubscribe();\r\n\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current);\r\n        isCurrentlyDebouncing.current = false;\r\n      }\r\n\r\n      // Remove element from Map\r\n      const meta = getGlobalStore.getState().getShadowMetadata(stateKey, path);\r\n      if (meta?.clientActivityState?.elements) {\r\n        meta.clientActivityState.elements.delete(componentId);\r\n        setShadowMetadata(stateKey, path, meta);\r\n      }\r\n    };\r\n  }, []);\r\n\r\n  const debouncedUpdate = useCallback(\r\n    (newValue: any) => {\r\n      // Type conversion logic (keep existing)\r\n      if (typeInfo) {\r\n        if (typeInfo.type === 'number' && typeof newValue === 'string') {\r\n          newValue =\r\n            newValue === ''\r\n              ? typeInfo.nullable\r\n                ? null\r\n                : (typeInfo.default ?? 0)\r\n              : Number(newValue);\r\n        } else if (\r\n          typeInfo.type === 'boolean' &&\r\n          typeof newValue === 'string'\r\n        ) {\r\n          newValue = newValue === 'true' || newValue === '1';\r\n        } else if (typeInfo.type === 'date' && typeof newValue === 'string') {\r\n          newValue = new Date(newValue);\r\n        }\r\n      } else {\r\n        const currentType = typeof globalStateValue;\r\n        if (currentType === 'number' && typeof newValue === 'string') {\r\n          newValue = newValue === '' ? 0 : Number(newValue);\r\n        }\r\n      }\r\n\r\n      setLocalValue(newValue);\r\n\r\n      // Update input activity details\r\n      const { getShadowMetadata, setShadowMetadata } =\r\n        getGlobalStore.getState();\r\n      const meta = getShadowMetadata(stateKey, path);\r\n      if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n        const element = meta.clientActivityState.elements.get(componentId);\r\n        if (element && element.currentActivity?.type === 'focus') {\r\n          element!.currentActivity.details = {\r\n            ...element!.currentActivity.details,\r\n            value: newValue,\r\n            previousValue:\r\n              element!.currentActivity.details?.value || globalStateValue,\r\n            inputLength:\r\n              typeof newValue === 'string' ? newValue.length : undefined,\r\n            keystrokeCount:\r\n              (element!.currentActivity.details?.keystrokeCount || 0) + 1,\r\n          };\r\n          setShadowMetadata(stateKey, path, meta);\r\n        }\r\n      }\r\n      const element = meta?.clientActivityState?.elements?.get(componentId);\r\n\r\n      // Notify plugins\r\n      notifyFormUpdate({\r\n        stateKey,\r\n        activityType: 'input', // Changed from 'type'\r\n        path,\r\n        timestamp: Date.now(),\r\n        details: {\r\n          value: newValue,\r\n          inputLength:\r\n            typeof newValue === 'string' ? newValue.length : undefined,\r\n          isComposing: false, // You'd need to track this from the actual input event\r\n          isPasting: false, // You'd need to track this from paste events\r\n          keystrokeCount:\r\n            (element?.currentActivity?.details?.keystrokeCount || 0) + 1,\r\n        },\r\n      });\r\n      // Validation (keep existing)\r\n      const virtualOperation: UpdateTypeDetail = {\r\n        stateKey,\r\n        path,\r\n        newValue: newValue,\r\n        updateType: 'update',\r\n        timeStamp: Date.now(),\r\n        status: 'new',\r\n        oldValue: globalStateValue,\r\n      };\r\n      runValidation(virtualOperation, 'onChange');\r\n\r\n      // Debounce state update (keep existing)\r\n      isCurrentlyDebouncing.current = true;\r\n      if (debounceTimeoutRef.current) {\r\n        clearTimeout(debounceTimeoutRef.current);\r\n      }\r\n\r\n      const debounceTime = formOpts?.debounceTime ?? 200;\r\n      debounceTimeoutRef.current = setTimeout(() => {\r\n        isCurrentlyDebouncing.current = false;\r\n        setState(newValue, path, {\r\n          updateType: 'update',\r\n          validationTrigger: 'onChange',\r\n        });\r\n      }, debounceTime);\r\n    },\r\n    [\r\n      setState,\r\n      path,\r\n      formOpts?.debounceTime,\r\n      typeInfo,\r\n      globalStateValue,\r\n      stateKey,\r\n      componentId,\r\n    ]\r\n  );\r\n\r\n  const handleFocus = useCallback(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Update element's current activity\r\n    const meta = getShadowMetadata(stateKey, path);\r\n    if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n      const element = meta.clientActivityState.elements.get(componentId)!;\r\n      element.currentActivity = {\r\n        type: 'focus',\r\n        startTime: Date.now(),\r\n        details: {\r\n          value: localValue,\r\n          inputLength:\r\n            typeof localValue === 'string' ? localValue.length : undefined,\r\n        },\r\n      };\r\n      setShadowMetadata(stateKey, path, meta);\r\n    }\r\n\r\n    // Notify plugins\r\n    notifyFormUpdate({\r\n      stateKey,\r\n      activityType: 'focus', // Changed from 'type'\r\n      path,\r\n      timestamp: Date.now(),\r\n      details: {\r\n        cursorPosition: formElementRef.current?.selectionStart,\r\n      },\r\n    });\r\n  }, [stateKey, path, componentId, localValue]);\r\n  const handleBlur = useCallback(() => {\r\n    const { getShadowMetadata, setShadowMetadata } = getGlobalStore.getState();\r\n\r\n    // Clear debounce if active\r\n    if (debounceTimeoutRef.current) {\r\n      clearTimeout(debounceTimeoutRef.current);\r\n      debounceTimeoutRef.current = null;\r\n      isCurrentlyDebouncing.current = false;\r\n      setState(localValue, path, {\r\n        updateType: 'update',\r\n        validationTrigger: 'onBlur',\r\n      });\r\n    }\r\n\r\n    // Clear element's current activity\r\n    const meta = getShadowMetadata(stateKey, path);\r\n    if (meta?.clientActivityState?.elements?.has(componentId)) {\r\n      const element = meta.clientActivityState.elements.get(componentId)!;\r\n      element.currentActivity = undefined;\r\n      setShadowMetadata(stateKey, path, meta);\r\n    }\r\n    const focusStartTime =\r\n      meta?.clientActivityState?.elements?.get(componentId)?.currentActivity\r\n        ?.startTime;\r\n\r\n    // Notify plugins\r\n    notifyFormUpdate({\r\n      stateKey,\r\n      activityType: 'blur', // Changed from 'type'\r\n      path,\r\n      timestamp: Date.now(),\r\n      duration: focusStartTime ? Date.now() - focusStartTime : undefined,\r\n      details: {\r\n        duration: focusStartTime ? Date.now() - focusStartTime : 0,\r\n      },\r\n    });\r\n\r\n    // Run validation if configured\r\n    const validationOptions = getInitialOptions(stateKey)?.validation;\r\n    if (validationOptions?.onBlur) {\r\n      const virtualOperation: UpdateTypeDetail = {\r\n        stateKey,\r\n        path,\r\n        newValue: localValue,\r\n        updateType: 'update',\r\n        timeStamp: Date.now(),\r\n        status: 'new',\r\n        oldValue: globalStateValue,\r\n      };\r\n      runValidation(virtualOperation, 'onBlur');\r\n    }\r\n  }, [localValue, setState, path, stateKey, componentId, globalStateValue]);\r\n\r\n  const baseState = rebuildStateShape({\r\n    path: path,\r\n    componentId: componentId,\r\n    meta: undefined,\r\n  });\r\n\r\n  const stateWithInputProps = new Proxy(baseState, {\r\n    get(target, prop) {\r\n      if (prop === '$inputProps') {\r\n        return {\r\n          value: localValue ?? '',\r\n          onChange: (e: any) => {\r\n            debouncedUpdate(e.target.value);\r\n          },\r\n          onFocus: handleFocus,\r\n          onBlur: handleBlur,\r\n          ref: formElementRef,\r\n        };\r\n      }\r\n\r\n      return target[prop];\r\n    },\r\n  });\r\n\r\n  const initialElement = renderFn(stateWithInputProps);\r\n\r\n  return (\r\n    <ValidationWrapper formOpts={formOpts} path={path} stateKey={stateKey}>\r\n      {initialElement}\r\n    </ValidationWrapper>\r\n  );\r\n}\r\nexport function useRegisterComponent(\r\n  stateKey: string,\r\n  componentId: string,\r\n  forceUpdate: (o: object) => void\r\n) {\r\n  const fullComponentId = `${stateKey}////${componentId}`;\r\n\r\n  useLayoutEffect(() => {\r\n    // Call the safe, centralized function to register\r\n    registerComponent(stateKey, fullComponentId, {\r\n      forceUpdate: () => forceUpdate({}),\r\n      paths: new Set(),\r\n      reactiveType: ['component'],\r\n    });\r\n\r\n    // The cleanup now calls the safe, centralized unregister function\r\n    return () => {\r\n      unregisterComponent(stateKey, fullComponentId);\r\n    };\r\n  }, [stateKey, fullComponentId]); // Dependencies are stable and correct\r\n}\r\n\r\nconst useImageLoaded = (ref: RefObject<HTMLElement>): boolean => {\r\n  const [loaded, setLoaded] = useState(false);\r\n\r\n  useLayoutEffect(() => {\r\n    if (!ref.current) {\r\n      setLoaded(true);\r\n      return;\r\n    }\r\n\r\n    const images = Array.from(ref.current.querySelectorAll('img'));\r\n\r\n    // If there are no images, we are \"loaded\" immediately.\r\n    if (images.length === 0) {\r\n      setLoaded(true);\r\n      return;\r\n    }\r\n\r\n    let loadedCount = 0;\r\n    const handleImageLoad = () => {\r\n      loadedCount++;\r\n      if (loadedCount === images.length) {\r\n        setLoaded(true);\r\n      }\r\n    };\r\n\r\n    images.forEach((image) => {\r\n      if (image.complete) {\r\n        handleImageLoad();\r\n      } else {\r\n        image.addEventListener('load', handleImageLoad);\r\n        image.addEventListener('error', handleImageLoad);\r\n      }\r\n    });\r\n\r\n    return () => {\r\n      images.forEach((image) => {\r\n        image.removeEventListener('load', handleImageLoad);\r\n        image.removeEventListener('error', handleImageLoad);\r\n      });\r\n    };\r\n  }, [ref.current]);\r\n\r\n  return loaded;\r\n};\r\n// Components.tsx\r\n\r\n// Generic isolated component wrapper\r\nexport function IsolatedComponentWrapper({\r\n  stateKey,\r\n  path,\r\n  rebuildStateShape,\r\n  renderFn,\r\n}: {\r\n  stateKey: string;\r\n  path: string[];\r\n  rebuildStateShape: (options: {\r\n    path: string[];\r\n    componentId: string;\r\n    meta?: any;\r\n  }) => any;\r\n  renderFn: (state: any) => React.ReactNode;\r\n}) {\r\n  const [componentId] = useState(() => uuidv4());\r\n  const [, forceUpdate] = useState({});\r\n\r\n  const stateKeyPathKey = [stateKey, ...path].join('.');\r\n  useRegisterComponent(stateKey, componentId, forceUpdate);\r\n\r\n  useEffect(() => {\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(stateKeyPathKey, () => {\r\n        forceUpdate({});\r\n      });\r\n    return () => unsubscribe();\r\n  }, [stateKeyPathKey]);\r\n\r\n  const baseState = rebuildStateShape({\r\n    path: path,\r\n    componentId: componentId,\r\n    meta: undefined,\r\n  });\r\n\r\n  return <>{renderFn(baseState)}</>;\r\n}\r\n\r\n// 1. Define the MINIMAL props needed.\r\ntype PluginWrapperProps = {\r\n  children: React.ReactNode;\r\n  stateKey: string;\r\n  path: string[];\r\n  pluginName: string;\r\n  wrapperDepth: number;\r\n};\r\n\r\nconst PluginWrapper = memo(function PluginWrapper({\r\n  children,\r\n  stateKey,\r\n  path,\r\n  pluginName,\r\n  wrapperDepth,\r\n}: PluginWrapperProps) {\r\n  const [, forceUpdate] = useState({});\r\n\r\n  useEffect(() => {\r\n    const fullPathKey = [stateKey, ...path].join('.');\r\n    const unsubscribe = getGlobalStore\r\n      .getState()\r\n      .subscribeToPath(fullPathKey, () => {\r\n        forceUpdate({});\r\n      });\r\n    return unsubscribe;\r\n  }, [stateKey, path]);\r\n\r\n  const plugin = pluginStore\r\n    .getState()\r\n    .registeredPlugins.find((p) => p.name === pluginName);\r\n\r\n  const stateHandler: StateObject<any> | undefined = pluginStore\r\n    .getState()\r\n    .stateHandlers.get(stateKey);\r\n\r\n  const typeInfo = getGlobalStore.getState().getShadowNode(stateKey, path)\r\n    ?._meta?.typeInfo;\r\n\r\n  const options = pluginStore\r\n    .getState()\r\n    .pluginOptions.get(stateKey)\r\n    ?.get(pluginName);\r\n\r\n  const hookData = pluginStore.getState().getHookResult(stateKey, pluginName);\r\n\r\n  if (!plugin?.formWrapper || !stateHandler) {\r\n    return <>{children}</>;\r\n  }\r\n\r\n  const deconstructed = toDeconstructedMethods(stateHandler);\r\n  const scopedMetadataContext = createScopedMetadataContext(\r\n    stateKey,\r\n    plugin.name,\r\n    path\r\n  );\r\n  return plugin.formWrapper({\r\n    element: children,\r\n    path,\r\n    stateKey,\r\n    pluginName: plugin.name,\r\n    ...deconstructed,\r\n\r\n    ...scopedMetadataContext,\r\n    options,\r\n    hookData,\r\n    fieldType: typeInfo?.type,\r\n    wrapperDepth,\r\n  });\r\n});\r\n"],"names":["getInitialOptions","getShadowMetadata","setShadowMetadata","getShadowValue","registerComponent","unregisterComponent","notifyPathSubscribers","subscribeToPath","getGlobalStore","stateHandlers","notifyFormUpdate","pluginStore","ValidationWrapper","formOpts","path","stateKey","children","thisStateOpts","validationState","status","errors","err","errorMessages","warningMessages","message","primarySeverity","registeredPlugins","pluginsApi","plugin","pluginName","hookData","scopedMetadata","createScopedMetadataContext","jsx","Fragment","React","MemoizedCogsItemWrapper","memo","ListItemWrapper","prevProps","nextProps","itemComponentId","itemPath","localIndex","arraySetter","rebuildStateShape","renderFn","forceUpdate","useState","inViewRef","inView","useInView","elementRef","useRef","imagesLoaded","useImageLoaded","hasReportedInitialHeight","fullKey","useRegisterComponent","setRefs","useCallback","element","useEffect","unsubscribe","e","newHeight","arrayPath","arrayPathKey","itemValue","itemSetter","FormElementWrapper","setState","componentId","uuidv4","formElementRef","stateKeyPathKey","typeInfo","globalStateValue","localValue","setLocalValue","isCurrentlyDebouncing","debounceTimeoutRef","isDeepEqual","currentMeta","detectElementType","el","tagName","type","newValue","meta","debouncedUpdate","runValidation","debounceTime","handleFocus","handleBlur","focusStartTime","baseState","stateWithInputProps","target","prop","initialElement","fullComponentId","useLayoutEffect","ref","loaded","setLoaded","images","loadedCount","handleImageLoad","image","IsolatedComponentWrapper","wrapperDepth","fullPathKey","p","stateHandler","options","deconstructed","toDeconstructedMethods","scopedMetadataContext"],"mappings":"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"}

package/dist/PluginRunner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginRunner.d.ts","sourceRoot":"","sources":["../src/PluginRunner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AA0JhF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAiDvE"}
+{"version":3,"file":"PluginRunner.d.ts","sourceRoot":"","sources":["../src/PluginRunner.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA2D,MAAM,OAAO,CAAC;AAuKhF;;;GAGG;AACH,wBAAgB,YAAY,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;CAAE,2CAiDvE"}

package/dist/PluginRunner.jsx

@@ -1,121 +1,130 @@
-import { jsxs as F, Fragment as M, jsx as P } from "react/jsx-runtime";
-import T, { useState as S, useMemo as U, useEffect as m, useRef as H, useReducer as C } from "react";
+import { jsxs as F, Fragment as C, jsx as P } from "react/jsx-runtime";
+import T, { useState as R, useMemo as M, useEffect as m, useRef as x, useReducer as N } from "react";
 import { pluginStore as f } from "./pluginStore.js";
-import { isDeepEqual as N } from "./utility.js";
-import { createMetadataContext as j, toDeconstructedMethods as v } from "./plugins.js";
-const { setHookResult: A, removeHookResult: I } = f.getState(), E = T.memo(
+import { isDeepEqual as j } from "./utility.js";
+import { createMetadataContext as A, toDeconstructedMethods as E, createScopedMetadataContext as H } from "./plugins.js";
+const { setHookResult: O, removeHookResult: I } = f.getState(), $ = T.memo(
   ({
     stateKey: r,
     plugin: e,
     options: t,
     stateHandler: d
   }) => {
-    const [i, s] = S(!0), n = U(
-      () => j(r, e.name),
+    const [b, a] = R(!0), c = M(
+      () => A(r, e.name),
       [r, e.name]
-    ), o = U(
-      () => v(d),
+    ), o = M(
+      () => E(d),
       [d]
-    ), b = U(
+    ), i = M(
       () => ({
         stateKey: r,
         pluginName: e.name,
-        isInitialMount: i,
+        isInitialMount: b,
         options: t,
         ...o,
-        ...n
+        ...c
       }),
       [
         r,
         e.name,
-        i,
+        b,
         t,
         o,
-        n
+        c
       ]
-    ), a = e.useHook ? e.useHook(b) : void 0;
+    ), s = e.useHook ? e.useHook(i) : void 0;
     m(() => {
-      s(!1);
-    }, []), m(() => (e.useHook ? A(r, e.name, a) : I(r, e.name), () => I(r, e.name)), [r, e.name, !!e.useHook, a]);
-    const u = H(), [h, x] = S(!0);
+      a(!1);
+    }, []), m(() => (e.useHook ? O(r, e.name, s) : I(r, e.name), () => I(r, e.name)), [r, e.name, !!e.useHook, s]);
+    const u = x(), [h, D] = R(!0);
     m(() => {
-      e.transformState && (N(t, u.current) || (e.transformState({
+      e.transformState && (j(t, u.current) || (e.transformState({
         stateKey: r,
         pluginName: e.name,
         options: t,
-        hookData: a,
+        hookData: s,
         isInitialTransform: h,
         ...o,
-        ...n
-      }), u.current = t, x(!1)));
+        ...c
+      }), u.current = t, D(!1)));
     }, [
       r,
       e,
       t,
-      a,
+      s,
       h,
       o,
-      n
+      c
     ]);
-    const k = H(a);
-    return k.current = a, m(() => {
+    const k = x(s);
+    return k.current = s, m(() => {
       if (!e.onUpdate) return;
-      const l = (c) => {
-        c.stateKey === r && e.onUpdate({
-          stateKey: r,
-          pluginName: e.name,
-          update: c,
-          path: c.path,
-          options: t,
-          hookData: k.current,
-          ...o,
-          ...n
-        });
+      const S = (n) => {
+        if (n.stateKey === r) {
+          const U = H(
+            r,
+            e.name,
+            n.path
+          );
+          e.onUpdate({
+            stateKey: r,
+            pluginName: e.name,
+            update: n,
+            path: n.path,
+            options: t,
+            hookData: k.current,
+            ...o,
+            ...U
+            // <-- Use the new scoped context
+          });
+        }
       };
-      return f.getState().subscribeToUpdates(l);
-    }, [r, e, t, o, n]), m(() => {
+      return f.getState().subscribeToUpdates(S);
+    }, [r, e, t, o]), m(() => {
       if (!e.onFormUpdate) return;
-      const l = (c) => {
-        if (c.stateKey === r) {
-          const R = c.path;
+      const S = (n) => {
+        if (n.stateKey === r) {
+          const U = H(
+            r,
+            e.name,
+            n.path
+          );
           e.onFormUpdate({
             stateKey: r,
             pluginName: e.name,
-            path: R,
-            event: {
-              type: c.type,
-              value: c.value,
-              path: R
-            },
+            path: n.path,
+            event: n,
             options: t,
             hookData: k.current,
             ...o,
-            ...n
+            ...U
+            // <-- Use the new scoped context
           });
         }
       };
-      return f.getState().subscribeToFormUpdates(l);
-    }, [r, e, t, o, n]), null;
+      return f.getState().subscribeToFormUpdates(S);
+    }, [r, e, t, o]), null;
   }
 );
-function B({ children: r }) {
-  const [, e] = C((s) => s + 1, 0);
+function J({ children: r }) {
+  const [, e] = N((a) => a + 1, 0);
   m(() => f.subscribe(e), []);
-  const { pluginOptions: t, stateHandlers: d, registeredPlugins: i } = f.getState();
-  return /* @__PURE__ */ F(M, { children: [
-    Array.from(t.entries()).map(([s, n]) => {
-      const o = d.get(s);
-      return o ? Array.from(n.entries()).map(([b, a]) => {
-        const u = i.find((h) => h.name === b);
+  const { pluginOptions: t, stateHandlers: d, registeredPlugins: b } = f.getState();
+  return /* @__PURE__ */ F(C, { children: [
+    Array.from(t.entries()).map(([a, c]) => {
+      const o = d.get(a);
+      return o ? Array.from(c.entries()).map(([i, s]) => {
+        const u = b.find((h) => h.name === i);
         return u ? /* @__PURE__ */ P(
-          E,
+          $,
           {
-            stateKey: s,
+            stateKey: a,
             plugin: u,
-            options: a,
+            options: s,
             stateHandler: o
           },
-          `${s}:${b}`
+          `${a}:${i}`
         ) : null;
       }) : null;
     }),
@@ -123,6 +132,6 @@ function B({ children: r }) {
   ] });
 }
 export {
-  B as PluginRunner
+  J as PluginRunner
 };
 //# sourceMappingURL=PluginRunner.jsx.map

package/dist/PluginRunner.jsx.map

@@ -1 +1 @@
-{"version":3,"file":"PluginRunner.jsx","sources":["../src/PluginRunner.tsx"],"sourcesContent":["import React, { useEffect, useMemo, useState, useRef, useReducer } from 'react';\r\nimport { pluginStore } from './pluginStore';\r\nimport { isDeepEqual } from './utility';\r\nimport { createMetadataContext, toDeconstructedMethods } from './plugins';\r\nimport type { CogsPlugin } from './plugins';\r\nimport type { StateObject, UpdateTypeDetail } from './CogsState';\r\nimport { FormEventType } from './store';\r\n\r\nconst { setHookResult, removeHookResult } = pluginStore.getState();\r\n\r\nconst PluginInstance = React.memo(\r\n  ({\r\n    stateKey,\r\n    plugin,\r\n    options,\r\n    stateHandler,\r\n  }: {\r\n    stateKey: string;\r\n    plugin: CogsPlugin<any, any, any, any, any>;\r\n    options: any;\r\n    stateHandler: StateObject<any>;\r\n  }) => {\r\n    const [isInitialMount, setIsInitialMount] = useState(true);\r\n    const metadataContext = useMemo(\r\n      () => createMetadataContext(stateKey, plugin.name),\r\n      [stateKey, plugin.name]\r\n    );\r\n\r\n    const deconstructed = useMemo(\r\n      () => toDeconstructedMethods(stateHandler),\r\n      [stateHandler]\r\n    );\r\n\r\n    const hookContext = useMemo(\r\n      () => ({\r\n        stateKey,\r\n        pluginName: plugin.name,\r\n        isInitialMount,\r\n        options,\r\n        ...deconstructed,\r\n        ...metadataContext,\r\n      }),\r\n      [\r\n        stateKey,\r\n        plugin.name,\r\n        isInitialMount,\r\n        options,\r\n        deconstructed,\r\n        metadataContext,\r\n      ]\r\n    );\r\n\r\n    const hookData = plugin.useHook ? plugin.useHook(hookContext) : undefined;\r\n\r\n    useEffect(() => {\r\n      setIsInitialMount(false);\r\n    }, []);\r\n\r\n    useEffect(() => {\r\n      if (plugin.useHook) setHookResult(stateKey, plugin.name, hookData);\r\n      else removeHookResult(stateKey, plugin.name);\r\n      return () => removeHookResult(stateKey, plugin.name);\r\n    }, [stateKey, plugin.name, !!plugin.useHook, hookData]);\r\n\r\n    const lastProcessedOptionsRef = useRef<any>();\r\n    const [isInitialTransform, setIsInitialTransform] = useState(true);\r\n\r\n    useEffect(() => {\r\n      if (plugin.transformState) {\r\n        if (!isDeepEqual(options, lastProcessedOptionsRef.current)) {\r\n          plugin.transformState({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            options,\r\n            hookData,\r\n            isInitialTransform,\r\n            ...deconstructed,\r\n            ...metadataContext,\r\n          });\r\n          lastProcessedOptionsRef.current = options;\r\n          setIsInitialTransform(false);\r\n        }\r\n      }\r\n    }, [\r\n      stateKey,\r\n      plugin,\r\n      options,\r\n      hookData,\r\n      isInitialTransform,\r\n      deconstructed,\r\n      metadataContext,\r\n    ]);\r\n\r\n    const hookDataRef = useRef(hookData);\r\n    hookDataRef.current = hookData;\r\n\r\n    useEffect(() => {\r\n      if (!plugin.onUpdate) return;\r\n\r\n      const handleUpdate = (update: UpdateTypeDetail) => {\r\n        if (update.stateKey === stateKey) {\r\n          plugin.onUpdate!({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            update,\r\n            path: update.path,\r\n            options,\r\n            hookData: hookDataRef.current,\r\n            ...deconstructed,\r\n            ...metadataContext,\r\n          });\r\n        }\r\n      };\r\n\r\n      const unsubscribe = pluginStore\r\n        .getState()\r\n        .subscribeToUpdates(handleUpdate);\r\n      return unsubscribe;\r\n    }, [stateKey, plugin, options, deconstructed, metadataContext]);\r\n\r\n    useEffect(() => {\r\n      if (!plugin.onFormUpdate) return;\r\n\r\n      const handleFormUpdate = (\r\n        event: FormEventType & { stateKey: string }\r\n      ) => {\r\n        if (event.stateKey === stateKey) {\r\n          const path = event.path;\r\n          plugin.onFormUpdate!({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            path,\r\n            event: {\r\n              type: event.type,\r\n              value: event.value,\r\n              path,\r\n            },\r\n            options,\r\n            hookData: hookDataRef.current,\r\n            ...deconstructed,\r\n            ...metadataContext,\r\n          });\r\n        }\r\n      };\r\n\r\n      const unsubscribe = pluginStore\r\n        .getState()\r\n        .subscribeToFormUpdates(handleFormUpdate);\r\n      return unsubscribe;\r\n    }, [stateKey, plugin, options, deconstructed, metadataContext]);\r\n\r\n    return null;\r\n  }\r\n);\r\n/**\r\n * The main orchestrator component. It reads from the central pluginStore\r\n * and renders a `PluginInstance` controller for each active plugin.\r\n */\r\nexport function PluginRunner({ children }: { children: React.ReactNode }) {\r\n  // A simple way to force a re-render when the store changes.\r\n  const [, forceUpdate] = useReducer((c) => c + 1, 0);\r\n\r\n  // Subscribe to the store. When plugins or their options are added/removed,\r\n  // this component will re-render to update the list of PluginInstances.\r\n  useEffect(() => {\r\n    const unsubscribe = pluginStore.subscribe(forceUpdate);\r\n    return unsubscribe;\r\n  }, []);\r\n\r\n  const { pluginOptions, stateHandlers, registeredPlugins } =\r\n    pluginStore.getState();\r\n\r\n  return (\r\n    <>\r\n      {/*\r\n        This declarative mapping is the core of the solution.\r\n        React will now manage adding and removing `PluginInstance` components\r\n        as the application state changes, ensuring hooks are handled safely.\r\n      */}\r\n      {Array.from(pluginOptions.entries()).map(([stateKey, pluginMap]) => {\r\n        const stateHandler = stateHandlers.get(stateKey);\r\n        if (!stateHandler) {\r\n          return null; // Don't render a runner if the state handler isn't ready.\r\n        }\r\n\r\n        return Array.from(pluginMap.entries()).map(([pluginName, options]) => {\r\n          const plugin = registeredPlugins.find((p) => p.name === pluginName);\r\n          if (!plugin) {\r\n            return null; // Don't render if the plugin is not in the registered list.\r\n          }\r\n\r\n          // Render a dedicated, memoized controller for this specific plugin configuration.\r\n          return (\r\n            <PluginInstance\r\n              key={`${stateKey}:${pluginName}`}\r\n              stateKey={stateKey}\r\n              plugin={plugin}\r\n              options={options}\r\n              stateHandler={stateHandler}\r\n            />\r\n          );\r\n        });\r\n      })}\r\n\r\n      {children}\r\n    </>\r\n  );\r\n}\r\n"],"names":["setHookResult","removeHookResult","pluginStore","PluginInstance","React","stateKey","plugin","options","stateHandler","isInitialMount","setIsInitialMount","useState","metadataContext","useMemo","createMetadataContext","deconstructed","toDeconstructedMethods","hookContext","hookData","useEffect","lastProcessedOptionsRef","useRef","isInitialTransform","setIsInitialTransform","isDeepEqual","hookDataRef","handleUpdate","update","handleFormUpdate","event","path","PluginRunner","children","forceUpdate","useReducer","c","pluginOptions","stateHandlers","registeredPlugins","jsxs","Fragment","pluginMap","pluginName","p","jsx"],"mappings":"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"}
+{"version":3,"file":"PluginRunner.jsx","sources":["../src/PluginRunner.tsx"],"sourcesContent":["import React, { useEffect, useMemo, useState, useRef, useReducer } from 'react';\r\nimport { ClientActivityEvent, pluginStore } from './pluginStore';\r\nimport { isDeepEqual } from './utility';\r\nimport {\r\n  createMetadataContext,\r\n  createScopedMetadataContext,\r\n  toDeconstructedMethods,\r\n} from './plugins';\r\nimport type { CogsPlugin } from './plugins';\r\nimport type { StateObject, UpdateTypeDetail } from './CogsState';\r\nimport { ClientActivityState, FormEventType } from './store';\r\n\r\nconst { setHookResult, removeHookResult } = pluginStore.getState();\r\n\r\nconst PluginInstance = React.memo(\r\n  ({\r\n    stateKey,\r\n    plugin,\r\n    options,\r\n    stateHandler,\r\n  }: {\r\n    stateKey: string;\r\n    plugin: CogsPlugin<any, any, any, any, any>;\r\n    options: any;\r\n    stateHandler: StateObject<any>;\r\n  }) => {\r\n    const [isInitialMount, setIsInitialMount] = useState(true);\r\n    const metadataContext = useMemo(\r\n      () => createMetadataContext(stateKey, plugin.name),\r\n      [stateKey, plugin.name]\r\n    );\r\n\r\n    const deconstructed = useMemo(\r\n      () => toDeconstructedMethods(stateHandler),\r\n      [stateHandler]\r\n    );\r\n\r\n    const hookContext = useMemo(\r\n      () => ({\r\n        stateKey,\r\n        pluginName: plugin.name,\r\n        isInitialMount,\r\n        options,\r\n        ...deconstructed,\r\n        ...metadataContext,\r\n      }),\r\n      [\r\n        stateKey,\r\n        plugin.name,\r\n        isInitialMount,\r\n        options,\r\n        deconstructed,\r\n        metadataContext,\r\n      ]\r\n    );\r\n\r\n    const hookData = plugin.useHook ? plugin.useHook(hookContext) : undefined;\r\n\r\n    useEffect(() => {\r\n      setIsInitialMount(false);\r\n    }, []);\r\n\r\n    useEffect(() => {\r\n      if (plugin.useHook) setHookResult(stateKey, plugin.name, hookData);\r\n      else removeHookResult(stateKey, plugin.name);\r\n      return () => removeHookResult(stateKey, plugin.name);\r\n    }, [stateKey, plugin.name, !!plugin.useHook, hookData]);\r\n\r\n    const lastProcessedOptionsRef = useRef<any>();\r\n    const [isInitialTransform, setIsInitialTransform] = useState(true);\r\n\r\n    useEffect(() => {\r\n      if (plugin.transformState) {\r\n        if (!isDeepEqual(options, lastProcessedOptionsRef.current)) {\r\n          plugin.transformState({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            options,\r\n            hookData,\r\n            isInitialTransform,\r\n            ...deconstructed,\r\n            ...metadataContext,\r\n          });\r\n          lastProcessedOptionsRef.current = options;\r\n          setIsInitialTransform(false);\r\n        }\r\n      }\r\n    }, [\r\n      stateKey,\r\n      plugin,\r\n      options,\r\n      hookData,\r\n      isInitialTransform,\r\n      deconstructed,\r\n      metadataContext,\r\n    ]);\r\n\r\n    const hookDataRef = useRef(hookData);\r\n    hookDataRef.current = hookData;\r\n\r\n    useEffect(() => {\r\n      if (!plugin.onUpdate) return;\r\n\r\n      const handleUpdate = (update: UpdateTypeDetail) => {\r\n        if (update.stateKey === stateKey) {\r\n          // Create a new, SCOPED context for this specific path\r\n          const scopedMetadata = createScopedMetadataContext(\r\n            stateKey,\r\n            plugin.name,\r\n            update.path\r\n          );\r\n\r\n          plugin.onUpdate!({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            update,\r\n            path: update.path,\r\n            options,\r\n            hookData: hookDataRef.current,\r\n            ...deconstructed,\r\n            ...scopedMetadata, // <-- Use the new scoped context\r\n          });\r\n        }\r\n      };\r\n\r\n      const unsubscribe = pluginStore\r\n        .getState()\r\n        .subscribeToUpdates(handleUpdate);\r\n      return unsubscribe;\r\n    }, [stateKey, plugin, options, deconstructed]);\r\n\r\n    useEffect(() => {\r\n      if (!plugin.onFormUpdate) return;\r\n\r\n      const handleFormUpdate = (\r\n        event: ClientActivityEvent // Use the proper type\r\n      ) => {\r\n        if (event.stateKey === stateKey) {\r\n          // Create a new, SCOPED context for this specific path\r\n          const scopedMetadata = createScopedMetadataContext(\r\n            stateKey,\r\n            plugin.name,\r\n            event.path\r\n          );\r\n\r\n          plugin.onFormUpdate!({\r\n            stateKey,\r\n            pluginName: plugin.name,\r\n            path: event.path,\r\n            event: event,\r\n            options,\r\n            hookData: hookDataRef.current,\r\n            ...deconstructed,\r\n            ...scopedMetadata, // <-- Use the new scoped context\r\n          });\r\n        }\r\n      };\r\n\r\n      const unsubscribe = pluginStore\r\n        .getState()\r\n        .subscribeToFormUpdates(handleFormUpdate);\r\n      return unsubscribe;\r\n    }, [stateKey, plugin, options, deconstructed]);\r\n\r\n    return null;\r\n  }\r\n);\r\n/**\r\n * The main orchestrator component. It reads from the central pluginStore\r\n * and renders a `PluginInstance` controller for each active plugin.\r\n */\r\nexport function PluginRunner({ children }: { children: React.ReactNode }) {\r\n  // A simple way to force a re-render when the store changes.\r\n  const [, forceUpdate] = useReducer((c) => c + 1, 0);\r\n\r\n  // Subscribe to the store. When plugins or their options are added/removed,\r\n  // this component will re-render to update the list of PluginInstances.\r\n  useEffect(() => {\r\n    const unsubscribe = pluginStore.subscribe(forceUpdate);\r\n    return unsubscribe;\r\n  }, []);\r\n\r\n  const { pluginOptions, stateHandlers, registeredPlugins } =\r\n    pluginStore.getState();\r\n\r\n  return (\r\n    <>\r\n      {/*\r\n        This declarative mapping is the core of the solution.\r\n        React will now manage adding and removing `PluginInstance` components\r\n        as the application state changes, ensuring hooks are handled safely.\r\n      */}\r\n      {Array.from(pluginOptions.entries()).map(([stateKey, pluginMap]) => {\r\n        const stateHandler = stateHandlers.get(stateKey);\r\n        if (!stateHandler) {\r\n          return null; // Don't render a runner if the state handler isn't ready.\r\n        }\r\n\r\n        return Array.from(pluginMap.entries()).map(([pluginName, options]) => {\r\n          const plugin = registeredPlugins.find((p) => p.name === pluginName);\r\n          if (!plugin) {\r\n            return null; // Don't render if the plugin is not in the registered list.\r\n          }\r\n\r\n          // Render a dedicated, memoized controller for this specific plugin configuration.\r\n          return (\r\n            <PluginInstance\r\n              key={`${stateKey}:${pluginName}`}\r\n              stateKey={stateKey}\r\n              plugin={plugin}\r\n              options={options}\r\n              stateHandler={stateHandler}\r\n            />\r\n          );\r\n        });\r\n      })}\r\n\r\n      {children}\r\n    </>\r\n  );\r\n}\r\n"],"names":["setHookResult","removeHookResult","pluginStore","PluginInstance","React","stateKey","plugin","options","stateHandler","isInitialMount","setIsInitialMount","useState","metadataContext","useMemo","createMetadataContext","deconstructed","toDeconstructedMethods","hookContext","hookData","useEffect","lastProcessedOptionsRef","useRef","isInitialTransform","setIsInitialTransform","isDeepEqual","hookDataRef","handleUpdate","update","scopedMetadata","createScopedMetadataContext","handleFormUpdate","event","PluginRunner","children","forceUpdate","useReducer","c","pluginOptions","stateHandlers","registeredPlugins","jsxs","Fragment","pluginMap","pluginName","p","jsx"],"mappings":"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"}

package/dist/index.js

@@ -1,41 +1,42 @@
 import { $cogsSignal as r, addStateOptions as o, createCogsState as a, useCogsStateFn as n } from "./CogsState.jsx";
 import { CogsStateClient as d, config as g, useCogsConfig as i } from "./CogsStateClient.jsx";
-import { debounce as c, deepMerge as p, deleteNestedProperty as u, getArrayLengthDifferences as S, getArrayLengthDifferencesArray as l, getDifferences as m, getDifferencesArray as x, isArray as y, isDeepEqual as C, isFunction as h, isObject as D, transformStateFunc as A, updateNestedProperty as b } from "./utility.js";
-import { useCogsTrpcValidationLink as w } from "./TRPCValidationLink.js";
-import { buildShadowNode as L, generateId as M, getGlobalStore as N, shadowStateStore as k, updateShadowTypeInfo as I } from "./store.js";
-import { createMetadataContext as T, createPluginContext as j, keyedSchema as q, toDeconstructedMethods as E } from "./plugins.js";
-import { PluginRunner as R } from "./PluginRunner.jsx";
+import { debounce as f, deepMerge as p, deleteNestedProperty as u, getArrayLengthDifferences as S, getArrayLengthDifferencesArray as l, getDifferences as x, getDifferencesArray as C, isArray as m, isDeepEqual as y, isFunction as h, isObject as D, transformStateFunc as A, updateNestedProperty as b } from "./utility.js";
+import { useCogsTrpcValidationLink as P } from "./TRPCValidationLink.js";
+import { buildShadowNode as F, generateId as L, getGlobalStore as N, shadowStateStore as k, updateShadowTypeInfo as I } from "./store.js";
+import { createMetadataContext as T, createPluginContext as j, createScopedMetadataContext as q, keyedSchema as E, toDeconstructedMethods as G } from "./plugins.js";
+import { PluginRunner as V } from "./PluginRunner.jsx";
 export {
   r as $cogsSignal,
   d as CogsStateClient,
-  R as PluginRunner,
+  V as PluginRunner,
   o as addStateOptions,
-  L as buildShadowNode,
+  F as buildShadowNode,
   g as config,
   a as createCogsState,
   T as createMetadataContext,
   j as createPluginContext,
-  c as debounce,
+  q as createScopedMetadataContext,
+  f as debounce,
   p as deepMerge,
   u as deleteNestedProperty,
-  M as generateId,
+  L as generateId,
   S as getArrayLengthDifferences,
   l as getArrayLengthDifferencesArray,
-  m as getDifferences,
-  x as getDifferencesArray,
+  x as getDifferences,
+  C as getDifferencesArray,
   N as getGlobalStore,
-  y as isArray,
-  C as isDeepEqual,
+  m as isArray,
+  y as isDeepEqual,
   h as isFunction,
   D as isObject,
-  q as keyedSchema,
+  E as keyedSchema,
   k as shadowStateStore,
-  E as toDeconstructedMethods,
+  G as toDeconstructedMethods,
   A as transformStateFunc,
   b as updateNestedProperty,
   I as updateShadowTypeInfo,
   i as useCogsConfig,
   n as useCogsStateFn,
-  w as useCogsTrpcValidationLink
+  P as useCogsTrpcValidationLink
 };
 //# sourceMappingURL=index.js.map

package/dist/pluginStore.d.ts

@@ -1,6 +1,59 @@
 import { StateObject, UpdateTypeDetail } from './CogsState';
 import { CogsPlugin } from './plugins';
 
+export type ClientActivityEvent = {
+    stateKey: string;
+    path: string[];
+    timestamp: number;
+    duration?: number;
+} & ({
+    activityType: 'focus';
+    details: {
+        cursorPosition?: number;
+    };
+} | {
+    activityType: 'blur';
+    details: {
+        duration: number;
+    };
+} | {
+    activityType: 'input';
+    details: {
+        value: any;
+        inputLength?: number;
+        isComposing?: boolean;
+        isPasting?: boolean;
+        keystrokeCount?: number;
+    };
+} | {
+    activityType: 'select';
+    details: {
+        selectionStart: number;
+        selectionEnd: number;
+        selectedText?: string;
+    };
+} | {
+    activityType: 'hover_enter';
+    details: {
+        cursorPosition?: number;
+    };
+} | {
+    activityType: 'hover_exit';
+    details: {
+        duration: number;
+    };
+} | {
+    activityType: 'scroll';
+    details: {
+        scrollTop: number;
+        scrollLeft: number;
+    };
+} | {
+    activityType: 'cursor_move';
+    details: {
+        cursorPosition: number;
+    };
+});
 type PluginRegistryStore = {
     stateHandlers: Map<string, StateObject<any>>;
     registerStateHandler: (stateKey: string, handler: StateObject<any>) => void;
@@ -15,24 +68,9 @@ type PluginRegistryStore = {
     updateSubscribers: Set<(update: UpdateTypeDetail) => void>;
     subscribeToUpdates: (callback: (update: UpdateTypeDetail) => void) => () => void;
     notifyUpdate: (update: UpdateTypeDetail) => void;
-    formUpdateSubscribers: Set<(event: {
-        stateKey: string;
-        type: 'focus' | 'blur' | 'input';
-        path: string[];
-        value?: any;
-    }) => void>;
-    subscribeToFormUpdates: (callback: (event: {
-        stateKey: string;
-        type: 'focus' | 'blur' | 'input';
-        path: string[];
-        value?: any;
-    }) => void) => () => void;
-    notifyFormUpdate: (event: {
-        stateKey: string;
-        type: 'focus' | 'blur' | 'input';
-        path: string[];
-        value?: any;
-    }) => void;
+    formUpdateSubscribers: Set<(event: ClientActivityEvent) => void>;
+    subscribeToFormUpdates: (callback: (event: ClientActivityEvent) => void) => () => void;
+    notifyFormUpdate: (event: ClientActivityEvent) => void;
     hookResults: Map<string, Map<string, any>>;
     setHookResult: (stateKey: string, pluginName: string, data: any) => void;
     getHookResult: (stateKey: string, pluginName: string) => any | undefined;

package/dist/pluginStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pluginStore.d.ts","sourceRoot":"","sources":["../src/pluginStore.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pluginStore.d.ts","sourceRoot":"","sources":["../src/pluginStore.ts"],"names":[],"mappings":"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"}