// ============================================================================
// Persistent storage keys
// ============================================================================
// STORAGE_KEY хранит пользовательские настройки интерфейса:
// тему, акцент, режим отображения, ширину сайдбара и toggle-настройки.
const STORAGE_KEY = "ecosystem-panel-preferences";

// COLLAPSE_STORAGE_KEY хранит ручные состояния раскрытия details:
// отдельно для дерева навигации и отдельно для контентных секций.
const COLLAPSE_STORAGE_KEY = "ecosystem-panel-collapse-state";

// ============================================================================
// Panel configuration (settings.json)
// ============================================================================
// settings.json задает источник данных панели:
// - dataUrl: URL или путь к JSON (fetch), например "./panel-data.json"
// - data: inline-объект с той же структурой, если dataUrl пустой
const panelScript =
  document.currentScript ?? document.querySelector("script[data-ecosystem-panel]");
const PANEL_ASSET_BASE = panelScript?.dataset.assetBase ?? "";
const SETTINGS_PATH = panelScript?.dataset.settingsPath ?? "./settings.json";

function resolveAssetPath(path) {
  if (!path || /^(?:[a-z]+:|\/\/|\/)/i.test(path)) {
    return path;
  }

  return `${PANEL_ASSET_BASE}${path}`;
}

let ecosystemSections = [];
let panelTitle = "Панель экосистемы";

const defaultServiceMeta = {
  ceph: { label: "Ceph", icon: "assets/ceph.svg" },
  cloudbeaver: { label: "CloudBeaver", icon: "assets/cloudbeaver.svg" },
  config: { label: "Config", icon: "assets/config.svg" },
  gitea: { label: "Gitea", icon: "assets/gitea.svg" },
  grafana: { label: "Grafana", icon: "assets/grafana.svg" },
  ipmi: { label: "IPMI", icon: "assets/server.svg" },
  kubernetes: { label: "Kubernetes", icon: "assets/kubernetes.svg" },
  ldap: { label: "LDAP", icon: "assets/ldap.svg" },
  messages: { label: "Messages", icon: "assets/messages.svg" },
  opensearch: { label: "OpenSearch", icon: "assets/opensearch.svg" },
  postgresql: { label: "PostgreSQL", icon: "assets/postgresql.svg" },
  prometheus: { label: "Prometheus", icon: "assets/prometheus.svg" },
  rabbitmq: { label: "RabbitMQ", icon: "assets/rabbitmq.svg" },
  redmine: { label: "Redmine", icon: "assets/redmine.svg" },
  rules: { label: "Rules", icon: "assets/rules.svg" },
  xpath: { label: "xPath", icon: "assets/xpath.svg" },
  xmpp: { label: "XMPP", icon: "assets/xmpp.svg" },
};

let serviceMeta = { ...defaultServiceMeta };

// ============================================================================
// Default UI preferences
// ============================================================================
// Значения используются при первом открытии или если localStorage пуст/битый.
const defaultPreferences = {
  theme: window.matchMedia("(prefers-color-scheme: light)").matches ? "light" : "dark",
  view: "cards",
  accent: "violet",
  customAccentFrom: "#8b5cf6",
  customAccentTo: "#22d3ee",
  customAccentAngle: 135,
  navLayout: "sidebar",
  showNumbers: false,
  showTreeTags: true,
  treeTwoColumn: false,
  autoCollapseSearch: true,
  sidebarWidth: 390,
  searchPlaceholder: "Grafana, S3, журнал, сервер...",
};

const defaultPanelFeatures = {
  allowNavLayoutChange: true,
  allowSearch: true,
  allowViewChange: true,
  allowShowNumbers: true,
  allowTreeOptions: true,
  allowSidebarResize: true,
  allowThemeChange: true,
  allowAccentChange: true,
};

const availableNavLayouts = ["sidebar", "top"];
const availableViews = ["cards", "list", "compact-cards", "compact-list"];
const availableAccents = ["violet", "cyan", "lime", "amber", "custom"];

// ============================================================================
// Runtime state and DOM references
// ============================================================================
// preferences - текущие настройки интерфейса; итоговые значения собираются в bootstrap().
let panelDefaults = { ...defaultPreferences };
let panelFeatures = { ...defaultPanelFeatures };
let preferences = { ...defaultPreferences };

// collapseState - объект вида { [collapseKey]: boolean } для details.
const collapseState = readCollapseState();

// Корневые DOM-узлы, которые нужны для рендера и событий.
const appLayout = document.querySelector(".app-layout");
const catalog = document.querySelector("[data-catalog-root]");
const navTree = document.querySelector("[data-nav-tree]");
const sidebarResizer = document.querySelector("[data-sidebar-resizer]");
const searchField = document.querySelector("[data-search-field]");
const searchInput = document.querySelector("[data-search-input]");
const settingsToggle = document.querySelector("[data-settings-toggle]");
const settingsPanel = document.querySelector("[data-settings-panel]");
const settingsOverlay = document.querySelector("[data-settings-overlay]");
const settingsClose = document.querySelector("[data-settings-close]");
const themeButtons = document.querySelectorAll("[data-theme]");
const navLayoutButtons = document.querySelectorAll("[data-nav-layout]");
const viewButtons = document.querySelectorAll("[data-view]");
const accentButtons = document.querySelectorAll("[data-accent]");
const accentCustomPanel = document.querySelector("[data-accent-custom-panel]");
const customAccentFromInput = document.querySelector("[data-custom-accent-from]");
const customAccentToInput = document.querySelector("[data-custom-accent-to]");
const customAccentAngleInput = document.querySelector("[data-custom-accent-angle]");
const customAccentAngleValue = document.querySelector("[data-custom-accent-angle-value]");
const customAccentPreview = document.querySelector("[data-custom-accent-preview]");
const showNumbersInput = document.querySelector("[data-show-numbers]");
const showTreeTagsInput = document.querySelector("[data-show-tree-tags]");
const treeTwoColumnInput = document.querySelector("[data-tree-two-column]");
const autoCollapseSearchInput = document.querySelector("[data-auto-collapse-search]");
const settingsSections = document.querySelectorAll("[data-settings-section]");
const emptyTemplate = document.querySelector("#empty-template");
const configErrorTemplate = document.querySelector("#config-error-template");
const pageTitleElement = document.querySelector("#page-title");

