@emailmaker/emailmaker 1.1.103 → 1.1.108

package/{emailmaker-po.3529b1de.js → emailmaker-po.d5e4bde1.js}

@@ -42,4 +42,4 @@ __emailmaker__.define("po",["require","exports","module"],function(na,ct,aa){Obj
 
 `),"utf-8"):u.convert(i.join(`
 
-`),this._charset)}})),Hn=R(((o,t)=>{var e=je(),u=st();t.exports=function(p,h){return new f(p,h).parse()};function f(p,h){this._fileContents=p,this._writeFunc="writeUInt32LE",this._readFunc="readUInt32LE",this._charset=h||"iso-8859-1",this._table={charset:this._charset,headers:void 0,translations:{}}}f.prototype.MAGIC=2500072158,f.prototype._checkMagick=function(){return this._fileContents.readUInt32LE(0)===this.MAGIC?(this._readFunc="readUInt32LE",this._writeFunc="writeUInt32LE",!0):this._fileContents.readUInt32BE(0)===this.MAGIC?(this._readFunc="readUInt32BE",this._writeFunc="writeUInt32BE",!0):!1},f.prototype._loadTranslationTable=function(){for(var p=this._offsetOriginals,h=this._offsetTranslations,i,r,s,n,l=0;l<this._total;l++)r=this._fileContents[this._readFunc](p),p+=4,i=this._fileContents[this._readFunc](p),p+=4,s=this._fileContents.slice(i,i+r),r=this._fileContents[this._readFunc](h),h+=4,i=this._fileContents[this._readFunc](h),h+=4,n=this._fileContents.slice(i,i+r),!l&&!s.toString()&&this._handleCharset(n),s=e.convert(s,"utf-8",this._charset).toString("utf-8"),n=e.convert(n,"utf-8",this._charset).toString("utf-8"),this._addString(s,n);this._fileContents=null},f.prototype._handleCharset=function(p){var h=p.toString(),i;(i=h.match(/[; ]charset\s*=\s*([\w-]+)/i))&&(this._charset=this._table.charset=u.formatCharset(i[1],this._charset)),p=e.convert(p,"utf-8",this._charset).toString("utf-8"),this._table.headers=u.parseHeader(p)},f.prototype._addString=function(p,h){var i={},r,s,n;p=p.split(""),p.length>1?(s=p.shift(),i.msgctxt=s):s="",p=p.join(""),r=p.split("\0"),p=r.shift(),i.msgid=p,(n=r.join("\0"))&&(i.msgid_plural=n),h=h.split("\0"),i.msgstr=[].concat(h||[]),this._table.translations[s]||(this._table.translations[s]={}),this._table.translations[s][p]=i},f.prototype.parse=function(){return this._checkMagick()?(this._revision=this._fileContents[this._readFunc](4),this._total=this._fileContents[this._readFunc](8),this._offsetOriginals=this._fileContents[this._readFunc](12),this._offsetTranslations=this._fileContents[this._readFunc](16),this._loadTranslationTable(),this._table):!1}})),Jn=R(((o,t)=>{var e=ot().Buffer,u=je(),f=st();t.exports=function(h){return new p(h).compile()};function p(h){this._table=h||{},this._table.headers=this._table.headers||{},this._table.translations=this._table.translations||{},this._translations=[],this._writeFunc="writeUInt32LE",this._handleCharset()}p.prototype.MAGIC=2500072158,p.prototype._handleCharset=function(){var h=(this._table.headers["content-type"]||"text/plain").split(";"),i=h.shift(),r=f.formatCharset(this._table.charset),s=[];s=h.map(function(n){var l=n.split("="),y=l.shift().trim(),g=l.join("=");return y.toLowerCase()==="charset"?(r||(r=f.formatCharset(g.trim()||"utf-8")),"charset="+r):n}),r||(r=this._table.charset||"utf-8",s.push("charset="+r)),this._table.charset=r,this._table.headers["content-type"]=i+"; "+s.join("; "),this._charset=r},p.prototype._generateList=function(){var h=[];return h.push({msgid:e.alloc(0),msgstr:u.convert(f.generateHeader(this._table.headers),this._charset)}),Object.keys(this._table.translations).forEach(function(i){typeof this._table.translations[i]=="object"&&Object.keys(this._table.translations[i]).forEach(function(r){if(typeof this._table.translations[i][r]=="object"&&!(i===""&&r==="")){var s=this._table.translations[i][r].msgid_plural,n=r,l;i&&(n=i+""+n),s&&(n+="\0"+s),l=[].concat(this._table.translations[i][r].msgstr||[]).join("\0"),h.push({msgid:u.convert(n,this._charset),msgstr:u.convert(l,this._charset)})}}.bind(this))}.bind(this)),h},p.prototype._calculateSize=function(h){var i=0,r=0,s=0;return h.forEach(function(n){i+=n.msgid.length+1,r+=n.msgstr.length+1}),s=28+8*h.length+8*h.length+i+r,{msgid:i,msgstr:r,total:s}},p.prototype._build=function(h,i){var r=e.alloc(i.total),s=0,n,l;for(r[this._writeFunc](this.MAGIC,0),r[this._writeFunc](0,4),r[this._writeFunc](h.length,8),r[this._writeFunc](28,12),r[this._writeFunc](28+8*h.length,16),r[this._writeFunc](0,20),r[this._writeFunc](28+8*h.length*2,24),s=28+16*h.length,n=0,l=h.length;n<l;n++)h[n].msgid.copy(r,s),r[this._writeFunc](h[n].msgid.length,28+n*8),r[this._writeFunc](s,28+n*8+4),r[s+h[n].msgid.length]=0,s+=h[n].msgid.length+1;for(n=0,l=h.length;n<l;n++)h[n].msgstr.copy(r,s),r[this._writeFunc](h[n].msgstr.length,28+8*h.length+n*8),r[this._writeFunc](s,28+8*h.length+n*8+4),r[s+h[n].msgstr.length]=0,s+=h[n].msgstr.length+1;return r},p.prototype.compile=function(){var h=this._generateList(),i=this._calculateSize(h);return h.sort(function(r,s){return r.msgid>s.msgid?1:r.msgid<s.msgid?-1:0}),this._build(h,i)}})),Xn=R(((o,t)=>{var e=Yn();t.exports={po:{parse:e.parse,createParseStream:e.stream,compile:Vn()},mo:{parse:Hn(),compile:Jn()}}})),Kn=R(((o,t)=>{var e=Wn();t.exports=function(u,f){f=f||{};const p={pretty:!1,fuzzy:!1,stringify:!1,format:"raw",domain:"messages",charset:"utf8",fullMF:!1,mfOptions:{}};for(const n in p)f[n]=typeof f[n]<"u"?f[n]:p[n];let h={},i={};if(f.format==="mf"){const n=u.toString().includes('"Plural-Forms:')?f.mfOptions:Object.assign({},{pluralFunction:()=>0},f.mfOptions);return i=Object.keys(n).length>0?e.parsePo(u,n):e.parsePo(u),f.fullMF?f.stringify?JSON.stringify(i,null,f.pretty?"   ":null):i:(i&&(i.translations&&i.translations[""]?(h=i.translations[""],Object.keys(i.translations).forEach(function(l){l===""?Object.keys(i.translations[""]).forEach(function(y){h[y]=i.translations[""][y]}):h[l]=i.translations[l]})):h=i.translations||{}),f.stringify?JSON.stringify(h,null,f.pretty?"   ":null):h)}const r=Xn().po.parse(u,p.charset),s=r.translations;if(Object.keys(s).forEach(function(n){const l=r.translations[n],y=r.headers?r.headers["plural-forms"]:"";Object.keys(l).forEach(function(g,b){const w=l[g],v=n.length?n+""+g:g,B=w.comments&&w.comments.flag&&w.comments.flag.match(/fuzzy/)!==null;(!B||f.fuzzy)&&(f.format==="jed"?i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgstr):y==="nplurals=1; plural=0;"?(msgstr=w.msgid_plural?[w.msgstr]:w.msgstr,i[v]=[w.msgid_plural?w.msgid_plural:null].concat(msgstr)):i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgstr)),f["fallback-to-msgid"]&&(B&&!f.fuzzy||w.msgstr[0]==="")&&(i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgid_plural?[g,w.msgid_plural]:[g]))})}),r.headers&&(i[""]=r.headers),f.format==="mf"&&delete i[""],f.format.indexOf("jed")===0){const n={domain:f.domain,locale_data:{}};if(f.format==="jed"){for(const l in i)if(i.hasOwnProperty(l)&&l!==""){for(let y=2;y<i[l].length;y++)i[l][y]===""&&(i[l][y]=i[l][0]);i[l].shift()}}n.locale_data[f.domain]=i,n.locale_data[f.domain][""]={domain:f.domain,plural_forms:i[""]["plural-forms"],lang:i[""].language},i=n}return f.stringify?JSON.stringify(i,null,f.pretty?"   ":null):i}})),Zn=It(Kn());function Qn(o){if(typeof o=="function")return o;const t=o?.default;return typeof t=="function"?t:void 0}function ea(o){if(!(o==null||typeof o!="object"||Array.isArray(o)))return o}function ta(o){const t=Qn(Zn.default)?.(o,{format:"jed",fuzzy:!0,domain:"default"});return ea(t?.locale_data?.default)}var ra="1.1.103";ct.parsePoCatalog=ta,ct.version=ra});
+`),this._charset)}})),Hn=R(((o,t)=>{var e=je(),u=st();t.exports=function(p,h){return new f(p,h).parse()};function f(p,h){this._fileContents=p,this._writeFunc="writeUInt32LE",this._readFunc="readUInt32LE",this._charset=h||"iso-8859-1",this._table={charset:this._charset,headers:void 0,translations:{}}}f.prototype.MAGIC=2500072158,f.prototype._checkMagick=function(){return this._fileContents.readUInt32LE(0)===this.MAGIC?(this._readFunc="readUInt32LE",this._writeFunc="writeUInt32LE",!0):this._fileContents.readUInt32BE(0)===this.MAGIC?(this._readFunc="readUInt32BE",this._writeFunc="writeUInt32BE",!0):!1},f.prototype._loadTranslationTable=function(){for(var p=this._offsetOriginals,h=this._offsetTranslations,i,r,s,n,l=0;l<this._total;l++)r=this._fileContents[this._readFunc](p),p+=4,i=this._fileContents[this._readFunc](p),p+=4,s=this._fileContents.slice(i,i+r),r=this._fileContents[this._readFunc](h),h+=4,i=this._fileContents[this._readFunc](h),h+=4,n=this._fileContents.slice(i,i+r),!l&&!s.toString()&&this._handleCharset(n),s=e.convert(s,"utf-8",this._charset).toString("utf-8"),n=e.convert(n,"utf-8",this._charset).toString("utf-8"),this._addString(s,n);this._fileContents=null},f.prototype._handleCharset=function(p){var h=p.toString(),i;(i=h.match(/[; ]charset\s*=\s*([\w-]+)/i))&&(this._charset=this._table.charset=u.formatCharset(i[1],this._charset)),p=e.convert(p,"utf-8",this._charset).toString("utf-8"),this._table.headers=u.parseHeader(p)},f.prototype._addString=function(p,h){var i={},r,s,n;p=p.split(""),p.length>1?(s=p.shift(),i.msgctxt=s):s="",p=p.join(""),r=p.split("\0"),p=r.shift(),i.msgid=p,(n=r.join("\0"))&&(i.msgid_plural=n),h=h.split("\0"),i.msgstr=[].concat(h||[]),this._table.translations[s]||(this._table.translations[s]={}),this._table.translations[s][p]=i},f.prototype.parse=function(){return this._checkMagick()?(this._revision=this._fileContents[this._readFunc](4),this._total=this._fileContents[this._readFunc](8),this._offsetOriginals=this._fileContents[this._readFunc](12),this._offsetTranslations=this._fileContents[this._readFunc](16),this._loadTranslationTable(),this._table):!1}})),Jn=R(((o,t)=>{var e=ot().Buffer,u=je(),f=st();t.exports=function(h){return new p(h).compile()};function p(h){this._table=h||{},this._table.headers=this._table.headers||{},this._table.translations=this._table.translations||{},this._translations=[],this._writeFunc="writeUInt32LE",this._handleCharset()}p.prototype.MAGIC=2500072158,p.prototype._handleCharset=function(){var h=(this._table.headers["content-type"]||"text/plain").split(";"),i=h.shift(),r=f.formatCharset(this._table.charset),s=[];s=h.map(function(n){var l=n.split("="),y=l.shift().trim(),g=l.join("=");return y.toLowerCase()==="charset"?(r||(r=f.formatCharset(g.trim()||"utf-8")),"charset="+r):n}),r||(r=this._table.charset||"utf-8",s.push("charset="+r)),this._table.charset=r,this._table.headers["content-type"]=i+"; "+s.join("; "),this._charset=r},p.prototype._generateList=function(){var h=[];return h.push({msgid:e.alloc(0),msgstr:u.convert(f.generateHeader(this._table.headers),this._charset)}),Object.keys(this._table.translations).forEach(function(i){typeof this._table.translations[i]=="object"&&Object.keys(this._table.translations[i]).forEach(function(r){if(typeof this._table.translations[i][r]=="object"&&!(i===""&&r==="")){var s=this._table.translations[i][r].msgid_plural,n=r,l;i&&(n=i+""+n),s&&(n+="\0"+s),l=[].concat(this._table.translations[i][r].msgstr||[]).join("\0"),h.push({msgid:u.convert(n,this._charset),msgstr:u.convert(l,this._charset)})}}.bind(this))}.bind(this)),h},p.prototype._calculateSize=function(h){var i=0,r=0,s=0;return h.forEach(function(n){i+=n.msgid.length+1,r+=n.msgstr.length+1}),s=28+8*h.length+8*h.length+i+r,{msgid:i,msgstr:r,total:s}},p.prototype._build=function(h,i){var r=e.alloc(i.total),s=0,n,l;for(r[this._writeFunc](this.MAGIC,0),r[this._writeFunc](0,4),r[this._writeFunc](h.length,8),r[this._writeFunc](28,12),r[this._writeFunc](28+8*h.length,16),r[this._writeFunc](0,20),r[this._writeFunc](28+8*h.length*2,24),s=28+16*h.length,n=0,l=h.length;n<l;n++)h[n].msgid.copy(r,s),r[this._writeFunc](h[n].msgid.length,28+n*8),r[this._writeFunc](s,28+n*8+4),r[s+h[n].msgid.length]=0,s+=h[n].msgid.length+1;for(n=0,l=h.length;n<l;n++)h[n].msgstr.copy(r,s),r[this._writeFunc](h[n].msgstr.length,28+8*h.length+n*8),r[this._writeFunc](s,28+8*h.length+n*8+4),r[s+h[n].msgstr.length]=0,s+=h[n].msgstr.length+1;return r},p.prototype.compile=function(){var h=this._generateList(),i=this._calculateSize(h);return h.sort(function(r,s){return r.msgid>s.msgid?1:r.msgid<s.msgid?-1:0}),this._build(h,i)}})),Xn=R(((o,t)=>{var e=Yn();t.exports={po:{parse:e.parse,createParseStream:e.stream,compile:Vn()},mo:{parse:Hn(),compile:Jn()}}})),Kn=R(((o,t)=>{var e=Wn();t.exports=function(u,f){f=f||{};const p={pretty:!1,fuzzy:!1,stringify:!1,format:"raw",domain:"messages",charset:"utf8",fullMF:!1,mfOptions:{}};for(const n in p)f[n]=typeof f[n]<"u"?f[n]:p[n];let h={},i={};if(f.format==="mf"){const n=u.toString().includes('"Plural-Forms:')?f.mfOptions:Object.assign({},{pluralFunction:()=>0},f.mfOptions);return i=Object.keys(n).length>0?e.parsePo(u,n):e.parsePo(u),f.fullMF?f.stringify?JSON.stringify(i,null,f.pretty?"   ":null):i:(i&&(i.translations&&i.translations[""]?(h=i.translations[""],Object.keys(i.translations).forEach(function(l){l===""?Object.keys(i.translations[""]).forEach(function(y){h[y]=i.translations[""][y]}):h[l]=i.translations[l]})):h=i.translations||{}),f.stringify?JSON.stringify(h,null,f.pretty?"   ":null):h)}const r=Xn().po.parse(u,p.charset),s=r.translations;if(Object.keys(s).forEach(function(n){const l=r.translations[n],y=r.headers?r.headers["plural-forms"]:"";Object.keys(l).forEach(function(g,b){const w=l[g],v=n.length?n+""+g:g,B=w.comments&&w.comments.flag&&w.comments.flag.match(/fuzzy/)!==null;(!B||f.fuzzy)&&(f.format==="jed"?i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgstr):y==="nplurals=1; plural=0;"?(msgstr=w.msgid_plural?[w.msgstr]:w.msgstr,i[v]=[w.msgid_plural?w.msgid_plural:null].concat(msgstr)):i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgstr)),f["fallback-to-msgid"]&&(B&&!f.fuzzy||w.msgstr[0]==="")&&(i[v]=[w.msgid_plural?w.msgid_plural:null].concat(w.msgid_plural?[g,w.msgid_plural]:[g]))})}),r.headers&&(i[""]=r.headers),f.format==="mf"&&delete i[""],f.format.indexOf("jed")===0){const n={domain:f.domain,locale_data:{}};if(f.format==="jed"){for(const l in i)if(i.hasOwnProperty(l)&&l!==""){for(let y=2;y<i[l].length;y++)i[l][y]===""&&(i[l][y]=i[l][0]);i[l].shift()}}n.locale_data[f.domain]=i,n.locale_data[f.domain][""]={domain:f.domain,plural_forms:i[""]["plural-forms"],lang:i[""].language},i=n}return f.stringify?JSON.stringify(i,null,f.pretty?"   ":null):i}})),Zn=It(Kn());function Qn(o){if(typeof o=="function")return o;const t=o?.default;return typeof t=="function"?t:void 0}function ea(o){if(!(o==null||typeof o!="object"||Array.isArray(o)))return o}function ta(o){const t=Qn(Zn.default)?.(o,{format:"jed",fuzzy:!0,domain:"default"});return ea(t?.locale_data?.default)}var ra="1.1.108";ct.parsePoCatalog=ta,ct.version=ra});

