More jsdoc blocks. Fill descriptions instead of todo;.

cli/build/steps/configs_dynamic.ts

@@ -68,7 +68,8 @@ export async function buildDynamicConfigs(parameters: IBuildCommandParameters):
  */
 async function getLtxConfigs(filters: Array<string> = []): Promise<Array<TFolderReplicationDescriptor>> {
   /**
-   * todo;
+   * Collect list of LTX configs for further transformation in typescript.
+   * Recursively find all ts files in configs dir.
    */
   function collectLtxConfigs(
     acc: Array<TFolderReplicationDescriptor>,

cli/build/steps/configs_statics.ts

@@ -54,7 +54,8 @@ export async function buildStaticConfigs(parameters: IBuildCommandParameters): P
  */
 async function getStaticConfigs(filters: Array<string> = []): Promise<Array<TFolderReplicationDescriptor>> {
   /**
-   * todo;
+   * Collect list of LTX configs for including in build.
+   * Recursively find all ltx files in configs dir.
    */
   function collectConfigs(
     acc: Array<TFolderReplicationDescriptor>,

cli/build/steps/translations_dynamic.ts

@@ -36,7 +36,7 @@ export async function buildDynamicTranslations(): Promise<void> {
   }
 
   /**
-   * todo;
+   * Collect list of all dynamic translations recursively in provided directory.
    */
   function collectTranslations(
     acc: Array<TFolderReplicationDescriptor>,

cli/build/steps/ui_dynamic.ts

@@ -64,7 +64,7 @@ export async function buildDynamicUi(parameters: IBuildCommandParameters): Promi
  */
 async function getUiConfigs(filters: Array<string> = []): Promise<Array<TFolderReplicationDescriptor>> {
   /**
-   * todo;
+   * Collect list of ts configs for including in build and correctly transforming to XML forms.
    */
   function collectXmlConfigs(
     acc: Array<TFolderReplicationDescriptor>,

cli/build/steps/ui_statics.ts

@@ -52,7 +52,8 @@ export async function buildStaticUi(parameters: IBuildCommandParameters): Promis
  */
 async function getUiConfigs(filters: Array<string> = []): Promise<Array<TFolderReplicationDescriptor>> {
   /**
-   * todo;
+   * Collect list of XML configs for including in build.
+   * Recursively find all XML files in UI configs dir.
    */
   function collectXmlConfigs(
     acc: Array<TFolderReplicationDescriptor>,

cli/format/format_ltx.ts

@@ -50,7 +50,7 @@ async function formatLtxFile(file: string): Promise<void> {
  */
 async function getLtxConfigs(filters: Array<string> = []): Promise<Array<string>> {
   /**
-   * todo;
+   * Collect list of files for LTX formatting in provided directory.
    */
   function collectConfigs(acc: Array<string>, it: TFolderFiles): Array<string> {
     if (Array.isArray(it)) {

cli/parse/parse_externals.ts

@@ -44,11 +44,11 @@ export async function parseExternals(): Promise<void> {
 }
 
 /**
- * Get list of LTX transformable descriptors.
+ * @returns descriptors of files to parse and generate docs
  */
 async function getSourcesList(source: string): Promise<Array<string>> {
   /**
-   * todo;
+   * Recursively find all files with possible definitions for docs generation.
    */
   function collectList(acc: Array<string>, it: TFolderFiles): Array<string> {
     if (Array.isArray(it)) {

cli/parse/utils/__test__/declaration.ts

@@ -11,12 +11,12 @@ interface IAbstractInterface {
 }
 
 /**
- * todo;
+ * Mock `extern` method for testing.
  */
 function extern(name: string, cb: (...args: Array<unknown>) => void): void {}
 
 /**
- * todo;
+ * Mock `another` method for testing of incorrect module global level calls.
  */
 function another(name: string, cb: (...args: Array<unknown>) => void): void {}
 

cli/preview/preview.ts

@@ -99,11 +99,11 @@ function createFoldersForConfigs(xmlConfigs: Array<TFolderReplicationDescriptor>
 }
 
 /**
- * todo;
+ * @returns list of files for preview generation
  */
 async function getUiConfigs(filters: Array<string> = []): Promise<Array<TFolderReplicationDescriptor>> {
   /**
-   * todo;
+   * Collect list of xml configs for UI preview generation in a recursive way.
    */
   function collectXmlConfigs(
     acc: Array<TFolderReplicationDescriptor>,

cli/utils/fs/open_folder_in_explorer.ts

@@ -2,7 +2,10 @@ import * as cp from "child_process";
 import * as os from "os";
 
 /**
- * todo;
+ * Open folder in OS explorer application for fast access.
+ *
+ * @param path - directory path to open
+ * @returns promise resolving on open folder command execution
  */
 export function openFolderInExplorer(path: string): Promise<void> {
   return new Promise((resolve, reject) => {

cli/utils/fs/read_last_lines_of_file.ts

@@ -7,7 +7,12 @@ import { Optional } from "#/utils/types";
 const NEW_LINE_CHARACTERS: Array<string> = ["\n"];
 
 /**
- * todo;
+ * Read last lines of some text file in a streamed way.
+ *
+ * @param filePath - full path to read file
+ * @param maxLineCount - number of lines to read from EOF
+ * @param encoding - encoding to use when reading file as text
+ * @returns last lines of text file
  */
 export async function readLastLinesOfFile(
   filePath: string,

src/engine/core/schemes/combat_idle/PostCombatIdle.ts

@@ -10,7 +10,8 @@ import { ActionBase, ActionPlanner, ClientObject } from "@/engine/lib/types";
 const logger: LuaLogger = new LuaLogger($filename);
 
 /**
- * todo;
+ * Post combat idle scheme manager.
+ * Used to add idle state logics for game objects if it is needed.
  */
 export class PostCombatIdle {
   /**

src/engine/core/schemes/combat_idle/actions/ActionPostCombatIdleWait.ts

@@ -10,7 +10,8 @@ import { ClientObject, Optional } from "@/engine/lib/types";
 const logger: LuaLogger = new LuaLogger($filename);
 
 /**
- * todo;
+ * Action to wait some time for possible remaining enemies after combat.
+ * Stalkers wait for some time and then go with alife activity / looting corpses / helping others.
  */
 @LuabindClass()
 export class ActionPostCombatIdleWait extends action_base {
@@ -80,7 +81,10 @@ export class ActionPostCombatIdleWait extends action_base {
   }
 
   /**
-   * todo;
+   * todo: Move to utils as pure function?
+   *
+   * @param object - object to check weapon staet
+   * @returns whether weapon is in locked state
    */
   public isWeaponLocked(object: ClientObject): boolean {
     const isWeaponStrapped: boolean = object.weapon_strapped();

src/engine/core/schemes/combat_idle/evaluators/EvaluatorPostCombatIdleEnemy.ts

@@ -10,7 +10,7 @@ import { ClientObject, Optional, TDistance, TTimestamp } from "@/engine/lib/type
 const logger: LuaLogger = new LuaLogger($filename);
 
 /**
- * todo;
+ * Evaluatore to check whether post-combat idle state should be active.
  */
 @LuabindClass()
 export class EvaluatorPostCombatIdleEnemy extends property_evaluator {

src/engine/forms/actor_menu.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { captions } from "@/engine/lib/constants/captions";
 
 /**
- * todo;
+ * Actor menu form generation.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/actor_menu_16.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { captions } from "@/engine/lib/constants/captions";
 
 /**
- * todo;
+ * Actor menu form generation for 16/9 screens.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/actor_menu_item.tsx

@@ -4,7 +4,7 @@ import { ArtefactParams } from "@/engine/forms/af_params";
 import { BoosterParams } from "@/engine/forms/booster_params";
 
 /**
- * todo;
+ * Actor menu form item form generation.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/actor_menu_item_16.tsx

@@ -4,7 +4,7 @@ import { ArtefactParams } from "@/engine/forms/af_params_16";
 import { BoosterParams } from "@/engine/forms/booster_params_16";
 
 /**
- * todo;
+ * Actor menu form item form generation for 16/9 screens.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/af_params.tsx

@@ -1,14 +1,14 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of UI forms for artefact parameters elements.
  */
 export function create(): JSXNode {
   return <ArtefactParams />;
 }
 
 /**
- * todo;
+ * Component describing possible artefact parameters.
  */
 export function ArtefactParams(): JSXNode {
   return (

src/engine/forms/booster_params.tsx

@@ -12,7 +12,7 @@ export function create(): JSXNode {
 }
 
 /**
- * todo;
+ * Component describing booster parameters for inventory items.
  */
 export function BoosterParams(): JSXNode {
   return (

src/engine/forms/inventory_upgrade_info.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Creation of inventory items upgrading possible info forms.
  */
 export function create(): JSXNode {
   return <w></w>;

src/engine/forms/maingame.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { GameUi } from "@/engine/forms/game/GameUi.component";
 
 /**
- * todo;
+ * Creation of UI forms related to in-game play interface.
  */
 export function create(): JSXNode {
   return <GameUi />;

src/engine/forms/maingame_16.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { GameUi } from "@/engine/forms/game/GameUi.component.16";
 
 /**
- * todo;
+ * Creation of UI forms related to in-game play interface (16/9).
  */
 export function create(): JSXNode {
   return <GameUi />;

src/engine/forms/map_spots.tsx

@@ -3,7 +3,7 @@
 import { MapSpots } from "@/engine/forms/game/map/MapSpots.component";
 
 /**
- * todo;
+ * Creation of UI forms related to in-game map spots.
  */
 export function create(): JSXNode {
   return <MapSpots />;

src/engine/forms/map_spots_16.tsx

@@ -3,7 +3,7 @@
 import { MapSpots } from "@/engine/forms/game/map/MapSpots.component.16";
 
 /**
- * todo;
+ * Creation of UI forms related to in-game map spots (16/9).
  */
 export function create(): JSXNode {
   return <MapSpots />;

src/engine/forms/message_box.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Creation of UI forms related to generic message boxes in game.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/message_box_16.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Creation of UI forms related to generic message boxes in game (16/9).
  */
 export function create(): JSXNode {
   return (

src/engine/forms/mp_buy_menu.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { MultiplayerBuyButtons } from "@/engine/forms/menu/multiplayer/MultiplayerBuyButtons";
 
 /**
- * todo;
+ * Generation of buy menu forms for multiplayer.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/mp_buy_menu_16.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { MultiplayerBuyButtons16 } from "@/engine/forms/menu/multiplayer/MultiplayerBuyButtons.16";
 
 /**
- * todo;
+ * Creation of UI forms related to multiplayer buy menu (16/9).
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { Pda } from "@/engine/forms/game/map/Pda.component";
 
 /**
- * todo;
+ * Generation of PDA UI forms.
  */
 export function create(): JSXNode {
   return <Pda />;

src/engine/forms/pda_16.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { Pda } from "@/engine/forms/game/map/Pda.component.16";
 
 /**
- * todo;
+ * Generation of PDA UI forms for 16/9 screens.
  */
 export function create(): JSXNode {
   return <Pda />;

src/engine/forms/pda_character.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of PDA character section UI forms.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_dialog_character.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { captions } from "@/engine/lib/constants/captions";
 
 /**
- * todo;
+ * Generation of PDA character dialogs section UI forms.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_dialog_character_16.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { captions } from "@/engine/lib/constants/captions";
 
 /**
- * todo;
+ * Generation of PDA character dialog section UI forms for 16/9.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_fraction_war.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of PDA faction wars section UI forms.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_fraction_war_16.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of PDA faction war section UI forms for 16/9.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_logs.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of PDA logs section UI forms.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_logs_16.tsx

@@ -1,7 +1,7 @@
 import { JSXNode, JSXXML } from "jsx-xml";
 
 /**
- * todo;
+ * Generation of PDA logs section UI forms for 16/9.
  */
 export function create(): JSXNode {
   return (

src/engine/forms/pda_ranking.tsx

@@ -3,7 +3,7 @@ import { JSXNode, JSXXML } from "jsx-xml";
 import { gameSettingConfig } from "@/engine/lib/configs/GameSettingConfig";
 
 /**
- * todo;
+ * Generation of PDA rankings section UI forms.
  */
 export function create(): JSXNode {
   return (