@tempots/beatui 0.72.0 → 0.74.0

package/dist/types/components/json-schema/index.d.ts

@@ -4,4 +4,4 @@ export * from './controls';
 export * from './json-schema-form';
 export * from './validator';
 export * from './schema-defaults';
-export { type CustomWidgets, type CustomWidgetRegistration, type WidgetFactory, forXUI, forFormat, forTypeAndFormat, } from './widgets/widget-customization';
+export { type CustomWidgets, type CustomWidgetRegistration, type WidgetFactory, forXUI, forFormat, forTypeAndFormat, createDiagnosticWidget, } from './widgets/widget-customization';

package/dist/types/components/json-schema/widgets/widget-customization.d.ts

@@ -173,3 +173,40 @@ export declare function forFormat<T = unknown>(format: string, factory: WidgetFa
  * ```
  */
 export declare function forTypeAndFormat<T = unknown>(type: string, format: string, factory: WidgetFactory<T>, options?: Partial<Omit<CustomWidgetRegistration<T>, 'factory' | 'matcher'>>): CustomWidgetRegistration<T>;
+/**
+ * Create a diagnostic custom widget registration for debugging custom widget matching.
+ *
+ * This utility helps diagnose issues where custom widgets aren't being matched as expected.
+ * It logs detailed information about each property that's being processed, including:
+ * - Property name and path
+ * - Schema type
+ * - Whether the widgetRegistry is available
+ * - Custom matcher results
+ *
+ * @example
+ * ```typescript
+ * const customWidgets = [
+ *   // Add the diagnostic widget first to trace all properties
+ *   createDiagnosticWidget({
+ *     logPrefix: 'CUSTOM_WIDGET_DEBUG',
+ *     filterFn: (ctx) => true, // Log all properties
+ *   }),
+ *   // Then add your actual custom widgets
+ *   myCustomWidget,
+ * ]
+ * ```
+ */
+export declare function createDiagnosticWidget<T = unknown>(options?: {
+    /** Prefix for log messages (default: 'WIDGET_DIAG') */
+    logPrefix?: string;
+    /** Filter function to control which properties are logged */
+    filterFn?: (ctx: SchemaContext) => boolean;
+    /** Callback function called for each processed property */
+    onProcess?: (info: {
+        name: string | undefined;
+        path: string[];
+        type: string | undefined;
+        hasRegistry: boolean;
+        definition: unknown;
+    }) => void;
+}): CustomWidgetRegistration<T>;