// ============================================================================
// Initial render
// ============================================================================
bootstrap();

async function bootstrap() {
  try {
    const settings = await fetchJson(SETTINGS_PATH);
    applyOrganizationConfig(settings);
    preferences = enforceFeatureLocks(normalizePreferences({ ...panelDefaults, ...readPreferences() }));

    const panelData = await loadPanelDataFromSettings(settings);
    ecosystemSections = panelData.sections;
    serviceMeta = panelData.serviceMeta;
    panelTitle = panelData.title;
    pageTitleElement.textContent = panelTitle;
    document.title = panelTitle;
  } catch (error) {
    showConfigError(error);
    return;
  }

  renderNavigationTree();
  applyPreferences(preferences);
  renderCatalog();
}

// ============================================================================
// Event bindings
// ============================================================================
// Поиск перерисовывает и дерево, и каталог:
// - дерево получает подсветку совпадений и авто-раскрытие веток;
// - каталог фильтруется и тоже подсвечивает найденный текст.
searchInput.addEventListener("input", () => {
  renderNavigationTree();
  renderCatalog();
});

// Клик по файлу/папке в дереве фокусирует соответствующую секцию/карточку.
// Само раскрытие details остается на нативном summary/caret.
navTree.addEventListener("click", (event) => {
  const button = event.target.closest("[data-focus-target]");

  if (!button) {
    return;
  }

  event.preventDefault();
  event.stopPropagation();
  focusCatalogTarget(button.dataset.focusTarget);
});

// Сохраняем ручное раскрытие/сворачивание дерева и контента.
// Используем capture=true, потому что toggle не всплывает как обычный click.
navTree.addEventListener("toggle", handleDetailsToggle, true);
catalog.addEventListener("toggle", handleDetailsToggle, true);

// Открытие popup-настроек по шестеренке.
settingsToggle.addEventListener("click", () => {
  const isOpen = settingsPanel.classList.toggle("is-open");
  settingsOverlay.classList.toggle("is-open", isOpen);
  settingsToggle.setAttribute("aria-expanded", String(isOpen));
});

// Закрытие popup-настроек всеми привычными способами.
settingsClose.addEventListener("click", closeSettingsPanel);
settingsOverlay.addEventListener("click", closeSettingsPanel);

document.addEventListener("keydown", (event) => {
  if (event.key === "Escape") {
    closeSettingsPanel();
  }
});

document.addEventListener("click", (event) => {
  if (!settingsPanel.classList.contains("is-open")) {
    return;
  }

  if (settingsPanel.contains(event.target) || settingsToggle.contains(event.target)) {
    return;
  }

  closeSettingsPanel();
});

themeButtons.forEach((button) => {
  button.addEventListener("click", () => {
    if (!panelFeatures.allowThemeChange) {
      return;
    }

    preferences.theme = button.dataset.theme;
    applyPreferences(preferences);
    savePreferences(preferences);
  });
});

navLayoutButtons.forEach((button) => {
  button.addEventListener("click", () => {
    if (!panelFeatures.allowNavLayoutChange) {
      return;
    }

    preferences.navLayout = button.dataset.navLayout;
    applyPreferences(preferences);

    if (preferences.navLayout === "sidebar") {
      renderNavigationTree();
    }

    savePreferences(preferences);
  });
});

// Переключение режима отображения каталога.
viewButtons.forEach((button) => {
  button.addEventListener("click", () => {
    if (!panelFeatures.allowViewChange) {
      return;
    }

    preferences.view = button.dataset.view;
    applyPreferences(preferences);
    savePreferences(preferences);
  });
});

// Выбор цветового акцента из пресетов или пользовательского градиента.
accentButtons.forEach((button) => {
  button.addEventListener("click", () => {
    if (!panelFeatures.allowAccentChange) {
      return;
    }

    preferences.accent = button.dataset.accent;
    applyPreferences(preferences);
    savePreferences(preferences);
  });
});

// Изменение параметров своего градиента сразу переключает accent на custom.
function handleCustomAccentChange() {
  if (!panelFeatures.allowAccentChange) {
    return;
  }

  preferences.customAccentFrom = customAccentFromInput.value;
  preferences.customAccentTo = customAccentToInput.value;
  preferences.customAccentAngle = Number(customAccentAngleInput.value);
  preferences.accent = "custom";
  applyPreferences(preferences);
  savePreferences(preferences);
}

customAccentFromInput.addEventListener("input", handleCustomAccentChange);
customAccentToInput.addEventListener("input", handleCustomAccentChange);
customAccentAngleInput.addEventListener("input", handleCustomAccentChange);

// Показывает/скрывает номера в секциях, группах и карточках.
showNumbersInput.addEventListener("change", () => {
  if (!panelFeatures.allowShowNumbers) {
    return;
  }

  preferences.showNumbers = showNumbersInput.checked;
  applyPreferences(preferences);
  savePreferences(preferences);
});

// Показывает/скрывает поисковые теги в файловом дереве.
// Взаимоисключимо с двухколоночным режимом элементов папок.
showTreeTagsInput.addEventListener("change", () => {
  if (!panelFeatures.allowTreeOptions || preferences.navLayout === "top") {
    return;
  }

  preferences.showTreeTags = showTreeTagsInput.checked;
  if (preferences.showTreeTags) {
    preferences.treeTwoColumn = false;
  }
  applyPreferences(preferences);
  savePreferences(preferences);
});

