Function ParseImportDirective

pkg/parser/import_directive.go:28–72

ParseImportDirective parses an import directive and returns its components

(line string)

// ParseImportDirective parses an import directive and returns its components
func ParseImportDirective(line string) *ImportDirectiveMatch {
	trimmedLine := strings.TrimSpace(line)

	// Fast-path: import directives must start with '@' or '{'; skip the regex for all other lines.
	if trimmedLine == "" || (trimmedLine[0] != '@' && trimmedLine[0] != '{') {
		return nil
	}

	// Check if it matches the import pattern at all
	matches := IncludeDirectivePattern.FindStringSubmatch(trimmedLine)
	if matches == nil {
		return nil
	}

	// All matched forms are now deprecated/legacy.
	// Group 2 non-empty → @-style (@include/@import), Group 4 non-empty → {{#import}} style.
	// Both are legacy; the distinction is kept for message formatting.
	atStyleLegacy := matches[2] != ""
	isLegacy := true // every form matched by IncludeDirectivePattern is deprecated
	importDirectiveLog.Printf("Parsing import directive: legacy=%t, atStyle=%t, line=%s", isLegacy, atStyleLegacy, trimmedLine)

	var isOptional bool
	var path string

	if atStyleLegacy {
		// @-style legacy syntax: @include? path or @import? path
		// Group 1: optional marker, Group 2: path
		isOptional = matches[1] == "?"
		path = strings.TrimSpace(matches[2])
	} else {
		// {{#import}} deprecated syntax: {{#import?: path}} or {{#import: path}} (colon is optional)
		// Group 3: optional marker, Group 4: path
		isOptional = matches[3] == "?"
		path = strings.TrimSpace(matches[4])
	}

	match := &ImportDirectiveMatch{
		IsOptional: isOptional,
		Path:       path,
		IsLegacy:   isLegacy,
		Original:   trimmedLine,
	}
	importDirectiveLog.Printf("Parsed import directive: path=%s, optional=%t, legacy=%t", path, isOptional, isLegacy)
	return match
}