@b9g/crank 0.5.0-beta.3 → 0.5.0-beta.4

package/crank.d.ts

@@ -332,61 +332,47 @@ export interface ProvisionMap extends Crank.ProvisionMap {
  * The internal class which holds context data.
  */
 declare class ContextImpl<TNode = unknown, TScope = unknown, TRoot extends TNode = TNode, TResult = unknown> {
-    /**
-     * flags - A bitmask. See CONTEXT FLAGS above.
-     */
+    /** A bitmask. See CONTEXT FLAGS above. */
     f: number;
+    /** The actual context associated with this impl. */
+    owner: Context<unknown, TResult>;
     /**
-     * ctx - The actual object passed as this to components.
-     */
-    ctx: Context<unknown, TResult>;
-    /**
-     * renderer - The renderer which created this context.
+     * The renderer which created this context.
      */
     renderer: RendererImpl<TNode, TScope, TRoot, TResult>;
-    /**
-     * root - The root node as set by the nearest ancestor portal.
-     */
+    /** The root node as set by the nearest ancestor portal. */
     root: TRoot | undefined;
     /**
-     * host - The nearest host or portal retainer.
+     * The nearest ancestor host or portal retainer.
      *
      * When refresh is called, the host element will be arranged as the last step
      * of the commit, to make sure the parent’s children properly reflects the
      * components’s children.
      */
     host: Retainer<TNode>;
-    /**
-     * parent - The parent context.
-     */
+    /** The parent context impl. */
     parent: ContextImpl<TNode, TScope, TRoot, TResult> | undefined;
-    /**
-     * scope - The value of the scope at the point of element’s creation.
-     */
+    /** The value of the scope at the point of element’s creation. */
     scope: TScope | undefined;
-    /**
-     * retainer - The internal node associated with this context.
-     */
+    /** The internal node associated with this context. */
     ret: Retainer<TNode>;
     /**
-     * iterator - The iterator returned by the component function.
+     * The iterator returned by the component function.
+     *
+     * Existence of this property implies that the component is a generator
+     * component. It is deleted when a component is returned.
      */
     iterator: Iterator<Children, Children | void, unknown> | AsyncIterator<Children, Children | void, unknown> | undefined;
-    /*** async properties ***/
     inflightBlock: Promise<unknown> | undefined;
     inflightValue: Promise<ElementValue<TNode>> | undefined;
     enqueuedBlock: Promise<unknown> | undefined;
     enqueuedValue: Promise<ElementValue<TNode>> | undefined;
-    /**
-     * onProps - A callback used in conjunction with the IsAvailable flag to
-     * implement the props async iterator. See the Symbol.asyncIterator method
-     * and the resumeCtxIterator function.
-     */
     onProps: ((props: Record<string, any>) => unknown) | undefined;
     onPropsRequested: Function | undefined;
     constructor(renderer: RendererImpl<TNode, TScope, TRoot, TResult>, root: TRoot | undefined, host: Retainer<TNode>, parent: ContextImpl<TNode, TScope, TRoot, TResult> | undefined, scope: TScope | undefined, ret: Retainer<TNode>);
 }
 declare const _ContextImpl: unique symbol;
+declare type ComponentProps<T> = T extends (props: infer U) => any ? U : T;
 /**
  * A class which is instantiated and passed to every component as its this
  * value. Contexts form a tree just like elements and all components in the
@@ -412,7 +398,7 @@ export declare class Context<TProps = any, TResult = any> implements EventTarget
      * component or via the context iterator methods. This property is mainly for
      * plugins or utilities which wrap contexts.
      */
-    get props(): TProps;
+    get props(): ComponentProps<TProps>;
     /**
      * The current value of the associated element.
      *
@@ -421,8 +407,8 @@ export declare class Context<TProps = any, TResult = any> implements EventTarget
      * mainly for plugins or utilities which wrap contexts.
      */
     get value(): TResult;
-    [Symbol.iterator](): Generator<TProps>;
-    [Symbol.asyncIterator](): AsyncGenerator<TProps>;
+    [Symbol.iterator](): Generator<ComponentProps<TProps>>;
+    [Symbol.asyncIterator](): AsyncGenerator<ComponentProps<TProps>>;
     /**
      * Re-executes a component.
      *