mam 1.11.921 → 1.11.923

package/node.test.js

@@ -35,6 +35,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) => {
@@ -138,7 +143,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;
 })($ || ($ = {}));
@@ -230,6 +235,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 + '<>';
         }
@@ -261,6 +269,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();
@@ -276,11 +285,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 = {}));
 })($ || ($ = {}));
@@ -289,6 +303,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();
@@ -296,10 +313,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) {
@@ -307,14 +331,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}`));
@@ -327,21 +360,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];
@@ -349,6 +400,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;
         }
@@ -364,10 +418,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 = [];
 })($ || ($ = {}));
 
@@ -375,6 +435,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);
@@ -426,6 +487,7 @@ var $;
                 return false;
             if (!val)
                 return false;
+            // if( Error.isError( val ) ) true
             if (val[$.$mol_dev_format_body])
                 return true;
             return false;
@@ -443,12 +505,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',
             {
@@ -506,6 +572,9 @@ var $;
         'margin-left': '13px'
     });
     class Stack extends Array {
+        // [ Symbol.toPrimitive ]() {
+        // 	return this.toString()
+        // }
         toString() {
             return this.join('\n');
         }
@@ -528,6 +597,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() ?? '';
@@ -574,9 +644,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;
         }
@@ -694,10 +771,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;
         }
@@ -753,6 +847,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;
@@ -773,6 +874,7 @@ var $;
             });
         }
         static sync() {
+            // Sync whole fiber graph
             while (this.planning.size) {
                 for (const fiber of this.planning) {
                     this.planning.delete(fiber);
@@ -783,6 +885,7 @@ var $;
                     fiber.fresh();
                 }
             }
+            // Collect garbage
             while (this.reaping.size) {
                 const fibers = this.reaping;
                 this.reaping = new Set;
@@ -934,6 +1037,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();
@@ -948,6 +1055,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();
@@ -960,6 +1071,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(() => { });
                 }
             }
@@ -1007,6 +1119,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;
@@ -1146,6 +1262,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;
@@ -1170,6 +1287,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Position in any resource. */
     class $mol_span extends $mol_object2 {
         uri;
         source;
@@ -1185,13 +1303,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);
         }
@@ -1206,15 +1328,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)
@@ -1237,6 +1363,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 = '') {
@@ -1280,12 +1407,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;
@@ -1293,12 +1433,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) {
@@ -1312,21 +1455,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) {
@@ -1336,15 +1484,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;
@@ -1377,6 +1530,7 @@ var $;
                 return [this.clone(kids)];
             }
         }
+        /** Query nodes by path. */
         select(...path) {
             let next = [this];
             for (const type of path) {
@@ -1403,6 +1557,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);
@@ -1430,9 +1585,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);
         }
@@ -1450,6 +1607,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Syntax error with cordinates and source line snippet. */
     class $mol_error_syntax extends SyntaxError {
         reason;
         line;
@@ -1468,6 +1626,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);
@@ -1477,6 +1636,7 @@ var $;
             var indent = 0;
             var line_start = pos;
             row++;
+            // read indent
             while (str.length > pos && str[pos] == '\t') {
                 indent++;
                 pos++;
@@ -1485,8 +1645,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++;
                 }
@@ -1501,7 +1663,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++;
@@ -1513,6 +1677,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] != '\\' &&
@@ -1527,10 +1692,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') {
@@ -1541,6 +1708,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));
@@ -1633,6 +1801,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);
@@ -1704,6 +1873,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) {
@@ -1729,6 +1899,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',
@@ -1761,7 +1932,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] });
                     }
                 }
@@ -1786,6 +1957,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Convert a pseudo-synchronous (Suspense API) API to an explicit asynchronous one (for integrating with external systems). */
     function $mol_wire_async(obj) {
         let fiber;
         const temp = $mol_wire_task.getter(obj);
@@ -1866,6 +2038,7 @@ var $;
 var $;
 (function ($) {
     const TypedArray = Object.getPrototypeOf(Uint8Array);
+    /** Returns string key for any value. */
     function $mol_key(value) {
         primitives: {
             if (typeof value === 'bigint')
@@ -1873,9 +2046,9 @@ var $;
             if (typeof value === 'symbol')
                 return `Symbol(${value.description})`;
             if (!value)
-                return JSON.stringify(value);
+                return JSON.stringify(value); // 0, null, ""
             if (typeof value !== 'object' && typeof value !== 'function')
-                return JSON.stringify(value);
+                return JSON.stringify(value); // boolean, number, string
         }
         caching: {
             let key = $mol_key_store.get(value);
@@ -1952,6 +2125,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Decorates method to fiber to ensure it is executed only once inside other fiber.
+     */
     function $mol_wire_method(host, field, descr) {
         if (!descr)
             descr = Reflect.getOwnPropertyDescriptor(host, field);
@@ -1984,6 +2160,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Long-living fiber. */
     class $mol_wire_atom extends $mol_wire_fiber {
         static solo(host, task) {
             const field = task.name + '()';
@@ -2034,7 +2211,11 @@ var $;
             }
             $mol_wire_atom.watching.add(this);
         }
+        /**
+         * Update atom value through another temp fiber.
+         */
         resync(args) {
+            // enforce pulling tasks abort
             for (let cursor = this.pub_from; cursor < this.sub_from; cursor += 2) {
                 const pub = this.data[cursor];
                 if (pub && pub instanceof $mol_wire_task) {
@@ -2095,7 +2276,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] });
                     }
                 }
@@ -2123,6 +2304,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Decorates solo object channel to [mol_wire_atom](../atom/atom.ts). */
     function $mol_wire_solo(host, field, descr) {
         if (!descr)
             descr = Reflect.getOwnPropertyDescriptor(host, field);
@@ -2161,6 +2343,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Reactive memoizing multiplexed property decorator. */
     function $mol_wire_plex(host, field, descr) {
         if (!descr)
             descr = Reflect.getOwnPropertyDescriptor(host, field);
@@ -2199,7 +2382,25 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Reactive memoizing solo property decorator from [mol_wire](../wire/README.md)
+     * @example
+     * '@' $mol_mem
+     * name(next?: string) {
+     * 	return next ?? 'default'
+     * }
+     * @see https://mol.hyoo.ru/#!section=docs/=qxmh6t_sinbmb
+     */
     $.$mol_mem = $mol_wire_solo;
+    /**
+     * Reactive memoizing multiplexed property decorator [mol_wire](../wire/README.md)
+     * @example
+     * '@' $mol_mem_key
+     * name(id: number, next?: string) {
+     *  return next ?? 'default'
+     * }
+     * @see https://mol.hyoo.ru/#!section=docs/=qxmh6t_sinbmb
+     */
     $.$mol_mem_key = $mol_wire_plex;
 })($ || ($ = {}));
 
@@ -2235,6 +2436,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) {
@@ -2359,7 +2564,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:'))
@@ -2373,8 +2578,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 {
@@ -2421,6 +2626,7 @@ require = (req => Object.assign(function require(name) {
 "use strict";
 var $;
 (function ($) {
+    /** Run code without state changes */
     function $mol_wire_probe(task, def) {
         const warm = $mol_wire_fiber.warm;
         try {
@@ -2469,6 +2675,7 @@ var $;
                     ])
                 ].map(frame_normalize).join('\n')
             });
+            // в nodejs, что б не дублировалось cause в консоли
             Object.defineProperty(this, 'cause', {
                 get: () => cause
             });
@@ -2672,7 +2879,7 @@ var $;
                     const err = new Error('Worker exited', { cause: { code } });
                     if (!inited)
                         return fail(err);
-                    this.error([err]);
+                    this.error([err]); // Need to reset callers fail callbacks
                     this.restarts(null);
                 });
                 worker.on('message', e => {
@@ -2732,6 +2939,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Decorates method to fiber to ensure it is executed only once inside other fiber from [mol_wire](../wire/README.md)
+     * @see https://mol.hyoo.ru/#!section=docs/=1fcpsq_1wh0h2
+     */
     $.$mol_action = $mol_wire_method;
 })($ || ($ = {}));
 
@@ -2818,6 +3029,7 @@ var $;
             $mol_error_fence(() => this.remote().changes(changes), e => ($mol_fail_log(e), null));
         }
         changes_schedule() {
+            // ts watcher calls it in host syncronously
             if (this.changes_tick === undefined)
                 return;
             if (this.changes_tick !== null)
@@ -2847,11 +3059,12 @@ var $;
             }
             this.run();
         }
+        // Do not place async logic here, to prevent recheck calls race
         recheck() {
             this.changes_tick?.destructor();
-            this.changes_tick = undefined;
-            this.watching(true);
-            this.host();
+            this.changes_tick = undefined; // disable watch sending
+            this.watching(true); // enable host pull in start
+            this.host(); // wait host started
             this.recheck_internal();
             return this.changes_cut();
         }
@@ -2868,6 +3081,7 @@ var $;
             }, {
                 ...$node.typescript.sys,
                 watchDirectory: (path, cb) => {
+                    // console.log('watchDirectory', path )
                     this.watchers.set(path, cb);
                     return { close() { } };
                 },
@@ -2878,6 +3092,7 @@ var $;
                     this.run = cb;
                 },
                 watchFile: (path, cb) => {
+                    // console.log('watchFile', path )
                     this.watchers.set(path, cb);
                     return { close() { } };
                 },
@@ -2898,7 +3113,9 @@ var $;
                         message: typeof text === 'string' ? text : text.messageText,
                     });
                 }
-            }, () => { }, [], {
+            }, () => { }, //watch reports
+            [], // project refs
+            {
                 synchronousWatchDirectory: true,
                 watchFile: 5,
                 watchDirectory: 0,
@@ -2999,6 +3216,11 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Returns closure that returns constant value.
+     * @example
+     * const rnd = $mol_const( Math.random() )
+     */
     function $mol_const(value) {
         const getter = (() => value);
         getter['()'] = value;
@@ -3089,7 +3311,8 @@ var $;
 "use strict";
 var $;
 (function ($) {
-    let buf = new Uint8Array(2 ** 12);
+    let buf = new Uint8Array(2 ** 12); // 4KB Mem Page
+    /** Temporary buffer. Recursive usage isn't supported. */
     function $mol_charset_buffer(size) {
         if (buf.byteLength < size)
             buf = new Uint8Array(size);
@@ -3111,19 +3334,19 @@ var $;
         let pos = from;
         for (let i = 0; i < str.length; i++) {
             let code = str.charCodeAt(i);
-            if (code < 0x80) {
+            if (code < 0x80) { // ASCII - 1 octet
                 buf[pos++] = code;
             }
-            else if (code < 0x800) {
+            else if (code < 0x800) { // 2 octet
                 buf[pos++] = 0xc0 | (code >> 6);
                 buf[pos++] = 0x80 | (code & 0x3f);
             }
-            else if (code < 0xd800 || code >= 0xe000) {
+            else if (code < 0xd800 || code >= 0xe000) { // 3 octet
                 buf[pos++] = 0xe0 | (code >> 12);
                 buf[pos++] = 0x80 | ((code >> 6) & 0x3f);
                 buf[pos++] = 0x80 | (code & 0x3f);
             }
-            else {
+            else { // surrogate pair
                 const point = ((code - 0xd800) << 10) + str.charCodeAt(++i) + 0x2400;
                 buf[pos++] = 0xf0 | (point >> 18);
                 buf[pos++] = 0x80 | ((point >> 12) & 0x3f);
@@ -3185,6 +3408,9 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Disable reaping of current subscriber
+     */
     function $mol_wire_solid() {
         let current = $mol_wire_auto();
         if (current.temp)
@@ -3205,12 +3431,16 @@ var $;
 (function ($) {
     let file_modes;
     (function (file_modes) {
+        /** create if it doesn't already exist */
         file_modes[file_modes["create"] = $node.fs.constants.O_CREAT] = "create";
+        /** truncate to zero size if it already exists */
         file_modes[file_modes["exists_truncate"] = $node.fs.constants.O_TRUNC] = "exists_truncate";
+        /** throw exception if it already exists */
         file_modes[file_modes["exists_fail"] = $node.fs.constants.O_EXCL] = "exists_fail";
         file_modes[file_modes["read_only"] = $node.fs.constants.O_RDONLY] = "read_only";
         file_modes[file_modes["write_only"] = $node.fs.constants.O_WRONLY] = "write_only";
         file_modes[file_modes["read_write"] = $node.fs.constants.O_RDWR] = "read_write";
+        /** data will be appended to the end */
         file_modes[file_modes["append"] = $node.fs.constants.O_APPEND] = "append";
     })(file_modes || (file_modes = {}));
     function mode_mask(modes) {
@@ -3275,12 +3505,24 @@ var $;
         root() {
             const path = this.path();
             const base = this.constructor.base;
+            // Если путь выше или равен base или если parent такойже как и this - считаем это корнем
             return base.startsWith(path) || this == this.parent();
         }
         stat(next, virt) {
             const path = this.path();
             const parent = this.parent();
+            // Отслеживать проверку наличия родительской папки не стоит до корня диска
+            // Лучше ограничить mam-ом
             if (!this.root()) {
+                /*
+                Если parent папка удалилась, надо ресетнуть все объекты в ней на любой глубине.
+                Например, rm -rf с последующим git pull: parent папка может удалиться, потом создасться,
+                а текущая папка успеет только удалиться до момента выполнения stat.
+                Поэтому parent.exists() не запустит перевычисления, нужна именно parent.version()
+
+                Однако, parent.version() меняется не только при удалении, будет ложное срабатывание
+                С этим придется мириться, красивого решения пока нет.
+                */
                 parent.version();
             }
             parent.watcher();
@@ -3294,9 +3536,19 @@ var $;
             if (/([\/\\]\.|___$)/.test(path))
                 return;
             const file = this.relative(path.at(-1) === '/' ? path.slice(0, -1) : path);
+            // console.log(type, path)
+            // add (change): добавился файл - у parent надо обновить список sub, если он был заюзан
+            // change, unlink (rename): обновился или удалился файл - ресетим
+            // addDir (change), добавилась папка, у parent обновляем список директорий в sub
+            // дочерние ресетим
+            // unlinkDir (rename), удалилась папка, ресетим ее
+            // stat у всех дочерних обновится сам, т.к. связан с parent.version()
             this.changed.add(file);
             if (!this.watching)
                 return;
+            // throttle, пока события поступают не сбрасываем.
+            // аналог awaitWriteFinish из chokidar
+            // интервалы между change-сообщениями модифицируемого файла должны быть меньше watch_debounce
             this.frame?.destructor();
             this.frame = new this.$.$mol_after_timeout(this.watch_debounce(), () => {
                 if (!this.watching)
@@ -3305,8 +3557,16 @@ var $;
                 $mol_wire_async(this).flush();
             });
         }
+        /**
+         * Должно быть больше, чем время между событиями от вотчера при записи внешним процессом.
+         * Иначе запуск ресетов паралельно с изменением может привести к неконсистентности.
+         */
         static watch_debounce() { return 500; }
         static flush() {
+            // Пока flush работает, вотчер сюда не заходит, но может добавлять новые изменения
+            // на каждом перезапуске они применятся
+            // Пока run выполняется, изменения накапливаются, в конце run вызывается flush
+            // Пока применяются изменения, run должен ожидать конца flush
             for (const file of this.changed) {
                 const parent = file.parent();
                 try {
@@ -3321,16 +3581,32 @@ var $;
             }
             this.changed.clear();
             this.watching = true;
+            // this.watch_wd?.destructor()
+            // this.watch_wd = null
         }
         static watching = true;
         static lock = new $mol_lock;
         static watch_off(path) {
             this.watching = false;
+            // run должен ожидать конца flush
             this.flush();
             this.watching = false;
+            /*
+            watch запаздывает и событие может прилететь через 3 сек после окончания сайд эффекта
+            поэтому добавляем папку, которую меняет side_effect
+            Когда дойдет до выполнения flush, он ресетнет ее
+            
+            Иначе будут лишние срабатывания
+            Например, удалили hyoo/board, watch ресетит и exists начинает отдавать false, срабатывает git clone
+            Сразу после него событие addDir еще не успело прийти,
+            на следующем перезапуске вызывается git pull, т.к.
+            с точки зрения реактивной системы hyoo/board еще не существует.
+            */
             this.changed.add(this.absolute(path));
         }
+        // protected static watch_wd = null as null | $mol_after_timeout
         static unwatched(side_effect, affected_dir) {
+            // ждем, пока выполнится предыдущий unwatched
             const unlock = this.lock.grab();
             this.watch_off(affected_dir);
             try {
@@ -3353,6 +3629,7 @@ var $;
         modified() { return this.stat()?.mtime ?? null; }
         version() {
             const next = this.stat()?.mtime.getTime().toString(36).toUpperCase() ?? '';
+            // console.log('version', next, this.path())
             return next;
         }
         info(path) { return null; }
@@ -3370,15 +3647,19 @@ var $;
         writable(opts) {
             return new WritableStream;
         }
+        // open( ... modes: readonly $mol_file_mode[] ) { return 0 }
         buffer(next) {
+            // Если версия пустая - возвращаем пустой буфер
             let readed = new Uint8Array();
             if (next === undefined) {
+                // Если меняется версия файла, буфер надо перечитать
                 if (this.version())
                     readed = this.read();
             }
             const prev = $mol_mem_cached(() => this.buffer());
             const changed = prev === undefined || !$mol_compare_array(prev, next ?? readed);
             if (prev !== undefined && changed) {
+                // Логируем, если повторно читаем/пишем и буфер поменялся
                 this.$.$mol_log3_rise({
                     place: `$mol_file_node.buffer()`,
                     message: 'Changed',
@@ -3387,6 +3668,11 @@ var $;
             }
             if (next === undefined)
                 return changed ? readed : prev;
+            // Если буфер при записи не поменялся и файл не удаляли перед этим - не записываем новую версию.
+            // Если записывать, это приведет к смене mtime и вотчер снова триггернется, даже если содержимое файла не поменялось.
+            // В этом алгоритме есть изъян.
+            // Если файл записали, потом отключили вотчер, кто-то из вне его поменял, потом включили вотчер, снова записали тот же буфер,
+            // то буфер не запишется на диск, т.к. кэш не консистентен с диском.
             if (!changed && this.exists())
                 return prev;
             this.parent().exists(true);
@@ -3422,13 +3708,21 @@ var $;
             }
             return null;
         }
+        // static watch_root = ''
+        // static watcher_warned = false
         watcher() {
+            // const constructor = this.constructor as typeof $mol_file_base
+            // if (! constructor.watcher_warned) {
+            // 	console.warn(`${constructor}.watcher() not implemented`)
+            // 	constructor.watcher_warned = true
+            // }
             return {
                 destructor() { }
             };
         }
         exists(next) {
             const exists = Boolean(this.stat());
+            // console.log('exists current', exists, 'next', next, this.path())
             if (next === undefined)
                 return exists;
             if (next === exists)
@@ -3454,6 +3748,10 @@ var $;
             return match ? match[1].substring(1) : '';
         }
         text(next, virt) {
+            // Если записываем text, и вотчер ресетнул записанный файл,
+            // то надо снова его обновить, вызвать логику, которая делала пуш в text.
+            // Например файл удалили, потом снова создали, версия поменялась - перезаписываем
+            // Если использовать version, то вновь созданный файл, через вотчер запустит свое пересоздание
             if (next !== undefined)
                 this.exists();
             return this.text_int(next, virt);
@@ -3478,6 +3776,7 @@ var $;
             if (this.type() !== 'dir')
                 return [];
             this.version();
+            // Если дочерний file удалился, список надо обновить
             return this.kids().filter(file => file.exists());
         }
         resolve(path) {
@@ -3622,10 +3921,15 @@ var $;
         watcher(reset) {
             const path = this.path();
             const root = this.root();
+            // Если папки/файла нет, watch упадет с ошибкой
+            // exists обратится к parent.version и parent.watcher
+            // Поэтому у root-папки и выше не надо вызывать exists, иначе поднимется выше base до корня диска
+            // exists вызывать надо, что б пересоздавать вотчер при появлении папки или файла
             if (!root && !this.exists())
                 return super.watcher();
             let watcher;
             try {
+                // Между exists и watch файл может удалиться, в любом случае надо обрабатывать ENOENT
                 watcher = $node.fs.watch(path);
             }
             catch (error) {
@@ -3635,6 +3939,8 @@ var $;
                 if (root || error.code !== 'ENOENT') {
                     this.$.$mol_fail_log(error);
                 }
+                // Если файла нет - вотчер не создается, создастся потом, когда exists поменяется на true.
+                // Если создание упало с другой ошибкой - не ломаем работу mol_file, деградируем до не реактивной fs.
                 return super.watcher();
             }
             watcher.on('change', (type, name) => {
@@ -3646,6 +3952,7 @@ var $;
             watcher.on('error', e => this.$.$mol_fail_log(e));
             let destructed = false;
             watcher.on('close', () => {
+                // Если в процессе работы вотчер сам закрылся, надо его переоткрыть
                 if (!destructed)
                     setTimeout(() => $mol_wire_async(this).watcher(null), 500);
             });
@@ -4001,14 +4308,18 @@ var $;
                 ];
             },
             '': (input, belt) => {
+                // string
                 if (!input.type)
                     return [
                         input.data(JSON.stringify(input.text())),
                     ];
+                // variable
                 if (/^[\w$#][\w0-9$]*$/i.test(input.type))
                     return [
                         input.data(input.type),
+                        // ... input.hack( context ),
                     ];
+                // number
                 if ($mol_tree2_js_is_number(input.type))
                     return [
                         input.data(input.type)
@@ -4140,8 +4451,10 @@ var $;
 var $;
 (function ($) {
     let x = /x/[Symbol.matchAll];
+    /** Type safe reguar expression builder */
     class $mol_regexp extends RegExp {
         groups;
+        /** Prefer to use $mol_regexp.from */
         constructor(source, flags = 'gsu', groups = []) {
             super(source, flags);
             this.groups = groups;
@@ -4161,12 +4474,14 @@ var $;
                 this.lastIndex = index;
             }
         }
+        /** Parses input and returns found capture groups or null */
         [Symbol.match](str) {
             const res = [...this[Symbol.matchAll](str)].filter(r => r.groups).map(r => r[0]);
             if (!res.length)
                 return null;
             return res;
         }
+        /** Splits string by regexp edges */
         [Symbol.split](str) {
             const res = [];
             let token_last = null;
@@ -4221,12 +4536,14 @@ var $;
         get native() {
             return new RegExp(this.source, this.flags);
         }
+        /** Makes regexp that greedy repeats this pattern with delimiter */
         static separated(chunk, sep) {
             return $mol_regexp.from([
                 $mol_regexp.repeat_greedy([[chunk], sep], 0),
                 chunk,
             ]);
         }
+        /** Makes regexp that non-greedy repeats this pattern from min to max count */
         static repeat(source, min = 0, max = Number.POSITIVE_INFINITY) {
             const regexp = $mol_regexp.from(source);
             const upper = Number.isFinite(max) ? max : '';
@@ -4242,6 +4559,7 @@ var $;
             };
             return regexp2;
         }
+        /** Makes regexp that greedy repeats this pattern from min to max count */
         static repeat_greedy(source, min = 0, max = Number.POSITIVE_INFINITY) {
             const regexp = $mol_regexp.from(source);
             const upper = Number.isFinite(max) ? max : '';
@@ -4257,6 +4575,7 @@ var $;
             };
             return regexp2;
         }
+        /** Makes regexp that match any of options */
         static vary(sources, flags = 'gsu') {
             const groups = [];
             const chunks = sources.map(source => {
@@ -4266,17 +4585,21 @@ var $;
             });
             return new $mol_regexp(`(?:${chunks.join('|')})`, flags, groups);
         }
+        /** Makes regexp that allow absent of this pattern */
         static optional(source) {
             return $mol_regexp.repeat_greedy(source, 0, 1);
         }
+        /** Makes regexp that look ahead for pattern */
         static force_after(source) {
             const regexp = $mol_regexp.from(source);
             return new $mol_regexp(`(?=${regexp.source})`, regexp.flags, regexp.groups);
         }
+        /** Makes regexp that look ahead for pattern */
         static forbid_after(source) {
             const regexp = $mol_regexp.from(source);
             return new $mol_regexp(`(?!${regexp.source})`, regexp.flags, regexp.groups);
         }
+        /** Converts some js values to regexp */
         static from(source, { ignoreCase, multiline } = {
             ignoreCase: false,
             multiline: false,
@@ -4377,9 +4700,11 @@ var $;
                 return regexp;
             }
         }
+        /** Makes regexp which includes only unicode category */
         static unicode_only(...category) {
             return new $mol_regexp(`\\p{${category.join('=')}}`);
         }
+        /** Makes regexp which excludes unicode category */
         static unicode_except(...category) {
             return new $mol_regexp(`\\P{${category.join('=')}}`);
         }
@@ -4500,13 +4825,23 @@ var $;
 var $;
 (function ($) {
     const err = $mol_view_tree2_error_str;
+    const is_writable = (input) => input.type.includes('?');
     function $mol_view_tree2_class_props(klass) {
         let props = this.$mol_view_tree2_class_super(klass);
+        // ! syntax to * and ?val syntax to ?
         props = props.clone(props.hack({
             '': (node, belt) => {
-                const normal = node.type.replace(/!\w+/, '*');
+                const next = node.type.indexOf('?');
+                const id = node.type.indexOf('!');
+                let normal = node.type;
+                const ch = node.type[id + 1];
+                if (id !== -1 && ch?.toUpperCase() !== ch?.toLowerCase())
+                    normal = `${normal.substring(0, id)}*${next === -1 ? '' : '?'}`;
+                else if (next !== -1)
+                    normal = normal.substring(0, next + 1);
                 if (node.type === normal)
                     return [node.clone(node.hack(belt))];
+                console.warn(`Syntax ${node.type} is deprecated. Use ${normal} instead`);
                 return [node.struct(normal, node.hack(belt))];
             }
         }));
@@ -4543,12 +4878,26 @@ var $;
                         this.$mol_fail(err `Need a child ${operator.span}`);
                     if (!context.factory)
                         this.$mol_fail(err `Need a parent ${left.span}`);
+                    if (is_writable(left) !== is_writable(right))
+                        this.$mol_fail(err `Left and right operands are not compatible at ${operator.span}`);
                     add_inner(right.clone([
                         right.struct('=', [
                             context.factory.struct(context.factory.type.replace(/\*.*/, '*'), [left.clone([])]),
                         ]),
                     ]));
                 }
+                else if (operator?.type === "<=>") {
+                    const right = operator.kids[0];
+                    if (!right)
+                        this.$mol_fail(err `Need a child ${operator.span}`);
+                    if (!is_writable(left))
+                        this.$mol_fail(err `Expected writable at ${left.span}`);
+                    if (!is_writable(right))
+                        this.$mol_fail(err `Expected writable at ${right.span}`);
+                }
+                else if (operator?.type === "<=" && is_writable(left)) {
+                    this.$mol_fail(err `Expected readonly at ${left.span}`);
+                }
                 if (right)
                     context = { factory: right.clone([]) };
                 else if (operator && !context.factory && $mol_view_tree2_class_match(operator)) {
@@ -4749,6 +5098,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Localisation in $mol framework
+     * @see https://mol.hyoo.ru/#!section=docs/=s5aqnb_odub8l
+     */
     class $mol_locale extends $mol_object {
         static lang_default() {
             return 'en';
@@ -4908,12 +5261,14 @@ var $;
             '=>': bind => [],
             '^': (ref, belt, context) => [
                 ref.struct('...', [
+                    // prop ^ foo
                     ref.kids[0]?.type
                         ? ref.struct('()', [
                             ref.struct('this'),
                             ref.struct('[]', [ref.data(name_of.call(this, ref.kids[0]))]),
                             args_of.call(this, ref.kids[0])
                         ])
+                        // Having $having foo / ^
                         : context.chain
                             ? ref.struct('()', [
                                 ref.struct('this'),
@@ -4925,6 +5280,7 @@ var $;
                                 ref.struct('(,)', [ref.struct('obj')]),
                                 ...context.chain.slice(1).map(field => ref.struct('[]', [ref.data(field)]))
                             ])
+                            // prop ^
                             : ref.struct('()', [
                                 ref.struct('super'),
                                 ref.struct('[]', [ref.data(name)]),
@@ -5206,6 +5562,7 @@ var $;
                         const left_parts = this.$mol_view_tree2_prop_parts(left);
                         const right_parts = this.$mol_view_tree2_prop_parts(right);
                         let conflict;
+                        // if (left_parts.next && right_parts.next) conflict = 'next'
                         if (left_parts.key && right_parts.key)
                             conflict = 'key';
                         if (conflict) {
@@ -5330,7 +5687,7 @@ var $;
                 }, context);
                 return prop.struct('indent', [
                     prop.struct('line', [
-                        channel_signature.call(this, prop, ...val),
+                        channel_signature.call(this, prop, ...val), // Parameter, not Return
                         prop.data(': '),
                         ...val,
                     ])
@@ -5556,18 +5913,33 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * # Generic Graph model
+     * - Supports any type of Nodes and Edges.
+     * - All links are ordered, but this may be ignored.
+     * - Multigraph supported using arrays of Edges.
+     * - Hypergraph supported by reusing same Edge on set of links.
+     * - Ubergraph supported using Edges as Nodes to.
+     **/
     class $mol_graph {
+        /** All registered Nodes */
         nodes = new Set();
+        /** Edges for Nodes pairs (from-to-edge) */
         edges_out = new Map();
+        /** Edges for Nodes pairs (to-from-edge) */
         edges_in = new Map();
+        // LINKING NODES
+        /** Full connect two Nodes */
         link(from, to, edge) {
             this.link_out(from, to, edge);
             this.link_in(to, from, edge);
         }
+        /** Full disconnect two Nodes */
         unlink(from, to) {
             this.edges_in.get(to)?.delete(from);
             this.edges_out.get(from)?.delete(to);
         }
+        /** Forward connect two Nodes */
         link_out(from, to, edge) {
             let pair = this.edges_out.get(from);
             if (!pair) {
@@ -5578,6 +5950,7 @@ var $;
             pair.set(to, edge);
             this.nodes.add(to);
         }
+        /** Backward connect two Nodes */
         link_in(to, from, edge) {
             let pair = this.edges_in.get(to);
             if (!pair) {
@@ -5588,15 +5961,21 @@ var $;
             pair.set(from, edge);
             this.nodes.add(to);
         }
+        // GETTING EDGES
+        /** Return any Edge for two Nodes or null */
         edge(from, to) {
             return this.edge_out(from, to) ?? this.edge_in(to, from);
         }
+        /** Return output Edge for two Nodes or null */
         edge_out(from, to) {
             return this.edges_out.get(from)?.get(to) ?? null;
         }
+        /** Return input Edge for two Nodes or null */
         edge_in(to, from) {
             return this.edges_in.get(to)?.get(from) ?? null;
         }
+        // MUTATIONS
+        /** Cut cycles at lowest priority of Edges */
         acyclic(get_weight) {
             const checked = [];
             for (const start of this.nodes) {
@@ -5641,6 +6020,8 @@ var $;
                 visit(start);
             }
         }
+        // NODES SELECTION
+        /** Topoligical ordered set of all Nodes for acyclic graph */
         get sorted() {
             const sorted = new Set();
             const visit = (node) => {
@@ -5658,6 +6039,7 @@ var $;
             }
             return sorted;
         }
+        /** All Nodes which don't have input Edges */
         get roots() {
             const roots = [];
             for (const node of this.nodes) {
@@ -5667,6 +6049,13 @@ var $;
             }
             return roots;
         }
+        // DEPTH STATS
+        /**
+         * Nodes depth statistics for acyclic graph
+         * @example
+         * graph.depth_stat( Math.min )
+         * graph.depth_stat( Math.max )
+         **/
         nodes_depth(select) {
             const stat = new Map();
             const visit = (node, depth = 0) => {
@@ -5681,6 +6070,12 @@ var $;
                 visit(root);
             return stat;
         }
+        /**
+         * Depth's Nodes statistics for acyclic graph
+         * @example
+         * graph.depth_nodes( Math.min )
+         * graph.depth_nodes( Math.max )
+         **/
         depth_nodes(select) {
             const groups = [];
             for (const [node, depth] of this.nodes_depth(select).entries()) {
@@ -5889,6 +6284,7 @@ var $;
             return new $mol_graph();
         }
         path_added(path) { return this.added.has(path); }
+        // @ $mol_mem_key
         add_module(path) {
             this.added.add(path);
             const mod = this.$.$mol_file.absolute(path);
@@ -5911,6 +6307,7 @@ var $;
             }
             return root.resolve('node_modules').resolve('./' + target);
         }
+        // @ $mol_mem_key
         check_dep([path, target]) {
             const root = this.root();
             const deps = this.dependencies(path);
@@ -5932,6 +6329,7 @@ var $;
                 if (index.exists())
                     dep = index;
             }
+            //if( dep.type() === 'file' ) dep = dep.parent()
             if (mod === dep)
                 return null;
             const from = mod.relate(root);
@@ -6006,6 +6404,7 @@ var $;
                 version: this.version,
                 sources: this.sources,
                 names: this.names,
+                // sourceRoot: this.sourceRoot || undefined,
                 mappings: sourcemap_codec.encode(this.segment_lines),
                 file: this.file,
                 sourcesContent: this.sourceContent,
@@ -6075,7 +6474,7 @@ var $;
             for (let line of lines) {
                 const mergedLine = [];
                 for (let segment of line) {
-                    const mergedSegment = [segment[0]];
+                    const mergedSegment = [segment[0]]; // generatedColumn
                     if (segment.length >= 2) {
                         const sourceIndex = segment[1];
                         const source = bundleSourceRoot + sourceRoot + raw.sources[sourceIndex];
@@ -6090,9 +6489,9 @@ var $;
                         mergedSegment.push(mergedSourceIndex);
                     }
                     if (segment.length >= 3)
-                        mergedSegment.push(segment[2]);
+                        mergedSegment.push(segment[2]); // originalLine
                     if (segment.length >= 4)
-                        mergedSegment.push(segment[3]);
+                        mergedSegment.push(segment[3]); // originalColumn
                     if (segment.length >= 5) {
                         const nameIndex = segment[4];
                         const name = raw.names?.[nameIndex];
@@ -6290,10 +6689,14 @@ var $;
                     return true;
                 }
                 this.update_safe(path);
+                // mod.reset()
+                // for ( const sub of mod.sub() ) sub.reset()
                 return true;
             }
             if (this.repo(path)) {
                 this.$.$mol_file.unwatched(() => this.init(path), path);
+                // mod.reset()
+                // for ( const sub of mod.sub() ) sub.reset()
                 return true;
             }
             return false;
@@ -6370,10 +6773,21 @@ var $;
                 command: 'git rev-parse --abbrev-ref --symbolic-full-name HEAD', dir,
             });
             const current_branch = out.stdout.toString().trim();
+            // когда не на ветке - не надо пулить, например сборка во время git bisect
             if (!current_branch)
                 return false;
             const command = ['git', 'pull'];
             if (!this.interactive() && this.deepen_supported()) {
+                /**
+                depth и deepen не годятся для локальной разработки, поэтому оставляем ограничение глубины пула только для CI
+
+                --depth=1 в сочетании с сабмодулями обрезает историю, кроме первого коммита
+
+                --deepen=1 если не сделать unset GIT_DIR
+                в git-конфиге сабмодуля выставляет bare=true, после этого все команды падают с сообщением
+                warning: core.bare and core.worktree do not make sense
+                fatal: unable to set up work tree using invalid config
+                 */
                 command.push('--deepen=1');
             }
             const timeout = this.pull_timeout();
@@ -6446,6 +6860,8 @@ var $;
             return res.stdout.toString().match(/HEAD branch: (.*?)\n/)?.[1] ?? 'master';
         }
         init_existing(dir) {
+            // Например, если вручную склонить ревизию папки в глубине (например, hyoo/mol) перед запуском билда,
+            // то hyoo надо проинициалзировать в соответствии с meta.ree
             const repo = this.repo_ensured(dir);
             const { url, branch } = repo;
             this.$.$mol_run.spawn({ command: ['git', 'init'], dir });
@@ -6501,12 +6917,12 @@ var $;
             if ([node, node_modules].includes(parent)
                 && mod.name() !== 'node'
                 && !mod.name().startsWith('@')) {
-                this.$.$node_autoinstall(mod.name());
+                this.$.$node_autoinstall(mod.name()); // force autoinstall through npm
                 return true;
             }
             if ([node, node_modules].includes(parent.parent())
                 && parent.name().startsWith('@')) {
-                this.$.$node_autoinstall(`${parent.name()}/${mod.name()}`);
+                this.$.$node_autoinstall(`${parent.name()}/${mod.name()}`); // force autoinstall through npm
                 return true;
             }
             return false;
@@ -6700,6 +7116,7 @@ var $;
                     continue;
                 if (exclude && RegExp('[.=](' + exclude.join('|') + ')[.]', 'i').test(name))
                     continue;
+                // if (! child.exists()) return false
                 const child_path = child.path();
                 let files = [];
                 if (/(meta\.tree)$/.test(name)) {
@@ -6716,8 +7133,29 @@ var $;
                 }
                 mods.push(...files, child);
             }
+            //mods.sort( ( a , b )=> a.name().length - b.name().length )
             return mods;
         }
+        // @ $mol_mem_key
+        // modsRecursive( [ path , exclude ] : [ path : string , exclude? : readonly string[] ] ) : $mol_file[] {
+        // 	var mod = $mol_file.absolute( path )
+        // 	switch( mod.type() ) {
+        // 		case 'file' :
+        // 			return [ mod ]
+        // 		case 'dir' :
+        // 			var mods = [ mod ]
+        // 			for( var m of this.mods( [ path , exclude ] ) ) {
+        // 				if( m.type() !== 'dir' ) continue
+        // 				for( var dep of this.modsRecursive( { path : m.path() , exclude } ) ) {
+        // 					if( mods.indexOf( dep ) !== -1 ) continue
+        // 					mods.push( dep )
+        // 				}
+        // 			}
+        // 			return mods
+        // 		default :
+        // 			throw new Error( `Unsupported type "${mod.type()}" of "${mod.relate()}"` )
+        // 	}
+        // }
         sources([path, exclude]) {
             const mod = $mol_file.absolute(path);
             if (!mod.exists())
@@ -6826,6 +7264,7 @@ var $;
             }, {
                 ...$node.typescript.sys,
                 watchDirectory: (path, cb) => {
+                    // console.log('watchDirectory', path )
                     watchers.set(path, cb);
                     return { close() { } };
                 },
@@ -6836,6 +7275,7 @@ var $;
                     run = cb;
                 },
                 watchFile: (path, cb) => {
+                    // console.log('watchFile', path )
                     watchers.set(path, cb);
                     return { close() { } };
                 },
@@ -6855,7 +7295,9 @@ var $;
                         message: typeof text === 'string' ? text : text.messageText,
                     });
                 }
-            }, () => { }, [], {
+            }, () => { }, //watch reports
+            [], // project refs
+            {
                 synchronousWatchDirectory: true,
                 watchFile: 5,
                 watchDirectory: 0,
@@ -6866,6 +7308,7 @@ var $;
                 recheck: () => {
                     for (const path of paths) {
                         const version = $node.fs.statSync(path).mtime.valueOf();
+                        // this.js_error( path, null )
                         if (versions[path] && versions[path] !== version) {
                             const watcher = watchers.get(path);
                             if (watcher)
@@ -6898,6 +7341,7 @@ var $;
                 map.sources = [src.relate()];
                 return {
                     text: this.$.$mol_sourcemap_strip(res.outputText),
+                    // .replace( /^\/\/#\ssourceMappingURL=[^\n]*/mg , '//' + src.relate() )+'\n',
                     map: map,
                 };
             }
@@ -7216,12 +7660,12 @@ var $;
             const errors = [];
             const paths = this.tsPaths({ path, exclude: exclude_ext, bundle });
             for (const path of paths) {
-                this.js_content(path);
+                this.js_content(path); // recheck on file change
                 const error = this.js_error(path);
                 if (!error)
                     continue;
                 errors.push(new Error(error));
-                this.js_error(path, null);
+                this.js_error(path, null); // ts will refill it on change
             }
             this.logBundle(target, Date.now() - start);
             if (errors.length) {
@@ -7480,7 +7924,7 @@ var $;
                 if ($node_internal_check(dep))
                     continue;
                 if (dep === 'internal')
-                    continue;
+                    continue; // @TODO: Prevent `internal` deps from `node:internal`.
                 json.dependencies[dep] ??= `*`;
             }
             json.keywords = [...this.graph([path, exclude]).nodes]
@@ -7595,9 +8039,23 @@ var $;
                 return [];
             const start = this.now();
             var pack = $mol_file.absolute(path);
-            var sources = [];
+            var sources = []; // this.sourcesCSS( [ path , exclude ] )
             var target = pack.resolve(`-/${bundle}.css`);
             var targetMap = pack.resolve(`-/${bundle}.css.map`);
+            // var root : any = null //$node['postcss'].root({})
+            // sources.forEach(
+            // 	src => {
+            // 		var root2 = $node['postcss'].parse( src.content() , { from : src.path() } )
+            // 		root = root ? root.append( root2 ) : root2
+            // 	}
+            // )
+            // var processor = $node['postcss']([
+            // 	$node[ 'postcss-custom-properties' ]({
+            // 		preserve : true ,
+            // 	}) ,
+            // 	$node[ 'postcss-color-function' ]() ,
+            // ])
+            // var result = processor.process( root , { to : target.relate() , map : { inline : false } } )
             const result = {
                 css: '/* CSS compiles into js bundle now! */',
                 map: '/* CSS compiles into js bundle now! */',
@@ -7880,8 +8338,8 @@ var $;
     $mol_build.dependors['js'] = source => {
         var depends = {};
         var lines = String(source.text())
-            .replace(/\/\*[^]*?\*\//g, '')
-            .replace(/\/\/.*$/gm, '')
+            .replace(/\/\*[^]*?\*\//g, '') // drop block comments
+            .replace(/\/\/.*$/gm, '') // drop inline comments
             .split('\n');
         lines.forEach(function (line) {
             var indent = /^([\s\t]*)/.exec(line);
@@ -7901,8 +8359,8 @@ var $;
     $mol_build.dependors['ts'] = $mol_build.dependors['tsx'] = $mol_build.dependors['jam.js'] = $mol_build.dependors['tree.js'] = source => {
         var depends = {};
         var lines = String(source.text())
-            .replace(/\/\*(?!\*)[\s\S]*?\*\//g, '')
-            .replace(/\/\/.*$/gm, '')
+            .replace(/\/\*(?!\*)[\s\S]*?\*\//g, '') // drop block comments except doc-comments
+            .replace(/\/\/.*$/gm, '') // drop inline comments
             .split('\n');
         lines.forEach(function (line) {
             var indent = /^([\s\t]*)/.exec(line);
@@ -7948,8 +8406,8 @@ var $;
             '/mol/style/attach': 0,
         };
         var lines = String(source.text())
-            .replace(/\/\*[^]*?\*\//g, '')
-            .replace(/\/\/.*$/gm, '')
+            .replace(/\/\*[^]*?\*\//g, '') // drop block comments
+            .replace(/\/\/.*$/gm, '') // drop inline comments
             .split('\n');
         lines.forEach(function (line) {
             var indent = /^([\s\t]*)/.exec(line);
@@ -7966,8 +8424,8 @@ var $;
             '/mol/3d/glsl': 0,
         };
         var lines = String(source.text())
-            .replace(/\/\*[^]*?\*\//g, '')
-            .replace(/\/\/.*$/gm, '')
+            .replace(/\/\*[^]*?\*\//g, '') // drop block comments
+            .replace(/\/\/.*$/gm, '') // drop inline comments
             .split('\n');
         lines.forEach(function (line) {
             var indent = /^([\s\t]*)/.exec(line);
@@ -8015,6 +8473,8 @@ var $;
             const results = Object.create(null);
             for (const name of Object.keys(nets)) {
                 for (const net of nets[name]) {
+                    // Skip over non-IPv4 and internal (i.e. 127.0.0.1) addresses
+                    // 'IPv4' is in Node <= 17, from 18 it's a number 4 or 6
                     const familyV4Value = typeof net.family === 'string' ? 'IPv4' : 4;
                     if (net.family === familyV4Value && !net.internal) {
                         if (!results[name]) {
@@ -8042,6 +8502,16 @@ var $;
         socket() {
             const socket = new $node.ws.WebSocketServer({
                 server: this.http(),
+                // perMessageDeflate: {
+                // 	zlibDeflateOptions: {
+                // 		chunkSize: 1024,
+                // 		memLevel: 7,
+                // 		level: 3
+                // 	},
+                // 	zlibInflateOptions: {
+                // 		chunkSize: 10 * 1024
+                // 	},
+                // }
             });
             socket.on('connection', line => {
                 this.connections.add(line);
@@ -8125,6 +8595,7 @@ var $;
     class $mol_build_server extends $mol_server {
         static trace = false;
         sync_middleware(mdl) {
+            // const wrapped = $mol_wire_async(mdl)
             return $mol_func_name_from(async (req, res, next) => {
                 const wrapped = $mol_wire_async(mdl);
                 try {
@@ -8151,6 +8622,13 @@ var $;
         expressGenerator() { return this.sync_middleware(this.handleRequest.bind(this)); }
         handleRequest(req, res) {
             try {
+                // if( req.query._escaped_fragment_ ) {
+                // 	const fragment = decodeURIComponent( String( req.query._escaped_fragment_ ) )
+                // 	const url = req.protocol + '://' + req.get( 'host' ) + req.path + '#!' + fragment
+                // 	const html = $mol_browser.html( url )
+                // 	res.send( html ).end()
+                // 	return
+                // }
                 if (!this.generate(req.url))
                     return false;
                 res.set('Cache-Control', 'no-cache, public');
@@ -8178,6 +8656,15 @@ var $;
         }
         generate(url) {
             $mol_wire_solid();
+            /*
+            Если использовать динамически подгружаемые через $mol_script модули
+            То урл тут может быть вида /demo/app/-/node_modules/stockfish/-/stockfish.js
+            В path должна попасть часть до первого /-/
+            Динамически подгружаться могут обособленные, редко используемые скрипты.
+            Например шахматы, встроенные в основное приложение.
+            У которых здоровый двиг stockfish.js динамически загружается в воркер
+            только при открытии шахмат.
+            */
             const matched = url.match(/^(.*?)\/-\/((?:(?:\w+(?:.\w+)+)(?:\/-\/)?)+)$/);
             if (!matched)
                 return null;
@@ -8204,6 +8691,7 @@ var $;
             const root = this.$.$mol_file.absolute(this.rootPublic());
             const dir = root.resolve(req.path);
             const path = dir.path();
+            // Handle .well-known paths (browser/dev tools standard paths)
             if (req.path === '/.well-known/appspecific/com.chrome.devtools.json') {
                 const root = this.build().root().path();
                 const config = {
@@ -8223,7 +8711,10 @@ var $;
                 res.end(JSON.stringify(config, null, 2));
                 return true;
             }
+            // ensure загружает сорцы, делает git pull, это не стоит делать на build-папках
+            // Поэтому регулярка выше отсеивает build-папки
             this.ensure(path);
+            // a/b/?c#d, a/b/-/
             const match = req.url.match(/(\/|.*[^\-]\/)([\?#].*)?$/);
             if (!match)
                 return;
@@ -8322,11 +8813,16 @@ var $;
             for (const [line, path] of this.lines()) {
                 this.notify([line, path]);
             }
+            // this.bundles_keep()
             return socket;
         }
         bundles_count(reset) {
             return 1 + ($mol_wire_probe(() => this.bundles_count()) ?? 0);
         }
+        /**
+         * Держать в памяти собранные бандлы плохо, т.к. gc их может долго не утилизировать и node сожрет память и упадет.
+         * Логичнее удалять отложенно, после того как reload-сокет отписался от пути и повторно не подписался.
+         */
         bundles_keep() {
             const build = this.build();
             this.bundles_count();
@@ -8371,6 +8867,12 @@ var $;
             const build = this.build();
             try {
                 const sources = build.sourcesAll([path, ['node']]);
+                /**
+                Бывает надо какой-то внешней программой в watch-режиме компилить js-ки или wasm
+                и класть как артефакт в - (например, игровой движок на unity)
+                При изменении этих файлов, надо перезапускать страницу.
+                Если их класть не в -, а рядом с сорцами, то билдер mol будет пытаться их анализировать и упадет.
+                 */
                 const resources = build.bundleFiles([path, ['node']]);
                 for (const src of [...sources, ...resources])
                     src.version();
@@ -8388,6 +8890,7 @@ var $;
         }
         notify([line, path]) {
             this.bundle_changed_at(path);
+            // ignore initial
             if (!$mol_mem_cached(() => this.notify([line, path])))
                 return true;
             this.$.$mol_log3_rise({
@@ -8475,6 +8978,11 @@ var $;
             })
                 .on('SIGINT', () => process.exit(0))
                 .on('close', () => process.exit(0));
+            // this.$.$mol_log3_done({
+            // 	place: this,
+            // 	message: 'Watch dog started',
+            // 	hint,
+            // })
             return terminal;
         }
     }
@@ -8728,6 +9236,12 @@ var $;
         createDocumentFragment: () => $mol_dom_context.document.createDocumentFragment(),
     };
     $.$mol_jsx_frag = '';
+    /**
+     * JSX adapter that makes DOM tree.
+     * Generates global unique ids for every DOM-element by components tree with ids.
+     * Ensures all local ids are unique.
+     * Can reuse an existing nodes by GUIDs when used inside [`mol_jsx_attach`](https://github.com/hyoo-ru/mam_mol/tree/master/jsx/attach).
+     */
     function $mol_jsx(Elem, props, ...childNodes) {
         const id = props && props.id || '';
         const guid = id ? $.$mol_jsx_prefix ? $.$mol_jsx_prefix + '/' + id : id : $.$mol_jsx_prefix;
@@ -8838,6 +9352,8 @@ var $;
 
 ;
 "use strict";
+/** @jsx $mol_jsx */
+/** @jsxFrag $mol_jsx_frag */
 var $;
 (function ($) {
     $mol_test({
@@ -8943,6 +9459,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Lazy computed lists with native Array interface. $mol_range2_array is mutable but all derived ranges are immutable. */
     function $mol_range2(item = index => index, size = () => Number.POSITIVE_INFINITY) {
         const source = typeof item === 'function' ? new $mol_range2_array() : item;
         if (typeof item !== 'function') {
@@ -8991,6 +9508,7 @@ var $;
     }
     $.$mol_range2 = $mol_range2;
     class $mol_range2_array extends Array {
+        // Lazy
         concat(...tail) {
             if (tail.length === 0)
                 return this;
@@ -9002,6 +9520,7 @@ var $;
             }
             return $mol_range2(index => index < this.length ? this[index] : tail[0][index - this.length], () => this.length + tail[0].length);
         }
+        // Lazy
         filter(check, context) {
             const filtered = [];
             let cursor = -1;
@@ -9014,13 +9533,16 @@ var $;
                 return filtered[index];
             }, () => cursor < this.length ? Number.POSITIVE_INFINITY : filtered.length);
         }
+        // Diligent
         forEach(proceed, context) {
             for (let [key, value] of this.entries())
                 proceed.call(context, value, key, this);
         }
+        // Lazy
         map(proceed, context) {
             return $mol_range2(index => proceed.call(context, this[index], index, this), () => this.length);
         }
+        // Diligent
         reduce(merge, result) {
             let index = 0;
             if (arguments.length === 1) {
@@ -9031,12 +9553,15 @@ var $;
             }
             return result;
         }
+        // Lazy
         toReversed() {
             return $mol_range2(index => this[this.length - 1 - index], () => this.length);
         }
+        // Lazy
         slice(from = 0, to = this.length) {
             return $mol_range2(index => this[from + index], () => Math.min(to, this.length) - from);
         }
+        // Lazy
         some(check, context) {
             for (let index = 0; index < this.length; ++index) {
                 if (check.call(context, this[index], index, this))
@@ -9229,6 +9754,7 @@ var $;
 
 ;
 "use strict";
+/** @jsx $mol_jsx */
 var $;
 (function ($) {
     $mol_test({
@@ -9290,6 +9816,7 @@ var $;
             const obj3_copy = { test: 3, obj2: obj2_copy };
             obj1.obj3 = obj3;
             obj1_copy.obj3 = obj3_copy;
+            // warmup cache
             $mol_assert_not($mol_compare_deep(obj1, {}));
             $mol_assert_not($mol_compare_deep(obj2, {}));
             $mol_assert_not($mol_compare_deep(obj3, {}));
@@ -9359,18 +9886,34 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Argument must be Truthy
+     * @deprecated use $mol_assert_equal instead
+     */
     function $mol_assert_ok(value) {
         if (value)
             return;
         $mol_fail(new Error(`${value} ≠ true`));
     }
     $.$mol_assert_ok = $mol_assert_ok;
+    /**
+     * Argument must be Falsy
+     * @deprecated use $mol_assert_equal instead
+     */
     function $mol_assert_not(value) {
         if (!value)
             return;
         $mol_fail(new Error(`${value} ≠ false`));
     }
     $.$mol_assert_not = $mol_assert_not;
+    /**
+     * Handler must throw an error.
+     * @example
+     * $mol_assert_fail( ()=>{ throw new Error( 'Parse error' ) } ) // Passes because throws error
+     * $mol_assert_fail( ()=>{ throw new Error( 'Parse error' ) } , 'Parse error' ) // Passes because throws right message
+     * $mol_assert_fail( ()=>{ throw new Error( 'Parse error' ) } , Error ) // Passes because throws right class
+     * @see https://mol.hyoo.ru/#!section=docs/=9q9dv3_fgxjsf
+     */
     function $mol_assert_fail(handler, ErrorRight) {
         const fail = $.$mol_fail;
         try {
@@ -9393,10 +9936,18 @@ var $;
         $mol_fail(new Error('Not failed', { cause: { expect: ErrorRight } }));
     }
     $.$mol_assert_fail = $mol_assert_fail;
+    /** @deprecated Use $mol_assert_equal */
     function $mol_assert_like(...args) {
         $mol_assert_equal(...args);
     }
     $.$mol_assert_like = $mol_assert_like;
+    /**
+     * All arguments must not be structural equal to each other.
+     * @example
+     * $mol_assert_unique( 1 , 2 , 3 ) // Passes
+     * $mol_assert_unique( 1 , 1 , 2 ) // Fails because 1 === 1
+     * @see https://mol.hyoo.ru/#!section=docs/=9q9dv3_fgxjsf
+     */
     function $mol_assert_unique(...args) {
         for (let i = 0; i < args.length; ++i) {
             for (let j = 0; j < args.length; ++j) {
@@ -9409,6 +9960,13 @@ var $;
         }
     }
     $.$mol_assert_unique = $mol_assert_unique;
+    /**
+     * All arguments must be structural equal each other.
+     * @example
+     * $mol_assert_like( [1] , [1] , [1] ) // Passes
+     * $mol_assert_like( [1] , [1] , [2] ) // Fails because 1 !== 2
+     * @see https://mol.hyoo.ru/#!section=docs/=9q9dv3_fgxjsf
+     */
     function $mol_assert_equal(...args) {
         for (let i = 1; i < args.length; ++i) {
             if ($mol_compare_deep(args[0], args[i]))
@@ -9479,6 +10037,12 @@ var $;
         'return result without errors'() {
             $mol_assert_equal($mol_try(() => false), false);
         },
+        //'return error if thrown'() {
+        //	
+        //	const error = new Error( '$mol_try test error' )
+        //	$mol_assert_equal( $mol_try( ()=> { throw error } ) , error )
+        //	
+        //} ,
     });
 })($ || ($ = {}));
 
@@ -9911,6 +10475,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /// @todo right orderinng
     $.$mol_after_mock_queue = [];
     function $mol_after_mock_warp() {
         const queue = $.$mol_after_mock_queue.splice(0);
@@ -10274,6 +10839,7 @@ var $;
 var $;
 (function ($_1) {
     $mol_test({
+        // https://github.com/nin-jin/slides/tree/master/reactivity#component-states
         'Cached channel'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10331,6 +10897,7 @@ var $;
             $mol_assert_equal(App.value(5), 21);
             $mol_assert_equal(App.value(), 21);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-consistency
         'Auto recalculation of cached values'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10358,6 +10925,7 @@ var $;
             App.xxx(5);
             $mol_assert_equal(App.zzz(), 7);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-reasonability
         'Skip recalculation when actually no dependency changes'($) {
             const log = [];
             class App extends $mol_object2 {
@@ -10391,6 +10959,7 @@ var $;
             App.zzz();
             $mol_assert_like(log, ['zzz', 'yyy', 'xxx', 'xxx', 'yyy']);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#flow-auto
         'Flow: Auto'($) {
             class App extends $mol_object2 {
                 static get $() { return $; }
@@ -10428,6 +10997,7 @@ var $;
             $mol_assert_equal(App.result(), 23);
             $mol_assert_equal(App.counter, 4);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#dupes-equality
         'Dupes: Equality'($) {
             let counter = 0;
             class App extends $mol_object2 {
@@ -10451,6 +11021,7 @@ var $;
             App.foo({ numbs: [2] });
             $mol_assert_like(App.bar(), { numbs: [2], count: 2 });
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#cycle-fail
         'Cycle: Fail'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10475,6 +11046,29 @@ var $;
             ], App, "test", null);
             App.test();
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-stability
+        // 'Update deps on push'( $ ) {
+        // 	class App extends $mol_object2 {
+        // 		static $ = $
+        // 		@ $mol_wire_solo
+        // 		static left( next = false ) {
+        // 			return next
+        // 		}
+        // 		@ $mol_wire_solo
+        // 		static right( next = false ) {
+        // 			return next
+        // 		}
+        // 		@ $mol_wire_solo
+        // 		static res( next?: boolean ) {
+        // 			return this.left( next ) && this.right()
+        // 		}
+        // 	}
+        // 	$mol_assert_equal( App.res(), false )
+        // 	$mol_assert_equal( App.res( true ), false )
+        // 	$mol_assert_equal( App.right( true ), true )
+        // 	$mol_assert_equal( App.res(), true )
+        // } ,
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-stability
         'Different order of pull and push'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10486,7 +11080,7 @@ var $;
                 }
                 static slow(next) {
                     if (next !== undefined)
-                        this.slow();
+                        this.slow(); // enforce pull before push
                     return this.store(next);
                 }
             }
@@ -10505,6 +11099,7 @@ var $;
             App.store(777);
             $mol_assert_equal(App.fast(), App.slow(), 777);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-stability
         'Actions inside invariant'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10544,6 +11139,7 @@ var $;
                 static toggle() {
                     const prev = this.checked();
                     $mol_assert_unique(this.checked(!prev), prev);
+                    // $mol_assert_equal( this.checked() , prev )
                 }
                 static res() {
                     return this.checked();
@@ -10568,6 +11164,39 @@ var $;
             ], App, "test", null);
             await $mol_wire_async(App).test();
         },
+        // // https://github.com/nin-jin/slides/tree/master/reactivity#wish-stability
+        // 'Stable order of multiple root'( $ ) {
+        // 	class App extends $mol_object2 {
+        // 		static $ = $
+        // 		static counter = 0
+        // 		@ $mol_wire_solo
+        // 		static left_trigger( next = 0 ) {
+        // 			return next
+        // 		}
+        // 		@ $mol_wire_solo
+        // 		static left_root() {
+        // 			this.left_trigger()
+        // 			return ++ this.counter
+        // 		}
+        // 		@ $mol_wire_solo
+        // 		static right_trigger( next = 0 ) {
+        // 			return next
+        // 		}
+        // 		@ $mol_wire_solo
+        // 		static right_root() {
+        // 			this.right_trigger()
+        // 			return ++ this.counter
+        // 		}
+        // 	}
+        // 	$mol_assert_equal( App.left_root(), 1 )
+        // 	$mol_assert_equal( App.right_root(), 2 )
+        // 	App.right_trigger( 1 )
+        // 	App.left_trigger( 1 )
+        // 	$mol_wire_fiber.sync()
+        // 	$mol_assert_equal( App.right_root(), 4 )
+        // 	$mol_assert_equal( App.left_root(), 3 )
+        // } ,
+        // https://github.com/nin-jin/slides/tree/master/reactivity#error-store
         'Restore after error'($) {
             class App extends $mol_object2 {
                 static get $() { return $; }
@@ -10665,6 +11294,7 @@ var $;
             App.showing(true);
             $mol_assert_unique(App.render(), details);
         },
+        // https://github.com/nin-jin/slides/tree/master/reactivity#wish-stability
         async 'Hold pubs while wait async task'($) {
             class App extends $mol_object2 {
                 static $ = $;
@@ -10967,6 +11597,7 @@ var $;
 
 ;
 "use strict";
+/** @jsx $mol_jsx */
 var $;
 (function ($) {
     $mol_test({
@@ -11048,6 +11679,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Watch and logs reactive states. Logger automatically added to test bundle which is adding to `test.html`. */
     class $mol_wire_log extends $mol_object2 {
         static watch(task) {
             return task;
@@ -11353,6 +11985,11 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Combines list of unary functions/classes to one function.
+     *
+     * 	const reparse = $mol_data_pipe( JSON.stringify , JSON.parse )
+     **/
     function $mol_data_pipe(...funcs) {
         return $mol_data_setup(function (input) {
             let value = input;
@@ -11369,6 +12006,14 @@ var $;
 var $;
 (function ($) {
     $mol_test({
+        // @todo enable on strict
+        // 'no functions'() {
+        // 	const stringify = $mol_data_pipe()
+        // 	type Type = $mol_type_assert<
+        // 		typeof stringify,
+        // 		( input : never )=> never
+        // 	>
+        // },
         'single function'() {
             const stringify = $mol_data_pipe((input) => input.toString());
             $mol_assert_equal(stringify(5), '5');
@@ -11675,6 +12320,9 @@ var $;
 ;
 "use strict";
 
+;
+"use strict";
+
 ;
 "use strict";
 var $;
@@ -12066,6 +12714,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * CSS Units
+     * @see https://mol.hyoo.ru/#!section=docs/=xwq9q5_f966fg
+     */
     class $mol_style_unit extends $mol_decor {
         literal;
         constructor(value, literal) {
@@ -12112,6 +12764,10 @@ var $;
 var $;
 (function ($) {
     const { per } = $mol_style_unit;
+    /**
+     * CSS Functions
+     * @see https://mol.hyoo.ru/#!section=docs/=xwq9q5_f966fg
+     */
     class $mol_style_func extends $mol_decor {
         name;
         constructor(name, value) {
@@ -12203,6 +12859,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Create record of CSS variables. */
     function $mol_style_prop(prefix, keys) {
         const record = keys.reduce((rec, key) => {
             rec[key] = $mol_style_func.vary(`--${prefix}_${key}`);
@@ -12217,6 +12874,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Theme css variables
+     * @see https://mol.hyoo.ru/#!section=demos/demo=mol_textarea_demo
+     */
     $.$mol_theme = $mol_style_prop('mol_theme', [
         'back',
         'hover',
@@ -12245,11 +12906,18 @@ var $;
 
 ;
 "use strict";
+// namespace $ {
+// 	$mol_style_attach( '$mol_theme_lights', `:root { --mol_theme_back: oklch( ${ $$.$mol_lights() ? 92 : 20 }% .01 var(--mol_theme_hue) ) }` )
+// }
 
 ;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Gap in CSS
+     * @see https://page.hyoo.ru/#!=msdb74_bm7nsq
+     */
     $.$mol_gap = $mol_style_prop('mol_gap', [
         'page',
         'block',
@@ -12536,6 +13204,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Real-time refresh current atom.
+     * Don't use if possible. May reduce performance.
+     */
     function $mol_wire_watch() {
         const atom = $mol_wire_auto();
         if (atom instanceof $mol_wire_atom) {
@@ -12642,6 +13314,9 @@ var $;
 ;
 "use strict";
 
+;
+"use strict";
+
 ;
 "use strict";
 var $;
@@ -12651,6 +13326,7 @@ var $;
 
 ;
 "use strict";
+/** @jsx $mol_jsx */
 var $;
 (function ($) {
     function $mol_view_visible_width() {
@@ -12665,6 +13341,11 @@ var $;
         return suffix;
     }
     $.$mol_view_state_key = $mol_view_state_key;
+    /**
+     * The base class for all visual components. It provides the infrastructure for reactive lazy rendering, handling exceptions.
+     * @see https://mol.hyoo.ru/#!section=docs/=vv2nig_s5zr0f
+     */
+    /// Reactive statefull lazy ViewModel
     class $mol_view extends $mol_object {
         static Root(id) {
             return new this;
@@ -12729,16 +13410,22 @@ var $;
         state_key(suffix = '') {
             return this.$.$mol_view_state_key(suffix);
         }
+        /// Name of element that created when element not found in DOM
         dom_name() {
             return $mol_dom_qname(this.constructor.toString()) || 'div';
         }
+        /// NameSpace of element that created when element not found in DOM
         dom_name_space() { return 'http://www.w3.org/1999/xhtml'; }
+        /// Raw child views
         sub() {
             return [];
         }
+        /// Visible sub views with defined ambient context
+        /// Render all by default
         sub_visible() {
             return this.sub();
         }
+        /// Minimal width that used for lazy rendering
         minimal_width() {
             let min = 0;
             try {
@@ -12760,6 +13447,7 @@ var $;
         maximal_width() {
             return this.minimal_width();
         }
+        /// Minimal height that used for lazy rendering
         minimal_height() {
             let min = 0;
             try {
@@ -12779,11 +13467,11 @@ var $;
         view_rect() {
             if ($mol_wire_probe(() => this.view_rect()) === undefined) {
                 $mol_wire_watch();
-                return null;
+                return null; // don't touch DOM to prevent instant reflow
             }
             else {
                 const { width, height, left, right, top, bottom } = this.dom_node().getBoundingClientRect();
-                return { width, height, left, right, top, bottom };
+                return { width, height, left, right, top, bottom }; // pick to optimize compare
             }
         }
         dom_id() {
@@ -12973,6 +13661,7 @@ var $;
         [$mol_dev_format_head]() {
             return $mol_dev_format_span({}, $mol_dev_format_native(this));
         }
+        /** Deep search view by predicate. */
         *view_find(check, path = []) {
             if (path.length === 0 && check(this))
                 return yield [this];
@@ -13001,6 +13690,7 @@ var $;
                 $mol_fail_log(error);
             }
         }
+        /** Renders path of views to DOM. */
         force_render(path) {
             const kids = this.sub();
             const index = kids.findIndex(item => {
@@ -13015,6 +13705,7 @@ var $;
                 kids[index].force_render(path);
             }
         }
+        /** Renders view to DOM and scroll to it. */
         ensure_visible(view, align = "start") {
             const path = this.view_find(v => v === view).next().value;
             this.force_render(new Set(path));
@@ -13029,6 +13720,9 @@ var $;
             const win = this.$.$mol_dom_context;
             if (win.parent !== win.self && !win.document.hasFocus())
                 return;
+            // new this.$.$mol_after_frame( ()=> {
+            // 	this.dom_node().scrollIntoView({ block: 'start', inline: 'nearest' })
+            // } )
             new this.$.$mol_after_timeout(0, () => {
                 this.focused(true);
             });
@@ -13217,6 +13911,7 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /** Plugin is component without its own DOM element, but instead uses the owner DOM element */
     class $mol_plugin extends $mol_view {
         dom_node_external(next) {
             return next ?? $mol_owning_get(this).host.dom_node();
@@ -13257,6 +13952,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+    * Key names code for hotkey
+    * @see [mol_hotkey](../../hotkey/hotkey.view.ts)
+    */
     let $mol_keyboard_code;
     (function ($mol_keyboard_code) {
         $mol_keyboard_code[$mol_keyboard_code["backspace"] = 8] = "backspace";
@@ -13365,12 +14064,17 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
 (function ($) {
     var $$;
     (function ($$) {
+        /**
+         * Plugin which adds handlers for keyboard keys.
+         * @see [mol_keyboard_code](../keyboard/code/code.ts)
+         */
         class $mol_hotkey extends $.$mol_hotkey {
             key() {
                 return super.key();
@@ -13546,6 +14250,10 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * Z-index values for layers
+     * https://page.hyoo.ru/#!=xthcpx_wqmiba
+     */
     $.$mol_layer = $mol_style_prop('mol_layer', [
         'hover',
         'focus',
@@ -13568,12 +14276,17 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
 (function ($) {
     var $$;
     (function ($$) {
+        /**
+         * An input field for entering single line text.
+         * @see https://mol.hyoo.ru/#!section=demos/demo=mol_string_demo
+         */
         class $mol_string extends $.$mol_string {
             event_change(next) {
                 if (!next)
@@ -13697,6 +14410,7 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
@@ -13834,12 +14548,17 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
 (function ($) {
     var $$;
     (function ($$) {
+        /**
+         * Output text with dimmed mismatched substrings.
+         * @see https://mol.hyoo.ru/#!section=demos/demo=mol_dimmer_demo
+         */
         class $mol_dimmer extends $.$mol_dimmer {
             parts() {
                 const needle = this.needle();
@@ -13909,6 +14628,7 @@ var $;
 ;
 "use strict";
 
+
 ;
 	($.$mol_button) = class $mol_button extends ($.$mol_view) {
 		event_activate(next){
@@ -14043,12 +14763,17 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
 (function ($) {
     var $$;
     (function ($$) {
+        /**
+         * Simple button.
+         * @see https://mol.hyoo.ru/#!section=demos/demo=mol_button_demo
+         */
         class $mol_button extends $.$mol_button {
             disabled() {
                 return !this.enabled();
@@ -14064,6 +14789,7 @@ var $;
                     this.status([null]);
                 }
                 catch (error) {
+                    // Calling actions from catch section, if throwing promise breaks idempotency
                     Promise.resolve().then(() => this.status([error]));
                     $mol_fail_hidden(error);
                 }
@@ -14133,6 +14859,7 @@ var $;
 ;
 "use strict";
 
+
 ;
 	($.$mol_button_minor) = class $mol_button_minor extends ($.$mol_button_typed) {};
 
@@ -14147,6 +14874,7 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
@@ -14176,12 +14904,12 @@ var $;
 			`;
                 const dest = `
 				query? \\
-				clear?event null
+				clear? null
 				Query $mol_string value? <=> query?
 				Suggest_label $mol_dimmer
 					needle <= query?
 					key * escape? <=> clear?
-				Clear $mol_button_minor click?event <=> clear?event
+				Clear $mol_button_minor click? <=> clear?
 			`;
                 const res = normalize($, src, dest);
                 $mol_assert_equal(res.input, res.output);
