newhelper-js 2.1.0 → 2.1.2

package/README-en.md

@@ -1,9 +1,19 @@
 # newHelper.js
 - [русская версия](README.md)
 - A library for creating ultra-lightweight yet highly functional admin panels, one of the best examples of Object Hub. The total bundle of the entire site is only 280 kb of pure code, and the internal admin panel with all HTML+CSS+JS weighs only 25 kilobytes (with gzip, the size is even smaller). I try to keep the library in a "Modular Monolith" state.
-Current version - 2.1, 13.6kb
+Current version - 2.1, with good documentation in the code
+## Included modules:
+- Advanced window engine (resize, fullscreen, taskbar, 6.29 KB)
+- Convenient hotkeys (press/release callbacks, 1.16 KB)
+- Router (1.48 KB)
+- Ultra-light i18n analog (1.30 KB)
+- Custom lazy-load (0.97 KB)
+- Error catching module (0.54 KB)
+- Simple HTTP client with file upload progress (0.82 KB)
+- DOM helpers (0.61 KB)
+- Storage isolation (0.31 KB)
 
-# Features
+## Features
 - The library uses a classic connection with a script tag and requires no bundlers/compilers. But if you really want to, you can configure it, but why? It's the assembly language of the web world.
 - Dependencies? Nope, it's vanilla ES6.
 - The library size mentioned at the beginning is the size of the source code, so minification + gzip will reduce the size even further.

package/README.md

@@ -1,14 +1,25 @@
 # newHelper.js
 - [english version](README-en.md)
+- [документация](docs.md)
 - Библиотека для создания сверхлёгких но очень функциональных админ панелей, один из лучших примеров Object hub, Общий бандл всего сайта составляет всего 280 кб чистого кода, внутренная админ панель со всем html+css+js весит всего 25 килобайт (при gzip размер ещё ниже). Я стараюсь придерживать библиотеку в состоянии "Модульного монолита".
-Текущая версия - 2.1, 13.6кб
+Текущая версия - 2.1.2, с хорошей документацией в коде
+## Модули в комплекте
+- Широкий движок окон (ресайз, разворот на весь экран, taskbar, 6.29 кб)
+- Удобные горячие клавиши (press/release колбеки, 1.16 кб)
+- Роутер (1.48 кб)
+- Ультралёгкий аналог i18n (1.30 кб)
+- Самописный lazy-load (0.97 кб)
+- Модуль отлова ошибок (0.54 кб)
+- Простой http клиент с прогрессом загрузки файлов (0.82 кб)
+- DOM-хелперы (0.61 кб)
+- Изоляция над Storage (0.31 кб)
 
-Особенности
+## Особенности
 - Библиотека использует классическое подключение с тегом script и не требует никаких сборщиков/компиляторов. Но если очень хочется вы можете настроить его, но зачем? это же ассемблер из мира веб
-- Зависимости? неа, это ванильный ES6
+- Зависимости? неа, это ванильный ES8
 - Указанный в начале размер библиотеки является размером исходного кода, так что минификация+gzip уменьшат размер ещё сильнее
 - Из-за минималистичности кода вы можете спокойно переопределить любой встроенный метод под свои нужны. В крайнем случае можно прибегнуть к модификации кода библиотеки, но такое мы не рекомендуем делать в случае если вы собираетесь обновляться до самых последних версий
-- Весь код написан внутри одного "_" и использованием всего трёх глобальных читателей событий. Из-за этого конфликты с остальными библиотеками минимальны, если вы готовы то можете пробовать запустить newHelper вместе с jQuery или если вы капец как хотите реактивность то пробуйте в связке с ультралёгкими реактивными фреймворками (у меня на слуху из адекватных alpine.js)
+- Весь код написан внутри одного "_" и использованием всего трёх глобальных читателей событий. Из-за этого конфликты с остальными библиотеками минимальны, если вы готовы то можете пробовать запустить newHelper вместе с jQuery или если вы очень хотите реактивность то пробуйте в связке с ультралёгкими реактивными фреймворками (у меня на слуху из адекватных alpine.js)
 - Если вы последователь "14 килобайтных сайтов" то можете смело прогнать библиотеку через минификатор, минифицированный код библиотеки не должен весить больше 5 килобайт, а если отбросить ненужные вам модули и то меньше (например код движка окон составляет приблизительно 50% всего кода библиотеки, если вам не нужен движок окон - оставляйте 2 килобайта gzip-ядра)
 - Если вы научитесь грамотно использовать ленивую загрузку, то ваши и без того лёгкие сайты станут в разы легче (тот же стартовый трафик Object Hub уменьшился 330кб до 180кб при старте из-за разбития всего на lazyload модули)
 - На базе этой библиотеки работает парочка моих сайтов не связанных с админ панелями - GDPS Helper (каталог приватных серверов geometry dash, но там тоже идёт админка для демонлистов), Object hub (каталог с элементами вики движка и hr-платформы для OSC сообщества, вики движок во всю использует окна вместо костылей mediawiki). Если захотеть можно не только админку за 2 часа собрать, но и написать мегасайт за пару недель

package/newHelper.js

