@jackuait/blok 0.19.1 → 0.19.2

package/dist/chunks/{tools-CelSzJoA.mjs → tools-fEI-EVng.mjs}

@@ -1,5 +1,5 @@
 import { i as e, t } from "./chunk-5O_1xk2F.mjs";
-import { $ as n, $n as r, $r as i, $t as a, An as o, At as s, B as c, Bn as l, Bt as u, C as d, Cn as f, Cr as p, Ct as m, Dn as h, Dr as g, Dt as _, En as v, Er as y, Et as b, F as x, Fi as S, Fn as C, Ft as w, G as T, Gn as E, Gt as D, H as ee, Hn as O, Ht as k, I as A, In as j, Ir as M, It as te, J as ne, Jn as N, Jt as re, Kn as ie, Kt as ae, L as oe, Ln as se, Lr as ce, Lt as P, Mn as le, Mr as F, Mt as ue, Nn as de, Nr as fe, Nt as pe, Oi as me, On as I, Or as he, Ot as ge, P as _e, Pi as L, Pn as ve, Pt as ye, Q as be, Qn as xe, Qt as Se, R as Ce, Rn as we, Rt as Te, S as Ee, Sn as De, St as Oe, T as ke, Tn as Ae, Tr as je, Tt as Me, U as R, Un as Ne, Ut as Pe, Vn as Fe, Vt as Ie, W as Le, Wn as Re, Wt as ze, X as Be, Xn as Ve, Xt as He, Y as Ue, Yn as We, Yt as Ge, Z as Ke, Zn as qe, Zt as Je, _ as Ye, _n as Xe, _t as Ze, a as Qe, ar as $e, at as et, b as tt, bn as nt, bt as rt, c as it, ci as at, cn as ot, cr as st, ct as z, d as ct, dn as lt, dt as ut, en as dt, et as ft, f as pt, fn as mt, fr as ht, ft as gt, g as _t, gn as vt, gr as yt, gt as bt, h as xt, hn as St, ht as Ct, i as wt, in as Tt, ir as Et, it as Dt, jn as Ot, jt as kt, kn as At, kr as B, kt as jt, l as Mt, ln as Nt, lr as Pt, lt as Ft, mn as It, mr as Lt, mt as Rt, n as zt, nn as Bt, nr as Vt, nt as Ht, o as V, oi as Ut, on as Wt, or as Gt, ot as Kt, p as qt, pn as Jt, pr as Yt, pt as Xt, q as Zt, qt as Qt, r as $t, rr as en, rt as tn, s as nn, sn as rn, sr as an, st as on, t as sn, tr as cn, u as H, un as ln, ur as un, ut as dn, v as fn, vn as pn, vt as mn, wn as hn, wr as U, wt as gn, x as _n, xn as vn, xt as yn, y as bn, yn as xn, yr as Sn, yt as Cn, z as wn, zn as Tn, zt as En } from "./constants-DzQOOvgv.mjs";
+import { $ as n, $n as r, $r as i, $t as a, An as o, At as s, B as c, Bn as l, Bt as u, C as d, Cn as f, Cr as p, Ct as m, Dn as h, Dr as g, Dt as _, En as v, Er as y, Et as b, F as x, Fi as S, Fn as C, Ft as w, G as T, Gn as E, Gt as D, H as ee, Hn as O, Ht as k, I as A, In as j, Ir as M, It as te, J as ne, Jn as N, Jt as re, Kn as ie, Kt as ae, L as oe, Ln as se, Lr as ce, Lt as P, Mn as le, Mr as F, Mt as ue, Nn as de, Nr as fe, Nt as pe, Oi as me, On as I, Or as he, Ot as ge, P as _e, Pi as L, Pn as ve, Pt as ye, Q as be, Qn as xe, Qt as Se, R as Ce, Rn as we, Rt as Te, S as Ee, Sn as De, St as Oe, T as ke, Tn as Ae, Tr as je, Tt as Me, U as R, Un as Ne, Ut as Pe, Vn as Fe, Vt as Ie, W as Le, Wn as Re, Wt as ze, X as Be, Xn as Ve, Xt as He, Y as Ue, Yn as We, Yt as Ge, Z as Ke, Zn as qe, Zt as Je, _ as Ye, _n as Xe, _t as Ze, a as Qe, ar as $e, at as et, b as tt, bn as nt, bt as rt, c as it, ci as at, cn as ot, cr as st, ct as z, d as ct, dn as lt, dt as ut, en as dt, et as ft, f as pt, fn as mt, fr as ht, ft as gt, g as _t, gn as vt, gr as yt, gt as bt, h as xt, hn as St, ht as Ct, i as wt, in as Tt, ir as Et, it as Dt, jn as Ot, jt as kt, kn as At, kr as B, kt as jt, l as Mt, ln as Nt, lr as Pt, lt as Ft, mn as It, mr as Lt, mt as Rt, n as zt, nn as Bt, nr as Vt, nt as Ht, o as V, oi as Ut, on as Wt, or as Gt, ot as Kt, p as qt, pn as Jt, pr as Yt, pt as Xt, q as Zt, qt as Qt, r as $t, rr as en, rt as tn, s as nn, sn as rn, sr as an, st as on, t as sn, tr as cn, u as H, un as ln, ur as un, ut as dn, v as fn, vn as pn, vt as mn, wn as hn, wr as U, wt as gn, x as _n, xn as vn, xt as yn, y as bn, yn as xn, yr as Sn, yt as Cn, z as wn, zn as Tn, zt as En } from "./constants-C3-Lh6Fs.mjs";
 import { t as W } from "./objectSpread2-jlBcdYeb.mjs";
 import { n as G } from "./tw-DmW6-pCY.mjs";
 import { n as Dn } from "./lightweight-i18n-DJpMke7a.mjs";

