Модуль:Prototypes/Хранилище/Предмет: различия между версиями

Материал из Space Station 14 Вики
мНет описания правки
мНет описания правки
(не показаны 93 промежуточные версии этого же участника)
Строка 1: Строка 1:
local p = {}
---------------------------------------------------------------------
-- Предварительная загрузка данных
local itemData          = mw.loadData("Модуль:IanComradeBot/prototypes/fills/Item.json/data")
local itemSlotsData    = mw.loadData("Модуль:IanComradeBot/prototypes/ItemSlots.json/data")
local itemStackData    = mw.loadData("Модуль:IanComradeBot/prototypes/fills/stack.json/data")
local chemTranslateData = mw.loadData("Модуль:IanComradeBot/chem prototypes.json/data")
local tableData        = mw.loadData("Модуль:IanComradeBot/prototypes/table.json/data")


-- Функции как локальные переменные
---------------------------------------------------------------------
local loadData, findDataById, formatContent, getContentsOutput, processNestedSelectors, getTableOutput, getContainedOutput, getChemOutput, handleGroupSelector, handleAllSelector, handleNestedSelector
-- Функция поиска данных по ID
local function findDataById(data, id)
    if not data then
        return nil
    end


-- Функция для загрузки данных
     if data[id] then
loadData = function(filePath)
        return data[id]
     local page = mw.title.new(filePath)
     end
    local content = page:getContent()
     return content and mw.text.jsonDecode(content) or nil
end


-- Поиск данных по ID
    if type(data) == "table" then
