@jackuait/blok 0.4.2 → 0.4.3-beta.10

package/README.md

@@ -45,11 +45,11 @@ import { Header, Paragraph, List, Bold, Italic, Link } from '@jackuait/blok/tool
 const editor = new Blok({
   holder: 'editor',
   tools: {
-    header: Header,
-    paragraph: { class: Paragraph, inlineToolbar: true },
-    list: { class: List, inlineToolbar: true },
-  },
-  inlineTools: {
+    // Block tools - inlineToolbar is enabled by default
+    paragraph: Paragraph,
+    header: { class: Header, placeholder: 'Enter a heading' },
+    list: List,
+    // Inline tools
     bold: Bold,
     italic: Italic,
     link: Link,
@@ -60,6 +60,8 @@ const editor = new Blok({
 const data = await editor.save();
 ```
 
+Tool configuration is flat—no need for nested `config: {}`. Blok automatically extracts known settings (`class`, `inlineToolbar`, `shortcut`, etc.) and passes the rest to the tool.
+
 ### Entry Points
 
 | Entry Point | Description |

package/codemod/README.md

@@ -34,16 +34,30 @@ npx migrate-from-editorjs ./src --dry-run
 
 ### Import Transformations
 
+**EditorJS → Blok:**
 ```diff
 - import EditorJS from '@editorjs/editorjs';
-+ import Blok from '@jackuait/blok';
++ import { Blok } from '@jackuait/blok';
+
+- import EditorJS, { EditorConfig } from '@editorjs/editorjs';
++ import { Blok, BlokConfig } from '@jackuait/blok';
 
 - import Header from '@editorjs/header';
 - import Paragraph from '@editorjs/paragraph';
 - import List from '@editorjs/list';
-+ // Header is now bundled with Blok: use Blok.Header
-+ // Paragraph is now bundled with Blok: use Blok.Paragraph
-+ // List is now bundled with Blok: use Blok.List
++ import { Header, Paragraph, List } from '@jackuait/blok/tools';
+```
+
+**Blok default imports → named imports** (Blok only exports named exports):
+```diff
+- import Blok from '@jackuait/blok';
++ import { Blok } from '@jackuait/blok';
+
+- import Editor from '@jackuait/blok';
++ import { Blok as Editor } from '@jackuait/blok';
+
+- import Blok, { BlokConfig } from '@jackuait/blok';
++ import { Blok, BlokConfig } from '@jackuait/blok';
 ```
 
 ### Type Transformations
@@ -98,17 +112,25 @@ npx migrate-from-editorjs ./src --dry-run
 
 ### Tool Configuration Transformations
 
+Old Blok static property references are converted to direct imports:
 ```diff
 tools: {
--   header: Header,
--   paragraph: Paragraph,
--   list: List,
-+   header: Blok.Header,
-+   paragraph: Blok.Paragraph,
-+   list: Blok.List,
+-   header: Blok.Header,
+-   paragraph: Blok.Paragraph,
+-   list: Blok.List,
++   header: Header,
++   paragraph: Paragraph,
++   list: List,
 }
 ```
 
+Combined Blok imports are split into core and tools:
+```diff
+- import { Blok, Header, Paragraph, List } from '@jackuait/blok';
++ import { Blok } from '@jackuait/blok';
++ import { Header, Paragraph, List } from '@jackuait/blok/tools';
+```
+
 ### package.json Updates
 
 ```diff

package/codemod/migrate-editorjs-to-blok.js

@@ -388,6 +388,98 @@ function removeI18nMessages(content) {
 
 // Import transformations
 const IMPORT_TRANSFORMS = [
+  // ============================================================================
+  // Blok default import → named import transformations
+  // These handle cases where users incorrectly use default imports with Blok
+  // (Blok only exports named exports, not a default export)
+  // ============================================================================
+
+  // Combined default + named imports from @jackuait/blok: import Blok, { BlokConfig } from '@jackuait/blok'
+  // → import { Blok, BlokConfig } from '@jackuait/blok'
+  // IMPORTANT: Must come before regular default import patterns to avoid partial matching
+  {
+    pattern: /import\s+Blok\s*,\s*\{\s*([^}]+?)\s*\}\s*from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "import { Blok, $1 } from '@jackuait/blok'",
+    note: 'Converted combined default + named import to named import',
+  },
+  // Aliased combined: import Editor, { BlokConfig } from '@jackuait/blok'
+  {
+    pattern: /import\s+(\w+)\s*,\s*\{\s*([^}]+?)\s*\}\s*from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "import { Blok as $1, $2 } from '@jackuait/blok'",
+    note: 'Converted aliased combined default + named import to named import',
+  },
+  // Default import: import Blok from '@jackuait/blok' → import { Blok } from '@jackuait/blok'
+  {
+    pattern: /import\s+Blok\s+from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "import { Blok } from '@jackuait/blok'",
+    note: 'Converted default import to named import',
+  },
+  // Aliased default import: import Editor from '@jackuait/blok' → import { Blok as Editor } from '@jackuait/blok'
+  // Must check it's not followed by /tools or /types to avoid matching subpath imports
+  {
+    pattern: /import\s+(\w+)\s+from\s+['"]@jackuait\/blok['"](?!\/)/g,
+    replacement: "import { Blok as $1 } from '@jackuait/blok'",
+    note: 'Converted aliased default import to named import',
+  },
+  // Type-only default import: import type Blok from '@jackuait/blok'
+  {
+    pattern: /import\s+type\s+Blok\s+from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "import type { Blok } from '@jackuait/blok'",
+    note: 'Converted type-only default import to named import',
+  },
+  // Type-only aliased default import: import type Editor from '@jackuait/blok'
+  {
+    pattern: /import\s+type\s+(\w+)\s+from\s+['"]@jackuait\/blok['"](?!\/)/g,
+    replacement: "import type { Blok as $1 } from '@jackuait/blok'",
+    note: 'Converted type-only aliased default import to named import',
+  },
+  // Namespace import: import * as Blok from '@jackuait/blok' → import { Blok } from '@jackuait/blok'
+  {
+    pattern: /import\s+\*\s+as\s+Blok\s+from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "import { Blok } from '@jackuait/blok'",
+    note: 'Converted namespace import to named import',
+  },
+  // Aliased namespace import: import * as Editor from '@jackuait/blok'
+  {
+    pattern: /import\s+\*\s+as\s+(\w+)\s+from\s+['"]@jackuait\/blok['"](?!\/)/g,
+    replacement: "import { Blok as $1 } from '@jackuait/blok'",
+    note: 'Converted namespace import to named import with alias',
+  },
+  // Dynamic import with destructuring: const { default: Editor } = await import('@jackuait/blok')
+  {
+    pattern: /\{\s*default\s*:\s*(\w+)\s*\}\s*=\s*await\s+import\s*\(\s*['"]@jackuait\/blok['"]\s*\)/g,
+    replacement: "{ Blok: $1 } = await import('@jackuait/blok')",
+    note: 'Converted destructured dynamic import',
+  },
+  // Re-export default as named: export { default as Editor } from '@jackuait/blok'
+  {
+    pattern: /export\s+\{\s*default\s+as\s+(\w+)\s*\}\s*from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "export { Blok as $1 } from '@jackuait/blok'",
+    note: 'Converted default re-export to named export',
+  },
+  // Re-export default: export { default } from '@jackuait/blok'
+  {
+    pattern: /export\s+\{\s*default\s*\}\s*from\s+['"]@jackuait\/blok['"]/g,
+    replacement: "export { Blok } from '@jackuait/blok'",
+    note: 'Converted default re-export',
+  },
+  // Require with .default access: require('@jackuait/blok').default
+  {
+    pattern: /require\s*\(\s*['"]@jackuait\/blok['"]\s*\)\.default/g,
+    replacement: "require('@jackuait/blok').Blok",
+    note: 'Converted require().default to require().Blok',
+  },
+  // Destructured require with default: const { default: Editor } = require('@jackuait/blok')
+  {
+    pattern: /const\s+\{\s*default\s*:\s*(\w+)\s*\}\s*=\s*require\s*\(\s*['"]@jackuait\/blok['"]\s*\)/g,
+    replacement: "const { Blok: $1 } = require('@jackuait/blok')",
+    note: 'Converted destructured default require to named require',
+  },
+
+  // ============================================================================
+  // EditorJS → Blok transformations
+  // ============================================================================
+
   // EditorJS subpath imports (e.g., @editorjs/editorjs/types -> @jackuait/blok/types)
   {
     pattern: /from\s+['"]@editorjs\/editorjs\/([^'"]+)['"]/g,

package/codemod/test.js

@@ -956,6 +956,104 @@ test('removeI18nMessages does not change content without i18n', () => {
   assertEqual(result, input, 'Content should be unchanged');
 });
 
+// ============================================================================
+// Blok Default Import → Named Import Tests
+// ============================================================================
+
+console.log('\n🔄 Blok Default Import → Named Import Transformations\n');
+
+test('transforms Blok default import to named import', () => {
+  const input = `import Blok from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok } from '@jackuait/blok';`);
+});
+
+test('transforms aliased Blok default import to named import with alias', () => {
+  const input = `import Editor from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok as Editor } from '@jackuait/blok';`);
+});
+
+test('transforms combined Blok default + named import', () => {
+  const input = `import Blok, { BlokConfig } from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok, BlokConfig } from '@jackuait/blok';`);
+});
+
+test('transforms aliased combined Blok default + named import', () => {
+  const input = `import Editor, { BlokConfig } from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok as Editor, BlokConfig } from '@jackuait/blok';`);
+});
+
+test('transforms type-only Blok default import', () => {
+  const input = `import type Blok from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import type { Blok } from '@jackuait/blok';`);
+});
+
+test('transforms type-only aliased Blok default import', () => {
+  const input = `import type Editor from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import type { Blok as Editor } from '@jackuait/blok';`);
+});
+
+test('transforms namespace import from @jackuait/blok', () => {
+  const input = `import * as Blok from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok } from '@jackuait/blok';`);
+});
+
+test('transforms aliased namespace import from @jackuait/blok', () => {
+  const input = `import * as Editor from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `import { Blok as Editor } from '@jackuait/blok';`);
+});
+
+test('transforms destructured dynamic import from @jackuait/blok', () => {
+  const input = `const { default: Editor } = await import('@jackuait/blok');`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `const { Blok: Editor } = await import('@jackuait/blok');`);
+});
+
+test('transforms require().default from @jackuait/blok', () => {
+  const input = `const Blok = require('@jackuait/blok').default;`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `const Blok = require('@jackuait/blok').Blok;`);
+});
+
+test('transforms destructured require default from @jackuait/blok', () => {
+  const input = `const { default: Editor } = require('@jackuait/blok');`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `const { Blok: Editor } = require('@jackuait/blok');`);
+});
+
+test('transforms re-export default as named from @jackuait/blok', () => {
+  const input = `export { default as Editor } from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `export { Blok as Editor } from '@jackuait/blok';`);
+});
+
+test('transforms re-export default from @jackuait/blok', () => {
+  const input = `export { default } from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  assertEqual(result, `export { Blok } from '@jackuait/blok';`);
+});
+
+test('does not transform subpath imports from @jackuait/blok/tools', () => {
+  const input = `import Header from '@jackuait/blok/tools';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  // Should not match because of the /tools path
+  assertEqual(result, input);
+});
+
+test('does not transform named imports from @jackuait/blok', () => {
+  const input = `import { Blok, BlokConfig } from '@jackuait/blok';`;
+  const { result } = applyTransforms(input, IMPORT_TRANSFORMS);
+  // Named imports should not be transformed by the default import transforms
+  assertEqual(result, input);
+});
+
 // ============================================================================
 // Modular Import Tests (Strategy 5)
 // ============================================================================

package/dist/blok.mjs

@@ -1,5 +1,5 @@
-import { B as s, v as a } from "./chunks/blok-BjgH1REI.mjs";
-import { D as A } from "./chunks/inline-tool-convert-Bx5BVd8I.mjs";
+import { B as s, v as a } from "./chunks/blok-D85C_iyk.mjs";
+import { D as A } from "./chunks/inline-tool-convert-CYkcoF1r.mjs";
 export {
   s as Blok,
   A as DATA_ATTR,