using System.Text;
namespace Shigure;

internal sealed class ModuleDependencyService
{
    private static readonly string[] StateCategories =
    [
        ClassStateCatalog.CategoryState,
        ClassStateCatalog.CategorySpecial,
        ClassStateCatalog.CategoryResource,
        ClassStateCatalog.CategoryConfig,
        ClassStateCatalog.CategoryTarget,
        ClassStateCatalog.CategoryFocus,
        ClassStateCatalog.CategoryMouseover,
        ClassStateCatalog.CategoryPet,
        ClassStateCatalog.CategoryBoss1,
        ClassStateCatalog.CategoryBoss2,
        ClassStateCatalog.CategoryBoss3,
        ClassStateCatalog.CategoryBoss4,
        ClassStateCatalog.CategoryBoss5
    ];

    // “锚点”是配置协议使用但不在可编辑字段目录中展示的固定字段。
    private static readonly HashSet<string> HiddenFixedStateFields = new(StringComparer.Ordinal)
    {
        "锚点"
    };

    private readonly string _classDirectory;
    private readonly string _classMacrosPath;
    private readonly object _gate = new();

    public ModuleDependencyService(string baseDirectory)
    {
        var addonRoot = Path.Combine(baseDirectory, "Fuyutsui");
        _classDirectory = Path.Combine(addonRoot, "class");
        _classMacrosPath = Path.Combine(addonRoot, "core", "classmacros.lua");
    }

    public string? Capture(ModuleDefinition module)
    {
        lock (_gate)
        {
            return CaptureCore(module);
        }
    }

    private string? CaptureCore(ModuleDefinition module)
    {
        var classId = module.Match.ClassId;
        var specId = module.Match.SpecId;
        if (classId is null || specId is null)
        {
            module.Dependencies = null;
            return "模块未同时指定职业和专精，已保存模块逻辑，但未携带配置和宏。";
        }

        var classPath = ResolveClassPath(classId.Value);
        var configDocument = ClassBlocksStore.Load(classPath);
        if (!configDocument.IsModernFormat)
        {
            throw new InvalidOperationException($"{Path.GetFileName(classPath)} 仍是旧版配置格式，无法随模块保存。");
        }

        if (!configDocument.Specs.TryGetValue(specId.Value, out var spec))
        {
            throw new InvalidOperationException($"职业 {classId} 中不存在专精 {specId} 的配置。");
        }

        var macrosDocument = ClassMacrosStore.Load(_classMacrosPath);
        var classKey = ClassMacrosStore.ToClassFileKey(classId.Value);
        if (!macrosDocument.Classes.TryGetValue(classKey, out var macros))
        {
            throw new InvalidOperationException($"classmacros.lua 中不存在职业 {classKey} 的宏配置。");
        }

        EnsureMacroCapacity(classId.Value, macros);
        module.Dependencies = new ModuleDependencySnapshot
        {
            ClassId = classId.Value,
            SpecId = specId.Value,
            Config = new ModuleConfigSnapshot
            {
                Spec = CaptureSpec(spec),
                SpellsList = configDocument.SpellsList.Select(entry => new ModuleSpellListEntrySnapshot
                {
                    SpellId = entry.SpellId,
                    Index = entry.Index,
                    Name = entry.Name
                }).ToList()
            },
            Macros = new ModuleMacrosSnapshot
            {
                UsesSpecDynamicSpells = macros.UsesSpecDynamicSpells,
                DynamicCommon = new List<string>(macros.DynamicCommon),
                DynamicForSpec = macros.UsesSpecDynamicSpells
                    ? new List<string>(macros.DynamicBySpec.GetValueOrDefault(specId.Value) ?? [])
                    : [],
                StaticSpells = CompactMacroSnapshots(macros.StaticSpells.Select(CaptureMacro), isSpecial: false),
                SpecialSpells = CompactMacroSnapshots(macros.SpecialSpells.Select(CaptureMacro), isSpecial: true)
            }
        };
        return null;
    }

    public ModuleDependencyImportResult Import(IReadOnlyList<ModuleDefinition> modules)
    {
        lock (_gate)
        {
            return ImportCore(modules);
        }
    }

    private ModuleDependencyImportResult ImportCore(IReadOnlyList<ModuleDefinition> modules)
    {
        var result = new ModuleDependencyImportResult();
        foreach (var module in modules
                     .OrderBy(item => item.Name, StringComparer.CurrentCultureIgnoreCase)
                     .ThenBy(item => item.FilePath, StringComparer.OrdinalIgnoreCase))
        {
            if (module.Dependencies is null)
            {
                continue;
            }

            try
            {
                ValidateSnapshot(module, module.Dependencies);
                var removedFields = RemoveUnknownStateFields(module.Dependencies.Config.Spec);
                if (removedFields.Count > 0)
                {
                    result.SanitizedModules.Add(module.Clone());
                    result.RemovedStateFields.AddRange(removedFields.Select(field =>
                        new RemovedModuleStateField(module.Name, field.Category, field.Name)));
                }

                ImportOne(module, result);
            }
            catch (Exception ex)
            {
                result.Rejected.Add(new RejectedModuleDependency(module.Id, module.Name, ex.Message));
            }
        }

        return result;
    }

