Skip to content

Commit 2dfb1d2

Browse files
committed
feat: add comprehensive console methods documentation and examples in Tajik and Russian
1 parent cff7cae commit 2dfb1d2

18 files changed

Lines changed: 1505 additions & 51 deletions

.claude/agents/code-reviewer.md

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
---
2+
name: code-reviewer
3+
description: when I will ask him
4+
tools:
5+
Bash, Glob, Grep, Read, WebFetch, TodoWrite, WebSearch, BashOutput, KillShell,
6+
AskUserQuestion, Skill, SlashCommand,
7+
mcp__sequential-thinking__sequentialthinking,
8+
mcp__context7__resolve-library-id, mcp__context7__get-library-docs,
9+
mcp__serena__list_dir, mcp__serena__find_file,
10+
mcp__serena__search_for_pattern, mcp__serena__get_symbols_overview,
11+
mcp__serena__find_symbol, mcp__serena__find_referencing_symbols,
12+
mcp__serena__replace_symbol_body, mcp__serena__insert_after_symbol,
13+
mcp__serena__insert_before_symbol, mcp__serena__rename_symbol,
14+
mcp__serena__write_memory, mcp__serena__read_memory,
15+
mcp__serena__list_memories, mcp__serena__delete_memory,
16+
mcp__serena__check_onboarding_performed, mcp__serena__onboarding,
17+
mcp__serena__think_about_collected_information,
18+
mcp__serena__think_about_task_adherence,
19+
mcp__serena__think_about_whether_you_are_done,
20+
mcp__serena__initial_instructions, ListMcpResourcesTool, ReadMcpResourceTool
21+
model: sonnet
22+
color: yellow
23+
---
24+
25+
Ты агент, который проводит код ревью сделанных изменений и выдает рекомендации
26+
для улучшения, учитывая безопастность, качество кода и его стиль.

README.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -775,6 +775,18 @@ npm run audit:examples
775775
methodology
776776
- [🤝 Community Participation](CONTRIBUTING.md) - Engagement guidelines
777777

778+
### **Built-in Functions & APIs**
779+
780+
- [📖 Console Methods Guide](examples/CONSOLE_METHODS.md) - Complete reference
781+
for all `чоп.*` methods (log, error, warn, info, debug, assert, count, time,
782+
table, trace, and more)
783+
- [Тоҷикӣ (Tajik)](examples/CONSOLE_METHODS.tj.md)
784+
- [Русский (Russian)](examples/CONSOLE_METHODS.ru.md)
785+
- [🖨️ Console Output Examples](examples/console-log-simple.som) - Simple
786+
examples for getting started
787+
- [📊 Advanced Console Usage](examples/console-methods-guide.som) -
788+
Comprehensive guide with all console methods
789+
778790
---
779791

780792
## 🌍 Professional Support

README.ru.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -451,6 +451,18 @@ npm run audit:examples
451451
обеспечения качества
452452
- [🤝 Участие сообщества](CONTRIBUTING.md) - Рекомендации по участию
453453

454+
### **Встроенные функции и API**
455+
456+
- [📖 Справочник методов консоли](examples/CONSOLE_METHODS.ru.md) - Полная
457+
справка по всем методам `чоп.*` (log, error, warn, info, debug, assert, count,
458+
time, table, trace и многое другое)
459+
- [English](examples/CONSOLE_METHODS.md)
460+
- [Тоҷикӣ](examples/CONSOLE_METHODS.tj.md)
461+
- [🖨️ Простые примеры вывода](examples/console-log-simple.som) - Простые примеры
462+
для начала работы
463+
- [📊 Продвинутое использование консоли](examples/console-methods-guide.som) -
464+
Полное руководство со всеми методами консоли
465+
454466
---
455467

456468
## 🌍 Профессиональная поддержка

README.tj.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -449,6 +449,18 @@ npm run audit:examples
449449
сифат
450450
- [🤝 Иштироки ҷомеа](CONTRIBUTING.md) - Дастурҳои иштирок
451451

452+
### **Функсияҳои ворид ва API-ҳо**
453+
454+
- [📖 Маълумотномаи методҳои чоп](examples/CONSOLE_METHODS.tj.md) -
455+
Маълумотномаи мукаммали ҳамаи методҳои `чоп.*` (сабт, хато, огоҳӣ, маълумот,
456+
исфти, тасдиқ, ҳисоб, вақт, ҷадвал, пайҷо ва бисёр дигар)
457+
- [English](examples/CONSOLE_METHODS.md)
458+
- [Русский](examples/CONSOLE_METHODS.ru.md)
459+
- [🖨️ Намунаҳои содаи чоп](examples/console-log-simple.som) - Намунаҳои оддӣ
460+
барои оғоз
461+
- [📊 Истифодаи пешрафтаи чоп](examples/console-methods-guide.som) - Дастури
462+
мукаммал бо ҳамаи методҳои чоп
463+
452464
---
453465

