Function RegisterBuiltinVirtualFile

pkg/parser/virtual_fs.go:27–44

RegisterBuiltinVirtualFile registers an embedded file under a canonical builtin path. Paths must start with BuiltinPathPrefix ("@builtin:"); it panics if they do not. If the same path is registered twice with identical content the call is a no-op. Registering the same path with different content pan

(path string, content []byte)

// Registering the same path with different content panics to surface configuration errors early.
// This function is safe for concurrent use.
func RegisterBuiltinVirtualFile(path string, content []byte) {
	if !strings.HasPrefix(path, BuiltinPathPrefix) {
		panic(fmt.Sprintf("RegisterBuiltinVirtualFile: path %q does not start with %q", path, BuiltinPathPrefix))
	}
	builtinVirtualFilesMu.Lock()
	defer builtinVirtualFilesMu.Unlock()
	if builtinVirtualFiles == nil {
		builtinVirtualFiles = make(map[string][]byte)
	}
	if existing, ok := builtinVirtualFiles[path]; ok {
		if string(existing) != string(content) {
			panic(fmt.Sprintf("RegisterBuiltinVirtualFile: path %q already registered with different content", path))
		}
		return // idempotent: same content, no-op
	}
	virtualFsLog.Printf("Registering builtin virtual file: %s (%d bytes)", path, len(content))
	builtinVirtualFiles[path] = content
}

// BuiltinVirtualFileExists returns true if the given path is registered as a builtin virtual file.
func BuiltinVirtualFileExists(path string) bool {