    private void ImportOne(ModuleDefinition module, ModuleDependencyImportResult result)
    {
        var snapshot = module.Dependencies!;

        var classPath = ResolveClassPath(snapshot.ClassId);
        var configDocument = ClassBlocksStore.Load(classPath);
        if (!configDocument.IsModernFormat)
        {
            throw new InvalidOperationException($"{Path.GetFileName(classPath)} 仍是旧版配置格式。");
        }

        if (!configDocument.Specs.TryGetValue(snapshot.SpecId, out var localSpec))
        {
            localSpec = new ClassBlocksStore.SpecBlocks();
            configDocument.Specs[snapshot.SpecId] = localSpec;
        }

        var macrosDocument = ClassMacrosStore.Load(_classMacrosPath);
        var classKey = ClassMacrosStore.ToClassFileKey(snapshot.ClassId);
        if (!macrosDocument.Classes.TryGetValue(classKey, out var localMacros))
        {
            throw new InvalidOperationException($"classmacros.lua 中不存在职业 {classKey} 的宏配置。");
        }

        var counters = new MergeCounters();
        MergeSpec(localSpec, snapshot.Config.Spec, counters);
        MergeSpellsList(configDocument.SpellsList, snapshot.Config.SpellsList, counters);
        MergeMacros(localMacros, snapshot.SpecId, snapshot.Macros, counters);
        EnsureMacroCapacity(snapshot.ClassId, localMacros);

        if (!counters.HasConfigChanges && counters.MacrosAdded == 0)
        {
            result.Conflicts.AddRange(counters.Conflicts.Select(message => $"{module.Name}: {message}"));
            if (counters.Conflicts.Count > 0)
            {
                result.ConflictedModuleIds.Add(module.Id);
            }
            return;
        }

        CommitDocuments(configDocument, macrosDocument, counters.HasConfigChanges, counters.MacrosAdded > 0);
        result.ConfigAdded += counters.ConfigAdded;
        result.ConfigUpdated += counters.ConfigUpdated;
        result.MacrosAdded += counters.MacrosAdded;
        result.ChangedModules.Add(module.Name);
        result.Conflicts.AddRange(counters.Conflicts.Select(message => $"{module.Name}: {message}"));
        if (counters.Conflicts.Count > 0)
        {
            result.ConflictedModuleIds.Add(module.Id);
        }
    }

    private static void ValidateSnapshot(ModuleDefinition module, ModuleDependencySnapshot snapshot)
    {
        if (snapshot.SchemaVersion is < 1 or > ModuleDependencySnapshot.CurrentSchemaVersion)
        {
            throw new InvalidDataException($"不支持依赖快照版本 {snapshot.SchemaVersion}。");
        }

        UpgradeLegacyItems(snapshot);

        if (module.Match.ClassId != snapshot.ClassId || module.Match.SpecId != snapshot.SpecId)
        {
            throw new InvalidDataException("依赖快照的职业/专精与模块匹配条件不一致。");
        }

        var unknownCategory = snapshot.Config.Spec.CategorizedStates.Keys
            .FirstOrDefault(key => !StateCategories.Contains(key, StringComparer.Ordinal));
        if (unknownCategory is not null)
        {
            throw new InvalidDataException($"依赖快照包含未知状态分类“{unknownCategory}”。");
        }

        var auraGroups = new[]
        {
            snapshot.Config.Spec.PlayerAuras,
            snapshot.Config.Spec.TargetHarmfulAuras,
            snapshot.Config.Spec.TargetHelpfulAuras,
            snapshot.Config.Spec.FocusHarmfulAuras,
            snapshot.Config.Spec.FocusHelpfulAuras
        };
        if (auraGroups.SelectMany(entries => entries ?? [])
            .Any(aura => !GetAuraSpellIds(aura.SpellId, aura.SpellIds).Any()))
        {
            throw new InvalidDataException("依赖快照包含缺少有效 spellId 的光环。");
        }

        if ((snapshot.Config.Spec.Spells ?? []).Any(spell => !IsValidSpellId(spell.SpellId)))
        {
            throw new InvalidDataException("依赖快照包含缺少有效 spellId 的法术。");
        }

        var items = snapshot.Config.Spec.Items ?? [];
        var itemReservedNames = new HashSet<string>(StringComparer.Ordinal);
        if (snapshot.Config.Spec.NestedStates)
        {
            foreach (var category in new[]
                     {
                         ClassStateCatalog.CategoryState,
                         ClassStateCatalog.CategorySpecial,
                         ClassStateCatalog.CategoryResource,
                         ClassStateCatalog.CategoryConfig
                     })
            {
                itemReservedNames.UnionWith(
                    snapshot.Config.Spec.CategorizedStates.GetValueOrDefault(category) ?? []);
            }
        }
        else
        {
            itemReservedNames.UnionWith(snapshot.Config.Spec.FlatStates ?? []);
        }
        if (items.Any(item => item.ItemId <= 0 || string.IsNullOrWhiteSpace(item.Name))
            || items.Select(item => item.ItemId).Distinct().Count() != items.Count
            || items.Select(item => item.Name).Distinct(StringComparer.Ordinal).Count() != items.Count
            || items.Any(item => itemReservedNames.Contains(item.Name)))
        {
            throw new InvalidDataException("依赖快照包含无效或重复的物品 itemId/name。");
        }

        if ((snapshot.Config.SpellsList ?? []).Any(spell => !IsValidSpellId(spell.SpellId)))
        {
            throw new InvalidDataException("依赖快照包含缺少有效 spellId 的技能列表条目。");
        }
    }

