@jackuait/blok 0.14.0 → 0.14.1

package/dist/full.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-CZKdLM9-.cjs`);const e=require(`./chunks/blok-Da-GaWJ8.cjs`),t=require(`./chunks/constants-C-OQpSwB.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-DeTgjuIK.cjs`);var i={paragraph:{class:r.C,inlineToolbar:!0,config:{preserveBlank:!0}},header:{class:r.S,inlineToolbar:!0},list:{class:r.x,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.Yr,exports.Header=r.S,exports.Italic=r.c,exports.Link=r.s,exports.List=r.x,exports.Marker=r.o,exports.Paragraph=r.C,exports.Strikethrough=r.i,exports.Toggle=r.y,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`}),require(`./chunks/chunk-CZKdLM9-.cjs`);const e=require(`./chunks/blok-DbYIZS7_.cjs`),t=require(`./chunks/constants-DPty7Dc7.cjs`),n=require(`./chunks/objectSpread2-iNkE6aJh.cjs`),r=require(`./chunks/tools-BuCT1-J0.cjs`);var i={paragraph:{class:r.w,inlineToolbar:!0,config:{preserveBlank:!0}},header:{class:r.C,inlineToolbar:!0},list:{class:r.S,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.Yr,exports.Header=r.C,exports.Italic=r.c,exports.Link=r.s,exports.List=r.S,exports.Marker=r.o,exports.Paragraph=r.w,exports.Strikethrough=r.i,exports.Toggle=r.b,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,29 +1,29 @@
-import { n as e, t } from "./chunks/blok-PpFnlqXZ.mjs";
-import { Yr as n } from "./chunks/constants-DdfiMdC1.mjs";
+import { n as e, t } from "./chunks/blok-DuYqYpF7.mjs";
+import { Yr as n } from "./chunks/constants-DMVxzgHf.mjs";
 import { t as r } from "./chunks/objectSpread2-jlBcdYeb.mjs";
-import { C as i, S as a, a as o, c as s, i as c, l, n as u, o as d, s as f, t as p, x as m, y as h } from "./chunks/tools-omGeunql.mjs";
+import { C as i, S as a, a as o, b as s, c, i as l, l as u, n as d, o as f, s as p, t as m, w as h } from "./chunks/tools-BwY9bTlg.mjs";
 //#region src/full.ts
 var g = {
 	paragraph: {
-		class: i,
+		class: h,
 		inlineToolbar: !0,
 		config: { preserveBlank: !0 }
 	},
 	header: {
-		class: a,
+		class: i,
 		inlineToolbar: !0
 	},
 	list: {
-		class: m,
+		class: a,
 		inlineToolbar: !0
 	}
 }, _ = r(r({}, g), {}, {
-	bold: { class: l },
-	italic: { class: s },
-	marker: { class: d },
+	bold: { class: u },
+	italic: { class: c },
+	marker: { class: f },
 	underline: { class: o },
-	strikethrough: { class: c },
-	link: { class: f }
+	strikethrough: { class: l },
+	link: { class: p }
 });
 //#endregion
-export { t as Blok, l as Bold, n as DATA_ATTR, a as Header, s as Italic, f as Link, m as List, d as Marker, i as Paragraph, c as Strikethrough, h as Toggle, o as Underline, _ as allTools, p as defaultBlockTools, u as defaultInlineTools, g as defaultTools, e as version };
+export { t as Blok, u as Bold, n as DATA_ATTR, i as Header, c as Italic, p as Link, a as List, f as Marker, h as Paragraph, l as Strikethrough, s as Toggle, o as Underline, _ as allTools, m as defaultBlockTools, d as defaultInlineTools, g as defaultTools, e as version };

package/dist/react.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-CZKdLM9-.cjs`);const e=require(`./chunks/blok-Da-GaWJ8.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.r(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-CZKdLM9-.cjs`);const e=require(`./chunks/blok-DbYIZS7_.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.r(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 { r as e, t } from "./chunks/blok-PpFnlqXZ.mjs";
+import { r as e, t } from "./chunks/blok-DuYqYpF7.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`}),require(`./chunks/chunk-CZKdLM9-.cjs`);const e=require(`./chunks/constants-C-OQpSwB.cjs`),t=require(`./chunks/tools-DeTgjuIK.cjs`);exports.Bold=t.l,exports.Callout=t.v,exports.Code=t.p,exports.Column=t.u,exports.ColumnList=t.d,exports.Convert=e.m,exports.Database=t._,exports.DatabaseRow=t.g,exports.Divider=t.h,exports.Header=t.S,exports.Image=t.f,exports.InlineCode=t.r,exports.Italic=t.c,exports.Link=t.s,exports.List=t.x,exports.Marker=t.o,exports.Paragraph=t.C,exports.Quote=t.m,exports.Strikethrough=t.i,exports.Table=t.b,exports.Toggle=t.y,exports.Underline=t.a,exports.defaultBlockTools=t.t,exports.defaultInlineTools=t.n;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-CZKdLM9-.cjs`);const e=require(`./chunks/constants-DPty7Dc7.cjs`),t=require(`./chunks/tools-BuCT1-J0.cjs`);exports.Bold=t.l,exports.Callout=t.y,exports.Code=t.m,exports.Column=t.d,exports.ColumnList=t.f,exports.Columns=t.u,exports.Convert=e.m,exports.Database=t.v,exports.DatabaseRow=t._,exports.Divider=t.g,exports.Header=t.C,exports.Image=t.p,exports.InlineCode=t.r,exports.Italic=t.c,exports.Link=t.s,exports.List=t.S,exports.Marker=t.o,exports.Paragraph=t.w,exports.Quote=t.h,exports.Strikethrough=t.i,exports.Table=t.x,exports.Toggle=t.b,exports.Underline=t.a,exports.defaultBlockTools=t.t,exports.defaultInlineTools=t.n;

package/dist/tools.mjs

@@ -1,3 +1,3 @@
-import { m as e } from "./chunks/constants-DdfiMdC1.mjs";
-import { C as t, S as n, _ as r, a as i, b as a, c as o, d as s, f as c, g as l, h as u, i as d, l as f, m as p, n as m, o as h, p as g, r as _, s as v, t as y, u as b, v as x, x as S, y as C } from "./chunks/tools-omGeunql.mjs";
-export { f as Bold, x as Callout, g as Code, b as Column, s as ColumnList, e as Convert, r as Database, l as DatabaseRow, u as Divider, n as Header, c as Image, _ as InlineCode, o as Italic, v as Link, S as List, h as Marker, t as Paragraph, p as Quote, d as Strikethrough, a as Table, C as Toggle, i as Underline, y as defaultBlockTools, m as defaultInlineTools };
+import { m as e } from "./chunks/constants-DMVxzgHf.mjs";
+import { C as t, S as n, _ as r, a as i, b as a, c as o, d as s, f as c, g as l, h as u, i as d, l as f, m as p, n as m, o as h, p as g, r as _, s as v, t as y, u as b, v as x, w as S, x as C, y as w } from "./chunks/tools-BwY9bTlg.mjs";
+export { f as Bold, w as Callout, p as Code, s as Column, c as ColumnList, b as Columns, e as Convert, x as Database, r as DatabaseRow, l as Divider, t as Header, g as Image, _ as InlineCode, o as Italic, v as Link, n as List, h as Marker, S as Paragraph, u as Quote, d as Strikethrough, C as Table, a as Toggle, i as Underline, y as defaultBlockTools, m as defaultInlineTools };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackuait/blok",
-  "version": "0.14.0",
+  "version": "0.14.1",
   "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/components/modules/tools.ts

@@ -148,7 +148,9 @@ export class Tools extends Module {
      */
     const userTools = this.config.tools ?? {};
 
-    this.config.tools = deepMerge({}, this.internalTools, userTools);
+    this.config.tools = this.expandToolGroups(
+      deepMerge({}, this.internalTools, userTools)
+    );
 
     this.validateTools();
 
@@ -284,6 +286,60 @@ export class Tools extends Module {
     };
   }
 
+  /**
+   * Expand any registered tool "group" into the real block tools it provides.
+   *
+   * A tool class may expose a static `provides` map of `{ blockType: ToolClass }`.
+   * Registering such a class under any key (e.g. `columns: Columns`) registers
+   * the provided block tools (`column_list`, `column`) instead, and drops the
+   * group handle key — no block ever has the handle's type. Settings on the
+   * group entry forward to each provided sub-tool.
+   *
+   * Explicit entries always win over group-provided entries regardless of order.
+   * If two groups provide the same block type, the first-registered group wins.
+   */
+  private expandToolGroups(
+    tools: Record<string, ToolConstructable | ToolSettings>
+  ): Record<string, ToolConstructable | ToolSettings> {
+    const out: Record<string, ToolConstructable | ToolSettings> = {};
+
+    for (const name in tools) {
+      if (!Object.prototype.hasOwnProperty.call(tools, name)) {
+        continue;
+      }
+
+      const entry = tools[name];
+      const toolClass = isObject(entry) ? (entry as ToolSettings).class : entry;
+      const provides = (toolClass as { provides?: Record<string, ToolConstructable> } | undefined)?.provides;
+
+      if (!provides) {
+        out[name] = entry;
+        continue;
+      }
+
+      const groupSettings: Record<string, unknown> = isObject(entry)
+        ? Object.fromEntries(
+            // never forward the class ref or the internal-tool flag to sub-tools
+            Object.entries(entry).filter(([key]) => key !== 'class' && key !== 'isInternal')
+          )
+        : {};
+
+      const hasGroupSettings = Object.keys(groupSettings).length > 0;
+
+      Object.entries(provides).forEach(([blockType, providedClass]) => {
+        // Never clobber an entry already present — explicit registration wins.
+        if (blockType in out) {
+          return;
+        }
+
+        out[blockType] = hasGroupSettings ? { class: providedClass, ...groupSettings } : providedClass;
+      });
+      // The group handle key (`name`) is intentionally dropped: not a block type.
+    }
+
+    return out;
+  }
+
   /**
    * Tool prepare method success callback
    * @param {object} data - append tool to available list

package/src/tools/columns/index.ts

@@ -0,0 +1,21 @@
+import type { BaseToolConstructable } from '../../../types/tools';
+import { Column } from '../column';
+import { ColumnList } from '../column-list';
+
+/**
+ * Registration handle for the columns feature. Registering `Columns` under a
+ * single tool key (e.g. `columns`) expands to the two real block tools that
+ * back columns — `column_list` (the row container) and `column` (one slot).
+ *
+ * `Columns` is never instantiated as a block: no block has `type: 'columns'`.
+ * Saved JSON still contains `column_list` and `column` blocks. See
+ * docs/superpowers/specs/2026-06-08-single-key-columns-registration-design.md.
+ */
+export class Columns {
+  public static get provides(): { [blockType: string]: BaseToolConstructable } {
+    return {
+      column_list: ColumnList as unknown as BaseToolConstructable,
+      column: Column as unknown as BaseToolConstructable,
+    };
+  }
+}

package/src/tools/index.ts

@@ -34,6 +34,7 @@ export { CodeTool as Code } from './code';
 export { ImageTool as Image } from './image';
 export { ColumnList } from './column-list';
 export { Column } from './column';
+export { Columns } from './columns';
 
 // Inline tools
 export { BoldInlineTool as Bold } from '../components/inline-tools/inline-tool-bold';

package/types/tools/tool.d.ts

@@ -57,6 +57,18 @@ export interface BaseToolConstructable {
    */
   titleKey?: string;
 
+  /**
+   * Optional manifest declaring the block types this class supplies. A class
+   * with `provides` is a registration group/handle, not a renderable block:
+   * registering it under any key expands to the listed block tools, and the
+   * handle key itself is dropped (it is not a block type). Used to register a
+   * multi-block feature (e.g. columns -> column_list + column) under one key.
+   *
+   * Typed as BaseToolConstructable to avoid a circular import with
+   * BlockToolConstructable; the provided classes are block tools at runtime.
+   */
+  provides?: { [blockType: string]: BaseToolConstructable };
+
   /**
    * Tool`s prepare method. Can be async
    * @param data

package/types/tools-entry.d.ts

@@ -34,6 +34,13 @@ export const Image: BlockToolConstructable;
 export const Code: BlockToolConstructable;
 export const ColumnList: ColumnListConstructable;
 export const Column: ColumnConstructable;
+/**
+ * Columns group manifest: a single registration handle that expands to the
+ * `column_list` and `column` block tools. Register as `tools: { columns: Columns }`.
+ */
+export const Columns: BlockToolConstructable & {
+  readonly provides: { readonly [blockType: string]: BlockToolConstructable };
+};
 
 // Re-export data and config types for convenience
 export { HeaderData, HeaderConfig } from './tools/header';