@amxts/menu-core 0.1.0

package/scripts/docs/src/index.ts

@@ -0,0 +1,298 @@
+// The tooltips of src/index.ts, in both languages: scripts/apply-docs.ts writes the
+// one AMXTS_DOCS_LANG picks into the JSDoc above each element.
+export default {
+	"Menu": {
+		en: `
+			A menu: read from a menu file, or made with \`create()\`. The fields are what
+			the file sets; the methods fill the menu, open it and count it down.
+
+			    const shop = menus.create("SHOP", { title: "Shop" });
+			    shop.addItem("Heal", { onSelect: heal });
+			    shop.show(player);
+		`,
+		ru: `
+			Меню: прочитанное из файла меню или сделанное через \`create()\`. Поля — то,
+			что задаёт файл; методы наполняют меню, открывают его и ведут отсчёт.
+
+			    const shop = menus.create("SHOP", { title: "Shop" });
+			    shop.addItem("Heal", { onSelect: heal });
+			    shop.show(player);
+		`,
+	},
+	"Menu.kind": {
+		en: `The menu's kind, one of \`"items"\` (a list of items) or \`"list"\` (a row per player, or per row of a list source). A name starting with \`LIST_\` makes a list.`,
+		ru: `Вид меню, одно из \`"items"\` (список пунктов) или \`"list"\` (строка на игрока или на строку источника). Имя на \`LIST_\` даёт список.`,
+	},
+	"Menu.hideBack": {
+		en: `Hiding of the \`"Back"\` button: \`true\` leaves it out.`,
+		ru: `Скрытие кнопки \`"Назад"\`: \`true\` убирает её.`,
+	},
+	"Menu.hideExit": {
+		en: `Hiding of the \`"Exit"\` button: \`true\` leaves it out.`,
+		ru: `Скрытие кнопки \`"Выход"\`: \`true\` убирает её.`,
+	},
+	"Menu.locked": {
+		en: `A lock on the menu: while \`true\`, items cannot be chosen and no other menu replaces this one.`,
+		ru: `Блокировка меню: пока \`true\`, пункты нельзя выбрать и другое меню не заменяет это.`,
+	},
+	"Menu.sharedTimer": {
+		en: `One countdown for everyone looking at the menu (\`true\`), rather than one per player.`,
+		ru: `Один отсчёт на всех, кто смотрит меню (\`true\`), а не у каждого игрока свой.`,
+	},
+	"Menu.time": {
+		en: `Seconds on the countdown when the menu opens, e.g. \`10\`; \`0\` for none.`,
+		ru: `Секунды отсчёта при открытии меню, например \`10\`; \`0\` — без отсчёта.`,
+	},
+	"Menu.onTimeout": {
+		en: `Action names run when the countdown ends, e.g. \`"CLOSE_MENU"\`; \`""\` closes the menu.`,
+		ru: `Имена действий, которые выполняются, когда отсчёт кончился, например \`"CLOSE_MENU"\`; \`""\` закрывает меню.`,
+	},
+	"Menu.activeOn": {
+		en: `Condition names the menu opens only under, space-separated, e.g. \`"IS_ALIVE !IS_SPECTATOR"\`; \`""\` for always.`,
+		ru: `Имена условий, при которых меню открывается, через пробел, например \`"IS_ALIVE !IS_SPECTATOR"\`; \`""\` — всегда.`,
+	},
+	"Menu.countdown": {
+		en: `Seconds left on the shared countdown; \`0\` while none runs.`,
+		ru: `Секунды, оставшиеся на общем отсчёте; \`0\`, пока отсчёт не идёт.`,
+	},
+	"Menu.name": {
+		en: `The menu's name - its name in the menu file, e.g. \`"MAIN_MENU"\`.`,
+		ru: `Имя меню — его имя в файле меню, например \`"MAIN_MENU"\`.`,
+	},
+	"Menu.title": {
+		en: `The menu's title: the text - a lang key too - or a function that gives it for the player who looks.`,
+		ru: `Заголовок меню: сам текст — или ключ словаря — либо функция, которая даёт его для игрока, который смотрит.`,
+	},
+	"Menu.addItem": {
+		en: `
+			Adds an item: its text, or a function that gives it for the player -
+			\`target\` is the row's in a list menu, else the menu's.
+
+			    shop.addItem((player) => \`Heal (\${player.health} HP)\`, { onSelect: heal });
+		`,
+		ru: `
+			Добавляет пункт: его текст или функцию, которая даёт текст для игрока, —
+			\`target\` — цель строки в меню-списке, иначе меню.
+
+			    shop.addItem((player) => \`Heal (\${player.health} HP)\`, { onSelect: heal });
+		`,
+	},
+	"Menu.addFixedItem": {
+		en: `Adds an item that takes the same slot on every page: \`slot\` is its key, \`1\` to \`7\`; the text as \`addItem()\` takes it.`,
+		ru: `Добавляет пункт, который на каждой странице занимает один слот: \`slot\` — его клавиша, от \`1\` до \`7\`; текст — как у \`addItem()\`.`,
+	},
+	"Menu.clearItems": {
+		en: `Removes every item of the menu, fixed ones too.`,
+		ru: `Удаляет все пункты меню, включая фиксированные.`,
+	},
+	"Menu.addFilter": {
+		en: `A filter of a list menu: rows \`test\` says no to are left out, and \`message\` is said when none is left.`,
+		ru: `Фильтр меню-списка: строки, на которые \`test\` отвечает «нет», пропускаются, а если не осталось ни одной, игрок получает \`message\`.`,
+	},
+	"Menu.addPlaceholder": {
+		en: `A placeholder of this menu, for menu files and Pawn plugins: the text \`%name%\` stands for, before the ones registered with \`addPlaceholder()\`. In code the text is a function instead.`,
+		ru: `Плейсхолдер этого меню — для файлов меню и Pawn-плагинов: текст, которым заменяется \`%name%\`, раньше зарегистрированных через \`addPlaceholder()\`. В коде текст — функция.`,
+	},
+	"Menu.setListSource": {
+		en: `The source of this list menu's rows, instead of the players.`,
+		ru: `Источник строк этого меню-списка вместо игроков.`,
+	},
+	"Menu.addEventListener": {
+		en: `Calls \`listener\` on this menu's events of \`type\`, one of \`"open"\`, \`"close"\` or \`"show"\` (before it opens).`,
+		ru: `Вызывает \`listener\` на события этого меню типа \`type\` — одно из \`"open"\`, \`"close"\` или \`"show"\` (до открытия).`,
+	},
+	"Menu.show": {
+		en: `
+			Shows the menu to the player; \`false\` when it does not open - a \`"show"\`
+			listener stopped it, it is not active, or the player's menu holds on.
+		`,
+		ru: `
+			Показывает меню игроку; \`false\`, если оно не открылось — его отменил
+			обработчик \`"show"\`, оно не активно или меню игрока не уступает место.
+		`,
+	},
+	"Menu.refresh": {
+		en: `Draws the menu again for whoever looks at it; the number of players it was drawn for.`,
+		ru: `Перерисовывает меню у всех, кто его смотрит; число игроков, у которых оно перерисовано.`,
+	},
+	"Menu.close": {
+		en: `Closes the menu for whoever looks at it.`,
+		ru: `Закрывает меню у всех, кто его смотрит.`,
+	},
+	"Menu.setTimer": {
+		en: `
+			Sets the shared countdown: starts it when none runs, or changes the
+			seconds left - \`0\` stops it where it is. \`false\` when there is nothing to change.
+		`,
+		ru: `
+			Задаёт общий отсчёт: запускает его, если он не идёт, или меняет
+			оставшиеся секунды — \`0\` останавливает его на месте. \`false\`, если менять нечего.
+		`,
+	},
+	"Menu.cancelTimer": {
+		en: `Stops the shared countdown and closes the menu for everyone looking at it. \`false\` when none ran.`,
+		ru: `Останавливает общий отсчёт и закрывает меню у всех, кто его смотрит. \`false\`, если отсчёт не шёл.`,
+	},
+	"MenuEvent": {
+		en: `A menu event: the \`player\`, the \`menu\`, and on \`"close"\` whether its \`timeout\` ran out.`,
+		ru: `Событие меню: игрок \`player\`, меню \`menu\` и на \`"close"\` — вышло ли время (\`timeout\`).`,
+	},
+	"MenuEvent.defaultPrevented": {
+		en: `A mark of \`preventDefault()\`: \`true\` once it was called.`,
+		ru: `Отметка \`preventDefault()\`: \`true\`, если его вызвали.`,
+	},
+	"MenuEvent.player": {
+		en: `The player whose menu it is.`,
+		ru: `Игрок, чьё это меню.`,
+	},
+	"MenuEvent.menu": {
+		en: `The menu the event is about.`,
+		ru: `Меню, о котором событие.`,
+	},
+	"MenuEvent.timeout": {
+		en: `On \`"close"\`: \`true\` when the menu closed because its time ran out.`,
+		ru: `На \`"close"\`: \`true\`, если меню закрылось, потому что вышло время.`,
+	},
+	"MenuEvent.preventDefault": {
+		en: `On \`"show"\`: keeps the menu from opening.`,
+		ru: `На \`"show"\`: не даёт меню открыться.`,
+	},
+	"MenuListener": {
+		en: `A listener of menu events, as \`addEventListener()\` calls it.`,
+		ru: `Обработчик событий меню, как его вызывает \`addEventListener()\`.`,
+	},
+	"setConfigFile": {
+		en: `
+			Sets the file menus are read from, under \`configs/\`: without an extension,
+			the first of \`.ini\`, \`.yaml\`, \`.yml\`, \`.json\` and \`.jsonc\` that is there. Read when
+			a menu is first asked for; \`fallback\` is read instead when \`file\` is empty.
+		`,
+		ru: `
+			Задаёт файл, из которого читаются меню: путь от \`configs/\`; без расширения —
+			первый из \`.ini\`, \`.yaml\`, \`.yml\`, \`.json\` и \`.jsonc\`, который есть. Читается, когда
+			меню понадобится впервые; если \`file\` пуст, читается \`fallback\`.
+		`,
+	},
+	"find": {
+		en: `A menu by its name; \`null\` when there is none - \`register()\` reads one from the file.`,
+		ru: `Меню по имени; \`null\`, если такого нет — меню из файла читает \`register()\`.`,
+	},
+	"indexOf": {
+		en: `A menu's number among all of them - the one Pawn plugins know it by; \`-1\` for none.`,
+		ru: `Номер меню среди всех — тот, под которым его знают Pawn-плагины; \`-1\`, если меню нет.`,
+	},
+	"menuAt": {
+		en: `The menu with that number among all of them - the reverse of \`indexOf()\`; \`null\` when there is none.`,
+		ru: `Меню с этим номером среди всех — обратное к \`indexOf()\`; \`null\`, если такого нет.`,
+	},
+	"register": {
+		en: `The menu of that name in the menu file, read now if it is not yet; \`null\` when the file has no such menu, or no items in it.`,
+		ru: `Меню с этим именем из файла меню, прочитанное сейчас, если ещё не прочитано; \`null\`, если такого меню в файле нет или в нём нет пунктов.`,
+	},
+	"create": {
+		en: `
+			A menu made in code - or the one of that name already there, as it is. A
+			name starting with \`LIST_\` makes a list menu.
+		`,
+		ru: `
+			Меню из кода — или уже существующее с этим именем, как есть. Имя на \`LIST_\`
+			даёт меню-список.
+		`,
+	},
+	"addCondition": {
+		en: `Registers a condition by name, for menu files and Pawn plugins; the first one registered under a name is the one asked - a built-in one (\`IS_ALIVE\`, \`TEAM_CT\`, ...) too.`,
+		ru: `Регистрирует условие по имени — для файлов меню и Pawn-плагинов; спрашивается то, что зарегистрировано под именем первым, — и вместо встроенного (\`IS_ALIVE\`, \`TEAM_CT\`, ...) тоже.`,
+	},
+	"addAction": {
+		en: `Registers an action by name, for menu files and Pawn plugins; \`SHOW_<MENU>\` and \`CLOSE_MENU\` are built in.`,
+		ru: `Регистрирует действие по имени — для файлов меню и Pawn-плагинов; \`SHOW_<MENU>\` и \`CLOSE_MENU\` встроены.`,
+	},
+	"addPlaceholder": {
+		en: `Registers a placeholder for menu files and Pawn plugins: the text \`%name%\` stands for in titles and items. A name registered twice keeps the first. In code the text is a function instead.`,
+		ru: `Регистрирует плейсхолдер для файлов меню и Pawn-плагинов: текст, которым заменяется \`%name%\` в заголовках и пунктах. Если имя зарегистрировано дважды, остаётся первое. В коде текст — функция.`,
+	},
+	"hasText": {
+		en: `Whether an item name of a menu file gives an item - e.g. \`"A|B"\` gives two variants; \`""\` and \`"|"\` give none.`,
+		ru: `Даёт ли имя пункта из файла меню пункт — например, \`"A|B"\` даёт два варианта; \`""\` и \`"|"\` не дают ни одного.`,
+	},
+	"addRestriction": {
+		en: `Registers a restriction by name, for menu files to name in \`enabled\` and \`when\`: \`message\` is said beside an item it greys out, unless the item or the requirement has its own; \`"*"\` answers for every name nothing else does.`,
+		ru: `Регистрирует ограничение по имени, которое файлы меню называют в \`enabled\` и \`when\`: \`message\` пишется рядом с пунктом, который оно гасит, если у пункта или требования нет своего; \`"*"\` отвечает за все имена, за которые не отвечает никто другой.`,
+	},
+	"addActionCheck": {
+		en: `Greys out items with \`action\` in \`menu\` while \`test\` says no; \`""\` for either means every one.`,
+		ru: `Гасит пункты с \`action\` в \`menu\`, пока \`test\` отвечает «нет»; \`""\` в любом из них означает «все».`,
+	},
+	"addConditionFilter": {
+		en: `Registers a filter over the condition \`name\`, whoever registered it: it gets the condition's value and returns the one to use.`,
+		ru: `Регистрирует фильтр над условием \`name\`, кто бы его ни зарегистрировал: получает значение условия и возвращает то, что будет использовано.`,
+	},
+	"setListSource": {
+		en: `Sets the source of the rows of the list menu of that name, instead of the players; a second source replaces the first.`,
+		ru: `Задаёт источник строк меню-списка с этим именем вместо игроков; второй источник заменяет первый.`,
+	},
+	"addEventListener": {
+		en: `Calls \`listener\` on every menu event of \`type\`, one of \`"open"\`, \`"close"\` or \`"show"\` (before a menu opens).`,
+		ru: `Вызывает \`listener\` на каждое событие меню типа \`type\` — одно из \`"open"\`, \`"close"\` или \`"show"\` (до открытия меню).`,
+	},
+	"listRow": {
+		en: `A row for a list source: its target, text, and optionally an action, a restriction and its message.`,
+		ru: `Строка для источника списка: цель, текст и, если нужно, действие, ограничение и его сообщение.`,
+	},
+	"textRow": {
+		en: `A line of text among a list source's rows; \`centered\` pads it to the middle of the menu.`,
+		ru: `Строка текста среди строк источника списка; \`centered\` выравнивает её по середине меню.`,
+	},
+	"show": {
+		en: `
+			Shows the menu of that name - one made in code, or one of the file;
+			\`false\` when it does not open: no such menu, a \`"show"\` listener stopped it,
+			it is not active, or the player's menu holds on.
+		`,
+		ru: `
+			Показывает меню с этим именем — из кода или из файла; \`false\`, если оно
+			не открылось: такого меню нет, его отменил обработчик \`"show"\`, оно не
+			активно или меню игрока не уступает место.
+		`,
+	},
+	"close": {
+		en: `Closes the player's menu; \`timeout\` tells the \`"close"\` listeners the time ran out.`,
+		ru: `Закрывает меню игрока; \`timeout\` сообщает обработчикам \`"close"\`, что вышло время.`,
+	},
+	"refresh": {
+		en: `Draws the menus again for whoever looks at them; \`names\` are space-separated. The number of players they were drawn for.`,
+		ru: `Перерисовывает меню у всех, кто их смотрит; \`names\` — через пробел. Число игроков, у которых меню перерисованы.`,
+	},
+	"conditionChanged": {
+		en: `Tells the menus a condition's value changed: the menus drawn with it are drawn again.`,
+		ru: `Сообщает меню, что значение условия изменилось: меню, нарисованные с ним, перерисовываются.`,
+	},
+	"activeMenu": {
+		en: `The menu the player looks at, or \`null\`.`,
+		ru: `Меню, которое смотрит игрок, или \`null\`.`,
+	},
+	"shownText": {
+		en: `The text of the player's menu, as it was last drawn; \`""\` when none is open.`,
+		ru: `Текст меню игрока, как оно было нарисовано в последний раз; \`""\`, если меню не открыто.`,
+	},
+	"lock": {
+		en: `Locks the player's menu: no item can be chosen and no other menu replaces it until it is unlocked or closed.`,
+		ru: `Блокирует меню игрока: пункты нельзя выбрать и другое меню его не заменяет, пока его не разблокируют или не закроют.`,
+	},
+	"isLocked": {
+		en: `Whether the player's menu is locked - see \`lock()\`.`,
+		ru: `Заблокировано ли меню игрока — см. \`lock()\`.`,
+	},
+	"setPage": {
+		en: `Sets the page the player's menu is drawn at next, from \`0\`.`,
+		ru: `Задаёт страницу, на которой меню игрока нарисуется в следующий раз, от \`0\`.`,
+	},
+	"hasAction": {
+		en: `Whether an action of that name is registered.`,
+		ru: `Зарегистрировано ли действие с этим именем.`,
+	},
+	"runActions": {
+		en: `Runs an action line: space-separated action names, \`CLOSE_MENU\` and \`SHOW_<MENU>\` among them.`,
+		ru: `Выполняет строку действий: имена действий через пробел, в том числе \`CLOSE_MENU\` и \`SHOW_<MENU>\`.`,
+	},
+};