// Компактный двухколоночный режим элементов внутри папок дерева.
// Взаимоисключимо с отображением тегов.
treeTwoColumnInput.addEventListener("change", () => {
  if (!panelFeatures.allowTreeOptions || preferences.navLayout === "top") {
    return;
  }

  preferences.treeTwoColumn = treeTwoColumnInput.checked;
  if (preferences.treeTwoColumn) {
    preferences.showTreeTags = false;
    if (preferences.sidebarWidth < 480) {
      preferences.sidebarWidth = 480;
    }
  }
  applyPreferences(preferences);
  savePreferences(preferences);
});

// Включает/выключает авто-раскрытие веток дерева при поиске.
autoCollapseSearchInput.addEventListener("change", () => {
  if (!panelFeatures.allowTreeOptions || preferences.navLayout === "top") {
    return;
  }

  preferences.autoCollapseSearch = autoCollapseSearchInput.checked;
  applyPreferences(preferences);
  renderNavigationTree();
  savePreferences(preferences);
});

// Drag-resize бокового меню.
// Ширина сохраняется в preferences.sidebarWidth и применяется через CSS-переменную.
sidebarResizer.addEventListener("pointerdown", (event) => {
  if (preferences.navLayout === "top" || !panelFeatures.allowSidebarResize) {
    return;
  }

  event.preventDefault();
  document.body.classList.add("is-resizing-sidebar");
  sidebarResizer.setPointerCapture(event.pointerId);

  const handlePointerMove = (moveEvent) => {
    const layoutLeft = document.querySelector(".app-layout").getBoundingClientRect().left;
    preferences.sidebarWidth = Math.round(
      clamp(moveEvent.clientX - layoutLeft, 260, getSidebarMaxWidth(preferences)),
    );
    applyPreferences(preferences);
  };

  const handlePointerUp = () => {
    document.body.classList.remove("is-resizing-sidebar");
    savePreferences(preferences);
    sidebarResizer.removeEventListener("pointermove", handlePointerMove);
    sidebarResizer.removeEventListener("pointerup", handlePointerUp);
    sidebarResizer.removeEventListener("pointercancel", handlePointerUp);
  };

  sidebarResizer.addEventListener("pointermove", handlePointerMove);
  sidebarResizer.addEventListener("pointerup", handlePointerUp);
  sidebarResizer.addEventListener("pointercancel", handlePointerUp);
});

// ============================================================================
// Panel config loading
// ============================================================================
async function loadPanelDataFromSettings(settings) {
  const dataUrl = typeof settings.dataUrl === "string" ? settings.dataUrl.trim() : "";

  let panelSource = settings.data;
  if (dataUrl) {
    panelSource = await fetchJson(dataUrl);
  }

  if (!panelSource || typeof panelSource !== "object") {
    throw new Error("settings.json должен содержать data или dataUrl");
  }

  return normalizePanelData(panelSource);
}

function applyOrganizationConfig(settings) {
  panelDefaults = normalizePreferences({
    ...defaultPreferences,
    ...(settings?.defaults && typeof settings.defaults === "object" ? settings.defaults : {}),
  });
  panelFeatures = {
    ...defaultPanelFeatures,
    ...(settings?.features && typeof settings.features === "object" ? settings.features : {}),
  };

  const placeholder =
    typeof settings?.defaults?.searchPlaceholder === "string"
      ? settings.defaults.searchPlaceholder.trim()
      : panelDefaults.searchPlaceholder;

  if (searchInput && placeholder) {
    searchInput.placeholder = placeholder;
  }
}

function normalizePreferences(raw) {
  const next = { ...raw };

  if (!availableViews.includes(next.view)) {
    next.view = defaultPreferences.view;
  }

  if (!availableAccents.includes(next.accent)) {
    next.accent = defaultPreferences.accent;
  }

  if (!availableNavLayouts.includes(next.navLayout)) {
    next.navLayout = defaultPreferences.navLayout;
  }

  next.customAccentFrom =
    normalizeHexColor(next.customAccentFrom) || defaultPreferences.customAccentFrom;
  next.customAccentTo = normalizeHexColor(next.customAccentTo) || defaultPreferences.customAccentTo;
  next.customAccentAngle = clamp(
    Number(next.customAccentAngle) || defaultPreferences.customAccentAngle,
    0,
    360,
  );
  next.showNumbers = Boolean(next.showNumbers);
  next.showTreeTags = Boolean(next.showTreeTags);
  next.treeTwoColumn = Boolean(next.treeTwoColumn);
  next.autoCollapseSearch = Boolean(next.autoCollapseSearch);
  next.sidebarWidth = clamp(
    Number(next.sidebarWidth) || defaultPreferences.sidebarWidth,
    260,
    getSidebarMaxWidth(next),
  );

  if (next.treeTwoColumn) {
    next.showTreeTags = false;
  } else if (next.showTreeTags) {
    next.treeTwoColumn = false;
  }

  if (next.navLayout === "top") {
    next.treeTwoColumn = false;
    next.showTreeTags = false;
  }

  return next;
}

function enforceFeatureLocks(rawPreferences) {
  const next = normalizePreferences(rawPreferences);

  if (!panelFeatures.allowNavLayoutChange) {
    next.navLayout = panelDefaults.navLayout;
  }

  if (!panelFeatures.allowThemeChange) {
    next.theme = panelDefaults.theme;
  }

  if (!panelFeatures.allowViewChange) {
    next.view = panelDefaults.view;
  }

  if (!panelFeatures.allowAccentChange) {
    next.accent = panelDefaults.accent;
    next.customAccentFrom = panelDefaults.customAccentFrom;
    next.customAccentTo = panelDefaults.customAccentTo;
    next.customAccentAngle = panelDefaults.customAccentAngle;
  }

  if (!panelFeatures.allowShowNumbers) {
    next.showNumbers = panelDefaults.showNumbers;
  }

  if (!panelFeatures.allowTreeOptions || next.navLayout === "top") {
    next.showTreeTags = false;
    next.treeTwoColumn = false;
    next.autoCollapseSearch = panelDefaults.autoCollapseSearch;
  }

  if (!panelFeatures.allowSidebarResize || next.navLayout === "top") {
    next.sidebarWidth = panelDefaults.sidebarWidth;
  }

  return next;
}

