docmodel

const (
	// CapabilityKeyCompletion suggests field/key names (e.g., spec field names).
	// These are typically disabled for JSONC because editors handle JSON property completion.
	CapabilityKeyCompletion CompletionCapability = iota

	// CapabilityValueCompletion suggests values for a field (e.g., types, operators, references).
	// These work for both YAML and JSONC formats.
	CapabilityValueCompletion
)

const (
	CompletionContextUnknown CompletionContextKind = iota

	// Type fields
	CompletionContextResourceType
	CompletionContextDataSourceType
	CompletionContextVariableType
	CompletionContextValueType
	CompletionContextExportType
	CompletionContextDataSourceFieldType

	// Data source filter fields
	CompletionContextDataSourceFilterField
	CompletionContextDataSourceFilterOperator

	// Data source nested field contexts
	CompletionContextDataSourceFilterDefinitionField // Fields inside a filter definition (field, operator, search)
	CompletionContextDataSourceExportDefinitionField // Fields inside an export definition (type, aliasFor, description)
	CompletionContextDataSourceMetadataField         // Fields inside data source metadata (displayName, annotations, custom)

	// Data source export value contexts (aliasFor references data source fields)
	CompletionContextDataSourceExportAliasForValue // aliasFor: value field referencing data source spec fields
	CompletionContextDataSourceExportName          // Export name key (suggests data source spec fields)

	// Resource spec field (editing directly in YAML/JSONC definition)
	CompletionContextResourceSpecField
	// Resource spec field value (editing a value for a field with AllowedValues)
	CompletionContextResourceSpecFieldValue

	// Top-level blueprint fields with enum values
	CompletionContextVersionField   // version: field with known spec versions
	CompletionContextTransformField // transform: field with available transforms

	// Custom variable type options (default value for custom type variables)
	CompletionContextCustomVariableTypeValue

	// Resource metadata field (displayName, labels, annotations, custom)
	CompletionContextResourceMetadataField

	// Resource annotation key (inside metadata.annotations, suggests link annotation keys)
	CompletionContextResourceAnnotationKey

	// Resource annotation value (value for a resource annotation with AllowedValues)
	CompletionContextResourceAnnotationValue

	// Resource definition field (type, description, spec, metadata, etc.)
	CompletionContextResourceDefinitionField

	// Resource linkSelector field (byLabel, exclude)
	CompletionContextLinkSelectorField

	// Resource linkSelector exclude value (resource names)
	CompletionContextLinkSelectorExcludeValue

	// Definition field contexts for other sections
	CompletionContextVariableDefinitionField
	CompletionContextValueDefinitionField
	CompletionContextDataSourceDefinitionField
	CompletionContextIncludeDefinitionField
	CompletionContextExportDefinitionField
	CompletionContextBlueprintTopLevelField

	// Substitution references
	CompletionContextStringSub // Inside ${...} but no specific reference
	CompletionContextStringSubVariableRef
	CompletionContextStringSubResourceRef
	CompletionContextStringSubResourceProperty
	CompletionContextStringSubDataSourceRef
	CompletionContextStringSubDataSourceProperty
	CompletionContextStringSubValueRef
	CompletionContextStringSubChildRef
	CompletionContextStringSubElemRef
	CompletionContextStringSubChildProperty         // After children.{name}., suggest child exports
	CompletionContextStringSubValueProperty         // After values.{name}., suggest value fields/indices
	CompletionContextStringSubPartialPath           // Typing a partial path (no completions)
	CompletionContextStringSubPotentialResourceProp // Potential standalone resource property (needs blueprint validation)

	// Data source annotation contexts
	CompletionContextDataSourceAnnotationKey   // Inside data source metadata.annotations, suggest annotation keys
	CompletionContextDataSourceAnnotationValue // Value for a data source annotation

	// Resource label key context
	CompletionContextResourceLabelKey // Inside metadata.labels, suggest label keys from linked resources

	// Export field reference contexts (field property in blueprint exports)
	CompletionContextExportFieldTopLevel           // Empty field value, suggest namespaces
	CompletionContextExportFieldResourceRef        // After "resources.", suggest resource names
	CompletionContextExportFieldResourceProperty   // After "resources.{name}.", suggest spec/metadata/fields
	CompletionContextExportFieldVariableRef        // After "variables.", suggest variable names
	CompletionContextExportFieldValueRef           // After "values.", suggest value names
	CompletionContextExportFieldValueProperty      // After "values.{name}.", suggest value fields/indices
	CompletionContextExportFieldChildRef           // After "children.", suggest child names
	CompletionContextExportFieldChildProperty      // After "children.{name}.", suggest exports
	CompletionContextExportFieldDataSourceRef      // After "datasources.", suggest data source names
	CompletionContextExportFieldDataSourceProperty // After "datasources.{name}.", suggest exports
)

const (
	FormatYAML DocumentFormat = iota
	FormatJSONC
)

const (
	StatusValid         DocumentStatus = iota // Document parses and validates successfully
	StatusParsingErrors                       // Has parse errors but some features work
	StatusDegraded                            // Using stale data from last valid parse
	StatusUnavailable                         // No AST available
)

