mappings

type ActionMappingConfig struct {
	ID          string `yaml:"id"`
	Description string `yaml:"description"`
	Name        string `yaml:"name"`
	// Featured means that this action is implemented within one or few editors and is not portable
	Featured bool `yaml:"featured"`
	// FeaturedReason: Why this action is not common across editors, or recommand users to use another portable actioin of similar utility.
	FeaturedReason string                `yaml:"featuredReason"`
	Category       string                `yaml:"category"`
	VSCode         VscodeConfigs         `yaml:"vscode"`
	Windsurf       VscodeConfigs         `yaml:"windsurf"`
	Cursor         VscodeConfigs         `yaml:"cursor"`
	Zed            ZedConfigs            `yaml:"zed"`
	IntelliJ       IntelliJMappingConfig `yaml:"intellij"`
	Vim            VimMappingConfig      `yaml:"vim"`
	Helix          HelixConfig           `yaml:"helix"`
	Xcode          XcodeConfigs          `yaml:"xcode"`
	// Children is a list of child action IDs for UI hierarchical grouping only.
	// This field has no effect on export/import logic.
	Children []string `yaml:"children,omitempty"`
	// Fallbacks is a list of action IDs used for export fallback.
	// When this action is not supported by a target editor, the system will try each fallback in order.
	Fallbacks []string `yaml:"fallbacks,omitempty"`
}

type DuplicateActionMappingError struct {
	Editor string
	// editor action name -> all involved universal action ids
	Duplicates map[string][]string
}

type EditorActionMapping struct {
	// when true, this config is only used for export, otherwise it is used for both import and export
	DisableImport bool `yaml:"disableImport,omitempty"`

	// explicitly set to true if this config is not supported by the editor
	NotSupported bool `yaml:"notSupported,omitempty"`
	// reason why this config is not supported by the editor
	Note string `yaml:"note,omitempty"`
}

type HelixConfig []HelixMappingConfig

type HelixMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	Command string `yaml:"command"`
	Mode    string `yaml:"mode"`
}

type IntelliJMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	Action string `yaml:"action"`
}

type MappingConfig struct {
	// Mappings is a map where the key is the one_keymap_id (e.g., "actions.editor.copy")
	// and the value is the detailed mapping information for that action.
	Mappings map[string]ActionMappingConfig
}

type StringOrSlice struct {
	Items []string
}

type VimMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	Command string `yaml:"command"`
	Mode    string `yaml:"mode"`
}

type VscodeConfigs []VscodeMappingConfig

type VscodeMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	Command string                 `yaml:"command"`
	When    string                 `yaml:"when"`
	Args    map[string]interface{} `yaml:"args,omitempty"`
}

type XcodeConfigs []XcodeMappingConfig

type XcodeMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	// The Xcode text action name(s) for Text Key Bindings. Accepts a string or array in YAML.
	TextAction XcodeTextAction `yaml:",inline"`

	// The Xcode menu action name for Menu Key Bindings (e.g., "moveWordLeft:", "selectWord:")
	MenuAction XcodeMenuAction `yaml:",inline"`
}

type XcodeMenuAction struct {
	// The Xcode action name (e.g., "moveWordLeft:", "selectWord:")
	Action string `yaml:"action"`
	// The command group ID
	CommandGroupID string `yaml:"commandGroupID,omitempty"`
	// The Xcode command ID for menu bindings (optional)
	CommandID string `yaml:"commandID,omitempty"`
	// Whether this is an alternate key binding
	Alternate string `yaml:"alternate,omitempty"`
	// The menu group this action belongs to
	Group string `yaml:"group,omitempty"`
	// The menu group ID
	GroupID string `yaml:"groupID,omitempty"`
	// Whether this is a grouped alternate key binding
	GroupedAlternate string `yaml:"groupedAlternate,omitempty"`
	// Whether this is a navigation action
	Navigation string `yaml:"navigation,omitempty"`
	// The parent title for nested menu items
	ParentTitle string `yaml:"parentTitle,omitempty"`
	// The title of the action
	Title string `yaml:"title,omitempty"`
}

type XcodeTextAction struct {
	TextAction StringOrSlice `yaml:"textAction,omitempty"`
}

type ZedConfigs []ZedMappingConfig

type ZedMappingConfig struct {
	EditorActionMapping `yaml:",inline"`

	Action  string                 `yaml:"action"`
	Context string                 `yaml:"context"`
	Args    map[string]interface{} `yaml:"args,omitempty"`
}