async function loadPanelConfig(settingsPath = SETTINGS_PATH) {
  const settings = await fetchJson(settingsPath);
  return loadPanelDataFromSettings(settings);
}

async function fetchJson(url) {
  const response = await fetch(url);

  if (!response.ok) {
    throw new Error(`Не удалось загрузить ${url}: HTTP ${response.status}`);
  }

  return response.json();
}

function normalizePanelData(raw) {
  const rootItems = Array.isArray(raw.items)
    ? raw.items.map((item, index) => normalizeItemFromConfig(item, index))
    : [];
  let sections = Array.isArray(raw.sections) ? raw.sections.map(normalizeSection) : [];

  // Корневой items[] без sections — плоский список карточек.
  if (!sections.length && rootItems.length) {
    sections = [
      {
        id: "root",
        number: "",
        title: typeof raw.title === "string" && raw.title.trim() ? raw.title.trim() : "Панель экосистемы",
        description: String(raw.description ?? ""),
        groups: [],
        items: rootItems,
        flat: true,
      },
    ];
  }

  if (!sections.length) {
    throw new Error("В данных панели нет sections или items");
  }

  const panelTitle =
    typeof raw.title === "string" && raw.title.trim()
      ? raw.title.trim()
      : sections[0]?.flat
        ? sections[0].title
        : "Панель экосистемы";

  return {
    title: panelTitle,
    sections,
    serviceMeta: {
      ...defaultServiceMeta,
      ...(raw.serviceMeta && typeof raw.serviceMeta === "object" ? raw.serviceMeta : {}),
    },
  };
}

function normalizeSection(section) {
  if (!section?.id || !section?.title) {
    throw new Error("Каждый section должен содержать id и title");
  }

  const groups = Array.isArray(section.groups) ? section.groups.map(normalizeGroup) : [];
  const items = Array.isArray(section.items)
    ? section.items.map((item, index) => normalizeItemFromConfig(item, index))
    : [];

  if (!groups.length && !items.length) {
    throw new Error(`Раздел "${section.title}" должен содержать groups или items`);
  }

  return {
    id: String(section.id),
    number: String(section.number ?? ""),
    title: String(section.title),
    description: String(section.description ?? ""),
    groups,
    items,
    flat: Boolean(section.flat),
  };
}

function normalizeGroup(group) {
  if (!group?.id || !group?.title) {
    throw new Error("Каждый group должен содержать id и title");
  }

  return {
    id: String(group.id),
    number: String(group.number ?? ""),
    title: String(group.title),
    description: String(group.description ?? ""),
    items: Array.isArray(group.items) ? group.items.map(normalizeItemFromConfig) : [],
  };
}

function normalizeItemFromConfig(item, index = 0) {
  if (!item?.title || !item?.type) {
    throw new Error("Каждый item должен содержать title и type");
  }

  const itemKey = item.id
    ? String(item.id)
    : item.number
      ? String(item.number)
      : `auto-${index}-${slugifyItemKey(item.title)}`;

  return {
    itemKey,
    number: String(item.number ?? ""),
    title: String(item.title),
    type: String(item.type),
    tags: Array.isArray(item.tags) ? item.tags.map(String) : [],
    url: typeof item.url === "string" && item.url.trim() ? item.url.trim() : "#",
    icon: typeof item.icon === "string" && item.icon.trim() ? item.icon.trim() : "",
  };
}

function getItemMeta(item) {
  const typeMeta = serviceMeta[item.type] || serviceMeta.config;

  if (item.icon) {
    return {
      label: typeMeta.label,
      icon: item.icon,
    };
  }

  return typeMeta;
}

function slugifyItemKey(value) {
  return normalize(String(value))
    .replace(/[^a-z0-9\u0430-\u044f\u0451]+/g, "-")
    .replace(/^-+|-+$/g, "") || "item";
}

function showConfigError(error) {
  const message = error instanceof Error ? error.message : String(error);
  navTree.replaceChildren();
  catalog.replaceChildren();

  if (configErrorTemplate) {
    const node = configErrorTemplate.content.cloneNode(true);
    node.querySelector("[data-config-error-message]").textContent =
      `${message}. Проверь settings.json и доступность dataUrl.`;
    catalog.append(node);
    return;
  }

  catalog.textContent = message;
}

// ============================================================================
// Data helpers
// ============================================================================
// Упрощает запись item-объектов при ручной правке JS (legacy helper).
function createItem(number, title, type, tags = [], url = "#") {
  return normalizeItemFromConfig({ number, title, type, tags, url }, 0);
}

// ============================================================================
// Catalog rendering
// ============================================================================
// Рендерит правую часть: details-разделы, details-подразделы и карточки.
// При активном поиске:
// - оставляет только группы с найденными элементами;
// - принудительно раскрывает найденные ветки;
// - подсвечивает совпадения через highlightText().
function renderCatalog() {
  const query = normalize(searchInput.value);
  const forceOpen = Boolean(query);
  const fragment = document.createDocumentFragment();
  let visibleItems = 0;

  ecosystemSections.forEach((section) => {
    if (section.flat && !section.groups.length) {
      const filteredItems = section.items.filter((item) => matchesQuery(item, null, section, query));

      if (!filteredItems.length) {
        return;
      }

      fragment.append(createItemsGridElement(filteredItems, query, "items-grid catalog-flat-grid"));
      visibleItems += filteredItems.length;
      return;
    }

    const sectionElement = createSectionElement(section, forceOpen, query);
    let sectionVisibleItems = 0;
    const sectionContainer = sectionElement.querySelector(".section-groups");

    const filteredDirectItems = section.items.filter((item) => matchesQuery(item, null, section, query));
    if (filteredDirectItems.length) {
      sectionVisibleItems += filteredDirectItems.length;
      sectionContainer.append(createItemsGridElement(filteredDirectItems, query));
    }

    section.groups.forEach((group) => {
      const filteredItems = group.items.filter((item) => matchesQuery(item, group, section, query));

      if (!filteredItems.length) {
        return;
      }

      sectionVisibleItems += filteredItems.length;
      sectionContainer.append(createGroupElement(group, filteredItems, forceOpen, query));
    });

    if (sectionVisibleItems) {
      sectionElement.querySelector("[data-section-count]").textContent = sectionVisibleItems;
      fragment.append(sectionElement);
      visibleItems += sectionVisibleItems;
    }
  });

  catalog.replaceChildren();

  if (visibleItems) {
    catalog.append(fragment);
    attachCardInteractions();
  } else {
    catalog.append(emptyTemplate.content.cloneNode(true));
  }
}

