@templatical/editor 0.28.1 → 0.29.0

package/dist/{dist-CQQNoHxz.js → dist-Btz6cFCI.js}

@@ -1,4 +1,4 @@
-import { E as e, G as t, Gn as n, Wn as r, et as i, f as a, fn as o, gn as s, lt as c, nt as l, pn as u, u as d, v as f } from "./dist-DUn6jY0n.js";
+import { E as e, G as t, Gn as n, Wn as r, et as i, f as a, fn as o, gn as s, lt as c, nt as l, pn as u, u as d, v as f } from "./dist-BUh4MT4D.js";
 //#region ../../node_modules/.pnpm/linkifyjs@4.3.3/node_modules/linkifyjs/dist/linkify.mjs
 var p = "aaa1rp3bb0ott3vie4c1le2ogado5udhabi7c0ademy5centure6ountant0s9o1tor4d0s1ult4e0g1ro2tna4f0l1rica5g0akhan5ency5i0g1rbus3force5tel5kdn3l0ibaba4pay4lfinanz6state5y2sace3tom5m0azon4ericanexpress7family11x2fam3ica3sterdam8nalytics7droid5quan4z2o0l2partments8p0le4q0uarelle8r0ab1mco4chi3my2pa2t0e3s0da2ia2sociates9t0hleta5torney7u0ction5di0ble3o3spost5thor3o0s4w0s2x0a2z0ure5ba0by2idu3namex4d1k2r0celona5laycard4s5efoot5gains6seball5ketball8uhaus5yern5b0c1t1va3cg1n2d1e0ats2uty4er2rlin4st0buy5t2f1g1h0arti5i0ble3d1ke2ng0o3o1z2j1lack0friday9ockbuster8g1omberg7ue3m0s1w2n0pparibas9o0ats3ehringer8fa2m1nd2o0k0ing5sch2tik2on4t1utique6x2r0adesco6idgestone9oadway5ker3ther5ussels7s1t1uild0ers6siness6y1zz3v1w1y1z0h3ca0b1fe2l0l1vinklein9m0era3p2non3petown5ital0one8r0avan4ds2e0er0s4s2sa1e1h1ino4t0ering5holic7ba1n1re3c1d1enter4o1rn3f0a1d2g1h0anel2nel4rity4se2t2eap3intai5ristmas6ome4urch5i0priani6rcle4sco3tadel4i0c2y3k1l0aims4eaning6ick2nic1que6othing5ud3ub0med6m1n1o0ach3des3ffee4llege4ogne5m0mbank4unity6pany2re3uter5sec4ndos3struction8ulting7tact3ractors9oking4l1p2rsica5untry4pon0s4rses6pa2r0edit0card4union9icket5own3s1uise0s6u0isinella9v1w1x1y0mru3ou3z2dad1nce3ta1e1ing3sun4y2clk3ds2e0al0er2s3gree4livery5l1oitte5ta3mocrat6ntal2ist5si0gn4v2hl2iamonds6et2gital5rect0ory7scount3ver5h2y2j1k1m1np2o0cs1tor4g1mains5t1wnload7rive4tv2ubai3pont4rban5vag2r2z2earth3t2c0o2deka3u0cation8e1g1mail3erck5nergy4gineer0ing9terprises10pson4quipment8r0icsson6ni3s0q1tate5t1u0rovision8s2vents5xchange6pert3osed4ress5traspace10fage2il1rwinds6th3mily4n0s2rm0ers5shion4t3edex3edback6rrari3ero6i0delity5o2lm2nal1nce1ial7re0stone6mdale6sh0ing5t0ness6j1k1lickr3ghts4r2orist4wers5y2m1o0o0d1tball6rd1ex2sale4um3undation8x2r0ee1senius7l1ogans4ntier7tr2ujitsu5n0d2rniture7tbol5yi3ga0l0lery3o1up4me0s3p1rden4y2b0iz3d0n2e0a1nt0ing5orge5f1g0ee3h1i0ft0s3ves2ing5l0ass3e1obal2o4m0ail3bh2o1x2n1odaddy5ld0point6f2odyear5g0le4p1t1v2p1q1r0ainger5phics5tis4een3ipe3ocery4up4s1t1u0cci3ge2ide2tars5ru3w1y2hair2mburg5ngout5us3bo2dfc0bank7ealth0care8lp1sinki6re1mes5iphop4samitsu7tachi5v2k0t2m1n1ockey4ldings5iday5medepot5goods5s0ense7nda3rse3spital5t0ing5t0els3mail5use3w2r1sbc3t1u0ghes5yatt3undai7ibm2cbc2e1u2d1e0ee3fm2kano4l1m0amat4db2mo0bilien9n0c1dustries8finiti5o2g1k1stitute6urance4e4t0ernational10uit4vestments10o1piranga7q1r0ish4s0maili5t0anbul7t0au2v3jaguar4va3cb2e0ep2tzt3welry6io2ll2m0p2nj2o0bs1urg4t1y2p0morgan6rs3uegos4niper7kaufen5ddi3e0rryhotels6properties14fh2g1h1i0a1ds2m1ndle4tchen5wi3m1n1oeln3matsu5sher5p0mg2n2r0d1ed3uokgroup8w1y0oto4z2la0caixa5mborghini8er3nd0rover6xess5salle5t0ino3robe5w0yer5b1c1ds2ease3clerc5frak4gal2o2xus4gbt3i0dl2fe0insurance9style7ghting6ke2lly3mited4o2ncoln4k2ve1ing5k1lc1p2oan0s3cker3us3l1ndon4tte1o3ve3pl0financial11r1s1t0d0a3u0ndbeck6xe1ury5v1y2ma0drid4if1son4keup4n0agement7go3p1rket0ing3s4riott5shalls7ttel5ba2c0kinsey7d1e0d0ia3et2lbourne7me1orial6n0u2rck0msd7g1h1iami3crosoft7l1ni1t2t0subishi9k1l0b1s2m0a2n1o0bi0le4da2e1i1m1nash3ey2ster5rmon3tgage6scow4to0rcycles9v0ie4p1q1r1s0d2t0n1r2u0seum3ic4v1w1x1y1z2na0b1goya4me2vy3ba2c1e0c1t0bank4flix4work5ustar5w0s2xt0direct7us4f0l2g0o2hk2i0co2ke1on3nja3ssan1y5l1o0kia3rton4w0ruz3tv4p1r0a1w2tt2u1yc2z2obi1server7ffice5kinawa6layan0group9lo3m0ega4ne1g1l0ine5oo2pen3racle3nge4g0anic5igins6saka4tsuka4t2vh3pa0ge2nasonic7ris2s1tners4s1y3y2ccw3e0t2f0izer5g1h0armacy6d1ilips5one2to0graphy6s4ysio5ics1tet2ures6d1n0g1k2oneer5zza4k1l0ace2y0station9umbing5s3m1n0c2ohl2ker3litie5rn2st3r0axi3ess3ime3o0d0uctions8f1gressive8mo2perties3y5tection8u0dential9s1t1ub2w0c2y2qa1pon3uebec3st5racing4dio4e0ad1lestate6tor2y4cipes5d0umbrella9hab3ise0n3t2liance6n0t0als5pair3ort3ublican8st0aurant8view0s5xroth6ich0ardli6oh3l1o1p2o0cks3deo3gers4om3s0vp3u0gby3hr2n2w0e2yukyu6sa0arland6fe0ty4kura4le1on3msclub4ung5ndvik0coromant12ofi4p1rl2s1ve2xo3b0i1s2c0b1haeffler7midt4olarships8ol3ule3warz5ience5ot3d1e0arch3t2cure1ity6ek2lect4ner3rvices6ven3w1x0y3fr2g1h0angrila6rp3ell3ia1ksha5oes2p0ping5uji3w3i0lk2na1gles5te3j1k0i0n2y0pe4l0ing4m0art3ile4n0cf3o0ccer3ial4ftbank4ware6hu2lar2utions7ng1y2y2pa0ce3ort2t3r0l2s1t0ada2ples4r1tebank4farm7c0group6ockholm6rage3e3ream4udio2y3yle4u0cks3pplies3y2ort5rf1gery5zuki5v1watch4iss4x1y0dney4stems6z2tab1ipei4lk2obao4rget4tamotors6r2too4x0i3c0i2d0k2eam2ch0nology8l1masek5nnis4va3f1g1h0d1eater2re6iaa2ckets5enda4ps2res2ol4j0maxx4x2k0maxx5l1m0all4n1o0day3kyo3ols3p1ray3shiba5tal3urs3wn2yota3s3r0ade1ing4ining5vel0ers0insurance16ust3v2t1ube2i1nes3shu4v0s2w1z2ua1bank3s2g1k1nicom3versity8o2ol2ps2s1y1z2va0cations7na1guard7c1e0gas3ntures6risign5mögensberater2ung14sicherung10t2g1i0ajes4deo3g1king4llas4n1p1rgin4sa1ion4va1o3laanderen9n1odka3lvo3te1ing3o2yage5u2wales2mart4ter4ng0gou5tch0es6eather0channel12bcam3er2site5d0ding5ibo2r3f1hoswho6ien2ki2lliamhill9n0dows4e1ners6me2oodside6rk0s2ld3w2s1tc1f3xbox3erox4ihuan4n2xx2yz3yachts4hoo3maxun5ndex5e1odobashi7ga2kohama6u0tube6t1un3za0ppos4ra3ero3ip2m1one3uerich6w2", m = "ελ1υ2бг1ел3дети4ею2католик6ом3мкд2он1сква6онлайн5рг3рус2ф2сайт3рб3укр3қаз3հայ3ישראל5קום3ابوظبي5رامكو5لاردن4بحرين5جزائر5سعودية6عليان5مغرب5مارات5یران5بارت2زار4يتك3ھارت5تونس4سودان3رية5شبكة4عراق2ب2مان4فلسطين6قطر3كاثوليك6وم3مصر2ليسيا5وريتانيا7قع4همراه5پاکستان7ڀارت4कॉम3नेट3भारत0म्3ोत5संगठन5বাংলা5ভারত2ৰত4ਭਾਰਤ4ભારત4ଭାରତ4இந்தியா6லங்கை6சிங்கப்பூர்11భారత్5ಭಾರತ4ഭാരതം5ලංකා4คอม3ไทย3ລາວ3გე2みんな3アマゾン4クラウド4グーグル4コム2ストア3セール3ファッション6ポイント4世界2中信1国1國1文网3亚马逊3企业2佛山2信息2健康2八卦2公司1益2台湾1灣2商城1店1标2嘉里0大酒店5在线2大拿2天主教3娱乐2家電2广东2微博2慈善2我爱你3手机2招聘2政务1府2新加坡2闻2时尚2書籍2机构2淡马锡3游戏2澳門2点看2移动2组织机构4网址1店1站1络2联通2谷歌2购物2通販2集团2電訊盈科4飞利浦3食品2餐厅2香格里拉3港2닷넷1컴2삼성2한국2", h = "numeric", g = "ascii", _ = "alpha", v = "asciinumeric", y = "alphanumeric", b = "domain", x = "emoji", ee = "scheme", S = "slashscheme", C = "whitespace";
 function w(e, t) {
@@ -510,7 +510,7 @@ function yt(e, t = null, n = null) {
 	return a;
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@tiptap+extension-link@3.30.2_@tiptap+core@3.30.2_@tiptap+pm@3.30.2__@tiptap+pm@3.30.2/node_modules/@tiptap/extension-link/dist/index.js
+//#region ../../node_modules/.pnpm/@tiptap+extension-link@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3__@tiptap+pm@3.30.3/node_modules/@tiptap/extension-link/dist/index.js
 var bt = "[\0- \xA0 ᠎ -\u2029 　]", xt = new RegExp(bt), St = RegExp(`${bt}$`), Ct = new RegExp(bt, "g");
 function wt(e) {
 	return e.length === 1 ? e[0].isLink : e.length === 3 && e[1].isLink ? ["()", "[]"].includes(e[0].value + e[2].value) : !1;
@@ -521,8 +521,8 @@ function Tt(i) {
 		appendTransaction: (n, r, a) => {
 			let o = n.some((e) => e.docChanged) && !r.doc.eq(a.doc), s = n.some((e) => e.getMeta("preventAutolink"));
 			if (!o || s) return;
-			let { tr: u } = a, d = e(r.doc, [...n]);
-			if (l(d).forEach(({ newRange: e }) => {
+			let { tr: u } = a;
+			if (l(e(r.doc, [...n])).forEach(({ newRange: e }) => {
 				let n = t(a.doc, e, (e) => e.isTextblock), r, o;
 				if (n.length > 1) r = n[0], o = a.doc.textBetween(r.pos, r.pos + r.node.nodeSize, void 0, " ");
 				else if (n.length) {

package/dist/dist-CCfNhI54.js

@@ -0,0 +1,5 @@
+import { Color as e } from "./dist-DAR13YWM.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-color@3.30.3_@tiptap+extension-text-style@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3__/node_modules/@tiptap/extension-color/dist/index.js
+var t = e;
+//#endregion
+export { e as Color, t as default };

package/dist/{dist-D4Jb08yv.js → dist-CHp21juN.js}

@@ -1,5 +1,5 @@
-import { f as e, gn as t } from "./dist-DUn6jY0n.js";
-//#region ../../node_modules/.pnpm/@tiptap+extension-subscript@3.30.2_@tiptap+core@3.30.2_@tiptap+pm@3.30.2__@tiptap+pm@3.30.2/node_modules/@tiptap/extension-subscript/dist/index.js
+import { f as e, gn as t } from "./dist-BUh4MT4D.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-subscript@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3__@tiptap+pm@3.30.3/node_modules/@tiptap/extension-subscript/dist/index.js
 var n = e.create({
 	name: "subscript",
 	addOptions() {

package/dist/dist-CMcNDUcw.js

@@ -0,0 +1,5 @@
+import { FontFamily as e } from "./dist-DAR13YWM.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-font-family@3.30.3_@tiptap+extension-text-style@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3__/node_modules/@tiptap/extension-font-family/dist/index.js
+var t = e;
+//#endregion
+export { e as FontFamily, t as default };

package/dist/{dist-CLc1cpN2.js → dist-DAR13YWM.js}

@@ -1,5 +1,5 @@
-import { bt as e, f as t, gn as n, s as r } from "./dist-DUn6jY0n.js";
-//#region ../../node_modules/.pnpm/@tiptap+extension-text-style@3.30.2_@tiptap+core@3.30.2_@tiptap+pm@3.30.2_/node_modules/@tiptap/extension-text-style/dist/index.js
+import { bt as e, f as t, gn as n, s as r } from "./dist-BUh4MT4D.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-text-style@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3_/node_modules/@tiptap/extension-text-style/dist/index.js
 var i = 20, a = (e, t = 0) => {
 	let n = [];
 	return !e.children.length || t > i || Array.from(e.children).forEach((e) => {
@@ -9,8 +9,9 @@ var i = 20, a = (e, t = 0) => {
 	if (!e.children.length) return;
 	let t = a(e);
 	t && t.forEach((e) => {
-		let t = e.getAttribute("style"), n = (e.parentElement?.closest("span"))?.getAttribute("style");
-		e.setAttribute("style", `${n};${t}`);
+		var t;
+		let n = e.getAttribute("style"), r = (t = e.parentElement) == null || (t = t.closest("span")) == null ? void 0 : t.getAttribute("style");
+		e.setAttribute("style", `${r};${n}`);
 	});
 }, s = t.create({
 	name: "textStyle",
@@ -41,7 +42,7 @@ var i = 20, a = (e, t = 0) => {
 			removeEmptyTextStyle: () => ({ tr: e }) => {
 				let { selection: t } = e;
 				return e.doc.nodesBetween(t.from, t.to, (t, n) => {
-					if (t.isTextblock) return !0;
+					if (!t.isInline) return !0;
 					t.marks.filter((e) => e.type === this.type).some((e) => Object.values(e.attrs).some((e) => !!e)) || e.removeMark(n, n + t.nodeSize, this.type);
 				}), !0;
 			}

package/dist/{dist-Dx-KOuOj.js → dist-DQ_4a0hb.js}

@@ -1,5 +1,5 @@
-import { f as e, gn as t } from "./dist-DUn6jY0n.js";
-//#region ../../node_modules/.pnpm/@tiptap+extension-underline@3.30.2_@tiptap+core@3.30.2_@tiptap+pm@3.30.2_/node_modules/@tiptap/extension-underline/dist/index.js
+import { f as e, gn as t } from "./dist-BUh4MT4D.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-underline@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3_/node_modules/@tiptap/extension-underline/dist/index.js
 var n = e.create({
 	name: "underline",
 	addOptions() {

package/dist/{dist-Dz7KUOSg.js → dist-q3Puexqv.js}

@@ -1,5 +1,5 @@
-import { bt as e, f as t, fn as n, gn as r, pn as i } from "./dist-DUn6jY0n.js";
-//#region ../../node_modules/.pnpm/@tiptap+extension-highlight@3.30.2_@tiptap+core@3.30.2_@tiptap+pm@3.30.2_/node_modules/@tiptap/extension-highlight/dist/index.js
+import { bt as e, f as t, fn as n, gn as r, pn as i } from "./dist-BUh4MT4D.js";
+//#region ../../node_modules/.pnpm/@tiptap+extension-highlight@3.30.3_@tiptap+core@3.30.3_@tiptap+pm@3.30.3_/node_modules/@tiptap/extension-highlight/dist/index.js
 var a = /(?:^|\s)(==(?!\s+==)((?:[^=]+))==(?!\s+==))$/, o = /(?:^|\s)(==(?!\s+==)((?:[^=]+))==(?!\s+==))/g, s = t.create({
 	name: "highlight",
 	addOptions() {

package/dist/{extensions-PJK0gLCL.js → extensions-BlYe3NFn.js}

@@ -3,9 +3,9 @@ import { a as h, c as g, s as _ } from "./runtime-dom.esm-bundler-CHEsXNQz.js";
 import { D as v, E as y, N as b, a as x } from "./dist-B1kLn1rs.js";
 import { t as S } from "./useI18n-DT_DKupw.js";
 import { t as C } from "./useMergeTag-CcHQCcPN.js";
-import { gn as w, m as T, s as E, u as D, v as O } from "./dist-DUn6jY0n.js";
-import { i as k, r as A, t as j } from "./MergeTagSuggestion-a7Tk8tBB.js";
-import { n as M, t as N } from "./dist-7Lr_A7Va.js";
+import { gn as w, m as T, s as E, u as D, v as O } from "./dist-BUh4MT4D.js";
+import { i as k, r as A, t as j } from "./MergeTagSuggestion-BUozNVtA.js";
+import { n as M, t as N } from "./dist-BpHkLruF.js";
 //#region src/extensions/FontSize.ts
 var P = E.create({
 	name: "fontSize",

package/dist/{image-up-BVOMy_Fs.js → image-up-KRq0lcdU.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("image-up", [
 	["path", {
 		d: "M10.3 21H5a2 2 0 0 1-2-2V5a2 2 0 0 1 2-2h14a2 2 0 0 1 2 2v10l-3.1-3.1a2 2 0 0 0-2.814.014L6 21",

package/dist/index.d.ts

@@ -2,7 +2,8 @@ import type { AiConfig } from '@templatical/types';
 import { BlockDefaults } from '@templatical/types';
 import type { CollaborationConfig } from '@templatical/types';
 import { ColorsConfig } from '@templatical/types';
-import type { CommentEvent } from '@templatical/types';
+import { CommentEventMeta } from '@templatical/types';
+import { CommentsOptions } from '@templatical/types';
 import type { CommentsProvider } from '@templatical/types';
 import { ComputedRef } from 'vue';
 import { createLocalStorageSavedBlocksProvider } from '@templatical/core';
@@ -28,40 +29,32 @@ import { RenderProvider } from '@templatical/types';
 import type { ResolvePreview } from '@templatical/types';
 import { SavedBlock } from '@templatical/types';
 import { SavedBlocksListParams } from '@templatical/types';
+import { SavedBlocksOptions } from '@templatical/types';
 import { SavedBlocksProvider } from '@templatical/types';
 import { Template } from '@templatical/types';
 import { TemplateContent } from '@templatical/types';
 import { TemplateDefaults } from '@templatical/types';
 import { TemplatePatch } from '@templatical/types';
+import { TemplateSaveTrigger } from '@templatical/types';
+import { TemplatesOptions } from '@templatical/types';
 import { TemplatesProvider } from '@templatical/types';
+import { TestEmailOptions } from '@templatical/types';
 import { TestEmailPayload } from '@templatical/types';
 import { TestEmailProvider } from '@templatical/types';
 import { ThemeOverrides } from '@templatical/types';
 import { UiTheme } from '@templatical/types';
+import { VersionHistoryOptions } from '@templatical/types';
 import type { VersionHistoryProvider } from '@templatical/types';
 import { ViewportSize } from '@templatical/types';
 
-/**
- * How often the editor's single debounced tick fires, and whether it saves.
- *
- * `true` / `false` turn autosave on and off at the default cadence; the object
- * form turns it on and sets the cadence in one key. One key rather than a
- * `boolean` plus a separate `autoSaveDebounce`, so there is no combination —
- * `autoSave: false, autoSaveDebounce: 500` — that reads as configured but does
- * nothing.
- *
- * The debounce governs `onChange` too: both ride one `useAutoSave` instance so
- * the notification and the save cannot drift apart, and so both inherit the
- * pause-during-undo/redo behaviour `useEditorCore` wires around it.
- */
-declare type AutoSaveConfig = boolean | {
-    debounce?: number;
-};
-
 export { BlockDefaults }
 
 export { ColorsConfig }
 
+export { CommentEventMeta }
+
+export { CommentsOptions }
+
 export { createLocalStorageSavedBlocksProvider }
 
 export { CustomBlockDefinition }
@@ -159,11 +152,6 @@ export declare interface EditorCapabilities {
         canUpdate: ComputedRef<boolean>;
         canDelete: ComputedRef<boolean>;
     };
-    /**
-     * Present only when a `TestEmailProvider` is configured — in OSS via
-     * `init({ testEmail })`, in Cloud whenever cloud mode is active (or when a
-     * consumer supplied their own sender to `initCloud()`).
-     */
     /**
      * Present only when a `TemplatesProvider` is configured — in OSS via
      * `init({ templates })`.
@@ -216,8 +204,11 @@ export declare interface EditorCapabilities {
         isAvailable: ComputedRef<boolean>;
     };
     /**
-     * Present only when a `VersionHistoryProvider` is configured — via
-     * `init({ versionHistory })` or `initCloud({ versionHistory })`.
+     * Present when a `VersionHistoryProvider` is configured via
+     * `init({ versionHistory })`. Always present in Cloud — Cloud injects its
+     * own adapter unconditionally, so `initCloud({ versionHistory })` (events
+     * only, no storage) attaches handlers to it rather than gating whether
+     * this capability exists.
      */
     versionHistory?: {
         /** Re-read the list from the provider. A no-op before a template exists. */
@@ -239,6 +230,11 @@ export declare interface EditorCapabilities {
         canCreate: ComputedRef<boolean>;
         canRestore: ComputedRef<boolean>;
     };
+    /**
+     * Present only when a `TestEmailProvider` is configured — in OSS via
+     * `init({ testEmail })`, in Cloud whenever cloud mode is active (or when a
+     * consumer supplied their own sender to `initCloud()`).
+     */
     testEmail?: {
         /** Open the send dialog. A no-op while {@link isAvailable} is false. */
         open(): void;
@@ -306,12 +302,30 @@ export declare function init(config: TemplaticalEditorConfig): Promise<Templatic
  * session that dies *later* — an auth refresh that cannot renew the token — does
  * still surface as an overlay, because by then there is an editor to cover.
  *
- * `templates`, `versionHistory` and `comments` are the three keys `initCloud()`
- * refuses: all are keyed to a template id Cloud issued, which also anchors
- * collaboration, AI rewrite, scoring and the server-side export. A store Cloud
- * never issued ids for would degrade all of them silently. Everything else —
- * `render`, `savedBlocks`, `testEmail`, `resolvePreview` — is the same key with the
- * same type on both entry points, so upgrading an OSS integration is a deletion.
+ * `templates`, `comments` and `versionHistory` are all keyed to a template
+ * id Cloud issued, which also anchors collaboration, AI rewrite, scoring and
+ * the server-side export — a store Cloud never issued ids for would degrade
+ * all of them silently. Cloud therefore keeps each key's storage, but each
+ * key is still accepted, for its configuration and events:
+ * `templates.load`/`create`/`save`,
+ * `comments.list`/`create`/`update`/`delete`/`setResolved`, and
+ * `versionHistory.list`/`get`/`create`/`restore` are ignored with a warning
+ * naming them, while `templates`' `autoSave`, `unsavedChangesGuard`,
+ * `nameField`, `onSaved`, `onCreated`, `onLoaded`, `comments`' `onCreated`,
+ * `onUpdated`, `onDeleted`, `onResolved`, `onUnresolved`, and
+ * `versionHistory`'s `onCreated`, `onRestored` are all honoured.
+ *
+ * `render` is not a key here at all, unlike `init()` — Cloud renders
+ * server-side for test email, sends and exports, so a supplied renderer
+ * would change only what you preview and export, never what Cloud delivers.
+ * `resolvePreview` is the same key with the same type on both entry points,
+ * so upgrading an OSS integration is a deletion. `savedBlocks` and
+ * `testEmail` are the same key on both entry points too, but Cloud widens
+ * each type to also accept an events-only shape — `boolean |
+ * SavedBlocksOptions | SavedBlocksProvider` and `Pick<TestEmailOptions,
+ * "onSent" | "defaultRecipient"> | TestEmailProvider` — so upgrading is
+ * still a deletion: drop the key to adopt Cloud's store or sender, or leave
+ * it exactly as it is to keep your own.
  *
  * `user` is not a key either: Cloud signs comment writes against the auth token's
  * `user` claim, so it fills `init({ user })` from there rather than letting a
@@ -355,6 +369,8 @@ export { SavedBlock }
 
 export { SavedBlocksListParams }
 
+export { SavedBlocksOptions }
+
 export { SavedBlocksProvider }
 
 export { Template }
@@ -365,6 +381,10 @@ export { TemplateDefaults }
 
 export { TemplatePatch }
 
+export { TemplateSaveTrigger }
+
+export { TemplatesOptions }
+
 export { TemplatesProvider }
 
 /**
@@ -376,11 +396,12 @@ export { TemplatesProvider }
  * false. It also means moving between them is a config change and never a
  * rewrite of the calling code.
  *
- * Three cloud-only members went with the convergence: `setThemeOverrides`
- * (`config.theme` is applied at init on both entry points, and the entitlement
- * that gated changing it later is gone), and `sendTestEmail` (the shared dialog
- * is the supported path). `create()` takes `init()`'s `{ name?, content? }`
- * input object rather than a bare `TemplateContent`.
+ * Three cloud-only members went with the convergence: `create()` takes
+ * `init()`'s `{ name?, content? }` input object now, rather than a bare
+ * `TemplateContent`; `setThemeOverrides` is gone (`config.theme` is applied
+ * at init on both entry points, and the entitlement that gated changing it
+ * later is gone); and `sendTestEmail` is gone (the shared dialog is the
+ * supported path).
  */
 export declare type TemplaticalCloudEditor = TemplaticalEditor;
 
@@ -442,21 +463,7 @@ export declare interface TemplaticalCloudEditorConfig {
      * @default true
      */
     smallScreenNotice?: boolean;
-    /**
-     * Show the template's name in the header, inline-editable. Defaults to `true`.
-     *
-     * Set to `false` when your store has no name column, or when your own chrome
-     * owns the name. Hides the field only — `create({ name })`, `setName()` and the
-     * `name` in each save patch keep working, so a headless caller or your own UI
-     * can still manage names.
-     *
-     * Without a `templates` provider the header renders no name field either way.
-     *
-     * @default true
-     */
-    templateNameField?: boolean;
     ai?: AiConfig | false;
-    commenting?: boolean;
     collaboration?: CollaborationConfig;
     mcp?: McpConfig;
     blockDefaults?: BlockDefaults;
@@ -465,8 +472,10 @@ export declare interface TemplaticalCloudEditorConfig {
      * Reusable saved blocks.
      *
      * - **omitted / `true`** — backed by Templatical Cloud, gated on the
-     *   `saved_modules` plan feature.
-     * - **`false`** — off entirely; no UI renders.
+     *   `saved_modules` plan feature;
+     * - **`false`** — off entirely; no UI renders;
+     * - **a {@link SavedBlocksOptions}** — still backed by Cloud's store, plus
+     *   your `onCreated`, `onUpdated` and `onDeleted` handlers;
      * - **a {@link SavedBlocksProvider}** — backed by *your* store instead of
      *   Cloud's, and **not plan-gated**, because the plan feature licenses Cloud's
      *   storage rather than the editor's UI.
@@ -475,14 +484,59 @@ export declare interface TemplaticalCloudEditorConfig {
      * integration to Cloud means deleting this key (to adopt Cloud's store) or
      * leaving it exactly as-is (to keep your own) — never rewriting it.
      */
-    savedBlocks?: boolean | SavedBlocksProvider;
+    savedBlocks?: boolean | SavedBlocksOptions | SavedBlocksProvider;
+    /**
+     * Configuration and events for the template lifecycle. **The same key and
+     * the same type as `init()`'s `templates`** — minus the storage methods,
+     * which Cloud owns: the id it issues is the join key for collaboration,
+     * version history, comments, AI rewrite, scoring and the server-side export.
+     *
+     * Passing a full provider is not an error: `load` / `create` / `save` are
+     * ignored with a warning naming them, while `autoSave`, `unsavedChangesGuard`,
+     * `nameField`, `onSaved`, `onCreated` and `onLoaded` are all honoured. So an
+     * OSS integration moving to Cloud leaves this key exactly as it is.
+     */
+    templates?: TemplatesOptions;
+    /**
+     * The review conversation. **The same key `init()` takes**, minus the storage
+     * methods Cloud owns — a comment is keyed to a template id Cloud issued and
+     * its author is signed by the auth token.
+     *
+     * - **omitted** — Cloud's store, subject to the `commenting` plan feature;
+     * - **`false`** — off, whatever the plan grants;
+     * - **an options object** — Cloud's store, plus your `onCreated`,
+     *   `onUpdated`, `onDeleted`, `onResolved` and `onUnresolved` handlers.
+     *
+     * Passing a full provider is not an error: its methods are ignored with a
+     * warning naming them, and its events are honoured.
+     */
+    comments?: false | CommentsOptions;
     /**
-     * Save automatically, debounced. **The same key and the same type as
-     * `init()`** — `true`/`false`, or `{ debounce }` to set the cadence in one
-     * key. Unlike OSS it defaults to *on*, because a Cloud session always has a
-     * store to save to.
+     * Outward notifications for a template's version history. **The same key
+     * `init()` takes**, minus the storage methods Cloud owns — a version is
+     * keyed to a template id Cloud issued, so Cloud owns version-history
+     * storage.
+     *
+     * - **omitted** — Cloud's store, with no extra notifications;
+     * - **a {@link VersionHistoryOptions}** — Cloud's store, plus your
+     *   `onCreated` and `onRestored` handlers.
+     *
+     * Passing a full provider is not an error: its methods are ignored with a
+     * warning naming them, and its events are honoured.
      */
-    autoSave?: AutoSaveConfig;
+    versionHistory?: VersionHistoryOptions;
+    /**
+     * How long the editor waits after the last edit before it fires `onChange`
+     * and, when `templates.autoSave` is on, saves.
+     *
+     * One timer drives both, so they cannot drift apart. Cloud always injects
+     * its own `templates` provider, so pace `onChange` alone with
+     * `templates: { autoSave: false }` rather than by omitting a provider —
+     * the no-provider case `init()` uses for this doesn't exist on this tier.
+     *
+     * @default 2000
+     */
+    changeDebounce?: number;
     mergeTags?: MergeTagsConfig;
     logicTags?: LogicTagsConfig;
     displayConditions?: DisplayConditionsConfig;
@@ -524,19 +578,7 @@ export declare interface TemplaticalCloudEditorConfig {
      * the same type as `init()`'s** — one editor, one set of keys.
      */
     onDirtyChange?: (isDirty: boolean) => void;
-    /**
-     * Warn before closing the tab with unsaved changes. On by default, since a
-     * Cloud session always has a store to save to. Set to `false` to own the
-     * prompt yourself; it can never cover client-side route changes either way,
-     * which is what {@link onDirtyChange} is for.
-     *
-     * @default true
-     */
-    unsavedChangesGuard?: boolean;
-    onCreate?: (template: Template) => void;
-    onLoad?: (template: Template) => void;
     onError?: (error: Error) => void;
-    onComment?: (event: CommentEvent) => void;
     onUnmount?: () => void;
     onRequestMedia?: (context: MediaRequestContext) => Promise<MediaItem | null>;
     /**
@@ -551,16 +593,27 @@ export declare interface TemplaticalCloudEditorConfig {
      * Sending backend for test emails.
      *
      * - **omitted** — sent by Templatical Cloud, gated on the `test_email` plan
-     *   feature and its signed allowed-recipient list.
+     *   feature and its signed allowed-recipient list;
+     * - **`{ onSent?, defaultRecipient? }`** — still sent by Cloud, plus your
+     *   `onSent` handler and/or a pre-filled recipient (ignored unless it's
+     *   already on Cloud's own allowlist — this can't smuggle in an address
+     *   outside it). `includeMjml` and `allowedRecipients` are not honoured on
+     *   this form — Cloud renders server-side rather than from a client MJML
+     *   pass, and the allowlist is the signed one from your project's JWT, not
+     *   a client-supplied one. TypeScript does not flag passing them here
+     *   (both are valid members of the sibling {@link TestEmailProvider} arm,
+     *   so the union accepts them structurally); passing either logs a
+     *   runtime warning naming it instead;
      * - **a {@link TestEmailProvider}** — sent by *you* instead, which is what to
      *   reach for when mail must leave your own infrastructure for compliance or
-     *   data-residency reasons.
+     *   data-residency reasons. `includeMjml`, `allowedRecipients`,
+     *   `defaultRecipient` and `onSent` are all yours to set here.
      *
      * The same type `init()` takes, so moving an OSS integration to Cloud means
      * deleting this key (to adopt Cloud's sender) or leaving it exactly as-is (to
      * keep your own) — never rewriting it.
      */
-    testEmail?: TestEmailProvider;
+    testEmail?: Pick<TestEmailOptions, "onSent" | "defaultRecipient"> | TestEmailProvider;
     /**
      * Resolves the template for preview surfaces — typically evaluating logic
      * tags (`{% if %}` … `{% endif %}`) against real data on your backend.
@@ -733,6 +786,11 @@ export declare interface TemplaticalEditorConfig {
      * await editor.load("tpl_123");
      * ```
      *
+     * Autosave (`templates.autoSave`), the unsaved-changes guard
+     * (`templates.unsavedChangesGuard`) and the header's inline name field
+     * (`templates.nameField`) are configured on this same object — grouped here
+     * because none of the three mean anything without somewhere to save to.
+     *
      * **Omitted by default.** With no provider the feature is entirely off — no
      * name field, no save button, no status indicator — and `create()` / `load()` /
      * `save()` reject with an explanatory error. Persist the content yourself from
@@ -815,34 +873,15 @@ export declare interface TemplaticalEditorConfig {
      */
     versionHistory?: VersionHistoryProvider;
     /**
-     * Save the template automatically, debounced, after the user stops editing.
-     * Requires a `templates` provider — without one there is nothing to save to,
-     * and the option is ignored with a warning.
+     * How long the editor waits after the last edit before it fires `onChange`
+     * and, when `templates.autoSave` is on, saves.
      *
-     * `true` uses the default cadence; `{ debounce }` sets it in the same key. The
-     * debounce governs `onChange` too — both ride one timer so they cannot drift
-     * apart.
+     * One timer drives both, so they cannot drift apart. Set it with no templates
+     * provider to pace `onChange` alone.
      *
-     * ```ts
-     * autoSave: true                  // default cadence
-     * autoSave: { debounce: 2000 }    // on, slower
-     * ```
-     *
-     * @default false
+     * @default 2000
      */
-    autoSave?: AutoSaveConfig;
-    /**
-     * Warn the user before they close or reload the tab with unsaved changes.
-     * On by default whenever a `templates` provider is configured — without one
-     * the editor cannot know whether you already persisted the change, so it never
-     * warns.
-     *
-     * Set to `false` to own that prompt yourself. Note it can never cover
-     * client-side route changes; use `onDirtyChange` for those.
-     *
-     * @default true
-     */
-    unsavedChangesGuard?: boolean;
+    changeDebounce?: number;
     onRequestMedia?: OnRequestMedia;
     /**
      * Resolves the template for preview surfaces — typically evaluating logic
@@ -1053,6 +1092,11 @@ export declare interface TemplaticalEditorConfig {
      * **Omitted by default**, and the panel also stays hidden until a template is
      * loaded, since a comment belongs to a template id.
      *
+     * The same object also carries outward events — `onCreated`, `onUpdated`,
+     * `onDeleted`, `onResolved`, `onUnresolved` — each called with the comment and
+     * whether the change was made locally or arrived through `subscribe`. That's
+     * the hook for a "3 new comments" badge outside the editor.
+     *
      * Realtime is an optional `subscribe` on the provider, not a prerequisite:
      * without it comments work identically, you simply see a colleague's on the next
      * read rather than immediately.
@@ -1073,12 +1117,6 @@ export declare interface TemplaticalEditorConfig {
      * already trusts.
      */
     user?: EditorUser;
-    /**
-     * Called for every comment change the editor applied — including ones that
-     * arrived through a provider's `subscribe`, so this is the hook for a "3 new
-     * comments" badge outside the editor.
-     */
-    onComment?: (event: CommentEvent) => void;
     blockDefaults?: BlockDefaults;
     templateDefaults?: TemplateDefaults;
     theme?: ThemeOverrides;
@@ -1105,19 +1143,6 @@ export declare interface TemplaticalEditorConfig {
      * @default true
      */
     smallScreenNotice?: boolean;
-    /**
-     * Show the template's name in the header, inline-editable. Defaults to `true`.
-     *
-     * Set to `false` when your store has no name column, or when your own chrome
-     * owns the name. Hides the field only — `create({ name })`, `setName()` and the
-     * `name` in each save patch keep working, so a headless caller or your own UI
-     * can still manage names.
-     *
-     * Without a `templates` provider the header renders no name field either way.
-     *
-     * @default true
-     */
-    templateNameField?: boolean;
     /**
      * Template linter (`@templatical/quality`) configuration. Runs every
      * linter exported by the package (accessibility + structure).
@@ -1130,6 +1155,8 @@ export declare interface TemplaticalEditorConfig {
     lint?: LintOptions;
 }
 
+export { TestEmailOptions }
+
 export { TestEmailPayload }
 
 export { TestEmailProvider }
@@ -1159,6 +1186,8 @@ export declare interface UseFontsReturn {
     getDefaultFont: () => string;
 }
 
+export { VersionHistoryOptions }
+
 export { ViewportSize }
 
 export { }

package/dist/{info-BKMKasyT.js → info-DbmE2JAo.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("info", [
 	["circle", {
 		cx: "12",

package/dist/{loader-circle-CSGh8n8A.js → loader-circle-dSap9DfQ.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("loader-circle", [["path", {
 	d: "M21 12a9 9 0 1 1-6.219-8.56",
 	key: "13zald"

package/dist/{message-circle-C6q2Fm_W.js → message-circle-qSKKLbac.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("message-circle", [["path", {
 	d: "M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",
 	key: "1sd12s"

package/dist/{pencil-DaTN0HKw.js → pencil-DMP8vL2F.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("pencil", [["path", {
 	d: "M21.174 6.812a1 1 0 0 0-3.986-3.987L3.842 16.174a2 2 0 0 0-.5.83l-1.321 4.352a.5.5 0 0 0 .623.622l4.353-1.32a2 2 0 0 0 .83-.497z",
 	key: "1a8usu"

package/dist/{refresh-cw-Cu4wRQwT.js → refresh-cw-WXtBeMva.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("eye", [["path", {
 	d: "M2.062 12.348a1 1 0 0 1 0-.696 10.75 10.75 0 0 1 19.876 0 1 1 0 0 1 0 .696 10.75 10.75 0 0 1-19.876 0",
 	key: "1nclc0"

package/dist/{scan-line-O_o657Gv.js → scan-line-BTrngVuN.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("braces", [["path", {
 	d: "M8 3H7a2 2 0 0 0-2 2v5a2 2 0 0 1-2 2 2 2 0 0 1 2 2v5c0 1.1.9 2 2 2h1",
 	key: "ezmyqa"

package/dist/{send-GS3soauT.js → send-CLa8Cxmh.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("send", [["path", {
 	d: "M14.536 21.686a.5.5 0 0 0 .937-.024l6.5-19a.496.496 0 0 0-.635-.635l-19 6.5a.5.5 0 0 0-.024.937l7.93 3.18a2 2 0 0 1 1.112 1.11z",
 	key: "1ffxy3"

package/dist/{shield-check-B2TzT3Wp.js → shield-check-42WZrKQu.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("shield-check", [["path", {
 	d: "M20 13c0 5-3.5 7.5-7.66 8.95a1 1 0 0 1-.67-.01C7.5 20.5 4 18 4 13V6a1 1 0 0 1 1-1c2 0 4.5-1.2 6.24-2.72a1.17 1.17 0 0 1 1.52 0C14.51 3.81 17 5 19 5a1 1 0 0 1 1 1z",
 	key: "oel41y"

package/dist/{sparkles-CNENcXZl.js → sparkles-DcOb0umz.js}

@@ -1,4 +1,4 @@
-import { t as e } from "./createLucideIcon-Cbl3Ma_H.js";
+import { t as e } from "./createLucideIcon-DGRWivCX.js";
 var t = e("sparkles", [
 	["path", {
 		d: "M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",