454466
## 🌍 Дастгирии касбӣ

example-audit-report.json

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
{
2-
"timestamp": "2025-10-28T15:38:53.987Z",
3-
"total": 48,
4-
"working": 48,
2+
"timestamp": "2025-10-29T11:07:49.864Z",
3+
"total": 51,
4+
"working": 51,
55
"partial": 0,
66
"failing": 0,
77
"workingPercentage": 100,
@@ -202,11 +202,26 @@
202202
"status": "working",
203203
"reason": "Compiles and runs successfully"
204204
},
205+
{
206+
"name": "38-fibonacci.som",
207+
"status": "working",
208+
"reason": "Compiles and runs successfully"
209+
},
205210
{
206211
"name": "comprehensive-operator-test.som",
207212
"status": "working",
208213
"reason": "Compiles and runs successfully"
209214
},
215+
{
216+
"name": "console-log-simple.som",
217+
"status": "working",
218+
"reason": "Compiles and runs successfully"
219+
},
220+
{
221+
"name": "console-methods-guide.som",
222+
"status": "working",
223+
"reason": "Compiles and runs successfully"
224+
},
210225
{
211226
"name": "simple-class-test.som",
212227
"status": "working",

examples/33-console-methods.som

Lines changed: 22 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -53,24 +53,24 @@
5353
// console.group and console.groupEnd
5454
чоп.сабт("\n=== Гурӯҳбандии паёмҳо ===");
5555

56-
чоп.гурӯҳ("Маълумоти корбар");
56+
чоп.гуруҳ("Маълумоти корбар");
5757
чоп.сабт("Ном: Сомонӣ Сомонов");
5858
чоп.сабт("Синну сол: 30");
5959
чоп.сабт("Касб: Барномасоз");
60-
чоп.анҷомиГурӯҳ();
60+
чоп.гуруҳ_охир();
6161

62-
чоп.гурӯҳ("Танзимоти система");
62+
чоп.гуруҳ("Танзимоти система");
6363
чоп.сабт("ОС: Windows 11");
6464
чоп.сабт("RAM: 16GB");
6565
чоп.сабт("CPU: Intel i7");
66-
чоп.анҷомиГурӯҳ();
66+
чоп.гуруҳ_охир();
6767

6868
// console.groupCollapsed - collapsed group
69-
чоп.гурӯҳиПечида("Тафсилоти иловагӣ");
69+
чоп.гуруҳ_пӯшида("Тафсилоти иловагӣ");
7070
чоп.сабт("Версияи барнома: 1.0.0");
7171
чоп.сабт("Санаи насб: 2024-01-15");
7272
чоп.сабт("Ҳаҷми файл: 2.5MB");
73-
чоп.анҷомиГурӯҳ();
73+
чоп.гуруҳ_охир();
7474

7575
// console.time and console.timeEnd - timing operations
7676
чоп.сабт("\n=== Ченкунии вақт ===");
@@ -80,7 +80,7 @@
8080
барои (тағйирёбанда и = 0; и < 1000000; и++) {
8181
натиҷа += и;
8282
}
83-
чоп.анҷомиВақт("Ҳисобкунӣ");
83+
чоп.вақт_охир("Ҳисобкунӣ");
8484
чоп.сабт("Натиҷа: " + натиҷа);
8585

8686
// Multiple timers
@@ -91,19 +91,19 @@
9191
барои (тағйирёбанда и = 0; и < 100000; и++) {
9292
// Амалиёти 1
9393
}
94-
чоп.анҷомиВақт("Амалиёти 1");
94+
чоп.вақт_охир("Амалиёти 1");
9595

9696
барои (тағйирёбанда и = 0; и < 200000; и++) {
9797
// Амалиёти 2
9898
}
99-
чоп.анҷомиВақт("Амалиёти 2");
99+
чоп.вақт_охир("Амалиёти 2");
100100

101101
// console.count - counting calls
102102
чоп.сабт("\n=== Ҳисобкунии даъватҳо ===");
103103

104104
функсия коркарди_маълумот(навъ: сатр) {
105-
чоп.шумор("Даъвати функсия");
106-
чоп.шумор("Навъи " + навъ);
105+
чоп.қайд("Даъвати функсия");
106+
чоп.қайд("Навъи " + навъ);
107107
}
108108

109109
коркарди_маълумот("корбар");
@@ -113,7 +113,7 @@
113113
коркарди_маълумот("корбар");
114114

115115
// console.countReset - reset counter
116-
чоп.сифриШумор("Даъвати функсия");
116+
чоп.қайд_асл("Даъвати функсия");
117117
чоп.сабт("Ҳисобкунак аз нав оғоз шуд");
118118
коркарди_маълумот("нав");
119119

@@ -138,7 +138,7 @@
138138
}
139139

