@jackuait/blok 0.4.1-beta.5 → 0.4.1

package/dist/{index-Cl_5rkKS.mjs → index-CBkApZKo.mjs}

@@ -1,4 +1,4 @@
-import { t as f, a as i } from "./blok-DvN73wsH.mjs";
+import { t as f, a as i } from "./blok-BwPfU8ro.mjs";
 const a = {
   wrapper: i(
     "fixed z-[2] bottom-5 left-5",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackuait/blok",
-  "version": "0.4.1-beta.5",
+  "version": "0.4.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",
   "main": "dist/blok.umd.js",
   "module": "dist/blok.mjs",
@@ -53,7 +53,7 @@
     "release:rc": "./scripts/release.sh prerelease rc",
     "release:dry": "./scripts/release.sh release beta true",
     "storybook": "storybook dev -p 6006 --no-open",
-    "storybook:build": "storybook build",
+    "storybook:build": "storybook build --stats-json",
     "storybook:test": "vitest --project=storybook --run",
     "chromatic": "chromatic --exit-zero-on-changes",
     "release:beta": "npm version prerelease --preid=beta",

package/types/index.d.ts

@@ -144,6 +144,8 @@ export interface API {
 }
 
 import { HeaderConstructable } from './tools/header';
+import { ParagraphConstructable } from './tools/paragraph';
+import { ListConstructable } from './tools/list';
 
 /**
  * Main Blok class
@@ -156,6 +158,16 @@ declare class Blok {
    */
   public static Header: HeaderConstructable;
 
+  /**
+   * Paragraph tool bundled with Blok
+   */
+  public static Paragraph: ParagraphConstructable;
+
+  /**
+   * List tool bundled with Blok
+   */
+  public static List: ListConstructable;
+
   public isReady: Promise<void>;
 
   public blocks: Blocks;
@@ -217,4 +229,4 @@ declare class Blok {
 }
 
 export as namespace Blok;
-export default Blok;
+export default Blok;

package/types/tools/header.d.ts

@@ -11,6 +11,22 @@ export interface HeaderData extends BlockToolData {
   level: number;
 }
 
+/**
+ * Level-specific overrides for customization
+ */
+export interface HeaderLevelConfig {
+  /** Custom HTML tag to use (e.g., 'div', 'p', 'span') */
+  tag?: string;
+  /** Custom display name for this level */
+  name?: string;
+  /** Custom font size (e.g., '3em', '24px') */
+  size?: string;
+  /** Custom margin top (e.g., '20px', '1rem') */
+  marginTop?: string;
+  /** Custom margin bottom (e.g., '10px', '0.5rem') */
+  marginBottom?: string;
+}
+
 /**
  * Header Tool's configuration
  */
@@ -21,6 +37,8 @@ export interface HeaderConfig {
   levels?: number[];
   /** Default level */
   defaultLevel?: number;
+  /** Level-specific overrides keyed by level number (1-6) */
+  levelOverrides?: Record<number, HeaderLevelConfig>;
 }
 
 /**

package/types/tools/index.d.ts

@@ -12,6 +12,7 @@ export * from './paste-events';
 export * from './hook-events';
 export * from './menu-config';
 export * from './header';
+export * from './list';
 
 export type Tool = BlockTool | InlineTool | BlockTune;
 export type ToolConstructable = BlockToolConstructable | InlineToolConstructable | BlockTuneConstructable;

package/types/tools/list.d.ts

@@ -0,0 +1,84 @@
+import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions, BlockToolData } from './block-tool';
+import { MenuConfig } from './menu-config';
+
+/**
+ * List styles enum
+ */
+export type ListStyle = 'unordered' | 'ordered' | 'checklist';
+
+/**
+ * Single list item data
+ */
+export interface ListItem {
+  /** Item content (can include HTML) */
+  content: string;
+  /** Checked state for checklist items */
+  checked?: boolean;
+  /** Nested items for indentation */
+  items?: ListItem[];
+}
+
+/**
+ * List Tool's input and output data format
+ */
+export interface ListData extends BlockToolData {
+  /** List style: unordered, ordered, or checklist */
+  style: ListStyle;
+  /** Array of list items */
+  items: ListItem[];
+}
+
+/**
+ * List Tool's configuration
+ */
+export interface ListConfig {
+  /** Default list style */
+  defaultStyle?: ListStyle;
+  /** Available list styles */
+  styles?: ListStyle[];
+  /** List styles to show in the toolbox */
+  toolboxStyles?: ListStyle[];
+  /** Custom color for list items */
+  itemColor?: string;
+  /** Custom font size for list items */
+  itemSize?: string;
+}
+
+/**
+ * List Tool for the Blok Editor
+ * Provides Ordered, Unordered, and Checklist Blocks
+ */
+export interface List extends BlockTool {
+  /**
+   * Return Tool's view
+   */
+  render(): HTMLElement;
+
+  /**
+   * Returns list block tunes config
+   */
+  renderSettings(): MenuConfig;
+
+  /**
+   * Method that specified how to merge two List blocks.
+   * Called by Editor by backspace at the beginning of the Block
+   */
+  merge(data: ListData): void;
+
+  /**
+   * Validate List block data
+   */
+  validate(blockData: ListData): boolean;
+
+  /**
+   * Extract Tool's data from the view
+   */
+  save(): ListData;
+}
+
+/**
+ * List Tool constructor
+ */
+export interface ListConstructable extends BlockToolConstructable {
+  new(config: BlockToolConstructorOptions<ListData, ListConfig>): List;
+}

package/types/tools/paragraph.d.ts

@@ -0,0 +1,71 @@
+import { BlockTool, BlockToolConstructable, BlockToolConstructorOptions, BlockToolData } from './block-tool';
+
+/**
+ * Paragraph Tool's input and output data format
+ */
+export interface ParagraphData extends BlockToolData {
+  /** Paragraph's content. Can include HTML tags: <a><b><i> */
+  text: string;
+}
+
+/**
+ * Style overrides for paragraph customization
+ */
+export interface ParagraphStyleConfig {
+  /** Custom font size (e.g., '16px', '1rem') */
+  size?: string;
+  /** Custom line height (e.g., '1.6', '24px') */
+  lineHeight?: string;
+  /** Custom margin top (e.g., '10px', '0.5rem') */
+  marginTop?: string;
+  /** Custom margin bottom (e.g., '10px', '0.5rem') */
+  marginBottom?: string;
+}
+
+/**
+ * Paragraph Tool's configuration
+ */
+export interface ParagraphConfig {
+  /** Placeholder for the empty paragraph */
+  placeholder?: string;
+  /** Whether or not to keep blank paragraphs when saving editor data */
+  preserveBlank?: boolean;
+  /** Style overrides for paragraph customization */
+  styles?: ParagraphStyleConfig;
+  /** Custom icon SVG string for the toolbox */
+  icon?: string;
+}
+
+/**
+ * Paragraph Tool for the Blok Editor
+ * Provides Text Block
+ */
+export interface Paragraph extends BlockTool {
+  /**
+   * Return Tool's view
+   */
+  render(): HTMLDivElement;
+
+  /**
+   * Method that specified how to merge two Paragraph blocks.
+   * Called by Editor by backspace at the beginning of the Block
+   */
+  merge(data: ParagraphData): void;
+
+  /**
+   * Validate Paragraph block data
+   */
+  validate(savedData: ParagraphData): boolean;
+
+  /**
+   * Extract Tool's data from the view
+   */
+  save(toolsContent: HTMLDivElement): ParagraphData;
+}
+
+/**
+ * Paragraph Tool constructor
+ */
+export interface ParagraphConstructable extends BlockToolConstructable {
+  new(config: BlockToolConstructorOptions<ParagraphData, ParagraphConfig>): Paragraph;
+}

package/types/tools/tool-settings.d.ts

@@ -24,7 +24,14 @@ export interface ToolboxConfigEntry {
   /**
    * May contain overrides for tool default data
    */
-  data?: BlockToolData
+  data?: BlockToolData;
+
+  /**
+   * Unique name for the toolbox entry, used for data-blok-item-name attribute.
+   * If not provided, falls back to the tool name.
+   * Useful when a tool has multiple toolbox entries (e.g., list with ordered/unordered/checklist variants).
+   */
+  name?: string;
 }
 
 /**