    private static void UpgradeLegacyItems(ModuleDependencySnapshot snapshot)
    {
        if (snapshot.SchemaVersion != 1)
        {
            return;
        }

        var spec = snapshot.Config.Spec;
        spec.Items ??= [];
        if (spec.CategorizedStates.TryGetValue(ClassStateCatalog.CategoryItem, out var legacyNames))
        {
            foreach (var name in legacyNames.ToArray())
            {
                if (ClassStateCatalog.TryGetLegacyItemId(name, out var itemId)
                    && spec.Items.All(item => item.ItemId != itemId))
                {
                    spec.Items.Add(new ModuleItemSnapshot { ItemId = itemId, Name = name, IsEquipped = false });
                    legacyNames.Remove(name);
                }
            }

            spec.CategorizedStates.Remove(ClassStateCatalog.CategoryItem);
        }

        snapshot.SchemaVersion = ModuleDependencySnapshot.CurrentSchemaVersion;
    }

    private static List<RemovedStateField> RemoveUnknownStateFields(ModuleSpecSnapshot spec)
    {
        var removed = new List<RemovedStateField>();
        if (spec.NestedStates)
        {
            foreach (var (category, fields) in spec.CategorizedStates)
            {
                if (fields is null)
                {
                    continue;
                }

                for (var index = fields.Count - 1; index >= 0; index--)
                {
                    var field = fields[index]?.Trim() ?? string.Empty;
                    if (IsRecognizedStateField(category, field))
                    {
                        continue;
                    }

                    fields.RemoveAt(index);
                    if (field.Length > 0)
                    {
                        removed.Add(new RemovedStateField(category, field));
                    }
                }
            }
        }
        else
        {
            for (var index = spec.FlatStates.Count - 1; index >= 0; index--)
            {
                var field = spec.FlatStates[index]?.Trim() ?? string.Empty;
                if (HiddenFixedStateFields.Contains(field) || ClassStateCatalog.FindCategory(field) is not null)
                {
                    continue;
                }

                spec.FlatStates.RemoveAt(index);
                if (field.Length > 0)
                {
                    removed.Add(new RemovedStateField(ClassStateCatalog.CategoryState, field));
                }
            }
        }

        removed.Reverse();
        return removed;
    }

    private static bool IsRecognizedStateField(string category, string field)
        => field.Length > 0
           && (ClassStateCatalog.IsKnown(category, field)
               || string.Equals(category, ClassStateCatalog.CategoryState, StringComparison.Ordinal)
               && HiddenFixedStateFields.Contains(field));

    private string ResolveClassPath(int classId)
    {
        var path = Path.Combine(_classDirectory, ClassNames.GetConfigFileName(classId) + ".lua");
        if (!File.Exists(path))
        {
            throw new FileNotFoundException($"找不到职业配置文件: {path}", path);
        }

        if (!File.Exists(_classMacrosPath))
        {
            throw new FileNotFoundException($"找不到职业宏文件: {_classMacrosPath}", _classMacrosPath);
        }

        return path;
    }

    private static ModuleSpecSnapshot CaptureSpec(ClassBlocksStore.SpecBlocks spec) => new()
    {
        NestedStates = spec.NestedStates,
        FlatStates = new List<string>(spec.FlatStates),
        CategorizedStates = spec.CategorizedStates.ToDictionary(
            pair => pair.Key,
            pair => new List<string>(pair.Value),
            StringComparer.Ordinal),
        Items = spec.Items
            .Where(item => item.ItemId is > 0 && !string.IsNullOrWhiteSpace(item.Name))
            .Select(item => new ModuleItemSnapshot
            {
                ItemId = item.ItemId!.Value,
                Name = item.Name,
                IsEquipped = item.IsEquipped
            })
            .ToList(),
        PlayerAuras = spec.PlayerAuras.Select(CaptureAura).ToList(),
        TargetHarmfulAuras = spec.TargetHarmfulAuras.Select(CaptureAura).ToList(),
        TargetHelpfulAuras = spec.TargetHelpfulAuras.Select(CaptureAura).ToList(),
        FocusHarmfulAuras = spec.FocusHarmfulAuras.Select(CaptureAura).ToList(),
        FocusHelpfulAuras = spec.FocusHelpfulAuras.Select(CaptureAura).ToList(),
        Spells = spec.Spells.Select(entry => new ModuleSpellSnapshot
        {
            Name = entry.Name,
            SpellId = entry.SpellId,
            Charge = entry.Charge,
            MaxCharge = entry.MaxCharge,
            CastCount = entry.CastCount,
            ForcedKnown = entry.ForcedKnown,
            InSpellBook = entry.InSpellBook
        }).ToList(),
        Group = spec.Group is null ? null : new ModuleGroupSnapshot
        {
            Num = spec.Group.Num,
            HealthPercent = spec.Group.HealthPercent,
            Role = spec.Group.Role,
            Dispel = spec.Group.Dispel,
            Auras = spec.Group.Auras.Select(entry => new ModuleGroupAuraSnapshot
            {
                Offset = entry.Offset,
                Name = entry.Name,
                SpellId = entry.SpellId,
                SpellIds = new List<long>(entry.SpellIds)
            }).ToList()
        }
    };

    private static ModuleAuraSnapshot CaptureAura(ClassBlocksStore.AuraEntry entry) => new()
    {
        Name = entry.Name,
        SpellId = entry.SpellId,
        SpellIds = new List<long>(entry.SpellIds),
        MaxApps = entry.MaxApps
    };