function createItemsGridElement(items, query = "", className = "items-grid") {
  const grid = document.createElement("div");
  grid.className = className;
  grid.append(...items.map((item) => createCardElement(item, query)));
  return grid;
}

// Создает корневой details для раздела контента.
// forceOpen нужен для поиска: найденные ветки должны быть видимы независимо
// от сохраненного collapsed-состояния.
function createSectionElement(section, forceOpen = false, query = "") {
  const sectionElement = document.createElement("details");
  sectionElement.className = "catalog-section";
  sectionElement.id = getSectionId(section);
  sectionElement.dataset.collapseKey = sectionElement.id;
  sectionElement.tabIndex = -1;
  sectionElement.open = forceOpen || getSavedOpenState(sectionElement.dataset.collapseKey);
  sectionElement.innerHTML = `
    <summary class="section-head">
      <div>
        <p class="section-number">${highlightText(section.number, query)} раздел</p>
        <h2>${highlightText(section.title, query)}</h2>
        <p>${highlightText(section.description, query)}</p>
      </div>
      <span class="section-meta">
        <span class="section-count"><span data-section-count>0</span> элементов</span>
        <span class="collapse-indicator" aria-hidden="true">⌄</span>
      </span>
    </summary>
    <div class="section-groups"></div>
  `;
  return sectionElement;
}

// Создает details-подраздел внутри раздела.
// items уже отфильтрованы на уровне renderCatalog().
function createGroupElement(group, items, forceOpen = false, query = "") {
  const groupElement = document.createElement("details");
  groupElement.className = "catalog-group";
  groupElement.id = getGroupId(group);
  groupElement.dataset.collapseKey = groupElement.id;
  groupElement.tabIndex = -1;
  groupElement.open = forceOpen || getSavedOpenState(groupElement.dataset.collapseKey);

  const cards = items.map((item) => createCardElement(item, query));
  groupElement.innerHTML = `
    <summary class="group-head">
      <div>
        <p class="group-number">${highlightText(group.number, query)}</p>
        <h3>${highlightText(group.title, query)}</h3>
        <p>${highlightText(group.description, query)}</p>
      </div>
      <span class="group-meta">
        <span class="group-count">${items.length}</span>
        <span class="collapse-indicator" aria-hidden="true">⌄</span>
      </span>
    </summary>
  `;

  const grid = document.createElement("div");
  grid.className = "items-grid";
  grid.append(...cards);
  groupElement.append(grid);

  return groupElement;
}

// Создает конечную карточку навигации.
// Если url === "#", карточка считается заглушкой и не меняет текущий hash/scroll.
function createCardElement(item, query = "") {
  const meta = getItemMeta(item);
  const link = document.createElement("a");
  link.className = "nav-card";
  link.href = item.url;
  link.id = getItemId(item);
  link.dataset.type = item.type;

  if (item.url === "#") {
    link.setAttribute("aria-label", `${item.title}: URL еще не настроен`);
    link.addEventListener("click", (event) => event.preventDefault());
  } else {
    link.target = "_blank";
    link.rel = "noopener noreferrer";
  }

  link.innerHTML = `
    <span class="shine"></span>
    <img src="${resolveAssetPath(meta.icon)}" alt="" loading="lazy" />
    <div class="card-content">
      <p class="item-number">${highlightText(item.number, query)}</p>
      <h4>${highlightText(item.title, query)}</h4>
      <p class="item-type">${highlightText(meta.label, query)}</p>
      <div class="tags">${item.tags.map((tag) => `<span>${highlightText(tag, query)}</span>`).join("")}</div>
    </div>
    <span class="arrow" aria-hidden="true">→</span>
  `;

  return link;
}

// ============================================================================
// Search matching and highlighting
// ============================================================================
// Проверяет, подходит ли конкретный item под строку поиска.
// Поиск идет не только по title, но и по номеру, type, label, tags и родителям.
function matchesQuery(item, group, section, query) {
  if (!query) {
    return true;
  }

  const meta = serviceMeta[item.type] || serviceMeta.config;
  const haystack = normalize(
    [
      item.number,
      item.title,
      item.type,
      meta.label,
      item.tags.join(" "),
      group?.title ?? "",
      group?.description ?? "",
      section.title,
    ].join(" "),
  );

  return haystack.includes(query);
}

function sectionMatchesQuery(section, query) {
  if (!query) {
    return true;
  }

  return (
    matchesText([section.number, section.title, section.description], query) ||
    section.items.some((item) => matchesQuery(item, null, section, query)) ||
    section.groups.some((group) => groupMatchesQuery(group, section, query))
  );
}

// Проверяет, есть ли совпадение на уровне группы или ее элементов.
// Используется для авто-раскрытия дерева при поиске.
function groupMatchesQuery(group, section, query) {
  if (!query) {
    return true;
  }

  return (
    matchesText([group.number, group.title, group.description, section.title], query) ||
    group.items.some((item) => matchesQuery(item, group, section, query))
  );
}

// Проверяет произвольный набор строк на наличие нормализованного query.
function matchesText(values, query) {
  if (!query) {
    return true;
  }

  return normalize(values.join(" ")).includes(query);
}

