setting

type Attribute struct {
	ID          string
	Title, Desc web.LocaleStringer
	Multiple    bool // 多行文本
	Candidate   []Candidate
}

type Candidate struct {
	Value       any
	Title, Desc web.LocaleStringer // 值的字面文本以及详细说明，desc 可以为空。
}

type CandidateResponse struct {
	Value any    `json:"value" xml:"value"`
	Title string `json:"title" xml:"title"`
	Desc  string `json:"desc,omitempty" xml:"desc,omitempty"`
}

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

type GroupRequest struct {
	XMLName struct{}       `json:"-" xml:"group"`
	ID      string         `json:"id,omitempty" xml:"id,attr,omitempty"`
	Items   []*ItemRequest `json:"items" xml:"item"`
	// contains filtered or unexported fields
}

type GroupResponse struct {
	XMLName struct{}        `json:"-" xml:"group"`
	ID      string          `json:"id" xml:"id,attr"`
	Title   string          `json:"title" xml:"title"`
	Desc    string          `json:"desc" xml:"desc"`
	Items   []*ItemResponse `json:"items,omitempty" xml:"item,omitempty"`
}

type ItemRequest struct {
	ID       string   `json:"id" xml:"id,attr"`
	Value    any      `json:"value" xml:"-"`
	XMLValue []string `json:"-" xml:"value"` // XML 无法解析到 any 类型
}

type ItemResponse struct {
	ID       string `json:"id" xml:"id,attr"`
	Title    string `json:"title" xml:"title"`
	Desc     string `json:"desc" xml:"desc"`
	Value    any    `json:"value" xml:"value"`
	Type     string `json:"type,omitempty" xml:"type,attr,omitempty"`
	Multiple bool   `json:"multiple,omitempty" xml:"multiple,attr,omitempty"`
	Slice    bool   `json:"slice,omitempty" xml:"slice,attr,omitempty"`

	Candidate []*CandidateResponse `json:"candidate,omitempty" xml:"candidate,omitempty"`
}

type Request struct {
	XMLName struct{}        `json:"-" xml:"setting"`
	Groups  []*GroupRequest `json:"groups,omitempty" xml:"group,omitempty"`
	// contains filtered or unexported fields
}

type Response struct {
	XMLName struct{}         `json:"-" xml:"settings"`
	Groups  []*GroupResponse `json:"groups,omitempty" xml:"groups,omitempty"`
}

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

type Store interface {
	// Update 将当前内容写入到存储对象
	Update(string, any) error

	// Insert 将内容第一次写入至存储对象
	Insert(string, any) error

	// Load 从存储对象加载数据至对象
	Load(string, any) error

	// Exists 是否存在提定 ID 的设置项
	Exists(string) (bool, error)
}