    private static ModuleMacroEntrySnapshot CaptureMacro(ClassMacrosStore.ArrayEntry entry) => new()
    {
        Text = entry.Text,
        Comment = entry.Comment
    };

    private static void MergeSpec(
        ClassBlocksStore.SpecBlocks local,
        ModuleSpecSnapshot incoming,
        MergeCounters counters)
    {
        if (local.NestedStates)
        {
            if (incoming.NestedStates)
            {
                foreach (var category in StateCategories)
                {
                    MergeStrings(local.CategorizedStates[category], incoming.CategorizedStates.GetValueOrDefault(category) ?? [], counters);
                }
            }
            else
            {
                MergeStrings(local.CategorizedStates[ClassStateCatalog.CategoryState], incoming.FlatStates, counters);
            }
        }
        else
        {
            if (incoming.NestedStates)
            {
                foreach (var category in StateCategories)
                {
                    MergeStrings(local.FlatStates, incoming.CategorizedStates.GetValueOrDefault(category) ?? [], counters);
                }
            }
            else
            {
                MergeStrings(local.FlatStates, incoming.FlatStates, counters);
            }
        }

        ClassBlocksStore.RelocateSpecialStateFields(local);

        var reservedNames = new HashSet<string>(StringComparer.Ordinal);
        if (local.NestedStates)
        {
            foreach (var category in new[]
                     {
                         ClassStateCatalog.CategoryState,
                         ClassStateCatalog.CategorySpecial,
                         ClassStateCatalog.CategoryResource,
                         ClassStateCatalog.CategoryConfig
                     })
            {
                reservedNames.UnionWith(local.CategorizedStates.GetValueOrDefault(category) ?? []);
            }
        }
        else
        {
            reservedNames.UnionWith(local.FlatStates);
        }
        MergeItems(local.Items, incoming.Items ?? [], reservedNames, counters);

        MergeAuras(local.PlayerAuras, incoming.PlayerAuras, "玩家光环", counters);
        MergeAuras(local.TargetHarmfulAuras, incoming.TargetHarmfulAuras, "目标减益", counters);
        MergeAuras(local.TargetHelpfulAuras, incoming.TargetHelpfulAuras, "目标增益", counters);
        MergeAuras(local.FocusHarmfulAuras, incoming.FocusHarmfulAuras, "焦点减益", counters);
        MergeAuras(local.FocusHelpfulAuras, incoming.FocusHelpfulAuras, "焦点增益", counters);
        MergeSpells(local.Spells, incoming.Spells, counters);
        // 队伍配置属于本地扫描布局；模块快照只为文件兼容保留，导入时不得比较或修改。
    }

    private static void MergeStrings(List<string> local, IEnumerable<string> incoming, MergeCounters counters)
    {
        var existing = new HashSet<string>(local, StringComparer.Ordinal);
        foreach (var value in incoming.Select(item => item?.Trim() ?? string.Empty).Where(item => item.Length > 0))
        {
            if (existing.Add(value))
            {
                local.Add(value);
                counters.ConfigAdded++;
            }
        }
    }

    private static void MergeAuras(
        List<ClassBlocksStore.AuraEntry> local,
        IEnumerable<ModuleAuraSnapshot> incoming,
        string label,
        MergeCounters counters)
    {
        CompactLocalAuras(local, label, counters);

        foreach (var entry in incoming)
        {
            var existing = local.FirstOrDefault(item => AuraIdentityMatches(item, entry));
            if (existing is not null)
            {
                MergeAuraMetadata(existing, entry, label, counters);
                continue;
            }

            var added = new ClassBlocksStore.AuraEntry
            {
                Name = entry.Name,
                SpellId = entry.SpellId,
                MaxApps = entry.MaxApps
            };
            added.SpellIds.AddRange(entry.SpellIds);
            local.Add(added);
            counters.ConfigAdded++;
        }
    }

    private static void CompactLocalAuras(
        List<ClassBlocksStore.AuraEntry> local,
        string label,
        MergeCounters counters)
    {
        for (var index = 0; index < local.Count; index++)
        {
            var current = local[index];
            var existing = local.Take(index).FirstOrDefault(item => AuraIdentityMatches(item, current));
            if (existing is null)
            {
                continue;
            }

            MergeAuraMetadata(existing, current, label, counters);
            local.RemoveAt(index--);
            counters.ConfigUpdated++;
        }
    }

    private static bool AuraIdentityMatches(
        ClassBlocksStore.AuraEntry left,
        ClassBlocksStore.AuraEntry right)
    {
        return SpellIdentityMatches(
            GetAuraSpellIds(left.SpellId, left.SpellIds),
            left.Name,
            GetAuraSpellIds(right.SpellId, right.SpellIds),
            right.Name);
    }

    private static bool AuraIdentityMatches(
        ClassBlocksStore.AuraEntry left,
        ModuleAuraSnapshot right)
    {
        return SpellIdentityMatches(
            GetAuraSpellIds(left.SpellId, left.SpellIds),
            left.Name,
            GetAuraSpellIds(right.SpellId, right.SpellIds),
            right.Name);
    }

    private static void MergeAuraMetadata(
        ClassBlocksStore.AuraEntry target,
        ClassBlocksStore.AuraEntry incoming,
        string label,
        MergeCounters counters)
    {
        MergeAuraMetadataCore(
            target,
            incoming.Name,
            incoming.SpellId,
            incoming.SpellIds,
            incoming.MaxApps,
            label,
            counters);
    }

