@enonic/react-components/dist/types/RichText.d.ts

Library of React components for handling Enonic XP data and page components

import type { DOMNode, Element } from 'html-react-parser';
import type { ReactNode, JSX } from 'react';
import type { ComponentRegistry } from './ComponentRegistry';
import { ComponentProps, MetaData, MacroComponentData, ComponentDataAndProps } from './index';
export interface RichTextData extends Record<string, unknown> {
    processedHtml: string;
    links?: LinkData[];
    macros?: MacroData[];
    images?: ImageData[];
}
export interface ExtendedRichTextData extends RichTextData {
    macroComponents?: ComponentDataAndProps<MacroComponentData>[];
}
export interface LinkData {
    ref: string;
    content?: Partial<RichtextContent> | null;
    media?: LinkDataMedia | null;
    uri: string;
}
export interface LinkDataMedia {
    content: Partial<RichtextContent> & {
        mediaUrl?: string;
    };
    intent: 'inline' | 'download';
}
export type MacroConfig = Record<string, unknown>;
export interface MacroData {
    ref: string;
    name: string;
    descriptor: string;
    config: Record<string, MacroConfig>;
}
export type ImageContent = Partial<RichtextContent> & {
    imageUrl?: string;
};
export interface ImageData {
    ref: string;
    image: ImageContent;
    style?: ImageStyle | null;
}
export interface ImageStyle {
    name: string;
    aspectRatio: string;
    filter: string;
}
export type RichTextComponentProps = Omit<ComponentProps, 'data' | 'meta'> & {
    data: ExtendedRichTextData;
    meta: RichTextMetaData;
};
export type RichTextMetaData = Omit<MetaData, 'componentRegistry'> & {
    componentRegistry?: ComponentRegistry;
};
export type CreateReplacer<RestProps = Record<string, unknown>> = (params: CreateReplacerParams<RestProps>) => (domNode: DOMNode) => ReplacerResult;
export interface CreateReplacerParams<RestProps = Record<string, unknown>> extends RichTextComponentProps {
    Image: ImageComponent<RestProps>;
    Link: LinkComponent<RestProps>;
    Macro: MacroComponent<RestProps>;
    replacer?: Replacer<RestProps>;
}
export type ReplacerResult = JSX.Element | object | void | undefined | null | false;
export type ImageComponent<RestProps = Record<string, unknown>> = (params: ImageComponentParams<RestProps>) => React.JSX.Element | null;
export type ImageComponentParams<RestProps = Record<string, unknown>> = {
    alt?: string;
    image: ImageContent;
    imageStyle?: ImageStyle | null;
    sizes?: string;
    src: string;
    srcSet?: string;
    style?: React.CSSProperties;
} & RestProps;
export type ReplacerParams<RestProps = Record<string, unknown>> = RichTextComponentProps & {
    el: Element;
} & RestProps;
export type Replacer<RestProps = Record<string, unknown>> = (params: ReplacerParams<RestProps>) => ReplacerResult;
export type LinkComponent<RestProps = Record<string, unknown>> = (params: LinkComponentParams<RestProps>) => React.JSX.Element | null;
export type LinkComponentParams<RestProps = Record<string, unknown>> = {
    children: ReactNode;
    content?: Partial<RichtextContent> | null;
    href: string;
    media?: LinkDataMedia | null;
    target?: string;
    title?: string;
    uri: string;
} & RestProps;
export type MacroComponent<RestProps = Record<string, unknown>> = (params: MacroComponentParams<RestProps>) => React.JSX.Element | null;
export type MacroComponentParams<RestProps = Record<string, unknown>> = ComponentProps<MacroComponentData> & {
    children: string | React.JSX.Element | React.JSX.Element[];
} & RestProps;
export interface ReplaceMacroImageLinkParams<RestProps = Record<string, unknown>> extends CreateReplacerParams<RestProps> {
    createReplacer: CreateReplacer<RestProps>;
    el: Element;
}
export type RichtextContent<Extensions extends Record<string, unknown> = Record<string, unknown>> = {
    _id: string;
    _name: string;
    _path: string;
    _references: RichtextContent[];
    _score?: number;
    children: RichtextContent[];
    components: RichtextContent[];
    createdTime: string;
    displayName: string;
    language: string;
    modifiedTime?: string;
    pageTemplate: RichtextContent;
    pageUrl: string;
    parent: RichtextContent;
    type: string;
    valid: boolean;
    imageUrl?: string;
    mediaUrl?: string;
    [key: string]: any;
} & Extensions;
export type RichTextParams<RestProps = Record<string, unknown>> = RichTextComponentProps & {
    tag?: string;
    className?: string;
    Image?: ImageComponent<RestProps>;
    Macro?: MacroComponent<RestProps>;
    Link?: LinkComponent<RestProps>;
    replacer?: Replacer<RestProps>;
} & RestProps;