findDataById = function(data, id)
        -- Если таблица массивная, то перебираем по порядку, иначе по парам
    if not data then return nil end
        local iterFunc = (#data > 0) and ipairs or pairs
    for _, item in ipairs(data) do
        for _, item in iterFunc(data) do
        if item.id == id then
            if type(item) == "table" and item.id == id then
            return item
                return item
            end
         end
         end
     end
     end
Строка 22: Строка 30:
end
end


-- Форматирование одного содержимого
---------------------------------------------------------------------
formatContent = function(content)
-- Форматирование содержимого
     if not content.id then
local function formatContent(content)
     if type(content) == "table" and not content.id then
         return "Ошибка: отсутствует id у элемента."
         return "Ошибка: отсутствует id у элемента."
     end
     end


     local name = string.format('{{#invoke:Entity Lookup|getname|%s}}', content.id)
     local id = content.id or content
    local image = string.format('%s.png', content.id)
     local amountNumber = 1
    local amount = content.amount and string.format(" [%d]", content.amount) or ""
     local prob = ""


     -- Если есть weight, преобразуем его в prob
     if content.amount then
    if content.weight then
        if type(content.amount) == "table" then
        content.prob = content.weight / 100
            amountNumber = content.amount.value or 1
        else
            amountNumber = content.amount
        end
     end
     end
    local amount = (amountNumber and amountNumber ~= 1) and string.format(" [%d]", amountNumber) or ""


     -- Если есть prob, формируем отображение процента
     local prob = ""
    local probValue = nil
     if content.prob then
     if content.prob then
         local percentage = content.prob * 100
         probValue = content.prob * 100 -- перевод в проценты
         if percentage >= 1 then
    elseif content.weight then
            prob = string.format(" <div>%d%%</div>", math.floor(percentage))
         probValue = content.weight
        else
    end
            prob = string.format(" <div>%g%%</div>", percentage)
    if probValue then
        end
        prob = string.format("%s%%", (probValue >= 1) and math.floor(probValue) or probValue)
     end
     end


     return string.format(
     return string.format('{{#invoke:Предмет|main|%s|%s<span>%s</span>|repository=1|wrapper=1}}', id, amount, prob)
        '{{LinkСard|SideStyle=1|background-color=#cbcbff0b|image=%s|name=%s%s%s {{#invoke:Prototypes/Хранилище/Предмет|main|framing|contained|%s}} }}',
        image, name, amount, prob, content.id
    )
end
end


-- Получение содержимого
---------------------------------------------------------------------
getContentsOutput = function(contents)
-- Обработка списка элементов (не таблицы, а прямой список содержимого)
     local result = ''
local function getContentsOutput(contents)
     local result = {}
     for _, content in ipairs(contents) do
     for _, content in ipairs(contents) do
         result = result .. formatContent(content)
         result[#result + 1] = formatContent(content)
     end
     end
     return result
     return table.concat(result)
end
end


-- Обработка вложенных таблиц
---------------------------------------------------------------------
processNestedSelectors = function(children)
-- Универсальная функция обхода детей с учётом рекурсии и кеширования (visited)
     local result = ''
local function processChildren(children, visited)
    visited = visited or {}
    if not children then return "" end
 
     local result = {}
     for _, child in ipairs(children) do
     for _, child in ipairs(children) do
         if child.id then
         if child.id then
             result = result .. formatContent(child)
             if not visited[child.id] then
         elseif child["!type"] == "NestedSelector" and child.tableId then
                result[#result + 1] = formatContent(child)
             result = result .. handleNestedSelector(child)
            end
         elseif child["!type"] == "NestedSelector" then
             result[#result + 1] = handleNestedSelector(child, true, visited)
         elseif child["!type"] == "GroupSelector" then
         elseif child["!type"] == "GroupSelector" then
             result = result .. handleGroupSelector(child)
             result[#result + 1] = handleGroupSelector(child, visited)
        elseif child["!type"] == "AllSelector" then
            result[#result + 1] = handleAllSelector(child)
         end
         end
     end
     end
     return result
     return table.concat(result)
end
end


-- Обработка таблиц
---------------------------------------------------------------------
getTableOutput = function(tableId)
-- Получение содержимого таблицы по tableId с кешированием
     local allSelectors = loadData('User:IanComradeBot/prototypes/AllSelector.json')
local function getTableOutput(tableId, visited)
     local tableData = findDataById(allSelectors, tableId)
     visited = visited or {}
    if visited[tableId] then return "" end
    visited[tableId] = true
 
     local tableDataIndex = findDataById(tableData, tableId)
    if not tableDataIndex then
        return 'Таблица не найдена.'
    end


     if not tableData then return 'Таблица не найдена.' end
     if tableDataIndex['!type:GroupSelector'] then
        return handleGroupSelector(tableDataIndex['!type:GroupSelector'], visited)
    elseif tableDataIndex['!type:AllSelector'] then
        return processChildren(tableDataIndex['!type:AllSelector'].children, visited)
    end


     if tableData['!type:GroupSelector'] and tableData['!type:GroupSelector'].children then
     return 'Таблица не содержит элементов.'
         return handleGroupSelector(tableData['!type:GroupSelector'])
end
    elseif tableData['!type:AllSelector'] and tableData['!type:AllSelector'].children then
 
        return processNestedSelectors(tableData['!type:AllSelector'].children)
---------------------------------------------------------------------
    else
-- Универсальная функция обработки детей контейнеров
         return 'Таблица не содержит элементов.'
local function processContainerChildren(children, visited)
    local result = {}
    if children then
         for _, child in ipairs(children) do
            if child.id then
                result[#result + 1] = formatContent(child)
            elseif child["!type"] == "GroupSelector" then
                result[#result + 1] = handleGroupSelector(child, visited)
            elseif child["!type"] == "AllSelector" then
                result[#result + 1] = processChildren(child.children, visited)
            end
         end
     end
     end
    return table.concat(result)
end
end


---------------------------------------------------------------------
-- Формирование списка содержащихся предметов или таблиц
-- Формирование списка содержащихся предметов или таблиц
getContainedOutput = function(data, id, wrapped)
local function getContainedOutput(itemData, id, visited)
     local item = findDataById(data, id)
    visited = visited or {}
     if not item then return '' end
    if visited[id] then return "" end
    visited[id] = true
 
     local item = findDataById(itemData, id)
     if not item then  
        return ""
    end


     local result = ''
     local result = {}


    -- Обработка StorageFill
     if item.StorageFill and item.StorageFill.contents then
     if item.StorageFill and item.StorageFill.contents then
         result = result .. getContentsOutput(item.StorageFill.contents)
         result[#result + 1] = getContentsOutput(item.StorageFill.contents)
 
    -- Обработка EntityTableContainerFill
     elseif item.EntityTableContainerFill and item.EntityTableContainerFill.containers then
     elseif item.EntityTableContainerFill and item.EntityTableContainerFill.containers then
         local containers = item.EntityTableContainerFill.containers
         local containers = item.EntityTableContainerFill.containers
        -- Обработка entity_storage
         if containers.entity_storage then
         if containers.entity_storage then
             local children = containers.entity_storage.children
             result[#result + 1] = processContainerChildren(containers.entity_storage.children, visited)
 
            -- Если есть `children`, обрабатываем их
            if children then
                for _, child in ipairs(children) do
                    if child["!type"] == "NestedSelector" and child.tableId then
                        result = result .. handleNestedSelector(child)
                    elseif child["!type"] == "GroupSelector" then
                        result = result .. handleGroupSelector(child)
                    elseif child["!type"] == "AllSelector" then
                        result = result .. handleAllSelector(child)
                    elseif child.id then
                        result = result .. formatContent(child)
                    end
                end
            end
 
            -- Если указан tableId
             if containers.entity_storage.tableId then
             if containers.entity_storage.tableId then
                 result = result .. getTableOutput(containers.entity_storage.tableId)
                 result[#result + 1] = getTableOutput(containers.entity_storage.tableId, visited)
             end
             end
         end
         end
 
         if containers.storagebase then
         -- Обработка storagebase
            result[#result + 1] = processContainerChildren(containers.storagebase.children, visited)
        if containers.storagebase and containers.storagebase.tableId then
            if containers.storagebase.tableId then
            result = result .. getTableOutput(containers.storagebase.tableId)
                result[#result + 1] = getTableOutput(containers.storagebase.tableId, visited)
            end
         end
         end
     end
     end
    return table.concat(result)
end


     return result
---------------------------------------------------------------------
-- Обработка AllSelector
function handleAllSelector(allSelector)
     if not allSelector.children then return "" end
    return processChildren(allSelector.children)
end
end


-- Обработка AllSelector
---------------------------------------------------------------------
handleAllSelector = function(allSelector)
-- Обработка GroupSelector
     local result = ''
function handleGroupSelector(groupSelector, visited)
     if not allSelector.children then return result end
    visited = visited or {}
    if not groupSelector.children then return "" end
 
     local result = {}
    local wrapperStart, wrapperEnd = "", ""
    if groupSelector.weight and groupSelector.weight ~= "default" then
        wrapperStart = string.format('{{LinkСard/Сollapsible|name=Группа предметов %s%%|content=', groupSelector.weight)
        wrapperEnd = "}}"
     elseif groupSelector["!type"] == "GroupSelector" and not groupSelector.weight then
        wrapperStart = '{{LinkСard/Сollapsible|name=Может выпасть лишь один из:|content='
        wrapperEnd = "}}"
    end


     for _, child in ipairs(allSelector.children) do
     for _, child in ipairs(groupSelector.children) do
         if child["!type"] == "NestedSelector" and child.tableId then
         if child["!type"] == "GroupSelector" then
             result = result .. handleNestedSelector(child)
            result[#result + 1] = handleGroupSelector(child, visited)
        elseif child["!type"] == "AllSelector" then
             result[#result + 1] = string.format('{{LinkСard/Сollapsible|name=Выпадают только вместе:|content=%s}}', handleAllSelector(child))
         elseif child.id then
         elseif child.id then
             result = result .. formatContent(child)
             result[#result + 1] = formatContent(child)
        else
            result[#result + 1] = "<div>Ошибка: отсутствует id у элемента.</div>"
         end
         end
     end
     end


     return result
     return wrapperStart .. table.concat(result) .. wrapperEnd
end
end


-- Обработка GroupSelector
---------------------------------------------------------------------
handleGroupSelector = function(groupSelector)
-- Обработка NestedSelector
     local result = ''
function handleNestedSelector(nestedSelector, wrapped, visited)
 
     visited = visited or {}
    -- Проверка на существование children
     if not nestedSelector.tableId then return "" end
     if not groupSelector.children then
        return ""
    end
 
    local weight = groupSelector.weight or "default"


     -- Если weight равен "default", не оборачиваем в div
     local result = {}
     if weight == "default" then
     local classesRolls, classesProb = "", ""
        for _, child in ipairs(groupSelector.children) do
    if wrapped then
            if child["!type"] == "GroupSelector" then
        if nestedSelector.rolls and nestedSelector.rolls.range then
                result = result .. handleGroupSelector(child)
             local rollsResult = processRolls(nestedSelector.rolls)
            elseif child["!type"] == "AllSelector" then
             if rollsResult and #rollsResult > 0 then
                result = result .. '<div class="AllSelector">'
                 classesRolls = ', максимум может выпасть: ' .. rollsResult
                result = result .. handleAllSelector(child)
                result = result .. '</div>'
             elseif child.id then
                result = result .. formatContent(child)
             else
                 result = result .. "<div>Ошибка: отсутствует id у элемента.</div>"
             end
             end
         end
         end
    else
         if nestedSelector.prob then
         -- Если weight указан, оборачиваем в div
            classesProb = string.format(" <div>%s%%</div>", (nestedSelector.prob * 100 >= 1) and math.floor(nestedSelector.prob * 100) or nestedSelector.prob * 100)
        result = result .. string.format('<div class="together" id="%s">', weight)
 
        for _, child in ipairs(groupSelector.children) do
            if child["!type"] == "GroupSelector" then
                result = result .. handleGroupSelector(child)
            elseif child["!type"] == "AllSelector" then
                result = result .. '<div class="AllSelector">'
                result = result .. handleAllSelector(child)
                result = result .. '</div>'
            elseif child.id then
                result = result .. formatContent(child)
            else
                result = result .. "<div>Ошибка: отсутствует id у элемента.</div>"
            end
         end
         end
    end


         result = result .. '</div>'
    if wrapped and (classesRolls ~= "" or classesProb ~= "") then
         result[#result + 1] = string.format('{{LinkСard/Сollapsible|name=Группа предметов%s%s|content=', classesRolls, classesProb)
     end
     end


     return result
     result[#result + 1] = getTableOutput(nestedSelector.tableId, visited)
end


-- Обработка NestedSelector
    if wrapped and (classesRolls ~= "" or classesProb ~= "") then
handleNestedSelector = function(nestedSelector)
        result[#result + 1] = "}}"
    local result = ''
     end
    local tableId = nestedSelector.tableId
     if not tableId then return result end


     -- Генерация классов для div
     return table.concat(result)
    local classes = {}
end


     if nestedSelector.rolls and nestedSelector.rolls.range then
---------------------------------------------------------------------
         table.insert(classes, 'rolls-' .. tostring(nestedSelector.rolls.range):gsub(',', '-'))
-- Функция для преобразования диапазона (rolls)
function processRolls(rolls)
     if rolls and rolls.range then
         local min, max = rolls.range:match("(%d+),%s*(%d+)")
        min, max = tonumber(min), tonumber(max)
        if min and max then
            return string.format('[%d-%d]', min + 1, max + 1)
        else
            return 'Некорректный формат для range.'
        end
    elseif rolls and rolls.value then
        return string.format('[%d]', rolls.value)
    else
        return 'Не указан параметр rolls.'
     end
     end
     if nestedSelector.prob then
end
         table.insert(classes, 'prob-' .. tostring(math.floor(nestedSelector.prob * 100)) .. 'p')
 
---------------------------------------------------------------------
-- Формирование списка химии
function getChemOutput(id)
     local function loadSolutionData(solutionType)
         local modulePath = string.format("Модуль:IanComradeBot/prototypes/fills/chem/%s.json/data", solutionType)
        return mw.loadData(modulePath)
     end
     end


     -- Обёртка div с классами
     local function processSolution(solutionType)
    local classString = table.concat(classes, ' ')
        local solutionModule = loadSolutionData(solutionType)
    result = result .. string.format('<div class="%s">', classString)
        if not solutionModule then return "" end
    result = result .. getTableOutput(tableId)
    result = result .. '</div>'


    return result
        local item = findDataById(solutionModule, id)
end
        if not item then return "" end


-- Формирование списка химии
        local solutionData = item[solutionType] or item
getChemOutput = function(data, id)
        if not solutionData or not solutionData.reagents then return "" end
    local item = findDataById(data, id)
    if not item then return '' end


    local solutions = item.SolutionContainerManager and item.SolutionContainerManager.solutions
        local output = {}
    if not solutions then return '' end
        for _, reagent in ipairs(solutionData.reagents) do
            local chemInfo = chemTranslateData[reagent.ReagentId]
            local displayName = chemInfo and chemInfo.name or reagent.ReagentId
            output[#output + 1] = string.format('<li>[[Химия#chem_%s|%s]] (%d ед.)</li>', reagent.ReagentId, displayName, reagent.Quantity)
        end
        return table.concat(output)
    end


     local result = '<ul class="1">'
     local result = {}
     for _, solution in pairs(solutions) do
    local solutionTypes = {"drink", "beaker", "injector", "pen"}
         for _, reagent in ipairs(solution.reagents) do
     for _, solutionType in ipairs(solutionTypes) do
            result = result .. string.format('<li>[[Химия#chem_%s|%s]] (%d ед.)</li>', reagent.ReagentId, reagent.ReagentId, reagent.Quantity)
         result[#result + 1] = processSolution(solutionType)
        end
     end
     end
     result = result .. '</ul>'
     local combined = table.concat(result)
    return result
    return (combined ~= "") and string.format('<ul><b>%s</b></ul>', combined) or ""
end
end


-- Обработка rolls
---------------------------------------------------------------------
processRolls = function(rolls)
-- Функция для получения count из itemStackData
     local result = ''
function getStackCount(id)
    if rolls.range then
     local item = findDataById(itemStackData, id)
        -- Если указан range
    if item and item.Stack and item.Stack.count then
        local min, max = rolls.range:match("(%d+),%s*(%d+)")
         return item.Stack.count
        min, max = tonumber(min), tonumber(max)
        if min and max then
            result = string.format('Максимальное количество предметов: от %d до %d.', min, max)
        else
            result = 'Некорректный формат для range.'
        end
    elseif rolls.value then
         -- Если указано value
        result = string.format('Будет сгенерировано %d предметов.', rolls.value)
    else
        result = 'Не указан параметр rolls.'
     end
     end
     return result
     return nil
end
end


---------------------------------------------------------------------
local p = {}
---------------------------------------------------------------------
-- Основная функция модуля
-- Основная функция модуля
function p.main(frame)
function p.main(frame)
Строка 278: Строка 313:
     local id = frame.args[2]
     local id = frame.args[2]


     if not id then return 'Не указан ID.' end
     if not id then  
        return 'Не указан ID.'  
    end


    local data = loadData('User:IanComradeBot/prototypes/fills/Item.json', 'items')
     if not itemData then  
     if not data then return 'Не удалось загрузить данные.' end
        return 'Не удалось загрузить данные.'  
    end


    -- При режиме framing
     if mode == 'framing' then
     if mode == 'framing' then
         local subMode = frame.args[2]
         local subMode = frame.args[2]
         local id = frame.args[3]
         local idFraming = frame.args[3]
   
         if not idFraming then
         if not id then
             return 'Не указан ID для режима framing.'
             return 'Не указан ID для режима framing.'
         end
         end
   
         if subMode == 'chem' then
         if subMode == 'chem' then
             return frame:preprocess('{{СollapsibleMenu|' .. getChemOutput(data, id) .. '}}')
             return frame:preprocess('{{СollapsibleMenu|color=#3e7c82|' .. getChemOutput(idFraming) .. '}}')
         elseif subMode == 'contained' then
         elseif subMode == 'contained' then
             return frame:preprocess('{{СollapsibleMenu|' .. getContainedOutput(data, id, false) .. '}}')
             return frame:preprocess('{{СollapsibleMenu|' .. getContainedOutput(itemData, idFraming) .. '}}')
        elseif subMode == "slot" then
            local itemDataEntry = findDataById(itemSlotsData, idFraming)
            if not itemDataEntry then return "" end
            local startingItem = nil
            if itemDataEntry.ItemSlots and itemDataEntry.ItemSlots.slots then
                for _, slot in ipairs(itemDataEntry.ItemSlots.slots) do
                    if slot.startingItem and slot.startingItem ~= "" then
                        startingItem = slot.startingItem
                        break
                    end
                end
            end
            if not startingItem then return "" end
            return frame:preprocess('{{СollapsibleMenu|color=#71702a|' .. formatContent(startingItem) .. '}}')
        elseif subMode == "stack" then
            local count = getStackCount(idFraming)
            return count and '(' .. count .. ')' or ""
         else
         else
             return 'Неизвестный подрежим для framing: ' .. subMode
             return 'Неизвестный подрежим для framing: ' .. subMode
         end
         end
     end
     elseif mode == 'stack' then
 
        local count = getStackCount(id)
    -- При нормальном режиме
        return count or ""
     if mode == 'chem' then
     elseif mode == 'chem' then
         return frame:preprocess(getChemOutput(data, id))
         return getChemOutput(id)
     elseif mode == 'contained' then
     elseif mode == 'contained' then
         return frame:preprocess(getContainedOutput(data, id, false))
         return frame:preprocess(getContainedOutput(itemData, id))
    elseif mode == "slot" then
        local itemDataEntry = findDataById(itemSlotsData, id)
        if not itemDataEntry then return "" end
        local startingItem = nil
        if itemDataEntry.ItemSlots and itemDataEntry.ItemSlots.slots then
            for _, slot in ipairs(itemDataEntry.ItemSlots.slots) do
                if slot.startingItem and slot.startingItem ~= "" then
                    startingItem = slot.startingItem
                    break
                end
            end
        end
        if not startingItem then return "" end
        return frame:preprocess(formatContent(startingItem))
     elseif mode == 'rolls' then
     elseif mode == 'rolls' then
         local entity = findDataById(data, id)
         local entity = findDataById(itemData, id)
         if not entity then return 'ID не найден в данных.' end
         if not entity then  
 
            return 'ID не найден в данных.'  
        end
         if entity.EntityTableContainerFill then
         if entity.EntityTableContainerFill then
             local containers = entity.EntityTableContainerFill.containers
             local containers = entity.EntityTableContainerFill.containers
Строка 316: Строка 383:
             end
             end
         end
         end
 
         return ''
         return 'Режим rolls не найден для этого ID.'
     else
     else
         return 'Неизвестный режим: ' .. mode
         return 'Неизвестный режим: ' .. mode

Версия от 20:34, 8 апреля 2025

Для документации этого модуля может быть создана страница Модуль:Prototypes/Хранилище/Предмет/doc

---------------------------------------------------------------------
-- Предварительная загрузка данных
local itemData          = mw.loadData("Модуль:IanComradeBot/prototypes/fills/Item.json/data")
local itemSlotsData     = mw.loadData("Модуль:IanComradeBot/prototypes/ItemSlots.json/data")
local itemStackData     = mw.loadData("Модуль:IanComradeBot/prototypes/fills/stack.json/data")
local chemTranslateData = mw.loadData("Модуль:IanComradeBot/chem prototypes.json/data")
local tableData         = mw.loadData("Модуль:IanComradeBot/prototypes/table.json/data")

---------------------------------------------------------------------
-- Функция поиска данных по ID
local function findDataById(data, id)
    if not data then 
        return nil 
    end

    if data[id] then
        return data[id]
    end

    if type(data) == "table" then
        -- Если таблица массивная, то перебираем по порядку, иначе по парам
        local iterFunc = (#data > 0) and ipairs or pairs
        for _, item in iterFunc(data) do
            if type(item) == "table" and item.id == id then
                return item
            end
        end
    end
    return nil
end

---------------------------------------------------------------------
-- Форматирование содержимого
local function formatContent(content)
    if type(content) == "table" and not content.id then
        return "Ошибка: отсутствует id у элемента."
    end

    local id = content.id or content
    local amountNumber = 1

    if content.amount then
        if type(content.amount) == "table" then
            amountNumber = content.amount.value or 1
        else
            amountNumber = content.amount
        end
    end
    local amount = (amountNumber and amountNumber ~= 1) and string.format(" [%d]", amountNumber) or ""

    local prob = ""
    local probValue = nil
    if content.prob then
        probValue = content.prob * 100 -- перевод в проценты
    elseif content.weight then
        probValue = content.weight
    end
    if probValue then
        prob = string.format("%s%%", (probValue >= 1) and math.floor(probValue) or probValue)
    end

    return string.format('{{#invoke:Предмет|main|%s|%s<span>%s</span>|repository=1|wrapper=1}}', id, amount, prob)
end

---------------------------------------------------------------------
-- Обработка списка элементов (не таблицы, а прямой список содержимого)
local function getContentsOutput(contents)
    local result = {}
    for _, content in ipairs(contents) do
        result[#result + 1] = formatContent(content)
    end
    return table.concat(result)
end

---------------------------------------------------------------------
-- Универсальная функция обхода детей с учётом рекурсии и кеширования (visited)
local function processChildren(children, visited)
    visited = visited or {}
    if not children then return "" end

    local result = {}
    for _, child in ipairs(children) do
        if child.id then
            if not visited[child.id] then
                result[#result + 1] = formatContent(child)
            end
        elseif child["!type"] == "NestedSelector" then
            result[#result + 1] = handleNestedSelector(child, true, visited)
        elseif child["!type"] == "GroupSelector" then
            result[#result + 1] = handleGroupSelector(child, visited)
        elseif child["!type"] == "AllSelector" then
            result[#result + 1] = handleAllSelector(child)
        end
    end
    return table.concat(result)
end

---------------------------------------------------------------------
-- Получение содержимого таблицы по tableId с кешированием
local function getTableOutput(tableId, visited)
    visited = visited or {}
    if visited[tableId] then return "" end
    visited[tableId] = true

    local tableDataIndex = findDataById(tableData, tableId)
    if not tableDataIndex then 
        return 'Таблица не найдена.' 
    end

    if tableDataIndex['!type:GroupSelector'] then
        return handleGroupSelector(tableDataIndex['!type:GroupSelector'], visited)
    elseif tableDataIndex['!type:AllSelector'] then
        return processChildren(tableDataIndex['!type:AllSelector'].children, visited)
    end

    return 'Таблица не содержит элементов.'
end

---------------------------------------------------------------------
-- Универсальная функция обработки детей контейнеров
local function processContainerChildren(children, visited)
    local result = {}
    if children then
        for _, child in ipairs(children) do
            if child.id then
                result[#result + 1] = formatContent(child)
            elseif child["!type"] == "GroupSelector" then
                result[#result + 1] = handleGroupSelector(child, visited)
            elseif child["!type"] == "AllSelector" then
                result[#result + 1] = processChildren(child.children, visited)
            end
        end
    end
    return table.concat(result)
end

---------------------------------------------------------------------
-- Формирование списка содержащихся предметов или таблиц
local function getContainedOutput(itemData, id, visited)
    visited = visited or {}
    if visited[id] then return "" end
    visited[id] = true

    local item = findDataById(itemData, id)
    if not item then 
        return "" 
    end

    local result = {}

    if item.StorageFill and item.StorageFill.contents then
        result[#result + 1] = getContentsOutput(item.StorageFill.contents)
    elseif item.EntityTableContainerFill and item.EntityTableContainerFill.containers then
        local containers = item.EntityTableContainerFill.containers
        if containers.entity_storage then
            result[#result + 1] = processContainerChildren(containers.entity_storage.children, visited)
            if containers.entity_storage.tableId then
                result[#result + 1] = getTableOutput(containers.entity_storage.tableId, visited)
            end
        end
        if containers.storagebase then
            result[#result + 1] = processContainerChildren(containers.storagebase.children, visited)
            if containers.storagebase.tableId then
                result[#result + 1] = getTableOutput(containers.storagebase.tableId, visited)
            end
        end
    end
    return table.concat(result)
end

---------------------------------------------------------------------
-- Обработка AllSelector
function handleAllSelector(allSelector)
    if not allSelector.children then return "" end
    return processChildren(allSelector.children)
end

---------------------------------------------------------------------
-- Обработка GroupSelector
function handleGroupSelector(groupSelector, visited)
    visited = visited or {}
    if not groupSelector.children then return "" end

    local result = {}
    local wrapperStart, wrapperEnd = "", ""
    if groupSelector.weight and groupSelector.weight ~= "default" then
        wrapperStart = string.format('{{LinkСard/Сollapsible|name=Группа предметов %s%%|content=', groupSelector.weight)
        wrapperEnd = "}}"
    elseif groupSelector["!type"] == "GroupSelector" and not groupSelector.weight then
        wrapperStart = '{{LinkСard/Сollapsible|name=Может выпасть лишь один из:|content='
        wrapperEnd = "}}"
    end

    for _, child in ipairs(groupSelector.children) do
        if child["!type"] == "GroupSelector" then
            result[#result + 1] = handleGroupSelector(child, visited)
        elseif child["!type"] == "AllSelector" then
            result[#result + 1] = string.format('{{LinkСard/Сollapsible|name=Выпадают только вместе:|content=%s}}', handleAllSelector(child))
        elseif child.id then
            result[#result + 1] = formatContent(child)
        else
            result[#result + 1] = "<div>Ошибка: отсутствует id у элемента.</div>"
        end
    end

    return wrapperStart .. table.concat(result) .. wrapperEnd
end

---------------------------------------------------------------------
-- Обработка NestedSelector
function handleNestedSelector(nestedSelector, wrapped, visited)
    visited = visited or {}
    if not nestedSelector.tableId then return "" end

    local result = {}
    local classesRolls, classesProb = "", ""
    if wrapped then
        if nestedSelector.rolls and nestedSelector.rolls.range then
            local rollsResult = processRolls(nestedSelector.rolls)
            if rollsResult and #rollsResult > 0 then
                classesRolls = ', максимум может выпасть: ' .. rollsResult
            end
        end
        if nestedSelector.prob then
            classesProb = string.format(" <div>%s%%</div>", (nestedSelector.prob * 100 >= 1) and math.floor(nestedSelector.prob * 100) or nestedSelector.prob * 100)
        end
    end

    if wrapped and (classesRolls ~= "" or classesProb ~= "") then
        result[#result + 1] = string.format('{{LinkСard/Сollapsible|name=Группа предметов%s%s|content=', classesRolls, classesProb)
    end

    result[#result + 1] = getTableOutput(nestedSelector.tableId, visited)

    if wrapped and (classesRolls ~= "" or classesProb ~= "") then
        result[#result + 1] = "}}"
    end

    return table.concat(result)
end

---------------------------------------------------------------------
-- Функция для преобразования диапазона (rolls)
function processRolls(rolls)
    if rolls and rolls.range then
        local min, max = rolls.range:match("(%d+),%s*(%d+)")
        min, max = tonumber(min), tonumber(max)
        if min and max then
            return string.format('[%d-%d]', min + 1, max + 1)
        else
            return 'Некорректный формат для range.'
        end
    elseif rolls and rolls.value then
        return string.format('[%d]', rolls.value)
    else
        return 'Не указан параметр rolls.'
    end
end

---------------------------------------------------------------------
-- Формирование списка химии
function getChemOutput(id)
    local function loadSolutionData(solutionType)
        local modulePath = string.format("Модуль:IanComradeBot/prototypes/fills/chem/%s.json/data", solutionType)
        return mw.loadData(modulePath)
    end

    local function processSolution(solutionType)
        local solutionModule = loadSolutionData(solutionType)
        if not solutionModule then return "" end

        local item = findDataById(solutionModule, id)
        if not item then return "" end

        local solutionData = item[solutionType] or item
        if not solutionData or not solutionData.reagents then return "" end

        local output = {}
        for _, reagent in ipairs(solutionData.reagents) do
            local chemInfo = chemTranslateData[reagent.ReagentId]
            local displayName = chemInfo and chemInfo.name or reagent.ReagentId
            output[#output + 1] = string.format('<li>[[Химия#chem_%s|%s]] (%d ед.)</li>', reagent.ReagentId, displayName, reagent.Quantity)
        end
        return table.concat(output)
    end

    local result = {}
    local solutionTypes = {"drink", "beaker", "injector", "pen"}
    for _, solutionType in ipairs(solutionTypes) do
        result[#result + 1] = processSolution(solutionType)
    end
    local combined = table.concat(result)
    return (combined ~= "") and string.format('<ul><b>%s</b></ul>', combined) or ""
end

---------------------------------------------------------------------
-- Функция для получения count из itemStackData
function getStackCount(id)
    local item = findDataById(itemStackData, id)
    if item and item.Stack and item.Stack.count then
        return item.Stack.count
    end
    return nil
end

---------------------------------------------------------------------
local p = {}

---------------------------------------------------------------------
-- Основная функция модуля
function p.main(frame)
    local mode = frame.args[1]
    local id = frame.args[2]

    if not id then 
        return 'Не указан ID.' 
    end

    if not itemData then 
        return 'Не удалось загрузить данные.' 
    end

    if mode == 'framing' then
        local subMode = frame.args[2]
        local idFraming = frame.args[3]
        if not idFraming then
            return 'Не указан ID для режима framing.'
        end
        if subMode == 'chem' then
            return frame:preprocess('{{СollapsibleMenu|color=#3e7c82|' .. getChemOutput(idFraming) .. '}}')
        elseif subMode == 'contained' then
            return frame:preprocess('{{СollapsibleMenu|' .. getContainedOutput(itemData, idFraming) .. '}}')
        elseif subMode == "slot" then
            local itemDataEntry = findDataById(itemSlotsData, idFraming)
            if not itemDataEntry then return "" end
            local startingItem = nil
            if itemDataEntry.ItemSlots and itemDataEntry.ItemSlots.slots then
                for _, slot in ipairs(itemDataEntry.ItemSlots.slots) do
                    if slot.startingItem and slot.startingItem ~= "" then
                        startingItem = slot.startingItem
                        break
                    end
                end
            end
            if not startingItem then return "" end
            return frame:preprocess('{{СollapsibleMenu|color=#71702a|' .. formatContent(startingItem) .. '}}')
        elseif subMode == "stack" then
            local count = getStackCount(idFraming)
            return count and '(' .. count .. ')' or ""
        else
            return 'Неизвестный подрежим для framing: ' .. subMode
        end
    elseif mode == 'stack' then
        local count = getStackCount(id)
        return count or ""
    elseif mode == 'chem' then
        return getChemOutput(id)
    elseif mode == 'contained' then
        return frame:preprocess(getContainedOutput(itemData, id))
    elseif mode == "slot" then
        local itemDataEntry = findDataById(itemSlotsData, id)
        if not itemDataEntry then return "" end
        local startingItem = nil
        if itemDataEntry.ItemSlots and itemDataEntry.ItemSlots.slots then
            for _, slot in ipairs(itemDataEntry.ItemSlots.slots) do
                if slot.startingItem and slot.startingItem ~= "" then
                    startingItem = slot.startingItem
                    break
                end
            end
        end
        if not startingItem then return "" end
        return frame:preprocess(formatContent(startingItem))
    elseif mode == 'rolls' then
        local entity = findDataById(itemData, id)
        if not entity then 
            return 'ID не найден в данных.' 
        end
        if entity.EntityTableContainerFill then
            local containers = entity.EntityTableContainerFill.containers
            if containers.entity_storage and containers.entity_storage.rolls then
                return processRolls(containers.entity_storage.rolls)
            end
        end
        return ''
    else
        return 'Неизвестный режим: ' .. mode
    end
end

return p