import { type Rec } from "@agyemanjp/standard";
import type { StdEltProps, Component, Children } from "../common";
/** General UI element type */
export type UIElement<P extends Rec = Rec> = ProperElement<P> | ValueElement;
export type ProperElement<P extends Rec = Rec> = ComponentElement<P> | IntrinsicElement<P>;
/** UI element that is a simple value */
export type ValueElement = string | undefined;
/** UI element that is intrinsic to the engine */
export type IntrinsicElement<P extends StdEltProps = StdEltProps> = UIElementBase<P> & {
    type: string;
};
/** UI element that specifies a component invocation
 * A component element can produce another UI element, recursively,
 * until an intrinsic/value element is obtained, at which point we can generate DOM from it
 */
export type ComponentElement<P extends StdEltProps = StdEltProps> = UIElementBase<P> & {
    type: Component<P>;
};
export type UIElementBase<P extends StdEltProps = StdEltProps> = {
    props: P;
    children?: Children;
};
/** JSX is transformed into calls of this function */
export declare function createElement<P extends Rec>(type: string, props: P, ...children: UIElement[]): IntrinsicElement<P>;
export declare function createElement<P extends Rec>(type: Component<P>, props: P, ...children: UIElement[]): ComponentElement<P>;
/** Gets children of input element as a flat elements array  */
export declare function getChildren(elt: UIElement): UIElement<Rec<unknown, string>>[];
/** Converts input children into a flat array of elements  */
export declare function normalizeChildren(children?: Children): UIElement<Rec<unknown, string>>[];
export declare const isValueElt: (elt: UIElement) => elt is ValueElement;
export declare const isProperElt: <P extends Rec>(elt?: UIElement<P>) => elt is (IntrinsicElement<P> | ComponentElement<P>);
export declare const isIntrinsicElt: <P extends Rec>(elt: UIElement<P>) => elt is IntrinsicElement<P>;
export declare const isComponentElt: <P extends Rec>(elt: UIElement<P>) => elt is ComponentElement<P>;
export declare const isFragmentElt: (elt: UIElement) => boolean;