schema

type AsyncValidator interface {
	// ValidateAsync validates the value asynchronously
	ValidateAsync(ctx context.Context, fieldID string, value any) error
	// Name returns the validator name for identification
	Name() string
}

type AsyncValidatorConfig struct {
	Type    string         `json:"type"`
	Params  map[string]any `json:"params,omitempty"`
	Message string         `json:"message,omitempty"`
}

type AsyncValidatorFunc struct {
	// contains filtered or unexported fields
}

type CachedAsyncValidator struct {
	// contains filtered or unexported fields
}

type Condition struct {
	// Field is the ID of the field to check
	Field string `json:"field"`
	// Operator is the comparison operator
	Operator ConditionOperator `json:"operator"`
	// Value is the target value for comparison
	Value any `json:"value,omitempty"`
	// Action specifies what happens when condition is met
	Action ConditionAction `json:"action"`
}

type ConditionAction string

type ConditionOperator string

type DynamicSettingsProvider interface {
	SettingsProvider
	// GetDynamicSections returns sections that may vary based on context
	GetDynamicSections(ctx context.Context, appID string) ([]*Section, error)
}

type Field struct {
	// ID is the unique identifier for this field within the section
	ID string `json:"id"`
	// Type is the field type
	Type FieldType `json:"type"`
	// Label is the display label for the field
	Label string `json:"label"`
	// Description provides additional context for the field
	Description string `json:"description,omitempty"`
	// Placeholder is the placeholder text for input fields
	Placeholder string `json:"placeholder,omitempty"`
	// DefaultValue is the initial value for the field
	DefaultValue any `json:"defaultValue,omitempty"`
	// Required indicates if the field is required
	Required bool `json:"required,omitempty"`
	// Disabled indicates if the field is disabled (read-only)
	Disabled bool `json:"disabled,omitempty"`
	// Hidden indicates if the field is hidden from view
	Hidden bool `json:"hidden,omitempty"`
	// ReadOnly indicates if the field is read-only but visible
	ReadOnly bool `json:"readOnly,omitempty"`
	// Validators are the synchronous validators for this field
	Validators []Validator `json:"-"`
	// ValidatorConfigs are serializable validator configurations
	ValidatorConfigs []ValidatorConfig `json:"validators,omitempty"`
	// AsyncValidators are async validators (uniqueness checks, etc.)
	AsyncValidators []AsyncValidator `json:"-"`
	// AsyncValidatorConfigs are serializable async validator configurations
	AsyncValidatorConfigs []AsyncValidatorConfig `json:"asyncValidators,omitempty"`
	// Options are the available options for select/multiselect fields
	Options []SelectOption `json:"options,omitempty"`
	// Conditions define conditional visibility/requirements
	Conditions []Condition `json:"conditions,omitempty"`
	// Metadata contains additional field-level configuration
	Metadata map[string]any `json:"metadata,omitempty"`
	// Order determines the display order within the section
	Order int `json:"order,omitempty"`
	// Width specifies the field width (e.g., "full", "half", "third")
	Width string `json:"width,omitempty"`
	// HelpText provides additional help information
	HelpText string `json:"helpText,omitempty"`
	// Prefix is an optional prefix for the input (e.g., "$", "https://")
	Prefix string `json:"prefix,omitempty"`
	// Suffix is an optional suffix for the input (e.g., "px", "%")
	Suffix string `json:"suffix,omitempty"`
	// Min is the minimum value for number/slider fields
	Min *float64 `json:"min,omitempty"`
	// Max is the maximum value for number/slider fields
	Max *float64 `json:"max,omitempty"`
	// Step is the step increment for number/slider fields
	Step *float64 `json:"step,omitempty"`
	// MinLength is the minimum string length
	MinLength *int `json:"minLength,omitempty"`
	// MaxLength is the maximum string length
	MaxLength *int `json:"maxLength,omitempty"`
	// Pattern is a regex pattern for validation
	Pattern string `json:"pattern,omitempty"`
	// PatternMessage is the error message for pattern validation failure
	PatternMessage string `json:"patternMessage,omitempty"`
}

type FieldBuilder struct {
	// contains filtered or unexported fields
}

type FieldType string

type Registry struct {
	// contains filtered or unexported fields
}

