types

type BlocksConfig struct {
	Before []string `yaml:"before" mapstructure:"before"`
	After  []string `yaml:"after" mapstructure:"after"`
}

type Config struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Modules         []string          `yaml:"module" mapstructure:"module"`
	GlobalSettings  GlobalSettings    `yaml:"global" mapstructure:"global"`
	FileDefinitions []*FileDefinition `yaml:"file" mapstructure:"file"`
	FormatStyles    []*FormatStyle    `yaml:"format,flow" mapstructure:"format,flow"`
	Layers          []*Layer          `yaml:"layer" mapstructure:"layer"`
	ManagementLayer ManagementLayer   `yaml:"mgmt_layer" mapstructure:"mgmt_layer"`
	ParameterRules  []*ParameterRule  `yaml:"param_rule,flow" mapstructure:"param_rule,flow"`

	NetworkClasses    []*NetworkClass    `yaml:"networkclass,flow" mapstructure:"network,flow"`
	NodeClasses       []*NodeClass       `yaml:"nodeclass,flow" mapstructure:"nodes,flow"`
	InterfaceClasses  []*InterfaceClass  `yaml:"interfaceclass,flow" mapstructure:"interfaces,flow"`
	ConnectionClasses []*ConnectionClass `yaml:"connectionclass,flow" mapstructure:"connections,flow"`
	GroupClasses      []*GroupClass      `yaml:"groupclass,flow" mapstructure:"group,flow"`
	SegmentClasses    []*SegmentClass    `yaml:"segmentclass,flow" mapstructure:"segments,flow"`

	LoadedModules              []Module           // reference to loaded modules, internal
	SorterConfigTemplateGroups mapset.Set[string] // list of sort-style config template groups
	// contains filtered or unexported fields
}

type ConfigTemplate struct {
	// Config block aggregation styles
	// hierarchy (default): specify child config templates in the template description as parameter
	// sort: merge child config templates of SortTarget groups into the "sort" config templates
	Style     string `yaml:"style" mapstructure:"style"`
	SortGroup string `yaml:"sort_group" mapstructure:"sort_group"`
	// Target file definition name
	// Config templates with file will generate a file of generated text
	File string `yaml:"file" mapstructure:"file"`
	// Name is used by parent objects to specify as childs in templates
	// Config templates with name will form a parameter that can be embeded in other hierarchy templates
	Name string `yaml:"name" mapstructure:"name"`
	// Group is used for sort config templates
	// A sort config template will aggregate all config blocks generated in child (or grandchild) objects of the same group
	Group string `yaml:"group" mapstructure:"group"`
	// Priority is used to reorder config templates in sort style
	// Config blocks with smaller priority should be on the top of generated config files
	// Default is 0, so users should specify negative values to make a config block top of a file
	Priority int `yaml:"priority" mapstructure:"priority"`
	// Used for hierarchy config templates
	// Config template names on same object that need to be embeded
	// Required for ordering config template generation considering the dependency
	Depends []string `yaml:"depends" mapstructure:"depends"`
	// Blocks configuration for flexible config block merging
	Blocks BlocksConfig `yaml:"blocks" mapstructure:"blocks"`

	// Format specifications
	// NamespaceFormat: format applied when registering config blocks to namespace
	NamespaceFormat  string   `yaml:"namespace_format" mapstructure:"namespace_format"`
	NamespaceFormats []string `yaml:"namespace_formats" mapstructure:"namespace_formats"`
	// AssemblyFormat: format applied when assembling config blocks (Sort, blocks)
	AssemblyFormat  string   `yaml:"assembly_format" mapstructure:"assembly_format"`
	AssemblyFormats []string `yaml:"assembly_formats" mapstructure:"assembly_formats"`

	// Condition related fields
	// add config only for interfaces of nodes belongs to the nodeclass(es)
	// this option is valid only on InterfaceClass, ConnectionClass, and their NeighborClass
	NodeClass   string   `yaml:"node" mapstructure:"node"`
	NodeClasses []string `yaml:"nodes" mapstructure:"nodes"`
	// add config only if the neighbor node belongs to the nodeclass(es)
	// this option is valid only on NeighborClass
	NeighborNodeClass   string   `yaml:"neighbor_node" mapstructure:"neighbor_node"`
	NeighborNodeClasses []string `yaml:"neighbor_nodes" mapstructure:"neighbor_nodes"`
	// put empty file or namespace if conditions are not satisfied
	Empty bool `yaml:"empty" mapstructure:"empty"`
	// RequiredParams specifies parameters that must exist for this template to generate output
	// If any of the specified parameters are missing, the entire block is skipped
	RequiredParams []string `yaml:"required_params,flow" mapstructure:"required_params,flow"`

	// This option is valid only on InterfaceClass or ConnectionClass
	// If specified, add config only for included output (e.g., tinet only, clab only, etc)
	Platform []string `yaml:"platform,flow" mapstructure:"platform,flow"`
	// Style is used to iterpret the given config format. Style can be different on one file. As-is in default.
	//Style string `yaml:"style" mapstructure:"style"`
	Format  string   `yaml:"format" mapstructure:"format"`
	Formats []string `yaml:"formats" mapstructure:"formats"`
	// Priority is a value to be used for sorting config blocks. 0 in default.
	// Priority int `yaml:"priority" mapstructure:"priority"`
	// Load config template
	Template []string `yaml:"template" mapstructure:"template"`
	// Load config template from external file
	SourceFile string `yaml:"sourcefile" mapstructure:"sourcefile"`

	ParsedTemplate *template.Template
	// contains filtered or unexported fields
}

