extend

type ChannelKindMeta struct {
	Fields []SettingsField `json:"fields"`
	// SendTest reports the kind supports the Send test button.
	SendTest bool `json:"sendTest"`
	// Selectable is false for kinds created another way (browser push is
	// created by connecting a device, not picked in the drawer).
	Selectable bool `json:"selectable"`
	// Formats lists payload formats: "text", and "html" for email.
	Formats []string `json:"formats,omitempty"`
	// MaxLength caps the delivered message text, in runes (0 = no cap).
	MaxLength int `json:"maxLength,omitempty"`
}

type CollectionSourceMeta struct {
	Params []ParamField `json:"params,omitempty"`
	// Editor names the console widget family that edits this kind today:
	// none, tmdbChart, lookup, urlList, listSelect, discover, titles.
	// WS1f's served-schema renderer replaces this with Params alone.
	Editor string `json:"editor,omitempty"`
	// Defaults is the new-source template: the console creates a source as
	// {"kind": <id>, ...defaults}, then the owner fills required params.
	Defaults json.RawMessage `json:"defaults,omitempty"`
	// MediaTypes lists the collection media types this kind can feed.
	MediaTypes []string `json:"mediaTypes,omitempty"`
}

type CommandMeta struct {
	Route    string `json:"route,omitempty"`
	Action   string `json:"action,omitempty"`
	Keywords Text   `json:"keywords,omitempty"`
	// AgentSuggestion marks the command as an Ask Ether suggestion.
	AgentSuggestion bool `json:"agentSuggestion,omitempty"`
	// RoutePatterns limits an agent suggestion to console routes. A pattern
	// is an exact route or a prefix ending in "/*".
	RoutePatterns []string `json:"routePatterns,omitempty"`
}

type Descriptor struct {
	Kind  Kind   `json:"kind"`
	ID    string `json:"id"`
	Owner string `json:"owner"`
	Label Text   `json:"label"`
	Hint  Text   `json:"hint,omitempty"`
	// Icon is a lucide icon name for built-ins or an asset URL for plugins.
	Icon  string `json:"icon,omitempty"`
	Group string `json:"group,omitempty"`
	Order int    `json:"order,omitempty"`
	// Meta is kind-specific. Each kind's Go type lives in meta_<kind>.go and
	// is mirrored in web/src/lib/extend.ts.
	Meta json.RawMessage `json:"meta,omitempty"`
}

type DescriptorOption struct {
	Value string `json:"value"`
	Label Text   `json:"label,omitempty"`
}

type EventKindMeta struct {
	// Automatic reports Ether produces the event itself, as opposed to the
	// owner API only.
	Automatic bool `json:"automatic"`
	// Critical marks the events in the Critical alerts preset.
	Critical bool `json:"critical,omitempty"`
	// ChannelKinds, when set, restricts the event to these channel kinds
	// (the weekly newsletter goes by email only).
	ChannelKinds []string `json:"channelKinds,omitempty"`
}

type FieldOption struct {
	Value string `json:"value"`
	Label Text   `json:"label"`
}

type IntegrationMeta struct {
	// Category is the Integrations page group key: required,
	// watch-tracking, artwork-ratings, playback-extras or smart-features.
	Category string `json:"category"`
	// Logo names a built-in brand mark (for example "trakt") or an asset
	// URL for plugins.
	Logo string `json:"logo,omitempty"`
	// Adds are 1 to 4 short chips naming what the integration adds.
	Adds []Text `json:"adds,omitempty"`
	// Connect is the connect mode: fields, device_code, custom or none.
	Connect string `json:"connect,omitempty"`
	// Tab is the integrations sub-tab key this card configures on.
	Tab string `json:"tab,omitempty"`
	// ConfigKey is the config section key (built-ins only).
	ConfigKey string `json:"configKey,omitempty"`
	// Endpoint is the config section endpoint used to save (built-ins only).
	Endpoint string `json:"endpoint,omitempty"`
	// Test names the test behaviour the console runs (built-ins only); it is
	// a key into the console's compiled test map, like a page component.
	Test string `json:"test,omitempty"`
	// Flag is the boolean field the card switch writes.
	Flag string `json:"flag,omitempty"`
	// RequiredField must be non-empty before the integration can be
	// enabled; the switch opens the setup drawer instead.
	RequiredField string `json:"requiredField,omitempty"`
	// ReadyField is the field whose presence means "configured" for the
	// card status. It defaults to RequiredField.
	ReadyField string `json:"readyField,omitempty"`
	// PublicFallback means the integration works without ReadyField, at
	// public limits; the card says so instead of asking for a key.
	PublicFallback bool `json:"publicFallback,omitempty"`
	// Form names a compiled console form for built-ins whose settings are
	// not a plain schema form (for example "simkl" or "llm").
	Form string `json:"form,omitempty"`
	// Switches are the capability switches the card declares.
	Switches []IntegrationSwitch `json:"switches,omitempty"`
}

