@objectstack/spec 0.3.3 → 0.4.1

package/dist/ui/widget.zod.d.ts

@@ -1,4 +1,625 @@
 import { z } from 'zod';
+/**
+ * Widget Lifecycle Hooks Schema
+ *
+ * Defines lifecycle callbacks for custom widgets inspired by Web Components and React.
+ * These hooks allow widgets to perform initialization, cleanup, and respond to changes.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_components
+ * @see https://react.dev/reference/react/Component#component-lifecycle
+ *
+ * @example
+ * ```typescript
+ * const widget = {
+ *   lifecycle: {
+ *     onMount: "console.log('Widget mounted')",
+ *     onUpdate: "if (prevProps.value !== props.value) { updateUI() }",
+ *     onUnmount: "cleanup()",
+ *     onValidate: "return value.length > 0 ? null : 'Required field'"
+ *   }
+ * }
+ * ```
+ */
+export declare const WidgetLifecycleSchema: z.ZodObject<{
+    /**
+     * Called when widget is mounted/rendered for the first time
+     * Use for initialization, setting up event listeners, loading data, etc.
+     *
+     * @example "initializeDatePicker(); loadOptions();"
+     */
+    onMount: z.ZodOptional<z.ZodString>;
+    /**
+     * Called when widget props change
+     * Receives previous props for comparison
+     *
+     * @example "if (prevProps.value !== props.value) { updateDisplay() }"
+     */
+    onUpdate: z.ZodOptional<z.ZodString>;
+    /**
+     * Called when widget is about to be removed from DOM
+     * Use for cleanup, removing event listeners, canceling timers, etc.
+     *
+     * @example "destroyDatePicker(); cancelPendingRequests();"
+     */
+    onUnmount: z.ZodOptional<z.ZodString>;
+    /**
+     * Custom validation logic for this widget
+     * Should return error message string if invalid, null/undefined if valid
+     *
+     * @example "return value && value.length >= 10 ? null : 'Minimum 10 characters'"
+     */
+    onValidate: z.ZodOptional<z.ZodString>;
+    /**
+     * Called when widget receives focus
+     *
+     * @example "highlightField(); logFocusEvent();"
+     */
+    onFocus: z.ZodOptional<z.ZodString>;
+    /**
+     * Called when widget loses focus
+     *
+     * @example "validateField(); saveFieldState();"
+     */
+    onBlur: z.ZodOptional<z.ZodString>;
+    /**
+     * Called on any error in the widget
+     *
+     * @example "logError(error); showErrorNotification();"
+     */
+    onError: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    onError?: string | undefined;
+    onMount?: string | undefined;
+    onUpdate?: string | undefined;
+    onUnmount?: string | undefined;
+    onValidate?: string | undefined;
+    onFocus?: string | undefined;
+    onBlur?: string | undefined;
+}, {
+    onError?: string | undefined;
+    onMount?: string | undefined;
+    onUpdate?: string | undefined;
+    onUnmount?: string | undefined;
+    onValidate?: string | undefined;
+    onFocus?: string | undefined;
+    onBlur?: string | undefined;
+}>;
+export type WidgetLifecycle = z.infer<typeof WidgetLifecycleSchema>;
+/**
+ * Widget Event Schema
+ *
+ * Defines custom events that widgets can emit, inspired by DOM Events and Lightning Web Components.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/Events/Creating_and_triggering_events
+ * @see https://developer.salesforce.com/docs/component-library/documentation/en/lwc/lwc.events
+ *
+ * @example
+ * ```typescript
+ * const searchEvent = {
+ *   name: 'search',
+ *   bubbles: true,
+ *   cancelable: false,
+ *   payload: {
+ *     query: 'string',
+ *     filters: 'object'
+ *   }
+ * }
+ * ```
+ */
+export declare const WidgetEventSchema: z.ZodObject<{
+    /**
+     * Event name
+     * Should be lowercase, dash-separated for consistency
+     *
+     * @example "value-change", "item-selected", "search-complete"
+     */
+    name: z.ZodString;
+    /**
+     * Event label for documentation
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Event description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Whether event bubbles up through the DOM hierarchy
+     *
+     * @default false
+     */
+    bubbles: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Whether event can be cancelled
+     *
+     * @default false
+     */
+    cancelable: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Event payload schema
+     * Defines the data structure sent with the event
+     *
+     * @example { userId: 'string', timestamp: 'number' }
+     */
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    bubbles: boolean;
+    cancelable: boolean;
+    label?: string | undefined;
+    description?: string | undefined;
+    payload?: Record<string, any> | undefined;
+}, {
+    name: string;
+    label?: string | undefined;
+    description?: string | undefined;
+    bubbles?: boolean | undefined;
+    cancelable?: boolean | undefined;
+    payload?: Record<string, any> | undefined;
+}>;
+export type WidgetEvent = z.infer<typeof WidgetEventSchema>;
+/**
+ * Widget Property Definition Schema
+ *
+ * Defines the contract for widget configuration properties.
+ * Inspired by React PropTypes and Web Component attributes.
+ *
+ * @see https://react.dev/reference/react/Component#static-proptypes
+ * @see https://developer.mozilla.org/en-US/docs/Web/API/Web_components/Using_custom_elements
+ *
+ * @example
+ * ```typescript
+ * const widgetProps = {
+ *   maxLength: {
+ *     type: 'number',
+ *     required: false,
+ *     default: 100,
+ *     description: 'Maximum input length'
+ *   }
+ * }
+ * ```
+ */
+export declare const WidgetPropertySchema: z.ZodObject<{
+    /**
+     * Property name
+     * Should be camelCase following ObjectStack conventions
+     */
+    name: z.ZodString;
+    /**
+     * Property label for UI
+     */
+    label: z.ZodOptional<z.ZodString>;
+    /**
+     * Property data type
+     *
+     * @example "string", "number", "boolean", "array", "object", "function"
+     */
+    type: z.ZodEnum<["string", "number", "boolean", "array", "object", "function", "any"]>;
+    /**
+     * Whether property is required
+     *
+     * @default false
+     */
+    required: z.ZodDefault<z.ZodBoolean>;
+    /**
+     * Default value for the property
+     */
+    default: z.ZodOptional<z.ZodAny>;
+    /**
+     * Property description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Property validation schema
+     * Can include min/max, regex, enum values, etc.
+     */
+    validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    /**
+     * Property category for grouping in UI
+     */
+    category: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+    required: boolean;
+    name: string;
+    validation?: Record<string, any> | undefined;
+    label?: string | undefined;
+    default?: any;
+    description?: string | undefined;
+    category?: string | undefined;
+}, {
+    type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+    name: string;
+    validation?: Record<string, any> | undefined;
+    required?: boolean | undefined;
+    label?: string | undefined;
+    default?: any;
+    description?: string | undefined;
+    category?: string | undefined;
+}>;
+export type WidgetProperty = z.infer<typeof WidgetPropertySchema>;
+/**
+ * Widget Manifest Schema
+ *
+ * Complete definition for a custom widget including metadata, lifecycle, events, and props.
+ * This is used for widget registration and discovery.
+ *
+ * @example
+ * ```typescript
+ * const customWidget = {
+ *   name: 'custom_date_picker',
+ *   label: 'Custom Date Picker',
+ *   version: '1.0.0',
+ *   author: 'Company Name',
+ *   fieldTypes: ['date', 'datetime'],
+ *   lifecycle: { ... },
+ *   events: [ ... ],
+ *   properties: [ ... ]
+ * }
+ * ```
+ */
+export declare const WidgetManifestSchema: z.ZodObject<{
+    /**
+     * Widget identifier (snake_case)
+     */
+    name: z.ZodString;
+    /**
+     * Human-readable widget name
+     */
+    label: z.ZodString;
+    /**
+     * Widget description
+     */
+    description: z.ZodOptional<z.ZodString>;
+    /**
+     * Widget version (semver)
+     */
+    version: z.ZodOptional<z.ZodString>;
+    /**
+     * Widget author/organization
+     */
+    author: z.ZodOptional<z.ZodString>;
+    /**
+     * Icon name or URL
+     */
+    icon: z.ZodOptional<z.ZodString>;
+    /**
+     * Field types this widget supports
+     *
+     * @example ["text", "email", "url"]
+     */
+    fieldTypes: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Widget category for organization
+     */
+    category: z.ZodDefault<z.ZodEnum<["input", "display", "picker", "editor", "custom"]>>;
+    /**
+     * Widget lifecycle hooks
+     */
+    lifecycle: z.ZodOptional<z.ZodObject<{
+        /**
+         * Called when widget is mounted/rendered for the first time
+         * Use for initialization, setting up event listeners, loading data, etc.
+         *
+         * @example "initializeDatePicker(); loadOptions();"
+         */
+        onMount: z.ZodOptional<z.ZodString>;
+        /**
+         * Called when widget props change
+         * Receives previous props for comparison
+         *
+         * @example "if (prevProps.value !== props.value) { updateDisplay() }"
+         */
+        onUpdate: z.ZodOptional<z.ZodString>;
+        /**
+         * Called when widget is about to be removed from DOM
+         * Use for cleanup, removing event listeners, canceling timers, etc.
+         *
+         * @example "destroyDatePicker(); cancelPendingRequests();"
+         */
+        onUnmount: z.ZodOptional<z.ZodString>;
+        /**
+         * Custom validation logic for this widget
+         * Should return error message string if invalid, null/undefined if valid
+         *
+         * @example "return value && value.length >= 10 ? null : 'Minimum 10 characters'"
+         */
+        onValidate: z.ZodOptional<z.ZodString>;
+        /**
+         * Called when widget receives focus
+         *
+         * @example "highlightField(); logFocusEvent();"
+         */
+        onFocus: z.ZodOptional<z.ZodString>;
+        /**
+         * Called when widget loses focus
+         *
+         * @example "validateField(); saveFieldState();"
+         */
+        onBlur: z.ZodOptional<z.ZodString>;
+        /**
+         * Called on any error in the widget
+         *
+         * @example "logError(error); showErrorNotification();"
+         */
+        onError: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        onError?: string | undefined;
+        onMount?: string | undefined;
+        onUpdate?: string | undefined;
+        onUnmount?: string | undefined;
+        onValidate?: string | undefined;
+        onFocus?: string | undefined;
+        onBlur?: string | undefined;
+    }, {
+        onError?: string | undefined;
+        onMount?: string | undefined;
+        onUpdate?: string | undefined;
+        onUnmount?: string | undefined;
+        onValidate?: string | undefined;
+        onFocus?: string | undefined;
+        onBlur?: string | undefined;
+    }>>;
+    /**
+     * Custom events this widget emits
+     */
+    events: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Event name
+         * Should be lowercase, dash-separated for consistency
+         *
+         * @example "value-change", "item-selected", "search-complete"
+         */
+        name: z.ZodString;
+        /**
+         * Event label for documentation
+         */
+        label: z.ZodOptional<z.ZodString>;
+        /**
+         * Event description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Whether event bubbles up through the DOM hierarchy
+         *
+         * @default false
+         */
+        bubbles: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Whether event can be cancelled
+         *
+         * @default false
+         */
+        cancelable: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Event payload schema
+         * Defines the data structure sent with the event
+         *
+         * @example { userId: 'string', timestamp: 'number' }
+         */
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        bubbles: boolean;
+        cancelable: boolean;
+        label?: string | undefined;
+        description?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    }, {
+        name: string;
+        label?: string | undefined;
+        description?: string | undefined;
+        bubbles?: boolean | undefined;
+        cancelable?: boolean | undefined;
+        payload?: Record<string, any> | undefined;
+    }>, "many">>;
+    /**
+     * Widget configuration properties
+     */
+    properties: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        /**
+         * Property name
+         * Should be camelCase following ObjectStack conventions
+         */
+        name: z.ZodString;
+        /**
+         * Property label for UI
+         */
+        label: z.ZodOptional<z.ZodString>;
+        /**
+         * Property data type
+         *
+         * @example "string", "number", "boolean", "array", "object", "function"
+         */
+        type: z.ZodEnum<["string", "number", "boolean", "array", "object", "function", "any"]>;
+        /**
+         * Whether property is required
+         *
+         * @default false
+         */
+        required: z.ZodDefault<z.ZodBoolean>;
+        /**
+         * Default value for the property
+         */
+        default: z.ZodOptional<z.ZodAny>;
+        /**
+         * Property description
+         */
+        description: z.ZodOptional<z.ZodString>;
+        /**
+         * Property validation schema
+         * Can include min/max, regex, enum values, etc.
+         */
+        validation: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        /**
+         * Property category for grouping in UI
+         */
+        category: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+        required: boolean;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        label?: string | undefined;
+        default?: any;
+        description?: string | undefined;
+        category?: string | undefined;
+    }, {
+        type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+        name: string;
+        validation?: Record<string, any> | undefined;
+        required?: boolean | undefined;
+        label?: string | undefined;
+        default?: any;
+        description?: string | undefined;
+        category?: string | undefined;
+    }>, "many">>;
+    /**
+     * Widget implementation
+     * URL to component or inline code
+     */
+    implementation: z.ZodOptional<z.ZodObject<{
+        type: z.ZodEnum<["url", "inline", "module"]>;
+        source: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "url" | "inline" | "module";
+        source: string;
+    }, {
+        type: "url" | "inline" | "module";
+        source: string;
+    }>>;
+    /**
+     * Widget dependencies
+     * External libraries or scripts needed
+     */
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodOptional<z.ZodString>;
+        url: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+        url?: string | undefined;
+        version?: string | undefined;
+    }, {
+        name: string;
+        url?: string | undefined;
+        version?: string | undefined;
+    }>, "many">>;
+    /**
+     * Widget screenshots for showcase
+     */
+    screenshots: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * Widget documentation URL
+     */
+    documentation: z.ZodOptional<z.ZodString>;
+    /**
+     * License information
+     */
+    license: z.ZodOptional<z.ZodString>;
+    /**
+     * Tags for discovery
+     */
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    label: string;
+    name: string;
+    category: "custom" | "input" | "display" | "picker" | "editor";
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    events?: {
+        name: string;
+        bubbles: boolean;
+        cancelable: boolean;
+        label?: string | undefined;
+        description?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    }[] | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    properties?: {
+        type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+        required: boolean;
+        name: string;
+        validation?: Record<string, any> | undefined;
+        label?: string | undefined;
+        default?: any;
+        description?: string | undefined;
+        category?: string | undefined;
+    }[] | undefined;
+    author?: string | undefined;
+    fieldTypes?: string[] | undefined;
+    lifecycle?: {
+        onError?: string | undefined;
+        onMount?: string | undefined;
+        onUpdate?: string | undefined;
+        onUnmount?: string | undefined;
+        onValidate?: string | undefined;
+        onFocus?: string | undefined;
+        onBlur?: string | undefined;
+    } | undefined;
+    implementation?: {
+        type: "url" | "inline" | "module";
+        source: string;
+    } | undefined;
+    dependencies?: {
+        name: string;
+        url?: string | undefined;
+        version?: string | undefined;
+    }[] | undefined;
+    screenshots?: string[] | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
+}, {
+    label: string;
+    name: string;
+    tags?: string[] | undefined;
+    description?: string | undefined;
+    events?: {
+        name: string;
+        label?: string | undefined;
+        description?: string | undefined;
+        bubbles?: boolean | undefined;
+        cancelable?: boolean | undefined;
+        payload?: Record<string, any> | undefined;
+    }[] | undefined;
+    icon?: string | undefined;
+    version?: string | undefined;
+    properties?: {
+        type: "string" | "number" | "boolean" | "object" | "function" | "array" | "any";
+        name: string;
+        validation?: Record<string, any> | undefined;
+        required?: boolean | undefined;
+        label?: string | undefined;
+        default?: any;
+        description?: string | undefined;
+        category?: string | undefined;
+    }[] | undefined;
+    category?: "custom" | "input" | "display" | "picker" | "editor" | undefined;
+    author?: string | undefined;
+    fieldTypes?: string[] | undefined;
+    lifecycle?: {
+        onError?: string | undefined;
+        onMount?: string | undefined;
+        onUpdate?: string | undefined;
+        onUnmount?: string | undefined;
+        onValidate?: string | undefined;
+        onFocus?: string | undefined;
+        onBlur?: string | undefined;
+    } | undefined;
+    implementation?: {
+        type: "url" | "inline" | "module";
+        source: string;
+    } | undefined;
+    dependencies?: {
+        name: string;
+        url?: string | undefined;
+        version?: string | undefined;
+    }[] | undefined;
+    screenshots?: string[] | undefined;
+    documentation?: string | undefined;
+    license?: string | undefined;
+}>;
+export type WidgetManifest = z.infer<typeof WidgetManifestSchema>;
 /**
  * Field Widget Props Schema
  *
@@ -48,7 +669,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
     field: z.ZodObject<{
         name: z.ZodOptional<z.ZodString>;
         label: z.ZodOptional<z.ZodString>;
-        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "select", "lookup", "master_detail", "image", "file", "avatar", "formula", "summary", "autonumber", "location", "geolocation", "address", "code", "color", "rating", "slider", "signature", "qrcode"]>;
+        type: z.ZodEnum<["text", "textarea", "email", "url", "phone", "password", "markdown", "html", "richtext", "number", "currency", "percent", "date", "datetime", "time", "boolean", "toggle", "select", "multiselect", "radio", "checkboxes", "lookup", "master_detail", "tree", "image", "file", "avatar", "video", "audio", "formula", "summary", "autonumber", "location", "address", "code", "json", "color", "rating", "slider", "signature", "qrcode", "progress", "tags", "vector"]>;
         description: z.ZodOptional<z.ZodString>;
         format: z.ZodOptional<z.ZodString>;
         required: z.ZodDefault<z.ZodBoolean>;
@@ -128,13 +749,32 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
             currencyMode?: "dynamic" | "fixed" | undefined;
             defaultCurrency?: string | undefined;
         }>>;
+        vectorConfig: z.ZodOptional<z.ZodObject<{
+            dimensions: z.ZodNumber;
+            distanceMetric: z.ZodDefault<z.ZodEnum<["cosine", "euclidean", "dotProduct", "manhattan"]>>;
+            normalized: z.ZodDefault<z.ZodBoolean>;
+            indexed: z.ZodDefault<z.ZodBoolean>;
+            indexType: z.ZodOptional<z.ZodEnum<["hnsw", "ivfflat", "flat"]>>;
+        }, "strip", z.ZodTypeAny, {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        }, {
+            dimensions: number;
+            distanceMetric?: "cosine" | "euclidean" | "dotProduct" | "manhattan" | undefined;
+            normalized?: boolean | undefined;
+            indexed?: boolean | undefined;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        }>>;
         hidden: z.ZodDefault<z.ZodBoolean>;
         readonly: z.ZodDefault<z.ZodBoolean>;
         encryption: z.ZodDefault<z.ZodBoolean>;
         index: z.ZodDefault<z.ZodBoolean>;
         externalId: z.ZodDefault<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         searchable: boolean;
         multiple: boolean;
@@ -195,8 +835,15 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
             currencyMode: "dynamic" | "fixed";
             defaultCurrency: string;
         } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
     }, {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         options?: {
             value: string;
             label: string;
@@ -252,6 +899,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
             currencyMode?: "dynamic" | "fixed" | undefined;
             defaultCurrency?: string | undefined;
         } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric?: "cosine" | "euclidean" | "dotProduct" | "manhattan" | undefined;
+            normalized?: boolean | undefined;
+            indexed?: boolean | undefined;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
         hidden?: boolean | undefined;
         readonly?: boolean | undefined;
         encryption?: boolean | undefined;
@@ -271,7 +925,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     required: boolean;
     field: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         required: boolean;
         searchable: boolean;
         multiple: boolean;
@@ -332,6 +986,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
             currencyMode: "dynamic" | "fixed";
             defaultCurrency: string;
         } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric: "cosine" | "euclidean" | "dotProduct" | "manhattan";
+            normalized: boolean;
+            indexed: boolean;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
     };
     readonly: boolean;
     onChange: (args_0: any, ...args: unknown[]) => void;
@@ -341,7 +1002,7 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
     record?: Record<string, any> | undefined;
 }, {
     field: {
-        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "select" | "lookup" | "master_detail" | "image" | "file" | "avatar" | "formula" | "summary" | "autonumber" | "location" | "geolocation" | "address" | "color" | "rating" | "slider" | "signature" | "qrcode";
+        type: "number" | "boolean" | "code" | "date" | "text" | "textarea" | "email" | "url" | "phone" | "password" | "markdown" | "html" | "richtext" | "currency" | "percent" | "datetime" | "time" | "toggle" | "select" | "multiselect" | "radio" | "checkboxes" | "lookup" | "master_detail" | "tree" | "image" | "file" | "avatar" | "video" | "audio" | "formula" | "summary" | "autonumber" | "location" | "address" | "json" | "color" | "rating" | "slider" | "signature" | "qrcode" | "progress" | "tags" | "vector";
         options?: {
             value: string;
             label: string;
@@ -397,6 +1058,13 @@ export declare const FieldWidgetPropsSchema: z.ZodObject<{
             currencyMode?: "dynamic" | "fixed" | undefined;
             defaultCurrency?: string | undefined;
         } | undefined;
+        vectorConfig?: {
+            dimensions: number;
+            distanceMetric?: "cosine" | "euclidean" | "dotProduct" | "manhattan" | undefined;
+            normalized?: boolean | undefined;
+            indexed?: boolean | undefined;
+            indexType?: "flat" | "hnsw" | "ivfflat" | undefined;
+        } | undefined;
         hidden?: boolean | undefined;
         readonly?: boolean | undefined;
         encryption?: boolean | undefined;