package/dist/full.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/blok-gFn3FI95.cjs`),t=require(`./chunks/constants-DmKwEMyC.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-BcF1rHBg.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.Pi,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-C8_pY9Bg.cjs`),t=require(`./chunks/constants-R70ypRAK.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-DcbePIHF.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.Pi,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-C52qeiPg.mjs";
-import { Pi as n } from "./chunks/constants-DzQOOvgv.mjs";
+import { n as e, t } from "./chunks/blok-DCc23rzA.mjs";
+import { Pi as n } from "./chunks/constants-C3-Lh6Fs.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-CelSzJoA.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-fEI-EVng.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-gFn3FI95.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;return(0,n.useEffect)(()=>{o===null||!m||o.focus()},[o,m]),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))});exports.BlokContent=d,exports.useBlok=c;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-BL1yB9zm.cjs`);const e=require(`./chunks/blok-C8_pY9Bg.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;return(0,n.useEffect)(()=>{o===null||!m||o.focus()},[o,m]),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))});exports.BlokContent=d,exports.useBlok=c;

package/dist/react.mjs

@@ -1,4 +1,4 @@
-import { i as e, t } from "./chunks/blok-C52qeiPg.mjs";
+import { i as e, t } from "./chunks/blok-DCc23rzA.mjs";
 import { t as n } from "./chunks/objectSpread2-jlBcdYeb.mjs";
 import { forwardRef as r, useEffect as i, useMemo as a, useRef as o, useState as s } from "react";
 import { jsx as c } from "react/jsx-runtime";

package/dist/tools.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./chunks/constants-DmKwEMyC.cjs`),t=require(`./chunks/tools-BcF1rHBg.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-R70ypRAK.cjs`),t=require(`./chunks/tools-DcbePIHF.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-DzQOOvgv.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-CelSzJoA.mjs";
+import { m as e } from "./chunks/constants-C3-Lh6Fs.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-fEI-EVng.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.19.1",
+  "version": "0.19.2",
   "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",
@@ -149,8 +149,7 @@
     "mdast-util-gfm": "^3.1.0",
     "mdast-util-math": "^3.0.0",
     "micromark-extension-gfm": "^3.0.0",
