useblocks 1.1.85-dev.9 → 1.1.102

package/{useblocks-po.bb6d921f.js → useblocks-po.1c4e77a0.js}

@@ -42,4 +42,4 @@ __useblocks__.define("po",["require","exports","module"],function(na,ct,aa){Obje
 
 `),"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.85-dev.9";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.102";ct.parsePoCatalog=ta,ct.version=ra});

package/useblocks.d.ts

@@ -227,15 +227,65 @@ interface EditStepChangeInfo {
 interface EditStepInfo {
   changes: EditStepChangeInfo[];
 }
+/** A node of the mutation a layout parsing error failed on. Tag paths only, never the email markup. */
+interface IFrameErrorNodeInfo {
+  /** A few ancestors and the node itself: tag, id, classes and the `em` attribute. */
+  path: string;
+  /** Whether every ancestor up to the document root lists the node among its children. */
+  inTree: boolean;
+  /** Whether the node is mapped to an element that is connected to the canvas DOM. */
+  inDom: boolean;
+  /** The same kind of path, taken from the canvas DOM. */
+  domPath?: string;
+}
+/** The mutation a layout parsing error failed on. */
+interface IFrameErrorMutationInfo {
+  /** `insertBefore`, `remove`, `set`, `hidden`, `attribute` and so on. */
+  type: string;
+  node: IFrameErrorNodeInfo;
+  parent?: IFrameErrorNodeInfo;
+  /** The node the insertion was anchored to. */
+  reference?: IFrameErrorNodeInfo;
+}
+/** One layout parsing error of a series. */
+interface IFrameErrorEntry {
+  message: string;
+  stack: string;
+  mutation?: IFrameErrorMutationInfo;
+}
+/** 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. */
+  reason: string;
+  /** Where the drift was noticed, when a reason has several places. */
+  at?: string;
+  mutation?: IFrameErrorMutationInfo;
+  /** The first mismatch between the canvas text and the host copy, and both lengths. */
+  text?: {
+    offset: number;
+    ownLength: number;
+    cachedLength: number;
+  };
+}
 interface IFrameErrorInfo {
-  /** Undone steps that can be redone. Most recent first. */
+  /** `parse-error` when absent; `sync-drift` is a warning report with nothing rolled back. */
+  kind?: 'parse-error' | 'sync-drift';
+  /** Undone steps that can be redone, as of the first error of the series. Most recent first. */
   future: EditStepInfo[];
-  /** Steps applied before the error. Most recent first, as those matter more than the oldest. */
+  /** Steps applied before the first error of the series, before any rollback. Most recent first. */
   past: EditStepInfo[];
   errorResolved: boolean;
+  /** The last error of the series; `errors` lists all of them. */
   message: string;
+  /** Document content at the first error of the series, before any rollback. */
   text: string;
   stack: string;
+  /** Every error of the series, in the order they arrived. */
+  errors?: IFrameErrorEntry[];
+  /** The drift a `sync-drift` report is about. */
+  drift?: IFrameSyncDriftInfo;
+  /** The mutation a `sync-drift` report is about, if the canvas reported it. */
+  mutation?: IFrameErrorMutationInfo;
   userId: string;
   entityId: string;
   entityType: 'email' | 'block';
@@ -404,19 +454,22 @@ export declare namespace Notify {
     BLOCK_EDITING_ERROR: BlockDesc;
     EMAIL_AUTOSAVE_ERROR: ExportedApi.EmailRevision;
     EMAIL_INIT_EVENT_ERROR: EmailDesc;
-    /**
-     * The template named by `templateId` could not be read; the email opens without it. The editor shows
-     * no toast for it — handle it in `handleNotify` if the user should know.
-     */
-    TEMPLATE_READ_ERROR: {
-      templateId: string;
-    };
     SAVE_BUTTON_CLICK_EVENT_ERROR: EmailDesc;
     NEXT_BUTTON_CLICK_EVENT_ERROR: EmailDesc;
     BLOCK_REMOVING_ERROR: BlockDesc;
     IFRAME_ERROR: IFrameErrorInfo;
     GET_LOCALE_ERROR: any;
     GET_LOCALES_ERROR: any;
+    /** A plugin constructor threw; the plugin is skipped, the editor starts without it. */
+    PLUGIN_CREATE_ERROR: {
+      plugin: string;
+    };
+    /** A plugin script or loader failed; the plugin is skipped and the editor starts without it. */
+    PLUGIN_LOAD_ERROR: {
+      plugin: string;
+      url?: string;
+      message: string;
+    };
   }
   /**
    * FM_* error ids from FileManager (mapped when resolved).
@@ -520,6 +573,14 @@ export declare namespace Notify {
   interface WarningMap {
     COPY_NOT_SAVED_BLOCK: ExportedApi.Block;
     EMAIL_TITLE_UPDATED: string;
+    /**
+     * The template named by `templateId` could not be read; the email opens without it. A warning, not an
+     * error: it does not reach `handleError`, and the editor shows no toast for it — handle it in
+     * `handleNotify` if the user should know.
+     */
+    TEMPLATE_READ_ERROR: {
+      templateId: string;
+    };
   }
   type FMWarningMap = FM_Notifications<Notify$1.WarningMap>;
   /**
@@ -629,6 +690,12 @@ export declare namespace ExportedApi {
      * snapshots it autosaves; store it as is.
      */
     autosave?: boolean;
+    /**
+     * The alphanumeric identifier of the record is unique for its type.
+     * @deprecated Mark autosave snapshots with `autosave: true` instead. A `slug` that contains
+     * `autosave` is still treated as an autosave snapshot.
+     */
+    slug?: string;
     /** The name of the entry. */
     title?: string;
     /** An excerpt of the recording. */
@@ -830,6 +897,12 @@ export declare namespace ExportedApi {
      * unsaved work.
      */
     autosave?: boolean;
+    /**
+     * The alphanumeric identifier of the record is unique for its type.
+     * @deprecated Mark autosave snapshots with `autosave: true` instead. A `slug` that contains
+     * `autosave` is still treated as an autosave snapshot.
+     */
+    slug?: string;
   }
   interface CompiledEmailRevision extends EmailRevision {
     readonly compiled: {
@@ -1503,6 +1576,22 @@ export declare namespace ExportedApi {
      * fine — hiding the canvas itself is our job, not yours.
      */
     hidden?: boolean;
+    /**
+     * Who owns the editor in `element` when `init()`/`create()` is called into it more than once.
+     *
+     * - `'single'` (default, as in 1.1.89): one instance object per element. A repeated call into the
+     *   same element returns that same object and applies its options like `setConfig`: handlers are
+     *   swapped at once, and the email is shown again only if it differs from the one you set last
+     *   (via `init`, `show` or `reset`). A repeated call made while the previous one is still starting
+     *   supersedes it: the previous promise rejects with an `AbortError`. `destroy()` through any
+     *   reference destroys the editor.
+     * - `'counted'`: every call gets its own instance object over the shared editor and holds a share in
+     *   it; overlapping calls all succeed. The object keeps its own subscriptions until its `destroy()`,
+     *   which releases only its share. The editor is destroyed shortly after the last share is released
+     *   (so a React StrictMode remount keeps it). A call without the flag into the same element holds the
+     *   editor until its own `destroy()`, and that `destroy()` ends the counted objects too.
+     */
+    ownership?: 'single' | 'counted';
     /**
      * Fires once the editor's code is loaded. Called once per `init()`/`create()`/`reset()` options;
      * options applied after the code is already loaded (e.g. reusing a running editor) get it right away.
@@ -1676,7 +1765,14 @@ export declare namespace ExportedApi {
        * @param content entity content
        */
       show(content: Content): Promise<void>;
-      /** save current  email */
+      /**
+       * Save the current email. 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'`).
+       *
+       * Tell them apart with `instanceof` against `errors.*` or by `error.name`.
+       */
       save(): Promise<Email>;
       /**
        * get the open email's fields without compiling it
@@ -2887,6 +2983,7 @@ export declare namespace ExportedApi {
     interface Instance {
       /**
        * An instance of `IUndoRedoService` that manages undo and redo operations.
+       * Available from the plugin constructor on; until an email is open there is nothing to undo.
        */
       undoRedoService: IUndoRedoService;
     }
