@jackuait/blok 0.6.0-beta.8 → 0.6.0

package/dist/vendor.LICENSE.txt

@@ -1,12 +1,12 @@
 Name: @babel/register
-Version: 7.28.3
+Version: 7.28.6
 License: MIT
 Private: false
 Description: babel require hook
 Repository: https://github.com/babel/babel.git
 Homepage: https://babel.dev/docs/en/next/babel-register
 Author: The Babel Team (https://babel.dev/team)
-License Copyright:
+License Text:
 ===
 
 MIT License
@@ -34,12 +34,116 @@ WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ---
 
+Name: lib0
+Version: 0.2.117
+License: MIT
+Private: false
+Repository: git+https://github.com/dmonad/lib0.git
+Homepage: https://github.com/dmonad/lib0#readme
+Author: Kevin Jahns <kevin.jahns@protonmail.com>
+License Text:
+===
+
+The MIT License (MIT)
+
+Copyright (c) 2019 Kevin Jahns <kevin.jahns@protonmail.com>.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Name: yjs
+Version: 13.6.29
+License: MIT
+Private: false
+Description: Shared Editing Library
+Repository: https://github.com/yjs/yjs.git
+Homepage: https://docs.yjs.dev
+Author: Kevin Jahns
+License Text:
+===
+
+The MIT License (MIT)
+
+Copyright (c) 2023
+  - Kevin Jahns <kevin.jahns@protonmail.com>.
+  - Chair of Computer Science 5 (Databases & Information Systems), RWTH Aachen University, Germany
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+---
+
+Name: nanoid
+Version: 5.1.6
+License: MIT
+Private: false
+Description: A tiny (118 bytes), secure URL-friendly unique string ID generator
+Repository: undefined
+Author: Andrey Sitnik <andrey@sitnik.ru>
+License Text:
+===
+
+The MIT License (MIT)
+
+Copyright 2017 Andrey Sitnik <andrey@sitnik.ru>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+---
+
 Name: html-janitor
 Version: 2.0.4
 License: null
 Private: false
 Repository: https://github.com/guardian/html-janitor.git
-License Copyright:
+License Text:
 ===
 
 Apache License
@@ -246,119 +350,15 @@ Apache License
 
 ---
 
-Name: lib0
-Version: 0.2.117
-License: MIT
-Private: false
-Repository: git+https://github.com/dmonad/lib0.git
-Homepage: https://github.com/dmonad/lib0#readme
-Author: Kevin Jahns <kevin.jahns@protonmail.com>
-License Copyright:
-===
-
-The MIT License (MIT)
-
-Copyright (c) 2019 Kevin Jahns <kevin.jahns@protonmail.com>.
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-Name: yjs
-Version: 13.6.28
-License: MIT
-Private: false
-Description: Shared Editing Library
-Repository: https://github.com/yjs/yjs.git
-Homepage: https://docs.yjs.dev
-Author: Kevin Jahns
-License Copyright:
-===
-
-The MIT License (MIT)
-
-Copyright (c) 2023
-  - Kevin Jahns <kevin.jahns@protonmail.com>.
-  - Chair of Computer Science 5 (Databases & Information Systems), RWTH Aachen University, Germany
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
----
-
-Name: nanoid
-Version: 5.1.6
-License: MIT
-Private: false
-Description: A tiny (118 bytes), secure URL-friendly unique string ID generator
-Repository: undefined
-Author: Andrey Sitnik <andrey@sitnik.ru>
-License Copyright:
-===
-
-The MIT License (MIT)
-
-Copyright 2017 Andrey Sitnik <andrey@sitnik.ru>
-
-Permission is hereby granted, free of charge, to any person obtaining a copy of
-this software and associated documentation files (the "Software"), to deal in
-the Software without restriction, including without limitation the rights to
-use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
-the Software, and to permit persons to whom the Software is furnished to do so,
-subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
-FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
-COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
-IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
-CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-
----
-
 Name: i18next
-Version: 25.7.3
+Version: 25.8.13
 License: MIT
 Private: false
 Description: i18next internationalization framework
 Repository: https://github.com/i18next/i18next.git
 Homepage: https://www.i18next.com
 Author: Jan Mühlemann <jan.muehlemann@gmail.com> (https://github.com/jamuhl)
-License Copyright:
+License Text:
 ===
 
 The MIT License (MIT)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jackuait/blok",
-  "version": "0.6.0-beta.8",
+  "version": "0.6.0",
   "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",
   "module": "dist/blok.mjs",
   "types": "./types/index.d.ts",
@@ -49,8 +49,9 @@
   "publishConfig": {
     "access": "public"
   },
+  "packageManager": "yarn@4.9.4",
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.19.0"
   },
   "keywords": [
     "blok",
@@ -118,73 +119,58 @@
     "url": "git+https://github.com/JackUait/blok.git"
   },
   "devDependencies": {
-    "@axe-core/playwright": "4.11.0",
-    "@babel/register": "7.28.3",
-    "@commitlint/cli": "20.1.0",
-    "@commitlint/config-conventional": "20.0.0",
-    "@playwright/test": "1.57.0",
+    "@axe-core/playwright": "4.11.1",
+    "@babel/register": "7.28.6",
+    "@commitlint/cli": "20.4.2",
+    "@commitlint/config-conventional": "20.4.2",
+    "@playwright/test": "1.58.2",
     "@size-limit/esbuild-why": "12.0.0",
     "@size-limit/preset-small-lib": "12.0.0",
-    "@storybook/addon-a11y": "10.1.11",
-    "@storybook/addon-vitest": "10.1.11",
-    "@storybook/html-vite": "10.1.11",
-    "@types/eslint-plugin-tailwindcss": "3",
-    "@types/node": "22.19.0",
-    "@vitest/browser-playwright": "4.0.14",
-    "@vitest/coverage-v8": "4.0.14",
-    "@vitest/ui": "4.0.14",
-    "autoprefixer": "10.4.22",
-    "chromatic": "13.3.4",
-    "eslint": "9.39.1",
+    "@storybook/addon-a11y": "10.2.13",
+    "@storybook/addon-vitest": "10.2.13",
+    "@storybook/html-vite": "10.2.13",
+    "@tailwindcss/vite": "4.2.1",
+    "@types/node": "25.3.2",
+    "@vitest/browser-playwright": "4.0.18",
+    "@vitest/coverage-v8": "4.0.18",
+    "@vitest/eslint-plugin": "1.6.9",
+    "@vitest/ui": "4.0.18",
+    "chromatic": "15.2.0",
+    "eslint": "10.0.2",
     "eslint-plugin-import": "2.32.0",
-    "eslint-plugin-jest": "29.2.1",
+    "eslint-plugin-jest": "29.15.0",
     "eslint-plugin-jest-dom": "^5.5.0",
-    "eslint-plugin-jsdoc": "61.4.1",
-    "eslint-plugin-playwright": "2.3.0",
-    "eslint-plugin-sonarjs": "3.0.5",
-    "eslint-plugin-storybook": "10.1.11",
-    "eslint-plugin-tailwindcss": "3.18.2",
-    "eslint-plugin-testing-library": "^7.15.4",
-    "eslint-plugin-vitest": "^0.5.4",
+    "eslint-plugin-jsdoc": "62.7.1",
+    "eslint-plugin-playwright": "2.7.1",
+    "eslint-plugin-sonarjs": "4.0.0",
+    "eslint-plugin-storybook": "10.2.13",
+    "eslint-plugin-tailwindcss": "4.0.0-beta.0",
+    "eslint-plugin-testing-library": "^7.16.0",
     "html-janitor": "2.0.4",
     "husky": "9.1.7",
-    "jscpd": "4.0.5",
-    "jsdom": "27.2.0",
-    "playwright": "1.57.0",
+    "jscpd": "4.0.8",
+    "jsdom": "28.1.0",
+    "playwright": "1.58.2",
     "postcss": "8.5.6",
-    "rollup-plugin-license": "3.6.0",
-    "semantic-release": "25.0.2",
-    "shiki": "^3.21.0",
+    "rollup-plugin-license": "3.7.0",
+    "semantic-release": "25.0.3",
+    "shiki": "^3.23.0",
     "size-limit": "12.0.0",
-    "storybook": "10.1.11",
-    "tailwindcss": "3",
+    "storybook": "10.2.13",
+    "tailwindcss": "4.2.1",
     "typescript": "5.9.3",
-    "typescript-eslint": "8.48.0",
-    "vite": "7.2.4",
-    "vite-plugin-css-injected-by-js": "3.1.0",
-    "vitest": "4.0.14",
+    "typescript-eslint": "8.56.1",
+    "vite": "7.3.1",
+    "vite-plugin-css-injected-by-js": "4.0.1",
+    "vitest": "4.0.18",
     "yaml": "^2.8.2"
   },
   "dependencies": {
-    "i18next": "25.7.3",
+    "i18next": "25.8.13",
     "nanoid": "5.1.6",
-    "yjs": "13.6.28"
+    "yjs": "13.6.29"
   },
-  "size-limit": [
-    {
-      "name": "Minimum (core only)",
-      "path": "src/variants/blok-minimum.ts",
-      "limit": "300 KB"
-    },
-    {
-      "name": "Normal (with tools)",
-      "path": "src/blok.ts",
-      "limit": "300 KB"
-    },
-    {
-      "name": "Maximum (all locales)",
-      "path": "src/variants/blok-maximum.ts",
-      "limit": "300 KB"
-    }
-  ]
+  "resolutions": {
+    "@typescript-eslint/utils": "8.56.1"
+  }
 }