const (
	NodeKindDocument NodeKind = iota
	NodeKindMapping
	NodeKindSequence
	NodeKindScalar
	NodeKindKey
	NodeKindError // Marks invalid/error regions from tree-sitter
)

const (
	PathSegmentField PathSegmentKind = iota
	PathSegmentIndex
)

const (
	// QuoteTypeNone indicates no quotes or unknown quote type.
	QuoteTypeNone QuoteType = iota

	// QuoteTypeSingle indicates single quotes ('value').
	QuoteTypeSingle

	// QuoteTypeDouble indicates double quotes ("value").
	QuoteTypeDouble
)

const (
	SchemaElementUnknown SchemaElementKind = iota

	// Top-level sections
	SchemaElementVariables
	SchemaElementValues
	SchemaElementResources
	SchemaElementDataSources
	SchemaElementIncludes
	SchemaElementExports

	// Named elements
	SchemaElementVariable
	SchemaElementValue
	SchemaElementResource
	SchemaElementDataSource
	SchemaElementInclude
	SchemaElementExport

	// Field types
	SchemaElementResourceType
	SchemaElementDataSourceType
	SchemaElementVariableType
	SchemaElementValueType
	SchemaElementExportType
	SchemaElementDataSourceFieldType
	SchemaElementDataSourceFilterField
	SchemaElementDataSourceFilterOperator

	// Substitution elements
	SchemaElementSubstitution
	SchemaElementFunctionCall
	SchemaElementVariableRef
	SchemaElementValueRef
	SchemaElementResourceRef
	SchemaElementDataSourceRef
	SchemaElementChildRef
	SchemaElementElemRef
	SchemaElementElemIndexRef
	SchemaElementPathItem

	// Structural elements
	SchemaElementMappingNode
	SchemaElementDataSourceFieldExport
	SchemaElementDataSourceFieldExportMap
	SchemaElementDataSourceFilters
	SchemaElementDataSourceFilter
	SchemaElementDataSourceFilterSearch
	SchemaElementMetadata
	SchemaElementDataSourceMetadata
	SchemaElementLinkSelector
	SchemaElementStringMap
	SchemaElementStringOrSubstitutionsMap
	SchemaElementStringList

	// Value nodes
	SchemaElementScalar
	SchemaElementMapping
	SchemaElementSequence
)

const (
	// SyntacticPositionUnknown indicates the position could not be determined.
	SyntacticPositionUnknown SyntacticPosition = iota

	// SyntacticPositionKeyField indicates the cursor is at a position where
	// a mapping key (field name) should be entered.
	// Examples:
	//   YAML block: "  |" (indented empty line under a mapping)
	//   YAML flow:  "{|" or "{key: value, |"
	//   JSONC:      "{|" or '{"key": "value", |'
	SyntacticPositionKeyField

	// SyntacticPositionValueField indicates the cursor is at a position where
	// a value should be entered (after a colon).
	// Examples:
	//   YAML block: "key: |"
	//   YAML flow:  "{key: |"
	//   JSONC:      '{"key": |'
	SyntacticPositionValueField

	// SyntacticPositionSequenceItem indicates the cursor is at a position where
	// a sequence/array item should be entered.
	// Examples:
	//   YAML block: "- |" (after sequence marker)
	//   YAML flow:  "[|" or "[item, |"
	//   JSONC:      "[|" or '["item", |'
	SyntacticPositionSequenceItem

	// SyntacticPositionStringContent indicates the cursor is inside a string value.
	// This is relevant for substitution completions and array item completions.
	// Examples:
	//   YAML: '"${resources.|}"'
	//   JSONC: '["partial|"]'
	SyntacticPositionStringContent

	// SyntacticPositionEmptyContainer indicates the cursor is inside an empty
	// container (array or object) with no content yet.
	// Examples:
	//   YAML flow: "[]" with cursor between brackets
	//   JSONC:     "[]" or "{}" with cursor between brackets
	SyntacticPositionEmptyContainer
)

const (
	// SyntacticStyleUnknown indicates the style could not be determined.
	SyntacticStyleUnknown SyntacticStyle = iota

	// SyntacticStyleBlockYAML indicates indentation-based YAML syntax.
	// Structure is determined by indentation levels and markers like "- ".
	// Examples:
	//   resources:
	//     myResource:
	//       type: aws/lambda/function
	SyntacticStyleBlockYAML

	// SyntacticStyleFlowYAML indicates inline/flow-style YAML syntax.
	// Structure is determined by delimiters: {}, [], commas.
	// Examples:
	//   resources: {myResource: {type: "aws/lambda/function"}}
	//   exclude: [item1, item2]
	SyntacticStyleFlowYAML

	// SyntacticStyleJSONC indicates JSON or JSONC syntax.
	// Like flow YAML, structure is determined by delimiters.
	// Examples:
	//   {"resources": {"myResource": {"type": "aws/lambda/function"}}}
	SyntacticStyleJSONC
)