    private static void MergeAuraMetadata(
        ClassBlocksStore.AuraEntry target,
        ModuleAuraSnapshot incoming,
        string label,
        MergeCounters counters)
    {
        MergeAuraMetadataCore(
            target,
            incoming.Name,
            incoming.SpellId,
            incoming.SpellIds,
            incoming.MaxApps,
            label,
            counters);
    }

    private static void MergeAuraMetadataCore(
        ClassBlocksStore.AuraEntry target,
        string? incomingName,
        long? incomingSpellId,
        IEnumerable<long>? incomingSpellIds,
        int? incomingMaxApps,
        string label,
        MergeCounters counters)
    {
        var changed = false;
        if (target.SpellId is null && incomingSpellId is > 0)
        {
            target.SpellId = incomingSpellId;
            changed = true;
        }

        foreach (var spellId in GetAuraSpellIds(incomingSpellId, incomingSpellIds))
        {
            if (target.SpellId != spellId && !target.SpellIds.Contains(spellId))
            {
                target.SpellIds.Add(spellId);
                changed = true;
            }
        }

        if (target.MaxApps is null && incomingMaxApps is not null)
        {
            target.MaxApps = incomingMaxApps;
            changed = true;
        }
        else if (target.MaxApps is not null
                 && incomingMaxApps is not null
                 && target.MaxApps != incomingMaxApps)
        {
            counters.Conflicts.Add(
                $"{label}“{DisplayName(incomingName, incomingSpellId)}”的 maxApps 存在差异："
                + $"本地 {target.MaxApps}、模块 {incomingMaxApps}，已保留本地。");
        }

        if (string.IsNullOrWhiteSpace(target.Name) && !string.IsNullOrWhiteSpace(incomingName))
        {
            target.Name = incomingName;
            changed = true;
        }

        if (changed)
        {
            counters.ConfigUpdated++;
        }
    }

    private static void MergeSpells(
        List<ClassBlocksStore.SpellEntry> local,
        IEnumerable<ModuleSpellSnapshot> incoming,
        MergeCounters counters)
    {
        CompactLocalSpells(local, counters);

        foreach (var entry in incoming)
        {
            var name = DisplayName(entry.Name, entry.SpellId);
            var existing = local.FirstOrDefault(item => SpellIdentityMatches(item, entry));
            if (existing is not null)
            {
                MergeSpellMetadata(existing, entry, name, counters);
                continue;
            }

            local.Add(new ClassBlocksStore.SpellEntry
            {
                Name = entry.Name,
                SpellId = entry.SpellId,
                Charge = entry.Charge,
                MaxCharge = entry.MaxCharge,
                CastCount = entry.CastCount,
                ForcedKnown = entry.ForcedKnown,
                InSpellBook = entry.InSpellBook
            });
            counters.ConfigAdded++;
        }
    }

    private static void CompactLocalSpells(
        List<ClassBlocksStore.SpellEntry> local,
        MergeCounters counters)
    {
        for (var index = 0; index < local.Count; index++)
        {
            var current = local[index];
            var existing = local.Take(index).FirstOrDefault(item => SpellIdentityMatches(item, current));
            if (existing is null)
            {
                continue;
            }

            MergeSpellMetadata(existing, current, DisplayName(current.Name, current.SpellId), counters);
            local.RemoveAt(index--);
            counters.ConfigUpdated++;
        }
    }

    private static void MergeItems(
        List<ClassBlocksStore.ItemEntry> local,
        IEnumerable<ModuleItemSnapshot> incoming,
        IReadOnlySet<string> reservedNames,
        MergeCounters counters)
    {
        foreach (var item in incoming.OrderBy(item => item.ItemId))
        {
            var byId = local.FirstOrDefault(existing => existing.ItemId == item.ItemId);
            if (byId is not null)
            {
                if (!string.Equals(byId.Name, item.Name, StringComparison.Ordinal))
                {
                    counters.Conflicts.Add(
                        $"物品 itemId {item.ItemId} 的名称不同：本地“{byId.Name}”、模块“{item.Name}”，已保留本地。");
                }
                else if (byId.IsEquipped != item.IsEquipped)
                {
                    counters.Conflicts.Add(
                        $"物品“{item.Name}”的 isEquipped 不同：本地 {byId.IsEquipped}、模块 {item.IsEquipped}，已保留本地。");
                }
                continue;
            }

            var byName = local.FirstOrDefault(existing => string.Equals(existing.Name, item.Name, StringComparison.Ordinal));
            if (byName is not null)
            {
                counters.Conflicts.Add(
                    $"物品名称“{item.Name}”的 itemId 不同：本地 {byName.ItemId}、模块 {item.ItemId}，已保留本地。");
                continue;
            }

            if (reservedNames.Contains(item.Name))
            {
                counters.Conflicts.Add($"物品名称“{item.Name}”与本地状态、特殊、能量或配置开关字段重名，已跳过。");
                continue;
            }

            local.Add(new ClassBlocksStore.ItemEntry
            {
                ItemId = item.ItemId,
                Name = item.Name,
                IsEquipped = item.IsEquipped
            });
            counters.ConfigAdded++;
        }

        local.Sort((left, right) => (left.ItemId ?? long.MaxValue).CompareTo(right.ItemId ?? long.MaxValue));
    }

