mol_crypto2_lib 0.0.37 → 0.0.39

package/node.mjs

@@ -69,6 +69,7 @@ var $;
 var $;
 (function ($) {
     function $mol_base64_decode_node(base64Str) {
+        // without Uint8Array breaks $mol_compare_deep
         const buffer = Buffer.from(base64Str, 'base64');
         return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
     }
@@ -170,6 +171,7 @@ var $;
                 this.setUint16(offset + 4, (value / 2 ** 32) | 0, LE);
             }
         }
+        /** 1-byte signed integer channel for offset. */
         int8(offset, next) {
             if (next === undefined)
                 return this.getInt8(offset);
@@ -177,6 +179,7 @@ var $;
                 return this.setInt8(offset, next), next;
             $mol_fail(new Error(`Wrong int8 value ${next}`));
         }
+        /** 1-byte unsigned integer channel for offset. */
         uint8(offset, next) {
             if (next === undefined)
                 return this.getUint8(offset);
@@ -184,6 +187,7 @@ var $;
                 return this.setUint8(offset, next), next;
             $mol_fail(new Error(`Wrong uint8 value ${next}`));
         }
+        /** 2-byte signed integer little-endian channel for offset. */
         int16(offset, next) {
             if (next === undefined)
                 return this.getInt16(offset, true);
@@ -191,6 +195,7 @@ var $;
                 return this.setInt16(offset, next, true), next;
             $mol_fail(new Error(`Wrong int16 value ${next}`));
         }
+        /** 2-byte unsigned integer little-endian channel for offset. */
         uint16(offset, next) {
             if (next === undefined)
                 return this.getUint16(offset, true);
@@ -198,6 +203,7 @@ var $;
                 return this.setUint16(offset, next, true), next;
             $mol_fail(new Error(`Wrong uint16 value ${next}`));
         }
+        /** 4-byte signed integer little-endian channel for offset. */
         int32(offset, next) {
             if (next === undefined)
                 return this.getInt32(offset, true);
@@ -205,6 +211,7 @@ var $;
                 return this.setInt32(offset, next, true), next;
             $mol_fail(new Error(`Wrong int32 value ${next}`));
         }
+        /** 4-byte unsigned integer little-endian channel for offset. */
         uint32(offset, next) {
             if (next === undefined)
                 return this.getUint32(offset, true);
@@ -212,6 +219,7 @@ var $;
                 return this.setUint32(offset, next, true), next;
             $mol_fail(new Error(`Wrong uint32 value ${next}`));
         }
+        /** 8-byte signed integer little-endian channel for offset. */
         int64(offset, next) {
             if (next === undefined)
                 return this.getBigInt64(offset, true);
@@ -219,6 +227,7 @@ var $;
                 return this.setBigInt64(offset, next, true), next;
             $mol_fail(new Error(`Wrong int64 value ${next}`));
         }
+        /** 6-byte unsigned integer little-endian channel for offset. */
         uint48(offset, next) {
             if (next === undefined)
                 return this.getUint48(offset, true);
@@ -226,6 +235,7 @@ var $;
                 return this.setUint48(offset, next, true), next;
             $mol_fail(new Error(`Wrong uint48 value ${next}`));
         }
+        /** 8-byte unsigned integer little-endian channel for offset. */
         uint64(offset, next) {
             if (next === undefined)
                 return this.getBigUint64(offset, true);
@@ -233,24 +243,29 @@ var $;
                 return this.setBigUint64(offset, next, true), next;
             $mol_fail(new Error(`Wrong uint64 value ${next}`));
         }
+        /** 2-byte float little-endian channel for offset. */
         float16(offset, next) {
             if (next !== undefined)
                 this.setFloat16(offset, next, true);
             return this.getFloat16(offset, true);
         }
+        /** 4-byte float little-endian channel for offset. */
         float32(offset, next) {
             if (next !== undefined)
                 this.setFloat32(offset, next, true);
             return this.getFloat32(offset, true);
         }
+        /** 8-byte float little-endian channel for offset. */
         float64(offset, next) {
             if (next !== undefined)
                 this.setFloat64(offset, next, true);
             return this.getFloat64(offset, true);
         }
+        /** A Uint8Array view for the same buffer. */
         asArray() {
             return new Uint8Array(this.buffer, this.byteOffset, this.byteLength);
         }
+        /** base64ae string from buffer. */
         toString() {
             return $mol_base64_ae_encode(this.asArray());
         }