package/emailmaker.d.ts

@@ -275,9 +275,25 @@ interface IFrameErrorEntry {
   /** The canvas instance that reported the error; a reloaded canvas gets a new one. */
   instance?: string;
 }
+/** A node of foreign structure: tag and class only, never the content. */
+interface IFrameForeignNodeInfo {
+  tag: string;
+  class?: string;
+}
+/** What a commit was about to carry into the email text from nodes the canvas does not own. */
+interface IFrameForeignStructureInfo {
+  /** Kind of the first finding: `inserted`, `moved`, `moved-own-node`, `attribute`, `text` or `implicit-tbody`. */
+  kind: string;
+  /** Distinct kinds of all findings of the commit. */
+  kinds: string[];
+  /** How many findings the commit had. */
+  count: number;
+  node: IFrameForeignNodeInfo;
+  parent?: IFrameForeignNodeInfo;
+}
 /** A canvas sync drift found without a parsing error. Positions and lengths only, never the email markup. */
 interface IFrameSyncDriftInfo {
-  /** `tree-node-out-of-place`, `host-copy-drift` and so on. */
+  /** `tree-node-out-of-place`, `host-copy-drift`, `foreign-structure-in-commit`, `implicit-tbody-in-canvas` and so on. */
   reason: string;
   /** Where the drift was noticed, when a reason has several places. */
   at?: string;
@@ -288,6 +304,8 @@ interface IFrameSyncDriftInfo {
     ownLength: number;
     cachedLength: number;
   };
+  /** The foreign structure a commit met; set for `foreign-structure-in-commit` and `implicit-tbody-in-canvas`. */
+  foreign?: IFrameForeignStructureInfo;
 }
 interface IFrameErrorInfo {
   /** `parse-error` when absent; `sync-drift` is a warning report with nothing rolled back. */
@@ -649,6 +667,8 @@ export declare namespace ExportedApi {
     date_gmt?: string | null;
     /** The unique identifier of the record. */
     id?: string;
+    /** Set by the editor: `true` while the block has not been saved yet and has no `id`. */
+    isNew?: boolean;
     /**
      * The URL of the record.
      * @format uri
@@ -849,6 +869,8 @@ export declare namespace ExportedApi {
     date_gmt?: string | null;
     /** Unique identifier of the record. */
     id?: string;
+    /** Set by the editor: `true` while the email has not been saved yet and has no `id`. */
+    isNew?: boolean;
     /** The name of the letter. */
     title?: string;
     /** Preheader of the letter. */
@@ -1310,6 +1332,13 @@ export declare namespace ExportedApi {
     };
     /** Local “upload from computer” entry in Image Center. */
     imageCenterLocalUploadEnabled: boolean;
+    /**
+     * Insert a link from the Image Center URL field (image and background pickers) into the email as is:
+     * the image is neither downloaded nor uploaded to storage, `handleLoadImage` is not called. A pasted
+     * link goes in right away, a typed one on Enter. Stock and GIF tabs are not affected; with
+     * `imageCenterFileManagerView: true` the field is absent and the option has no effect. Default `false`.
+     */
+    imageCenterInsertUrlAsIs?: boolean;
     /** Stock photo tab in Image Center / file manager. */
     imageCenterStockEnabled: boolean;
     /** GIF / animated stock tab in Image Center. */
@@ -1421,6 +1450,11 @@ export declare namespace ExportedApi {
     blocksSearchEnabled?: boolean;
     /** showing the panel for adding a block in the visual editor */
     blocksAddPanelEnabled?: boolean;
+    /**
+     * Plugin: «Edit block» in the block library of the email editor opens the block editor over the
+     * email (see `openBlock`). Default `false` — the item is not shown. Does not affect `openBlock()` itself.
+     */
+    openBlockFromEmailEnabled?: boolean;
     /** Read-only templates: forbid structure edits beyond allowed regions. */
     lockEditor?: boolean;
     /** Disables editing of preheader / title chrome when integrated with locking flows. */
@@ -1635,15 +1669,26 @@ export declare namespace ExportedApi {
 export declare namespace ExportedApi {
   namespace DataMixin {
     type BlockShowOptions = {
-      /** block content */
+      /**
+       * block content: an entity, or a string with the block code. A block given as `{ id }` only is
+       * read through `handleReadBlock`, falling back to `handleReadBlocks`.
+       */
       block: Block | string;
-      /** autosaves */
+      /**
+       * Re-read the block instead of applying the passed fields over the open session — the same
+       * command as {@link EmailShowOptions.reload}. Showing the same block again keeps the editing
+       * session by default; with this flag the session is closed, `handleReadBlock` is called again,
+       * the undo history and the dirty mark are reset, and anything passed along is applied on top of
+       * what was read. Only meaningful together with a block id.
+       */
+      reload?: boolean;
+      /** the block's autosaves (same role as `autosaves` of an email): unsaved work is recovered from the newest one */
       revisions?: BlockRevision[];
-      /** comments */
-      comments?: Comment[];
       /** blocks */
       blocks?: Block[];
-      /** template identifier for email */
+      /** @deprecated Ignored for blocks: comments belong to emails. */
+      comments?: Comment[];
+      /** @deprecated Ignored for blocks: templates belong to emails. */
       templateId?: string | number;
     };
     type EmailShowOptions = {
@@ -1661,18 +1706,35 @@ export declare namespace ExportedApi {
        * Only meaningful together with an email id: a show without an id always starts a new draft.
        */
       reload?: boolean;
-      /** autosaves */
+      /** the email's autosaves: unsaved work is recovered from the newest one */
       autosaves?: EmailRevision[];
       /** comments */
       comments?: Comment[];
       /** blocks */
       blocks?: Block[];
-      /** template identifier for block */
+      /** template identifier for the email */
       templateId?: number;
     };
-    type Content = string | Email | EmailShowOptions;
+    /**
+     * What to show: an email (code, entity or {@link EmailShowOptions}) or a block ({@link BlockShowOptions}).
+     * A block given as `{ id }` only is read through `handleReadBlock`, falling back to `handleReadBlocks`.
+     */
+    type Content = string | Email | EmailShowOptions | BlockShowOptions;
     type ReadEmailHandler = (id: string) => MayBePromise<Email>;
+    /** Reads one block by id; return nothing when the block does not exist. */
+    type ReadBlockHandler = (id: string) => MayBePromise<Block | undefined>;
+    /** Block navigation payload: the block that was opened or closed. */
+    type BlockNavigationPayload = {
+      block: Block;
+      /** Set on close: the block had changes that were not saved. */
+      hasUnsavedChanges?: boolean;
+    };
+    type BlockNavigationHandler = AppListener<BlockNavigationPayload>;
+    type BlockHandler = AppListener<Block>;
     type ReadEmailAutosavesHandler = (emailId: string) => MayBePromise<EmailRevision[]>;
+    /** Reads a block's autosaves; return an empty list when there are none. */
+    type ReadBlockAutosavesHandler = (blockId: string) => MayBePromise<BlockRevision[]>;
+    type ReadBlockAutosaveHandler = (blockId: string) => MayBePromise<BlockRevision | null | undefined>;
     type ReadEmailAutosaveHandler = (emailId: string) => MayBePromise<EmailRevision | null | undefined>;
     type ReadBlocksHandler = (project: string) => MayBePromise<Block[]>;
     type ReadTemplateBlocksHandler = (block: {
@@ -1733,6 +1795,34 @@ export declare namespace ExportedApi {
       handleReadTemplateBlocks: AppEvent<ReadTemplateBlocksHandler>;
       /** read blocks handler */
       handleReadBlocks: AppEvent<ReadBlocksHandler>;
+      /** read one block by id; optional — without it the block is looked up via `handleReadBlocks` */
+      handleReadBlock: AppEvent<ReadBlockHandler>;
+      /** fires when a block editor is opened over the current email (`openBlock` or "Edit block") */
+      handleOpenBlock: AppEvent<BlockNavigationHandler>;
+      /**
+       * fires when the user leaves the block editor ("Back" or `closeBlock`); a block opened over an email
+       * is closed and the email is back, otherwise the editor stays on the block and the host decides
+       */
+      handleCloseBlock: AppEvent<BlockNavigationHandler>;
+      /** read a block's autosaves (block editor history and recovery) */
+      handleReadBlockRevisions: AppEvent<ReadBlockAutosavesHandler>;
+      /**
+       * Returns the latest autosave snapshot of the block, or `null` if there is none. Optional: when it
+       * is set, the editor recovers unsaved work from it; without it the editor looks for the newest
+       * revision with `autosave: true` in `handleReadBlockRevisions`. Either way the snapshot is
+       * recovered only if it is newer than the block's `modified`.
+       */
+      handleReadBlockAutosave: AppEvent<ReadBlockAutosaveHandler>;
+      /** fires when the open block is autosaved */
+      handleBlockAutosave: CreateEvent<BlockRevision>;
+      /** fires when a block autosave is deleted */
+      handleRemoveBlockAutoSave: RemoveEvent<BlockRevision>;
+      /** fires when the block is shown in the editor (its content is on the canvas) */
+      handleBlockInit: AppEvent<BlockHandler>;
+      /** fires when the open block changes (content or fields), debounced like `handleEmailChanged` */
+      handleBlockChanged: AppEvent<BlockHandler>;
+      /** fires when the user asks to clone the open block */
+      handleCloneBlock: AppEvent<BlockHandler>;
       /** fires when block save */
       handleSaveBlock: SaveEvent<Block>;
       /** fires when block delete */
@@ -1743,8 +1833,13 @@ export declare namespace ExportedApi {
       handleSaveComment: SaveEvent<Comment>;
       /** fires when comment delete */
       handleRemoveComment: RemoveEvent<Comment>;
-      /** fires when user clicked on 'save' button */
-      handleSaveButtonClick: AppEvent<EmailHandler>;
+      /** fires when user clicked on 'save' button of the email; return `false` to cancel the save */
+      handleSaveButtonClick: AppEvent<AppListener<Email, false | void>>;
+      /**
+       * fires when user asked to save the open block (the 'save' button or Ctrl+S); return `false` to
+       * cancel the save. The block counterpart of {@link handleSaveButtonClick}.
+       */
+      handleSaveBlockButtonClick: AppEvent<AppListener<Block, false | void>>;
       /** fires when user clicked on 'next' button */
       handleNextButtonClick: AppEvent<EmailHandler>;
       /** fires when user clicked on 'previous' button */
@@ -1787,11 +1882,33 @@ export declare namespace ExportedApi {
     interface Instance extends Events {
       /**
        * show block or email
+       *
+       * A string is code: `show('<html>…')` shows email code, `show({ block: '<div em="block">…' })` shows
+       * block code. `show({ block })` replaces what is open and fires no navigation events; to open a block
+       * over the email and come back to it, use {@link openBlock}.
        * @param content entity content
        */
       show(content: Content): Promise<void>;
       /**
-       * Save the current email. Resolves with the saved email; rejects when the save did not happen:
+       * open a block editor over the current email; the email stays open and comes back on {@link closeBlock}
+       * @param block block id or entity. Unlike `show({ block })`, a string here is an id, not code; it is
+       * read through `handleReadBlock`, falling back to `handleReadBlocks`
+       */
+      openBlock(block: string | Block): Promise<void>;
+      /**
+       * show a block in place of what is open — the same as `show({ block, ...options })`
+       * @param block block entity, or block code as a string (unlike {@link openBlock}, where a string is an id)
+       * @param options `reload`, `blocks`, `revisions` — as in `BlockShowOptions`
+       */
+      showBlock(block: string | Block, options?: Omit<DataMixin.BlockShowOptions, 'block'>): Promise<void>;
+      /** leave the block editor: a block opened by {@link openBlock} is closed and the email is back */
+      closeBlock(): Promise<void>;
+      /**
+       * Save the email. While a block is open over the email (see {@link openBlock}), the email under it is
+       * saved; the block is saved with {@link saveBlock}. Rejects when there is no email to save (only a block
+       * is shown with {@link showBlock}).
+       *
+       * Resolves with the saved email; rejects when the save did not happen:
        * - the error thrown (or the rejection) of your `handleSaveEmail`, passed through unchanged;
        * - {@link errors.IntegratorSaveTimeoutError} — `handleSaveEmail` did not settle in time;
        * - {@link errors.SaveRefusedError} — the save was refused by a rule (`reason`: `'locked'`, `'too-many-tags'`, `'empty-content'`).
@@ -1799,6 +1916,12 @@ export declare namespace ExportedApi {
        * Tell them apart with `instanceof` against `errors.*` or by `error.name`.
        */
       save(): Promise<Email>;
+      /**
+       * Save the open block through `handleSaveBlock`. Rejects when no block is open; also rejects with the
+       * error of your `handleSaveBlock`, or with {@link errors.IntegratorSaveTimeoutError} when it did not
+       * settle in time.
+       */
+      saveBlock(): Promise<Block>;
       /**
        * get the open email's fields without compiling it
        *
@@ -1807,6 +1930,14 @@ export declare namespace ExportedApi {
        * `preheader` does not require a compilation.
        */
       getEmailSnapshot(): Promise<Email>;
+      /**
+       * get the open block's fields without saving it
+       *
+       * The block counterpart of {@link getEmailSnapshot}: the same entity {@link save} would send, read
+       * from the editor as it is now. Resolves to `null` when no block is open — while the block editor
+       * is closed, `getEmailSnapshot` describes what is open.
+       */
+      getBlockSnapshot(): Promise<Block | null>;
       /**
        * get email from inner storage
        *
@@ -3402,4 +3533,4 @@ export declare namespace helpers {
    */
   export function mapHttpStatusToErrorCode(status: number, defaultCode?: FileManagerErrorCode): FileManagerErrorCode;
 }
-export { ApiPaginationResponse, AppEvent, AppListener, BatchResult, BlockDesc, COMMON_STYLES, CommonStyles, CommonStylesBlock, CommonStylesBorder, CommonStylesBorderRadius, CommonStylesBorderSide, CommonStylesButton, CommonStylesCard, CommonStylesHeading, CommonStylesLink, CommonStylesPadding, CommonStylesText, Config, CreateEvent, CreateEventPayload, CreateListener, EditHistorySnapshot, EditStepChangeInfo, EditStepInfo, EditorStartFailedError, EmailDesc, ExtractPluginOptions, notification_d_exports as FileManager, FileManagerApiErrorInfo, FileSystemItem, FileSystemItemUpdate, GetFileDataOptions, IFrameErrorCause, IFrameErrorEntry, IFrameErrorInfo, IFrameErrorMutationInfo, IFrameErrorNodeInfo, IFrameErrorSource, IFrameSyncDriftInfo, IPlugin, IPluginConstructor, IUndoRedoService, Instance, InstanceOfPluginType, MayBePromise, MergeTag, MergeTagGroup, MergeTagItem, ModulePluginDescriptor, NotifyEvent, OperationResult, Options, ParsedAMP, PluginClassConstructor, PluginDescriptor, PluginEntryItem, PluginFunctionConstructor, PluginLoader, PluginRegistry, PluginTypeMap, PreloadOptions, PromiseWrap, RecursivePartial, RegistryPluginDescriptor, RemoveEvent, RemoveEventPayload, RemoveListener, SaveEvent, SaveEventPayload, SaveListener, SortState, StorageProvider, StorageProviderController, UploadFileItemInput, UploadFilesRequest, WindowPluginDescriptor, create, getInstance, init, parseAMP, pluginRegistry, preload, version };
+export { ApiPaginationResponse, AppEvent, AppListener, BatchResult, BlockDesc, COMMON_STYLES, CommonStyles, CommonStylesBlock, CommonStylesBorder, CommonStylesBorderRadius, CommonStylesBorderSide, CommonStylesButton, CommonStylesCard, CommonStylesHeading, CommonStylesLink, CommonStylesPadding, CommonStylesText, Config, CreateEvent, CreateEventPayload, CreateListener, EditHistorySnapshot, EditStepChangeInfo, EditStepInfo, EditorStartFailedError, EmailDesc, ExtractPluginOptions, notification_d_exports as FileManager, FileManagerApiErrorInfo, FileSystemItem, FileSystemItemUpdate, GetFileDataOptions, IFrameErrorCause, IFrameErrorEntry, IFrameErrorInfo, IFrameErrorMutationInfo, IFrameErrorNodeInfo, IFrameErrorSource, IFrameForeignNodeInfo, IFrameForeignStructureInfo, IFrameSyncDriftInfo, IPlugin, IPluginConstructor, IUndoRedoService, Instance, InstanceOfPluginType, MayBePromise, MergeTag, MergeTagGroup, MergeTagItem, ModulePluginDescriptor, NotifyEvent, OperationResult, Options, ParsedAMP, PluginClassConstructor, PluginDescriptor, PluginEntryItem, PluginFunctionConstructor, PluginLoader, PluginRegistry, PluginTypeMap, PreloadOptions, PromiseWrap, RecursivePartial, RegistryPluginDescriptor, RemoveEvent, RemoveEventPayload, RemoveListener, SaveEvent, SaveEventPayload, SaveListener, SortState, StorageProvider, StorageProviderController, UploadFileItemInput, UploadFilesRequest, WindowPluginDescriptor, create, getInstance, init, parseAMP, pluginRegistry, preload, version };