@jackuait/blok 0.4.1-beta.4 → 0.4.1-beta.6

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

@@ -12,10 +12,17 @@ export type ToolboxConfig = ToolboxConfigEntry | ToolboxConfigEntry[];
  */
 export interface ToolboxConfigEntry {
   /**
-   * Tool title for Toolbox
+   * Tool title for Toolbox (human-readable fallback)
    */
   title?: string;
 
+  /**
+   * Translation key for the title (e.g., 'text', 'heading', 'bulletedList').
+   * Used to look up translations in the toolNames.* namespace.
+   * If provided, the translated value is used; otherwise falls back to title.
+   */
+  titleKey?: string;
+
   /**
    * HTML string with an icon for Toolbox
    */
@@ -24,7 +31,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;
 }
 
 /**

package/types/tools/tool.d.ts

@@ -51,6 +51,12 @@ export interface BaseToolConstructable {
    */
   title?: string;
 
+  /**
+   * Translation key for the tool title (e.g., 'bold', 'italic', 'link').
+   * Used to look up translations in the toolNames.* namespace.
+   */
+  titleKey?: string;
+
   /**
    * Tool`s prepare method. Can be async
    * @param data

package/types/tools-entry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Type definitions for @jackuait/blok/tools entry point
+ * Re-exports all built-in tools for easy importing
+ */
+
+import { HeaderConstructable, HeaderData, HeaderConfig } from './tools/header';
+import { ParagraphConstructable, ParagraphData, ParagraphConfig } from './tools/paragraph';
+import { ListConstructable, ListData, ListConfig, ListStyle } from './tools/list';
+import { InlineToolConstructable } from './tools/inline-tool';
+import { BlockTuneConstructable } from './block-tunes';
+import { ToolSettings } from './tools';
+
+// Block tools
+export const Paragraph: ParagraphConstructable;
+export const Header: HeaderConstructable;
+export const List: ListConstructable;
+
+// Re-export data and config types for convenience
+export { HeaderData, HeaderConfig } from './tools/header';
+export { ParagraphData, ParagraphConfig } from './tools/paragraph';
+export { ListData, ListConfig, ListStyle } from './tools/list';
+
+// Inline tools
+export const Bold: InlineToolConstructable;
+export const Italic: InlineToolConstructable;
+export const Link: InlineToolConstructable;
+export const Convert: InlineToolConstructable;
+
+// Block tunes
+export const Delete: BlockTuneConstructable;
+
+/**
+ * Default block tools configuration
+ */
+export const defaultBlockTools: {
+  readonly paragraph: { readonly inlineToolbar: true; readonly config: { readonly preserveBlank: true } };
+  readonly header: { readonly inlineToolbar: true };
+  readonly list: { readonly inlineToolbar: true };
+};
+
+/**
+ * Default inline tools configuration
+ */
+export const defaultInlineTools: {
+  readonly bold: {};
+  readonly italic: {};
+  readonly link: {};
+  readonly convertTo: {};
+};

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

@@ -134,11 +134,6 @@ export interface PopoverItemDefaultBaseParams {
    */
   title?: string;
 
-  /**
-   * @deprecated Use title instead
-   */
-  label?: string;
-
   /**
    * Item icon to be appeared near a title
    */
@@ -182,6 +177,12 @@ export interface PopoverItemDefaultBaseParams {
    */
   hint?: HintParams;
 
+  /**
+   * Custom data attributes to be added to the item element.
+   * Keys should be in camelCase (e.g., 'headerLevel' becomes 'data-header-level')
+   */
+  dataset?: Record<string, string>;
+
   /**
    * Popover item activation handler
    *