package/src/blok.ts

@@ -111,6 +111,18 @@ class Blok {
   public exportAPI(blok: Core): void {
     const fieldsToExport = [ 'configuration' ];
     const destroy = (): void => {
+      // Mark all modules as destroyed first so any in-flight async work stops gracefully
+      Object.values(blok.moduleInstances)
+        .forEach((moduleInstance) => {
+          if (moduleInstance === undefined || moduleInstance === null) {
+            return;
+          }
+
+          if (isFunction((moduleInstance as { markDestroyed?: () => void }).markDestroyed)) {
+            (moduleInstance as { markDestroyed: () => void }).markDestroyed();
+          }
+        });
+
       Object.values(blok.moduleInstances)
         .forEach((moduleInstance) => {
           if (moduleInstance === undefined || moduleInstance === null) {

package/src/components/__module.ts

@@ -27,6 +27,27 @@ export class Module<T extends ModuleNodes = Record<string, HTMLElement>> {
 
   public nodes: T = {} as T;
 
+  /**
+   * Flag indicating whether this module's editor has been destroyed.
+   * After destruction, modules should refuse to perform work.
+   */
+  private _isDestroyed = false;
+
+  /**
+   * Returns true if the editor owning this module has been destroyed
+   */
+  public get isDestroyed(): boolean {
+    return this._isDestroyed;
+  }
+
+  /**
+   * Mark this module as destroyed. Called by the editor's destroy() method.
+   * After this, the module should refuse to perform further work.
+   */
+  public markDestroyed(): void {
+    this._isDestroyed = true;
+  }
+
   /**
    * Blok modules list
    * @type {BlokModules}

package/src/components/block/api.ts

@@ -1,5 +1,6 @@
 import type { BlockAPI as BlockAPIInterface } from '../../../types/api';
 import type { SavedData } from '../../../types/data-formats';
+import type { BlockTuneData } from '../../../types/block-tunes/block-tune-data';
 import type { BlockToolData, ToolConfig, ToolboxConfigEntry } from '../../../types/tools';
 
 import type { Block } from './index';
@@ -61,6 +62,22 @@ const BlockAPIConstructor = function BlockAPI(
       return block.selected;
     },
 
+    /**
+     * Last successfully extracted block tool data (synchronous)
+     * @returns {BlockToolData}
+     */
+    get preservedData(): BlockToolData {
+      return block.preservedData;
+    },
+
+    /**
+     * Last successfully extracted tune data (synchronous)
+     * @returns {{ [name: string]: BlockTuneData }}
+     */
+    get preservedTunes(): { [name: string]: BlockTuneData } {
+      return block.preservedTunes;
+    },
+
     /**
      * Set Block's stretch state
      * @param {boolean} state — state to set

package/src/components/block/style-manager.ts

@@ -10,9 +10,9 @@ export class StyleManager {
    * Tailwind styles for the Block elements
    */
   private static readonly styles = {
-    wrapper: 'relative opacity-100 my-[-0.5em] py-[0.5em] first:mt-0 [&_a]:cursor-pointer [&_a]:underline [&_a]:text-link [&_b]:font-bold [&_i]:italic',
+    wrapper: 'relative opacity-100 my-[-0.5em] py-[0.5em] first:mt-0 last:pb-0 last:mb-0 [&_a]:cursor-pointer [&_a]:underline [&_a]:text-link [&_b]:font-bold [&_i]:italic',
     content: 'relative mx-auto transition-colors duration-150 ease-out max-w-content',
-    contentSelected: 'bg-selection rounded-[4px] [&_[contenteditable]]:select-none [&_img]:opacity-55 [&_[data-blok-tool=stub]]:opacity-55',
+    contentSelected: 'bg-selection rounded-[4px] **:[[contenteditable]]:select-none [&_img]:opacity-55 **:data-[blok-tool=stub]:opacity-55',
     contentStretched: 'max-w-none',
   };
 
@@ -84,6 +84,10 @@ export class StyleManager {
    * @returns The CSS class string
    */
   public getContentClasses(selected: boolean, stretched: boolean): string {
+    if (selected && stretched) {
+      return twMerge(StyleManager.styles.content, StyleManager.styles.contentSelected, StyleManager.styles.contentStretched);
+    }
+
     if (selected) {
       return twMerge(StyleManager.styles.content, StyleManager.styles.contentSelected);
     }

package/src/components/block/tool-renderer.ts

@@ -163,19 +163,7 @@ export class ToolRenderer {
     this.addToolDataAttributes(pluginsContent, wrapper);
     contentNode.appendChild(pluginsContent);
 
-    // Call the tool's rendered lifecycle method if it exists
-    // Defer to next frame to ensure all blocks are registered
-    const rendered = this.toolInstance.rendered;
-    if (typeof rendered === 'function') {
-      const resolver = this.readyResolver;
-      const toolInstance = this.toolInstance;
-      requestAnimationFrame(() => {
-        rendered.call(toolInstance);
-        resolver?.();
-      });
-    } else {
-      this.readyResolver?.();
-    }
+    this.invokeRenderedLifecycle();
   }
 
   /**
@@ -192,19 +180,7 @@ export class ToolRenderer {
         this.addToolDataAttributes(resolvedElement, wrapper);
         contentNode.appendChild(resolvedElement);
 
-        // Call the tool's rendered lifecycle method if it exists
-        // Defer to next frame to ensure all blocks are registered
-        const rendered = this.toolInstance.rendered;
-        if (typeof rendered === 'function') {
-          const resolver = this.readyResolver;
-          const toolInstance = this.toolInstance;
-          requestAnimationFrame(() => {
-            rendered.call(toolInstance);
-            resolver?.();
-          });
-        } else {
-          this.readyResolver?.();
-        }
+        this.invokeRenderedLifecycle();
       })
       .catch((error) => {
         log(`Tool render promise rejected: %o`, 'error', error);
@@ -212,6 +188,33 @@ export class ToolRenderer {
       });
   }
 
+  /**
+   * Call the tool's rendered lifecycle method if it exists.
+   * Defers to next frame to ensure all blocks are registered.
+   * Always resolves readyResolver, even if rendered() throws.
+   */
+  private invokeRenderedLifecycle(): void {
+    const rendered = this.toolInstance.rendered;
+
+    if (typeof rendered === 'function') {
+      const resolver = this.readyResolver;
+      const toolInstance = this.toolInstance;
+      const name = this.name;
+
+      requestAnimationFrame(() => {
+        try {
+          rendered.call(toolInstance);
+        } catch (e) {
+          log(`${name}: rendered() threw: ${e instanceof Error ? e.message : String(e)}`, 'warn');
+        } finally {
+          resolver?.();
+        }
+      });
+    } else {
+      this.readyResolver?.();
+    }
+  }
+
   /**
    * Add data attributes to tool-rendered element based on tool name
    */
@@ -237,10 +240,10 @@ export class ToolRenderer {
       'empty:before:text-gray-text',
       'empty:before:cursor-text',
       'empty:before:content-[attr(data-blok-placeholder)]',
-      '[&[data-blok-empty=true]]:before:pointer-events-none',
-      '[&[data-blok-empty=true]]:before:text-gray-text',
-      '[&[data-blok-empty=true]]:before:cursor-text',
-      '[&[data-blok-empty=true]]:before:content-[attr(data-blok-placeholder)]',
+      'data-[blok-empty=true]:before:pointer-events-none',
+      'data-[blok-empty=true]:before:text-gray-text',
+      'data-[blok-empty=true]:before:cursor-text',
+      'data-[blok-empty=true]:before:content-[attr(data-blok-placeholder)]',
     ];
 
     if (placeholderText.length > 0) {