mol_jsx_lib 0.0.1602 → 0.0.1604

package/node.d.ts

@@ -73,11 +73,17 @@ declare namespace $ {
 
 declare namespace $ {
     const $mol_ambient_ref: unique symbol;
+    /** @deprecated use $ instead */
     type $mol_ambient_context = $;
     function $mol_ambient(this: $ | void, overrides: Partial<$>): $;
 }
 
 declare namespace $ {
+    /**
+     * Proxy that delegates all to lazy returned target.
+     *
+     * 	$mol_delegate( Array.prototype , ()=> fetch_array() )
+     */
     function $mol_delegate<Value extends object>(proto: Value, target: () => Value): Value;
 }
 
@@ -141,57 +147,130 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Generates unique identifier. */
     function $mol_guid(length?: number, exists?: (id: string) => boolean): string;
 }
 
 declare namespace $ {
+    /** Special status statuses. */
     enum $mol_wire_cursor {
+        /** Update required. */
         stale = -1,
+        /** Some of (transitive) pub update required. */
         doubt = -2,
+        /** Actual state but may be dropped. */
         fresh = -3,
+        /** State will never be changed. */
         final = -4
     }
 }
 
 declare namespace $ {
+    /**
+     * Collects subscribers in compact array. 28B
+     */
     class $mol_wire_pub extends Object {
         constructor(id?: string);
         [Symbol.toStringTag]: string;
         data: unknown[];
         static get [Symbol.species](): ArrayConstructor;
+        /**
+         * Index of first subscriber.
+         */
         protected sub_from: number;
+        /**
+         * All current subscribers.
+         */
         get sub_list(): readonly $mol_wire_sub[];
+        /**
+         * Has any subscribers or not.
+         */
         get sub_empty(): boolean;
+        /**
+         * Subscribe subscriber to this publisher events and return position of subscriber that required to unsubscribe.
+         */
         sub_on(sub: $mol_wire_pub, pub_pos: number): number;
+        /**
+         * Unsubscribe subscriber from this publisher events by subscriber position provided by `on(pub)`.
+         */
         sub_off(sub_pos: number): void;
+        /**
+         * Called when last sub was unsubscribed.
+         **/
         reap(): void;
+        /**
+         * Autowire this publisher with current subscriber.
+         **/
         promote(): void;
+        /**
+         * Enforce actualization. Should not throw errors.
+         */
         fresh(): void;
+        /**
+         * Allow to put data to caches in the subtree.
+         */
         complete(): void;
         get incompleted(): boolean;
+        /**
+         * Notify subscribers about self changes.
+         */
         emit(quant?: $mol_wire_cursor): void;
+        /**
+         * Moves peer from one position to another. Doesn't clear data at old position!
+         */
         peer_move(from_pos: number, to_pos: number): void;
+        /**
+         * Updates self position in the peer.
+         */
         peer_repos(peer_pos: number, self_pos: number): void;
     }
 }
 
 declare namespace $ {
+    /** Generic subscriber interface */
     interface $mol_wire_sub extends $mol_wire_pub {
         temp: boolean;
         pub_list: $mol_wire_pub[];
+        /**
+         * Begin auto wire to publishers.
+         * Returns previous auto subscriber that must me transfer to the `end`.
+         */
         track_on(): $mol_wire_sub | null;
+        /**
+         * Returns next auto wired publisher. It can be easely repormoted.
+         * Or promotes next publisher to auto wire its togeter.
+         * Must be used only between `track_on` and `track_off`.
+         */
         track_next(pub?: $mol_wire_pub): $mol_wire_pub | null;
         pub_off(pub_pos: number): void;
+        /**
+         * Unsubscribes from unpromoted publishers.
+         */
         track_cut(sub: $mol_wire_pub | null): void;
+        /**
+         * Ends auto wire to publishers.
+         */
         track_off(sub: $mol_wire_pub | null): void;
+        /**
+         * Receive notification about publisher changes.
+         */
         absorb(quant: $mol_wire_cursor, pos: number): void;
+        /**
+         * Unsubscribes from all publishers.
+         */
         destructor(): void;
     }
 }
 
 declare namespace $ {
     let $mol_wire_auto_sub: $mol_wire_sub | null;
+    /**
+     * When fulfilled, all publishers are promoted to this subscriber on access to its.
+     */
     function $mol_wire_auto(next?: $mol_wire_sub | null): $mol_wire_sub | null;
+    /**
+     * Affection queue. Used to prevent accidental stack overflow on emit.
+     */
     const $mol_wire_affected: ($mol_wire_sub | number)[];
 }
 