type IntegrationSwitch struct {
	Key   string `json:"key"`
	Label Text   `json:"label"`
	Hint  Text   `json:"hint,omitempty"`
}

type Kind string

type LiveTVSourceMeta struct {
	Params         []ParamField `json:"params,omitempty"`
	Editor         string       `json:"editor,omitempty"`
	YieldsChannels bool         `json:"yieldsChannels,omitempty"`
	YieldsGuide    bool         `json:"yieldsGuide,omitempty"`
	// Test reports whether the kind supports a connection test.
	Test bool `json:"test,omitempty"`
}

type NavItemMeta struct {
	Route  string `json:"route"`
	Page   string `json:"page,omitempty"`
	Mobile bool   `json:"mobile,omitempty"`
	Exact  bool   `json:"exact,omitempty"`
}

type PageMeta struct {
	// Route is the console path, for example "/releases". Plugin pages omit
	// it; their route is /p/<plugin>/<page>.
	Route string `json:"route,omitempty"`
	// NavGroup places the page in the sidebar when InNav is set, and places
	// a plugin page in its declared group.
	NavGroup string `json:"navGroup,omitempty"`
	// InNav marks a built-in page that belongs in the sidebar. Plugin pages
	// appear in the sidebar whenever they declare a nav group.
	InNav bool `json:"inNav,omitempty"`
	// Mobile keeps the page in the mobile tab bar.
	Mobile bool `json:"mobile,omitempty"`
	// Exact matches only the route itself in the sidebar.
	Exact bool `json:"exact,omitempty"`
	// Keywords are search aliases for the page itself.
	Keywords Text `json:"keywords,omitempty"`
	// Sections are the page's in-page sections in display order.
	Sections []PageSection `json:"sections,omitempty"`
}

type PageSection struct {
	Key string `json:"key"`
	// Label is declared with T for built-ins so the i18n extractor sees it.
	Label Text `json:"label"`
	// Keywords are search aliases, declared with T for built-ins. The
	// console applies its search-terms translation to the source string,
	// keeping the English terms beside the translated ones.
	Keywords Text `json:"keywords,omitempty"`
}

type ParamField struct {
	Name     string        `json:"name"`
	Kind     string        `json:"kind"`
	Label    Text          `json:"label"`
	Hint     Text          `json:"hint,omitempty"`
	Required bool          `json:"required,omitempty"`
	Options  []ParamOption `json:"options,omitempty"`
	// Lookup names a catalogue lookup ("person", "keyword", "collection",
	// "company", "network", "watchProvider") for id-valued fields.
	Lookup string `json:"lookup,omitempty"`
	// Placeholder is display-only example text (a URL shape).
	Placeholder string `json:"placeholder,omitempty"`
}

type ParamOption struct {
	Value string   `json:"value"`
	Label Text     `json:"label"`
	Media []string `json:"media,omitempty"`
}

type RankingEditorKind string

