@jackuait/blok 0.23.1 → 0.23.3

package/dist/full.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/blok-Ci1zCOUg.cjs`),t=require(`./chunks/constants-Bkncy0y5.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-DlOZpcVU.cjs`);var i={paragraph:{class:r.k,inlineToolbar:!0,config:{preserveBlank:!0}},header:{class:r.O,inlineToolbar:!0},list:{class:r.D,inlineToolbar:!0}},a=n.t(n.t({},i),{},{bold:{class:r.l},italic:{class:r.c},marker:{class:r.o},underline:{class:r.a},strikethrough:{class:r.i},link:{class:r.s}});exports.Blok=e.t,exports.Bold=r.l,exports.DATA_ATTR=t.ja,exports.Header=r.O,exports.Italic=r.c,exports.Link=r.s,exports.List=r.D,exports.Marker=r.o,exports.Paragraph=r.k,exports.Strikethrough=r.i,exports.Toggle=r.T,exports.Underline=r.a,exports.allTools=a,exports.defaultBlockTools=r.t,exports.defaultInlineTools=r.n,exports.defaultTools=i,exports.version=e.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/blok-J3Lfa_bK.cjs`),t=require(`./chunks/constants-BZUc1kAY.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-OHDv2C7w.cjs`);var i={paragraph:{class:r.k,inlineToolbar:!0,config:{preserveBlank:!0}},header:{class:r.O,inlineToolbar:!0},list:{class:r.D,inlineToolbar:!0}},a=n.t(n.t({},i),{},{bold:{class:r.l},italic:{class:r.c},marker:{class:r.o},underline:{class:r.a},strikethrough:{class:r.i},link:{class:r.s}});exports.Blok=e.t,exports.Bold=r.l,exports.DATA_ATTR=t.Ma,exports.Header=r.O,exports.Italic=r.c,exports.Link=r.s,exports.List=r.D,exports.Marker=r.o,exports.Paragraph=r.k,exports.Strikethrough=r.i,exports.Toggle=r.T,exports.Underline=r.a,exports.allTools=a,exports.defaultBlockTools=r.t,exports.defaultInlineTools=r.n,exports.defaultTools=i,exports.version=e.n;

package/dist/full.mjs

@@ -1,7 +1,7 @@
-import { n as e, t } from "./chunks/blok-BPeM6wKv.mjs";
-import { ja as n } from "./chunks/constants-DR3sya6U.mjs";
+import { n as e, t } from "./chunks/blok-1H9roBGf.mjs";
+import { Ma as n } from "./chunks/constants-BJ79cqMa.mjs";
 import { t as r } from "./chunks/objectSpread2-jlBcdYeb.mjs";