type Connection struct {
	Name   string
	Src    *Interface
	Dst    *Interface
	Layers mapset.Set[string]

	*ParsedLabels
	*NameSpace
	// contains filtered or unexported fields
}

type ConnectionClass struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Virtual         bool              `yaml:"virtual" mapstructure:"virtual"`
	IPPolicy        []string          `yaml:"policy,flow" mapstructure:"policy,flow"`
	Layers          []string          `yaml:"layers,flow" mapstructure:"layers,flow"` // Connection is limited to specified layers
	Parameters      []string          `yaml:"params,flow" mapstructure:"params,flow"` // Parameter policies
	Values          map[string]string `yaml:"values" mapstructure:"values"`
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
	MemberClasses   []*MemberClass    `yaml:"classmembers,flow" mapstructure:"classmembers,flow"`

	// Connection naming
	Prefix string `yaml:"prefix" mapstructure:"prefix"` // prefix of connection auto-naming

	LabelOwnerClass
}

type FileDefinition struct {
	// Name is used as the filename of generated file.
	// If empty and NamePrefix/NameSuffix are specified, filename is generated as:
	//   {NamePrefix}{object_name}{NameSuffix}
	Name string `yaml:"name" mapstructure:"name"`
	// NamePrefix is prepended to the object name when Name is empty.
	NamePrefix string `yaml:"name_prefix" mapstructure:"name_prefix"`
	// NameSuffix is appended to the object name when Name is empty.
	NameSuffix string `yaml:"name_suffix" mapstructure:"name_suffix"`
	// Path is the path that the generated file is placed on the node.
	// If empty, the file is generated but not placed on the node.
	Path string `yaml:"path" mapstructure:"path"`
	// Format is used to determine the way to format lines in generated config text.
	Format  string   `yaml:"format" mapstructure:"format"`
	Formats []string `yaml:"formats,flow" mapstructure:"formats,flow"`
	// Scope specifies the scope of file creation.
	// Available values:
	//   - "network": File is created at network level (root directory)
	//   - "node": File is created for each node (node_name/file_name)
	//   - "" (empty): Defaults to "node" scope for backward compatibility
	// Examples:
	//   - Scope = "network": Creates "spec.yaml", "topo.yaml" at root
	//   - Scope = "node" or "": Creates "r1/frr.conf", "r2/frr.conf", etc.
	Scope string `yaml:"scope" mapstructure:"scope"`
	// Output specifies where the file is placed in the output directory.
	// Available values:
	//   - "root": File is placed at root directory
	//   - "node": File is placed in node subdirectory (node_name/file_name)
	//   - "" (empty): Defaults based on Scope (network->root, node->node)
	// This is useful for Kathara-style startup files that need to be at root
	// but are generated per-node (e.g., r1.startup, r2.startup).
	Output string `yaml:"output" mapstructure:"output"`
}

type FileGenerator interface {
	// FilesToGenerate returns a list of file names that this object will generate based on its classes.
	FilesToGenerate(cfg *Config) []string
}

type FormatStyle struct {
	Name string `yaml:"name" mapstructure:"name"`

	// Format Phase (block生成時の装飾)
	FormatLinePrefix    string `yaml:"format_lineprefix" mapstructure:"format_lineprefix"`
	FormatLineSuffix    string `yaml:"format_linesuffix" mapstructure:"format_linesuffix"`
	FormatLineSeparator string `yaml:"format_lineseparator" mapstructure:"format_lineseparator"`
	FormatBlockPrefix   string `yaml:"format_blockprefix" mapstructure:"format_blockprefix"`
	FormatBlockSuffix   string `yaml:"format_blocksuffix" mapstructure:"format_blocksuffix"`

	// Merge Phase (block結合時の処理)
	MergeBlockSeparator string `yaml:"merge_blockseparator" mapstructure:"merge_blockseparator"`
	MergeResultPrefix   string `yaml:"merge_resultprefix" mapstructure:"merge_resultprefix"`
	MergeResultSuffix   string `yaml:"merge_resultsuffix" mapstructure:"merge_resultsuffix"`
}

