eddev 2.0.0-beta.115 → 2.0.0-beta.117

package/css/editor-styles.css

@@ -92,3 +92,7 @@
 .acf-block-panel .acf-empty-block-fields {
   display: none;
 }
+
+.simple-appender {
+  display: inline-flex !important;
+}

package/dist/app/entry/ssr-root-client.js

@@ -1,11 +1,12 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { useEffect } from "react";
 import { useSnapshot } from "valtio";
 import { BrowserRouter } from "../lib/routing/components/BrowserRouter.js";
 import { clientMetaTags } from "../lib/routing/context.js";
 import { APIProvider } from "../utils/APIProvider.js";
+import { DevUILoader } from "../lib/devtools/loader.js";
 export function SSRClientRoot(props) {
-    return (_jsxs(APIProvider, { children: [_jsx(DynamicMetaTags, {}), _jsx(BrowserRouter, {})] }));
+    return (_jsxs(APIProvider, { children: [_jsx(BrowserRouter, {}), _jsxs(_Fragment, { children: [_jsx(DynamicMetaTags, {}), _jsx(DevUILoader, {})] })] }));
 }
 function DynamicMetaTags() {
     const dynamicTags = useSnapshot(clientMetaTags).tags;

package/dist/app/entry/ssr-root.js

@@ -1,4 +1,4 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { SSRRouter } from "../lib/routing/components/SSRRouter.js";
 import { getRouteMeta, normalizeRoute } from "../lib/routing/utils.js";
 import { APIProvider } from "../utils/APIProvider.js";
@@ -6,16 +6,16 @@ export function SSRRoot(props) {
     const loader = props.loader;
     loader.setAppData(props.initialData.appData.data);
     loader.populateRouteData(props.pathname, props.initialData);
-    return (_jsx(APIProvider, { children: _jsx(SSRRouter, { loader: loader, route: normalizeRoute({
-                id: "initial",
-                component: loader.getRouteComponent(props.initialData.view),
-                key: "",
-                props: props.initialData.viewData.data,
-                view: props.initialData.view,
-                search: "",
-                pathname: props.pathname,
-                query: {},
-                hash: "",
-                meta: getRouteMeta(props.initialData),
-            }) }) }));
+    return (_jsxs(APIProvider, { children: [_jsx(SSRRouter, { loader: loader, route: normalizeRoute({
+                    id: "initial",
+                    component: loader.getRouteComponent(props.initialData.view),
+                    key: "",
+                    props: props.initialData.viewData.data,
+                    view: props.initialData.view,
+                    search: "",
+                    pathname: props.pathname,
+                    query: {},
+                    hash: "",
+                    meta: getRouteMeta(props.initialData),
+                }) }), _jsx(_Fragment, {})] }));
 }

package/dist/app/lib/blocks/EditableText.d.ts

@@ -1,12 +1,25 @@
 import { ElementType } from "react";
 import { InlineValueStore } from "./inline-editing.js";
 export type InlineTextValueStore = InlineValueStore<string>;
+type BuiltinFormats = "core/bold" | "core/code" | "core/italic" | "core/link" | "core/strikethrough" | "core/underline" | "core/subscript" | "core/superscript" | "core/unknown" | "core/non-breaking-space" | "core/footnote";
 type Props<T extends ElementType> = {
     /** Specify a tag name or React component */
     as?: T;
     /** Prevents this text element from being multi-line */
     disableLineBreaks?: boolean;
-    /** Enables the rich text toolbar */
+    /**
+     * Specify which formatting options are allowed in this text element (bold, italics etc).
+     *
+     * By default, all options are enabled.
+     *
+     * Set to an empty array to disable formatting options.
+     *
+     * You can register new formats in `_editor.tsx` using the `defineEditorConfig` function.
+     **/
+    allowedFormats?: (BuiltinFormats | (string & {}))[];
+    /**
+     * @deprecated use `allowedFormats` instead
+     */
     inlineToolbar?: boolean;
     /** Specify default content to use on the frontend if nothing has been entered */
     defaultValue?: string;

package/dist/app/lib/blocks/EditableText.js

@@ -6,8 +6,13 @@ export function EditableText({ id, as, appendOnEnter, store, ...props }) {
         const readOnly = useBlockContext()?.readonly;
         if (!readOnly) {
             const [value, setValue] = useValueStore(store ?? id);
+            // const defaultFormats = wp.data.useSelect((select) => {
+            //   const formats = (select(wp.richText.store) as any).getFormatTypes()
+            //   console.log("U", formats)
+            //   return formats.map((f: any) => f.name)
+            // }, [])
             const appendBlocks = useBlockAppender();
-            return (_jsx(wp.blockEditor.RichText, { ...props, placeholder: props.placeholder ?? props.defaultValue, tagName: as, value: value || "", onChange: setValue, inlineToolbar: props.inlineToolbar, disableLineBreaks: props.disableLineBreaks, onKeyDownCapture: (e) => {
+            return (_jsx(wp.blockEditor.RichText, { ...props, placeholder: props.placeholder ?? props.defaultValue, tagName: as, value: value || "", onChange: setValue, allowedFormats: props.inlineToolbar === false ? [] : props.allowedFormats, disableLineBreaks: props.disableLineBreaks, "data-allowed-formats": props.allowedFormats?.join(" "), onKeyDownCapture: (e) => {
                     if (e.key === "Enter" && appendOnEnter && appendBlocks) {
                         appendBlocks([
                             wp.blocks.createBlock(typeof appendOnEnter === "string" ? appendOnEnter : "core/paragraph"),
@@ -21,11 +26,12 @@ export function EditableText({ id, as, appendOnEnter, store, ...props }) {
     let [value] = useValueStore(store ?? id);
     const handleClickEvent = useRouter((r) => r.handleClickEvent);
     const otherProps = { ...props };
-    delete otherProps.inlineToolbar;
     delete otherProps.disableLineBreaks;
     delete otherProps.id;
     otherProps.as = otherProps.asProp ?? undefined;
     delete otherProps.asProp;
+    delete otherProps.allowedFormats;
+    delete otherProps.disableLineBreaks;
     delete otherProps.placeholder;
     if (value === "" || typeof value !== "string") {
         if (props.defaultValue) {

package/dist/app/lib/blocks/InnerBlocks.d.ts

@@ -2,7 +2,7 @@ import { FunctionComponent } from "react";
 import { ContentBlockLayoutProps } from "./ContentBlocks.js";
 import { BlockTemplate } from "./editor/block-templates.js";
 type AppenderConfig = {
-    type: "default" | "button" | CustomBlockAppender;
+    type: "default" | "button" | "simple" | CustomBlockAppender;
     className?: string;
 };
 export type CustomBlockAppender = FunctionComponent<{
@@ -26,9 +26,13 @@ type InnerBlocksProps = {
      * NOTE: This will have no effect on the frontend, since no wrapper div is created on the frontend.
      **/
     adminClassName?: string;
-    /**
-     *
-     */
+    /** The default blocks to insert when there are no (non-templated) blocks */
+    defaultBlocks?: BlockTemplate;
+    /** Blocks to ensure are inserted at the top of the page */
+    headerTemplate?: BlockTemplate;
+    /** Blocks to ensure are inserted at the bottom of the page */
+    footerTemplate?: BlockTemplate;
+    /** A full-page block template */
     template?: BlockTemplate;
     /**
      * `false` allows all operations
@@ -41,7 +45,7 @@ type InnerBlocksProps = {
      * @default false
      *
      */
-    templateLock?: "all" | "insert" | "contentOnly" | false;
+    templateLock?: "all" | "insert" | "contentOnly" | "none" | false;
     appender?: AppenderConfig;
     prioritizedInserterBlocks?: ChildBlockTypeName[];
 } & ContentBlockLayoutProps;

package/dist/app/lib/blocks/InnerBlocks.js

@@ -1,25 +1,58 @@
 import { jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo } from "react";
 import { ContentBlocks } from "./ContentBlocks.js";
-import { transformBlockTemplate } from "./editor/block-templates.js";
+import { applyTemplateBlocks, transformBlockTemplate } from "./editor/block-templates.js";
 import { blocksByTag } from "./editor/blocks-by-tag.js";
 import { useBlockContext, useInnerBlocks } from "./inline-editing.js";
-const Appender = (props) => {
+import { hash } from "object-code";
+const Appender = ({ config, ...props }) => {
     const clientId = useBlockContext()?.block[1].clientId;
-    if (props.type === "button") {
-        return _jsx(wp.blockEditor.ButtonBlockAppender, { className: props.className, rootClientId: clientId });
+    if (config?.type === "button") {
+        return _jsx(wp.blockEditor.ButtonBlockAppender, { ...props, rootClientId: clientId, className: config.className });
     }
-    else if (typeof props.type === "function") {
-        const Type = props.type;
-        return (_jsx(wp.blockEditor.Inserter, { renderToggle: (p) => {
+    else if (config?.type === "simple") {
+        return (_jsx(wp.blockEditor.ButtonBlockAppender, { ...props, rootClientId: clientId, className: (props.className || "") + " block-editor-inserter__toggle has-icon simple-appender" }));
+    }
+    else if (typeof config?.type === "function") {
+        const Type = config?.type;
+        return (_jsx(wp.blockEditor.Inserter, { rootClientId: clientId, renderToggle: (p) => {
                 return _jsx(Type, { ...p });
-            }, rootClientId: clientId }));
+            }, isAppender: true, 
+            // @ts-ignore
+            __experimentalIsQuick: true }));
+        // } else if (config?.type === "simple") {
+        //   return (
+        //     <wp.blockEditor.Inserter
+        //       clientId={clientId}
+        //       rootClientId={clientId}
+        //       renderToggle={(p: any) => {
+        //         return (
+        //           <button
+        //             className="simple-appender components-button block-editor-inserter__toggle !inline-flex has-icon"
+        //             onClick={() => p.onToggle()}
+        //           >
+        //             <svg
+        //               xmlns="http://www.w3.org/2000/svg"
+        //               viewBox="0 0 24 24"
+        //               width="24"
+        //               height="24"
+        //               aria-hidden="true"
+        //               focusable="false"
+        //             >
+        //               <path d="M11 12.5V17.5H12.5V12.5H17.5V11H12.5V6H11V11H6V12.5H11Z"></path>
+        //             </svg>
+        //           </button>
+        //         )
+        //       }}
+        //       isAppender
+        //       // @ts-ignore
+        //       __experimentalIsQuick
+        //     />
+        //   )
     }
     else {
-        return (_jsx(wp.blockEditor.DefaultBlockAppender
         // @ts-ignore
-        , { 
-            // @ts-ignore
-            className: props.className, rootClientId: clientId, lastBlockClientId: clientId }));
+        return _jsx(wp.blockEditor.InnerBlocks.DefaultBlockAppender, { ...props });
     }
 };
 export function createAppender(comp) {
@@ -33,29 +66,35 @@ export function createAppender(comp) {
 export function InnerBlocks(props) {
     if (env.admin) {
         const inlineContext = useBlockContext();
+        const appender = useMemo(() => {
+            return (p) => _jsx(Appender, { config: props.appender, ...p });
+        }, [props.appender]);
         if (!inlineContext?.readonly) {
             const innerBlocksProps = wp.blockEditor.useInnerBlocksProps({}, {
                 orientation: props.orientation ?? "vertical",
                 allowedBlocks: props.allowedBlocks ? blocksByTag.expand(props.allowedBlocks) : undefined,
                 prioritizedInserterBlocks: props.prioritizedInserterBlocks,
-                renderAppender: props.appender
-                    ? () => _jsx(Appender, { ...props.appender })
-                    : wp.blockEditor.InnerBlocks.ButtonBlockAppender,
-                templateLock: props.templateLock ?? false,
+                renderAppender: appender,
+                templateLock: props.templateLock === "none" ? false : (props.templateLock ?? false),
                 template: props.template ? transformBlockTemplate(props.template) : undefined,
             });
+            /**
+             * A little bit experimental
+             *
+             * Adds support for headerTemplate/defaultBlocks/footerTemplate, which was first introduced in `_editor.tsx` for generate templates.
+             */
+            const blockId = inlineContext?.block[1].clientId;
+            useEffect(() => {
+                if (props.defaultBlocks || props.headerTemplate || props.footerTemplate) {
+                    const newBlocks = applyTemplateBlocks(inlineContext?.innerBlocks ?? [], props);
+                    wp.data.dispatch(wp.blockEditor.store).replaceInnerBlocks(blockId, newBlocks);
+                }
+            }, [
+                hash(inlineContext?.innerBlocks.map((b) => [b.blockName, b.clientId])),
+                hash([props.template, props.defaultBlocks, props.headerTemplate, props.footerTemplate]),
+                blockId,
+            ]);
             return (_jsx("div", { ...innerBlocksProps, className: [innerBlocksProps.className, props.adminClassName].filter(Boolean).join(" ") }));
-            // return (
-            //   <wp.blockEditor.InnerBlocks
-            //     // @ts-ignore
-            //     orientation={props.orientation}
-            //     prioritizedInserterBlocks={props.prioritizedInserterBlocks}
-            //     allowedBlocks={props.allowedBlocks ? blocksByTag.expand(props.allowedBlocks) : undefined}
-            //     renderAppender={props.appender ? () => <Appender {...props.appender!} /> : undefined}
-            //     templateLock={(props.templateLock as any) ?? false}
-            //     template={props.template ? transformBlockTemplate(props.template) : undefined}
-            //   />
-            // )
         }
     }
     const blocks = useInnerBlocks();

package/dist/app/lib/blocks/defineBlock.d.ts

@@ -1,2 +1,5 @@
 import { ComponentType, ReactNode } from "react";
 export declare function defineBlock<TName extends keyof BlockProps>(name: TName, component: (props: BlockProps[TName]) => ReactNode): ComponentType<BlockProps[TName]>;
+export declare namespace defineBlock {
+    var meta: (name: string, meta: any) => void;
+}

package/dist/app/lib/blocks/defineBlock.js

@@ -1,3 +1,10 @@
+import { blockMetaDescriptors } from "./editor/installGutenbergHooks";
+import { resolveAcfBlockName } from "./editor/block-templates";
 export function defineBlock(name, component) {
     return component;
 }
+defineBlock.meta = (name, meta) => {
+    if (env.admin) {
+        blockMetaDescriptors.set(resolveAcfBlockName(name), meta);
+    }
+};

package/dist/app/lib/blocks/editor/EditorHighlights.js

@@ -1,7 +1,7 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-import { useEffect, useRef, useState } from "react";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
 export function EditorHighlights(props) {
-    const ref = useRef(null);
+    const [element, setElement] = useState(null);
     const [controller, setController] = useState(null);
     // wp.data.select('core/editor').isBlockSelected
     // const isSelected = wp.data.useSelect(
@@ -9,12 +9,12 @@ export function EditorHighlights(props) {
     //   [props.clientId]
     // )
     useEffect(() => {
-        if (!props.enabled)
+        if (!props.enabled || !element)
             return;
-        const controller = new HighlightController(ref.current);
+        const controller = new HighlightController(element);
         setController(controller);
         return () => controller.teardown();
-    }, [props.enabled]);
+    }, [props.enabled, element]);
     useEffect(() => {
         if (controller) {
             controller.isSelected = false;
@@ -22,7 +22,38 @@ export function EditorHighlights(props) {
             controller.update();
         }
     }, [controller, false]);
-    return (_jsx("div", { ref: ref, style: { display: "contents" }, onPointerEnter: () => controller?.enable(), onPointerLeave: () => controller?.disable(), children: props.children }));
+    useEffect(() => {
+        const element = document.getElementById(`block-${props.clientId}`);
+        if (element) {
+            setElement(element);
+        }
+        else {
+            setElement(null);
+        }
+    }, [props.clientId]);
+    useEffect(() => {
+        if (controller && element) {
+            const onPointerEnter = () => controller.enable();
+            const onPointerLeave = () => controller.disable();
+            element.addEventListener("pointerenter", onPointerEnter);
+            element.addEventListener("pointerleave", onPointerLeave);
+            return () => {
+                element.removeEventListener("pointerenter", onPointerEnter);
+                element.removeEventListener("pointerleave", onPointerLeave);
+            };
+        }
+    }, [element, controller]);
+    return _jsx(_Fragment, { children: props.children });
+    // return (
+    //   <div
+    //     ref={ref}
+    //     style={{ display: "contents" }}
+    //     // onPointerEnter={() => controller?.enable()}
+    //     // onPointerLeave={() => controller?.disable()}
+    //   >
+    //     {props.children}
+    //   </div>
+    // )
 }
 class HighlightController {
     root;
@@ -40,7 +71,7 @@ class HighlightController {
             let editables = Array.from(this.root.querySelectorAll("[contenteditable=true], .editable-slot"));
             let childBlocks = Array.from(this.root.querySelectorAll(".wp-block"));
             const childIsSelected = this.root.querySelectorAll(".editor-highlighter-root-selected").length > 0;
-            this.block = childBlocks[0];
+            this.block = this.root;
             childBlocks = childBlocks.slice(1);
             editables = childIsSelected
                 ? []
@@ -96,7 +127,10 @@ class HighlightController {
         el.style.position = "absolute";
         el.style.pointerEvents = "none";
         el.style.zIndex = "20";
-        el.className = "editor-highlight";
+        el.classList.add("editor-highlight");
+        if (target.getAttribute("data-editor-higlight-class")) {
+            el.classList.add(target.getAttribute("data-editor-higlight-class"));
+        }
         this.block.appendChild(el);
         return el;
     }

package/dist/app/lib/blocks/editor/EditorSupport.js

@@ -1,17 +1,23 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { createContext, Suspense, useContext } from "react";
+import { createContext, Suspense, useContext, useEffect } from "react";
 import { blockManifestReader } from "../../internal/read-block-manifest.js";
 import { APIProvider } from "../../../utils/APIProvider.js";
 import { ErrorBoundaryEditor } from "./ErrorBoundaryEditor.js";
 export const BlockContext = createContext(undefined);
 export function EditableBlock({ payload }) {
-    const block = useContext(BlockContext);
-    if (!block)
+    if (!env.admin)
+        throw new Error("`EditableBlock` can only be used in the admin environment");
+    const info = useContext(BlockContext);
+    useEffect(() => {
+        const block = wp.data.select("core/block-editor").getBlock(info?.props.clientId);
+        if (block && block.attributes) {
+            // @ts-ignore
+            block.attributes.props = payload;
+        }
+    }, [payload, info?.props.clientId]);
+    if (!info)
         return null;
-    const getBlock = () => {
-        return blockManifestReader.value[block.name];
-    };
-    const BlockComponent = getBlock();
+    const BlockComponent = blockManifestReader.value[info.name];
     if (!BlockComponent)
         return _jsx("div", { children: "Unable to load block component" });
     return (_jsx(ErrorBoundaryEditor, { children: _jsx(APIProvider, { children: _jsx(Suspense, { children: _jsx(BlockComponent, { ...payload }) }) }) }));

package/dist/app/lib/blocks/editor/block-templates.d.ts

@@ -1,3 +1,9 @@
 export type BlockTemplate = [name: ChildBlockTypeName, props: any, children?: BlockTemplate][];
 export declare function resolveAcfBlockName(name: string): string;
 export declare function transformBlockTemplate(template: BlockTemplate): BlockTemplate;
+export declare function applyTemplateBlocks(currentBlocks: any[], config: {
+    defaultBlocks?: BlockTemplate;
+    headerTemplate?: BlockTemplate;
+    footerTemplate?: BlockTemplate;
+}): any[];
+export declare function transformTemplateToBlocks(template: BlockTemplate, locked?: boolean, isFromTemplate?: boolean): any;

package/dist/app/lib/blocks/editor/block-templates.js

@@ -7,3 +7,67 @@ export function transformBlockTemplate(template) {
         return [resolveAcfBlockName(name), props, children ? transformBlockTemplate(children) : undefined];
     });
 }
+export function applyTemplateBlocks(currentBlocks, config) {
+    const templateBlocks = currentBlocks.filter((block) => block.attributes.isFromTemplate);
+    let header = config.headerTemplate ? syncBlocks(transformTemplateToBlocks(config.headerTemplate)) : [];
+    let footer = config.footerTemplate ? syncBlocks(transformTemplateToBlocks(config.footerTemplate)) : [];
+    let blocks = currentBlocks.filter((block) => !header.includes(block) && !footer.includes(block));
+    blocks.forEach((block) => {
+        delete block.attributes.lock;
+        delete block.isFromTemplate;
+    });
+    // const blocksToDelete = currentBlocks.filter((block: any) => {
+    //   return !header.includes(block) && !footer.includes(block) && !blocks.includes(block)
+    // })
+    // blocksToDelete.forEach((block: any) => {
+    //   delete block.attributes.lock
+    //   delete block.isFromTemplate
+    // })
+    // blocks = [...blocks, ...blocksToDelete]
+    // console.log("blocks", blocks)
+    // console.log("blocksToDelete", blocksToDelete)
+    if (!blocks.length && config.defaultBlocks) {
+        blocks = transformTemplateToBlocks(config.defaultBlocks, false, false);
+    }
+    let newBlocks = [...header, ...blocks, ...footer];
+    function syncBlocks(blocks) {
+        return blocks.map((block) => {
+            const matched = templateBlocks.find((templateBlock) => templateBlock.name === block.name);
+            templateBlocks.splice(templateBlocks.indexOf(matched), 1);
+            if (matched) {
+                matched.attributes.lock = block.attributes.lock;
+                return matched;
+            }
+            return block;
+        });
+    }
+    return newBlocks;
+}
+export function transformTemplateToBlocks(template, locked = true, isFromTemplate = true) {
+    return template.map(([name, props, children]) => {
+        const attributes = {
+            data: {},
+            inline: {},
+            isFromTemplate: isFromTemplate,
+            lock: undefined,
+        };
+        if (props.locked === false) {
+            attributes.lock = { move: false, remove: false };
+        }
+        else if (locked || props.locked === true || props.locked === "all") {
+            attributes.lock = { move: true, remove: true };
+        }
+        else {
+            attributes.lock = props.lock;
+        }
+        Object.assign(attributes, props);
+        return {
+            clientId: "block-" + Math.random().toString(36),
+            name: resolveAcfBlockName(name),
+            attributes: attributes,
+            innerBlocks: children ? transformTemplateToBlocks(children, false, isFromTemplate) : [],
+            isValid: true,
+            validationIssues: [],
+        };
+    });
+}

package/dist/app/lib/blocks/editor/create-block.d.ts

@@ -0,0 +1,9 @@
+import { BlockInstance } from "../inline-editing";
+/**
+ * Creates a block instance for the editor. This doesn't add the block to the editor on it's own.
+ * @param name The name of the block
+ * @param attributes
+ * @param innerBlocks
+ * @returns
+ */
+export declare function createBlock(name: ChildBlockTypeName, attributes?: Record<string, any>, innerBlocks?: BlockInstance[]): BlockInstance;

package/dist/app/lib/blocks/editor/create-block.js

@@ -0,0 +1,13 @@
+/**
+ * Creates a block instance for the editor. This doesn't add the block to the editor on it's own.
+ * @param name The name of the block
+ * @param attributes
+ * @param innerBlocks
+ * @returns
+ */
+export function createBlock(name, attributes = {}, innerBlocks = []) {
+    if (!env.admin) {
+        throw new Error("`createBlock` can only be used in the admin environment");
+    }
+    return wp.blocks.createBlock(name, attributes, innerBlocks);
+}

package/dist/app/lib/blocks/editor/editor-config.d.ts

@@ -44,7 +44,6 @@ export declare const editorConfigStore: {
     currentBlocksConfig: EditorConfigItem;
 };
 export declare function configureEditorBlocks(config: EditorConfigItem): void;
-export declare function transformTemplateToBlocks(template: BlockTemplate, locked?: boolean, isFromTemplate?: boolean): any;
 type PostInfo = {
     type: PostTypeName;
     isPattern: false;
@@ -72,9 +71,45 @@ type Matcher = {
     /** Configuration for the editor, when the post type and template match */
     config: EditorConfigItem | ((post: PostInfo) => EditorConfigItem);
 };
+export type BlockTransform = {
+    from: ChildBlockTypeName[];
+    to: ChildBlockTypeName;
+};
+export type CustomRichTextFormat = {
+    /** The ID of the format, eg. `"custom/fancy"` */
+    id: string;
+    /** The title of the format, shown on the tooltip */
+    title: string;
+    /**
+     * The HTML tag name to use.
+     * @default `"span"`
+     **/
+    tagName?: string;
+    /**
+     * The class name to apply to the element.
+     * @default `undefined`
+     **/
+    className?: string;
+    /**
+     * The icon to use in the toolbar.
+     */
+    icon?: string;
+    /**
+     * Whether format makes content interactive or not.
+     * @default `false`
+     */
+    interactive?: boolean;
+    /**
+     * Whether to disable this format by default. If `true`, you must pass the format ID to `allowedFormats` on a `EditableText` component.
+     *
+     * @default `false`
+     */
+    disabledByDefault?: boolean;
+};
 type EditorConfig = {
-    /** A list of template/post type matchers, and the resulting editor config */
-    matchers: Matcher[];
+    customRichTextFormats?: CustomRichTextFormat[];
+    /** A list of template/post type matchers, and resulting editor config that they will apply */
+    matchers?: Matcher[];
 };
 /**
  * This call should be placed in blocks/_editor.tsx