// ============================================================================
// Sidebar tree rendering
// ============================================================================
// Строит левое файловое дерево из той же структуры данных, что и каталог.
// Это важно: дерево и карточки всегда остаются синхронизированными.
function renderNavigationTree() {
  if (preferences.navLayout === "top") {
    navTree.replaceChildren();
    return;
  }

  const query = normalize(searchInput.value);
  const shouldAutoCollapse = Boolean(query && preferences.autoCollapseSearch);
  const fragment = document.createDocumentFragment();

  ecosystemSections.forEach((section) => {
    if (section.flat && !section.groups.length) {
      const filteredItems = section.items.filter((item) => matchesQuery(item, null, section, query));

      if (!filteredItems.length) {
        return;
      }

      fragment.append(createTreeItemList(filteredItems, query));
      return;
    }

    const sectionHasMatches = sectionMatchesQuery(section, query);
    const sectionNode = document.createElement("details");
    sectionNode.className = "tree-section";
    sectionNode.dataset.collapseKey = getTreeSectionId(section);
    sectionNode.open = shouldAutoCollapse ? sectionHasMatches : getSavedOpenState(sectionNode.dataset.collapseKey);

    const sectionSummary = document.createElement("summary");
    sectionSummary.innerHTML = `
      <span class="tree-caret" aria-hidden="true"></span>
      <button class="tree-node tree-folder" type="button" data-focus-target="${getSectionId(section)}">
        <span>${highlightText(section.title, query)}</span>
      </button>
    `;
    sectionNode.append(sectionSummary);

    const filteredDirectItems = section.items.filter((item) => matchesQuery(item, null, section, query));
    if (filteredDirectItems.length) {
      sectionNode.append(createTreeItemList(filteredDirectItems, query, "tree-items tree-items-direct"));
    }

    section.groups.forEach((group) => {
      const groupHasMatches = groupMatchesQuery(group, section, query);
      const groupNode = document.createElement("details");
      groupNode.className = "tree-group";
      groupNode.dataset.collapseKey = getTreeGroupId(group);
      groupNode.open = shouldAutoCollapse ? groupHasMatches : getSavedOpenState(groupNode.dataset.collapseKey);

      const groupSummary = document.createElement("summary");
      groupSummary.innerHTML = `
        <span class="tree-caret" aria-hidden="true"></span>
        <button class="tree-node tree-folder" type="button" data-focus-target="${getGroupId(group)}">
          <span>${highlightText(group.title, query)}</span>
        </button>
      `;
      groupNode.append(groupSummary);
      groupNode.append(createTreeItemList(group.items.filter((item) => matchesQuery(item, group, section, query)), query));
      sectionNode.append(groupNode);
    });

    fragment.append(sectionNode);
  });

  navTree.replaceChildren(fragment);
}

function createTreeItemList(items, query = "", className = "tree-items") {
  const itemList = document.createElement("div");
  itemList.className = className;

  items.forEach((item) => {
    const meta = getItemMeta(item);
    const itemButton = document.createElement("button");
    itemButton.type = "button";
    itemButton.className = "tree-node tree-file";
    itemButton.dataset.focusTarget = getItemId(item);
    itemButton.innerHTML = `
      <img class="tree-node-icon" src="${resolveAssetPath(meta.icon)}" alt="" loading="lazy" />
      <span>${highlightText(item.title, query)}</span>
      <small>${highlightText(item.tags.join(", "), query)}</small>
    `;
    itemList.append(itemButton);
  });

  return itemList;
}

// ============================================================================
// Focusing from tree to content
// ============================================================================
// Переход из дерева к правому контенту:
// - если текущий поиск скрывает цель, поиск очищается;
// - родительские details раскрываются;
// - состояние раскрытия сохраняется;
// - целевой элемент скроллится в центр и подсвечивается.
function focusCatalogTarget(targetId) {
  let target = document.getElementById(targetId);

  if (!target) {
    searchInput.value = "";
    renderCatalog();
    target = document.getElementById(targetId);
  }

  if (!target) {
    return;
  }

  target.closest(".catalog-section")?.setAttribute("open", "");
  target.closest(".catalog-group")?.setAttribute("open", "");
  persistOpenedAncestor(target.closest(".catalog-section"));
  persistOpenedAncestor(target.closest(".catalog-group"));
  target.scrollIntoView({ behavior: "smooth", block: "center" });
  target.focus({ preventScroll: true });
  target.classList.add("is-focused");
  window.setTimeout(() => target.classList.remove("is-focused"), 1200);
}

// ============================================================================
// Collapse state handling
// ============================================================================
// Сохраняет состояние каждого details, у которого есть data-collapse-key.
function handleDetailsToggle(event) {
  const details = event.target;

  if (!(details instanceof HTMLDetailsElement) || !details.dataset.collapseKey) {
    return;
  }

  collapseState[details.dataset.collapseKey] = details.open;
  saveCollapseState();
}

// Принудительно сохраняет родительский details как раскрытый.
// Используется, когда пользователь прыгает к элементу из дерева.
function persistOpenedAncestor(details) {
  if (!details?.dataset.collapseKey) {
    return;
  }

  collapseState[details.dataset.collapseKey] = true;
  saveCollapseState();
}