type GlobalSettings struct {
	PathSpecification string `yaml:"path" mapstructure:"path"`
	MountSourcePath   string `yaml:"mountsourcepath" mapstructure:"mountsourcepath"`
	NodeAutoRename    bool   `yaml:"nodeautoname" mapstructure:"nodeautoname"`
}

type Group struct {
	Name  string
	Nodes []*Node

	*NameSpace
	*ParsedLabels
	// contains filtered or unexported fields
}

type GroupClass struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Virtual         bool              `yaml:"virtual" mapstructure:"virtual"`
	Parameters      []string          `yaml:"params,flow" mapstructure:"params,flow"` // Parameter policies
	Values          map[string]string `yaml:"values" mapstructure:"values"`
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`

	LabelOwnerClass
}

type IPPolicy struct {
	Name string `yaml:"name" mapstructure:"name"`
	// type: ip (deafult), loopback, mgmt
	Type                string `yaml:"type" mapstructure:"type"`
	AddrRange           string `yaml:"range" mapstructure:"range"`
	DefaultPrefixLength int    `yaml:"prefix" mapstructure:"prefix"`
	// contains filtered or unexported fields
}

type Interface struct {
	Name       string
	Node       *Node
	Virtual    bool
	Connection *Connection
	Opposite   *Interface
	Neighbors  map[string][]*Neighbor
	NamePrefix string

	*NameSpace
	*ParsedLabels
	// contains filtered or unexported fields
}

type InterfaceClass struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Virtual         bool              `yaml:"virtual" mapstructure:"virtual"`
	IPPolicy        []string          `yaml:"policy,flow" mapstructure:"policy,flow"`
	Layers          []string          `yaml:"layers,flow" mapstructure:"layers,flow"` // Interface connection is limited to specified layers
	Parameters      []string          `yaml:"params,flow" mapstructure:"params,flow"` // Parameter policies
	Values          map[string]string `yaml:"values" mapstructure:"values"`
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
	NeighborClasses []*NeighborClass  `yaml:"neighbors,flow" mapstructure:"neighbors,flow"`
	MemberClasses   []*MemberClass    `yaml:"classmembers,flow" mapstructure:"classmembers,flow"`

	Prefix string `yaml:"prefix" mapstructure:"prefix"` // prefix of auto-naming

	LabelOwnerClass
}

type LabelOwner interface {
	ClassLabels() []string
	RelationalClassLabels() []RelationalClassLabel
	PlaceLabels() []string
	ValueLabels() map[string]string
	MetaValueLabels() map[string]string
	SetLabels(cfg *Config, labels []string, moduleLabels []string) error
	AddClassLabels(labels ...string)

	HasClass(string) bool
	GetClasses() []ObjectClass

	SetVirtual(bool)
	IsVirtual() bool

	ClassDefinition(cfg *Config, cls string) (interface{}, error)

	ObjectInstance
}

type LabelOwnerClass interface {
	GetGivenValues() map[string]string
}

type Layer struct {
	Name string `yaml:"name" mapstructure:"name"`
	// If default_connect is true, ConnectionClasses without ipspaces field are considered as connected on this Layer
	DefaultConnect bool        `yaml:"default_connect" mapstructure:"default_connect"`
	Policies       []*IPPolicy `yaml:"policy" mapstructure:"policy"`

	Layerer

	IPPolicy       []*IPPolicy
	LoopbackPolicy []*IPPolicy
}

type Layerer interface {
	IPAddressReplacer() string
	IPNetworkReplacer() string
	IPPrefixLengthReplacer() string
}

type ManagementLayer struct {
	Name      string `yaml:"name" mapstructure:"name"`
	AddrRange string `yaml:"range" mapstructure:"range"`
	// gateway is used only for management network or external network
	// the address is avoided in automated IPaddress assignment
	ExternalGateway string `yaml:"gateway" mapstructure:"gateway"`
	InterfaceName   string `yaml:"interface_name" mapstructure:"mgmt_name"`

	Layerer
}

type Member struct {
	ClassName string
	ClassType string
	Referrer  MemberReferrer
	Member    NameSpacer

	*NameSpace
}

type MemberClass struct {
	NodeClass         string            `yaml:"node" mapstructure:"node"`
	NodeClasses       []string          `yaml:"nodes" mapstructure:"nodes"`
	InterfaceClass    string            `yaml:"interface" mapstructure:"interface"`
	InterfaceClasses  []string          `yaml:"interfaces" mapstructure:"interfaces"`
	ConnectionClass   string            `yaml:"connection" mapstructure:"connection"`
	ConnectionClasses []string          `yaml:"connections" mapstructure:"connections"`
	IncludeSelf       bool              `yaml:"include_self" mapstructure:"include_self"`
	ConfigTemplates   []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
}

type MemberReferrer interface {
	LabelOwner
	NameSpacer
	ObjectInstance

	AddMemberClass(*MemberClass)
	GetMemberClasses() []*MemberClass
	AddMember(*Member)
	GetMembers() []*Member
}

type Module interface {
	UpdateConfig(cfg *Config) error
	AddModuleNodeClassLabel(label string)
	GetModuleNodeClassLabels() []string
	AddModuleInterfaceClassLabel(label string)
	GetModuleInterfaceClassLabels() []string
	AddModuleConnectionClassLabel(label string)
	GetModuleConnectionClassLabels() []string
	//SetClasses(cfg *Config, nm *NetworkModel) error
	GenerateParameters(cfg *Config, nm *NetworkModel) error
	CheckModuleRequirements(cfg *Config, nm *NetworkModel) error
}

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

type NameSpacer interface {
	// Methods to trace top-down network model
	ChildClasses() ([]string, error)
	Childs(c string) ([]NameSpacer, error)
	// Methods for dependency graph processing
	DependClasses() ([]string, error)
	Depends(c string) ([]NameSpacer, error)

	IterateFlaggedParams() <-chan string
	AddParam(k, v string)
	HasParam(k string) bool

	// BuildRelativeNameSpace() error
	BuildRelativeNameSpace(globalParams map[string]map[string]string) error
	SetRelativeParam(k, v string)
	HasRelativeParam(k string) bool
	SetRelativeParams(map[string]string)
	GetParams() map[string]string
	GetRelativeParams() map[string]string
	GetParamValue(string) (string, error)

	GetConfigTemplates(cfg *Config) []*ConfigTemplate
	GetPossibleConfigTemplates(cfg *Config) []*ConfigTemplate

	ObjectInstance
	// contains filtered or unexported methods
}

type Neighbor struct {
	Self            *Interface
	Neighbor        *Interface
	Layer           string
	NeighborClasses []*NeighborClass

	*NameSpace
}

type NeighborClass struct {
	Layer           string            `yaml:"layer" mapstructure:"layer"`
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
}

type NetworkClass struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Values          map[string]string `yaml:"values" mapstructure:"values"`
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`

	LabelOwnerClass
}