type RankingStepMeta struct {
	// Editor is the inline editor kind for this step's own setting.
	Editor RankingEditorKind `json:"editor"`
	// Options are the values the editor offers: the ordered choices for
	// ordered_list and choice editors, the selectable bounds for range.
	Options []DescriptorOption `json:"options,omitempty"`
	// Choices are optional selectable choices when a step distinguishes
	// choices from options.
	Choices []DescriptorOption `json:"choices,omitempty"`
	// Required steps must stay in every ladder (connection, verified).
	Required bool `json:"required,omitempty"`
	// CanMove is false for steps the ladder renders as Automatic: the owner
	// cannot reorder them.
	CanMove bool `json:"canMove"`
	// DefaultPosition is the step's 0-based place in the default ladder.
	// "Add a step" inserts a step ahead of the first ladder step with a
	// larger DefaultPosition. Plugin steps are never auto-inserted; this
	// only says where one lands when the owner adds it.
	DefaultPosition int `json:"defaultPosition"`
	// ConfigKey names the QualityProfile field the editor edits for
	// built-in steps (preferredLanguages, preferredSources,
	// preferredCodecs, preferredAudio, preferLargest, heightRange, hdr,
	// customFormatScores).
	// Plugin steps leave it empty; their settings arrive with WS9h.
	ConfigKey string `json:"configKey,omitempty"`
}

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

type Response struct {
	Version     uint64       `json:"version"`
	Descriptors []Descriptor `json:"descriptors"`
}

type RowSourceMeta struct {
	// HubID is the row pattern the Home Designer policy targets.
	HubID string `json:"hubId"`
	// RowKind is the personalization row kind, when the row is kind-backed.
	RowKind string `json:"rowKind,omitempty"`
	// Sections lists the pages this row can appear on (empty = every page).
	Sections []string `json:"sections,omitempty"`
	// Source is the row provenance (core.RowSource* for built-ins).
	Source string `json:"source,omitempty"`
	// CollectionSource links a list-backed row source to the collection
	// source kind that gathers its titles (WS3/WS9 list sources).
	CollectionSource string `json:"collectionSource,omitempty"`
}

type RuleFieldMeta struct {
	// ValueClass is one of the RuleValue* constants.
	ValueClass string `json:"valueClass"`
	// Operators are the comparisons the field accepts, in display order
	// (equals, contains, regex, range).
	Operators []string `json:"operators,omitempty"`
	// DefaultOperator is preselected when a condition is created or
	// retargeted to this field.
	DefaultOperator string `json:"defaultOperator,omitempty"`
	// Choices are suggested values for choice and language fields. Choice
	// fields still accept free text; language choices are ISO codes the
	// console labels through Intl.DisplayNames.
	Choices []DescriptorOption `json:"choices,omitempty"`
	// Unit is the value's unit for number fields ("GiB", "p").
	Unit string `json:"unit,omitempty"`
	// SingleValue fields can hold one value per release, so two required
	// rules demanding different values conflict.
	SingleValue bool `json:"singleValue,omitempty"`
	// Editor carries a plugin manifest's raw ruleConditions[].editor
	// (SPEC §5.1.3) when ValueClass was not set directly.
	Editor json.RawMessage `json:"editor,omitempty"`
}

type SettingsField struct {
	Key      string        `json:"key"`
	Kind     string        `json:"kind"`
	Label    Text          `json:"label"`
	Hint     Text          `json:"hint,omitempty"`
	Required bool          `json:"required,omitempty"`
	Secret   bool          `json:"secret,omitempty"`
	Default  string        `json:"default,omitempty"`
	Options  []FieldOption `json:"options,omitempty"`
	Wide     bool          `json:"wide,omitempty"`
}

type SettingsSchemaMeta struct {
	// ConfigKey is the config.json section a built-in form edits, when it
	// edits one. Plugin settings leave it empty.
	ConfigKey string          `json:"configKey,omitempty"`
	Schema    json.RawMessage `json:"schema"`
}

type Text struct {
	Source   string `json:"source,omitempty"`
	Plugin   string `json:"plugin,omitempty"`
	Key      string `json:"key,omitempty"`
	Resolved string `json:"resolved,omitempty"`
}

type TextResolver func(plugin, key, locale string) (string, bool)