// ============================================================================
// Card pointer interaction
// ============================================================================
// Добавляет мягкий tilt/highlight эффект для карточек.
// После каждого renderCatalog() обработчики нужно навешивать заново,
// потому что карточки пересоздаются.
function attachCardInteractions() {
  document.querySelectorAll(".nav-card").forEach((card) => {
    let leaveTimer;

    card.addEventListener("pointerenter", () => {
      window.clearTimeout(leaveTimer);
      card.classList.add("is-hovered");
    });

    card.addEventListener("pointermove", (event) => {
      window.clearTimeout(leaveTimer);
      card.classList.add("is-hovered");

      const rect = card.getBoundingClientRect();
      const xPercent = clamp(((event.clientX - rect.left) / rect.width) * 100, 8, 92);
      const yPercent = clamp(((event.clientY - rect.top) / rect.height) * 100, 8, 92);
      const rotateY = ((xPercent - 50) / 50) * 2.4;
      const rotateX = ((50 - yPercent) / 50) * 2.4;

      card.style.setProperty("--card-x", `${xPercent}%`);
      card.style.setProperty("--card-y", `${yPercent}%`);
      card.style.setProperty("--tilt-x", `${rotateX}deg`);
      card.style.setProperty("--tilt-y", `${rotateY}deg`);
    });

    card.addEventListener("pointerleave", () => {
      leaveTimer = window.setTimeout(() => {
        card.classList.remove("is-hovered");
        card.style.setProperty("--card-x", "50%");
        card.style.setProperty("--card-y", "50%");
        card.style.setProperty("--tilt-x", "0deg");
        card.style.setProperty("--tilt-y", "0deg");
      }, 80);
    });
  });
}

// ============================================================================
// Preferences application
// ============================================================================
// Применяет preferences к DOM:
// - data-theme / data-accent для CSS;
// - CSS-переменную ширины сайдбара;
// - класс режима отображения каталога;
// - состояния toggle-контролов в настройках.
function applyPreferences(nextPreferences) {
  const lockedPreferences = enforceFeatureLocks(nextPreferences);
  Object.assign(preferences, lockedPreferences);
  const activePreferences = preferences;

  document.documentElement.dataset.theme = activePreferences.theme;
  document.documentElement.dataset.accent = activePreferences.accent;
  document.documentElement.dataset.navLayout =
    activePreferences.navLayout === "top" ? "top" : "sidebar";
  applyAccentVariables(activePreferences);
  document.documentElement.style.setProperty(
    "--sidebar-width",
    `${clamp(
      Number(activePreferences.sidebarWidth) || defaultPreferences.sidebarWidth,
      260,
      getSidebarMaxWidth(activePreferences),
    )}px`,
  );
  document.documentElement.style.setProperty(
    "--shell-max-width",
    activePreferences.treeTwoColumn ? "1920px" : "1560px",
  );
  document.documentElement.style.setProperty(
    "--sidebar-max-width",
    `${getSidebarMaxWidth(activePreferences)}px`,
  );
  catalog.classList.remove("cards-view", "list-view", "compact-cards-view", "compact-list-view");
  catalog.classList.add(`${activePreferences.view}-view`);
  document.documentElement.dataset.showNumbers = String(Boolean(activePreferences.showNumbers));
  document.documentElement.dataset.showTreeTags = String(Boolean(activePreferences.showTreeTags));
  document.documentElement.dataset.treeTwoColumn = String(Boolean(activePreferences.treeTwoColumn));
  showNumbersInput.checked = Boolean(activePreferences.showNumbers);
  showTreeTagsInput.checked = Boolean(activePreferences.showTreeTags);
  treeTwoColumnInput.checked = Boolean(activePreferences.treeTwoColumn);
  autoCollapseSearchInput.checked = Boolean(activePreferences.autoCollapseSearch);
  customAccentFromInput.value = activePreferences.customAccentFrom;
  customAccentToInput.value = activePreferences.customAccentTo;
  customAccentAngleInput.value = String(activePreferences.customAccentAngle);
  customAccentAngleValue.textContent = `${activePreferences.customAccentAngle}°`;
  accentCustomPanel.hidden = activePreferences.accent !== "custom";
  updateCustomAccentPreview(activePreferences);
  setActiveButton(themeButtons, "theme", activePreferences.theme);
  setActiveButton(navLayoutButtons, "navLayout", activePreferences.navLayout);
  setActiveButton(viewButtons, "view", activePreferences.view);
  setActiveButton(accentButtons, "accent", activePreferences.accent);
  applyPanelFeatures(activePreferences);
}

function applyPanelFeatures(activePreferences) {
  settingsSections.forEach((section) => {
    const featureName = section.dataset.settingsSection;
    section.hidden = !isSettingsSectionVisible(featureName, activePreferences);
  });

  if (searchField) {
    searchField.hidden = !panelFeatures.allowSearch;
  }

  if (navTree) {
    navTree.hidden = activePreferences.navLayout === "top";
  }

  if (sidebarResizer) {
    sidebarResizer.hidden =
      activePreferences.navLayout === "top" || !panelFeatures.allowSidebarResize;
  }

  if (appLayout) {
    appLayout.dataset.navLayout = activePreferences.navLayout === "top" ? "top" : "sidebar";
  }

  document.querySelectorAll("[data-feature]").forEach((element) => {
    const featureName = element.dataset.feature;
    element.hidden = featureName ? !panelFeatures[featureName] : false;
  });
}

function isSettingsSectionVisible(sectionName, activePreferences) {
  switch (sectionName) {
    case "layout":
      return panelFeatures.allowNavLayoutChange;
    case "catalog":
      return panelFeatures.allowViewChange || panelFeatures.allowShowNumbers;
    case "tree":
      return panelFeatures.allowTreeOptions && activePreferences.navLayout !== "top";
    case "appearance":
      return panelFeatures.allowThemeChange || panelFeatures.allowAccentChange;
    default:
      return true;
  }
}

// Применяет CSS-переменные акцента для пресетов или пользовательского градиента.
function applyAccentVariables(nextPreferences) {
  const root = document.documentElement;

  if (nextPreferences.accent === "custom") {
    root.style.setProperty("--accent", nextPreferences.customAccentFrom);
    root.style.setProperty("--accent-2", nextPreferences.customAccentTo);
    root.style.setProperty("--accent-angle", `${nextPreferences.customAccentAngle}deg`);

    const rgb = hexToRgb(nextPreferences.customAccentFrom);
    if (rgb) {
      root.style.setProperty("--accent-rgb", `${rgb.r}, ${rgb.g}, ${rgb.b}`);
    }

    return;
  }

  root.style.removeProperty("--accent");
  root.style.removeProperty("--accent-2");
  root.style.removeProperty("--accent-rgb");
  root.style.removeProperty("--accent-angle");
}