@@ -287,6 +302,7 @@ var $;
         $.$mol_base64_url_encode = $mol_base64_url_encode_node;
     }
     function $mol_base64_url_decode_node(str) {
+        // without Uint8Array breaks $mol_compare_deep
         const buffer = Buffer.from(str, 'base64url');
         return new Uint8Array(buffer.buffer, buffer.byteOffset, buffer.byteLength);
     }
@@ -312,6 +328,11 @@ var $;
 var $;
 (function ($) {
     const instances = new WeakSet();
+    /**
+     * Proxy that delegates all to lazy returned target.
+     *
+     * 	$mol_delegate( Array.prototype , ()=> fetch_array() )
+     */
     function $mol_delegate(proto, target) {
         const proxy = new Proxy(proto, {
             get: (_, field) => {
@@ -405,7 +426,7 @@ var $;
 var $;
 (function ($) {
     function $mol_fail_hidden(error) {
-        throw error;
+        throw error; /// Use 'Never Pause Here' breakpoint in DevTools or simply blackbox this script
     }
     $.$mol_fail_hidden = $mol_fail_hidden;
 })($ || ($ = {}));
@@ -465,6 +486,9 @@ var $;
         [Symbol.dispose]() {
             this.destructor();
         }
+        //[ Symbol.toPrimitive ]( hint: string ) {
+        //	return hint === 'number' ? this.valueOf() : this.toString()
+        //}
         toString() {
             return this[Symbol.toStringTag] || this.constructor.name + '<>';
         }
@@ -535,9 +559,11 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Base class for crypto keys. */
     class $mol_crypto2_key extends $mol_buffer {
         static size_str = 43;
         static size_bin = 32;
+        /** Kakes key from different params. */
         static from(serial) {
             if (typeof serial === 'string') {
                 serial = new Uint8Array(serial.match(/.{43}/g)
@@ -549,6 +575,7 @@ var $;
             }
             return super.from(serial);
         }
+        /** Array view of public part. */
         asArray() {
             const size = this.constructor.size_bin;
             if (this.byteLength < size) {
@@ -559,6 +586,7 @@ var $;
             }
             return new Uint8Array(this.buffer, this.byteOffset, size);
         }
+        /** String representation of public part. */
         toString() {
             return $mol_base64_url_encode(this.asArray());
         }
@@ -576,7 +604,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
-    const mod = require('module');
+    const mod = require /****/('module');
     const internals = mod.builtinModules;
     function $node_internal_check(name) {
         if (name.startsWith('node:'))
@@ -654,8 +682,8 @@ var $;
 "use strict";
 var $;
 (function ($) {
-    const path = require('path');
-    const mod = require('module');
+    const path = require /****/('path');
+    const mod = require /****/('module');
     const localRequire = mod.createRequire(path.join(process.cwd(), 'package.json'));
     function $node_autoinstall(name) {
         try {
@@ -730,6 +758,7 @@ var $;
                     ])
                 ].map(frame_normalize).join('\n')
             });
+            // в nodejs, что б не дублировалось cause в консоли
             Object.defineProperty(this, 'cause', {
                 get: () => cause
             });
@@ -790,6 +819,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Generates unique identifier. */
     function $mol_guid(length = 8, exists = () => false) {
         for (;;) {
             let id = Math.random().toString(36).substring(2, length + 2).toUpperCase();
@@ -805,11 +835,16 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Special status statuses. */
     let $mol_wire_cursor;
     (function ($mol_wire_cursor) {
+        /** Update required. */
         $mol_wire_cursor[$mol_wire_cursor["stale"] = -1] = "stale";
+        /** Some of (transitive) pub update required. */
         $mol_wire_cursor[$mol_wire_cursor["doubt"] = -2] = "doubt";
+        /** Actual state but may be dropped. */
         $mol_wire_cursor[$mol_wire_cursor["fresh"] = -3] = "fresh";
+        /** State will never be changed. */
         $mol_wire_cursor[$mol_wire_cursor["final"] = -4] = "final";
     })($mol_wire_cursor = $.$mol_wire_cursor || ($.$mol_wire_cursor = {}));
 })($ || ($ = {}));
@@ -818,6 +853,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Collects subscribers in compact array. 28B
+     */
     class $mol_wire_pub extends Object {
         constructor(id = `$mol_wire_pub:${$mol_guid()}`) {
             super();
@@ -825,10 +863,17 @@ var $;
         }
         [Symbol.toStringTag];
         data = [];
+        // Derived objects should be Arrays.
         static get [Symbol.species]() {
             return Array;
         }
-        sub_from = 0;
+        /**
+         * Index of first subscriber.
+         */
+        sub_from = 0; // 4B
+        /**
+         * All current subscribers.
+         */
         get sub_list() {
             const res = [];
             for (let i = this.sub_from; i < this.data.length; i += 2) {
@@ -836,14 +881,23 @@ var $;
             }
             return res;
         }
+        /**
+         * Has any subscribers or not.
+         */
         get sub_empty() {
             return this.sub_from === this.data.length;
         }
+        /**
+         * Subscribe subscriber to this publisher events and return position of subscriber that required to unsubscribe.
+         */
         sub_on(sub, pub_pos) {
             const pos = this.data.length;
             this.data.push(sub, pub_pos);
             return pos;
         }
+        /**
+         * Unsubscribe subscriber from this publisher events by subscriber position provided by `on(pub)`.
+         */
         sub_off(sub_pos) {
             if (!(sub_pos < this.data.length)) {
                 $mol_fail(new Error(`Wrong pos ${sub_pos}`));
@@ -856,21 +910,39 @@ var $;
             if (end === this.sub_from)
                 this.reap();
         }
+        /**
+         * Called when last sub was unsubscribed.
+         **/
         reap() { }
+        /**
+         * Autowire this publisher with current subscriber.
+         **/
         promote() {
             $mol_wire_auto()?.track_next(this);
         }
+        /**
+         * Enforce actualization. Should not throw errors.
+         */
         fresh() { }
+        /**
+         * Allow to put data to caches in the subtree.
+         */
         complete() { }
         get incompleted() {
             return false;
         }
+        /**
+         * Notify subscribers about self changes.
+         */
         emit(quant = $mol_wire_cursor.stale) {
             for (let i = this.sub_from; i < this.data.length; i += 2) {
                 ;
                 this.data[i].absorb(quant, this.data[i + 1]);
             }
         }
+        /**
+         * Moves peer from one position to another. Doesn't clear data at old position!
+         */
         peer_move(from_pos, to_pos) {
             const peer = this.data[from_pos];
             const self_pos = this.data[from_pos + 1];
@@ -878,6 +950,9 @@ var $;
             this.data[to_pos + 1] = self_pos;
             peer.peer_repos(self_pos, to_pos);
         }
+        /**
+         * Updates self position in the peer.
+         */
         peer_repos(peer_pos, self_pos) {
             this.data[peer_pos + 1] = self_pos;
         }
@@ -893,10 +968,16 @@ var $;
 var $;
 (function ($) {
     $.$mol_wire_auto_sub = null;
+    /**
+     * When fulfilled, all publishers are promoted to this subscriber on access to its.
+     */
     function $mol_wire_auto(next = $.$mol_wire_auto_sub) {
         return $.$mol_wire_auto_sub = next;
     }
     $.$mol_wire_auto = $mol_wire_auto;
+    /**
+     * Affection queue. Used to prevent accidental stack overflow on emit.
+     */
     $.$mol_wire_affected = [];
 })($ || ($ = {}));
 
@@ -904,6 +985,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    // https://docs.google.com/document/d/1FTascZXT9cxfetuPRT2eXPQKXui4nWFivUnS_335T3U/preview#
     $['devtoolsFormatters'] ||= [];
     function $mol_dev_format_register(config) {
         $['devtoolsFormatters'].push(config);
@@ -955,6 +1037,7 @@ var $;
                 return false;
             if (!val)
                 return false;
+            // if( Error.isError( val ) ) true
             if (val[$.$mol_dev_format_body])
                 return true;
             return false;
@@ -972,12 +1055,16 @@ var $;
                     return $.$mol_dev_format_accent($mol_dev_format_native(val), '💨', $mol_dev_format_native(error), '');
                 }
             }
+            // if( Error.isError( val ) ) {
+            // 	return $mol_dev_format_native( val )
+            // }
             return null;
         },
     });
     function $mol_dev_format_native(obj) {
         if (typeof obj === 'undefined')
             return $.$mol_dev_format_shade('undefined');
+        // if( ![ 'object', 'function', 'symbol' ].includes( typeof obj )  ) return obj
         return [
             'object',
             {
@@ -1035,6 +1122,9 @@ var $;
         'margin-left': '13px'
     });
     class Stack extends Array {
+        // [ Symbol.toPrimitive ]() {
+        // 	return this.toString()
+        // }
         toString() {
             return this.join('\n');
         }
@@ -1057,6 +1147,7 @@ var $;
             this.method = call.getMethodName() ?? '';
             if (this.method === this.function)
                 this.method = '';
+            // const func = c.getFunction()
             this.pos = [call.getEnclosingLineNumber() ?? 0, call.getEnclosingColumnNumber() ?? 0];
             this.eval = call.getEvalOrigin() ?? '';
             this.source = call.getScriptNameOrSourceURL() ?? '';
@@ -1103,9 +1194,16 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Publisher that can auto collect other publishers. 32B
+     *
+     * 	P1 P2 P3 P4 S1 S2 S3
+     * 	^           ^
+     * 	pubs_from   subs_from
+     */
     class $mol_wire_pub_sub extends $mol_wire_pub {
-        pub_from = 0;
-        cursor = $mol_wire_cursor.stale;
+        pub_from = 0; // 4B
+        cursor = $mol_wire_cursor.stale; // 4B
         get temp() {
             return false;
         }
@@ -1223,10 +1321,27 @@ var $;
                 return;
             this.cursor = quant;
             this.emit($mol_wire_cursor.doubt);
+            // if( pos >= 0 && pos < this.sub_from - 2 ) {
+            // 	const pub = this.data[ pos ] as $mol_wire_pub
+            // 	if( pub instanceof $mol_wire_task ) return
+            // 	for(
+            // 		let cursor = this.pub_from;
+            // 		cursor < this.sub_from;
+            // 		cursor += 2
+            // 	) {
+            // 		const pub = this.data[ cursor ] as $mol_wire_pub
+            // 		if( pub instanceof $mol_wire_task ) {
+            // 			pub.destructor()
+            // 		}
+            // 	}
+            // }
         }
         [$mol_dev_format_head]() {
             return $mol_dev_format_native(this);
         }
+        /**
+         * Is subscribed to any publisher or not.
+         */
         get pub_empty() {
             return this.sub_from === this.pub_from;
         }
@@ -1267,6 +1382,13 @@ var $;
 var $;
 (function ($) {
     const wrappers = new WeakMap();
+    /**
+     * Suspendable task with support both sync/async api.
+     *
+     * 	A1 A2 A3 A4 P1 P2 P3 P4 S1 S2 S3
+     * 	^           ^           ^
+     * 	args_from   pubs_from   subs_from
+     **/
     class $mol_wire_fiber extends $mol_wire_pub_sub {
         task;
         host;
@@ -1287,6 +1409,7 @@ var $;
             });
         }
         static sync() {
+            // Sync whole fiber graph
             while (this.planning.size) {
                 for (const fiber of this.planning) {
                     this.planning.delete(fiber);
@@ -1297,6 +1420,7 @@ var $;
                     fiber.fresh();
                 }
             }
+            // Collect garbage
             while (this.reaping.size) {
                 const fibers = this.reaping;
                 this.reaping = new Set;
@@ -1448,6 +1572,10 @@ var $;
             this.cursor = $mol_wire_cursor.stale;
             this.fresh();
         }
+        /**
+         * Synchronous execution. Throws Promise when waits async task (SuspenseAPI provider).
+         * Should be called inside SuspenseAPI consumer (ie fiber).
+         */
         sync() {
             if (!$mol_wire_fiber.warm) {
                 return this.result();
@@ -1462,6 +1590,10 @@ var $;
             }
             return this.cache;
         }
+        /**
+         * Asynchronous execution.
+         * It's SuspenseAPI consumer. So SuspenseAPI providers can be called inside.
+         */
         async async_raw() {
             while (true) {
                 this.fresh();
@@ -1474,6 +1606,7 @@ var $;
                 if (!$mol_promise_like(this.cache))
                     return this.cache;
                 if (this.cursor === $mol_wire_cursor.final) {
+                    // never ends on destructed fiber
                     await new Promise(() => { });
                 }
             }
@@ -1521,6 +1654,10 @@ var $;
 var $;
 (function ($) {
     $.$mol_compare_deep_cache = new WeakMap();
+    /**
+     * Deeply compares two values. Returns true if equal.
+     * Define `Symbol.toPrimitive` to customize.
+     */
     function $mol_compare_deep(left, right) {
         if (Object.is(left, right))
             return true;
@@ -1660,6 +1797,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Log begin of collapsed group only when some logged inside, returns func to close group */
     function $mol_log3_area_lazy(event) {
         const self = this.$;
         const stack = self.$mol_log3_stack;
@@ -1684,6 +1822,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Position in any resource. */
     class $mol_span extends $mol_object2 {
         uri;
         source;
@@ -1699,13 +1838,17 @@ var $;
             this.length = length;
             this[Symbol.toStringTag] = this.uri + ('#' + this.row + ':' + this.col + '/' + this.length);
         }
+        /** Span for begin of unknown resource */
         static unknown = $mol_span.begin('?');
+        /** Makes new span for begin of resource. */
         static begin(uri, source = '') {
             return new $mol_span(uri, source, 1, 1, 0);
         }
+        /** Makes new span for end of resource. */
         static end(uri, source) {
             return new $mol_span(uri, source, 1, source.length + 1, 0);
         }
+        /** Makes new span for entire resource. */
         static entire(uri, source) {
             return new $mol_span(uri, source, 1, 1, source.length);
         }
@@ -1720,15 +1863,19 @@ var $;
                 length: this.length
             };
         }
+        /** Makes new error for this span. */
         error(message, Class = Error) {
             return new Class(`${message} (${this})`);
         }
+        /** Makes new span for same uri. */
         span(row, col, length) {
             return new $mol_span(this.uri, this.source, row, col, length);
         }
+        /** Makes new span after end of this. */
         after(length = 0) {
             return new $mol_span(this.uri, this.source, this.row, this.col + this.length, length);
         }
+        /** Makes new span between begin and end. */
         slice(begin, end = -1) {
             let len = this.length;
             if (begin < 0)
@@ -1751,6 +1898,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Serializes tree to string in tree format. */
     function $mol_tree2_to_string(tree) {
         let output = [];
         function dump(tree, prefix = '') {
@@ -1794,12 +1942,25 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Abstract Syntax Tree with human readable serialization.
+     * Avoid direct instantiation. Use static factories instead.
+     * @see https://github.com/nin-jin/tree.d
+     */
     class $mol_tree2 extends Object {
         type;
         value;
         kids;
         span;
-        constructor(type, value, kids, span) {
+        constructor(
+        /** Type of structural node, `value` should be empty */
+        type, 
+        /** Content of data node, `type` should be empty */
+        value, 
+        /** Child nodes */
+        kids, 
+        /** Position in most far source resource */
+        span) {
             super();
             this.type = type;
             this.value = value;
@@ -1807,12 +1968,15 @@ var $;
             this.span = span;
             this[Symbol.toStringTag] = type || '\\' + value;
         }
+        /** Makes collection node. */
         static list(kids, span = $mol_span.unknown) {
             return new $mol_tree2('', '', kids, span);
         }
+        /** Makes new derived collection node. */
         list(kids) {
             return $mol_tree2.list(kids, this.span);
         }
+        /** Makes data node for any string. */
         static data(value, kids = [], span = $mol_span.unknown) {
             const chunks = value.split('\n');
             if (chunks.length > 1) {
@@ -1826,21 +1990,26 @@ var $;
             }
             return new $mol_tree2('', value, kids, span);
         }
+        /** Makes new derived data node. */
         data(value, kids = []) {
             return $mol_tree2.data(value, kids, this.span);
         }
+        /** Makes struct node. */
         static struct(type, kids = [], span = $mol_span.unknown) {
             if (/[ \n\t\\]/.test(type)) {
                 $$.$mol_fail(span.error(`Wrong type ${JSON.stringify(type)}`));
             }
             return new $mol_tree2(type, '', kids, span);
         }
+        /** Makes new derived structural node. */
         struct(type, kids = []) {
             return $mol_tree2.struct(type, kids, this.span);
         }
+        /** Makes new derived node with different kids id defined. */
         clone(kids, span = this.span) {
             return new $mol_tree2(this.type, this.value, kids, span);
         }
+        /** Returns multiline text content. */
         text() {
             var values = [];
             for (var kid of this.kids) {
@@ -1850,15 +2019,20 @@ var $;
             }
             return this.value + values.join('\n');
         }
+        /** Parses tree format. */
+        /** @deprecated Use $mol_tree2_from_string */
         static fromString(str, uri = 'unknown') {
             return $$.$mol_tree2_from_string(str, uri);
         }
+        /** Serializes to tree format. */
         toString() {
             return $$.$mol_tree2_to_string(this);
         }
+        /** Makes new tree with node overrided by path. */
         insert(value, ...path) {
             return this.update($mol_maybe(value), ...path)[0];
         }
+        /** Makes new tree with node overrided by path. */
         update(value, ...path) {
             if (path.length === 0)
                 return value;
@@ -1891,6 +2065,7 @@ var $;
                 return [this.clone(kids)];
             }
         }
+        /** Query nodes by path. */
         select(...path) {
             let next = [this];
             for (const type of path) {
@@ -1917,6 +2092,7 @@ var $;
             }
             return this.list(next);
         }
+        /** Filter kids by path or value. */
         filter(path, value) {
             const sub = this.kids.filter(item => {
                 var found = item.select(...path);
@@ -1944,9 +2120,11 @@ var $;
                 $mol_fail_hidden(error);
             }
         }
+        /** Transform tree through context with transformers */
         hack(belt, context = {}) {
             return [].concat(...this.kids.map(child => child.hack_self(belt, context)));
         }
+        /** Makes Error with node coordinates. */
         error(message, Class = Error) {
             return this.span.error(`${message}\n${this.clone([])}`, Class);
         }
@@ -1964,6 +2142,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Syntax error with cordinates and source line snippet. */
     class $mol_error_syntax extends SyntaxError {
         reason;
         line;
@@ -1982,6 +2161,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Parses tree format from string. */
     function $mol_tree2_from_string(str, uri = '?') {
         const span = $mol_span.entire(uri, str);
         var root = $mol_tree2.list([], span);
@@ -1991,6 +2171,7 @@ var $;
             var indent = 0;
             var line_start = pos;
             row++;
+            // read indent
             while (str.length > pos && str[pos] == '\t') {
                 indent++;
                 pos++;
@@ -1999,8 +2180,10 @@ var $;
                 min_indent = indent;
             }
             indent -= min_indent;
+            // invalid tab size
             if (indent < 0 || indent >= stack.length) {
                 const sp = span.span(row, 1, pos - line_start);
+                // skip error line
                 while (str.length > pos && str[pos] != '\n') {
                     pos++;
                 }
@@ -2015,7 +2198,9 @@ var $;
             }
             stack.length = indent + 1;
             var parent = stack[indent];
+            // parse types
             while (str.length > pos && str[pos] != '\\' && str[pos] != '\n') {
+                // type can not contain space and tab
                 var error_start = pos;
                 while (str.length > pos && (str[pos] == ' ' || str[pos] == '\t')) {
                     pos++;
@@ -2027,6 +2212,7 @@ var $;
                     const sp = span.span(row, error_start - line_start + 1, pos - error_start);
                     this.$mol_fail(new this.$mol_error_syntax(`Wrong nodes separator`, str.substring(line_start, line_end), sp));
                 }
+                // read type
                 var type_start = pos;
                 while (str.length > pos &&
                     str[pos] != '\\' &&
@@ -2041,10 +2227,12 @@ var $;
                     parent_kids.push(next);
                     parent = next;
                 }
+                // read one space if exists
                 if (str.length > pos && str[pos] == ' ') {
                     pos++;
                 }
             }
+            // read data
             if (str.length > pos && str[pos] == '\\') {
                 var data_start = pos;
                 while (str.length > pos && str[pos] != '\n') {
@@ -2055,6 +2243,7 @@ var $;
                 parent_kids.push(next);
                 parent = next;
             }
+            // now must be end of text
             if (str.length === pos && stack.length > 0) {
                 const sp = span.span(row, pos - line_start + 1, 1);
                 this.$mol_fail(new this.$mol_error_syntax(`Unexpected EOF, LF required`, str.substring(line_start, str.length), sp));
@@ -2147,6 +2336,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Module for working with terminal. Text coloring when output in terminal */
     class $mol_term_color {
         static reset = this.ansi(0, 0);
         static bold = this.ansi(1, 22);
@@ -2218,6 +2408,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** One-shot fiber */
     class $mol_wire_task extends $mol_wire_fiber {
         static getter(task) {
             return function $mol_wire_task_get(host, args) {
@@ -2243,6 +2434,7 @@ var $;
                 }
                 const key = (host?.[Symbol.toStringTag] ?? host) + ('.' + task.name + '<#>');
                 const next = new $mol_wire_task(key, task, host, args);
+                // Disabled because non-idempotency is required for try-catch
                 if (existen?.temp) {
                     $$.$mol_log3_warn({
                         place: '$mol_wire_task',
@@ -2275,7 +2467,7 @@ var $;
                     try {
                         next[Symbol.toStringTag] = this[Symbol.toStringTag];
                     }
-                    catch {
+                    catch { // Promises throw in strict mode
                         Object.defineProperty(next, Symbol.toStringTag, { value: this[Symbol.toStringTag] });
                     }
                 }
@@ -2328,6 +2520,10 @@ var $;
         props[field] = get_val;
         return get_val;
     }
+    /**
+     * Convert asynchronous (promise-based) API to synchronous by wrapping function and method calls in a fiber.
+     * @see https://mol.hyoo.ru/#!section=docs/=1fcpsq_1wh0h2
+     */
     function $mol_wire_sync(obj) {
         return new Proxy(obj, {
             get(obj, field) {
@@ -2489,6 +2685,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Derived debuggable error with stack */
     function $mol_crypto_restack(error) {
         error = new Error(error instanceof Error ? error.message : String(error), { cause: error });
         $mol_fail_hidden(error);
@@ -2500,7 +2697,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Ed25519 public key for sign verifying. */
     class $mol_crypto2_auditor extends $mol_crypto2_key {
+        /** Native WebAPI public key. */
         async native() {
             return $mol_crypto_native.subtle.importKey('jwk', {
                 crv: "Ed25519",
@@ -2510,6 +2709,7 @@ var $;
                 x: this.toString(),
             }, "Ed25519", Boolean('extractable'), ['verify']).catch($mol_crypto_restack);
         }
+        /** Verifies signature of data. */
         async verify(data, sign) {
             return await $mol_crypto_native.subtle.verify("Ed25519", await this.native(), sign, data).catch($mol_crypto_restack);
         }
@@ -2524,13 +2724,16 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Ed25519 private key for data signing. */
     class $mol_crypto2_signer extends $mol_crypto2_auditor {
         static size_sign = 64;
+        /** Generates new Signer. */
         static async generate() {
             const pair = await $mol_crypto_native.subtle.generateKey("Ed25519", Boolean('extractable'), ['sign', 'verify']).catch($mol_crypto_restack);
             const { x, d } = await $mol_crypto_native.subtle.exportKey('jwk', pair.privateKey).catch($mol_crypto_restack);
             return this.from(x + d);
         }
+        /** Native WebAPI private key. */
         async nativePrivate() {
             return await $mol_crypto_native.subtle.importKey('jwk', {
                 crv: "Ed25519",
@@ -2541,15 +2744,19 @@ var $;
                 d: this.toStringPrivate(),
             }, "Ed25519", Boolean('extractable'), ['sign']).catch($mol_crypto_restack);
         }
+        /** Array view of private part. */
         asArrayPrivate() {
             return new Uint8Array(this.buffer, this.byteOffset + 32, 32);
         }
+        /** String representation of private part. */
         toStringPrivate() {
             return $mol_base64_url_encode(this.asArrayPrivate());
         }
+        /** Returns Auditor from this Signer. */
         auditor() {
             return $mol_crypto2_auditor.from(this.asArray());
         }
+        /** Makes Signature for data. */
         async sign(data) {
             return new Uint8Array(await $mol_crypto_native.subtle.sign("Ed25519", await this.nativePrivate(), data).catch($mol_crypto_restack));
         }
@@ -2570,7 +2777,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** x25519 public key for data encryption. */
     class $mol_crypto2_socket extends $mol_crypto2_key {
+        /** Native WebAPI public key. */
         async native() {
             return await $mol_crypto_native.subtle.importKey('jwk', {
                 crv: 'X25519',
@@ -2591,6 +2800,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** 16 unique bytes. */
     function $mol_crypto2_nonce() {
         return $mol_crypto_native.getRandomValues(new Uint8Array(16));
     }
@@ -2601,6 +2811,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** @deprecated Use $mol_crypto2_nonce */
     $.$mol_crypto_salt = $mol_crypto2_nonce;
 })($ || ($ = {}));
 
@@ -2608,11 +2819,15 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Symmetric cipher with shortest payload. */
     class $mol_crypto_sacred extends $mol_buffer {
+        /** Key size in bytes. */
         static size = 16;
+        /** Makes new random secret. */
         static make() {
             return this.from($mol_crypto_salt());
         }
+        /** Makes from string of buffer view. */
         static from(serial) {
             if (typeof serial === 'string') {
                 serial = new Uint8Array([
@@ -2642,12 +2857,14 @@ var $;
             return $mol_base64_url_encode(this.asArray());
         }
         _native;
+        /** Native crypto secret */
         async native() {
             return this._native ?? (this._native = await $mol_crypto_native.subtle.importKey('raw', this, {
                 name: 'AES-CBC',
                 length: 128,
             }, true, ['encrypt', 'decrypt']).catch($mol_crypto_restack));
         }
+        /** Encrypt any binary message. 16n bytes */
         async encrypt(open, salt) {
             return new Uint8Array(await $mol_crypto_native.subtle.encrypt({
                 name: 'AES-CBC',
@@ -2656,6 +2873,7 @@ var $;
                 iv: salt,
             }, await this.native(), open).catch($mol_crypto_restack));
         }
+        /** Decrypt any binary message. */
         async decrypt(closed, salt) {
             return new Uint8Array(await $mol_crypto_native.subtle.decrypt({
                 name: 'AES-CBC',
@@ -2664,12 +2882,14 @@ var $;
                 iv: salt,
             }, await this.native(), closed).catch($mol_crypto_restack));
         }
+        /** Encrypts 0xFF prefixed buffer. 16 bytes */
         async close(opened, salt) {
             if (opened.getUint8(0) !== 0xFF)
                 throw new Error('Closable buffer should starts with 0xFF');
             const trimed = new Uint8Array(opened.buffer, opened.byteOffset + 1, opened.byteLength - 1);
             return this.encrypt(trimed, salt);
         }
+        /** Decrypts 0xFF prefixed buffer. 16 bytes */
         async open(closed, salt) {
             const trimed = await this.decrypt(closed, salt);
             if (trimed.byteLength !== closed.byteLength - 1)
@@ -2690,13 +2910,16 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** x25519 private key for data encryption. */
     class $mol_crypto2_cipher extends $mol_crypto2_socket {
         static size_secret = 16;
+        /** Generates new Cipher. */
         static async generate() {
             const pair = await $mol_crypto_native.subtle.generateKey("X25519", Boolean('extractable'), ['deriveKey']).catch($mol_crypto_restack);
             const { x, d } = await $mol_crypto_native.subtle.exportKey('jwk', pair.privateKey).catch($mol_crypto_restack);
             return this.from(x + d);
         }
+        /** Native WebAPI private key. */
         async nativePrivate() {
             return $mol_crypto_native.subtle.importKey('jwk', {
                 crv: 'X25519',
@@ -2707,15 +2930,19 @@ var $;
                 d: this.toStringPrivate(),
             }, "X25519", Boolean('extractable'), ['deriveKey', 'deriveBits']).catch($mol_crypto_restack);
         }
+        /** Array view of private part. */
         asArrayPrivate() {
             return new Uint8Array(this.buffer, this.byteOffset + 32, 32);
         }
+        /** String representation of private part. */
         toStringPrivate() {
             return $mol_base64_url_encode(this.asArrayPrivate());
         }
+        /** Returns Socket from this Chipher. */
         socket() {
             return $mol_crypto2_socket.from(this.asArray());
         }
+        /** Makes shared secret for combination of Chiper and Soacket. */
         async secret(pub) {
             return $mol_crypto_sacred.from(new Uint8Array(await $mol_crypto_native.subtle.deriveBits({
                 name: "X25519",
@@ -2739,12 +2966,15 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Compose public key for verifying and encryption, based on Curve25519. */
     class $mol_crypto2_public extends $mol_crypto2_key {
         static size_str = 86;
         static size_bin = 64;
+        /** Return Auditor part. */
         auditor() {
             return $mol_crypto2_auditor.from(this.asArray().subarray(0, 32));
         }
+        /** Return Socket part. */
         socket() {
             return $mol_crypto2_socket.from(this.asArray().subarray(32, 64));
         }
@@ -2768,7 +2998,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Compose private key for signing and encryption, based on Curve25519. */
     class $mol_crypto2_private extends $mol_crypto2_public {
+        /** Generates new private key. */
         static async generate() {
             const [signer, cipher] = await Promise.all([
                 $mol_crypto2_signer.generate(),
@@ -2781,24 +3013,29 @@ var $;
             key.asArrayPrivate().set(cipher.asArrayPrivate(), 32);
             return key;
         }
+        /** Return Signer part. */
         signer() {
             const signer = $mol_crypto2_signer.from($mol_crypto2_auditor.size_bin + $mol_crypto2_signer.size_bin);
             signer.asArray().set(this.asArray().subarray(0, 32));
             signer.asArrayPrivate().set(this.asArrayPrivate().subarray(0, 32));
             return signer;
         }
+        /** Return Cipher part. */
         cipher() {
             const cipher = $mol_crypto2_cipher.from($mol_crypto2_socket.size_bin + $mol_crypto2_cipher.size_bin);
             cipher.asArray().set(this.asArray().subarray(32, 64));
             cipher.asArrayPrivate().set(this.asArrayPrivate().subarray(32, 64));
             return cipher;
         }
+        /** Return Public part. */
         public() {
             return $mol_crypto2_public.from(this.asArray());
         }
+        /** Array view of private part. */
         asArrayPrivate() {
             return new Uint8Array(this.buffer, this.byteOffset + 64, 64);
         }
+        /** String representation of private part. */
         toStringPrivate() {
             return this.signer().toStringPrivate() + this.cipher().toStringPrivate();
         }