@jackuait/blok 0.11.1 → 0.12.1

package/LICENSE

@@ -175,7 +175,19 @@
 
    END OF TERMS AND CONDITIONS
 
-   Copyright © 2015-present CodeX
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2015-2025 CodeX
+   Copyright 2025-2026 JackUait
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

package/NOTICE

@@ -0,0 +1,10 @@
+Blok
+Copyright 2025-2026 JackUait
+
+This product includes software originally developed by CodeX
+(https://codex.so/) as Editor.js (https://github.com/codex-team/editor.js),
+Copyright 2015-2025 CodeX, licensed under the Apache License, Version 2.0.
+
+Blok was forked from Editor.js in November 2025 and has been substantially
+modified since. See CHANGELOG.md and the Git history for a record of
+changes made to the original files.

package/README.md

@@ -86,4 +86,10 @@ Visit the documentation site for:
 
 💬 **Join the Telegram channel**: [t.me/that_ai_guy](https://t.me/that_ai_guy)
 
-Follow for updates, discussions, and insights about Blok and other projects.
+Follow for updates, discussions, and insights about Blok and other projects.
+
+## License & Attribution
+
+Blok is licensed under the [Apache License 2.0](./LICENSE). See the [NOTICE](./NOTICE) file for attribution details.
+
+Blok was originally forked from [Editor.js](https://github.com/codex-team/editor.js) by [CodeX](https://codex.so/) in November 2025 and has been substantially reworked since. The Editor.js codebase remains © CodeX under Apache-2.0; subsequent Blok-specific changes are © JackUait, also under Apache-2.0.

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

@@ -965,6 +965,53 @@ const BLOCK_TYPE_TRANSFORMS = {
   delimiter: 'divider',
 };
 
+/**
+ * Migrate a single block object in-place semantics (returns a new object).
+ * Currently handles the legacy image shape `{ type: "image", data: { file: { url } } }`
+ * → `{ type: "image", data: { url, ...mapped } }`, mapping legacy editor.js
+ * flags onto Blok's ImageData (types/tools/image.d.ts):
+ *
+ *   - `withBorder: true`  → `frame: 'border'` (false: drop, default is 'none')
+ *   - `withBackground`    → drop entirely (no Blok equivalent)
+ *   - `stretched: true`   → `size: 'full'`   (false: drop)
+ *
+ * Unknown fields pass through untouched. Other block types pass through too;
+ * type renames are handled separately.
+ * @param {Object} block - block object with `type` and `data`
+ * @returns {Object} possibly migrated block
+ */
+function migrateLegacyBlockShape(block) {
+  if (!block || typeof block !== 'object' || Array.isArray(block)) {
+    return block;
+  }
+  if (block.type !== 'image' || !block.data || typeof block.data !== 'object') {
+    return block;
+  }
+  const file = block.data.file;
+
+  if (!file || typeof file !== 'object' || typeof file.url !== 'string') {
+    return block;
+  }
+
+  const {
+    file: _file,
+    withBorder,
+    withBackground: _withBackground,
+    stretched,
+    ...rest
+  } = block.data;
+
+  return {
+    ...block,
+    data: {
+      url: file.url,
+      ...rest,
+      ...(withBorder === true ? { frame: 'border' } : {}),
+      ...(stretched === true ? { size: 'full' } : {}),
+    },
+  };
+}
+
 /**
  * Apply block type transforms to JSON article data.
  * Renames legacy EditorJS block types to their Blok equivalents.
@@ -979,9 +1026,12 @@ function applyBlockTypeTransforms(jsonString) {
         return obj.map(transformBlocks);
       }
       if (obj !== null && typeof obj === 'object') {
+        // Migrate legacy block shapes (e.g. image { data: { file: { url } } })
+        // before recursing so the migrated shape is what children see.
+        const migrated = migrateLegacyBlockShape(obj);
         const result = {};
 
-        for (const [key, value] of Object.entries(obj)) {
+        for (const [key, value] of Object.entries(migrated)) {
           if (key === 'type' && typeof value === 'string' && BLOCK_TYPE_TRANSFORMS[value]) {
             result[key] = BLOCK_TYPE_TRANSFORMS[value];
           } else {

package/codemod/test.js

@@ -1241,6 +1241,101 @@ test('exports BLOCK_TYPE_TRANSFORMS constant', () => {
   assertEqual(BLOCK_TYPE_TRANSFORMS.delimiter, 'divider');
 });
 
+test('migrates legacy image { data: { file: { url } } } to { data: { url } }', () => {
+  const input = JSON.stringify({
+    blocks: [
+      { type: 'image', data: { file: { url: 'x.png' }, caption: 'c' } },
+    ],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].type, 'image');
+  assertEqual(parsed.blocks[0].data.url, 'x.png');
+  assertEqual(parsed.blocks[0].data.caption, 'c');
+  assertEqual(parsed.blocks[0].data.file, undefined, 'file wrapper must be dropped');
+});
+
+test('maps legacy image flags (withBorder, withBackground, stretched) to new image shape', () => {
+  const input = JSON.stringify({
+    blocks: [
+      {
+        type: 'image',
+        data: {
+          file: { url: 'x.png' },
+          caption: 'c',
+          withBorder: true,
+          withBackground: false,
+          stretched: true,
+        },
+      },
+    ],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'x.png');
+  assertEqual(parsed.blocks[0].data.caption, 'c');
+  assertEqual(parsed.blocks[0].data.frame, 'border');
+  assertEqual(parsed.blocks[0].data.size, 'full');
+  assertEqual(parsed.blocks[0].data.withBorder, undefined, 'withBorder must be dropped');
+  assertEqual(parsed.blocks[0].data.withBackground, undefined, 'withBackground must be dropped');
+  assertEqual(parsed.blocks[0].data.stretched, undefined, 'stretched must be dropped');
+  assertEqual(parsed.blocks[0].data.file, undefined, 'file wrapper must be dropped');
+});
+
+test('drops withBorder: false without adding frame', () => {
+  const input = JSON.stringify({
+    blocks: [{ type: 'image', data: { file: { url: 'u' }, withBorder: false } }],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'u');
+  assertEqual(parsed.blocks[0].data.frame, undefined, 'no frame on withBorder: false');
+  assertEqual(parsed.blocks[0].data.withBorder, undefined, 'withBorder must be dropped');
+});
+
+test('drops withBackground: true without any Blok equivalent', () => {
+  const input = JSON.stringify({
+    blocks: [{ type: 'image', data: { file: { url: 'u' }, withBackground: true } }],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'u');
+  assertEqual(parsed.blocks[0].data.withBackground, undefined, 'withBackground must be dropped');
+});
+
+test('drops stretched: false without adding size', () => {
+  const input = JSON.stringify({
+    blocks: [{ type: 'image', data: { file: { url: 'u' }, stretched: false } }],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'u');
+  assertEqual(parsed.blocks[0].data.size, undefined, 'no size on stretched: false');
+  assertEqual(parsed.blocks[0].data.stretched, undefined, 'stretched must be dropped');
+});
+
+test('passes unknown legacy image fields through (future-proof)', () => {
+  const input = JSON.stringify({
+    blocks: [{ type: 'image', data: { file: { url: 'u' }, customField: 'x' } }],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'u');
+  assertEqual(parsed.blocks[0].data.customField, 'x');
+});
+
+test('leaves already-migrated image blocks unchanged', () => {
+  const input = JSON.stringify({
+    blocks: [
+      { type: 'image', data: { url: 'x.png', caption: 'c' } },
+    ],
+  }, null, 2);
+  const result = applyBlockTypeTransforms(input);
+  const parsed = JSON.parse(result);
+  assertEqual(parsed.blocks[0].data.url, 'x.png');
+  assertEqual(parsed.blocks[0].data.caption, 'c');
+});
+
 // ============================================================================
 // Summary
 // ============================================================================

package/dist/blok.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-Kud-AIAt.cjs`);const e=require(`./chunks/blok-CNEP3LpI.cjs`),t=require(`./chunks/constants-DJjFgioo.cjs`);exports.Blok=e.t,exports.DATA_ATTR=t.ur,exports.version=e.n;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),require(`./chunks/chunk-Kud-AIAt.cjs`);const e=require(`./chunks/blok-k8Yo4v2F.cjs`),t=require(`./chunks/constants-DGaNl2M0.cjs`);exports.Blok=e.t,exports.DATA_ATTR=t.Pr,exports.version=e.n;