// Обновляет превью пользовательского градиента в настройках и на кнопке custom.
function updateCustomAccentPreview(nextPreferences) {
  const gradient = `linear-gradient(${nextPreferences.customAccentAngle}deg, ${nextPreferences.customAccentFrom}, ${nextPreferences.customAccentTo})`;
  customAccentPreview.style.background = gradient;

  const customSwatch = document.querySelector('[data-accent="custom"]');
  if (customSwatch) {
    customSwatch.style.setProperty("--custom-accent-from", nextPreferences.customAccentFrom);
    customSwatch.style.setProperty("--custom-accent-to", nextPreferences.customAccentTo);
    customSwatch.style.setProperty("--custom-accent-angle", `${nextPreferences.customAccentAngle}deg`);
  }
}

// Приводит hex-цвет к формату #rrggbb для input[type="color"].
function normalizeHexColor(value) {
  if (typeof value !== "string") {
    return null;
  }

  const normalized = value.trim().toLowerCase();

  if (/^#[0-9a-f]{6}$/.test(normalized)) {
    return normalized;
  }

  if (/^#[0-9a-f]{3}$/.test(normalized)) {
    return `#${normalized[1]}${normalized[1]}${normalized[2]}${normalized[2]}${normalized[3]}${normalized[3]}`;
  }

  return null;
}

// Конвертирует hex в RGB для CSS-переменной --accent-rgb.
function hexToRgb(value) {
  const hex = normalizeHexColor(value);

  if (!hex) {
    return null;
  }

  return {
    r: Number.parseInt(hex.slice(1, 3), 16),
    g: Number.parseInt(hex.slice(3, 5), 16),
    b: Number.parseInt(hex.slice(5, 7), 16),
  };
}

// Обновляет визуальное состояние группы кнопок.
function setActiveButton(buttons, key, value) {
  buttons.forEach((button) => {
    const isActive = button.dataset[key] === value;
    button.classList.toggle("is-active", isActive);
    button.setAttribute("aria-pressed", String(isActive));
  });
}

// ============================================================================
// Generic helpers
// ============================================================================
// Нормализует строки для поиска: регистр + ё/е.
function normalize(value) {
  return value.toLowerCase().replaceAll("ё", "е").trim();
}

// Подсвечивает все совпадения query внутри value.
// Возвращает HTML-строку, поэтому весь обычный текст пропускается через escapeHTML().
function highlightText(value, query) {
  const text = String(value);
  const normalizedQuery = normalize(query);

  if (!normalizedQuery) {
    return escapeHTML(text);
  }

  const normalizedText = normalize(text);
  let cursor = 0;
  let result = "";
  let matchIndex = normalizedText.indexOf(normalizedQuery, cursor);

  while (matchIndex !== -1) {
    result += escapeHTML(text.slice(cursor, matchIndex));
    result += `<mark class="search-mark">${escapeHTML(text.slice(matchIndex, matchIndex + normalizedQuery.length))}</mark>`;
    cursor = matchIndex + normalizedQuery.length;
    matchIndex = normalizedText.indexOf(normalizedQuery, cursor);
  }

  return result + escapeHTML(text.slice(cursor));
}

// Минимальная HTML-экранизация для безопасной вставки строк в innerHTML.
function escapeHTML(value) {
  return String(value)
    .replaceAll("&", "&amp;")
    .replaceAll("<", "&lt;")
    .replaceAll(">", "&gt;")
    .replaceAll('"', "&quot;")
    .replaceAll("'", "&#039;");
}

// Стабильные id для секций, групп и элементов.
// Они используются одновременно как DOM id и как цель tree focus.
function getSectionId(section) {
  return `section-${section.id}`;
}

function getGroupId(group) {
  return `group-${group.id}`;
}

// Отдельные ключи для дерева, чтобы collapse-состояния дерева
// не конфликтовали с collapse-состояниями контента.
function getTreeSectionId(section) {
  return `tree-${getSectionId(section)}`;
}

function getTreeGroupId(group) {
  return `tree-${getGroupId(group)}`;
}

function getItemId(item) {
  return `item-${String(item.itemKey).replaceAll(".", "-")}`;
}

// Ограничивает число диапазоном.
function clamp(value, min, max) {
  return Math.min(Math.max(value, min), max);
}

// Максимальная ширина sidebar зависит от режима дерева.
function getSidebarMaxWidth(nextPreferences) {
  return nextPreferences.treeTwoColumn ? 760 : 560;
}

// ============================================================================
// localStorage helpers
// ============================================================================
// Читает настройки интерфейса.
function readPreferences() {
  try {
    return JSON.parse(localStorage.getItem(STORAGE_KEY)) || {};
  } catch {
    return {};
  }
}

// Сохраняет настройки интерфейса.
function savePreferences(nextPreferences) {
  localStorage.setItem(STORAGE_KEY, JSON.stringify(nextPreferences));
}

// Возвращает сохраненное состояние details.
// По умолчанию все ветки открыты, чтобы первый вход был максимально понятным.
function getSavedOpenState(key) {
  return collapseState[key] ?? true;
}

// Читает состояния раскрытия дерева/контента.
function readCollapseState() {
  try {
    return JSON.parse(localStorage.getItem(COLLAPSE_STORAGE_KEY)) || {};
  } catch {
    return {};
  }
}

// Сохраняет состояния раскрытия дерева/контента.
function saveCollapseState() {
  localStorage.setItem(COLLAPSE_STORAGE_KEY, JSON.stringify(collapseState));
}

// Закрывает popup-настройки и синхронизирует aria-expanded.
function closeSettingsPanel() {
  settingsPanel.classList.remove("is-open");
  settingsOverlay.classList.remove("is-open");
  settingsToggle.setAttribute("aria-expanded", "false");
}