import { MixedStyleDeclaration } from '@native-html/css-processor';
import { ReactNativePropsDefinitions } from '../helper-types';
import { SetMarkersForTNode } from '../tree/tree-types';
import HTMLContentModel from './HTMLContentModel';
import { CustomElementModel, ElementCategory, ElementModelBase, NativeElementModel, TagName } from './model-types';
/**
 * An object to specify custom tags.
 *
 * @typeParam T - The name of the tag to which the model will apply.
 * @typeParam M - The {@link HTMLContentModel} associated with this tag.
 */
export interface HTMLElementModelShape<T extends string, M extends HTMLContentModel> extends ElementModelBase<T> {
    /**
     * The {@link HTMLContentModel} attached to this model.
     */
    readonly contentModel: M;
    /**
     * `true` when the associated tag is a {@link https://html.spec.whatwg.org/multipage/syntax.html#void-elements | void element}.
     *
     * @remarks
     *
     * - Void elements cannot have children.
     * - TText-translated void elements will be preserved even though they don't
     *   have children.
     */
    readonly isVoid: boolean;
    /**
     * An opaque element translated {@link TNode} will have no translated {@link TNode}
     * children.
     */
    readonly isOpaque: boolean;
}
/**
 * An object defining engine internals for tags, such as default styles
 * (UAStyles), content model (how this tag is treated during hoisting)... etc.
 *
 * @typeParam T - The name of the tag to which the model will apply.
 * @typeParam M - The {@link HTMLContentModel} associated with this tag.
 */
export default class HTMLElementModel<T extends string, M extends HTMLContentModel> implements HTMLElementModelShape<T, M> {
    /**
     * The tag name associated with this model.
     */
    readonly tagName: T;
    /**
     * The {@link HTMLContentModel} attached to this model.
     */
    readonly contentModel: M;
    /**
     * An opaque element translated {@link TNode} will have no translated {@link TNode}
     * children.
     */
    readonly isOpaque: boolean;
    /**
     * `true` when the associated tag is a {@link https://html.spec.whatwg.org/multipage/syntax.html#void-elements | void element}.
     *
     * @remarks
     *
     * - Void elements cannot have children.
     * - TText-translated void elements will be preserved even though they don't
     *   have children.
     */
    readonly isVoid: boolean;
    /**
     * Equivalent of "user-agent" styles. The default styles for the element.
     *
     * @remarks These styles will be merged over by `tagsStyles`.
     */
    readonly mixedUAStyles?: MixedStyleDeclaration;
    /**
     * React Native props grouped by native components. Those props
     * will be passed to the underlying native component at render time.
     *
     * @remarks Some props might be overriden by props derived from the
     * {@link TNode} attributes. For example, if you pass `accessibilityLabel`
     * and there is an `aria-label` attribute attached to one node, the
     * `aria-label` will be used. If you want to be able to override the
     * `aria-label`, use {@link HTMLElementModel.getReactNativeProps} instead.
     *
     * @example
     *
     * ```ts
     * import {HTMLElementModel, HTMLContentModel} from '@native-html/render';
     *
     * const customHTMLElementModels = {
     *  'nav-button': HTMLElementModel.fromCustomModel({
     *    tagName: 'nav-button',
     *    contentModel: HTMLContentModel.block,
     *    reactNativeProps: {
     *      native: {
     *        onPress() {
     *          console.info('nav-button pressed');
     *        },
     *      },
     *    },
     *  }),
     *};
     * ```
     */
    readonly reactNativeProps?: ReactNativePropsDefinitions;
    /**
     * A function to create conditional "user-agent" styles.
     *
     * @deprecated Use {@link HTMLElementModel.getMixedUAStyles} instead.
     */
    readonly getUADerivedStyleFromAttributes: NativeElementModel['getUADerivedStyleFromAttributes'];
    /**
     * A function to create conditional "user-agent" styles.
     *
     * @remarks For example, &lt;a&gt; tags will have underline decoration and be
     * colored blue only when `href` is defined.
     */
    readonly getMixedUAStyles: NativeElementModel['getMixedUAStyles'];
    /**
     * A function to create React Native props from a {@link TNode} grouped by
     * native components.
     *
     * Those props will be deep-merged over the pre-generated props. You can
     * preserve some of the pre-generated props since you receive them as second
     * argument.
     *
     * **Merge strategy** (latest overrides former):
     *
     * 1. props from `reactNativeProps`,
     * 2. auto-generated props from attributes
     * 3. props returned by this function
     *
     * @param tnode - The {@link TNode} for which to create React Native props.
     * @param preGeneratedProps - The props that were pre-generated for the {@link TNode}
     * based on attributes (e.g. aria-label ...) and
     * {@link ElementModelBase.reactNativeProps}.
     * @returns React Native props grouped by native components (see
     * {@link ReactNativePropsDefinitions}). Those props will be passed to the
     * underlying native component at render time.
     *
     * @example
     *
     * ```ts
     * import { defaultHTMLElementModels } from "@native-html/render";
     *
     * const customHTMLElementModels = {
     *   a: defaultHTMLElementModels.a.extend({
     *     getReactNativeProps(tnode) {
     *       const attributes = tnode.attributes;
     *       return {
     *         native: {
     *           accessibilityHint:
     *             attributes['data-scope'] === 'internal'
     *               ? 'Open in a new screen.'
     *               : 'Open in system web browser.',
     *         },
     *       };
     *     },
     *   }),
     * };
     * ```
     */
    readonly getReactNativeProps: NativeElementModel['getReactNativeProps'];
    /**
     * Derive markers for one TNode.
     */
    readonly setMarkersForTNode?: SetMarkersForTNode;
    private constructor();
    /**
     * Create an {@link HTMLElementModel} from a custom template.
     *
     * @param template - The custom template.
     */
    static fromCustomModel<CustomTags extends string, ContentModel extends HTMLContentModel>(template: CustomElementModel<CustomTags, ContentModel>): HTMLElementModel<CustomTags, ContentModel>;
    /**
     * Create an {@link HTMLElementModel} from a native description.
     *
     * @param nativeElementModel - The native model declaration.
     */
    static fromNativeModel<TN extends TagName, E extends ElementCategory>(nativeElementModel: NativeElementModel<TN, E>): HTMLElementModel<TN, E extends "anchor" | "edits" ? HTMLContentModel.mixed : E extends "tabular" | "sectioning" | "grouping" ? HTMLContentModel.block : E extends "textual" ? HTMLContentModel.textual : HTMLContentModel.none>;
    isTranslatableBlock(): boolean;
    isTranslatableTextual(): boolean;
    /**
     * Create a new {@link HTMLElementModel} by shallow-merging properties into this model.
     *
     * @param merger - A function to generate the new properties to shallow-merge into this model.
     * @typeParam CM - The {@link HTMLContentModel} attached to the new model.
     */
    extend<CM extends HTMLContentModel>(merger: (shape: HTMLElementModelShape<T, CM>) => Partial<HTMLElementModelShape<T, CM>>): HTMLElementModel<T, CM>;
    /**
     * Create a new {@link HTMLElementModel} by shallow-merging properties into this model.
     *
     * @param shape - The {@link HTMLElementModelShape} to shallow-merge into this model.
     * @typeParam CM - The {@link HTMLContentModel} attached to the new model.
     */
    extend<CM extends HTMLContentModel>(shape: Partial<HTMLElementModelShape<T, CM>>): HTMLElementModel<T, CM>;
}
//# sourceMappingURL=HTMLElementModel.d.ts.map