    private static void MergeSpellMetadata(
        ClassBlocksStore.SpellEntry target,
        ModuleSpellSnapshot incoming,
        string name,
        MergeCounters counters)
        => MergeSpellMetadataCore(
            target,
            incoming.Name,
            incoming.Charge,
            incoming.MaxCharge,
            incoming.CastCount,
            incoming.ForcedKnown,
            incoming.InSpellBook,
            name,
            counters);

    private static void MergeSpellMetadata(
        ClassBlocksStore.SpellEntry target,
        ClassBlocksStore.SpellEntry incoming,
        string name,
        MergeCounters counters)
        => MergeSpellMetadataCore(
            target,
            incoming.Name,
            incoming.Charge,
            incoming.MaxCharge,
            incoming.CastCount,
            incoming.ForcedKnown,
            incoming.InSpellBook,
            name,
            counters);

    private static void MergeSpellMetadataCore(
        ClassBlocksStore.SpellEntry target,
        string? incomingName,
        bool incomingCharge,
        int? incomingMaxCharge,
        int? incomingCastCount,
        bool incomingForcedKnown,
        bool incomingInSpellBook,
        string name,
        MergeCounters counters)
    {
        var changed = false;
        if (!target.Charge && incomingCharge)
        {
            target.Charge = true;
            changed = true;
        }
        if (!target.ForcedKnown && incomingForcedKnown)
        {
            target.ForcedKnown = true;
            changed = true;
        }
        if (!target.InSpellBook && incomingInSpellBook)
        {
            target.InSpellBook = true;
            changed = true;
        }

        MergeNullable(
            target.MaxCharge,
            incomingMaxCharge,
            value => target.MaxCharge = value,
            "最大充能");
        MergeNullable(
            target.CastCount,
            incomingCastCount,
            value => target.CastCount = value,
            "施法次数");

        if (string.IsNullOrWhiteSpace(target.Name) && !string.IsNullOrWhiteSpace(incomingName))
        {
            target.Name = incomingName.Trim();
            changed = true;
        }

        if (changed)
        {
            counters.ConfigUpdated++;
        }

        void MergeNullable(int? localValue, int? incomingValue, Action<int> assign, string field)
        {
            if (localValue is null && incomingValue is { } supplied)
            {
                assign(supplied);
                changed = true;
            }
            else if (localValue is not null && incomingValue is not null && localValue != incomingValue)
            {
                counters.Conflicts.Add(
                    $"法术“{name}”的{field}存在差异：本地 {localValue}、模块 {incomingValue}，已保留本地。");
            }
        }
    }

    private static bool SpellIdentityMatches(
        ClassBlocksStore.SpellEntry left,
        ClassBlocksStore.SpellEntry right)
    {
        return IsValidSpellId(left.SpellId) && left.SpellId == right.SpellId;
    }

    private static bool SpellIdentityMatches(
        ClassBlocksStore.SpellEntry left,
        ModuleSpellSnapshot right)
    {
        return IsValidSpellId(left.SpellId) && left.SpellId == right.SpellId;
    }

    private static bool SpellIdentityMatches(
        IEnumerable<long> leftIds,
        string? leftName,
        IEnumerable<long> rightIds,
        string? rightName)
    {
        var leftIdSet = leftIds.Where(IsValidSpellId).ToHashSet();
        var rightIdSet = rightIds.Where(IsValidSpellId).ToHashSet();
        return leftIdSet.Count > 0
            && rightIdSet.Count > 0
            && leftIdSet.Overlaps(rightIdSet);
    }

    private static IEnumerable<long> GetSpellIds(long spellId)
        => IsValidSpellId(spellId) ? [spellId] : [];

    private static IEnumerable<long> GetAuraSpellIds(long? spellId, IEnumerable<long>? spellIds)
    {
        var result = new HashSet<long>();
        if (spellId is { } primary && IsValidSpellId(primary))
        {
            result.Add(primary);
        }

        foreach (var id in spellIds ?? [])
        {
            if (IsValidSpellId(id))
            {
                result.Add(id);
            }
        }

        return result;
    }

    private static bool IsValidSpellId(long spellId) => spellId > 0;

    private static string DisplayName(string? name, long? spellId)
        => string.IsNullOrWhiteSpace(name) ? spellId?.ToString() ?? "未命名" : name.Trim();

    private static void MergeSpellsList(
        List<ClassBlocksStore.SpellsListEntry> local,
        IEnumerable<ModuleSpellListEntrySnapshot> incoming,
        MergeCounters counters)
    {
        CompactLocalSpellsList(local, counters);

        foreach (var entry in incoming)
        {
            var byId = local.FirstOrDefault(item => item.SpellId == entry.SpellId);
            if (byId is not null)
            {
                // spellId 是跨模块稳定标识；索引是当前职业文件的本地编码。
                // 同一 spellId 已存在时保留本地索引/名称，不因来源索引不同产生冲突。
                continue;
            }

            local.Add(new ClassBlocksStore.SpellsListEntry
            {
                SpellId = entry.SpellId,
                Index = entry.Index,
                Name = entry.Name,
                OriginalSpellId = 0
            });
            counters.ConfigAdded++;
        }
    }

    private static void CompactLocalSpellsList(
        List<ClassBlocksStore.SpellsListEntry> local,
        MergeCounters counters)
    {
        var seen = new HashSet<long>();
        for (var index = 0; index < local.Count; index++)
        {
            if (seen.Add(local[index].SpellId))
            {
                continue;
            }

            local.RemoveAt(index--);
            counters.ConfigUpdated++;
        }
    }