package/scripts/docs/src/types.ts

@@ -0,0 +1,266 @@
+// The tooltips of src/types.ts, in both languages: scripts/apply-docs.ts writes the
+// one AMXTS_DOCS_LANG picks into the JSDoc above each element.
+export default {
+	"MenuKind": {
+		en: `A menu's kind, one of \`"items"\` (a list of items) or \`"list"\` (a row per player, or per row of a list source).`,
+		ru: `Вид меню, одно из \`"items"\` (список пунктов) или \`"list"\` (строка на игрока или на строку источника).`,
+	},
+	"MenuText": {
+		en: `
+			Text of a menu - a title, an item, a message: the text itself, or a
+			function that gives it for the player who looks; \`target\` is the row's
+			in a list menu, else the menu's. A lang key is translated either way.
+			Colour tags are chat's letters: \`!y\` yellow, \`!r\` red, \`!d\` grey, \`!w\`
+			white, \`!R\` to the right edge; chat's own \`!g\`, \`!b\` and \`!t\` are dropped.
+
+			    menus.create("SHOP", { title: (player) => \`Shop for \${player.name}\` });
+		`,
+		ru: `
+			Текст меню — заголовок, пункт, сообщение: сам текст или функция, которая
+			даёт его для игрока, который смотрит; \`target\` — цель строки в
+			меню-списке, иначе меню. Ключ словаря переводится в обоих случаях.
+			Цветовые метки — буквы чата: \`!y\` жёлтый, \`!r\` красный, \`!d\` серый, \`!w\`
+			белый, \`!R\` — к правому краю; метки только для чата \`!g\`, \`!b\` и \`!t\` убираются.
+
+			    menus.create("SHOP", { title: (player) => \`Shop for \${player.name}\` });
+		`,
+	},
+	"ListRow": {
+		en: `A row of a list menu, as a list source gives it - made with \`listRow()\` or \`textRow()\`.`,
+		ru: `Строка меню-списка, как её отдаёт источник, — из \`listRow()\` или \`textRow()\`.`,
+	},
+	"ListRow.kind": {
+		en: `The row's kind, one of \`"item"\` (a row to choose) or \`"text"\` (a line of text, not a choice).`,
+		ru: `Вид строки, одно из \`"item"\` (строка для выбора) или \`"text"\` (строка текста, не выбор).`,
+	},
+	"ListRow.target": {
+		en: `The row's target, handed to the action: e.g. a player's \`id\`, an entity or an index of the source's own; \`0\` for a line of text.`,
+		ru: `Цель строки, которую получает действие: например, номер игрока, сущность или индекс самого источника; \`0\` у строки текста.`,
+	},
+	"ListRow.text": {
+		en: `The row's text, put for \`%name%\` in the menu's row template.`,
+		ru: `Текст строки, который подставляется вместо \`%name%\` в шаблон строки меню.`,
+	},
+	"ListRow.action": {
+		en: `Action names of the row's own, run instead of the template's; \`""\` for the template's.`,
+		ru: `Собственные имена действий строки, вместо действий шаблона; \`""\` — действия шаблона.`,
+	},
+	"ListRow.restriction": {
+		en: `Restriction names, space-separated: the row is greyed out unless each passes.`,
+		ru: `Имена ограничений через пробел: строка погашена, пока не пройдено каждое.`,
+	},
+	"ListRow.restrictionMessage": {
+		en: `The text beside the row while it is greyed out; \`""\` for the restriction's own message.`,
+		ru: `Текст рядом со строкой, пока она погашена; \`""\` — сообщение самого ограничения.`,
+	},
+	"MenuOptions": {
+		en: `
+			The options of a menu made with \`create()\`. Every field may be left out:
+
+			    menus.create("SHOP", { title: "Shop", time: 30, activeWhen: player => player.isAlive });
+		`,
+		ru: `
+			Настройки меню, сделанного через \`create()\`. Любое поле можно не задавать:
+
+			    menus.create("SHOP", { title: "Shop", time: 30, activeWhen: player => player.isAlive });
+		`,
+	},
+	"MenuOptions.title": {
+		en: `The menu's title: the text - a lang key too - or a function that gives it for the player; left out, the menu's name.`,
+		ru: `Заголовок меню: сам текст — или ключ словаря — либо функция, которая даёт его для игрока; если не задан — имя меню.`,
+	},
+	"MenuOptions.time": {
+		en: `Seconds on the countdown when the menu opens, e.g. \`10\`; left out, none.`,
+		ru: `Секунды отсчёта при открытии меню, например \`10\`; если не задано — без отсчёта.`,
+	},
+	"MenuOptions.hideBack": {
+		en: `Hiding of the \`"Back"\` button: \`true\` leaves it out.`,
+		ru: `Скрытие кнопки \`"Назад"\`: \`true\` убирает её.`,
+	},
+	"MenuOptions.hideExit": {
+		en: `Hiding of the \`"Exit"\` button: \`true\` leaves it out.`,
+		ru: `Скрытие кнопки \`"Выход"\`: \`true\` убирает её.`,
+	},
+	"MenuOptions.locked": {
+		en: `A lock on the menu: while \`true\`, items cannot be chosen and no other menu replaces this one.`,
+		ru: `Блокировка меню: пока \`true\`, пункты нельзя выбрать и другое меню не заменяет это.`,
+	},
+	"MenuOptions.activeWhen": {
+		en: `A test the menu opens under: while it says no to the player, the menu does not open for him.`,
+		ru: `Проверка, при которой меню открывается: пока она отвечает игроку «нет», меню ему не открывается.`,
+	},
+	"MenuShowOptions": {
+		en: `
+			The options of showing a menu. Every field may be left out:
+
+			    shop.show(player, { time: 10 });
+		`,
+		ru: `
+			Настройки показа меню. Любое поле можно не задавать:
+
+			    shop.show(player, { time: 10 });
+		`,
+	},
+	"MenuShowOptions.time": {
+		en: `Seconds on the countdown; left out, the countdown running goes on, or the menu's own starts.`,
+		ru: `Секунды отсчёта; если не заданы, идущий отсчёт продолжается или начинается собственный отсчёт меню.`,
+	},
+	"MenuShowOptions.target": {
+		en: `The player the menu is about, by \`id\`: \`%target%\`, and the target an action gets; \`0\` when left out.`,
+		ru: `Игрок, о котором меню, — его номер: \`%target%\` и цель, которую получает действие; если не задан — \`0\`.`,
+	},
+	"MenuShowOptions.resetHistory": {
+		en: `A new way back: \`true\` forgets the menus this one was opened from.`,
+		ru: `Новый путь назад: \`true\` забывает меню, из которых открыто это.`,
+	},
+	"MenuShowOptions.force": {
+		en: `Opening over a menu that holds on - a countdown, a lock: \`true\` opens anyway.`,
+		ru: `Открытие поверх меню, которое держится, — с отсчётом или заблокированного: \`true\` открывает всё равно.`,
+	},
+	"MenuShowOptions.skipHistory": {
+		en: `Leaving the menu out of the way back: \`true\` does not remember it.`,
+		ru: `Пропуск меню на пути назад: \`true\` его не запоминает.`,
+	},
+	"MenuItemOptions": {
+		en: `
+			The options of an item, besides its text. Every field may be left out:
+
+			    shop.addItem("Heal", {
+			        visible: player => player.health < 100,
+			        onSelect: (player) => { player.health = 100; },
+			    });
+		`,
+		ru: `
+			Настройки пункта, кроме текста. Любое поле можно не задавать:
+
+			    shop.addItem("Heal", {
+			        visible: player => player.health < 100,
+			        onSelect: (player) => { player.health = 100; },
+			    });
+		`,
+	},
+	"MenuItemOptions.onSelect": {
+		en: `The function run when the item is chosen: the player who chose it, and the target - the row's in a list menu, else the menu's.`,
+		ru: `Функция, которая выполняется при выборе пункта: игрок, который выбрал, и цель — строки в меню-списке, иначе меню.`,
+	},
+	"MenuItemOptions.visible": {
+		en: `A test the item is shown under: while it says no, the item is left out and takes no slot.`,
+		ru: `Проверка, при которой пункт показан: пока она отвечает «нет», пункта нет и слот он не занимает.`,
+	},
+	"MenuItemOptions.enabled": {
+		en: `
+			A test the item can be chosen under - while it says no, the item is
+			greyed out with \`message\` beside it; or a list of requirements, each with
+			a message of its own - the first that fails gives its message.
+
+			    enabled: [
+			        { when: (player) => player.frags >= 5, message: "5 frags needed" },
+			        { when: (player) => player.armor < 100, message: (player) => \`(\${player.armor} already)\` },
+			    ],
+		`,
+		ru: `
+			Проверка, при которой пункт можно выбрать, — пока она отвечает «нет»,
+			пункт погашен, а рядом \`message\`; или список требований, у каждого своё
+			сообщение, — первое невыполненное даёт своё.
+
+			    enabled: [
+			        { when: (player) => player.frags >= 5, message: "5 frags needed" },
+			        { when: (player) => player.armor < 100, message: (player) => \`(\${player.armor} already)\` },
+			    ],
+		`,
+	},
+	"MenuItemOptions.message": {
+		en: `The text beside the item while \`enabled\` greys it out, for a requirement without a message of its own: the text, e.g. \`"(full)"\`, or a function that gives it for the player.`,
+		ru: `Текст рядом с пунктом, пока его гасит \`enabled\`, — для требования без своего сообщения: сам текст, например \`"(full)"\`, или функция, которая даёт его для игрока.`,
+	},
+	"MenuItemOptions.placeholder": {
+		en: `The text after the item's name, for items of menu files and Pawn plugins, placeholders and all, e.g. \`"%hp%"\`; in code the item's text is a function instead.`,
+		ru: `Текст после имени пункта — для пунктов файлов меню и Pawn-плагинов, с плейсхолдерами, например \`"%hp%"\`; в коде текст пункта — функция.`,
+	},
+	"MenuItemOptions.action": {
+		en: `Action names from \`addAction()\` run when the item is chosen, or a built-in one: \`"SHOW_<MENU>"\`, \`"CLOSE_MENU"\`.`,
+		ru: `Имена действий из \`addAction()\`, которые выполняются при выборе пункта, или встроенное: \`"SHOW_<MENU>"\`, \`"CLOSE_MENU"\`.`,
+	},
+	"MenuItemOptions.at": {
+		en: `The item's place among the items, from \`0\`; left out, the end.`,
+		ru: `Место пункта среди пунктов, от \`0\`; если не задано — в конце.`,
+	},
+	"MenuItemOptions.spaceBefore": {
+		en: `Blank lines before the item.`,
+		ru: `Пустые строки перед пунктом.`,
+	},
+	"MenuItemOptions.spaceAfter": {
+		en: `Blank lines after the item.`,
+		ru: `Пустые строки после пункта.`,
+	},
+	"Requirement": {
+		en: `
+			A requirement of an item, in the list \`enabled\` takes: while \`when\` says
+			no, the item is greyed out with \`message\` beside it.
+
+			    { when: (player) => player.frags >= 5, message: "5 frags needed" }
+		`,
+		ru: `
+			Требование пункта в списке, который принимает \`enabled\`: пока \`when\`
+			отвечает «нет», пункт погашен, а рядом \`message\`.
+
+			    { when: (player) => player.frags >= 5, message: "5 frags needed" }
+		`,
+	},
+	"Requirement.when": {
+		en: `A test the requirement holds under: the player who looks, and the target - the row's in a list menu, else the menu's.`,
+		ru: `Проверка, при которой требование выполнено: игрок, который смотрит, и цель — строки в меню-списке, иначе меню.`,
+	},
+	"Requirement.message": {
+		en: `The text beside the item while \`when\` says no: the text, a lang key, or a function that gives it for the player; left out, the item's \`message\`.`,
+		ru: `Текст рядом с пунктом, пока \`when\` отвечает «нет»: сам текст, ключ словаря или функция, которая даёт его для игрока; если не задан — \`message\` пункта.`,
+	},
+	"ConditionTest": {
+		en: `A condition's test, as \`addCondition()\` registers it. In a list menu \`player\` is the row's player and \`viewer\` whoever looks.`,
+		ru: `Проверка условия, как её регистрирует \`addCondition()\`. В меню-списке \`player\` — игрок строки, \`viewer\` — тот, кто смотрит.`,
+	},
+	"ActionHandler": {
+		en: `An action, as \`addAction()\` registers it: \`target\` is the row's in a list menu, else the menu's.`,
+		ru: `Действие, как его регистрирует \`addAction()\`: \`target\` — цель строки в меню-списке, иначе меню.`,
+	},
+	"PlaceholderValue": {
+		en: `A placeholder's value: the text \`%name%\` stands for.`,
+		ru: `Значение плейсхолдера: текст, которым заменяется \`%name%\`.`,
+	},
+	"RestrictionTest": {
+		en: `A restriction's test, as \`addRestriction()\` registers it; \`name\` is the whole token, \`"NAME:param"\` included.`,
+		ru: `Проверка ограничения, как её регистрирует \`addRestriction()\`; \`name\` — токен целиком, вместе с \`"NAME:param"\`.`,
+	},
+	"ActionTest": {
+		en: `A test of an item's action, as \`addActionCheck()\` registers it: \`false\` greys the item out.`,
+		ru: `Проверка действия пункта, как её регистрирует \`addActionCheck()\`: \`false\` гасит пункт.`,
+	},
+	"ConditionFilter": {
+		en: `A filter over a condition someone else registered: gets its value and returns the one to use.`,
+		ru: `Фильтр над условием, которое зарегистрировал кто-то другой: получает его значение и возвращает то, что будет использовано.`,
+	},
+	"RowTest": {
+		en: `A test of a row of a list menu, as \`addFilter()\` takes it: \`player\` is the row's player, \`viewer\` whoever looks.`,
+		ru: `Проверка строки меню-списка, как её принимает \`addFilter()\`: \`player\` — игрок строки, \`viewer\` — тот, кто смотрит.`,
+	},
+	"ListSource": {
+		en: `A list source: the rows of a list menu for the player who looks; \`null\` lists the players instead.`,
+		ru: `Источник списка: строки меню-списка для игрока, который смотрит; \`null\` — вместо них список игроков.`,
+	},
+	"MenuEventType": {
+		en: `A menu event's type, one of \`"open"\` and \`"close"\` as they happen, or \`"show"\` before a menu opens, to stop it.`,
+		ru: `Тип события меню, одно из \`"open"\` и \`"close"\` — когда это происходит, или \`"show"\` — до открытия меню, чтобы его остановить.`,
+	},
+	"MenuCoreOptions": {
+		en: `Menu Core's options: \`menus\` in \`amxts.config.ts\`.`,
+		ru: `Настройки Menu Core: \`menus\` в \`amxts.config.ts\`.`,
+	},
+	"MenuCoreOptions.file": {
+		en: `The menu file, from \`configs/\`: e.g. \`"menu"\` is \`configs/menu.ini\`, \`menu.yaml\`, \`menu.yml\`, \`menu.json\` or \`menu.jsonc\` - the first that is there; \`"myserver/menu.yaml"\` is that file.`,
+		ru: `Файл меню от \`configs/\`: например, \`"menu"\` — \`configs/menu.ini\`, \`menu.yaml\`, \`menu.yml\`, \`menu.json\` или \`menu.jsonc\` — первый, который есть; \`"myserver/menu.yaml"\` — этот файл.`,
+	},
+	"MenuCoreOptions.fallback": {
+		en: `The file read instead when \`file\` is empty or not there, e.g. \`"menu"\` for \`configs/menu.ini\` or \`menu.yaml\`; \`""\` is none.`,
+		ru: `Файл, который читается вместо \`file\`, если тот пуст или его нет, например \`"menu"\` — \`configs/menu.ini\` или \`menu.yaml\`; \`""\` — никакой.`,
+	},
+};