@@ -14203,10 +14931,10 @@ var $;
                 const dest = `
 				Close_icon ${d}mol_icon_cross
 				Title ${d}mol_view sub / <= title
-				close?event null
+				close? null
 				Close ${d}mol_button
 					title \\close
-					click?event <=> close?event
+					click? <=> close?
 				title @ \\title
 				sub2 / <= Close_icon
 				sub /
@@ -14252,7 +14980,7 @@ var $;
                 const dest = `
 				clear? = Suggest_label clear?
 				Suggest_label $mol_dimmer clear? => clear?
-				Clear $mol_button_minor click?e <=> clear?e
+				Clear $mol_button_minor click? <=> clear?
 			`;
                 const res = normalize($, src, dest);
                 $mol_assert_equal(res.input, res.output);
@@ -14268,7 +14996,7 @@ var $;
                 $mol_assert_fail(() => normalize($, src).input, `Need an equal default values at \`/mol/view/tree2/class/props.test.ts#4:16/5\` vs \`/mol/view/tree2/class/props.test.ts#6:23/11\`
 <=>
 /mol/view/tree2/class/props.test.ts#6:19/3
-click?event
+click?
 /mol/view/tree2/class/props.test.ts#6:7/11
 $mol_button_minor
 /mol/view/tree2/class/props.test.ts#5:12/17
@@ -15371,6 +16099,11 @@ var $;
 "use strict";
 var $;
 (function ($) {
+    /**
+     * CSS in TS.
+     * Statically typed CSS style sheets. Following samples show which CSS code are generated from TS code.
+     * @see https://mol.hyoo.ru/#!section=docs/=xwq9q5_f966fg
+     */
     function $mol_style_define(Component, config) {
         return $mol_style_attach(Component.name, $mol_style_sheet(Component, config));
     }
@@ -15380,12 +16113,17 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
 (function ($) {
     var $$;
     (function ($$) {
+        /**
+         * Scrolling pane.
+         * @see https://mol.hyoo.ru/#!section=demos/demo=mol_scroll_demo
+         */
         class $mol_scroll extends $.$mol_scroll {
             scroll_top(next, cache) {
                 const el = this.dom_node();
@@ -15435,6 +16173,7 @@ var $;
                 direction: 'column',
                 grow: 1,
                 shrink: 1,
+                // basis: 0,
             },
             outline: 'none',
             align: {
@@ -15452,6 +16191,7 @@ var $;
             contain: 'content',
             '>': {
                 $mol_view: {
+                    // transform: 'translateZ(0)', // enforce gpu scroll in all agents
                     gridArea: '1/1',
                 },
             },
@@ -15564,6 +16304,7 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
@@ -15584,6 +16325,8 @@ var $;
             maxHeight: per(100),
             boxSizing: 'border-box',
             color: $mol_theme.text,
+            // backdropFilter: blur( `3px` ), enforces layering
+            // zIndex: 0 ,
             ':focus': {
                 outline: 'none',
             },
@@ -16101,99 +16844,131 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
@@ -16229,45 +17004,59 @@ var $;
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 
+
 ;
 "use strict";
 var $;
@@ -16355,13 +17144,13 @@ var $;
                 $mol_view_tree2_to_js_test_run(`
 					Foo $mol_view
 						a!? $mol_view