type NetworkModel struct {
	Name        string
	Nodes       []*Node
	Connections []*Connection
	Groups      []*Group
	Classes     []*NetworkClass

	*NameSpace

	NetworkSegments map[string][]*NetworkSegment
	// contains filtered or unexported fields
}

type NetworkSegment struct {
	Name        string // Auto-assigned name
	Layer       string
	Interfaces  []*Interface
	Connections []*Connection
	NamePrefix  string // Prefix for auto-naming

	*NameSpace
	*ParsedLabels
	// contains filtered or unexported fields
}

type Node struct {
	Name       string
	Interfaces []*Interface
	Groups     []*Group

	*NameSpace
	*ParsedLabels

	NamePrefix string
	// contains filtered or unexported fields
}

type NodeClass struct {
	// A virtual node have parameters, but no object nor configuration. It is considered only on parameter assignment.
	Name              string            `yaml:"name" mapstructure:"name"`
	Virtual           bool              `yaml:"virtual" mapstructure:"virtual"`
	IPPolicy          []string          `yaml:"policy,flow" mapstructure:"policy,flow"`
	Parameters        []string          `yaml:"params,flow" mapstructure:"params,flow"` // Parameter policies
	Values            map[string]string `yaml:"values" mapstructure:"values"`
	InterfaceIPPolicy []string          `yaml:"interface_policy,flow" mapstructure:"interface_policy,flow"`
	ConfigTemplates   []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
	MemberClasses     []*MemberClass    `yaml:"classmembers,flow" mapstructure:"classmembers,flow"`

	Prefix        string `yaml:"prefix" mapstructure:"prefix"`                           // prefix of auto-naming
	MgmtInterface string `yaml:"mgmt_interfaceclass" mapstructure:"mgmt_interfaceclass"` // InterfaceClass name for mgmt

	LabelOwnerClass
}

