newhelper-js 2.1.6 → 2.1.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (4) hide show
  1. package/README.md +29 -17
  2. package/history.md +30 -5
  3. package/newHelper.js +1273 -1099
  4. package/package.json +1 -1
package/newHelper.js CHANGED
@@ -1,37 +1,56 @@
1
-
2
1
  /*
3
- * Перед вами код newHelper.js версии 2.1.6, он построен на базе фабрики
2
+ * Перед вами код newHelper.js версии 2.1.7, он построен на базе фабрики
4
3
  * Которая начинается с Intl.newHelper=function(){...};
5
4
  * Причина использоватся Intl.newHelper банально проста
6
- * Если я сейчас засираю глобалскоуп одной полу гибкой переменной
5
+ * Если я в 2.1.0 засирал глобалскоуп одной полу гибкой переменной
6
+ * И парочкой addEventListener,
7
7
  * То почему бы не начать отказываться от засирания глобал скоупа как такового
8
8
  * И да, для инициализации ньюхелпера реально нужно писать
9
- * yourVariable = Intl.newHelper()
9
+ * window.yourVariable = Intl.newHelper()
10
+ * (Да, я рекомендую не бояться глобал скоупа, т.к. надеюсь
11
+ * что вы понимаете почему и зачем вы это читаете)
10
12
  *
11
13
  * Стиль комментариев
12
14
  * FIXME - странное поведение функции, которое желательно бы переделать
13
- * ??? - требует уточнения
15
+ * ну или просто заметки для себя на будущее
16
+ * HMM - требует уточнения
14
17
  * !!! - обратите внимание
15
18
  * See also - почитайте для понимания как устроено
19
+ *
16
20
  *
17
- * ???: рассмотреть переход на es6 экспорт вместо вкладывания фабрики в Intl
21
+ * HMM: рассмотреть переход на es6 экспорт вместо вкладывания фабрики в Intl
22
+ * HMM: рассмотреть переделку окон под iife фабрику
18
23
  *
24
+ * Модули пришедшие с релизом 2.1:
25
+ * link
26
+ * lazy
27
+ * lang
28
+ * http
29
+ * html
30
+ * storage
31
+ * err
32
+ * hotkeys
33
+ * win (+wins)
34
+ *
35
+ * Модули удалённые после 2.1 (ищите полифиллы в конце файла):
36
+ * $
37
+ *
19
38
  * Новые модули, готовятсяк релизу в 2.2
20
- * их апи может быть чуть чуть нестабильно:
21
- * tables - на стадии рефакторинга
39
+ * их апи может быть чуть чуть нестабильно
40
+ * # - модуль ещё в планах:
41
+ * link (пропатченный, см. _.link.get => dynamic)
22
42
  * form
23
- * drag (портирован из окон)
24
43
  * pipe/pipeAsync
25
- * В 2.2 появятся плагины, некоторые модули ядра будут вынесены в плагины:
26
- * win (в 2.2)
27
- * tables (возможно он не будет частью ядра, но с другой стороны он полезен в админках)
28
- * http (в 2.3)
44
+ * drag (портирован из win)
45
+ * #fade (будет портирован из win._animate)
46
+ * #toast
29
47
  *
30
48
  * Модули, имена которых зарезервированы на 2.3++
31
49
  * не используйте их неймспейсы для плагинов:
32
- * toast
33
50
  * filezone
34
51
  * ikarus
52
+ * tables
53
+ * resize
35
54
  *
36
55
  * Плагины, новый паттерн который я хочу узаконить в 2.2
37
56
  * Это не _.use(), не _.plugins, не мутация прототипа
@@ -41,1096 +60,1251 @@
41
60
  * Фабрика плагина возвращает объект, метод, или класс, или что вам нужно
42
61
  * Вам для подключения плагина просто нужно дать плагину неймспейс внутри ядра
43
62
  * И вызвать фабрику, всё!
63
+ *
64
+ * О модуле таблиц!!!!
65
+ * Я его удалил потому что создавать второй движок окон мне нахуй не надо
66
+ * Эта блядота заняла бы у меня ещё порядка 200-400 строк просто чтобы стать
67
+ * "хорошей альтернативой" условным react-tables или datatables
68
+ * Если я и захочу его делать снова то ждите 2.4, может быть тогда у меня хватит ума
69
+ * Придумать как сделать правильно, и по своему
70
+ * А щас, пусть эта гнида горит в аду, не место недопиленному говну в ядре unix.js
71
+ *
72
+ * А если вам нужны именно ньюхелпер таблицы
73
+ * Будьте добры проверить исходники 2.1.6 на npm
74
+ * Или пилите самодельные таблицы через innerHTML или _.html
75
+ * Что вам удобнее то и берите
76
+ *
77
+ * Я (MIOBOMB) хочу релизнуть 2.2 уже после 2.1.8,
78
+ * ибо мне в идеале закончить тосты и Object Hub 0.97.4
44
79
  */
45
80
 