@@ -224,6 +303,13 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * 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 implements $mol_wire_sub {
         protected pub_from: number;
         protected cursor: $mol_wire_cursor;
@@ -240,6 +326,9 @@ declare namespace $ {
         complete_pubs(): void;
         absorb(quant?: $mol_wire_cursor, pos?: number): void;
         [$mol_dev_format_head](): any[];
+        /**
+         * Is subscribed to any publisher or not.
+         */
         get pub_empty(): boolean;
     }
 }
@@ -255,6 +344,13 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * 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
+     **/
     abstract class $mol_wire_fiber<Host, Args extends readonly unknown[], Result> extends $mol_wire_pub_sub {
         readonly task: (this: Host, ...args: Args) => Result;
         readonly host?: Host | undefined;
@@ -281,7 +377,15 @@ declare namespace $ {
         fresh(): this | undefined;
         refresh(): void;
         abstract put(next: Result | Error | Promise<Result | Error>): Result | Error | Promise<Result | Error>;
+        /**
+         * Synchronous execution. Throws Promise when waits async task (SuspenseAPI provider).
+         * Should be called inside SuspenseAPI consumer (ie fiber).
+         */
         sync(): Awaited<Result>;
+        /**
+         * Asynchronous execution.
+         * It's SuspenseAPI consumer. So SuspenseAPI providers can be called inside.
+         */
         async_raw(): Promise<Result>;
         async(): Promise<Result> & {
             destructor(): void;
@@ -293,31 +397,48 @@ declare namespace $ {
 
 declare namespace $ {
     let $mol_compare_deep_cache: WeakMap<any, WeakMap<any, boolean>>;
+    /**
+     * Deeply compares two values. Returns true if equal.
+     * Define `Symbol.toPrimitive` to customize.
+     */
     function $mol_compare_deep<Value>(left: Value, right: Value): boolean;
 }
 
 declare namespace $ {
+    /** Logger event data */
     type $mol_log3_event<Fields> = {
         [key in string]: unknown;
     } & {
+        /** Time of event creation */
         time?: string;
+        /** Place of event creation */
         place: unknown;
+        /** Short description of event */
         message: string;
     } & Fields;
+    /** Logger function */
     type $mol_log3_logger<Fields, Res = void> = (this: $, event: $mol_log3_event<Fields>) => Res;
+    /** Log begin of some task */
     let $mol_log3_come: $mol_log3_logger<{}>;
+    /** Log end of some task */
     let $mol_log3_done: $mol_log3_logger<{}>;
+    /** Log error */
     let $mol_log3_fail: $mol_log3_logger<{}>;
+    /** Log warning message */
     let $mol_log3_warn: $mol_log3_logger<{
         hint: string;
     }>;
+    /** Log some generic event */
     let $mol_log3_rise: $mol_log3_logger<{}>;
+    /** Log begin of log group, returns func to close group */
     let $mol_log3_area: $mol_log3_logger<{}, () => void>;
+    /** Log begin of collapsed group only when some logged inside, returns func to close group */
     function $mol_log3_area_lazy(this: $, event: $mol_log3_event<{}>): () => void;
     let $mol_log3_stack: (() => void)[];
 }
 
 declare namespace $ {
+    /** Position in any resource. */
     class $mol_span extends $mol_object2 {
         readonly uri: string;
         readonly source: string;
@@ -325,9 +446,13 @@ declare namespace $ {
         readonly col: number;
         readonly length: number;
         constructor(uri: string, source: string, row: number, col: number, length: number);
+        /** Span for begin of unknown resource */
         static unknown: $mol_span;
+        /** Makes new span for begin of resource. */
         static begin(uri: string, source?: string): $mol_span;
+        /** Makes new span for end of resource. */
         static end(uri: string, source: string): $mol_span;
+        /** Makes new span for entire resource. */
         static entire(uri: string, source: string): $mol_span;
         toString(): string;
         toJSON(): {
@@ -336,14 +461,19 @@ declare namespace $ {
             col: number;
             length: number;
         };
+        /** Makes new error for this span. */
         error(message: string, Class?: ErrorConstructor): Error;
+        /** Makes new span for same uri. */
         span(row: number, col: number, length: number): $mol_span;
+        /** Makes new span after end of this. */
         after(length?: number): $mol_span;
+        /** Makes new span between begin and end. */
         slice(begin: number, end?: number): $mol_span;
     }
 }
 
 declare namespace $ {
+    /** Serializes tree to string in tree format. */
     function $mol_tree2_to_string(this: $, tree: $mol_tree2): string;
 }
 
@@ -352,37 +482,74 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Path by types in tree. */
     type $mol_tree2_path = Array<string | number | null>;
+    /** Hask tool for processing node. */
     type $mol_tree2_hack<Context> = (input: $mol_tree2, belt: $mol_tree2_belt<Context>, context: Context) => readonly $mol_tree2[];
+    /** Collection of hask tools for processing tree. */
     type $mol_tree2_belt<Context> = Record<string, $mol_tree2_hack<Context>>;
+    /**
+     * 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 of structural node, `value` should be empty */
         readonly type: string;
+        /** Content of data node, `type` should be empty */
         readonly value: string;
+        /** Child nodes */
         readonly kids: readonly $mol_tree2[];
+        /** Position in most far source resource */
         readonly span: $mol_span;
-        constructor(type: string, value: string, kids: readonly $mol_tree2[], span: $mol_span);
+        constructor(
+        /** Type of structural node, `value` should be empty */
+        type: string, 
+        /** Content of data node, `type` should be empty */
+        value: string, 
+        /** Child nodes */
+        kids: readonly $mol_tree2[], 
+        /** Position in most far source resource */
+        span: $mol_span);
+        /** Makes collection node. */
         static list(kids: readonly $mol_tree2[], span?: $mol_span): $mol_tree2;
+        /** Makes new derived collection node. */
         list(kids: readonly $mol_tree2[]): $mol_tree2;
+        /** Makes data node for any string. */
         static data(value: string, kids?: readonly $mol_tree2[], span?: $mol_span): $mol_tree2;
+        /** Makes new derived data node. */
         data(value: string, kids?: readonly $mol_tree2[]): $mol_tree2;
+        /** Makes struct node. */
         static struct(type: string, kids?: readonly $mol_tree2[], span?: $mol_span): $mol_tree2;
+        /** Makes new derived structural node. */
         struct(type: string, kids?: readonly $mol_tree2[]): $mol_tree2;
+        /** Makes new derived node with different kids id defined. */
         clone(kids: readonly $mol_tree2[], span?: $mol_span): $mol_tree2;
+        /** Returns multiline text content. */
         text(): string;
+        /** Parses tree format. */
+        /** @deprecated Use $mol_tree2_from_string */
         static fromString(str: string, uri?: string): $mol_tree2;
+        /** Serializes to tree format. */
         toString(): string;
+        /** Makes new tree with node overrided by path. */
         insert(value: $mol_tree2 | null, ...path: $mol_tree2_path): $mol_tree2;
+        /** Makes new tree with node overrided by path. */
         update(value: readonly $mol_tree2[], ...path: $mol_tree2_path): readonly $mol_tree2[];
+        /** Query nodes by path. */
         select(...path: $mol_tree2_path): $mol_tree2;
+        /** Filter kids by path or value. */
         filter(path: string[], value?: string): $mol_tree2;
         hack_self<Context extends {
             span?: $mol_span;
             [key: string]: unknown;
         } = {}>(belt: $mol_tree2_belt<Context>, context?: Context): readonly $mol_tree2[];
+        /** Transform tree through context with transformers */
         hack<Context extends {
             span?: $mol_span;
             [key: string]: unknown;
         } = {}>(belt: $mol_tree2_belt<Context>, context?: Context): $mol_tree2[];
+        /** Makes Error with node coordinates. */
         error(message: string, Class?: ErrorConstructor): Error;
     }
     class $mol_tree2_empty extends $mol_tree2 {
@@ -391,6 +558,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Syntax error with cordinates and source line snippet. */
     class $mol_error_syntax extends SyntaxError {
         reason: string;
         line: string;
@@ -400,6 +568,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Parses tree format from string. */
     function $mol_tree2_from_string(this: $, str: string, uri?: string): $mol_tree2;
 }
 
@@ -412,6 +581,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Module for working with terminal. Text coloring when output in terminal */
     class $mol_term_color {
         static reset: (str: string) => string;
         static bold: (str: string) => string;
@@ -443,6 +613,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** One-shot fiber */
     class $mol_wire_task<Host, Args extends readonly unknown[], Result> extends $mol_wire_fiber<Host, Args, Result> {
         static getter<Host, Args extends readonly unknown[], Result>(task: (this: Host, ...args: Args) => Result): (host: Host, args: Args) => $mol_wire_task<Host, Args, Result>;
         get temp(): boolean;
@@ -453,6 +624,10 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * 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
+     */
     export function $mol_wire_sync<Host extends object>(obj: Host): ObjectOrFunctionResultAwaited<Host>;
     type FunctionResultAwaited<Some> = Some extends (...args: infer Args) => infer Res ? (...args: Args) => Awaited<Res> : Some;
     type ConstructorResultAwaited<Some> = Some extends new (...args: infer Args) => infer Res ? new (...args: Args) => Res : {};
@@ -510,6 +685,11 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * Recursive `Partial`.
+     *
+     * 	let props : $mol_type_partial_deep< HTMLElement > = { style : { display : 'block' } }
+     */
     type $mol_type_partial_deep<Val> = Val extends object ? Val extends Function ? Val : {
         [field in keyof Val]?: $mol_type_partial_deep<Val[field]> | undefined;
     } : Val;
@@ -521,6 +701,12 @@ declare namespace $ {
     let $mol_jsx_booked: null | Set<string>;
     let $mol_jsx_document: $mol_jsx.JSX.ElementClass['ownerDocument'];
     const $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<Props extends $mol_jsx.JSX.IntrinsicAttributes, Children extends Array<Node | string>>(Elem: string | ((props: Props, ...children: Children) => Element), props: Props, ...childNodes: Children): Element | DocumentFragment;
     namespace $mol_jsx.JSX {
         interface Element extends HTMLElement {
@@ -535,9 +721,11 @@ declare namespace $ {
         type OrString<Dict> = {
             [key in keyof Dict]: Dict[key] | string;
         };
+        /** Props for html elements */
         type IntrinsicElements = {
             [key in keyof ElementTagNameMap]?: $.$mol_type_partial_deep<OrString<Element & IntrinsicAttributes & ElementTagNameMap[key]>>;
         };
+        /** Additional undeclared props */
         interface IntrinsicAttributes {
             id?: string;
             xmlns?: string;
@@ -555,6 +743,11 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * Returns closure that returns constant value.
+     * @example
+     * const rnd = $mol_const( Math.random() )
+     */
     function $mol_const<Value>(value: Value): {
         (): Value;
         '()': Value;
@@ -562,6 +755,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Returns string key for any value. */
     function $mol_key<Value>(value: Value): string;
 }
 
@@ -583,6 +777,9 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * Decorates method to fiber to ensure it is executed only once inside other fiber.
+     */
     function $mol_wire_method<Host extends object, Args extends readonly any[]>(host: Host, field: PropertyKey, descr?: TypedPropertyDescriptor<(...args: Args) => any>): {
         value: (this: Host, ...args: Args) => any;
         enumerable?: boolean;
@@ -594,14 +791,25 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * Returns `Tuple` without first element.
+     *
+     * 	$mol_type_tail<[ 1 , 2 , 3 ]> // [ 2, 3 ]
+     */
     type $mol_type_tail<Tuple extends readonly any[]> = ((...tail: Tuple) => any) extends ((head: any, ...tail: infer Tail) => any) ? Tail : never;
 }
 
 declare namespace $ {
+    /**
+     * Returns last element of `Tuple`.
+     *
+     * 	$mol_type_tail<[ 1 , 2 , 3 ]> // 3
+     */
     type $mol_type_foot<Tuple extends readonly any[]> = Tuple['length'] extends 0 ? never : Tuple[$mol_type_tail<Tuple>['length']];
 }
 
 declare namespace $ {
+    /** Long-living fiber. */
     class $mol_wire_atom<Host, Args extends readonly unknown[], Result> extends $mol_wire_fiber<Host, Args, Result> {
         static solo<Host, Args extends readonly unknown[], Result>(host: Host, task: (this: Host, ...args: Args) => Result): $mol_wire_atom<Host, Args, Result>;
         static plex<Host, Args extends readonly unknown[], Result>(host: Host, task: (this: Host, ...args: Args) => Result, key: Args[0]): $mol_wire_atom<Host, Args, Result>;
@@ -609,6 +817,9 @@ declare namespace $ {
         static watcher: $mol_after_frame | null;
         static watch(): void;
         watch(): void;
+        /**
+         * Update atom value through another temp fiber.
+         */
         resync(args: Args): Error | Result | Promise<Error | Result>;
         once(): Awaited<Result>;
         channel(): ((next?: $mol_type_foot<Args>) => Awaited<Result>) & {
@@ -620,16 +831,19 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Incompatible with instance fields with initializators */
     function $mol_wire_field<Host extends object, Field extends keyof Host, Value extends Host[Field]>(host: Host, field: Field, descr?: TypedPropertyDescriptor<Value>): any;
 }
 
 declare namespace $ {
+    /** Decorates solo object channel to [mol_wire_atom](../atom/atom.ts). */
     export function $mol_wire_solo<Args extends any[]>(host: object, field: string, descr?: TypedPropertyDescriptor<(...args: Args) => any>): TypedPropertyDescriptor<(...args: First_optional<Args>) => any>;
     type First_optional<Args extends any[]> = Args extends [] ? [] : [Args[0] | undefined, ...$mol_type_tail<Args>];
     export {};
 }
 
 declare namespace $ {
+    /** Reactive memoizing multiplexed property decorator. */
     function $mol_wire_plex<Args extends [any, ...any[]]>(host: object, field: string, descr?: TypedPropertyDescriptor<(...args: Args) => any>): {
         value: (this: typeof host, ...args: Args) => any;
         enumerable?: boolean;
@@ -641,35 +855,70 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * 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
+     */
     let $mol_mem: typeof $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
+     */
     let $mol_mem_key: typeof $mol_wire_plex;
 }
 
+/** @jsx $mol_jsx */
 declare namespace $ {
+    /** Reactive JSX component */
     abstract class $mol_jsx_view extends $mol_object2 {
+        /** Returns component instance for DOM node. */
         static of<This extends typeof $mol_jsx_view>(this: This, node: Element): InstanceType<This>;
         attributes: Partial<Pick<this, Exclude<keyof this, 'valueOf'>>>;
+        /** Document to reuse DOM elements by ID */
         ownerDocument: typeof $mol_jsx_document;
+        /** Autogenerated class names */
         className: string;
+        /** Children to render inside */
         get childNodes(): Array<Node | string>;
+        /** Memoized render in right context */
         valueOf(): HTMLElement;
+        /** Returns actual DOM tree */
         abstract render(): HTMLElement;
     }
 }
 
 declare namespace $ {
+    /** Run code without state changes */
     function $mol_wire_probe<Value>(task: () => Value, def?: Value): Value | undefined;
 }
 
 declare namespace $ {
+    /**
+     * Disable reaping of current subscriber
+     */
     function $mol_wire_solid(): void;
 }
 
 declare namespace $ {
+    /**
+     * Real-time refresh current atom.
+     * Don't use if possible. May reduce performance.
+     */
     function $mol_wire_watch(): void;
 }
 
 declare namespace $ {
+    /** Convert a pseudo-synchronous (Suspense API) API to an explicit asynchronous one (for integrating with external systems). */
     export function $mol_wire_async<Host extends object>(obj: Host): ObjectOrFunctionResultPromisify<Host>;
     type FunctionResultPromisify<Some> = Some extends (...args: infer Args) => infer Res ? Res extends PromiseLike<unknown> ? Some : (...args: Args) => Promise<Res> : Some;
     type MethodsResultPromisify<Host extends Object> = {
@@ -680,12 +929,14 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Starts subtasks concurrently instead of serial. */
     function $mol_wire_race<Tasks extends ((...args: any) => any)[]>(...tasks: Tasks): {
         [index in keyof Tasks]: ReturnType<Tasks[index]>;
     };
 }
 
 declare namespace $ {
+    /** State of time moment */
     class $mol_state_time extends $mol_object {
         static task(precision: number, reset?: null): $mol_after_timeout | $mol_after_frame;
         static now(precision: number): number;
@@ -693,6 +944,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Transition atom value */
     function $mol_wire_easing(next: any): any;
 }
 
@@ -701,6 +953,15 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /**
+     * Returns type of function result or class instance.
+     *
+     * 	// 777
+     * 	$mol_type_result< ()=> 777 >
+     *
+     * 	// 777
+     * 	$mol_type_result< new()=> 777 >
+     */
     type $mol_type_result<Func> = Func extends (...params: any) => infer Result ? Result : Func extends new (...params: any) => infer Result ? Result : never;
 }
 
@@ -711,6 +972,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** Reactive Set */
     class $mol_wire_set<Value> extends Set<Value> {
         pub: $mol_wire_pub;
         has(value: Value): boolean;
@@ -733,6 +995,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** reactive Dictionary */
     class $mol_wire_dict<Key, Value> extends Map<Key, Value> {
         pub: $mol_wire_pub;
         has(key: Key): boolean;
@@ -764,6 +1027,7 @@ declare namespace $ {
 }
 
 declare namespace $ {
+    /** 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?: () => any): (() => any) | undefined;
         static track(fiber: $mol_wire_fiber<any, any, any>): any;