-    "micromark-extension-math": "^3.1.0",
-    "nanoid": "5.1.9"
+    "micromark-extension-math": "^3.1.0"
   },
   "devDependencies": {
     "@aiden0z/pptx-renderer": "^1.1.0",
@@ -204,6 +203,7 @@
     "katex": "^0.16.44",
     "mermaid": "^11.15.0",
     "music-metadata": "^11.13.0",
+    "nanoid": "5.1.9",
     "playwright": "1.59.1",
     "postcss": "8.5.10",
     "prismjs": "^1.30.0",

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

@@ -416,7 +416,7 @@ export class BlocksAPI extends Module {
       return this.Blok.BlockManager.composeBlock({
         id,
         tool: type || (this.config.defaultBlock as string),
-        data: data as BlockToolData,
+        data: data,
         tunes,
         parentId: parent,
         contentIds: content,

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

@@ -516,7 +516,7 @@ export class BlockManager extends Module {
     // Those nested inserts sync to Yjs. If fromJSON() ran after, it would wipe
     // them (fromJSON replaces the entire Yjs array). Running fromJSON first
     // ensures nested blocks created during rendered() persist in Yjs.
-    const blockDataArray: OutputBlockData<string, Record<string, unknown>>[] = blocks.map(block => {
+    const blockDataArray: OutputBlockData[] = blocks.map(block => {
       const tunes = block.preservedTunes;
 
       return {
@@ -1410,7 +1410,7 @@ export class BlockManager extends Module {
    * @param blocks - the fully reconciled blocks about to be handed to Yjs
    */
   private assertInsertManyHierarchy(blocks: Block[]): void {
-    const snapshot: OutputBlockData<string, Record<string, unknown>>[] = blocks.map((block) => ({
+    const snapshot: OutputBlockData[] = blocks.map((block) => ({
       id: block.id,
       type: block.name,
       data: {},

package/src/components/modules/yjs/serializer.ts

@@ -6,7 +6,7 @@ import type { OutputBlockData } from '../../../../types/data-formats/output-data
  * Type alias for OutputBlockData with concrete types for the Yjs serializer.
  * Uses Record<string, unknown> for data to avoid the default `any` type.
  */
-export type YjsOutputBlockData = OutputBlockData<string, Record<string, unknown>>;
+export type YjsOutputBlockData = OutputBlockData;
 
 /**
  * Characters that mark potential undo checkpoint positions.

package/src/components/utils/data-model-transform.ts

@@ -33,7 +33,7 @@ type LegacyListItem = LegacyListItemObject | OldChecklistItem | string;
 /**
  * Legacy list data structure for data model transformation.
  */
-interface LegacyListData {
+type LegacyListData = {
   style: 'unordered' | 'ordered' | 'checklist';
   items: LegacyListItem[];
   start?: number;
@@ -45,7 +45,7 @@ interface LegacyListData {
  * Blok has no dedicated checklist tool — checklist is a style of the List tool —
  * so this is expanded into per-item flat `list` blocks with style 'checklist'.
  */
-interface LegacyChecklistData {
+type LegacyChecklistData = {
   items: LegacyListItem[];
 }
 
@@ -54,7 +54,7 @@ interface LegacyChecklistData {
  * Old format: { type: "linkTool", data: { link, meta: { title, description, image: { url }, favicon, domain } } }
  * Maps to Blok's flat Bookmark data shape (see types BookmarkMeta).
  */
-interface LegacyLinkToolData {
+type LegacyLinkToolData = {
   link: string;
   meta?: {
     title?: string;
@@ -70,7 +70,7 @@ interface LegacyLinkToolData {
  * Legacy toggle list data structure for data model transformation.
  * Old format: { title: string, isExpanded?: boolean, body: { blocks: [], time, version }, titleVariant?: number }
  */
-interface LegacyToggleListData {
+type LegacyToggleListData = {
   title: string;
   isExpanded?: boolean;
   titleVariant?: number;
@@ -85,7 +85,7 @@ interface LegacyToggleListData {
  * Legacy callout data structure for data model transformation.
  * Old format: { title?: string, body: { blocks: [] } | null, variant, emoji, isEmojiVisible }
  */
-interface LegacyCalloutData {
+type LegacyCalloutData = {
   title?: string;
   body?: {
     blocks?: OutputBlockData[];
@@ -311,7 +311,7 @@ const isLegacyToggleListBlock = (block: OutputBlockData): block is OutputBlockDa
     return false;
   }
 
-  const data = block.data as Record<string, unknown>;
+  const data = block.data;
 
   return typeof data === 'object' && data !== null && 'title' in data;
 };
@@ -326,7 +326,7 @@ const isLegacyCalloutBlock = (block: OutputBlockData): block is OutputBlockData<
     return false;
   }
 
-  const data = block.data as Record<string, unknown>;
+  const data = block.data;
 
   return typeof data === 'object' && data !== null && 'body' in data;
 };
@@ -761,7 +761,7 @@ const expandCalloutToHierarchical = (
  * can't silently lose information.
  */
 const expandImageToHierarchical = (block: OutputBlockData, warned: Set<string>): OutputBlockData => {
-  const rawData = (block.data ?? {}) as Record<string, unknown>;
+  const rawData = (block.data ?? {});
   const {
     file,
     url: flatUrl,
@@ -858,7 +858,7 @@ const expandLinkToolToHierarchical = (
 const expandQuoteToHierarchical = (block: OutputBlockData, warned: Set<string>): OutputBlockData[] => {
   warnLossyQuoteFields(block, warned);
 
-  const rawData = (block.data ?? {}) as Record<string, unknown>;
+  const rawData = (block.data ?? {});
   const { caption, alignment: _alignment, ...rest } = rawData;
 
   const quoteBlock: OutputBlockData = {
@@ -897,7 +897,7 @@ const expandQuoteToHierarchical = (block: OutputBlockData, warned: Set<string>):
  */
 const expandTableToHierarchical = (block: OutputBlockData): OutputBlockData[] => {
   const tableId = block.id ?? generateBlockId();
-  const rawData = (block.data ?? {}) as Record<string, unknown>;
+  const rawData = (block.data ?? {});
   const { content: _content, withHeadings, withHeadingColumn, stretched, ...restData } = rawData;
   const rows = getTableContentRows(rawData) ?? [];
   const childBlocks: OutputBlockData[] = [];
@@ -977,7 +977,7 @@ const WARNING_EMOJI = '⚠️';
  */
 const expandWarningToHierarchical = (block: OutputBlockData): OutputBlockData[] => {
   const calloutId = block.id ?? generateBlockId();
-  const data = (block.data ?? {}) as Record<string, unknown>;
+  const data = (block.data ?? {});
   const title = typeof data.title === 'string' ? data.title : '';
   const message = typeof data.message === 'string' ? data.message : '';
 
@@ -1021,7 +1021,7 @@ const expandWarningToHierarchical = (block: OutputBlockData): OutputBlockData[]
  * equivalent and is dropped + warned once per pass.
  */
 const expandAttachesToHierarchical = (block: OutputBlockData, warned: Set<string>): OutputBlockData => {
-  const data = (block.data ?? {}) as Record<string, unknown>;
+  const data = (block.data ?? {});
   const file = (typeof data.file === 'object' && data.file !== null ? data.file : {}) as Record<string, unknown>;
   const url = typeof file.url === 'string' ? file.url : '';
   const title = typeof data.title === 'string' ? data.title : undefined;
@@ -1389,7 +1389,7 @@ const isFlatModelCalloutBlock = (block: OutputBlockData): boolean => {
     return false;
   }
 
-  const data = block.data as Record<string, unknown>;
+  const data = block.data;
 
   return typeof data === 'object' && data !== null && !('body' in data);
 };
@@ -1404,7 +1404,7 @@ const processRootCalloutItem = (
 ): OutputBlockData => {
   markBlockAsProcessed(block.id, processedIds);
 
-  const data = block.data as Record<string, unknown>;
+  const data = block.data;
 
   // Map backgroundColor preset → variant
   const backgroundColor = data.backgroundColor as string | null | undefined;
@@ -1907,7 +1907,7 @@ export const reclaimDetachedTableCells = (blocks: OutputBlockData[]): OutputBloc
         });
       });
 
-      return { ...block, data: { ...(block.data as Record<string, unknown>), content: newContent } } as OutputBlockData;
+      return { ...block, data: { ...(block.data), content: newContent } } as OutputBlockData;
     }
 
     return block;

package/src/components/utils/popover/popover-desktop.ts

@@ -15,7 +15,7 @@ import { resolvePosition } from './popover-position';
 import { stripPopoverAttribute } from '../top-layer';
 import { twMerge } from '../tw';
 
-import type { PopoverParams } from '@/types/utils/popover/popover';
+import type { PopoverParams, Flipper as FlipperHandle } from '@/types/utils/popover/popover';
 import { PopoverEvent } from '@/types/utils/popover/popover-event';
 
 
@@ -51,9 +51,12 @@ if (typeof document !== 'undefined' && !(document as unknown as Record<string, u
  */
 export class PopoverDesktop extends PopoverAbstract {
   /**
-   * Flipper - module for keyboard iteration between elements
+   * Flipper - module for keyboard iteration between elements.
+   * Typed as the published structural handle so a reused flipper passed via
+   * params (also the handle type) assigns cleanly; `new Flipper()` is
+   * structurally assignable to it.
    */
-  public flipper: Flipper | undefined;
+  public flipper: FlipperHandle | undefined;
 
   /**
    * Popover nesting level. 0 value means that it is a root popover

package/src/components/utils/tooltip.ts

@@ -6,45 +6,12 @@ import {
 } from './top-layer';
 import { twJoin } from './tw';
 
-/**
- * Tooltip supported content
- */
-export type TooltipContent = HTMLElement | DocumentFragment | Node | string;
-
-/**
- * Base options interface for tooltips
- */
-export interface TooltipOptions {
-  /**
-   * Tooltip placement: top|bottom|left|right
-   */
-  placement?: string;
-
-  /**
-   * Tooltip top margin
-   */
-  marginTop?: number;
-
-  /**
-   * Tooltip left margin
-   */
-  marginLeft?: number;
-
-  /**
-   * Tooltip right margin
-   */
-  marginRight?: number;
+// TooltipContent / TooltipOptions are declared in the published types
+// (types/api/tooltip.d.ts) as the single source of truth, so the package's
+// declaration surface stays self-contained and never re-exports raw src.
+import type { TooltipContent, TooltipOptions } from '@/types/api/tooltip';
 
-  /**
-   * Tooltip bottom margin
-   */
-  marginBottom?: number;
-
-  /**
-   * Timout before showing
-   */
-  delay?: number;
-}
+export type { TooltipContent, TooltipOptions };
 
 const DEFAULT_OFFSET = 10;
 const TOOLTIP_ROLE = 'tooltip';

package/src/markdown/markdown-handler.ts

@@ -1,4 +1,3 @@
-import type { BlockToolData } from '../../types';
 import type { BlokModules } from '../types-internal/blok-modules';
 import type { SanitizerConfigBuilder } from '../components/modules/paste/sanitizer-config';
 import type { ToolRegistry } from '../components/modules/paste/tool-registry';
@@ -93,7 +92,7 @@ export class MarkdownHandler extends BasePasteHandler implements PasteHandler {
       BlockManager.composeBlock({
         id,
         tool: type,
-        data: blockData as BlockToolData,
+        data: blockData,
         parentId: parent,
       })
     );

package/types/api/tooltip.d.ts

@@ -1,7 +1,46 @@
 /**
  * Tooltip API
  */
-import {TooltipContent, TooltipOptions} from '../../src/components/utils/tooltip';
+
+/**
+ * Tooltip supported content
+ */
+export type TooltipContent = HTMLElement | DocumentFragment | Node | string;
+
+/**
+ * Base options interface for tooltips
+ */
+export interface TooltipOptions {
+  /**
+   * Tooltip placement: top|bottom|left|right
+   */
+  placement?: string;
+
+  /**
+   * Tooltip top margin
+   */
+  marginTop?: number;
+
+  /**
+   * Tooltip left margin
+   */
+  marginLeft?: number;
+
+  /**
+   * Tooltip right margin
+   */
+  marginRight?: number;
+
+  /**
+   * Tooltip bottom margin
+   */
+  marginBottom?: number;
+
+  /**
+   * Timeout before showing
+   */
+  delay?: number;
+}
 
 export interface Tooltip {
   /**

package/types/data-formats/output-data.d.ts

@@ -6,9 +6,12 @@ import { BlockId } from './block-id';
  * Output of one Tool
  *
  * @template Type - the string literal describing a tool type
- * @template Data - the structure describing a data object supported by the tool
+ * @template Data - the structure describing a data object supported by the tool.
+ *   Defaults to `Record<string, unknown>` (matching {@link BlockToolData}) so
+ *   reading saved block data is type-guarded: property access yields `unknown`,
+ *   not `any`. Pass a concrete shape for fully-typed access.
  */
-export interface OutputBlockData<Type extends string = string, Data extends object = any> {
+export interface OutputBlockData<Type extends string = string, Data extends object = Record<string, unknown>> {
   /**
    * Unique Id of the block
    */

package/types/index.d.ts

@@ -5,12 +5,11 @@
  */
 
 import {
-  Dictionary,
-  DictValue,
   BlokConfig,
   I18nConfig,
   I18nDictionary,
 } from './configs';
+import { InlineToolConstructable, InlineToolConstructorOptions } from './tools';
 
 import {
   Blocks,
@@ -81,8 +80,6 @@ export {
   LogLevels,
   ConversionConfig,
   I18nDictionary,
-  Dictionary,
-  DictValue,
   I18nConfig,
   UserInfo,
 } from './configs';

package/types/tools/database.d.ts

@@ -1,4 +1,4 @@
-import { BlockToolData } from './block-tool';
+import { BlockToolData } from './block-tool-data';
 import { OutputData } from '../data-formats/output-data';
 
 // ─── Property types ───

package/types/tools/header.d.ts

@@ -1,4 +1,5 @@
-import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions, BlockToolData } from './block-tool';
+import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions } from './block-tool';
+import { BlockToolData } from './block-tool-data';
 import { MenuConfig } from './menu-config';
 
 /**

package/types/tools/list.d.ts

@@ -1,4 +1,5 @@
-import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions, BlockToolData } from './block-tool';
+import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions } from './block-tool';
+import { BlockToolData } from './block-tool-data';
 import { MenuConfig } from './menu-config';
 
 /**

package/types/utils/popover/popover.d.ts

@@ -1,7 +1,48 @@
 import { PopoverItemParams } from './popover-item';
-import type { Flipper } from '../../../src/components/flipper';
 import { PopoverEvent } from './popover-event';
 
+/**
+ * Public surface of the internal keyboard-navigation Flipper that a popover
+ * exposes for reuse via {@link PopoverParams.flipper}.
+ *
+ * Declared structurally here (rather than imported from raw src) so the
+ * published declarations stay self-contained: a bare `import` of the package
+ * must never drag Blok's `.ts` source into a consumer's type program. The
+ * concrete Flipper is internal — consumers never construct it; it is only
+ * passed between Blok's own popovers.
+ */
+export interface Flipper {
+  /** True while the flipper is handling keyboard navigation. */
+  readonly isActivated: boolean;
+
+  /** Begin handling keyboard navigation over the given items. */
+  activate(items?: HTMLElement[], cursorPosition?: number): void;
+
+  /** Stop handling keyboard navigation. */
+  deactivate(): void;
+
+  /** Focus the first navigable item. */
+  focusFirst(): void;
+
+  /** Focus the item at the given position. */
+  focusItem(position: number, options?: { skipNextTab?: boolean }): void;
+
+  /** True if a navigable item currently has focus. */
+  hasFocus(): boolean;
+
+  /** Register a callback fired on each flip (navigation step). */
+  onFlip(cb: () => void): void;
+
+  /** Remove a previously registered flip callback. */
+  removeOnFlip(cb: () => void): void;
+
+  /** Toggle handling of keydown events originating from contenteditable targets. */
+  setHandleContentEditableTargets(value: boolean): void;
+
+  /** Whether keydown events from contenteditable targets are handled. */
+  getHandleContentEditableTargets(): boolean;
+}
+
 /**
  * Params required to render popover
  */