@@ -3080,28 +3177,29 @@ export declare namespace ExportedApi {
 }
 /**
  * Editor instance returned by {@link create} and {@link init}; merged from all `ExportedApi.Instance`
- * declarations. `create()` returns it right away, before the editor is initialised, so handlers and
- * your own code can hold it from the start.
+ * declarations. A plain object: every member is an own enumerable property, so `Object.keys`, spread
+ * and `Object.assign` see it, and any method can be replaced. `create()` returns it right away, before
+ * the editor is initialised, so handlers and your own code can hold it from the start.
  *
  * Until `ready`: event subscriptions are kept and attached before the first event; async methods wait
  * for `ready`; `setEmailMeta`, `setBlockMeta` and `notify` are applied once ready, in order;
  * `getElement` returns the element from options (when passed as an element) and `getCodeErrors` an
- * empty list; `getConfig`, `use`, `container` and `undoRedoService` throw — use `useAsync()` or await
- * `ready`. Calls made from handlers (e.g. `compileEmail()` inside `handleEmailInit`) already reach the
- * editor. If you need the shown email (e.g. a snapshot via `getEmail()`), await `ready` first.
+ * empty list; `getConfig` and `use` throw — use `useAsync()` or await `ready`; the `container` and
+ * `undoRedoService` fields are `undefined`. Calls made from handlers (e.g. `compileEmail()` inside
+ * `handleEmailInit`) already reach the editor. If you need the shown email (e.g. a snapshot via
+ * `getEmail()`), await `ready` first.
  *
  * `destroy()` before `ready` cancels initialisation.
  *
- * Another `create()`/`init()` into the same element reuses its editor with the new options (waiting for
- * a start still in progress) and returns a new instance object; the editor belongs to the latest call.
- * The earlier instance stops receiving events, and its `destroy()` leaves the editor alone. Its methods
- * keep working while the new call is starting; once the new instance is ready they throw (or reject)
- * with an `EditorReleasedError`. Get the current one with {@link getInstance}. If the new call fails to
- * start (including cancellation via its `signal`), the editor is handed back: the earlier instance works
- * again with its own options, and its email is restored from a snapshot (text and header; undo history
- * is cleared). If the hand-back fails too, the editor is destroyed and the earlier instance throws (or
- * rejects) with an {@link EditorStartFailedError}. `destroy()` of the latest instance destroys the editor,
- * even before its `ready`.
+ * Another `create()`/`init()` into the same element follows `Options.ownership`. By default
+ * (`'single'`) it returns this same object and applies its options like `setConfig`; a call made while
+ * the previous one is still starting supersedes it (the previous promise rejects with an `AbortError`);
+ * `destroy()` through any reference destroys the editor. With `'counted'` every call gets its own object
+ * holding a share in the editor; `destroy()` releases that share. Get the current object with
+ * {@link getInstance}. If a repeated call fails to start (including cancellation via its `signal`), the
+ * editor keeps its previous options and its email is restored from a snapshot (text and header; undo
+ * history is cleared). If that fails too, the editor is destroyed and the earlier objects throw (or
+ * reject) with an {@link EditorStartFailedError}.
  */
 interface Instance extends ExportedApi.Instance {
   /** Resolves with this instance once the editor is initialised (the email from `content` is shown). */
@@ -3190,8 +3288,9 @@ declare function init(options: Options): Promise<Instance>;
  */
 declare function create(options: Options): Instance;
 /**
- * The editor instance that currently owns the element: the latest `create()`/`init()` into it that has
- * not failed or been destroyed. It may still be starting — await its `ready`. `undefined` if there is none.
+ * The editor object of the element: with the default `ownership: 'single'` — the element's shared object;
+ * with `'counted'` — the object of the latest `create()`/`init()` into it that has not failed or been
+ * destroyed. It may still be starting — await its `ready`. `undefined` if there is none.
  * @param element - The element passed as `element` to `create()`/`init()`, or a CSS selector for it.
  */
 declare function getInstance(element: Element | DocumentFragment | string): Instance | undefined;
@@ -3232,6 +3331,41 @@ export declare namespace errors {
     public readonly details?: unknown;
     constructor(message: string, code: FileManagerErrorCode, httpStatus?: number, details?: unknown);
   }
+  /**
+   * `save()` rejected because `handleSaveEmail` did not settle within the save timeout. The email was not saved.
+   * @example
+   * ```ts
+   * try {
+   *   await editor.save();
+   * } catch (error) {
+   *   if (error instanceof errors.IntegratorSaveTimeoutError) {
+   *     // your handler hung — retry or tell the user
+   *   }
+   * }
+   * ```
+   */
+  export class IntegratorSaveTimeoutError extends Error {
+    public readonly name: 'IntegratorSaveTimeoutError';
+    /** The timeout that elapsed, in milliseconds. */
+    public readonly timeoutMs: number;
+    constructor(timeoutMs: number);
+  }
+  /** Why a save was refused before it started. */
+  export type SaveRefusalReason =
+  /** The email is locked and the current user may not edit it. */
+  'locked' |
+  /** The email has more tags than allowed. */
+  'too-many-tags' |
+  /** The editor is empty while the saved email has content; saving would wipe the email. */
+  'empty-content';
+  /**
+   * `save()` rejected by a rule before reaching `handleSaveEmail`; the email was not saved.
+   */
+  export class SaveRefusedError extends Error {
+    public readonly name: 'SaveRefusedError';
+    public readonly reason: SaveRefusalReason;
+    constructor(reason: SaveRefusalReason);
+  }
 }
 export declare namespace helpers {
   /**
@@ -3243,4 +3377,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, IFrameErrorInfo, 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, IFrameErrorEntry, IFrameErrorInfo, IFrameErrorMutationInfo, IFrameErrorNodeInfo, 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 };