type RegistryStats struct {
	SectionCount  int `json:"sectionCount"`
	ProviderCount int `json:"providerCount"`
	FieldCount    int `json:"fieldCount"`
}

type RenderOption func(*renderOptions)

type Renderer struct {
	// contains filtered or unexported fields
}

type Schema struct {
	// ID is the unique identifier for this schema
	ID string `json:"id"`
	// Name is the display name of the schema
	Name string `json:"name"`
	// Description provides additional context about the schema
	Description string `json:"description,omitempty"`
	// Sections are the logical groupings of fields
	Sections []*Section `json:"sections"`
	// Version is the schema version for migration support
	Version int `json:"version"`
	// Metadata contains additional schema-level configuration
	Metadata map[string]any `json:"metadata,omitempty"`
}

type SchemaError struct {
	Type    string `json:"type"`
	Message string `json:"message"`
	Details string `json:"details,omitempty"`
}

type Section struct {
	// ID is the unique identifier for this section
	ID string `json:"id"`
	// Title is the display title for the section
	Title string `json:"title"`
	// Description provides additional context
	Description string `json:"description,omitempty"`
	// Icon is an optional icon identifier (e.g., lucide icon name)
	Icon string `json:"icon,omitempty"`
	// Order determines the display order
	Order int `json:"order,omitempty"`
	// Fields are the form fields in this section
	Fields []*Field `json:"fields"`
	// Collapsible indicates if the section can be collapsed
	Collapsible bool `json:"collapsible,omitempty"`
	// DefaultCollapsed indicates if the section is collapsed by default
	DefaultCollapsed bool `json:"defaultCollapsed,omitempty"`
	// Permissions are the permissions required to view/edit this section
	Permissions []string `json:"permissions,omitempty"`
	// Metadata contains additional section-level configuration
	Metadata map[string]any `json:"metadata,omitempty"`
	// ReadOnly indicates if the entire section is read-only
	ReadOnly bool `json:"readOnly,omitempty"`
	// HelpURL is an optional link to documentation
	HelpURL string `json:"helpUrl,omitempty"`
}

type SectionBuilder struct {
	// contains filtered or unexported fields
}

type SelectOption struct {
	// Value is the actual value stored
	Value any `json:"value"`
	// Label is the display text
	Label string `json:"label"`
	// Description is optional additional context
	Description string `json:"description,omitempty"`
	// Disabled indicates if this option is disabled
	Disabled bool `json:"disabled,omitempty"`
	// Icon is an optional icon identifier
	Icon string `json:"icon,omitempty"`
	// Group is used to group options in the dropdown
	Group string `json:"group,omitempty"`
}

type SettingsMigrator interface {
	// MigrateSettings migrates settings from one version to another
	MigrateSettings(ctx context.Context, appID string, data map[string]any, fromVersion, toVersion int) (map[string]any, error)
}

type SettingsProvider interface {
	// ProviderID returns the unique identifier for this provider
	ProviderID() string
	// GetSettingsSections returns the settings sections provided by this plugin
	GetSettingsSections() []*Section
	// GetSettingsSchema returns the complete schema (optional, can return nil)
	GetSettingsSchema() *Schema
}

type SettingsValidator interface {
	// ValidateSettings validates settings data for this provider
	ValidateSettings(ctx context.Context, appID string, sectionID string, data map[string]any) *ValidationResult
}

type UniqueCheckFunc func(ctx context.Context, value any) (bool, error)

type ValidationError struct {
	FieldID     string `json:"fieldId"`
	ValidatorID string `json:"validatorId"`
	Message     string `json:"message"`
}

type ValidationResult struct {
	Valid        bool                          `json:"valid"`
	FieldErrors  map[string][]*ValidationError `json:"fieldErrors,omitempty"`
	GlobalErrors []string                      `json:"globalErrors,omitempty"`
}

type Validator interface {
	// Validate validates the given value
	Validate(value any) error
	// Name returns the validator name for identification
	Name() string
}

type ValidatorConfig struct {
	Type    string         `json:"type"`
	Params  map[string]any `json:"params,omitempty"`
	Message string         `json:"message,omitempty"`
}

type ValidatorFunc struct {
	// contains filtered or unexported fields
}