useblocks 1.1.85-dev.10 → 1.1.85-dev.11

package/{useblocks-po.8098d114.js → useblocks-po.714faf8a.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.10";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.85-dev.11";ct.parsePoCatalog=ta,ct.version=ra});

package/useblocks.d.ts

@@ -404,19 +404,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 +523,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 +640,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 +847,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 +1526,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 +1715,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 +2933,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 +3127,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 +3238,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 +3281,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 {
   /**