type ObjectClass interface{}

type ObjectInstance interface {
	StringForMessage() string // just for debug messages
}

type ParameterGenerator interface {
	// GenerateValueParameters generates a list of parameter sets for creating Values
	// generatorName: the generator name after the module prefix (e.g., "filemounts" for "clab.filemounts")
	// target: the target object (Node, Interface, etc.)
	// cfg: the configuration
	// nm: the network model
	// Returns: a list of parameter maps, one per Value to be created
	GenerateValueParameters(
		generatorName string,
		target ValueOwner,
		cfg *Config,
		nm *NetworkModel,
	) ([]map[string]string, error)
}

type ParameterRule struct {
	Name string `yaml:"name" mapstructure:"name"`
	// Mode: "distribute" (default) or "attach"
	// distribute: N objects get 1 parameter each (legacy behavior)
	// attach: 1 object gets N Values attached
	Mode string `yaml:"mode" mapstructure:"mode"`
	// object (in default) or segment
	Assign string `yaml:"assign" mapstructure:"assign"`
	// layer is used only when the assign option is "segment"
	Layer string `yaml:"layer" mapstructure:"layer"`
	// integer (in default) or file
	Type string `yaml:"type" mapstructure:"type"`
	// for type integer
	Max    int    `yaml:"max" mapstructure:"max"`
	Min    int    `yaml:"min" mapstructure:"min"`
	Header string `yaml:"header" mapstructure:"header"`
	Footer string `yaml:"footer" mapstructure:"footer"`
	// for type file
	SourceFile string `yaml:"sourcefile" mapstructure:"soucefile"`

	// === attach mode fields ===
	// Source defines how to generate Value list (for attach mode)
	Source *ParameterRuleSource `yaml:"source" mapstructure:"source"`
	// Generator specifies a module-provided generator (e.g., "clab.bindmounts")
	Generator string `yaml:"generator" mapstructure:"generator"`
	// ParamFormat defines how to format source values into Value parameters
	ParamFormat map[string]string `yaml:"param_format" mapstructure:"param_format"`
	// ConfigTemplates defines config blocks for Values
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
	// Sort specifies ordering: "asc", "desc", or empty (preserve generation order)
	Sort string `yaml:"sort" mapstructure:"sort"`
}

type ParameterRuleSource struct {
	// Type specifies the source type: range, sequence, list, file
	Type string `yaml:"type" mapstructure:"type"`
	// Start is used for range type
	Start int `yaml:"start" mapstructure:"start"`
	// End is used for range type
	End int `yaml:"end" mapstructure:"end"`
	// Values is used for list type (inline values)
	Values []map[string]interface{} `yaml:"values" mapstructure:"values"`
	// File is used for file type
	File string `yaml:"file" mapstructure:"file"`
	// Format specifies the file format: yaml, json, csv, text (default: auto-detect from extension)
	Format string `yaml:"format" mapstructure:"format"`
}

type ParsedLabels struct {
	Classes []ObjectClass
	// contains filtered or unexported fields
}

type RelationalClassLabel struct {
	ClassType string
	Name      string
}

type SegmentClass struct {
	Name            string            `yaml:"name" mapstructure:"name"`
	Layer           string            `yaml:"layer" mapstructure:"layer"`
	Parameters      []string          `yaml:"params,flow" mapstructure:"params,flow"` // Parameter policies
	ConfigTemplates []*ConfigTemplate `yaml:"config,flow" mapstructure:"config,flow"`
	Prefix          string            `yaml:"prefix" mapstructure:"prefix"` // prefix of segment auto-naming
}

type StandardModule struct {
	NodeClassLabels       []string
	InterfaceClassLabels  []string
	ConnectionClassLabels []string
}

type Value struct {
	// ParamRuleName is the name of the param_rule that generated this Value
	ParamRuleName string
	// Owner is the parent object that owns this Value
	Owner ValueOwner
	// Index is the position in the Value list (0, 1, 2, ...)
	Index int

	*NameSpace
}

type ValueOwner interface {
	NameSpacer

	// SortKey returns a string key for deterministic sorting of objects.
	// Used to ensure stable parameter assignment order regardless of map iteration order.
	SortKey() string
	// AddValue adds a Value to this owner
	AddValue(v *Value)
	// GetValues returns all Values attached to this owner
	GetValues() []*Value
	// GetValuesByParamRule returns Values generated by the specified param_rule
	GetValuesByParamRule(paramRuleName string) []*Value
}