@@ -1,15 +1,48 @@
-_={};
-_.ver='2.1';
-_.link={
+/*
+ * Стиль комментариев
+ * FIXME - странное поведение функции, которое желательно бы переделать
+ * ??? - требует уточнения
+ * !!! - обратите внимание
+ * 
+ * Перед вами код newHelper.js версии 2.1.2, он построен на базе гибкой псевдофабрики
+ * Которая начинается с _=function(){...}();
+ * Если у вас есть конфликты с Lodash вы можете переименовать _ на всё что вам нужно
+ * 
+ * НЕСТАБИЛЬНОЕ API (НЕ РЕКОМЕНДУЕТСЯ ДЛЯ PRODUCTION):
+ * модуль _.autoForm
+ * _.win.read()
+ * _.win.write()
+ * 
+ * УДАЛЕНО (вернётся позже):
+ * модуль _.err
+ */
+
+
+_=function(){let _={
+link:{
+	/*
+	 * МОДУЛЬ ССЫЛОК
+	 * 
+	 * Работает по принципу [ссылка, команды...]
+	 * Пример: ?page=home&debug&lang=ru
+	 *          ^^^^^^^^  ^^^^^  ^^^^^^
+	 *          страница  команды
+	 * 
+	 * В процессе разработки ядра 2.0 в Object hub я понял
+	 * Что команды могут быть очень полезными для отладки
+	 * Но в теории на них можно повешать все модальные и прочие действия
+	 * 
+	 * !!!: в функции get() работает весь роутинг, в т.ч. вложенный для страниц
+	 */
 	basePage:()=>{},
 	defTitle:'',
 	actions:{},
 	commands:{},
-	_cmd:[],
 
-	_i: true,
+	_i: true, // _i - блокировщик pushState в set()
+	_cmd:[],
 	compile:()=>location.search.replace('?','').split('&'),
-	set(page,title=_.link.defTitle){
+	set(page,title=this.defTitle){
 		if (title) _.$.D.title=title;
 		if (!this._i){
 			let link=this.compile();
@@ -36,47 +69,78 @@ _.link={
 		}
 	},
 	get(){
-		let cfg=_.link,
-			links=this.compile(),
-			[fKey,fVal]=links[0].split('='),
+		/*
+		 * Страницы бросают ошибку чтобы вызвать базовую страницу
+		 * Команды тем временем так не делают
+		 * Потому что сломанная команда не так страшна как сломанная страница
+		 * 
+		 * При popstate команды берутся из хранилища _cmd, вместо самой ссылки
+		 * Сделано это для переноса команд при прыжках по истории
+		 */
+		let links=this.compile(),
+			[firstKey,fisrtValue]=links[0].split('='),
 			cmds=links.slice(1);
 		try {
-			let dirs=fKey.split('/'),
-				dir=cfg.actions,
-				main=dir[fKey];
-			if (!fKey.includes('/')){
-				main(fVal);
+			let dirs=firstKey.split('/'),
+				dir=this.actions,
+				main=dir[firstKey];
+			if (!firstKey.includes('/')){
+				main(fisrtValue);
 			} else {
 				for (let p of dirs){
 					let kDir=dir[p+'/'];
 					if (kDir)
 						dir=kDir;
 					else{
-						dir[p](fVal);
+						dir[p](fisrtValue);
 						break;
 					}
 				}
 			}
 		}catch(e){
-			_.link.basePage();
+			this.basePage();
 			throw e;
 		}
-		_.link._cmd=cmds;
-		cmds.forEach(kPre=>{
-			let [key,val]=kPre.split('=');
-			let cmd=cfg.commands[key];
-			if (cmd)
-				cmd(val);
+		this._cmd=cmds;
+		cmds.forEach(cmmdPre=>{
+			let [key,value]=cmmdPre.split('=');
+			let cmd=this.commands[key];
+			if (cmd) cmd(value);
+			else console.error(new Error(`command '${cmd}' doesn't exist!`))
 		});
 	},
-};
-_.lazy={
+},
+lazy:{
+	/*
+	 * МОДУЛЬ ЛЕНИ
+	 * 
+	 * Создаёт в глобальной области видимости прокси функции
+	 * Вызывающие загрузку скрипта с внещним модулем
+	 * Был сделан через глобальную область, так намного проще создавать лень
+	 * 
+	 * !!!: Функции обёртки в register() должны быть повешаны на window
+	 *      Иначе lazy._ провалится в рекурсию ошибок, не наступайте на мои грабли
+	 * 
+	 * ???: будет ли легче создавать лень в легаси проектах через es6 импорты
+	 */
 	loaded:{},
 	load(url,...args){
-		let key=url.split('?')[0],
+		let key=url.split('?')[0], // отсекаем параметры, чтобы не дублировать
 			state=this.loaded,
 			c=state[key];
 
+		/*
+		 * ...args передаются в Promise.resolve(args)
+		 * Это позволяет делать _.lazy.load('script.js', 'данные', 'для', 'колбека')
+		 * И потом в .then((a,b,c)=>...) получать эти аргументы
+		 * 
+		 * Тройное состояние скрипта в lazy.loaded:
+		 * - true: уже загружен => сразу резолвим
+		 * - Promise: грузится сейчас => ждём тот же промис
+		 * - undefined: ещё не грузили => создаём новый промис
+		 * 
+		 * Это защита от двойной загрузки одного скрипта
+		 */
 		if (c=== true) return Promise.resolve(args);
 		if (c instanceof Promise) return c.then(()=>args);
 
@@ -100,42 +164,62 @@ _.lazy={
 		if (!Array.isArray(funcs)) return new Error('Array required for register');
 
 		for (let fn of funcs)
-			window[fn]=(...a)=>_.lazy._(scr,fn).then(f=>f(...a));
+			window[fn]=(...a)=>this._(scr,fn).then(f=>f(...a));
+			// ???: добавить вложенность с созданием объектов-обёрток
 
-		console.info('_.lazy> Applied lazy '+scr+' with this functions:',funcs);
+		console.info('lazy> Applied lazy '+scr+' with this functions:',funcs);
+		// ???: не мешает ли тут console.info
 	},
 	async _(scr,fn){
 		let w=window,
-			wrpr=w[fn];
-		try{await _.lazy.load(scr)}
+			wrapper=w[fn]; 
+		try{await this.load(scr)}
 		catch(e){throw e}
-		if (wrpr!== w[fn]) return w[fn];
+		if (wrapper!== w[fn]) return w[fn];
 		throw new Error(`Function ${fn} not loaded from ${scr}`);
 	},
-};
-_.lang={
+},
+lang:{
+	/*
+	 * МОДУЛЬ ПЕРЕВОДОВ
+	 * 
+	 * По слухам этот модуль лучше чем многие i18n реализации
+	 * Всё потому что он из коробки умеет переводить страницу без перезагрузки
+	 * 
+	 * !!!: parse() обрабатывает ключи из vars и подставляет их значения
+	 * ваш +ключ+ становится значением, и это значение динамичное
+	 * Так удобнее отображать динамичные данные на сайтах
+	 * Например никнейм пользователя
+	 */
 	addr:'',
 	vars:{},
 	main:{},
 
-	_:(i)=>` data-trans="${i}"`,
 	load(name){
 		return new Promise((resolve,reject)=>{
-			_.http.req('GET',_.lang.addr+name+'.json',false,{'Cache-Control':'no-cache,no-store,max-age=0'})
+			_.http.req('GET',this.addr+name+'.json',false,{'Cache-Control':'no-cache,no-store,max-age=0'})
 				.then(data=>resolve(data));
 		})
+		// ???: убрать ли захардкоженое отключение кеша
 	},
 	parse:(packet,vars=_.lang.vars)=>
+		/*
+		 * Регулярка ищет всё, что внутри плюсов, в JSON они редки
+		 * Это позволяет без конфликтов подставлять переменные если они нашлись
+		 * 
+		 * ???: переделать под общий синтаксис типа {var}
+		 */
 		packet.replace(/\+([^+]+)\+/g,(match,key)=>{
 			let v=vars[key];
 			return v!== undefined ? v : match;
 		}),
 	async replace(name){
-		const p=await this.load(name);
-		_.lang.main=JSON.parse(this.parse(p));
+		const p=await this.load(name); // await короче Promise.then
+		this.main=JSON.parse(this.parse(p)); // без замены языка нельзя начинать перевод
 		for (let e of _.$.qa('[data-trans]')){
 			let key=e.dataset.trans,
-				text=_.lang.main[key] || `<code>_.lang.get('${key}')</code>`,
+				text=this.main[key] || `<code>lang.get('${key}')</code>`,
+				// ???: убрать обёртывание отсутсвующих ключей в <code />
 				tag=e.tagName;
 
 			if (tag=== 'IMG') e.src=text;
@@ -143,26 +227,57 @@ _.lang={
 				e[e.type=== 'submit' ? 'value' :'placeholder']=text;
 			else e.innerHTML=text;
 		}
+		// возвращаем для последующей обработки пакета, например для сохранения в _.storage
 		return p;
 	},
+
+	/*
+	 * Получатели строки из пакета автоматически формируют HTML
+	 * Это позволяет заметно упростить работу с кодом
+	 * Вместо отдельного указания data-trans и lang.from
+	 * вы можете написать   `<h1${_.lang.text('yourKey')}/h1>`
+	 * А пришлось бы писать `<h1 data-trans="yourKey">${_.lang.from('yourKey')}</h1>`
+	 * Согласитесь, и короче и удобнее ведь?
+	 * Не повторяйте моих ошибок и примите это как победу в лотерее
+	 * 
+	 * !!!: если ключа в пакете нету, будет выброшен warning
+	 */
+	attr:(i)=>` data-trans="${i}"`,
 	from:i=>_.lang.main[i] || console.warn(`_.lang> ${i} is undefined`) || i,
 
-	text:		i=>_.lang._(i)+`>${_.lang.from(i)}<`,
-	submit:		i=>_.lang._(i)+`value="${_.lang.from(i)}">`,
-	input:		i=>_.lang._(i)+`placeholder="${_.lang.from(i)}">`,
-	textarea:	i=>_.lang._(i)+`placeholder="${_.lang.from(i)}"><`,
-	img:		i=>_.lang._(i)+`src="${_.lang.from(i)}"`,
+	text:		i=>_.lang.attr(i)+`>${_.lang.from(i)}<`,
+	submit:		i=>_.lang.attr(i)+`value="${_.lang.from(i)}">`,
+	/*
+	 * <input type=submit> работает во всех браузерах стабильно
+	 * не используйте на них обычный lang.input()
+	 * иначе у вас не отобразится текст
+	 */
+	input:		i=>_.lang.attr(i)+`placeholder="${_.lang.from(i)}">`,
+	textarea:	i=>_.lang.attr(i)+`placeholder="${_.lang.from(i)}"><`,
+	img:		i=>_.lang.attr(i)+`src="${_.lang.from(i)}"`,
 	win(i){
-		let text=_.lang.from(i),
-			dT=_.lang._(i);
+		let text=this.from(i),
+			dT=this.attr(i);
 		if (text== null || text== ''){
 			text=i;
 			dT='';
 		}
 		return `${dT}>${text}<`;
 	},
-};
-_.http={
+},
+http:{
+	/*
+	 * HTTP-КЛИЕНТ
+	 * 
+	 * Обычная обёртка нав XHR для быстрых запросов
+	 * Использую XHR вместо fetch
+	 * Мне нужен прогресс загрузки (fetch его не даёт)
+	 * Да и вам тоже не помешает прогресс загрузки
+	 * 
+	 * В defaultHeaders вы можете установить хедеры по умолчанию
+	 * Как пример Authorization: 'your token'
+	 * ???: добавить возможность игнорировать дефолтные хедеры
+	 */
 	defaultHeaders:{},
 	req(method,url,data='',headers={},fileProgressElement=false){
 		return new Promise((resolve,reject)=>{
@@ -170,10 +285,12 @@ _.http={
 
 			xhr.open(method,url);
 
-			let allHeaders={..._.http.defaultHeaders,...headers};
+			let allHeaders={...this.defaultHeaders,...headers};
 			for (let header in allHeaders)
 				xhr.setRequestHeader(header,allHeaders[header]);
 
+			// !!!: fileProgressElement ожидает <progress> элемент без min/max
+			// Потому что value от 0 до 1
 			if (fileProgressElement)
 				xhr.upload.onprogress=(e)=>{
 					if (e.lengthComputable){
@@ -192,22 +309,36 @@ _.http={
 			xhr.send(data);
 		});
 	},
-};
-_.$={
+},
+$:{
 	D: document,
-
 	id:(i)=>_.$.D.getElementById(i),
 	q:(i,p=_.$.D)=>p.querySelector(i),
 	qa:(i,p=_.$.D)=>p.querySelectorAll(i),
 
 	on:(el,ev,fn,opts)=>el.addEventListener(ev,fn,opts),
 	off:(el,ev,fn,opts)=>el.removeEventListener(ev,fn,opts),
-};
-_.html=(strs,...args)=>{
+
+	cliRect:e=>e.getBoundingClientRect(), // сокращение чтобы не писать 25+ символов
+},
+html(strs,...args){
+	/*
+	 * Шаблонные строки в DOM
+	 * 
+	 * Позволяет писать _.html`<div>${content}</div>`
+	 * И получать настоящий DOM-элемент, а не строку
+	 * 
+	 * Почему через template?
+	 * - Скрипты не выполняются (никаких xss!)
+	 * - Можно создать несколько элементов разом
+	 * - Быстрее чем createElement для сложных структур
+	 * - Банально удобнее createElement для сложных древ
+	 */
 	let strF=[];
 	for (let i=0; i < args.length; i++)
 		strF.push(strs[i],args[i]);
 	strF.push(strs[strs.length - 1]);
+	// убираем лишние пробелы, чтобы не плодить пустые текстовые ноды
 	strF=strF.join('').trim().replace(/\s+/g,' ');
 
 	const template=_.$.D.createElement('template');
@@ -217,8 +348,56 @@ _.html=(strs,...args)=>{
 	if (content.children.length=== 1)
 		return content.firstChild;
 	return content;
-};
-_.storage=class{
+},
+autoForm:{
+	/*
+	 * АВТОСОХРАНЕНИЕ ФОРМ
+	 * 
+	 * Позволяет сохранять состояние формы на случай
+	 * Если в офисе внезапно выключат свет
+	 * 
+	 * Реализовывать удаление читателя событий я не стал
+	 * Зачем удалять обработчик если он вешается на форму а не на Document?
+	 */
+	autoSave(form,delay=1000,cb){
+		let t,
+		save=()=>{
+			let data={};
+			new FormData(form).forEach((v,k)=>{
+				if (data[k]!== undefined) {
+					if (!Array.isArray(data[k])) data[k]=[data[k]];
+					data[k].push(v);
+				} else data[k]=v;
+			});
+			cb(data);
+		};
+		if(delay<1)return save();
+		_.$.on(form,'input',()=>{
+			clearTimeout(t);
+			t=setTimeout(save,delay);
+		});
+	},
+	write(form,data){
+		Object.entries(data).forEach(([k,v])=>{
+			let el=form.elements[k];
+			if (!el) return;
+			if (el.length) [...el].forEach((opt,i)=> 
+				/* 
+				 * ???: переделать тернарники на внешные переменные для повышения читаемости
+				 * 
+				 * Код ужасно читать, не отрицаю
+				 * Но причина сделать так проста - всего 2 строки с простыми условиями
+				 * Вместо 8 или 14 как у меня получалось ранее
+				 */
+				opt[['checkbox','radio'].includes(opt.type) ? 'checked' : 'selected']=
+				Array.isArray(v) ? v.includes(opt.value) : opt.value== v);
+			else
+				el.value=v;
+		});
+		return data;
+	},
+},
+storage:class{
 	constructor(strg,name){
 		this._=strg;
 		this.n=name;
@@ -229,51 +408,45 @@ _.storage=class{
 	clear=()=>Object.keys(this._)
 		.filter(k=>k.startsWith(this.n))
 		.forEach(k=>this._.removeItem(k));
-};
-_.err={
-	print:()=>{},
-
-	errors:{},
-	_c: 0,
-	log(err){
-		_.err.print(_.err._c,err);
-		_.err._c++;
-		_.err.errors[_.err._c]=err;
-	},
-	handleGlobal(message,source,line,column,error){
-		console.error(message,source+':'+line+':'+column,error)
-		_.err.log(message+`\n IN ${source} ON LINE ${line} IN COLUMN ${column}`);
-	},
-	handleRejection(e){
-		const err=e.reason || e;
-		console.error(err);
-		_.err.log(
-			`PROMISE ERROR\n`+
-			`${e.stack || e}`
-		);
-	},
-};
-_.hotkeys={
+},
+hotkeys:{ 
+	/*
+	 * ГОРЯЧИЕ КЛАВИШЫ
+	 * 
+	 * Реализует самый настоящий press/release интерфейс
+	 * Если верить минификатору, после сжатия весит всего 790 байт
+	 * 
+	 * В Object Hub уже есть текстовый редактор горячих клавиш
+	 * На базе этого движка, конечно давать textarea с js кодом...
+	 * Не самая безопасная затея, но как факт кастомизация широчайшая
+	 * 
+	 * _holds работает не на массивах а на new Set()
+	 * Сеты работают намного быстрее при большом объёме данных
+	 * Вы же не хотите чтобы у вас тормозил поток с 100+ хоткеями
+	 * Из-за простого печатанья?
+	 */
 	keys:{},
 	_holds:new Set(),
 	_:false,
 
 	_parse:combo=>combo.split('+').map(k=>k.trim()),
 	_match(keys) {
+		// Нужно сверять все клавишы, это же КОМБИНАЦИЯ а не отдельные куски
 		for (let k of keys) if (!this._holds.has(k)) return false;
 		return true;
 	},
 	_init() {
 		if (this._) return;
 		_.$.on(_.$.D,'keydown',e=>{
-			this._holds.add(e.code);
+			this._holds.add(e.code);// key зависит от раскладки (на Qwerty 'KeyZ' — это 'z', на Йцукен — 'я')
+			// code даёт физическое положение клавиши, что важно для игр и хоткеев, и в целом универсальнее
 
 			for (let combo in this.keys) {
 				let h=this.keys[combo];
 				if (!this._match(h.keys)) continue;
 
 				if (h.press && !h.active) {
-					h.active=true;
+					h.active=true; // active защищает от множественных срабатываний
 					h.press(e);
 				}
 			}
@@ -290,6 +463,10 @@ _.hotkeys={
 			}
 		});
 		_.$.on(window,'blur',()=>{
+			/*
+			 * При переключении в другое окно автоматического keyup не будет
+			 * Поэтому сбрасываем всё принудительно, мало ли
+			 */
 			for (let combo in this.keys) {
 				let h=this.keys[combo];
 				if (h.active) {
@@ -307,6 +484,7 @@ _.hotkeys={
 
 		this.keys[combo]={
 			keys,
+			// press/releace по умолчанию пустышки для сокращения синаксиса
 			press: press || (()=>{}),
 			release: release || (()=>{}),
 			active: false
@@ -317,9 +495,33 @@ _.hotkeys={
 	off(combo) {
 		delete this.keys[combo];
 		return this;
-	}
-};
-_.win={
+	},
+},
+win:{
+	/* 
+	 * МОДУЛЬ ОКОН
+	 * если вы спросите почему ньюхелпер я отвечу
+	 * winBox.js это 35 килобайт, здесь же вы получаете в 25 килобайт
+	 * И более широкий движок окон и документацию уровня...
+	 * А у кого нибуть вообще есть такие подробные документации в вебе?
+	 * 
+	 * Реализует ограниченно-гибкий движок окон, функционал:
+	 * - открытие, разворот на весь экран, закрытие
+	 * - сворачивание в таскбар и разворчаивание
+	 * - нативный css-ресайз (resize:both)
+	 * - возможность двигать окна (работает на телефонах, я проверял)
+	 * - сохранение и загрузка окон по вашему выбору
+	 * 
+	 * !!!: _opn() и toggleFull() могут сломать ваши окна!
+	 * Эти функции высчитывают координаты окна, и размер окна с учётом padding'а
+	 * Ни за что не вешайте на ваши окна transform:translate()!
+	 * 
+	 * !!!: _opn() по умолчанию открывает окно по центру экрана
+	 *      Если не идёт восстановление через write()
+	 * ???: стоит ли открывать окно в центре, или лучше дать "дефолтную функцию" позиционирования
+	 * 
+	 * теперь мне надо вспомнить я рефакторил этот код 4 раза или 7 раз
+	 */
 	manager:false,
 	hider:false,
 
@@ -331,9 +533,9 @@ _.win={
 	hiderAttrs:'',
 	
 	defBtns:[
-		['–',w=>_.win.hide(w)],
-		['=',w=>_.win.toggleFull(w)],
-		['X',w=>_.win.close(w)],
+		['–',w=>w.hide()],
+		['=',w=>w.toggleFull()],
+		['X',w=>w.close()],
 	],
 
 	animOpen:'',
@@ -342,46 +544,54 @@ _.win={
 	animShow:'',
 	animFullOn:'',
 	animFullOff:'',
+	_ae:{once:true},
 
 	_ID(){
 		let id;
+		// Создаём случайный 6 символьный айди, чтобы каждый раз не совпадало
+		// !!!: в теории можно задать любой айди
+		// ???: проверить при скольки окнах генератор начинает тормозить
 		do id=Math.random().toString(36).substring(2,8);
 		while (_.wins[id]);
 		return id;
 	},
 	_winBtn(win,text,func){
-		let b=_.html`<button ${_.win.btnAttrs}>${text}</button>`;
+		let b=_.html`<button ${this.btnAttrs}>${text}</button>`;
 		_.$.on(b,'click',()=>func(win));
 		return b;
 	},
 	_hiderBtn(win){
 		let title=win.langs!== false ? _.lang.win('WINDOW-'+win.langs) : `>${win.name}<`,
-			b=_.html`<button id=hider${win.id} ${_.win.hiderAttrs}${title}/button>`;
-		_.$.on(b,'click',()=>_.win.show(win));
+			b=_.html`<button id=hider${win.id} ${this.hiderAttrs}${title}/button>`;
+		_.$.on(b,'click',()=>this.show(win));
 		return b;
 	},
 	_initWin(win){
-		let wEl=win.elem,
-			x1=0,y1=0,x2=0,y2=0,
+		let D=_.$.D,
+		wEl=win.elem,
+		x1=0,y1=0,x2=0,y2=0,
+		prevent=e=>e.preventDefault(),
 		startW=e=>{
 			let targ=e.target;
+			// Проверяем куда нажали, если бы мы не проверяли,
+			// То драггер не дал бы нам нажать на кнопки или изменить имя окна
 			if (['BUTTON','INPUT'].includes(targ.tagName) || targ.closest('button,input')){
 				return;
 			}
-			_.win.manager.appendChild(wEl);
+			this.manager.appendChild(wEl);
 
-			e.preventDefault();
-			x2=e.clientX || e.touches[0].clientX;
-			y2=e.clientY || e.touches[0].clientY;
+			prevent(e);
+			x2=e.clientX;
+			y2=e.clientY;
 
-			_.$.D.onmouseup=_.$.D.ontouchend=stopW;
+			D.onpointermove=moveW;
 
-			_.$.D.onmousemove=_.$.D.ontouchmove=moveW;
+			D.onpointerup=D.onpointercancel=stopW;
 		},
 		moveW=e=>{
-			e.preventDefault();
-			let cX=e.clientX || e.touches[0].clientX,
-				cY=e.clientY || e.touches[0].clientY;
+			prevent(e);
+			let cX=e.clientX,
+				cY=e.clientY;
 
 			x1=x2 - cX;
 			y1=y2 - cY;
@@ -391,83 +601,97 @@ _.win={
 			wEl.style.top=(wEl.offsetTop - y1) + "px";
 			wEl.style.left=(wEl.offsetLeft - x1) + "px";
 		},
-		stopW=()=>{
-			['mouseup','touchend','mousemove','touchmove']
-			.forEach(e=>_.$.D['on'+e]=null)
-		},
-		drag=win.drag;
-		drag.onmousedown=drag.ontouchstart=startW;
+		stopW=()=>['move','up','cancel'].map(e=>D['onpointer'+e]=null),
+		dr=win.drag;
+		dr.onpointerdown=startW;
+		dr.ontouchmove=prevent;
 	},
 	open(name,content='',customAttrs=''){
-		if (!_.win.manager || !_.win.hider)
-			throw new Error('Window managers not inited');
-		let winId=_.win._ID();
-		_.wins[winId]={};
-		let s=_.wins[winId];
-		s.id=winId;
-		s.name=name;
-		s.langs=name;
-		s.state='opened';
-		s.full=false;
-		s.inRename=false;
-		s.onUnfull={top:0,left:0,width:0,height:0,};
-		
-		s.setTitle = newTitle=>_.win.setTitle(s,newTitle);
-		s.toggleFull = e=>_.win.toggleFull(s);
-		s.close = e=>_.win.close(s);
-		s.hide = e=>_.win.hide(s);
-		s.show = e=>_.win.show(s);
-
-		let html =
-			_.html`<div id=${winId} ${_.win.winAttrs} ${customAttrs}>
+		let winId=this._ID(),
+		winState=_.wins[winId]={
+			id:winId,
+			name:name,
+			langs:name,
+			state:'opened',
+			full:false,
+			inRename:false,
+			// Если окно новое, координаты полностью нулевые, 
+			// Нужно чтобы проверять создаётся ли окно и если да то задавать координаты
+			onUnfull:{top:0,left:0,width:0,height:0},
+			attrs:customAttrs,
+			elem:false,
+			drag:false,
+			content:false,
+		};
+		return this._opn(winState,content);
+	},
+	_opn(w,content=''){
+		if (!this.manager || !this.hider) throw new Error('Window managers not inited');
+
+		let wId=w.id,
+			html=
+			_.html`<div id=${wId} ${this.winAttrs} ${w.attrs}>
 				<div style="display:flex;justify-content:space-between;align-items:center"
-				${_.win.dragAttrs} id=DRAGGER${winId}>
-					<span ${_.win.titleAttrs} id=title${winId}${_.lang.win('WINDOW-'+name)}/span>
-					<div id=btns${winId}></div>
+				${this.dragAttrs} id=DRAGGER${wId}>
+					<span ${this.titleAttrs} id=title${wId}${_.lang.win('WINDOW-'+w.name)}/span>
+					<div id=btns${wId}></div>
 				</div>
-				<div id=content${winId} style=overflow:auto;width:100%;height:100%>
-					${content.replace(/\{winId\}/g,winId)}
+				<div id=content${wId} style=overflow:auto;width:100%;height:100%>
+					${content.replace(/\{winId\}/g,wId)}
 				</div>
 			</div>`,
-			btns=_.$.q(`#btns${winId}`,html);
-		for(let b of _.win.defBtns) btns.append(_.win._winBtn(s,...b));
-
+			btns=_.$.q(`#btns${wId}`,html);
+		for(let b of this.defBtns) btns.append(this._winBtn(w,...b));
 		html.style.overflow='hidden';
 		html.style.resize='both';
 
-		let anim=_.win.animOpen;
+		let anim=this.animOpen;
 		if (anim)
-			_.$.on(html,'animationend',()=>html.classList.remove(anim),{ once: true })
-		_.win.manager.append(html);
-
-		let win=s.elem=_.$.id(winId),
-			c=_.$.id('content'+winId).getBoundingClientRect(), r=win.getBoundingClientRect(),
-			padX=r.width - c.width, padY=r.height - c.height;
-		s.drag=_.$.id('DRAGGER'+winId);
-		s.content=_.$.id('content'+winId);
-
-		if (!customAttrs.includes('top')) {
-			win.style.top=win.offsetTop - (win.offsetHeight / 2) + 'px';
-			win.style.left=win.offsetLeft - (win.offsetWidth / 2) + 'px';
-		}
-		if (!customAttrs.includes('width')) win.style.height=(win.offsetHeight - padX) + 'px';
-		if (!customAttrs.includes('height')) win.style.width=(win.offsetWidth - padY) + 'px';
-
-		_.$.on(s.drag,'dblclick',(e)=>{
+			_.$.on(html,'animationend',()=>html.classList.remove(anim),this._ae);
+		w.setTitle=nT=>_.win.setTitle(w,nT);
+		w.toggleFull=e=>_.win.toggleFull(w);
+		w.close=e=>_.win.close(w);
+		w.hide=e=>_.win.hide(w);
+		w.show=e=>_.win.show(w);
+		this.manager.append(html);
+
+		let win=w.elem=_.$.id(wId),
+			c=_.$.cliRect(_.$.id('content'+wId)),r=_.$.cliRect(win),
+			padX=r.width - c.width,padY=r.height - c.height;
+		w.drag=_.$.id('DRAGGER'+wId);
+		w.content=_.$.id('content'+wId);
+
+		if (w.onUnfull.width === 0) {
+			// Здесь и задаются координаты...
+			// Мастера клин кода не выносите мне мозги прошу
+			// Оно же работает!!!
+			if (!w.attrs.includes('top')) {
+				win.style.top=win.offsetTop - (win.offsetHeight / 2) + 'px';
+				win.style.left=win.offsetLeft - (win.offsetWidth / 2) + 'px';
+			}
+			if (!w.attrs.includes('width')) win.style.height=(win.offsetHeight - padX) + 'px';
+			if (!w.attrs.includes('height')) win.style.width=(win.offsetWidth - padY) + 'px';
+		} else
+			for (let pos in w.onUnfull)
+				win.style[pos] = w.onUnfull[pos] + 'px'
+
+		this._initWin(w);
+		_.$.on(w.drag,'contextmenu',(e)=>{
+			e.preventDefault();
 			if(e.target.closest('button')) return;
-			let wT=_.$.id('title'+winId);
-			if (!s.inRename){
-				wT.innerHTML=`<input ${_.win.renameAttrs} id=rename${winId} value="${wT.textContent}">`;
-				s.inRename=true;
+			let wT=_.$.id('title'+wId);
+			if (!w.inRename){
+				wT.innerHTML=`<input ${this.renameAttrs} id=rename${wId} value="${wT.textContent}">`;
+				w.inRename=true;
 			}else{
-				_.win.setTitle(s,_.$.id('rename'+winId).value);
-				s.inRename=false;
+				this.setTitle(w,_.$.id('rename'+wId).value);
+				w.inRename=false;
 			}
 		});
 
-		_.win._initWin(s);
+		if (w.state === 'hidened') w.hide();
 
-		return s;
+		return w;
 	},
 	setTitle(win,newT){
 		win.langs=false;
@@ -485,12 +709,12 @@ _.win={
 		let wEl=win.elem,
 			ws=wEl.style,
 			wc=wEl.classList,
-			cont=_.$.id('content'+win.id).getBoundingClientRect(),
-			rect=wEl.getBoundingClientRect(),
+			cont=_.$.cliRect(_.$.id('content'+win.id)),
+			rect=_.$.cliRect(wEl),
 			padX=rect.width - cont.width,
 			padY=rect.height - cont.height,
-			aOn=_.win.animFullOn,
-			aOff=_.win.animFullOff,
+			aOn=this.animFullOn,
+			aOff=this.animFullOff,
 			fd={
 				top: rect.top,	left: rect.left,
 				width: cont.width,	height: cont.height,
@@ -509,35 +733,37 @@ _.win={
 				ws.left=0;
 				ws.width=`calc(100% - ${padX}px)`;
 				ws.height=`calc(100% - ${padY}px)`;
-				win.drag.onmousedown=null;
-				win.drag.ontouchstart=null;
+				win.drag.onpointerdown=null;
 			},
 			doUnful=()=>{
 				if (aOff) wc.remove(aOff);
 				unful();
 				win.full=false;
-				_.win._initWin(win);
+				this._initWin(win);
 			},
 			old=win.onUnfull;
 		if (!win.full) {
 			if (aOn) {
 				wc.add(aOn);
-				_.$.on(wEl,'animationend',doFul,{ once: true });
+				_.$.on(wEl,'animationend',doFul,this._ae);
 			}else doFul();
 		} else {
 			if (aOff) {
 				wc.add(aOff);
 				unful();
-				_.$.on(wEl,'animationend',doUnful,{ once: true });
+				_.$.on(wEl,'animationend',doUnful,this._ae);
 			}else doUnful();
 		}
 	},
 	close(win){
 		let w=win.elem,
 			remover=()=>{
-				let drag=win.drag;
-				drag.onmousedown=null;
-				drag.ontouchstart=null;
+				let dr=win.drag,D=_.$.D;
+				dr.onpointerdown=dr.ontouchmove=null;
+				// Удаляем обработчики висящие на документе
+				// Если их не удалять рано или поздно случится утечка памяти
+				// Я не знаю как я жил во времена 2.0 когда движок только появился
+				['move','up','cancel'].map(e=>D['onpointer'+e]=null);
 				w.remove();
 				delete _.wins[win.id];
 			};
@@ -545,34 +771,34 @@ _.win={
 			_.$.id('hider'+win.id).remove();
 			remover();
 		}else{
-			let anim=_.win.animClose;
+			let anim=this.animClose;
 			if(anim){
 				w.classList.add(anim);
-				_.$.on(w,'animationend',remover,{ once: true });
+				_.$.on(w,'animationend',remover,this._ae);
 			}else
 				remover();
 		}
 	},
 	hide(win){
-		let wEl = win.elem,
+		let wEl=win.elem,
 			wc=wEl.classList,
-			anim=_.win.animHide,
+			anim=this.animHide,
 			hider=()=>{
 				wEl.style.display='none';
 				if(anim)wc.remove(anim);
 				win.state='hidened';
-				_.win.hider.append(_.win._hiderBtn(win));
+				this.hider.append(this._hiderBtn(win));
 			}
 		if(anim){
 			wc.add(anim);
-			_.$.on(wEl,'animationend',hider,{ once: true });
+			_.$.on(wEl,'animationend',hider,this._ae);
 		}else
 			hider();
 	},
 	show(win){
-		let wEl = win.elem,
+		let wEl=win.elem,
 			wc=wEl.classList,
-			anim=_.win.animShow,
+			anim=this.animShow,
 			hider=_.$.id('hider'+win.id),
 			shower=()=>{
 				if(anim)wc.remove(anim);
@@ -582,22 +808,63 @@ _.win={
 		hider.remove();
 		if(anim){
 			wc.add(anim);
-			_.$.on(wEl,'animationend',shower,{ once: true });
+			_.$.on(wEl,'animationend',shower,this._ae);
 		}else
 			shower()
 	},
+	read(){
+		let store = {};
+		for (let winId in _.wins) {
+			let win={..._.wins[winId]},
+				size=win.onUnfull,
+				wEl = win.elem,
+				c=_.$.cliRect(win.content),r=_.$.cliRect(wEl);
+			win.realContent=win.content.innerHTML;
+			size.top=r.top;
+			size.left=r.left;
+			size.height=wEl.offsetHeight - (r.height - c.height);
+			size.width=wEl.offsetWidth - (r.width - c.width);
+			delete win.elem;
+			delete win.drag;
+			delete win.content;
+			store[winId] = win;
+		}
+		return store;
+	},
+	write(state){
+		for (let winId in state) {
+			let win=state[winId],
+			content=win.realContent;
+			delete win.realContent;
+			_.wins[winId] = win;
+			this._opn(win,content);
+		}
+	},
+},
+wins:{},
 };
-_.wins={};
 
-_.$.on(window,'error',_.err.handleGlobal);
-_.$.on(window,'unhandledrejection',_.err.handleRejection);
 _.$.on(window,'popstate',()=>{
 	let l=_.link
+	/*
+	 * popstate срабатывает когда:
+	 * - пользователь прыгает по истории назад/вперёд
+	 * - мы вызываем history.pushState (не replaceState)
+	 * 
+	 * _i различает эти случаи:
+	 * true = пользователь прыгнул назад
+	 * false = страница пишет свой адрес в ссылку
+	 */
+	// ???: некоторые браузеры могут вызывать popstate и при реплейсе
 	if (!l._i) {
+		// здесь происходит перенос команд при popstate
+		// читайте _.lang.get() если хотите узнать почему
 		let nUrl='?' + [l.compile()[0],...l._cmd].join('&');
-		history.replaceState(null,null,nUrl);
 		l._i=true;
+		history.replaceState(null,null,nUrl);
 		l.get();
 	} else
 		l._i=false;
 });
+
+return _}();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "newhelper-js",
-  "version": "2.1.0",
+  "version": "2.1.2",
   "description": "сверх лёгкая библиотека для построения админок",
   "keywords": [
     "admin",