From e530ee8fa6511b2b3b4db601dd02bfad91b2bb2d Mon Sep 17 00:00:00 2001
From: DrSmoothl <1787882683@qq.com>
Date: Tue, 17 Feb 2026 16:49:32 +0800
Subject: [PATCH] feat(dashboard): create FieldHookRegistry for dynamic form
 hooks

---
 dashboard/src/lib/field-hooks.ts | 99 ++++++++++++++++++++++++++++++++
 1 file changed, 99 insertions(+)
 create mode 100644 dashboard/src/lib/field-hooks.ts

diff --git a/dashboard/src/lib/field-hooks.ts b/dashboard/src/lib/field-hooks.ts
new file mode 100644
index 00000000..2be1b866
--- /dev/null
+++ b/dashboard/src/lib/field-hooks.ts
@@ -0,0 +1,99 @@
+import type { ReactNode } from 'react'
+
+/**
+ * Hook type for field-level customization
+ */
+export type FieldHookType = 'replace' | 'wrapper'
+
+/**
+ * Props passed to a FieldHookComponent
+ */
+export interface FieldHookComponentProps {
+  fieldPath: string
+  value: unknown
+  onChange?: (value: unknown) => void
+  children?: ReactNode
+}
+
+/**
+ * A React component that can be registered as a field hook
+ */
+export type FieldHookComponent = React.FC<FieldHookComponentProps>
+
+/**
+ * Registry entry for a field hook
+ */
+interface FieldHookEntry {
+  component: FieldHookComponent
+  type: FieldHookType
+}
+
+/**
+ * Registry for managing field-level hooks
+ * Supports two types of hooks:
+ * - replace: Completely replaces the default field renderer
+ * - wrapper: Wraps the default field renderer with additional functionality
+ */
+export class FieldHookRegistry {
+  private hooks: Map<string, FieldHookEntry> = new Map()
+
+  /**
+   * Register a hook for a specific field path
+   * @param fieldPath The field path (e.g., 'chat.talk_value')
+   * @param component The React component to register
+   * @param type The hook type ('replace' or 'wrapper')
+   */
+  register(
+    fieldPath: string,
+    component: FieldHookComponent,
+    type: FieldHookType = 'replace'
+  ): void {
+    this.hooks.set(fieldPath, { component, type })
+  }
+
+  /**
+   * Get a registered hook for a specific field path
+   * @param fieldPath The field path to look up
+   * @returns The hook entry if found, undefined otherwise
+   */
+  get(fieldPath: string): FieldHookEntry | undefined {
+    return this.hooks.get(fieldPath)
+  }
+
+  /**
+   * Check if a hook is registered for a specific field path
+   * @param fieldPath The field path to check
+   * @returns True if a hook is registered, false otherwise
+   */
+  has(fieldPath: string): boolean {
+    return this.hooks.has(fieldPath)
+  }
+
+  /**
+   * Unregister a hook for a specific field path
+   * @param fieldPath The field path to unregister
+   */
+  unregister(fieldPath: string): void {
+    this.hooks.delete(fieldPath)
+  }
+
+  /**
+   * Clear all registered hooks
+   */
+  clear(): void {
+    this.hooks.clear()
+  }
+
+  /**
+   * Get all registered field paths
+   * @returns Array of registered field paths
+   */
+  getAllPaths(): string[] {
+    return Array.from(this.hooks.keys())
+  }
+}
+
+/**
+ * Singleton instance of the field hook registry
+ */
+export const fieldHooks = new FieldHookRegistry()