-import { D as i, O as a, T as o, a as s, c, i as l, k as u, l as d, n as f, o as p, s as m, t as h } from "./chunks/tools-B72rczVw.mjs";
+import { D as i, O as a, T as o, a as s, c, i as l, k as u, l as d, n as f, o as p, s as m, t as h } from "./chunks/tools-ByOjWADT.mjs";
 //#region src/full.ts
 var g = {
 	paragraph: {

package/dist/react.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-BL1yB9zm.cjs`);const e=require(`./chunks/blok-Ci1zCOUg.cjs`),t=require(`./chunks/objectSpread2-iNkE6aJh.cjs`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=new WeakMap;function a(e,t){i.set(e,t)}function o(e){return i.get(e)}function s(e){i.delete(e)}function c(r,i){let[o,c]=(0,n.useState)(null),u=(0,n.useRef)(r);u.current=r;let d=(0,n.useRef)({editor:null,holder:null,destroyTimeout:null,isDestroyed:!1,depsToken:null}),f=(0,n.useMemo)(()=>({}),i==null?[]:i);(0,n.useEffect)(()=>{if(typeof window>`u`)return;let n=d.current;if(n.destroyTimeout!==null&&(clearTimeout(n.destroyTimeout),n.destroyTimeout=null),n.editor!==null&&!n.isDestroyed&&n.depsToken===f)return c(n.editor),()=>{l(n,c)};if(n.editor!==null&&!n.isDestroyed){s(n.editor);try{n.editor.destroy()}catch(e){}n.editor=null,n.holder=null,n.isDestroyed=!0,c(null)}let r=document.createElement(`div`);n.holder=r,n.isDestroyed=!1,n.depsToken=f;let i=u.current,o=new e.t(t.t(t.t({},i),{},{holder:r,onReady:()=>{var e,t;(e=(t=u.current).onReady)==null||e.call(t)},onChange:(...e)=>{var t,n;(t=(n=u.current).onChange)==null||t.call(n,...e)}}));return n.editor=o,a(o,r),o.isReady.then(()=>{n.editor===o&&!n.isDestroyed&&c(o)}).catch(()=>{if(n.editor===o&&!n.isDestroyed){s(o);try{o.destroy()}catch(e){}n.editor=null,n.holder=null,n.isDestroyed=!0,c(null)}}),()=>{l(n,c)}},[f]);let{readOnly:p}=r;(0,n.useEffect)(()=>{o!==null&&o.readOnly.set(p==null?!1:p)},[o,p]);let{autofocus:m}=r;(0,n.useEffect)(()=>{o===null||!m||o.focus()},[o,m]);let{theme:h}=r;(0,n.useEffect)(()=>{o===null||h===void 0||o.theme.set(h)},[o,h]);let{width:g}=r;(0,n.useEffect)(()=>{o===null||g===void 0||o.width.set(g)},[o,g]);let{placeholder:_}=r;return(0,n.useEffect)(()=>{o===null||_===void 0||o.placeholder.set(_)},[o,_]),o}function l(e,t){e.destroyTimeout=setTimeout(()=>{if(e.editor!==null){s(e.editor);try{e.editor.destroy()}catch(e){}e.editor=null,e.holder=null,e.isDestroyed=!0,e.destroyTimeout=null,t(null)}},0)}var u=[`editor`],d=(0,n.forwardRef)(function(i,a){let{editor:s}=i,c=e.i(i,u),l=(0,n.useRef)(null);return(0,n.useEffect)(()=>{if(s===null||l.current===null)return;let e=o(s);if(e!==void 0)return l.current.appendChild(e),()=>{e.remove()}},[s]),(0,r.jsx)(`div`,t.t({ref:e=>{if(l.current=e,typeof a==`function`)a(e);else if(a!=null){let t=a;t.current=e}}},c))}),f=`autofocus.defaultBlock.dataModel.placeholder.sanitizer.hideToolbar.maxHistoryLength.historyDebounceTime.newGroupDelay.globalUndoRedo.tools.data.minHeight.logLevel.readOnly.i18n.linkPaste.onReady.onChange.inlineToolbar.tunes.style.theme.onThemeChange.scrollToBlock.user.resolveUser.notifierPosition.notifier.width`.split(`.`),p=[`deps`,`onReady`],m=new Set(f),h=(0,n.forwardRef)(function(i,a){let{deps:o,onReady:s}=i,l=e.i(i,p),u={},f={};for(let e of Object.keys(l)){let t=l[e];m.has(e)?u[e]=t:f[e]=t}let h=c(u,o);(0,n.useImperativeHandle)(a,()=>h,[h]);let g=(0,n.useRef)(s);return g.current=s,(0,n.useEffect)(()=>{if(h!==null){var e;(e=g.current)==null||e.call(g,h)}},[h]),(0,r.jsx)(d,t.t({editor:h},f))});exports.BlokContent=d,exports.BlokEditor=h,exports.useBlok=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-BL1yB9zm.cjs`);const e=require(`./chunks/blok-J3Lfa_bK.cjs`),t=require(`./chunks/objectSpread2-iNkE6aJh.cjs`);let n=require(`react`),r=require(`react/jsx-runtime`);var i=new WeakMap;function a(e,t){i.set(e,t)}function o(e){return i.get(e)}function s(e){i.delete(e)}function c(e,t){if(e===t)return!0;if(typeof e!=`object`||!e||typeof t!=`object`||!t)return!1;let n=Array.isArray(e),r=Array.isArray(t);if(n!==r)return!1;if(n&&r)return e.length===t.length?e.every((e,n)=>c(e,t[n])):!1;let i=e,a=t,o=Object.keys(i),s=Object.keys(a);return o.length===s.length?o.every(e=>Object.prototype.hasOwnProperty.call(a,e)&&c(i[e],a[e])):!1}function l(r,i){let[o,l]=(0,n.useState)(null),d=(0,n.useRef)(r);d.current=r;let f=(0,n.useRef)({editor:null,holder:null,destroyTimeout:null,isDestroyed:!1,depsToken:null}),p=(0,n.useMemo)(()=>({}),i==null?[]:i);(0,n.useEffect)(()=>{if(typeof window>`u`)return;let n=f.current;if(n.destroyTimeout!==null&&(clearTimeout(n.destroyTimeout),n.destroyTimeout=null),n.editor!==null&&!n.isDestroyed&&n.depsToken===p)return l(n.editor),()=>{u(n,l)};if(n.editor!==null&&!n.isDestroyed){s(n.editor);try{n.editor.destroy()}catch(e){}n.editor=null,n.holder=null,n.isDestroyed=!0,l(null)}let r=document.createElement(`div`);n.holder=r,n.isDestroyed=!1,n.depsToken=p;let i=d.current,o=new e.t(t.t(t.t({},i),{},{holder:r,onReady:()=>{var e,t;(e=(t=d.current).onReady)==null||e.call(t)},onChange:(...e)=>{var t,n;(t=(n=d.current).onChange)==null||t.call(n,...e)}}));return n.editor=o,a(o,r),o.isReady.then(()=>{n.editor===o&&!n.isDestroyed&&l(o)}).catch(()=>{if(n.editor===o&&!n.isDestroyed){s(o);try{o.destroy()}catch(e){}n.editor=null,n.holder=null,n.isDestroyed=!0,l(null)}}),()=>{u(n,l)}},[p]);let{readOnly:m}=r;(0,n.useEffect)(()=>{o!==null&&o.readOnly.set(m==null?!1:m)},[o,m]);let{autofocus:h}=r;(0,n.useEffect)(()=>{o===null||!h||o.focus()},[o,h]);let{theme:g}=r;(0,n.useEffect)(()=>{o===null||g===void 0||o.theme.set(g)},[o,g]);let{width:_}=r;(0,n.useEffect)(()=>{o===null||_===void 0||o.width.set(_)},[o,_]);let{placeholder:v}=r;(0,n.useEffect)(()=>{o===null||v===void 0||o.placeholder.set(v)},[o,v]);let{data:y}=r,b=(0,n.useRef)(r.data),x=(0,n.useRef)(null),S=(0,n.useRef)(Promise.resolve());return(0,n.useEffect)(()=>{if(!(o===null||y===void 0)){if(x.current!==o){x.current=o,b.current=y;return}c(y,b.current)||(b.current=y,S.current=S.current.catch(()=>void 0).then(()=>o.render(y)))}},[o,y]),o}function u(e,t){e.destroyTimeout=setTimeout(()=>{if(e.editor!==null){s(e.editor);try{e.editor.destroy()}catch(e){}e.editor=null,e.holder=null,e.isDestroyed=!0,e.destroyTimeout=null,t(null)}},0)}var d=[`editor`],f=(0,n.forwardRef)(function(i,a){let{editor:s}=i,c=e.i(i,d),l=(0,n.useRef)(null);return(0,n.useEffect)(()=>{if(s===null||l.current===null)return;let e=o(s);if(e!==void 0)return l.current.appendChild(e),()=>{e.remove()}},[s]),(0,r.jsx)(`div`,t.t({ref:e=>{if(l.current=e,typeof a==`function`)a(e);else if(a!=null){let t=a;t.current=e}}},c))}),p=`autofocus.defaultBlock.dataModel.placeholder.sanitizer.hideToolbar.maxHistoryLength.historyDebounceTime.newGroupDelay.globalUndoRedo.tools.data.minHeight.logLevel.readOnly.i18n.link.linkPaste.onBeforePaste.onReady.onChange.inlineToolbar.tunes.style.theme.onThemeChange.scrollToBlock.user.resolveUser.notifierPosition.notifier.width`.split(`.`),m=[`deps`,`onReady`],h=new Set(p),g=(0,n.forwardRef)(function(i,a){let{deps:o,onReady:s}=i,c=e.i(i,m),u={},d={};for(let e of Object.keys(c)){let t=c[e];h.has(e)?u[e]=t:d[e]=t}let p=l(u,o);(0,n.useImperativeHandle)(a,()=>p,[p]);let g=(0,n.useRef)(s);return g.current=s,(0,n.useEffect)(()=>{if(p!==null){var e;(e=g.current)==null||e.call(g,p)}},[p]),(0,r.jsx)(f,t.t({editor:p},d))});exports.BlokContent=f,exports.BlokEditor=g,exports.useBlok=l;

package/dist/react.mjs

@@ -1,4 +1,4 @@
-import { i as e, t } from "./chunks/blok-BPeM6wKv.mjs";
+import { i as e, t } from "./chunks/blok-1H9roBGf.mjs";
 import { t as n } from "./chunks/objectSpread2-jlBcdYeb.mjs";
 import { forwardRef as r, useEffect as i, useImperativeHandle as a, useMemo as o, useRef as s, useState as c } from "react";
 import { jsx as l } from "react/jsx-runtime";
@@ -14,8 +14,19 @@ function p(e) {
 	u.delete(e);
 }
 //#endregion
+//#region src/react/deep-equal.ts
+function m(e, t) {
+	if (e === t) return !0;
+	if (typeof e != "object" || !e || typeof t != "object" || !t) return !1;
+	let n = Array.isArray(e), r = Array.isArray(t);
+	if (n !== r) return !1;
+	if (n && r) return e.length === t.length ? e.every((e, n) => m(e, t[n])) : !1;
+	let i = e, a = t, o = Object.keys(i), s = Object.keys(a);
+	return o.length === s.length ? o.every((e) => Object.prototype.hasOwnProperty.call(a, e) && m(i[e], a[e])) : !1;
+}
+//#endregion
 //#region src/react/useBlok.ts
-function m(e, r) {
+function h(e, r) {
 	let [a, l] = c(null), u = s(e);
 	u.current = e;
 	let f = s({
@@ -24,12 +35,12 @@ function m(e, r) {
 		destroyTimeout: null,
 		isDestroyed: !1,
 		depsToken: null
-	}), m = o(() => ({}), r == null ? [] : r);
+	}), h = o(() => ({}), r == null ? [] : r);
 	i(() => {
 		if (typeof window > "u") return;
 		let e = f.current;
-		if (e.destroyTimeout !== null && (clearTimeout(e.destroyTimeout), e.destroyTimeout = null), e.editor !== null && !e.isDestroyed && e.depsToken === m) return l(e.editor), () => {
-			h(e, l);
+		if (e.destroyTimeout !== null && (clearTimeout(e.destroyTimeout), e.destroyTimeout = null), e.editor !== null && !e.isDestroyed && e.depsToken === h) return l(e.editor), () => {
+			g(e, l);
 		};
 		if (e.editor !== null && !e.isDestroyed) {
 			p(e.editor);
@@ -39,7 +50,7 @@ function m(e, r) {
 			e.editor = null, e.holder = null, e.isDestroyed = !0, l(null);
 		}
 		let r = document.createElement("div");
-		e.holder = r, e.isDestroyed = !1, e.depsToken = m;
+		e.holder = r, e.isDestroyed = !1, e.depsToken = h;
 		let i = u.current, a = new t(n(n({}, i), {}, {
 			holder: r,
 			onReady: () => {
@@ -62,31 +73,41 @@ function m(e, r) {
 				e.editor = null, e.holder = null, e.isDestroyed = !0, l(null);
 			}
 		}), () => {
-			h(e, l);
+			g(e, l);
 		};
-	}, [m]);
-	let { readOnly: g } = e;
+	}, [h]);
+	let { readOnly: _ } = e;
 	i(() => {
-		a !== null && a.readOnly.set(g == null ? !1 : g);
-	}, [a, g]);
-	let { autofocus: _ } = e;
-	i(() => {
-		a === null || !_ || a.focus();
+		a !== null && a.readOnly.set(_ == null ? !1 : _);
 	}, [a, _]);
-	let { theme: v } = e;
+	let { autofocus: v } = e;
 	i(() => {
-		a === null || v === void 0 || a.theme.set(v);
+		a === null || !v || a.focus();
 	}, [a, v]);
-	let { width: y } = e;
+	let { theme: y } = e;
 	i(() => {
-		a === null || y === void 0 || a.width.set(y);
+		a === null || y === void 0 || a.theme.set(y);
 	}, [a, y]);
-	let { placeholder: b } = e;
+	let { width: b } = e;
+	i(() => {
+		a === null || b === void 0 || a.width.set(b);
+	}, [a, b]);
+	let { placeholder: x } = e;
+	i(() => {
+		a === null || x === void 0 || a.placeholder.set(x);
+	}, [a, x]);
+	let { data: S } = e, C = s(e.data), w = s(null), T = s(Promise.resolve());
 	return i(() => {
-		a === null || b === void 0 || a.placeholder.set(b);
-	}, [a, b]), a;
+		if (!(a === null || S === void 0)) {
+			if (w.current !== a) {
+				w.current = a, C.current = S;
+				return;
+			}
+			m(S, C.current) || (C.current = S, T.current = T.current.catch(() => void 0).then(() => a.render(S)));
+		}
+	}, [a, S]), a;
 }
-function h(e, t) {
+function g(e, t) {
 	e.destroyTimeout = setTimeout(() => {
 		if (e.editor !== null) {
 			p(e.editor);
@@ -99,8 +120,8 @@ function h(e, t) {
 }
 //#endregion
 //#region src/react/BlokContent.tsx
-var g = ["editor"], _ = r(function(t, r) {
-	let { editor: a } = t, o = e(t, g), c = s(null);
+var _ = ["editor"], v = r(function(t, r) {
+	let { editor: a } = t, o = e(t, _), c = s(null);
 	return i(() => {
 		if (a === null || c.current === null) return;
 		let e = f(a);
@@ -114,21 +135,21 @@ var g = ["editor"], _ = r(function(t, r) {
 			t.current = e;
 		}
 	} }, o));
-}), v = /* @__PURE__ */ "autofocus.defaultBlock.dataModel.placeholder.sanitizer.hideToolbar.maxHistoryLength.historyDebounceTime.newGroupDelay.globalUndoRedo.tools.data.minHeight.logLevel.readOnly.i18n.linkPaste.onReady.onChange.inlineToolbar.tunes.style.theme.onThemeChange.scrollToBlock.user.resolveUser.notifierPosition.notifier.width".split("."), y = ["deps", "onReady"], b = new Set(v), x = r(function(t, r) {
-	let { deps: o, onReady: c } = t, u = e(t, y), d = {}, f = {};
+}), y = /* @__PURE__ */ "autofocus.defaultBlock.dataModel.placeholder.sanitizer.hideToolbar.maxHistoryLength.historyDebounceTime.newGroupDelay.globalUndoRedo.tools.data.minHeight.logLevel.readOnly.i18n.link.linkPaste.onBeforePaste.onReady.onChange.inlineToolbar.tunes.style.theme.onThemeChange.scrollToBlock.user.resolveUser.notifierPosition.notifier.width".split("."), b = ["deps", "onReady"], x = new Set(y), S = r(function(t, r) {
+	let { deps: o, onReady: c } = t, u = e(t, b), d = {}, f = {};
 	for (let e of Object.keys(u)) {
 		let t = u[e];
-		b.has(e) ? d[e] = t : f[e] = t;
+		x.has(e) ? d[e] = t : f[e] = t;
 	}
-	let p = m(d, o);
+	let p = h(d, o);
 	a(r, () => p, [p]);
-	let h = s(c);
-	return h.current = c, i(() => {
+	let m = s(c);
+	return m.current = c, i(() => {
 		if (p !== null) {
 			var e;
-			(e = h.current) == null || e.call(h, p);
+			(e = m.current) == null || e.call(m, p);
 		}
-	}, [p]), /* @__PURE__ */ l(_, n({ editor: p }, f));
+	}, [p]), /* @__PURE__ */ l(v, n({ editor: p }, f));
 });
 //#endregion
-export { _ as BlokContent, x as BlokEditor, m as useBlok };
+export { v as BlokContent, S as BlokEditor, h as useBlok };

package/dist/tools.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/constants-Bkncy0y5.cjs`),t=require(`./chunks/tools-DlOZpcVU.cjs`);exports.Audio=t.g,exports.Bold=t.l,exports.Bookmark=t.u,exports.Callout=t.w,exports.Code=t.y,exports.Column=t.p,exports.ColumnList=t.m,exports.Columns=t.f,exports.Convert=e.m,exports.Database=t.C,exports.DatabaseRow=t.S,exports.Divider=t.x,exports.Embed=t.d,exports.File=t._,exports.Header=t.O,exports.Image=t.v,exports.InlineCode=t.r,exports.Italic=t.c,exports.Link=t.s,exports.List=t.D,exports.Marker=t.o,exports.Paragraph=t.k,exports.Quote=t.b,exports.Strikethrough=t.i,exports.Table=t.E,exports.Toggle=t.T,exports.Underline=t.a,exports.Video=t.h,exports.defaultBlockTools=t.t,exports.defaultInlineTools=t.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/constants-BZUc1kAY.cjs`),t=require(`./chunks/tools-OHDv2C7w.cjs`);exports.Audio=t.g,exports.Bold=t.l,exports.Bookmark=t.u,exports.Callout=t.w,exports.Code=t.y,exports.Column=t.p,exports.ColumnList=t.m,exports.Columns=t.f,exports.Convert=e.m,exports.Database=t.C,exports.DatabaseRow=t.S,exports.Divider=t.x,exports.Embed=t.d,exports.File=t._,exports.Header=t.O,exports.Image=t.v,exports.InlineCode=t.r,exports.Italic=t.c,exports.Link=t.s,exports.List=t.D,exports.Marker=t.o,exports.Paragraph=t.k,exports.Quote=t.b,exports.Strikethrough=t.i,exports.Table=t.E,exports.Toggle=t.T,exports.Underline=t.a,exports.Video=t.h,exports.defaultBlockTools=t.t,exports.defaultInlineTools=t.n;

package/dist/tools.mjs

@@ -1,3 +1,3 @@
-import { m as e } from "./chunks/constants-DR3sya6U.mjs";
-import { C as t, D as n, E as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, k as g, l as _, m as v, n as y, o as b, p as x, r as S, s as C, t as w, u as T, v as E, w as D, x as O, y as k } from "./chunks/tools-B72rczVw.mjs";
+import { m as e } from "./chunks/constants-BJ79cqMa.mjs";
+import { C as t, D as n, E as r, O as i, S as a, T as o, _ as s, a as c, b as l, c as u, d, f, g as p, h as m, i as h, k as g, l as _, m as v, n as y, o as b, p as x, r as S, s as C, t as w, u as T, v as E, w as D, x as O, y as k } from "./chunks/tools-ByOjWADT.mjs";
 export { p as Audio, _ as Bold, T as Bookmark, D as Callout, k as Code, x as Column, v as ColumnList, f as Columns, e as Convert, t as Database, a as DatabaseRow, O as Divider, d as Embed, s as File, i as Header, E as Image, S as InlineCode, u as Italic, C as Link, n as List, b as Marker, g as Paragraph, l as Quote, h as Strikethrough, r as Table, o as Toggle, c as Underline, m as Video, w as defaultBlockTools, y as defaultInlineTools };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackuait/blok",
-  "version": "0.23.1",
+  "version": "0.23.3",
   "description": "Blok — headless, highly extensible rich text editor built for developers who need to implement a block-based editing experience (similar to Notion) without building it from scratch",
   "module": "dist/blok.mjs",
   "main": "./dist/blok.cjs",

package/src/blok.ts

@@ -25,6 +25,11 @@ export const version = getBlokVersion();
  */
 export { DATA_ATTR } from './components/constants/data-attributes';
 
+/**
+ * Re-export the stable test-id hooks for targeting editor chrome in tests
+ */
+export { TEST_ID } from './components/constants/test-ids';
+
 /**
  * Blok
  * @license Apache-2.0
@@ -542,3 +547,10 @@ export default Blok;
  * into Blok's `render()→MenuConfig` inline tool contract.
  */
 export { wrapLegacyInlineTool } from './components/inline-tools/wrap-legacy-inline-tool';
+
+/**
+ * Typed event-name constants for editor lifecycle events observable via
+ * `blok.events.on(...)`. Prefer these over raw strings to avoid typos and
+ * get typed payloads (see {@link BlokEditorEventMap}).
+ */
+export { BlockRendered, BlocksRendered } from './components/events';

package/src/components/block/tool-renderer.ts

@@ -1,5 +1,5 @@
 import type { BlockTool as IBlockTool , ToolConfig } from '../../../types';
-import { DATA_ATTR } from '../constants';
+import { DATA_ATTR, TEST_ID } from '../constants';
 import { Dom as $ } from '../dom';
 import { log } from '../utils';
 
@@ -107,7 +107,7 @@ export class ToolRenderer {
     contentNode.setAttribute(DATA_ATTR.elementContent, '');
     contentNode.setAttribute('data-blok-testid', 'block-content');
 
-    wrapper.setAttribute('data-blok-testid', 'block-wrapper');
+    wrapper.setAttribute(DATA_ATTR.testid, TEST_ID.blockWrapper);
 
     if (this.name && !wrapper.hasAttribute('data-blok-component')) {
       wrapper.setAttribute('data-blok-component', this.name);

package/src/components/blocks.ts

@@ -1,5 +1,8 @@
 import type { Block } from './block';
 import { BlockToolAPI } from './block';
+import { BlockRendered } from './events';
+import type { BlokEventMap } from './events';
+import type { EventsDispatcher } from './utils/events';
 import { moveElementBefore, moveElementToEnd } from './utils/html';
 
 
@@ -20,13 +23,32 @@ export class Blocks {
    */
   public workingArea: HTMLElement;
 
+  /**
+   * Editor-wide event bus used to broadcast block lifecycle events
+   * (e.g. `block:rendered`). Optional so the class can be used and
+   * unit-tested standalone without an event bus.
+   */
+  private readonly eventsDispatcher?: EventsDispatcher<BlokEventMap>;
+
   /**
    * @class
    * @param {HTMLElement} workingArea — blok`s working node
+   * @param [eventsDispatcher] - editor-wide event bus for lifecycle events
    */
-  constructor(workingArea: HTMLElement) {
+  constructor(workingArea: HTMLElement, eventsDispatcher?: EventsDispatcher<BlokEventMap>) {
     this.blocks = [];
     this.workingArea = workingArea;
+    this.eventsDispatcher = eventsDispatcher;
+  }
+
+  /**
+   * Invokes the tool's `rendered()` lifecycle hook and broadcasts the
+   * `block:rendered` event for the freshly rendered block.
+   * @param block - block that has just been inserted into the DOM
+   */
+  private callRenderedHook(block: Block): void {
+    block.call(BlockToolAPI.RENDERED);
+    this.eventsDispatcher?.emit(BlockRendered, { blockId: block.id });
   }
 
   /**
@@ -226,7 +248,7 @@ export class Blocks {
       blockToReplace.holder.replaceWith(block.holder);
 
       this.blocks.splice(insertIndex, 1, block);
-      block.call(BlockToolAPI.RENDERED);
+      this.callRenderedHook(block);
 
       return;
     }
@@ -358,7 +380,7 @@ export class Blocks {
 
     this.blocks[index] = block;
 
-    block.call(BlockToolAPI.RENDERED);
+    this.callRenderedHook(block);
   }
 
   /**
@@ -388,7 +410,7 @@ export class Blocks {
       this.blocks.push(...blocks);
       this.workingArea.appendChild(fragment);
 
-      blocks.forEach((block) => block.call(BlockToolAPI.RENDERED));
+      blocks.forEach((block) => this.callRenderedHook(block));
 
       return;
     }
@@ -417,7 +439,7 @@ export class Blocks {
     /**
      * Call Rendered event for each block
      */
-    blocks.forEach((block) => block.call(BlockToolAPI.RENDERED));
+    blocks.forEach((block) => this.callRenderedHook(block));
   }
 
   /**
@@ -549,7 +571,7 @@ export class Blocks {
    */
   public activateBlock(block: Block): void {
     if (block.holder.parentElement !== null) {
-      block.call(BlockToolAPI.RENDERED);
+      this.callRenderedHook(block);
 
       return;
     }
@@ -588,13 +610,13 @@ export class Blocks {
   private insertToDOM(block: Block, position?: InsertPosition, target?: Block): void {
     if (!position || target === undefined) {
       this.workingArea.appendChild(block.holder);
-      block.call(BlockToolAPI.RENDERED);
+      this.callRenderedHook(block);
 
       return;
     }
 
     target.holder.insertAdjacentElement(position, block.holder);
-    block.call(BlockToolAPI.RENDERED);
+    this.callRenderedHook(block);
   }
 
   /**
@@ -627,7 +649,7 @@ export class Blocks {
       );
     }
 
-    block.call(BlockToolAPI.RENDERED);
+    this.callRenderedHook(block);
   }
 
   /**
@@ -678,7 +700,7 @@ export class Blocks {
       moveElementBefore(block.holder, nextBlock.holder);
     }
 
-    block.call(BlockToolAPI.RENDERED);
+    this.callRenderedHook(block);
   }
 
   /**

package/src/components/constants/test-ids.ts

@@ -0,0 +1,17 @@
+/**
+ * Stable, documented test-id values used with the `data-blok-testid`
+ * attribute ({@link DATA_ATTR.testid}).
+ *
+ * Exported as `Blok.TEST_ID` so consumers (and their test suites) can target
+ * editor chrome without reverse-engineering internal selectors. These values
+ * are part of the public contract — query them as
+ * `[${DATA_ATTR.testid}="${TEST_ID.plusButton}"]`.
+ */
+export const TEST_ID = {
+  /** The "+" (add block) toolbar button. */
+  plusButton: 'plus-button',
+  /** The block settings / drag handle toggler (☰). */
+  settingsToggler: 'settings-toggler',
+  /** A single block's wrapper element. */
+  blockWrapper: 'block-wrapper',
+} as const;

package/src/components/constants.ts

@@ -3,6 +3,11 @@
  */
 export { DATA_ATTR, createSelector } from './constants/data-attributes';
 
+/**
+ * Re-export the stable public test-id hooks
+ */
+export { TEST_ID } from './constants/test-ids';
+
 /**
  * Debounce timeout for selection change event
  * {@link modules/ui.ts}

package/src/components/events/BlockRendered.ts

@@ -0,0 +1,9 @@
+export type { BlockRenderedPayload } from '../../../types/events/editor-events';
+
+/**
+ * Fired when a single block has been rendered into the DOM
+ * (its `rendered()` lifecycle hook has been invoked).
+ *
+ * Public event name: `block:rendered`.
+ */
+export const BlockRendered = 'block:rendered';

package/src/components/events/BlocksRendered.ts

@@ -0,0 +1,13 @@
+export type { BlocksRenderedPayload } from '../../../types/events/editor-events';
+
+/**
+ * Fired when a batch of blocks has finished rendering into the DOM,
+ * e.g. on editor initialization or after `blok.blocks.render()`.
+ *
+ * Emitted once the browser has painted the inserted blocks, so subscribers
+ * can safely read the rendered DOM (build a table of contents, mark blocks,
+ * etc.) instead of polling.
+ *
+ * Public event name: `blocks:rendered`.
+ */
+export const BlocksRendered = 'blocks:rendered';

package/src/components/events/index.ts

@@ -1,6 +1,10 @@
 import type { BlockChangedPayload } from './BlockChanged';
 import { BlockChanged } from './BlockChanged';
 import type { BlockHovered, BlockHoveredPayload } from './BlockHovered';
+import type { BlockRenderedPayload } from './BlockRendered';
+import { BlockRendered } from './BlockRendered';
+import type { BlocksRenderedPayload } from './BlocksRendered';
+import { BlocksRendered } from './BlocksRendered';
 import type { BlockSettingsClosedPayload } from './BlockSettingsClosed';
 import { BlockSettingsClosed } from './BlockSettingsClosed';
 import type { BlockSettingsOpenedPayload } from './BlockSettingsOpened';
@@ -20,6 +24,8 @@ import type { RedactorDomChangedPayload } from './RedactorDomChanged';
 export {
   RedactorDomChanged,
   BlockChanged,
+  BlockRendered,
+  BlocksRendered,
   FakeCursorAboutToBeToggled,
   FakeCursorHaveBeenSet,
   BlokMobileLayoutToggled,
@@ -34,6 +40,8 @@ export interface BlokEventMap {
   [BlockHovered]: BlockHoveredPayload;
   [RedactorDomChanged]: RedactorDomChangedPayload;
   [BlockChanged]: BlockChangedPayload;
+  [BlockRendered]: BlockRenderedPayload;
+  [BlocksRendered]: BlocksRenderedPayload;
   [FakeCursorAboutToBeToggled]: FakeCursorAboutToBeToggledPayload;
   [FakeCursorHaveBeenSet]: FakeCursorHaveBeenSetPayload;
   [BlokMobileLayoutToggled]: BlokMobileLayoutToggledPayload;

package/src/components/inline-tools/inline-tool-link.ts

@@ -3,6 +3,7 @@ import type {
   InlineToolConstructorOptions,
   SanitizerConfig
 } from '../../../types';
+import type { BlokConfig } from '../../../types/configs/blok-config';
 import type { Notifier, Toolbar, I18n, InlineToolbar } from '../../../types/api';
 import type { MenuConfig } from '../../../types/tools';
 import { DATA_ATTR, createSelector, INLINE_TOOLBAR_INTERFACE_VALUE } from '../constants';
@@ -42,15 +43,18 @@ export class LinkInlineTool implements InlineTool {
 
   /**
    * Sanitizer Rule
-   * Leave <a> tags
+   * Leave <a> tags. target/rel pass through (instead of being forced to the
+   * defaults) so consumer-configured BlokConfig.link.target / .rel values
+   * survive save-time sanitization. Created anchors still default to
+   * '_blank'/'nofollow' via insertLink().
    * @returns {object}
    */
   public static get sanitize(): SanitizerConfig {
     return {
       a: {
         href: true,
-        target: '_blank',
-        rel: 'nofollow',
+        target: true,
+        rel: true,
       },
     } as SanitizerConfig;
   }
@@ -119,6 +123,11 @@ export class LinkInlineTool implements InlineTool {
    */
   private i18n: I18n;
 
+  /**
+   * Global anchor-building config (target / rel / transformHref)
+   */
+  private linkConfig: NonNullable<BlokConfig['link']>;
+
   /**
    * @param api - Blok API
    */
@@ -127,6 +136,7 @@ export class LinkInlineTool implements InlineTool {
     this.inlineToolbar = api.inlineToolbar;
     this.notifier = api.notifier;
     this.i18n = api.i18n;
+    this.linkConfig = api.config.link ?? {};
     this.selection = new SelectionUtils();
     this.nodes.input = this.createInput();
     this.nodes.suggestion = this.createSuggestion();
@@ -676,6 +686,10 @@ export class LinkInlineTool implements InlineTool {
    * @param {string} link - "href" value
    */
   private insertLink(link: string): void {
+    const href = this.linkConfig.transformHref ? this.linkConfig.transformHref(link) : link;
+    const target = this.linkConfig.target ?? '_blank';
+    const rel = this.linkConfig.rel ?? 'nofollow';
+
     /**
      * Edit all link, not selected part
      */
@@ -684,9 +698,9 @@ export class LinkInlineTool implements InlineTool {
     if (anchorTag instanceof HTMLAnchorElement) {
       this.selection.expandToTag(anchorTag);
 
-      anchorTag.href = link;
-      anchorTag.target = '_blank';
-      anchorTag.rel = 'nofollow';
+      anchorTag.href = href;
+      anchorTag.target = target;
+      anchorTag.rel = rel;
 
       return;
     }
@@ -699,9 +713,9 @@ export class LinkInlineTool implements InlineTool {
 
     const anchor = document.createElement('a');
 
-    anchor.href = link;
-    anchor.target = '_blank';
-    anchor.rel = 'nofollow';
+    anchor.href = href;
+    anchor.target = target;
+    anchor.rel = rel;
 
     anchor.appendChild(range.extractContents());
 

package/src/components/modules/api/events.ts

@@ -13,9 +13,9 @@ export class EventsAPI extends Module {
    */
   public get methods(): Events {
     return {
-      emit: (eventName: keyof BlokEventMap, data: BlokEventMap[keyof BlokEventMap] | undefined): void => this.emit(eventName, data),
-      off: (eventName: keyof BlokEventMap, callback: (data?: unknown) => void): void => this.off(eventName, callback),
-      on: (eventName: keyof BlokEventMap, callback: () => void): void => this.on(eventName, callback),
+      emit: (eventName: string, data?: unknown): void => this.emit(eventName, data),
+      off: (eventName: string, callback: (data?: unknown) => void): void => this.off(eventName, callback),
+      on: (eventName: string, callback: (data?: unknown) => void): void => this.on(eventName, callback),
     };
   }
 
@@ -24,8 +24,8 @@ export class EventsAPI extends Module {
    * @param {string} eventName - event name to subscribe
    * @param {Function} callback - event handler
    */
-  public on(eventName: keyof BlokEventMap, callback: (data?: unknown) => void): void {
-    this.eventsDispatcher.on(eventName, callback);
+  public on(eventName: string, callback: (data?: unknown) => void): void {
+    this.eventsDispatcher.on(eventName as keyof BlokEventMap, callback);
   }
 
   /**
@@ -33,10 +33,10 @@ export class EventsAPI extends Module {
    * @param {string} eventName - event to emit
    * @param {object} data - event's data
    */
-  public emit(eventName: keyof BlokEventMap, data: BlokEventMap[keyof BlokEventMap] | undefined): void {
+  public emit(eventName: string, data?: unknown): void {
     this.eventsDispatcher.emit(
-      eventName,
-      data
+      eventName as keyof BlokEventMap,
+      data as BlokEventMap[keyof BlokEventMap]
     );
   }
 
@@ -45,7 +45,7 @@ export class EventsAPI extends Module {
    * @param {string} eventName - event to unsubscribe
    * @param {Function} callback - event handler
    */
-  public off(eventName: keyof BlokEventMap, callback: (data?: unknown) => void): void {
-    this.eventsDispatcher.off(eventName, callback);
+  public off(eventName: string, callback: (data?: unknown) => void): void {
+    this.eventsDispatcher.off(eventName as keyof BlokEventMap, callback);
   }
 }

package/src/components/modules/api/index.ts

@@ -41,6 +41,9 @@ export class API extends Module {
         get linkPaste() {
           return apiConfig.linkPaste;
         },
+        get link() {
+          return apiConfig.link;
+        },
       },
       rectangleSelection: this.Blok.RectangleSelection,
     };

package/src/components/modules/api/tools.ts

@@ -30,6 +30,9 @@ export class ToolsAPI extends Module {
 
         return result;
       },
+      update: (name, config) => {
+        this.Blok.Tools.updateToolConfig(name, config);
+      },
     };
   }
 }

package/src/components/modules/blockManager/blockManager.ts

@@ -269,7 +269,7 @@ export class BlockManager extends Module {
    * Define this._blocks property
    */
   public prepare(): void {
-    const blocks = new Blocks(this.Blok.UI.nodes.redactor);
+    const blocks = new Blocks(this.Blok.UI.nodes.redactor, this.eventsDispatcher);
 
     /**
      * We need to use Proxy to overload set/get [] operator.

package/src/components/modules/paste/index.ts

@@ -113,7 +113,16 @@ export class Paste extends Module {
    */
   public async processDataTransfer(dataTransfer: DataTransfer, pasteTarget?: Element): Promise<void> {
     const plainData = dataTransfer.getData('text/plain');
-    const rawHtmlData = dataTransfer.getData('text/html');
+
+    // Give consumers a chance to transform or drop the raw clipboard HTML
+    // before any Blok preprocessing/sanitization runs. Returning a string
+    // replaces the HTML for the rest of the pipeline; returning null aborts the
+    // HTML paste path entirely (an empty string makes HtmlHandler bail, so the
+    // paste falls through to the plain-text handler).
+    const clipboardHtml = dataTransfer.getData('text/html');
+    const rawHtmlData = clipboardHtml && this.config.onBeforePaste
+      ? this.config.onBeforePaste(clipboardHtml) ?? ''
+      : clipboardHtml;
 
     // Native Blok clipboard data always wins. When absent, fall back to the
     // lossless proprietary flavours of other editors (web→web paste): they