@jackuait/blok 0.4.3-beta.5 → 0.4.3-beta.7

package/src/tools/header/index.ts

@@ -16,6 +16,7 @@ import type {
   BlockToolData,
   PasteEvent,
   ToolboxConfig,
+  ToolboxConfigEntry,
   ConversionConfig,
   SanitizerConfig,
   PasteConfig,
@@ -60,6 +61,11 @@ export interface HeaderConfig {
   defaultLevel?: number;
   /** Level-specific overrides keyed by level number (1-6) */
   levelOverrides?: Record<number, HeaderLevelConfig>;
+  /**
+   * @internal Injected by BlockToolAdapter - merged toolbox entries.
+   * When present, renderSettings() will use these entries instead of the default levels.
+   */
+  _toolboxEntries?: ToolboxConfigEntry[];
 }
 
 /**
@@ -195,6 +201,19 @@ export class Header implements BlockTool {
    * @returns MenuConfig array
    */
   public renderSettings(): MenuConfig {
+    const toolboxEntries = this._settings._toolboxEntries;
+
+    /**
+     * If user provided custom toolbox entries, use them to build settings menu.
+     * This ensures block settings match the toolbox configuration.
+     */
+    if (toolboxEntries !== undefined && toolboxEntries.length > 0) {
+      return this.buildSettingsFromToolboxEntries(toolboxEntries);
+    }
+
+    /**
+     * Fall back to existing behavior using levels config
+     */
     return this.levels.map(level => {
       const translated = this.api.i18n.t(level.nameKey);
       const title = translated !== level.nameKey ? translated : level.name;
@@ -212,6 +231,60 @@ export class Header implements BlockTool {
     });
   }
 
+  /**
+   * Build settings menu items from toolbox entries.
+   * This allows users to customize which levels appear in block settings
+   * by configuring the toolbox.
+   *
+   * @param entries - Merged toolbox entries from user config
+   * @returns MenuConfig array
+   */
+  private buildSettingsFromToolboxEntries(entries: ToolboxConfigEntry[]): MenuConfig {
+    return entries.map(entry => {
+      const entryData = entry.data as { level?: number } | undefined;
+      const level = entryData?.level ?? this.defaultLevel.number;
+      const defaultLevel = Header.DEFAULT_LEVELS.find(l => l.number === level);
+      const fallbackTitle = defaultLevel?.name ?? `Heading ${level}`;
+
+      const title = this.resolveToolboxEntryTitle(entry, fallbackTitle);
+      const icon = entry.icon ?? defaultLevel?.icon ?? IconHeading;
+
+      return {
+        icon,
+        title,
+        onActivate: (): void => this.setLevel(level),
+        closeOnActivate: true,
+        isActive: this.currentLevel.number === level,
+        dataset: {
+          'blok-header-level': String(level),
+        },
+      };
+    });
+  }
+
+  /**
+   * Resolves the title for a toolbox entry.
+   * Priority: custom title > i18n key translation > fallback
+   *
+   * @param entry - Toolbox entry
+   * @param fallback - Fallback title if no custom title or translation found
+   * @returns Resolved title string
+   */
+  private resolveToolboxEntryTitle(entry: ToolboxConfigEntry, fallback: string): string {
+    if (entry.title !== undefined) {
+      return entry.title;
+    }
+
+    if (entry.titleKey === undefined) {
+      return fallback;
+    }
+
+    const namespacedKey = `toolNames.${entry.titleKey}`;
+    const translated = this.api.i18n.t(namespacedKey);
+
+    return translated !== namespacedKey ? translated : fallback;
+  }
+
   /**
    * Callback for Block's settings buttons
    *

package/src/tools/list/index.ts

@@ -226,10 +226,10 @@ export class ListItem implements BlockTool {
     return this._settings.itemSize;
   }
 
-  private static readonly DEFAULT_PLACEHOLDER = 'List';
+  private static readonly PLACEHOLDER_KEY = 'tools.list.placeholder';
 
   private get placeholder(): string {
-    return this.api.i18n.t(ListItem.DEFAULT_PLACEHOLDER);
+    return this.api.i18n.t(ListItem.PLACEHOLDER_KEY);
   }
 
   private applyItemStyles(element: HTMLElement): void {

package/types/api/i18n.d.ts

@@ -10,4 +10,12 @@ export interface I18n {
    * @returns Translated string, or the key itself if translation is missing
    */
   t(dictKey: string): string;
+
+  /**
+   * Check if a translation exists for the given key.
+   *
+   * @param dictKey - Full translation key to check
+   * @returns True if translation exists, false otherwise
+   */
+  has(dictKey: string): boolean;
 }