140140
функсия функсияи_В() {
141-
чоп.пайгирӣ("Пайгирии даъватҳои функсия");
141+
чоп.пайҷо("Пайгирии даъватҳои функсия");
142142
}
143143

144144
функсияи_А();
@@ -166,7 +166,7 @@
166166
чоп.феҳрист(мошин);
167167

168168
// console.clear - clearing console (commented out to preserve output)
169-
// чоп.тоза();
169+
// чоп.полиз();
170170
// чоп.сабт("Консол тоза карда шуд!");
171171

172172
// Formatting output with CSS-like styles (browser-specific)
@@ -179,8 +179,7 @@
179179

180180
// Debug logging with context
181181
функсия дебаг_сабт(модул: сатр, паём: сатр, маълумот?: ҳар) {
182-
тағйирёбанда вақт = нав Date().toISOString();
183-
чоп.маълумот(`[${вақт}] [${модул}] ${паём}`, маълумот || "");
182+
чоп.маълумот(`[${модул}] ${паём}`, маълумот || "");
184183
}
185184

186185
дебаг_сабт("AUTH", "Корбар ворид шуд", { корбар_ид: 123 });
@@ -189,13 +188,13 @@
189188

190189
// Error logging with details
191190
функсия хато_сабт(хато: Хато, контекст?: ҳар) {
192-
чоп.гурӯҳ("🔴 Хато рух дод");
191+
чоп.гуруҳ("🔴 Хато рух дод");
193192
чоп.хато("Паём:", хато.паём);
194193
чоп.хато("Стек:", хато.stack);
195194
агар (контекст) {
196195
чоп.хато("Контекст:", контекст);
197196
}
198-
чоп.анҷомиГурӯҳ();
197+
чоп.гуруҳ_охир();
199198
}
200199

201200
кӯшиш {
@@ -206,21 +205,21 @@
206205

207206
// Performance logging
208207
функсия иҷрои_амалиёт() {
209-
чоп.гурӯҳ("⏱️ Ченкунии иҷроиш");
208+
чоп.гуруҳ("⏱️ Ченкунии иҷроиш");
210209
чоп.вақт("Вақти умумӣ");
211210

212211
чоп.вақт("Қадами 1");
213212
// Simulate work
214213
барои (тағйирёбанда и = 0; и < 100000; и++) {}
215-
чоп.анҷомиВақт("Қадами 1");
214+
чоп.вақт_охир("Қадами 1");
216215

217216
чоп.вақт("Қадами 2");
218217
// Simulate work
219218
барои (тағйирёбанда и = 0; и < 200000; и++) {}
220-
чоп.анҷомиВақт("Қадами 2");
219+
чоп.вақт_охир("Қадами 2");
221220

222-
чоп.анҷомиВақт("Вақти умумӣ");
223-
чоп.анҷомиГурӯҳ();
221+
чоп.вақт_охир("Вақти умумӣ");
222+
чоп.гуруҳ_охир();
224223
}
225224

226225
иҷрои_амалиёт();

examples/34-api-server.som

Lines changed: 13 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@
9191

9292
// API маршрутҳо - Функсияҳои ҳамзамон
9393

94-
ҳамзамон функсия гирифтани_тамоми_корбарон(хидматир: ХидматирКорбар): сатр {
94+
функсия гирифтани_тамоми_корбарон(хидматир: ХидматирКорбар): сатр {
9595
тағйирёбанда корбарон = хидматир.тамоми_корбарон();
9696
тағйирёбанда маълумот = [];
9797

@@ -110,7 +110,7 @@
110110
});
111111
}
112112

113-
ҳамзамон функсия илова_кардани_корбар(
113+
функсия илова_кардани_корбар(
114114
хидматир: ХидматирКорбар,
115115
ном: сатр,
116116
имейл: сатр,
@@ -163,7 +163,7 @@
163163
});
164164
}
165165