    private static void MergeMacros(
        ClassMacrosStore.ClassMacros local,
        int specId,
        ModuleMacrosSnapshot incoming,
        MergeCounters counters)
    {
        var commonNames = new HashSet<string>(local.DynamicCommon.Select(NormalizeMacroText), StringComparer.Ordinal);
        foreach (var value in incoming.DynamicCommon)
        {
            var normalized = NormalizeMacroText(value);
            if (normalized.Length > 0 && commonNames.Add(normalized))
            {
                local.DynamicCommon.Add(value.Trim());
                counters.MacrosAdded++;
            }
        }

        if (incoming.UsesSpecDynamicSpells && incoming.DynamicForSpec.Count > 0)
        {
            local.UsesSpecDynamicSpells = true;
            if (!local.DynamicBySpec.TryGetValue(specId, out var specMacros))
            {
                specMacros = new List<string>();
                local.DynamicBySpec[specId] = specMacros;
            }

            var resolved = new HashSet<string>(local.DynamicCommon.Select(NormalizeMacroText), StringComparer.Ordinal);
            resolved.UnionWith(specMacros.Select(NormalizeMacroText));
            foreach (var value in incoming.DynamicForSpec)
            {
                var normalized = NormalizeMacroText(value);
                if (normalized.Length > 0 && resolved.Add(normalized))
                {
                    specMacros.Add(value.Trim());
                    counters.MacrosAdded++;
                }
            }
        }

        MergeMacroEntries(local.StaticSpells, incoming.StaticSpells, isSpecial: false, counters);
        MergeMacroEntries(local.SpecialSpells, incoming.SpecialSpells, isSpecial: true, counters);
    }

    private static void MergeMacroEntries(
        List<ClassMacrosStore.ArrayEntry> local,
        IEnumerable<ModuleMacroEntrySnapshot> incoming,
        bool isSpecial,
        MergeCounters counters)
    {
        foreach (var entry in CompactMacroSnapshots(incoming, isSpecial))
        {
            var overlapIndex = IndexOfOverlappingArrayEntry(local, entry, isSpecial);
            if (overlapIndex >= 0)
            {
                var existing = local[overlapIndex];
                if (string.IsNullOrWhiteSpace(existing.Comment) && !string.IsNullOrWhiteSpace(entry.Comment))
                {
                    existing.Comment = entry.Comment;
                    counters.MacrosAdded++;
                    continue;
                }

                if (!string.Equals(NormalizeMacroText(existing.Text), NormalizeMacroText(entry.Text), StringComparison.Ordinal)
                    || CommentsConflict(existing.Comment, entry.Comment))
                {
                    var identity = GetMacroIdentity(entry.Text, entry.Comment, isSpecial);
                    counters.Conflicts.Add($"宏“{identity.Spell}”与本地内容不同，已保留本地。");
                }

                continue;
            }

            local.Add(new ClassMacrosStore.ArrayEntry { Text = entry.Text, Comment = entry.Comment });
            counters.MacrosAdded++;
        }
    }

    private static List<ModuleMacroEntrySnapshot> CompactMacroSnapshots(
        IEnumerable<ModuleMacroEntrySnapshot>? entries,
        bool isSpecial)
    {
        var result = new List<ModuleMacroEntrySnapshot>();
        foreach (var entry in entries ?? [])
        {
            if (entry is null || string.IsNullOrWhiteSpace(entry.Text))
            {
                continue;
            }

            var index = IndexOfOverlappingMacroSnapshot(result, entry, isSpecial);
            if (index >= 0)
            {
                UpgradeMacroComment(result[index], entry);
                continue;
            }

            result.Add(entry.Clone());
        }

        return result;
    }

    private static void UpgradeMacroComment(ModuleMacroEntrySnapshot target, ModuleMacroEntrySnapshot source)
    {
        if (string.IsNullOrWhiteSpace(target.Comment) && !string.IsNullOrWhiteSpace(source.Comment))
        {
            target.Comment = source.Comment;
        }
    }

    private static int IndexOfOverlappingMacroSnapshot(
        IReadOnlyList<ModuleMacroEntrySnapshot> entries,
        ModuleMacroEntrySnapshot candidate,
        bool isSpecial)
    {
        for (var i = 0; i < entries.Count; i++)
        {
            if (MacrosOverlap(entries[i].Text, entries[i].Comment, candidate.Text, candidate.Comment, isSpecial))
            {
                return i;
            }
        }

        return -1;
    }

    private static int IndexOfOverlappingArrayEntry(
        IReadOnlyList<ClassMacrosStore.ArrayEntry> entries,
        ModuleMacroEntrySnapshot candidate,
        bool isSpecial)
    {
        for (var i = 0; i < entries.Count; i++)
        {
            if (MacrosOverlap(entries[i].Text, entries[i].Comment, candidate.Text, candidate.Comment, isSpecial))
            {
                return i;
            }
        }

        return -1;
    }

    private static bool MacrosOverlap(
        string leftText,
        string? leftComment,
        string rightText,
        string? rightComment,
        bool isSpecial)
    {
        var leftNormalized = NormalizeMacroText(leftText);
        var rightNormalized = NormalizeMacroText(rightText);
        if (leftNormalized.Length > 0 && leftNormalized == rightNormalized)
        {
            return true;
        }

        if (!isSpecial)
        {
            return false;
        }

        var leftName = leftComment?.Trim() ?? string.Empty;
        var rightName = rightComment?.Trim() ?? string.Empty;
        return leftName.Length > 0 && string.Equals(leftName, rightName, StringComparison.Ordinal);
    }