-							expanded <=> cell_test_expanded!? null
+							expanded? <=> cell_test_expanded!? null
 				`);
-            }, `Required prop like some*? at \`.view.tree#4:21/20\`
+            }, `Required prop like some*? at \`.view.tree#4:22/20\`
 <=>
-.view.tree#4:17/3
-expanded
-.view.tree#4:8/8
+.view.tree#4:18/3
+expanded?
+.view.tree#4:8/9
 $mol_view
 .view.tree#3:11/9
 a!?
@@ -16395,7 +17184,9 @@ var $;
         'Left bind read only'($) {
             const _foo = $mol_view_tree2_to_js_test_ex_left_read_only_foo;
             const foo = _foo.make({ $ });
-            $mol_assert_like(foo.bar1(), foo.bar1(2), foo.bar1(), foo.bar2(), 1);
+            $mol_assert_like(foo.bar1(), 
+            // @ts-ignore
+            foo.bar1(2), foo.bar1(), foo.bar2(), 1);
             $mol_assert_like(foo.bar2(2), foo.bar1(), 2);
         },
         'Left bind second level index'($) {
@@ -16422,7 +17213,11 @@ var $;
             const foo = _foo.make({ $ });
             $mol_assert_equal(foo.d(), foo.c(), foo.b(), foo.a(), 0);
             $mol_assert_equal(foo.d(1), foo.c(), foo.b(), foo.a(), 1);
-            $mol_assert_equal(foo.a(2), foo.b(2), foo.c(), foo.d(), 1);
+            $mol_assert_equal(
+            // @ts-ignore
+            foo.a(2), 
+            // @ts-ignore
+            foo.b(2), foo.c(), foo.d(), 1);
             $mol_assert_equal(foo.c(2), foo.b(), foo.a(), 2);
             $mol_assert_equal(foo.d(1), 1);
             $mol_assert_equal(foo.d(3), foo.c(), foo.b(), foo.a(), 3);
@@ -16458,6 +17253,10 @@ var $;
         'Array of array or object'($) {
             const _foo = $mol_view_tree2_to_js_test_ex_array_of_array_or_object_foo;
             const foo = _foo.make({ $ });
+            // type a1 = $mol_type_assert<
+            // 	ReturnType<typeof foo.complex>,
+            // 	readonly (readonly(number | string)[] | Record<string, number | string>)[]
+            // >
             $mol_assert_like(foo.complex(), ['1', [true], ['1', 21], { a: 1, str: 'some' }]);
         },
         'Array inheritance'($) {
@@ -16549,7 +17348,9 @@ var $;
         'simple mutable and read only channels'($) {
             const _foo = $mol_view_tree2_to_js_test_ex_simple_mutable_and_read_only_foo;
             const foo = _foo.make({ $ });
-            $mol_assert_equal(foo.readonly(), foo.readonly(1), foo.readonly(), null);
+            $mol_assert_equal(foo.readonly(), 
+            // @ts-ignore
+            foo.readonly(1), foo.readonly(), null);
             $mol_assert_equal(foo.mutable(), null);
             $mol_assert_equal(foo.mutable(2), foo.mutable(), 2);
         },