166-
ҳамзамон функсия гирифтани_корбар_бо_ID(хидматир: ХидматирКорбар, id: рақам): сатр {
166+
функсия гирифтани_корбар_бо_ID(хидматир: ХидматирКорбар, id: рақам): сатр {
167167
агар (id < 1) {
168168
бозгашт JSON.stringify({
169169
огоҳӣ: "Хато",
@@ -193,7 +193,7 @@
193193
});
194194
}
195195

196-
ҳамзамон функсия ҳадфи_корбар(хидматир: ХидматирКорбар, id: рақам): сатр {
196+
функсия ҳадфи_корбар(хидматир: ХидматирКорбар, id: рақам): сатр {
197197
агар (id < 1) {
198198
бозгашт JSON.stringify({
199199
огоҳӣ: "Хато",
@@ -219,13 +219,11 @@
219219
});
220220
}
221221

222-
ҳамзамон функсия санҷиши_саломатӣ(): сатр {
223-
тағйирёбанда вақт = нав Date().toISOString();
222+
функсия санҷиши_саломатӣ(): сатр {
224223
бозгашт JSON.stringify({
225224
огоҳӣ: "موفақ",
226225
код: 200,
227226
саломатӣ: "Сервер кор мекунад",
228-
вақт: вақт
229227
});
230228
}
231229

@@ -235,35 +233,35 @@
235233
тағйирёбанда хидматир = нав ХидматирКорбар();
236234

237235
чоп.сабт("1. Санҷиши саломатӣ:");
238-
тағйирёбанда оҳӣ_саломатӣ = интизор санҷиши_саломатӣ();
236+
тағйирёбанда оҳӣ_саломатӣ = санҷиши_саломатӣ();
239237
чоп.сабт(оҳӣ_саломатӣ);
240238

241239
чоп.сабт("\n2. Илова кардани корбари нав (موفақ):");
242-
тағйирёбанда оҳӣ_илова = интизор илова_кардани_корбар(хидматир, "Аҳмад Раҳимов", "ahmad@example.com", "password123");
240+
тағйирёбанда оҳӣ_илова = илова_кардани_корбар(хидматир, "Аҳмад Раҳимов", "ahmad@example.com", "password123");
243241
чоп.сабт(оҳӣ_илова);
244242

245243
чоп.сабт("\n3. Илова кардани корбари нав (хато дар имейл):");
246-
тағйирёбанда оҳӣ_хато1 = интизор илова_кардани_корбар(хидматир, "Фатима", "invalid-email", "pass123");
244+
тағйирёбанда оҳӣ_хато1 = илова_кардани_корбар(хидматир, "Фатима", "invalid-email", "pass123");
247245
чоп.сабт(оҳӣ_хато1);
248246

249247
чоп.сабт("\n4. Илова кардани корбари нав (хато дар дор-роҳ):");
250-
тағйирёбанда оҳӣ_хато2 = интизор илова_кардани_корбар(хидматир, "Алӣ", "ali@example.com", "123");
248+
тағйирёбанда оҳӣ_хато2 = илова_кардани_корбар(хидматир, "Алӣ", "ali@example.com", "123");
251249
чоп.сабт(оҳӣ_хато2);
252250

253251
чоп.сабт("\n5. Гирифтани корбари бо ID = 1:");
254-
тағйирёбанда оҳӣ_гиранда = интизор гирифтани_корбар_бо_ID(хидматир, 1);
252+
тағйирёбанда оҳӣ_гиранда = гирифтани_корбар_бо_ID(хидматир, 1);
255253
чоп.сабт(оҳӣ_гиранда);
256254

257255
чоп.сабт("\n6. Гирифтани тамоми корбарон:");
258-
тағйирёбанда оҳӣ_тамоми = интизор гирифтани_тамоми_корбарон(хидматир);
256+
тағйирёбанда оҳӣ_тамоми = гирифтани_тамоми_корбарон(хидматир);
259257
чоп.сабт(оҳӣ_тамоми);
260258

261259
чоп.сабт("\n7. Ҳадфи кардани корбари бо ID = 1:");
262-
тағйирёбанда оҳӣ_ҳадфи = интизор ҳадфи_корбар(хидматир, 1);
260+
тағйирёбанда оҳӣ_ҳадфи = ҳадфи_корбар(хидматир, 1);
263261
чоп.сабт(оҳӣ_ҳадфи);
264262

265263
чоп.сабт("\n8. Гирифтани корбари ҳадф карда шудаи ID = 1 (404):");
266-
тағйирёбанда оҳӣ_404 = интизор гирифтани_корбар_бо_ID(хидматир, 1);
264+
тағйирёбанда оҳӣ_404 = гирифтани_корбар_бо_ID(хидматир, 1);
267265
чоп.сабт(оҳӣ_404);
268266

269267
чоп.сабт("\n=== АНҶОМИ МИСОЛ ===");

examples/36-user-management.som

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -16,8 +16,7 @@
1616
ин.ID = ID;
1717
ин.ном = ном;
1818
ин.имейл = имейл;
19-
тағйирёбанда вақт = нав Date().toISOString();
20-
ин.вақти_сохт = вақт;
19+
ин.вақти_сохт = нав Date().toString();
2120
}
2221

2322
ҷамъиятӣ гирифтани_ID(): рақам {

0 commit comments

Comments
 (0)