    private static bool CommentsConflict(string? left, string? right)
    {
        var leftName = left?.Trim() ?? string.Empty;
        var rightName = right?.Trim() ?? string.Empty;
        return leftName.Length > 0
               && rightName.Length > 0
               && !string.Equals(leftName, rightName, StringComparison.Ordinal);
    }

    private static MacroIdentity GetMacroIdentity(string text, string? comment, bool isSpecial)
    {
        var parsed = isSpecial
            ? FuyutsuiKeymapConverter.ParseSpecialMacro(text, comment)
            : FuyutsuiKeymapConverter.ParseStaticMacro(text, comment);
        var spell = parsed.Spell.Trim();
        return spell.Length > 0
            ? new MacroIdentity(isSpecial, parsed.Unit, spell, parsed.Condition)
            : new MacroIdentity(isSpecial, parsed.Unit, NormalizeMacroText(text), parsed.Condition);
    }

    private static string NormalizeMacroText(string? value)
        => (value ?? string.Empty).Replace("\r\n", "\n", StringComparison.Ordinal).Trim();

    private static void EnsureMacroCapacity(int classId, ClassMacrosStore.ClassMacros macros)
    {
        foreach (var (specId, specName) in ClassNames.GetSpecs(classId))
        {
            var dynamicCount = macros.UsesSpecDynamicSpells
                ? macros.DynamicCommon.Count + (macros.DynamicBySpec.GetValueOrDefault(specId)?.Count ?? 0)
                : macros.DynamicCommon.Count;
            var slots = checked(dynamicCount * 30 + macros.StaticSpells.Count + macros.SpecialSpells.Count);
            if (slots > FuyutsuiKeymapConverter.MacroSlotCapacity)
            {
                throw new InvalidOperationException(
                    $"宏容量超限：{ClassNames.GetClassAndSpecName(classId, specId).ClassName} {specName} 合并后 {slots} 个槽位，最大 {FuyutsuiKeymapConverter.MacroSlotCapacity}。模块未导入。");
            }
        }
    }

    private static void CommitDocuments(
        ClassBlocksStore.ClassFileDocument config,
        ClassMacrosStore.MacrosDocument macros,
        bool saveConfig,
        bool saveMacros)
    {
        var originalConfig = saveConfig ? File.ReadAllText(config.FilePath, Encoding.UTF8) : null;
        var originalMacros = saveMacros ? File.ReadAllText(macros.FilePath, Encoding.UTF8) : null;
        try
        {
            if (saveConfig)
            {
                ClassBlocksStore.Save(config);
            }
            if (saveMacros)
            {
                ClassMacrosStore.Save(macros);
            }
        }
        catch (Exception saveError)
        {
            var rollbackErrors = new List<Exception>();
            TryRestore(config.FilePath, originalConfig, rollbackErrors);
            TryRestore(macros.FilePath, originalMacros, rollbackErrors);
            if (rollbackErrors.Count > 0)
            {
                throw new AggregateException("模块依赖写入失败，且回滚未完全成功。", [saveError, .. rollbackErrors]);
            }
            throw;
        }
    }

    private static void TryRestore(string path, string? contents, ICollection<Exception> errors)
    {
        if (contents is null)
        {
            return;
        }
        try
        {
            AtomicFile.WriteAllText(path, contents, new UTF8Encoding(encoderShouldEmitUTF8Identifier: false));
        }
        catch (Exception ex)
        {
            errors.Add(ex);
        }
    }

    private static bool SpellEquals(ClassBlocksStore.SpellEntry left, ModuleSpellSnapshot right)
        => left.SpellId == right.SpellId
           && left.Charge == right.Charge
           && left.MaxCharge == right.MaxCharge
           && left.CastCount == right.CastCount
           && left.ForcedKnown == right.ForcedKnown
           && left.InSpellBook == right.InSpellBook;

    private sealed class MergeCounters
    {
        public int ConfigAdded { get; set; }
        public int ConfigUpdated { get; set; }
        public int MacrosAdded { get; set; }
        public List<string> Conflicts { get; } = new();

        public bool HasConfigChanges => ConfigAdded > 0 || ConfigUpdated > 0;
    }

    // 仅用于冲突提示：静态宏按解析出的目标/技能/条件；特殊宏按手工技能名。
    private readonly record struct MacroIdentity(bool IsSpecial, int Unit, string Spell, string Condition);
}

internal sealed class ModuleDependencyImportResult
{
    public int ConfigAdded { get; set; }
    public int ConfigUpdated { get; set; }
    public int MacrosAdded { get; set; }
    public List<string> ChangedModules { get; } = new();
    public List<string> Conflicts { get; } = new();
    public HashSet<string> ConflictedModuleIds { get; } = new(StringComparer.OrdinalIgnoreCase);
    public List<RejectedModuleDependency> Rejected { get; } = new();
    public List<ModuleDefinition> SanitizedModules { get; } = new();
    public List<RemovedModuleStateField> RemovedStateFields { get; } = new();
    public bool HasChanges => ConfigAdded > 0 || ConfigUpdated > 0 || MacrosAdded > 0;
}

internal sealed record RejectedModuleDependency(string ModuleId, string ModuleName, string Reason);
internal sealed record RemovedModuleStateField(string ModuleName, string Category, string Name);
internal sealed record RemovedStateField(string Category, string Name);