46
- Intl.newHelper=function() {let _ = {
47
- link: {
48
- /*
49
- * МОДУЛЬ ССЫЛОК
50
- *
51
- * Работает по принципу [ссылка, команды...]
52
- * Пример: ?home&debug&lang=ru
53
- * ^^^^ ^^^^^^^^^^^^^
54
- * страница команды
55
- *
56
- * В процессе разработки ядра 2.0 в Object hub я понял
57
- * Что команды могут быть очень полезными для отладки
58
- * Но в теории на них можно повешать все модальные и прочие действия
59
- *
60
- * !!!: в функции get() работает весь роутинг, в т.ч. вложенный для страниц
61
- *
62
- * See also:
63
- * - https://developer.mozilla.org/en-US/docs/Web/API/History_API
64
- */
65
- basePage: ()=>{},
66
- defTitle: '',
67
- actions: {},
68
- commands: {},
81
+ /** @import { NewHelper } from './newHelper.d.ts' */
82
+ Intl.newHelper=function() {
83
+ /** @type {NewHelper} */
84
+ let _ = {
85
+
86
+ link: {
87
+ /*
88
+ * МОДУЛЬ ССЫЛОК
89
+ * Author: MIOBOMB (2023-2026)
90
+ * Last patch: 2.1.7
91
+ *
92
+ * Работает по принципу [ссылка, команды...]
93
+ * Пример: ?home&debug&lang=ru
94
+ * ^^^^ ^^^^^^^^^^^^^
95
+ * страница команды
96
+ *
97
+ * В процессе разработки ядра 2.0 в Object hub я понял
98
+ * Что команды могут быть очень полезными для отладки
99
+ * Но в теории на них можно повешать все модальные и прочие действия
100
+ *
101
+ * !!!: в функции get() работает весь роутинг, в т.ч. вложенный для страниц
102
+ *
103
+ * See also:
104
+ * - https://developer.mozilla.org/en-US/docs/Web/API/History_API
105
+ */
106
+ basePage: ()=>{},
107
+ defTitle: '',
108
+ actions: {},
109
+ commands: {},
110
+
111
+ _i: true, // _i - блокировщик pushState в set()
112
+ _pop() {
113
+ /*
114
+ * Popstate движок
115
+ *
116
+ * Сделан он для сохранения команд в истории
117
+ * Это уникальная фича newHelper.js
118
+ *
119
+ * Зачем я сделал сохранение команд?
120
+ * Он вырос из потребностей object hub
121
+ * Для меня это потребность сохранять
122
+ * отладочные состояния в url
123
+ * или вызывать функции одноразки, например:
124
+ * - вызов модалки с конкретными данными (&user=1)
125
+ * - смена настроек SPA по команде (язык, тема...)
126
+ * -
127
+ * - сброс localStorage
128
+ * для вас это может быть всё что угодно
129
+ * но если он вам не нужен - link.popInit=true
130
+ *
131
+ * popstate срабатывает когда:
132
+ * - пользователь прыгает по истории назад/вперёд
133
+ * - мы вызываем history.pushState (не replaceState)
134
+ *
135
+ * _i различает эти случаи:
136
+ * true = пользователь прыгнул назад
137
+ * false = страница пишет свой адрес в ссылку
138
+ */
139
+ // HMM: некоторые браузеры могут вызывать popstate и при реплейсе
140
+ if (!this._i) {
141
+ // здесь происходит перенос команд при popstate
142
+ // читайте _.link.get() если хотите узнать почему
143
+ let newUrl='?' + [this.compile()[0],...this._cmd].join('&');
144
+ this._i=true;
145
+ history.replaceState(null,null,newUrl);
146
+ this.get();
147
+ } else
148
+ this._i=false;
149
+ },
150
+ _cmd: [],
151
+ popInit: false,
152
+ _init() {
153
+ if (!this.popInit) {
154
+ window.addEventListener('popstate', ()=>this._pop());
155
+ this.popInit = true;
156
+ }
157
+ },
158
+
159
+ compile: (e=location.search)=>e.replace('?','').split('&'),
160
+ set(page, title = this.defTitle) {
161
+ if (title) document.title = title;
162
+ if (!this._i) {
163
+ let link = this.compile();
164
+ link[0] = page;
165
+ history.pushState(null,null,'?'+link.join('&'));
166
+ }
167
+ this._i = false;
168
+ },
169
+ add(cmd) {
170
+ let link = this.compile();
171
+ if (!link.includes(cmd)) {
172
+ link.push(cmd);
173
+ this._cmd.push(cmd);
174
+ history.replaceState(null,null,'?'+link.join('&'));
175
+ }
176
+ },
177
+ remove(cmd) {
178
+ let link = this.compile();
179
+ if (link.includes(cmd)){
180
+ let c = this._cmd;
181
+ link.splice(link.indexOf(cmd),1);
182
+ c.splice(c.indexOf(cmd),1);
183
+ history.replaceState(null,null,'?'+link.join('&'));
184
+ }
185
+ },
186
+
187
+ get() {
188
+ this._init();
189
+ /*
190
+ * Страницы бросают ошибку чтобы вызвать базовую страницу
191
+ * Команды тем временем так не делают
192
+ * Потому что сломанная команда не так страшна как сломанная страница
193
+ * И вдруг на вашем сайте висит трекер от гугла который что то пишет в url
194
+ *
195
+ * При popstate команды берутся из хранилища _cmd, вместо самой ссылки
196
+ * Сделано это для переноса команд при прыжках по истории
197
+ */
198
+ let links = this.compile(),
199
+ [ firstKey, fisrtValue ] = links[0].split('='),
200
+ cmds = links.slice(1);
201
+ try {
202
+ let route = firstKey.split('/'),
203
+ dir = this.actions,
204
+ main = dir[firstKey];
205
+ if (!firstKey.includes('/')) {
206
+ main(fisrtValue);
207
+ } else {
208
+ /*
209
+ * ВЛОЖЕННЫЙ РОУТЕР
210
+ *
211
+ * Фича которую я сделал случайно
212
+ * в поединке с бекендером-вайбкодером
213
+ *
214
+ * Заодно со скуки я сделал динамические маршруты
215
+ * Я офигел когда понял что они полностью рабочие
216
+ * Впрочем динамика работает также как и везде
217
+ * называете свой ключ с двоеточия и всё работает
218
+ *
219
+ * !!!:
220
+ * Чтобы создать вложенность вам нужно
221
+ * сделать объект вместо функции
222
+ * и обязательно добавить "/" в конце ключа
223
+ * и внутри объекта уже описывать либо
224
+ * ещё большую вложенность, либо маршруты
225
+ * ТАКЖЕ
226
+ * Если вы используете динамический роутер
227
+ * Ваши query параметры будут удалены
228
+ * А сама переменная передаваемая в функцию
229
+ * Станет массивом, который нужно раскрыть
230
+ * Количество динамики в пути - количество элементов массива
231
+ *
232
+ * Пример роутера:
233
+ *
234
+ * {
235
+ * '': ()=>mainPage(),
236
+ * 'account/': {
237
+ * '': ()=>profile(),
238
+ * 'settings':()=>settings()
239
+ * },
240
+ * 'product': e=>getProduct(e),
241
+ * 'user/': {
242
+ * ':id': ...e=>getProfile(...e)
243
+ * }
244
+ * }
245
+ *
246
+ * FIXME:
247
+ * сделать документацию
248
+ * или хотябы интродакшн с интерактивом
249
+ */
250
+ let dynamic = [];
251
+ for (let point of route){
252
+ let isDyn = Object.keys(dir).find(e=>e.startsWith(':'));
253
+ if (isDyn) {
254
+ dynamic.push(point);
255
+ point = isDyn;
256
+ if (point.endsWith('/'))
257
+ point = point.slice(0,-1);
258
+ }
259
+ let kDir = dir[point+'/'];
260
+ if (kDir)
261
+ dir = kDir;
262
+ else {
263
+ if (dynamic.length)
264
+ fisrtValue = dynamic;
265
+ dir[point](fisrtValue);
266
+ break;
267
+ }
268
+ }
269
+ }
270
+ } catch (e) {
271
+ this.basePage();
272
+ throw e;
273
+ }
274
+ this._cmd = cmds;
275
+ cmds.forEach(cmdPre => {
276
+ let [ key, value ] = cmdPre.split('=');
277
+ let cmd = this.commands[key];
278
+ if (cmd)
279
+ cmd(value);
280
+ else
281
+ console.error(new Error(`command '${cmd}' doesn't exist!`))
282
+ });
283
+ },
284
+ },
285
+
286
+ lazy: {
287
+ /*
288
+ * МОДУЛЬ ЛЕНИ
289
+ * Author: MIOBOMB (2024-2026)
290
+ * Last patch: 2.1.4
291
+ *
292
+ * Создаёт в глобальной области видимости прокси функции
293
+ * Вызывающие загрузку скрипта с внещним модулем
294
+ * Был сделан через глобальную область, так намного проще создавать лень
295
+ *
296
+ * !!!: Функции обёртки в register() должны быть повешаны на window
297
+ * Иначе lazy._ провалится в рекурсию ошибок, не наступайте на мои грабли
298
+ *
299
+ * HMM: будет ли легче создавать лень в легаси проектах через es6 импорты
300
+ *
301
+ * See also:
302
+ * - https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script
303
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/window
304
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function (для _())
305
+ */
306
+ loaded: {},
307
+ load(url, ...args) {
308
+ /*
309
+ * ...args передаются в Promise.resolve(args)
310
+ * Это позволяет делать _.lazy.load('script.js', 'данные', 'для', 'колбека')
311
+ * И потом в .then((a,b,c)=>...) получать эти аргументы
312
+ *
313
+ * Тройное состояние скрипта в lazy.loaded:
314
+ * - true: уже загружен => сразу резолвим
315
+ * - Promise: грузится сейчас => ждём тот же промис
316
+ * - undefined: ещё не грузили => создаём новый промис
317
+ *
318
+ * Это защита от двойной загрузки одного скрипта
319
+ */
320
+ let key = url.split('?')[0], // отсекаем параметры, чтобы не дублировать
321
+ state = this.loaded;
322
+ if (state[key] === true)
323
+ return Promise.resolve(args);
324
+ if (state[key] instanceof Promise)
325
+ return state[key].then(()=>args);
326
+
327
+ let promise = new Promise((resolve,reject)=>{
328
+ let scr = document.createElement('script');
329
+ scr.src = url;
330
+ scr.onload = ()=>{
331
+ state[key] = true;
332
+ resolve(args);
333
+ };
334
+ scr.onerror = ()=>{
335
+ delete state[key];
336
+ reject(new Error('Failed to load '+url));
337
+ };
338
+ document.head.append(scr);
339
+ });
340
+ state[key] = promise;
341
+ return promise;
342
+ },
343
+ register(script, funcs) {
344
+ for (let fn of funcs) {
345
+ let fns = fn.split('.'),
346
+ method = fns.pop(),
347
+ path = window;
348
+ for (let obj of fns) {
349
+ if (path[obj] == undefined)
350
+ path[obj] = {};
351
+ path = path[obj];
352
+ }
353
+ path[method] = (...a)=>
354
+ this._(script,fn).then(f=>f(...a));
355
+ }
356
+ },
357
+ async _(scr, fn) {
358
+ let get = path => path.split('.').reduce((obj, key) => obj?.[key], window),
359
+ wrapper = get(fn);
360
+
361
+ await this.load(scr); // await короче Promise.then
362
+
363
+ if (wrapper !== get(fn))
364
+ return get(fn);
365
+ throw new Error(`Function ${fn} not loaded from ${scr}`);
366
+ },
367
+ },
368
+
369
+ lang: {
370
+ /*
371
+ * МОДУЛЬ ПЕРЕВОДОВ (l10n)
372
+ * Author: MIOBOMB (2024-2026)
373
+ * Contributors:
374
+ * - DenisC - логика метода load + патч всего модуля (2025)
375
+ * Last patch: 2.1.7
376
+ *
377
+ * По слухам этот модуль лучше чем многие i18n реализации, и лучше всех l10n
378
+ * Всё потому что он из коробки умеет переводить страницу без перезагрузки
379
+ *
380
+ * !!!: parse() обрабатывает ключи из vars и подставляет их значения
381
+ * ваш +ключ+ становится значением, и это значение динамичное
382
+ * Так удобнее отображать динамичные данные на сайтах
383
+ * Например никнейм пользователя
384
+ *
385
+ * !!!: Это l10n (локализация), а не i18n (интернационализация)
386
+ *
387
+ * i18n — подготовка кода: вынос строк в JSON, поддержка Unicode,
388
+ * гибкая верстка. Делается один раз.
389
+ *
390
+ * l10n - перевод JSON и адаптация под язык/регион
391
+ *
392
+ * lang - загружает JSON, подставляет +переменные+,
393
+ * даёт реактивную смену языка на странице
394
+ *
395
+ * Чтобы частично приблизить lang к i18n используйте Intl,
396
+ * Нативное апи интернационализации (даты, числа, валюты)
397
+ *
398
+ * See also:
399
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
400
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function
401
+ * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset (data-trans атрибуты)
402
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl
403
+ * - https://localizejs.com/articles/i18n-vs-l10n
404
+ */
405
+ addr: '',
406
+ vars: {},
407
+ // HMM:
408
+ // переделать main на мапу т.к. внутреннее api?
409
+ // или сохранить оригинальное api на объекте
410
+ main: {},
411
+
412
+ // FIXME: переделать на fetch для устранения связности
413
+ load: name => _.http.req('GET', _.lang.addr + name + '.json'),
414
+ parse: (packet, vars = _.lang.vars)=>
415
+ // HMM: переделать под общий синтаксис типа {var}
416
+ packet.replace(/\+([^+]+)\+/g, (match, key)=>{
417
+ let v = vars[key];
418
+ return v !== undefined ? v : match;
419
+ }),
420
+ async replace(name){
421
+ const packet = await this.load(name);
422
+ this.main = JSON.parse(this.parse(packet)); // без замены языка нельзя начинать перевод
423
+
424
+ for (let el of document.querySelectorAll(`[${this.attr}]`)) {
425
+ let key = el.dataset.trans,
426
+ text = this.main[key] || key,
427
+ tag = el.tagName;
428
+
429
+ if (tag === 'IMG')
430
+ el.src = text;
431
+ else if (['INPUT','TEXTAREA'].includes(tag))
432
+ el[ el.type === 'submit' ? 'value' : 'placeholder' ] = text;
433
+ else
434
+ el.innerHTML = text;
435
+ }
436
+ // возвращаем для последующей обработки пакета, например для сохранения в _.storage
437
+ return packet;
438
+ },
439
+
440
+ /*
441
+ * Получатели строки из пакета автоматически формируют HTML
442
+ * Это позволяет заметно упростить работу с кодом
443
+ * Вместо отдельного указания data-trans и lang.from
444
+ * вы можете написать `<h1${_.lang.text('yourKey')}/h1>`
445
+ * А пришлось бы писать `<h1 data-trans="yourKey">${_.lang.from('yourKey')}</h1>`
446
+ * Согласитесь, и короче и удобнее ведь?
447
+ * Не повторяйте моих ошибок и примите это как победу в лотерее
448
+ *
449
+ * !!!: если ключа в пакете нету, будет выброшен warning
450
+ */
451
+ attr: ` data-trans`,
452
+ from: i=>_.lang.main[i] || console.warn(`_.lang> ${i} is undefined`) || i,
453
+
454
+ text: i=>_.lang.attr+`="${i}">${_.lang.from(i)}<`,
455
+ submit: i=>_.lang.attr+`="${i}" value="${_.lang.from(i)}">`, // <input type=submit>
456
+ input: i=>_.lang.attr+`="${i}" placeholder="${_.lang.from(i)}">`,
457
+ textarea: i=>_.lang.attr+`="${i}" placeholder="${_.lang.from(i)}"><`,
458
+ img: i=>_.lang.attr+`="${i}" src="${_.lang.from(i)}"`,
459
+ winTitle(i) {
460
+ let text = this.from(i),
461
+ dataTrans = _.lang.attr[i]+`="${i}"`;
462
+ if (text == null || text == '') {
463
+ text = i;
464
+ dataTrans = '';
465
+ }
466
+ return `${dataTrans}>${text}<`;
467
+ },
468
+ },
469
+
470
+ http: {
471
+ /*
472
+ * HTTP-КЛИЕНТ
473
+ * Author: MIOBOMB (2024-2026)
474
+ * Last patch: 2.1.4
475
+ *
476
+ * Обычная обёртка нав XHR для быстрых запросов
477
+ * Использую XHR вместо fetch
478
+ * Мне нужен прогресс загрузки (fetch его не даёт)
479
+ * Да и вам тоже не помешает прогресс загрузки
480
+ *
481
+ * В defaultHeaders вы можете установить хедеры по умолчанию
482
+ * Как пример Authorization: 'your token'
483
+ * HMM: добавить возможность игнорировать дефолтные хедеры
484
+ *
485
+ * See also:
486
+ * - https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
487
+ * - https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/progress
488
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
489
+ */
490
+ defaultHeaders: {},
491
+ req(method, url, data = '', headers = {}, fileProgressElement = false) {
492
+ return new Promise((resolve, reject)=>{
493
+ let xhr = new XMLHttpRequest();
494
+
495
+ xhr.open(method, url);
496
+
497
+ let allHeaders = { ...this.defaultHeaders, ...headers };
498
+ for (let header in allHeaders)
499
+ xhr.setRequestHeader(header, allHeaders[header]);
500
+
501
+ // !!!: fileProgressElement ожидает <progress> элемент без min/max
502
+ // Потому что value от 0 до 1
503
+ if (fileProgressElement)
504
+ xhr.upload.onprogress= e=>{
505
+ if (e.lengthComputable) {
506
+ let percentage = (e.loaded / e.total);
507
+ fileProgressElement.setAttribute('value', percentage);
508
+ }
509
+ };
510
+
511
+ xhr.onreadystatechange= ()=>{
512
+ if (xhr.readyState=== 4)
513
+ if (xhr.status >= 200 && xhr.status < 300)
514
+ resolve(xhr.response);
515
+ else
516
+ reject(new Error(`${xhr.status} - ${xhr.statusText}`),xhr);
517
+ };
518
+ xhr.onerror = ()=>
519
+ reject(new Error('Network error'), xhr);
520
+
521
+ xhr.send(data);
522
+ });
523
+ },
524
+ get: (url, headers={})=>
525
+ _.http.req('GET', url, false, headers),
526
+ post: (url, data = '', headers = {}, fileProgressElement = false)=>
527
+ _.http.req('POST', url, data, headers, fileProgressElement)
528
+ },
529
+
530
+ html(strs, ...args) {
531
+ /*
532
+ * Шаблонные строки в DOM
533
+ * Author: MIOBOMB (2026)
534
+ * Last patch: 2.1.4
535
+ *
536
+ * Позволяет писать _.html`<div>${content}</div>`
537
+ * И получать настоящий DOM-элемент, а не строку
538
+ *
539
+ * Почему через template?
540
+ * - Скрипты не выполняются (никаких xss!)
541
+ * - Можно создать несколько элементов разом
542
+ * - Быстрее чем createElement для сложных структур
543
+ * - Банально удобнее createElement для сложных древ
544
+ *
545
+ * HMM: проверить производительность этого генератора dom
546
+ *
547
+ * See also:
548
+ * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLTemplateElement
549
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Document/createTreeWalker
550
+ */
551
+ let fullStr = '',
552
+ DOMs = [];
553
+ for (let i=0; i < args.length; i++) {
554
+ fullStr += strs[i];
555
+ let arg = args[i];
556
+ if (arg && arg.nodeType) {
557
+ fullStr += `<!--${DOMs.length}-->`;
558
+ DOMs.push(arg);
559
+ } else {
560
+ fullStr += arg;
561
+ }
562
+ }
563
+ fullStr += strs[strs.length - 1];
564
+
565
+ const template = document.createElement('template');
566
+ template.innerHTML = fullStr;
567
+ const content = template.content;
568
+
569
+ // для создания вложенности html элементов заменяем плейсхолдеры
570
+ const it = document.createTreeWalker(
571
+ content,
572
+ NodeFilter.SHOW_COMMENT
573
+ );
574
+ let node, i = 0;
575
+ for (; node = it.nextNode(); )
576
+ node.replaceWith(DOMs[i++]);
577
+
578
+ if (content.children.length === 1)
579
+ return content.firstChild;
580
+ return content;
581
+ },
582
+
583
+ pipe(data, ...fns) {
584
+ /*
585
+ * КАСТОМНЫЙ PIPE ОПЕРАТОР
586
+ * Author: MIOBOMB (2026)
587
+ * Last patch: 2.1.4
588
+ *
589
+ * Никакой магии, обычный синхронный |>
590
+ * для мутации таблиц будет самое то
591
+ *
592
+ * See also:
593
+ * - https://github.com/tc39/proposal-pipeline-operator/blob/main/README.md
594
+ */
595
+ for (const fn of fns)
596
+ data = fn(data);
597
+ return data;
598
+ },
599
+
600
+ async pipeAsync(data, ...fns) {
601
+ /*
602
+ * КАСТОМНЫЙ PIPE ОПЕРАТОР 2
603
+ * Author: MIOBOMB (2026)
604
+ * Last patch: 2.1.7
605
+ *
606
+ * Никакой магии, обычный асинхронный |>
607
+ * для получения и мутации данных сойдёт
608
+ *
609
+ * See also:
610
+ * - https://github.com/tc39/proposal-pipeline-operator/blob/main/README.md
611
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function
612
+ */
613
+ for (const fn of fns) {
614
+ let waiter = await data;
615
+ data = await fn(waiter);
616
+ }
617
+ return data;
618
+ },
69
619
 
70
- _i: true, // _i - блокировщик pushState в set()
71
- _pop() {
72
- /*
73
- * Popstate движок
74
- *
75
- * Сделан он для сохранения команд в истории
76
- * Это уникальная фича newHelper.js
77
- *
78
- * popstate срабатывает когда:
79
- * - пользователь прыгает по истории назад/вперёд
80
- * - мы вызываем history.pushState (не replaceState)
81
- *
82
- * _i различает эти случаи:
83
- * true = пользователь прыгнул назад
84
- * false = страница пишет свой адрес в ссылку
85
- */
86
- // ???: некоторые браузеры могут вызывать popstate и при реплейсе
87
- if (!this._i) {
88
- // здесь происходит перенос команд при popstate
89
- // читайте _.link.get() если хотите узнать почему
90
- let newUrl='?' + [this.compile()[0],...this._cmd].join('&');
91
- this._i=true;
92
- history.replaceState(null,null,newUrl);
93
- this.get();
94
- } else
95
- this._i=false;
96
- },
97
- _cmd: [],
98
- _popInit: false,
99
- _init() {
100
- if (!this._popInit) {
101
- window.addEventListener('popstate', ()=>this._pop());
102
- this._popInit = true;
103
- }
104
- },
620
+ form: { // TS DONE HMM no
621
+ /*
622
+ * АВТОСОХРАНЕНИЕ ФОРМ
623
+ * Author: MIOBOMB (2026)
624
+ * Last patch: 2.1.4
625
+ *
626
+ * Позволяет сохранять состояние формы на случай
627
+ * Если в офисе внезапно выключат свет
628
+ *
629
+ * HMM: может сделать более полноценный модуль форм
630
+ * с встроенной валидацией, или чем нибуть ещё
631
+ *
632
+ * See also:
633
+ * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement
634
+ * - https://developer.mozilla.org/en-US/docs/Web/API/FormData/FormData
635
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax
636
+ */
637
+ read(form) {
638
+ let data = {};
639
+ new FormData(form).forEach((value, key)=>{
640
+ if (data[key] !== undefined) {
641
+ if (!Array.isArray(data[key]))
642
+ data[key] = [data[key]];
643
+ else
644
+ data[key].push(value);
645
+ } else
646
+ data[key] = value;
647
+ });
648
+ return data;
649
+ },
650
+ write(form, data) {
651
+ Object.entries(data).forEach(([key,value])=>{
652
+ let el = form.elements[key];
653
+ if (!el)
654
+ return;
655
+ if (el.length)
656
+ [...el].forEach((opt,i)=>{
657
+ let isCheckBox = 'selected';
658
+ if (['checkbox','radio'].includes(opt.type))
659
+ isCheckBox = 'checked';
660
+
661
+ let select = false;
662
+ if (Array.isArray(value)) {
663
+ if (value.includes(opt.value))
664
+ select = true;
665
+ } else if (opt.value == value)
666
+ select = true;
667
+
668
+ opt[isCheckBox] = select;
669
+ });
670
+ else
671
+ el.value = value;
672
+ });
673
+ return data;
674
+ },
675
+ },
105
676
 
106
- compile: ()=>location.search.replace('?','').split('&'),
107
- set(page, title = this.defTitle) {
108
- if (title) document.title = title;
109
- if (!this._i) {
110
- let link = this.compile();
111
- link[0] = page;
112
- history.pushState(null,null,'?'+link.join('&'));
113
- }
114
- this._i = false;
115
- },
116
- add(cmd) {
117
- let link = this.compile();
118
- if (!link.includes(cmd)) {
119
- link.push(cmd);
120
- this._cmd.push(cmd);
121
- history.replaceState(null,null,'?'+link.join('&'));
122
- }
123
- },
124
- remove(cmd) {
125
- let link = this.compile();
126
- if (link.includes(cmd)){
127
- let c = this._cmd;
128
- link.splice(link.indexOf(cmd),1);
129
- c.splice(c.indexOf(cmd),1);
130
- history.replaceState(null,null,'?'+link.join('&'));
131
- }
132
- },
133
- get() {
134
- this._init();
135
- /*
136
- * Страницы бросают ошибку чтобы вызвать базовую страницу
137
- * Команды тем временем так не делают
138
- * Потому что сломанная команда не так страшна как сломанная страница
139
- *
140
- * При popstate команды берутся из хранилища _cmd, вместо самой ссылки
141
- * Сделано это для переноса команд при прыжках по истории
142
- */
143
- let links = this.compile(),
144
- [ firstKey, fisrtValue ] = links[0].split('='),
145
- cmds = links.slice(1);
146
- try {
147
- let dirs = firstKey.split('/'),
148
- dir = this.actions,
149
- main = dir[firstKey];
150
- if (!firstKey.includes('/')) {
151
- main(fisrtValue);
152
- } else {
153
- for (let p of dirs){
154
- let kDir = dir[p+'/'];
155
- if (kDir)
156
- dir = kDir;
157
- else{
158
- dir[p](fisrtValue);
159
- break;
160
- }
161
- }
162
- }
163
- } catch (e) {
164
- this.basePage();
165
- throw e;
166
- }
167
- this._cmd = cmds;
168
- cmds.forEach(cmdPre => {
169
- let [ key, value ] = cmdPre.split('=');
170
- let cmd = this.commands[key];
171
- if (cmd)
172
- cmd(value);
173
- else
174
- console.error(new Error(`command '${cmd}' doesn't exist!`))
175
- });
176
- },
177
- },
178
- lazy: {
179
- /*
180
- * МОДУЛЬ ЛЕНИ
181
- *
182
- * Создаёт в глобальной области видимости прокси функции
183
- * Вызывающие загрузку скрипта с внещним модулем
184
- * Был сделан через глобальную область, так намного проще создавать лень
185
- *
186
- * !!!: Функции обёртки в register() должны быть повешаны на window
187
- * Иначе lazy._ провалится в рекурсию ошибок, не наступайте на мои грабли
188
- *
189
- * ???: будет ли легче создавать лень в легаси проектах через es6 импорты
190
- *
191
- * See also:
192
- * - https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/script
193
- * - https://developer.mozilla.org/en-US/docs/Web/API/Window/window
194
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function (для lazy())
195
- */
196
- loaded: {},
197
- load(url, ...args) {
198
- /*
199
- * ...args передаются в Promise.resolve(args)
200
- * Это позволяет делать _.lazy.load('script.js', 'данные', 'для', 'колбека')
201
- * И потом в .then((a,b,c)=>...) получать эти аргументы
202
- *
203
- * Тройное состояние скрипта в lazy.loaded:
204
- * - true: уже загружен => сразу резолвим
205
- * - Promise: грузится сейчас => ждём тот же промис
206
- * - undefined: ещё не грузили => создаём новый промис
207
- *
208
- * Это защита от двойной загрузки одного скрипта
209
- */
210
- let key = url.split('?')[0], // отсекаем параметры, чтобы не дублировать
211
- state = this.loaded;
212
- if (state[key] === true)
213
- return Promise.resolve(args);
214
- if (state[key] instanceof Promise)
215
- return state[key].then(()=>args);
216
-
217
- let promise = new Promise((resolve,reject)=>{
218
- let scr = document.createElement('script');
219
- scr.src = url;
220
- scr.onload = ()=>{
221
- state[key] = true;
222
- resolve(args);
223
- };
224
- scr.onerror = ()=>{
225
- delete state[key];
226
- reject(new Error('Failed to load '+url));
227
- };
228
- document.head.append(scr);
229
- });
230
- state[key] = promise;
231
- return promise;
232
- },
233
- register(script, funcs) {
234
- if (!Array.isArray(funcs))
235
- return new Error('Array required for register');
236
-
237
- for (let fn of funcs) {
238
- let fns = fn.split('.'),
239
- method = fns.pop(),
240
- path = window;
241
- for (let obj of fns) {
242
- if (path[obj] == undefined)
243
- path[obj] = {};
244
- path = path[obj];
245
- }
246
- path[method] = (...a)=>
247
- this.lazy(script,fn).then(f=>f(...a));
248
- }
249
- },
250
- async lazy(scr, fn) {
251
- let get = path => path.split('.').reduce((obj, key) => obj?.[key], window),
252
- wrapper = get(fn);
253
-
254
- await this.load(scr); // await короче Promise.then
255
-
256
- if (wrapper !== get(fn))
257
- return get(fn);
258
- throw new Error(`Function ${fn} not loaded from ${scr}`);
259
- },
260
- },
261
- lang: {
262
- /*
263
- * МОДУЛЬ ПЕРЕВОДОВ (l10n)
264
- *
265
- * По слухам этот модуль лучше чем многие i18n реализации, и лучше всех l10n
266
- * Всё потому что он из коробки умеет переводить страницу без перезагрузки
267
- *
268
- * !!!: parse() обрабатывает ключи из vars и подставляет их значения
269
- * ваш +ключ+ становится значением, и это значение динамичное
270
- * Так удобнее отображать динамичные данные на сайтах
271
- * Например никнейм пользователя
272
- *
273
- * !!!: Это l10n (локализация), а не i18n (интернационализация)
274
- *
275
- * i18n — подготовка кода: вынос строк в JSON, поддержка Unicode,
276
- * гибкая верстка. Делается один раз.
277
- *
278
- * l10n - перевод JSON и адаптация под язык/регион
279
- *
280
- * lang - загружает JSON, подставляет +переменные+,
281
- * даёт реактивную смену языка на странице
282
- *
283
- * Чтобы частично приблизить lang к i18n используйте Intl,
284
- * Нативное апи интернационализации (даты, числа, валюты)
285
- *
286
- * See also:
287
- * - https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
288
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function
289
- * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/dataset (data-trans атрибуты)
290
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl
291
- * - https://localizejs.com/articles/i18n-vs-l10n
292
- */
293
- addr: '',
294
- vars: {},
295
- // FIXME: переделать main на мапу т.к. внутреннее api?
296
- // или сохранить оригинальное api на объекте
297
- main: {},
298
-
299
- load: name => _.http.req('GET', _.lang.addr + name + '.json'),
300
- parse: (packet, vars = _.lang.vars)=>
301
- // ???: переделать под общий синтаксис типа {var}
302
- packet.replace(/\+([^+]+)\+/g, (match, key)=>{
303
- let v = vars[key];
304
- return v !== undefined ? v : match;
305
- }),
306
- async replace(name){
307
- const packet = await this.load(name);
308
- this.main = JSON.parse(this.parse(packet)); // без замены языка нельзя начинать перевод
309
-
310
- for (let el of document.querySelectorAll('[data-trans]')) {
311
- let key = el.dataset.trans,
312
- text = this.main[key] || key,
313
- tag = el.tagName;
314
-
315
- if (tag === 'IMG')
316
- el.src = text;
317
- else if (['INPUT','TEXTAREA'].includes(tag))
318
- el[ el.type === 'submit' ? 'value' : 'placeholder' ] = text;
319
- else
320
- el.innerHTML = text;
321
- }
322
- // возвращаем для последующей обработки пакета, например для сохранения в _.storage
323
- return packet;
324
- },
325
-
326
- /*
327
- * Получатели строки из пакета автоматически формируют HTML
328
- * Это позволяет заметно упростить работу с кодом
329
- * Вместо отдельного указания data-trans и lang.from
330
- * вы можете написать `<h1${_.lang.text('yourKey')}/h1>`
331
- * А пришлось бы писать `<h1 data-trans="yourKey">${_.lang.from('yourKey')}</h1>`
332
- * Согласитесь, и короче и удобнее ведь?
333
- * Не повторяйте моих ошибок и примите это как победу в лотерее
334
- *
335
- * !!!: если ключа в пакете нету, будет выброшен warning
336
- */
337
- attr: i=>` data-trans="${i}"`,
338
- from: i=>_.lang.main[i] || console.warn(`_.lang> ${i} is undefined`) || i,
339
-
340
- text: i=>_.lang.attr(i)+`>${_.lang.from(i)}<`,
341
- submit: i=>_.lang.attr(i)+`value="${_.lang.from(i)}">`, // <input type=submit>
342
- input: i=>_.lang.attr(i)+`placeholder="${_.lang.from(i)}">`,
343
- textarea: i=>_.lang.attr(i)+`placeholder="${_.lang.from(i)}"><`,
344
- img: i=>_.lang.attr(i)+`src="${_.lang.from(i)}"`,
345
- winTitle(i) {
346
- let text = this.from(i),
347
- dataTrans = this.attr(i);
348
- if (text == null || text == '') {
349
- text = i;
350
- dataTrans = '';
351
- }
352
- return `${dataTrans}>${text}<`;
353
- },
354
- },
355
- http: {
356
- /*
357
- * HTTP-КЛИЕНТ
358
- *
359
- * Обычная обёртка нав XHR для быстрых запросов
360
- * Использую XHR вместо fetch
361
- * Мне нужен прогресс загрузки (fetch его не даёт)
362
- * Да и вам тоже не помешает прогресс загрузки
363
- *
364
- * В defaultHeaders вы можете установить хедеры по умолчанию
365
- * Как пример Authorization: 'your token'
366
- * ???: добавить возможность игнорировать дефолтные хедеры
367
- *
368
- * See also:
369
- * - https://developer.mozilla.org/en-US/docs/Web/API/XMLHttpRequest
370
- * - https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Elements/progress
371
- * - https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API
372
- */
373
- defaultHeaders: {},
374
- req(method, url, data = '', headers = {}, fileProgressElement = false) {
375
- return new Promise((resolve, reject)=>{
376
- let xhr = new XMLHttpRequest();
377
-
378
- xhr.open(method, url);
379
-
380
- let allHeaders = { ...this.defaultHeaders, ...headers };
381
- for (let header in allHeaders)
382
- xhr.setRequestHeader(header, allHeaders[header]);
383
-
384
- // !!!: fileProgressElement ожидает <progress> элемент без min/max
385
- // Потому что value от 0 до 1
386
- if (fileProgressElement)
387
- xhr.upload.onprogress= e=>{
388
- if (e.lengthComputable) {
389
- let percentage = (e.loaded / e.total);
390
- fileProgressElement.setAttribute('value', percentage);
391
- }
392
- };
393
-
394
- xhr.onreadystatechange= ()=>{
395
- if (xhr.readyState=== 4)
396
- if (xhr.status >= 200 && xhr.status < 300)
397
- resolve(xhr.response);
398
- else
399
- reject(new Error(`${xhr.status} - ${xhr.statusText}`),xhr);
400
- };
401
- xhr.onerror = ()=>
402
- reject(new Error('Network error'), xhr);
403
-
404
- xhr.send(data);
405
- });
406
- },
407
- get: (url, headers={})=>
408
- _.http.req('GET', url, false, headers),
409
- post: (url, data = '', headers = {}, fileProgressElement = false)=>
410
- _.http.req('POST', url, data, headers, fileProgressElement)
411
- },
412
- html(strs, ...args) {
413
- /*
414
- * Шаблонные строки в DOM
415
- *
416
- * Позволяет писать _.html`<div>${content}</div>`
417
- * И получать настоящий DOM-элемент, а не строку
418
- *
419
- * Почему через template?
420
- * - Скрипты не выполняются (никаких xss!)
421
- * - Можно создать несколько элементов разом
422
- * - Быстрее чем createElement для сложных структур
423
- * - Банально удобнее createElement для сложных древ
424
- *
425
- * See also:
426
- * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLTemplateElement
427
- * - https://developer.mozilla.org/en-US/docs/Web/API/Document/createTreeWalker
428
- */
429
- let fullStr = '',
430
- DOMs = [];
431
- for (let i=0; i < args.length; i++) {
432
- fullStr += strs[i];
433
- let arg = args[i];
434
- if (arg && arg.nodeType) {
435
- fullStr += `<!--${DOMs.length}-->`;
436
- DOMs.push(arg);
437
- } else {
438
- fullStr += arg;
439
- }
440
- }
441
- fullStr += strs[strs.length - 1];
442
-
443
- const template = document.createElement('template');
444
- template.innerHTML = fullStr;
445
- const content = template.content;
446
-
447
- // для создания вложенности html элементов заменяем плейсхолдеры <!--${DOMs.length}-->
448
- const it = document.createTreeWalker(
449
- content,
450
- NodeFilter.SHOW_COMMENT
451
- );
452
- let node, i = 0;
453
- for (; node = it.nextNode(); )
454
- node.replaceWith(DOMs[i++]);
455
-
456
- if (content.children.length === 1)
457
- return content.firstChild;
458
- return content;
459
- },
460
- pipe(data, ...fns) {
461
- /*
462
- * КАСТОМНЫЙ PIPE ОПЕРАТОР
463
- *
464
- * Никакой магии, обычный синхронный |>
465
- * для мутации таблиц будет самое то
466
- *
467
- * See also:
468
- * - https://github.com/tc39/proposal-pipeline-operator/blob/main/README.md
469
- */
470
- for (const fn of fns)
471
- data = fn(data);
472
- return data;
473
- },
474
- async pipeAsync(data, ...fns) {
475
- /*
476
- * КАСТОМНЫЙ PIPE ОПЕРАТОР 2
477
- *
478
- * Никакой магии, обычный асинхронный |>
479
- * для получения и мутации данных сойдёт
480
- *
481
- * See also:
482
- * - https://github.com/tc39/proposal-pipeline-operator/blob/main/README.md
483
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function
484
- */
485
- for (const fn of fns) {
486
- let waiter = await data;
487
- data = await fn(waiter);
488
- }
489
- return data;
490
- },
491
- form: {
492
- /*
493
- * АВТОСОХРАНЕНИЕ ФОРМ
494
- *
495
- * Позволяет сохранять состояние формы на случай
496
- * Если в офисе внезапно выключат свет
497
- *
498
- * ???: может сделать более полноценный модуль форм
499
- * с встроенной валидацией, или чем нибуть ещё
500
- *
501
- * See also:
502
- * - https://developer.mozilla.org/en-US/docs/Web/API/HTMLFormElement
503
- * - https://developer.mozilla.org/en-US/docs/Web/API/FormData/FormData
504
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/Spread_syntax
505
- */
506
- read(form) {
507
- let data = {};
508
- new FormData(form).forEach((value, key)=>{
509
- if (data[key] !== undefined) {
510
- if (!Array.isArray(data[key]))
511
- data[key] = [data[key]];
512
- else
513
- data[key].push(value);
514
- } else
515
- data[key] = value;
516
- });
517
- return data;
518
- },
519
- write(form, data) {
520
- Object.entries(data).forEach(([key,value])=>{
521
- let el = form.elements[key];
522
- if (!el)
523
- return;
524
- if (el.length)
525
- [...el].forEach((opt,i)=>{
526
- let isCheckBox = 'selected';
527
- if (['checkbox','radio'].includes(opt.type))
528
- isCheckBox = 'checked';
529
-
530
- let select = false;
531
- if (Array.isArray(value)) {
532
- if (value.includes(opt.value))
533
- select = true;
534
- } else if (opt.value == value)
535
- select = true;
536
-
537
- opt[isCheckBox] = select;
538
- });
539
- else
540
- el.value = value;
541
- });
542
- return data;
543
- },
544
- },
545
- tables(elem, name, columns, raw, rowKey = 'ID') {
546
- /*
547
- * МОДУЛЬ АВТОТАБЛИЦ
548
- *
549
- * Позволяет быстро генерировать таблицы с особыми свойствами
550
- *
551
- * !!!: в columns параметр mutate работает как парсер значения
552
- * !!!: сортируйте сами путём мутации data, javascript как никак умеет
553
- * или вообще сортируйте на сервере
554
- *
555
- * ???: рассмотреть переделку апи т.к. в текущей реализации
556
- * гибкость все ещё слишком низкая
557
- */
558
- if (!Array.isArray(raw))
559
- raw = Object.values(raw);
560
- let state = {
561
- name: name,
562
- columns: columns,
563
- raw: raw,
564
- rowKey: rowKey,
565
- data: raw,
566
- elem: elem,
567
-
568
- render() {
569
- let html = '';
570
- html += `<thead><tr>`;
571
- for (let c of this.columns)
572
- html += `<th>${c.title || c.key}</th>`;
573
- html += `</tr></thead>`;
574
-
575
- html += `<tbody>`;
576
- for (let row of this.data) {
577
- let id = row[this.rowKey];
578
-
579
- html += `<tr data-id="${id}">`;
677
+ storage: class {
678
+ /*
679
+ * ИЗОЛЯТОР ХРАНИЛИЩ
680
+ * Author: MIOBOMB (2024-2026)
681
+ * Last patch: 2.1.0
682
+ *
683
+ * Обычная обёртка поверх Storage экземпляра
684
+ * Даёт простую но надёжную изоляцию хранилищ
685
+ * Но нет она не даёт вам защиту от угона хранилища
686
+ *
687
+ * See also:
688
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
689
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage
690
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Storage
691
+ */
692
+ constructor(storage, name) {
693
+ this._ = storage;
694
+ this.n = name;
695
+ }
696
+ get = key=>
697
+ this._.getItem(this.n + key);
698
+ set = (key, value)=>
699
+ this._.setItem(this.n + key, value);
700
+ remove = key=>
701
+ this._.removeItem(this.n + key);
702
+ clear = ()=>Object.keys(this._)
703
+ .filter(k => k.startsWith(this.n))
704
+ .forEach(k => this._.removeItem(k));
705
+ },
580
706
 
581
- for (let c of this.columns) {
582
- let v = row[c.key];
583
- if (c.mutate)
584
- v = c.mutate(row);
585
- html += `<td>${v ?? ``}</td>`;
586
- }
587
- html += `</tr>`;
588
- }
589
- html += `</tbody>`;
590
-
591
- this.elem.innerHTML = `<table>${html}</table>`;
592
- }
593
- };
594
- return state;
595
- },
596
- storage: class {
597
- // See also:
598
- // - https://developer.mozilla.org/en-US/docs/Web/API/Window/localStorage
599
- // - https://developer.mozilla.org/en-US/docs/Web/API/Window/sessionStorage
600
- // - https://developer.mozilla.org/en-US/docs/Web/API/Storage
601
- constructor(storage, name) {
602
- this._ = storage;
603
- this.n = name;
604
- }
605
- get = key=> this._.getItem(this.n + key);
606
- set = (key, value)=>this._.setItem(this.n + key, value);
607
- remove = key=> this._.removeItem(this.n + key);
608
- clear = ()=>Object.keys(this._)
609
- .filter(k => k.startsWith(this.n))
610
- .forEach(k => this._.removeItem(k));
611
- },
612
- err: {
613
- //See also:
614
- // - https://developer.mozilla.org/en-US/docs/Web/API/Window/error_event
615
- // - https://developer.mozilla.org/en-US/docs/Web/API/Window/unhandledrejection_event
616
- // - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error
617
- init() {
618
- window.addEventListener('error',_.err.handleGlobal);
619
- window.addEventListener('unhandledrejection',_.err.handleRejection);
620
- },
621
- print: (cnt,e)=>console.error(e),
622
-
623
- errors: {},
624
- _c: 0,
625
- log(err) {
626
- _.err.print(_.err._c,err);
627
- _.err._c++;
628
- _.err.errors[_.err._c]=err;
629
- },
630
- handleGlobal(message,source,line,column,error){
631
- console.error(message,source+':'+line+':'+column,error)
632
- _.err.log(message + `\n IN ${source} ON LINE ${line} IN COLUMN ${column}`);
633
- },
634
- handleRejection(e){
635
- const err = e.reason || e;
636
- console.error(err);
637
- _.err.log(
638
- `PROMISE ERROR\n`+
639
- `${e.stack || e}`
640
- );
641
- },
642
- },
643
- hotkeys: {
644
- /*
645
- * ГОРЯЧИЕ КЛАВИШЫ
646
- *
647
- * Реализует самый настоящий press/release интерфейс
648
- * Если верить минификатору, после сжатия весит всего 790 байт
649
- *
650
- * В Object Hub уже есть текстовый редактор горячих клавиш
651
- * На базе этого движка, конечно давать textarea с js кодом...
652
- * Не самая безопасная затея, но как факт кастомизация широчайшая
653
- *
654
- * _holds работает не на массивах а на new Set()
655
- * Сеты работают намного быстрее при большом объёме данных
656
- * Вы же не хотите чтобы у вас тормозил поток с 100+ хоткеями
657
- * Из-за простого печатанья?
658
- *
659
- * FIXME: Рассмотреть альтернативы e.code из-за проблем
660
- * с otg-клавиатурами на телефонах
661
- *
662
- * See also:
663
- * - https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent
664
- * - https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/code
665
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/keydown_event
666
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/keyup_event
667
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event
668
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
669
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
670
- */
671
- keys: new Map(),
672
- _holds: new Set(),
673
- _: false,
674
-
675
- _parse: combo => combo.split('+').map(k=>k.trim()),
676
- _match(keys) {
677
- // Нужно сверять все клавишы, это же КОМБИНАЦИЯ а не отдельные куски
678
- for (let k of keys) if (!this._holds.has(k)) return false;
679
- return true;
680
- },
681
- _init() {
682
- if (this._)
683
- return;
684
- document.addEventListener('keydown', e=>{
685
- this._holds.add(e.code);// key зависит от раскладки (на Qwerty 'KeyZ' — это 'z', на Йцукен — 'я')
686
- // code даёт физическое положение клавиши, что важно для игр и хоткеев, и в целом универсальнее
687
-
688
- for (let hotkey of this.keys.values()) {
689
- if (!this._match(hotkey.keys))
690
- continue;
691
- if (hotkey.press && !hotkey.active) {
692
- hotkey.active = true; // active защищает от множественных срабатываний
693
- hotkey.press(e);
694
- }
695
- }
696
- });
697
- document.addEventListener('keyup', e=>{
698
- this._holds.delete(e.code);
699
-
700
- for (let hotkey of this.keys.values()) {
701
- if (hotkey.active && !this._match(hotkey.keys)) {
702
- hotkey.active=false;
703
- hotkey.release(e);
704
- }
705
- }
706
- });
707
- window.addEventListener('blur', e=>{
708
- /*
709
- * При переключении в другое окно автоматического keyup не будет
710
- * Поэтому сбрасываем всё принудительно, мало ли
711
- */
712
- for (let hotkey of this.keys.values()) {
713
- if (hotkey.active) {
714
- hotkey.active = false;
715
- hotkey.release();
716
- }
717
- }
718
- this._holds.clear();
719
- });
720
- this._=true;
721
- },
722
- on(combo, press, release) {
723
- this._init();
724
- let keys = this._parse(combo);
725
-
726
- this.keys.set(combo, {
727
- keys,
728
- // press/releace по умолчанию пустышки для сокращения синаксиса
729
- press: press || (()=>{}),
730
- release: release || (()=>{}),
731
- active: false
732
- });
733
-
734
- return this;
735
- },
736
- off(combo) {
737
- this.keys.delete(combo);
738
- return this;
739
- },
740
- },
741
- drag: {
742
- // See also:
743
- // - https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientX
744
- // - https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientY
745
- // - https://developer.mozilla.org/en-US/docs/Web/API/Pointer_events
746
- // - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
747
- // - https://developer.mozilla.org/en-US/docs/Web/API/Event/preventDefault
748
- // - https://developer.mozilla.org/en-US/docs/Web/API/Element/touchmove_event (почему нам нужен preventDefault)
749
- _i: false,
750
- active: new Map(),
707
+ err: {
708
+ /*
709
+ * МОДУЛЬ ОШИБОК
710
+ * Author: MIOBOMB (2024-2026)
711
+ * Last patch: 2.1.4
712
+ *
713
+ * Мой самописный модуль ошибок
714
+ * вообще он ялвяется наследием
715
+ * но если вам лень писать .catch после .then
716
+ * то почему бы и нет
717
+ *
718
+ * See also:
719
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/error_event
720
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Window/unhandledrejection_event
721
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Error
722
+ */
723
+ init() {
724
+ window.addEventListener('error',_.err.handleGlobal);
725
+ window.addEventListener('unhandledrejection',_.err.handleRejection);
726
+ },
727
+ print: (cnt,e)=>console.error(e),
728
+
729
+ errors: {},
730
+ _c: 0,
731
+ log(err) {
732
+ _.err.print(_.err._c,err);
733
+ _.err._c++;
734
+ _.err.errors[_.err._c]=err;
735
+ },
736
+ handleGlobal(message,source,line,column,error){
737
+ console.error(message,source+':'+line+':'+column,error)
738
+ _.err.log(message + `\n IN ${source} ON LINE ${line} IN COLUMN ${column}`);
739
+ },
740
+ handleRejection(e){
741
+ const err = e.reason || e;
742
+ console.error(err);
743
+ _.err.log(
744
+ `PROMISE ERROR\n`+
745
+ `${e.stack || e}`
746
+ );
747
+ },
748
+ },
751
749
 
752
- prevent: e=>e.target.closest('button,input'),
753
- init(dragger, mover, onStart, onStop) {
754
- let start=e=>{
755
- // Проверяем куда нажали, если бы мы не проверяли,
756
- // То драггер не дал бы нам нажать на кнопки или изменить имя окна
757
- if (this.prevent(e)) return;
758
-
759
- e.preventDefault();
760
-
761
- this.active.set(e.pointerId,{
762
- x:e.clientX,
763
- y:e.clientY,
764
- mover:mover,
765
- onStop:onStop
766
- });
767
-
768
- onStart?.(e);
769
- };
770
- if (!this._i) {
771
- document.addEventListener("pointermove", (e) => this.move(e));
772
- document.addEventListener("pointerup", (e) => this.stop(e));
773
- document.addEventListener("pointercancel", (e) => this.stop(e));
774
- this._i = true;
775
- }
776
- dragger.onpointerdown=start;
777
- // превентим touchmove событие чтобы не было проблем
778
- // при скролле на телефонах
779
- dragger.ontouchmove=e=>e.preventDefault();
780
- },
781
- move(e) {
782
- let p=this.active.get(e.pointerId);
783
- if(!p) return;
784
- e.preventDefault();
785
-
786
- let dx=p.x - e.clientX,
787
- dy=p.y - e.clientY;
788
-
789
- p.x=e.clientX;
790
- p.y=e.clientY;
791
-
792
- let mov = p.mover;
793
- mov.style.top=(mov.offsetTop - dy)+"px";
794
- mov.style.left=(mov.offsetLeft - dx)+"px";
795
- },
796
- stop(e) {
797
- this.active.get(e.pointerId)?.onStop?.(e);
798
- this.active.delete(e.pointerId);
799
- },
800
- },
801
- win:{
802
- /*
803
- * МОДУЛЬ ОКОН
804
- * если вы спросите почему ньюхелпер я отвечу
805
- * winBox.js это 35 килобайт, здесь же вы получаете в 25 килобайт
806
- * И более широкий движок окон и документацию уровня...
807
- * А у кого нибуть вообще есть такие подробные документации в вебе?
808
- *
809
- * Реализует ограниченно-гибкий движок окон, функционал:
810
- * - открытие, разворот на весь экран, закрытие
811
- * - сворачивание в таскбар и разворчаивание
812
- * - нативный css-ресайз (resize:both)
813
- * - возможность двигать окна (работает на телефонах, я проверял)
814
- * - сохранение и загрузка окон по вашему выбору
815
- *
816
- * теперь мне надо вспомнить я рефакторил этот код 4 раза или 7 раз
817
- *
818
- * !!!: _opn() и toggleFull() могут сломать ваши окна!
819
- * Эти функции высчитывают координаты окна, и размер окна с учётом padding'а
820
- * Ни за что не вешайте на ваши окна transform:translate()!
821
- *
822
- * !!!: _opn() по умолчанию открывает окно по центру экрана
823
- * Если не идёт восстановление через write()
824
- *
825
- * ???: стоит ли открывать окно в центре, или лучше дать "дефолтную функцию" позиционирования
826
- *
827
- * FIXME: вынести lang.winTitle из переводов для устранения "связности" кода
828
- *
829
- * See also:
830
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect
831
- * - https://developer.mozilla.org/en-US/docs/Web/CSS/position
832
- * - https://developer.mozilla.org/en-US/docs/Web/CSS/resize
833
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/animationend_event
834
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
835
- * - https://developer.mozilla.org/en-US/docs/Web/API/Element/classList
836
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
837
- * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Closures
838
- * - html модуль
839
- * - lang.winTitle функция
840
- * - drag модуль
841
- */
842
- manager:false,
843
- hider:false,
844
- text:'',
845
-
846
- winAttrs:'',
847
- dragAttrs:'',
848
- titleAttrs:'',
849
- renameAttrs:'',
850
- btnAttrs:'',
851
- hiderAttrs:'',
852
-
853
- defBtns:[
854
- ['–',w=>w.hide()],
855
- ['=',w=>w.toggleFull()],
856
- ['X',w=>w.close()],
857
- ],
858
-
859
- animOpen:'',
860
- animClose:'',
861
- animHide:'',
862
- animShow:'',
863
- animFullOn:'',
864
- animFullOff:'',
865
-
866
- _animate(elem, anim, actAfter = ()=>{}, actPre = ()=>{}) {
867
- if (anim) {
868
- elem.classList.add(anim);
869
- actPre();
870
- elem.addEventListener('animationend', ()=>{
871
- elem.classList.remove(anim);
872
- actAfter();
873
- }, { once: true });
874
- } else {
875
- actPre();
876
- actAfter();
877
- }
878
- },
879
- _ID(){
880
- let id;
881
- // Создаём случайный 6 символьный айди, чтобы каждый раз не совпадало
882
- // !!!: в теории можно задать любой айди
883
- // ???: проверить при скольки окнах генератор начинает тормозить
884
- do id=Math.random().toString(36).substring(2,8);
885
- while (_.wins.has(id));
886
- return id;
887
- },
888
- _winBtn(win,text,func){
889
- let b=_.html`<button ${this.btnAttrs}>${text}</button>`;
890
- b.addEventListener('click',()=>func(win));
891
- return b;
892
- },
893
- _hiderBtn(win){
894
- let title=win.langs!== false ? _.lang.winTitle(_.win.text+win.langs) : `>${win.name}<`,
895
- b=_.html`<button id=hider${win.id} ${this.hiderAttrs}${title}/button>`;
896
- b.addEventListener('click',()=>this.show(win));
897
- return b;
898
- },
899
- _initWin: winState=>
900
- _.drag.init(winState.drag, winState.elem, ()=>_.win.manager.appendChild(winState.elem)),
901
- open(name,content='',customAttrs=''){
902
- let winId=this._ID(),
903
- winState={
904
- id:winId,
905
- name:name,
906
- langs:name,
907
- state:'opened',
908
- full:false,
909
- inRename:false,
910
- // Если окно новое, координаты полностью нулевые,
911
- // Нужно чтобы проверять создаётся ли окно и если да то задавать координаты
912
- onUnfull:{top:0,left:0,width:0,height:0},
913
- attrs:customAttrs,
914
- elem:false,
915
- drag:false,
916
- content:false,
917
- };
918
- return this._opn(winState,content);
919
- },
920
- _opn(winState,content=''){
921
- if (!this.manager || !this.hider) throw new Error('Window managers not inited');
922
-
923
- let wId=winState.id,
924
- html=
925
- _.html`<div id=${wId} ${this.winAttrs} ${winState.attrs}>
926
- <div style="display:flex;justify-content:space-between;align-items:center"
927
- ${this.dragAttrs} id=DRAGGER${wId}>
928
- <span ${this.titleAttrs} id=title${wId}${_.lang.winTitle(_.win.text+winState.name)}/span>
929
- <div id=btns${wId}></div>
930
- </div>
931
- <div id=content${wId} style=overflow:auto;width:100%;height:100%>
932
- ${content.replace(/\{winId\}/g,wId)}
933
- </div>
934
- </div>`,
935
- btns=html.querySelector(`#btns${wId}`);
936
- for(let b of this.defBtns) btns.append(this._winBtn(winState,...b));
937
- html.style.overflow='hidden';
938
- html.style.resize='both';
939
-
940
- this._animate(html, this.animOpen)
750
+ hotkeys: {
751
+ /*
752
+ * ГОРЯЧИЕ КЛАВИШЫ
753
+ * Author: MIOBOMB (2025-2026)
754
+ * Last patch: 2.1.4
755
+ *
756
+ * Реализует самый настоящий press/release интерфейс
757
+ * Если верить минификатору, после сжатия весит всего 790 байт
758
+ *
759
+ * В Object Hub уже есть текстовый редактор горячих клавиш
760
+ * На базе этого движка, конечно давать textarea с js кодом...
761
+ * Не самая безопасная затея, но как факт кастомизация широчайшая
762
+ *
763
+ * _holds работает не на массивах а на new Set()
764
+ * Сеты работают намного быстрее при большом объёме данных
765
+ * Вы же не хотите чтобы у вас тормозил поток с 100+ хоткеями
766
+ * Из-за простого печатанья?
767
+ *
768
+ * FIXME: Рассмотреть альтернативы e.code из-за проблем
769
+ * с otg-клавиатурами на телефонах
770
+ *
771
+ * See also:
772
+ * - https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent
773
+ * - https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/code
774
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/keydown_event
775
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/keyup_event
776
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/blur_event
777
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Set
778
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
779
+ * - https://developer.mozilla.org/en-US/docs/Web/API/UI_Events/Keyboard_event_code_values (список клавиш)
780
+ */
781
+ keys: new Map(),
782
+ _holds: new Set(),
783
+ _: false,
784
+
785
+ _parse: combo => combo.split('+').map(k=>k.trim()),
786
+ _match(keys) {
787
+ // Нужно сверять все клавишы, это же КОМБИНАЦИЯ а не отдельные куски
788
+ for (let k of keys) if (!this._holds.has(k)) return false;
789
+ return true;
790
+ },
791
+ _init() {
792
+ if (this._)
793
+ return;
794
+ document.addEventListener('keydown', e=>{
795
+ this._holds.add(e.code);// key зависит от раскладки (на Qwerty 'KeyZ' — это 'z', на Йцукен — 'я')
796
+ // code даёт физическое положение клавиши, что важно для игр и хоткеев, и в целом универсальнее
797
+
798
+ for (let hotkey of this.keys.values()) {
799
+ if (!this._match(hotkey.keys))
800
+ continue;
801
+ if (hotkey.press && !hotkey.active) {
802
+ hotkey.active = true; // active защищает от множественных срабатываний
803
+ hotkey.press(e);
804
+ }
805
+ }
806
+ });
807
+ document.addEventListener('keyup', e=>{
808
+ this._holds.delete(e.code);
809
+
810
+ for (let hotkey of this.keys.values()) {
811
+ if (hotkey.active && !this._match(hotkey.keys)) {
812
+ hotkey.active=false;
813
+ hotkey.release(e);
814
+ }
815
+ }
816
+ });
817
+ window.addEventListener('blur', e=>{
818
+ /*
819
+ * При переключении в другое окно автоматического keyup не будет
820
+ * Поэтому сбрасываем всё принудительно, мало ли
821
+ */
822
+ for (let hotkey of this.keys.values()) {
823
+ if (hotkey.active) {
824
+ hotkey.active = false;
825
+ hotkey.release();
826
+ }
827
+ }
828
+ this._holds.clear();
829
+ });
830
+ this._=true;
831
+ },
832
+ on(combo, press, release) {
833
+ this._init();
834
+ let keys = this._parse(combo);
835
+
836
+ this.keys.set(combo, {
837
+ keys,
838
+ // press/releace по умолчанию пустышки для сокращения синаксиса
839
+ press: press || (()=>{}),
840
+ release: release || (()=>{}),
841
+ active: false
842
+ });
843
+
844
+ return this;
845
+ },
846
+ off(combo) {
847
+ this.keys.delete(combo);
848
+ return this;
849
+ },
850
+ },
941
851
 
942
- winState.setTitle=nT=>_.win.setTitle(winState,nT);
943
- winState.toggleFull=e=>_.win.toggleFull(winState);
944
- winState.close=e=>_.win.close(winState);
945
- winState.hide=e=>_.win.hide(winState);
946
- winState.show=e=>_.win.show(winState);
947
- this.manager.append(html);
948
-
949
- let win=winState.elem=document.getElementById(wId),
950
- contentRect=document.getElementById('content'+wId).getBoundingClientRect(),
951
- windowRect=win.getBoundingClientRect(),
952
- padX=windowRect.width - contentRect.width,padY=windowRect.height - contentRect.height;
953
- winState.drag=document.getElementById('DRAGGER'+wId);
954
- winState.content=document.getElementById('content'+wId);
955
-
956
- if (winState.onUnfull.width === 0) {
957
- // Здесь и задаются координаты...
958
- // Мастера клин кода не выносите мне мозги прошу
959
- // Оно же работает!!!
960
- if (!winState.attrs.includes('top')) {
961
- win.style.top=win.offsetTop - (win.offsetHeight / 2) + 'px';
962
- win.style.left=win.offsetLeft - (win.offsetWidth / 2) + 'px';
963
- }
964
- if (!winState.attrs.includes('width')) win.style.height=(win.offsetHeight - padX) + 'px';
965
- if (!winState.attrs.includes('height')) win.style.width=(win.offsetWidth - padY) + 'px';
966
- } else
967
- for (let pos in winState.onUnfull)
968
- win.style[pos] = winState.onUnfull[pos] + 'px'
969
-
970
- this._initWin(winState);
971
- winState.drag.addEventListener('contextmenu',(e)=>{
972
- e.preventDefault();
973
- if(e.target.closest('button')) return;
974
- let wT=document.getElementById('title'+wId);
975
- if (!winState.inRename){
976
- wT.innerHTML=`<input ${this.renameAttrs} id=rename${wId} value="${wT.textContent}">`;
977
- winState.inRename=true;
978
- }else{
979
- this.setTitle(winState,document.getElementById('rename'+wId).value);
980
- winState.inRename=false;
981
- }
982
- });
983
-
984
- if (winState.state === 'hidened') winState.hide();
985
-
986
- _.wins.set(winState.id, winState);
987
- return winState;
988
- },
989
- setTitle(winState,newT){
990
- winState.langs=false;
991
- winState.name=newT;
992
- let t=document.getElementById('title'+winState.id),
993
- h=document.getElementById('hider'+winState.id);
994
- t.innerHTML=newT;
995
- t.removeAttribute('data-trans');
996
- if (h){
997
- h.innerHTML=newT;
998
- h.removeAttribute('data-trans');
999
- }
1000
- },
1001
- toggleFull(winState){
1002
- let wEl=winState.elem,
1003
- ws=wEl.style,
1004
- wc=wEl.classList,
1005
- contentRect=document.getElementById('content'+winState.id).getBoundingClientRect(),
1006
- windowRect=wEl.getBoundingClientRect(),
1007
- padX=windowRect.width - contentRect.width,
1008
- padY=windowRect.height - contentRect.height,
1009
- aOn=this.animFullOn,
1010
- aOff=this.animFullOff,
1011
- fd={
1012
- top: windowRect.top, left: windowRect.left,
1013
- width: contentRect.width, height: contentRect.height,
1014
- },
1015
- unful=()=>{
1016
- ws.top=old.top + 'px';
1017
- ws.left=old.left + 'px';
1018
- ws.width=old.width + 'px';
1019
- ws.height=old.height + 'px';
1020
- },
1021
- doFul=()=>{
1022
- if (aOn) wc.remove(aOn);
1023
- winState.full=true;
1024
- winState.onUnfull=fd;
1025
- ws.top=0;
1026
- ws.left=0;
1027
- ws.width=`calc(100% - ${padX}px)`;
1028
- ws.height=`calc(100% - ${padY}px)`;
1029
- winState.drag.onpointerdown=null;
1030
- },
1031
- doUnful=()=>{
1032
- if (aOff) wc.remove(aOff);
1033
- unful();
1034
- winState.full=false;
1035
- this._initWin(winState);
1036
- },
1037
- old=winState.onUnfull;
1038
- if (!winState.full)
1039
- this._animate(wEl, this.animFullOn, doFul)
1040
- else
1041
- this._animate(wEl, this.animFullOff, doUnful, unful)
1042
- },
1043
- close(winState){
1044
- let w=winState.elem,
1045
- remover=()=>{
1046
- let dr=winState.drag,D=document;
1047
- dr.onpointerdown=dr.ontouchmove=null;
1048
- // Удаляем обработчики висящие на документе
1049
- // Если их не удалять рано или поздно случится утечка памяти
1050
- // Я не знаю как я жил во времена 2.0 когда движок только появился
1051
- ['move','up','cancel'].map(e=>D['onpointer'+e]=null);
1052
- w.remove();
1053
- _.wins.delete(winState.id);
1054
- };
1055
- if (w.style.display== 'none') {
1056
- document.getElementById('hider'+winState.id).remove();
1057
- remover();
1058
- } else
1059
- this._animate(w, this.animClose, remover);
1060
-
1061
- },
1062
- hide(winState){
1063
- let wEl=winState.elem,
1064
- wc=wEl.classList,
1065
- anim=this.animHide,
1066
- hider=()=>{
1067
- wEl.style.display='none';
1068
- if(anim)wc.remove(anim);
1069
- winState.state='hidened';
1070
- this.hider.append(this._hiderBtn(winState));
1071
- }
1072
- this._animate(wEl, this.animHide, hider);
1073
- },
1074
- show(winState){
1075
- let wEl=winState.elem,
1076
- wc=wEl.classList,
1077
- anim=this.animShow,
1078
- hider=document.getElementById('hider'+winState.id),
1079
- shower=()=>{
1080
- if(anim)wc.remove(anim);
1081
- winState.state='opened';
1082
- }
1083
- wEl.style.display='';
1084
- hider.remove();
1085
- this._animate(wEl, this.animShow, shower);
1086
- },
1087
- /*
1088
- * о да, ниже идёт самая крутая фишка которую я готовлю к 2.2
1089
- *
1090
- * СОХРАНЕНИЕ-ВОССТАНОВКА ОКОН
1091
- * Помните автоформы? Здесь я поступил лучше
1092
- * Вы можете полностью сохранить окна, как - решаете вы, но лучше
1093
- * Вместо колбека я теперь просто делаю разовый читатель, так намного гибче
1094
- * Плюсом я делаю разовый восстановитель который возвращает все окна
1095
- * Так тоже в разы гибче, авось у вас в окнах были вебсокеты и их нужно восстановить
1096
- * Проще записать результат а потом прогнать проверку по data-ws атрибутам
1097
- * Или как вы ещё придумаете
1098
- *
1099
- * !!!: Оно работает настолько гибко что в теории можно сделать виртуальные рабочие столы
1100
- */
1101
- read(){
1102
- let store = {};
1103
- for (let [winId, winPre] of _.wins) {
1104
- let win = { ...winPre },
1105
- size=win.onUnfull,
1106
- wEl = win.elem,
1107
- contentRect=win.content.getBoundingClientRect(),
1108
- windowRect=wEl.getBoundingClientRect();
1109
- win.realContent=win.content.innerHTML;
1110
- size.top=windowRect.top;
1111
- size.left=windowRect.left;
1112
- size.height=wEl.offsetHeight - (windowRect.height - contentRect.height);
1113
- size.width=wEl.offsetWidth - (windowRect.width - contentRect.width);
1114
- delete win.elem;
1115
- delete win.drag;
1116
- delete win.content;
1117
- store[winId] = win;
1118
- }
1119
- return store;
1120
- },
1121
- write(state){
1122
- for (let winId in state) {
1123
- let win=state[winId],
1124
- content=win.realContent;
1125
- delete win.realContent;
1126
- _.wins.set(winId, win);
1127
- this._opn(win,content);
1128
- }
1129
- return _.wins;
1130
- },
1131
- },
1132
- wins: new Map(),
1133
- };
1134
-
1135
- return _
852
+ drag: {
853
+ /* МОДУЛЬ ДРАГГЕРА
854
+ * Author: MIOBOMB (2023-2026)
855
+ * Last patch: 2.1.7
856
+ *
857
+ * Самый обычный драггер, разве что адаптированный под движок окон
858
+ * Не буду врать, написал я его 2 года назад украв код с w3schools
859
+ * Но я провёл настолько глубокий рефакторинг что единственное напоминание:
860
+ * Алгоритм вычисления координат
861
+ *
862
+ * FIXME:
863
+ * Мультитач чувствует себя плохо на телефонах
864
+ * (возможно не только на них)
865
+ * Первые элементы начинают дрожжать и прыгать по экрану
866
+ * А последний взятый элемент сильно фризит
867
+ * Я что зря делал проброс nginx'а на 192.168.0.*?
868
+ * Непорядок
869
+ *
870
+ * See also:
871
+ * - https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientX
872
+ * - https://developer.mozilla.org/en-US/docs/Web/API/MouseEvent/clientY
873
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Pointer_events
874
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
875
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Event/preventDefault
876
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/touchmove_event (почему нам нужен preventDefault)
877
+ * - https://www.w3schools.com/howto/howto_js_draggable.asp (основа для модуля)
878
+ */
879
+ _i: false,
880
+ active: new Map(),
881
+
882
+ prevent: e=>e.target.closest('button,input'),
883
+ init(dragger, mover, onStart, onStop) {
884
+ let start=e=>{
885
+ // Проверяем куда нажали, если бы мы не проверяли,
886
+ // То драггер не дал бы нам нажать на кнопки или изменить имя окна
887
+ if (this.prevent(e)) return;
888
+
889
+ e.preventDefault();
890
+
891
+ this.active.set(e.pointerId,{
892
+ x:e.clientX,
893
+ y:e.clientY,
894
+ mover:mover,
895
+ onStop:onStop
896
+ });
897
+
898
+ onStart?.(e);
899
+ };
900
+ if (!this._i) {
901
+ document.addEventListener("pointermove", (e) => this.move(e));
902
+ document.addEventListener("pointerup", (e) => this.stop(e));
903
+ document.addEventListener("pointercancel", (e) => this.stop(e));
904
+ this._i = true;
905
+ }
906
+ dragger.onpointerdown=start;
907
+ // превентим touchmove событие чтобы не было проблем
908
+ // при скролле на телефонах
909
+ dragger.ontouchmove=e=>e.preventDefault();
910
+ },
911
+ move(e) {
912
+ let p=this.active.get(e.pointerId);
913
+ if(!p) return;
914
+ e.preventDefault();
915
+
916
+ let dx=p.x - e.clientX,
917
+ dy=p.y - e.clientY;
918
+
919
+ p.x=e.clientX;
920
+ p.y=e.clientY;
921
+
922
+ let mov = p.mover;
923
+ mov.style.top=(mov.offsetTop - dy)+"px";
924
+ mov.style.left=(mov.offsetLeft - dx)+"px";
925
+ },
926
+ stop(e) {
927
+ this.active.get(e.pointerId)?.onStop?.(e);
928
+ this.active.delete(e.pointerId);
929
+ },
930
+ },
931
+
932
+ win:{
933
+ /*
934
+ * МОДУЛЬ ОКОН
935
+ * Author: MIOBOMB (2023-2026)
936
+ * Last patch: 2.1.7
937
+ *
938
+ * если вы спросите почему ньюхелпер я отвечу
939
+ * winBox.js это 35 килобайт, здесь же вы получаете в 25 килобайт
940
+ * И более широкий движок окон и документацию уровня...
941
+ * А у кого нибуть вообще есть такие подробные документации в вебе?
942
+ *
943
+ * Реализует ограниченно-гибкий движок окон, функционал:
944
+ * - открытие, разворот на весь экран, закрытие
945
+ * - сворачивание в таскбар и разворчаивание
946
+ * - нативный css-ресайз (resize:both)
947
+ * - возможность двигать окна (работает на телефонах, я проверял)
948
+ * - сохранение и загрузка окон по вашему выбору
949
+ *
950
+ * теперь мне надо вспомнить я рефакторил этот код 4 раза или 7 раз
951
+ *
952
+ * !!!: _opn() и toggleFull() могут сломать ваши окна!
953
+ * Эти функции высчитывают координаты окна, и размер окна с учётом padding'а
954
+ * Ни за что не вешайте на ваши окна transform:translate()!
955
+ *
956
+ * !!!: _opn() по умолчанию открывает окно по центру экрана
957
+ * Если не идёт восстановление через write()
958
+ *
959
+ * HMM: стоит ли открывать окно в центре, или лучше дать "дефолтную функцию" позиционирования
960
+ *
961
+ * FIXME: вынести lang.winTitle из переводов для устранения "связности" кода
962
+ *
963
+ * FIXME: придумать что делать с переездом _.wins на new Map
964
+ * я уже пробовал перенос на мапу и результат...
965
+ * но у меня сломались все окна в object hub'е
966
+ * по этому пусть пока хоть до 2.5 будет объект
967
+ *
968
+ * See also:
969
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/getBoundingClientRect
970
+ * - https://developer.mozilla.org/en-US/docs/Web/CSS/position
971
+ * - https://developer.mozilla.org/en-US/docs/Web/CSS/resize
972
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/animationend_event
973
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/contextmenu_event
974
+ * - https://developer.mozilla.org/en-US/docs/Web/API/Element/classList
975
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map
976
+ * - https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Closures
977
+ * - html модуль
978
+ * - lang.winTitle функция
979
+ * - drag модуль
980
+ */
981
+ manager:false,
982
+ hider:false,
983
+ text:'',
984
+
985
+ winAttrs:'',
986
+ dragAttrs:'',
987
+ titleAttrs:'',
988
+ renameAttrs:'',
989
+ btnAttrs:'',
990
+ hiderAttrs:'',
991
+
992
+ defBtns:[
993
+ ['',w=>w.hide()],
994
+ ['=',w=>w.toggleFull()],
995
+ ['X',w=>w.close()],
996
+ ],
997
+
998
+ animOpen:'',
999
+ animClose:'',
1000
+ animHide:'',
1001
+ animShow:'',
1002
+ animFullOn:'',
1003
+ animFullOff:'',
1004
+
1005
+ _animate(elem, anim, actAfter = ()=>{}, actPre = ()=>{}) {
1006
+ if (anim) {
1007
+ elem.classList.add(anim);
1008
+ actPre();
1009
+ elem.addEventListener('animationend', ()=>{
1010
+ elem.classList.remove(anim);
1011
+ actAfter();
1012
+ }, { once: true });
1013
+ } else {
1014
+ actPre();
1015
+ actAfter();
1016
+ }
1017
+ },
1018
+
1019
+ _ID(){
1020
+ let id;
1021
+ // Создаём случайный 6 символьный айди, чтобы каждый раз не совпадало
1022
+ // !!!: в теории можно задать любой айди
1023
+ // HMM: проверить при скольки окнах генератор начинает тормозить
1024
+ do id=Math.random().toString(36).substring(2,8);
1025
+ while (_.wins[id]);
1026
+ //while (_.wins.has(id));
1027
+ return id;
1028
+ },
1029
+ _winBtn(win,text,func){
1030
+ let b=_.html`<button ${this.btnAttrs}>${text}</button>`;
1031
+ b.addEventListener('click',()=>func(win));
1032
+ return b;
1033
+ },
1034
+ _hiderBtn(win){
1035
+ let title=win.langs!== false ? _.lang.winTitle(_.win.text+win.langs) : `>${win.name}<`,
1036
+ b=_.html`<button id=hider${win.id} ${this.hiderAttrs}${title}/button>`;
1037
+ b.addEventListener('click',()=>this.show(win));
1038
+ return b;
1039
+ },
1040
+
1041
+ _initWin: winState=>
1042
+ _.drag.init(winState.drag, winState.elem, ()=>_.win.manager.appendChild(winState.elem)),
1043
+ open(name,content='',customAttrs=''){
1044
+ let winId=this._ID(),
1045
+ winState={
1046
+ id:winId,
1047
+ name:name,
1048
+ langs:name,
1049
+ state:'opened',
1050
+ full:false,
1051
+ inRename:false,
1052
+ // Если окно новое, координаты полностью нулевые,
1053
+ // Нужно чтобы проверять создаётся ли окно и если да то задавать координаты
1054
+ onUnfull:{top:0,left:0,width:0,height:0},
1055
+ attrs:customAttrs,
1056
+ elem:false,
1057
+ drag:false,
1058
+ content:false,
1059
+ };
1060
+ return this._opn(winState,content);
1061
+ },
1062
+ _opn(winState,content=''){
1063
+ if (!this.manager || !this.hider) throw new Error('Window managers not inited');
1064
+
1065
+ let wId=winState.id,
1066
+ html=
1067
+ _.html`<div id=${wId} ${this.winAttrs} ${winState.attrs}>
1068
+ <div style="display:flex;justify-content:space-between;align-items:center"
1069
+ ${this.dragAttrs} id=DRAGGER${wId}>
1070
+ <span ${this.titleAttrs} id=title${wId}${_.lang.winTitle(_.win.text+winState.name)}/span>
1071
+ <div id=btns${wId}></div>
1072
+ </div>
1073
+ <div id=content${wId} style=overflow:auto;width:100%;height:100%>
1074
+ ${content.replace(/\{winId\}/g,wId)}
1075
+ </div>
1076
+ </div>`,
1077
+ btns=html.querySelector(`#btns${wId}`);
1078
+ for(let b of this.defBtns) btns.append(this._winBtn(winState,...b));
1079
+ html.style.overflow='hidden';
1080
+ html.style.resize='both';
1081
+
1082
+ this._animate(html, this.animOpen)
1083
+
1084
+ winState.setTitle=nT=>_.win.setTitle(winState,nT);
1085
+ winState.toggleFull=e=>_.win.toggleFull(winState);
1086
+ winState.close=e=>_.win.close(winState);
1087
+ winState.hide=e=>_.win.hide(winState);
1088
+ winState.show=e=>_.win.show(winState);
1089
+ this.manager.append(html);
1090
+
1091
+ let win=winState.elem=document.getElementById(wId),
1092
+ contentRect=document.getElementById('content'+wId).getBoundingClientRect(),
1093
+ windowRect=win.getBoundingClientRect(),
1094
+ padX=windowRect.width - contentRect.width,padY=windowRect.height - contentRect.height;
1095
+ winState.drag=document.getElementById('DRAGGER'+wId);
1096
+ winState.content=document.getElementById('content'+wId);
1097
+
1098
+ if (winState.onUnfull.width === 0) {
1099
+ // Здесь и задаются координаты...
1100
+ // Мастера клин кода не выносите мне мозги прошу
1101
+ // Оно же работает!!!
1102
+ if (!winState.attrs.includes('top')) {
1103
+ win.style.top=win.offsetTop - (win.offsetHeight / 2) + 'px';
1104
+ win.style.left=win.offsetLeft - (win.offsetWidth / 2) + 'px';
1105
+ }
1106
+ if (!winState.attrs.includes('width'))
1107
+ win.style.width=(win.offsetWidth - padY) + 'px';
1108
+ if (!winState.attrs.includes('height'))
1109
+ win.style.height=(win.offsetHeight - padX) + 'px';
1110
+ } else
1111
+ for (let pos in winState.onUnfull)
1112
+ win.style[pos] = winState.onUnfull[pos] + 'px'
1113
+
1114
+ this._initWin(winState);
1115
+ winState.drag.addEventListener('contextmenu',(e)=>{
1116
+ e.preventDefault();
1117
+ if(e.target.closest('button')) return;
1118
+ let wT=document.getElementById('title'+wId);
1119
+ if (!winState.inRename){
1120
+ wT.innerHTML=`<input ${this.renameAttrs} id=rename${wId} value="${wT.textContent}">`;
1121
+ winState.inRename=true;
1122
+ }else{
1123
+ this.setTitle(winState,document.getElementById('rename'+wId).value);
1124
+ winState.inRename=false;
1125
+ }
1126
+ });
1127
+
1128
+ if (winState.state === 'hidened') winState.hide();
1129
+
1130
+ _.wins[winState.id] = winState;
1131
+ //_.wins.set(winState.id, winState);
1132
+ return winState;
1133
+ },
1134
+
1135
+ setTitle(winState,newT){
1136
+ winState.langs=false;
1137
+ winState.name=newT;
1138
+ let t=document.getElementById('title'+winState.id),
1139
+ h=document.getElementById('hider'+winState.id);
1140
+ t.innerHTML=newT;
1141
+ t.removeAttribute('data-trans');
1142
+ if (h){
1143
+ h.innerHTML=newT;
1144
+ h.removeAttribute('data-trans');
1145
+ }
1146
+ },
1147
+
1148
+ toggleFull(winState){
1149
+ let wEl=winState.elem,
1150
+ ws=wEl.style,
1151
+ wc=wEl.classList,
1152
+ contentRect=document.getElementById('content'+winState.id).getBoundingClientRect(),
1153
+ windowRect=wEl.getBoundingClientRect(),
1154
+ padX=windowRect.width - contentRect.width,
1155
+ padY=windowRect.height - contentRect.height,
1156
+ aOn=this.animFullOn,
1157
+ aOff=this.animFullOff,
1158
+ fd={
1159
+ top: windowRect.top, left: windowRect.left,
1160
+ width: contentRect.width, height: contentRect.height,
1161
+ },
1162
+ unful=()=>{
1163
+ ws.top=old.top + 'px';
1164
+ ws.left=old.left + 'px';
1165
+ ws.width=old.width + 'px';
1166
+ ws.height=old.height + 'px';
1167
+ },
1168
+ doFul=()=>{
1169
+ if (aOn) wc.remove(aOn);
1170
+ winState.full=true;
1171
+ winState.onUnfull=fd;
1172
+ ws.top=0;
1173
+ ws.left=0;
1174
+ ws.width=`calc(100% - ${padX}px)`;
1175
+ ws.height=`calc(100% - ${padY}px)`;
1176
+ winState.drag.onpointerdown=null;
1177
+ },
1178
+ doUnful=()=>{
1179
+ if (aOff) wc.remove(aOff);
1180
+ unful();
1181
+ winState.full=false;
1182
+ this._initWin(winState);
1183
+ },
1184
+ old=winState.onUnfull;
1185
+ if (!winState.full)
1186
+ this._animate(wEl, this.animFullOn, doFul)
1187
+ else
1188
+ this._animate(wEl, this.animFullOff, doUnful, unful)
1189
+ },
1190
+
1191
+ close(winState){
1192
+ let w=winState.elem,
1193
+ remover=()=>{
1194
+ let dr=winState.drag;
1195
+ dr.onpointerdown=dr.ontouchmove=null;
1196
+ w.remove();
1197
+ delete _.wins[winState.id];
1198
+ //_.wins.delete(winState.id);
1199
+ };
1200
+ if (w.style.display== 'none') {
1201
+ document.getElementById('hider'+winState.id).remove();
1202
+ remover();
1203
+ } else
1204
+ this._animate(w, this.animClose, remover);
1205
+
1206
+ },
1207
+
1208
+ hide(winState){
1209
+ let wEl=winState.elem,
1210
+ wc=wEl.classList,
1211
+ anim=this.animHide,
1212
+ hider=()=>{
1213
+ wEl.style.display='none';
1214
+ if(anim)wc.remove(anim);
1215
+ winState.state='hidened';
1216
+ this.hider.append(this._hiderBtn(winState));
1217
+ }
1218
+ this._animate(wEl, this.animHide, hider);
1219
+ },
1220
+
1221
+ show(winState){
1222
+ let wEl=winState.elem,
1223
+ wc=wEl.classList,
1224
+ anim=this.animShow,
1225
+ hider=document.getElementById('hider'+winState.id),
1226
+ shower=()=>{
1227
+ if(anim)wc.remove(anim);
1228
+ winState.state='opened';
1229
+ }
1230
+ wEl.style.display='';
1231
+ hider.remove();
1232
+ this._animate(wEl, this.animShow, shower);
1233
+ },
1234
+
1235
+ /*
1236
+ * о да, ниже идёт самая крутая фишка которую я готовлю к 2.2
1237
+ *
1238
+ * СОХРАНЕНИЕ-ВОССТАНОВКА ОКОН
1239
+ * Помните автоформы? Здесь я поступил лучше
1240
+ * Вы можете полностью сохранить окна, как - решаете вы, но лучше
1241
+ * Вместо колбека я теперь просто делаю разовый читатель, так намного гибче
1242
+ * Плюсом я делаю разовый восстановитель который возвращает все окна
1243
+ * Так тоже в разы гибче, авось у вас в окнах были вебсокеты и их нужно восстановить
1244
+ * Проще записать результат а потом прогнать проверку по data-ws атрибутам
1245
+ * Или как вы ещё придумаете
1246
+ *
1247
+ * !!!: Оно работает настолько гибко что в теории можно сделать виртуальные рабочие столы
1248
+ */
1249
+ read(){
1250
+ let store = {};
1251
+ for (let winId in _.wins) {
1252
+ let winPre = _.wins[winId];
1253
+ //for (let [winId, winPre] of _.wins) {
1254
+ let win = { ...winPre },
1255
+ size=win.onUnfull,
1256
+ wEl = win.elem,
1257
+ contentRect=win.content.getBoundingClientRect(),
1258
+ windowRect=wEl.getBoundingClientRect();
1259
+ win.realContent=win.content.innerHTML;
1260
+ size.top=windowRect.top;
1261
+ size.left=windowRect.left;
1262
+ size.height=wEl.offsetHeight - (windowRect.height - contentRect.height);
1263
+ size.width=wEl.offsetWidth - (windowRect.width - contentRect.width);
1264
+ delete win.elem;
1265
+ delete win.drag;
1266
+ delete win.content;
1267
+ store[winId] = win;
1268
+ }
1269
+ return store;
1270
+ },
1271
+ write(state){
1272
+ for (let winId in state) {
1273
+ let win=state[winId],
1274
+ content=win.realContent;
1275
+ delete win.realContent;
1276
+ _.wins[winId] = win;
1277
+ //_.wins.set(winId, win);
1278
+ this._opn(win,content);
1279
+ }
1280
+ return _.wins;
1281
+ },
1282
+ },
1283
+
1284
+ wins: {},
1285
+ //wins: new Map(),
1286
+ };
1287
+ return _
1136
1288
  };
1289
+
1290
+ /* полифиллы к удалённым модулям
1291
+ * (сделаны в формате плагинов)
1292
+ * DOM хелпер ($), удалён в 2.1.X:
1293
+ _.$ = {
1294
+ D: document,
1295
+ id: i=> document.getElementById(i),
1296
+ q: (i,p=document)=> p.querySelector(i),
1297
+ qa: (i,p=document)=> p.querySelectorAll(i),
1298
+
1299
+ on: (el,ev,fn,opts)=> el.addEventListener(ev,fn,opts),
1300
+ off: (el,ev,fn,opts)=> el.removeEventListener(ev,fn,opts),
1301
+
1302
+ cliRect: e=> e.getBoundingClientRect(), // сокращение чтобы не писать 25+ символов
1303
+ }
1304
+ * Причины удаления:
1305
+ * 1. в процессе разработки 2.2 я понял что мне не нужен
1306
+ * "сверхлегкий исходный код", а нужен крайне сжатый min+gzip
1307
+ * 2. в следствие пункта 1 я удалил весь синтаксический сахар
1308
+ * потому что "document." гзипается заметно лучше
1309
+ */
1310
+