Skip to content
Version History

Changelog

Track every improvement, fix, and feature as Blok evolves

  1. v1.4.2PatchJul 23, 2026
    FixedMarkdown — Typing a list marker (- , 1. ) inside a heading no longer converts the heading into a list; it stays a heading.
  2. v1.4.1PatchJul 23, 2026
    FixedEditor — Enter now honours the IME composition and Shift contract; added an onError channel; data-blok-tool is opt-in.
    FixedSanitize — Redundant inline markup is now collapsed on every path that stores HTML.
    FixedVideo — Unplayable sources are surfaced to the user instead of rendering a black player.
    FixedView — Added a classList facade so MarkSpec inline tools render correctly in BlokView.
    Fixedi18n — Localized video stats and database overflow, added tr() interpolation, and completed locale audits across Yiddish, Vietnamese, Traditional and Simplified Chinese, Urdu, Ukrainian, Uyghur, Turkish, Thai, Telugu, Tamil, Swahili, Serbian, Albanian and Slovenian.
  3. v1.4.0MinorJul 23, 2026

    Marks — New range-aware api.marks inline-formatting engine, with the built-in bold/italic/underline/strikethrough tools migrated onto it. Exposes MarkSpec identity/family/transparent semantics for authoring custom inline tools.

    AddedMarks — New range-aware api.marks inline-formatting engine, with the built-in bold/italic/underline/strikethrough tools migrated onto it. Exposes MarkSpec identity/family/transparent semantics for authoring custom inline tools.
    AddedView renderer — New synchronous, DOM-free view renderer published at @bloklabs/core/view (defineBlokSchema + a central dispatcher, plus a React BlokView), for rendering stored block content without booting a full editor.
    Addedi18n — New runtime editor.i18n.update() API that makes config.i18n live and repaints already-rendered block DOM, wired reactively through all three adapters.
    AddedConfig — Reactive contract for readOnly, hideToolbar and inlineToolbar: setting them after construction now takes effect live across the React, Vue and Angular adapters (with sanitize-cache invalidation on inlineToolbar).
    AddedReadiness — Scoped, reactive editor readiness: whenAllReady({ within, settleOn }), readyState/subscribeReady, and a useBlokReady hook in all three adapters.
    AddedDocs — The documentation site is now crawlable (prerendered metadata, sitemap, AI mirrors) and carries Google Analytics coverage across pages.
    AddedPlayground — Dev settings panel gains a language picker and an RTL toggle.
    FixedMarks — Fixed the trailing-whitespace extension eating later content when a mark ended on a boundary.
    FixedStyles — Surface background tokens (--blok-bg-light/-secondary/-tertiary) are now a test-enforced public contract; the gutter stays put in plain read-only so readOnly flips no longer shift layout.
    FixedTypes — MarkSpec is now imported into the main declaration entry so it resolves for consumers.
    FixedDocs — Russian pages are headed by their localized H1; @bloklabs/core/view resolves in the docs build and React fixtures.
    FixedRelease — The Angular README is now staged into the directory npm packs.
    Fixedi18n — Locale audits completed across Slovak, Sinhala, Sindhi, Russian, Romanian, Portuguese, Pashto, Polish, Punjabi, Norwegian, Dutch, Nepali, Burmese, Malay, Marathi, Mongolian, Malayalam, Macedonian, Latvian, Lithuanian, Lao, Sorani, Korean and Kannada.
    ChangedMigrated the docs site to React Router framework mode.
    ChangedRenamed the default branch from master to main.
    ChangedCompleted npm metadata across the package family and hardened the view/reactive-contract law tests.
  4. v1.3.0MinorJul 21, 2026

    API — New public editor.tokens getter/setter for runtime --blok-* theme tokens, with replace semantics and pre-ready buffering (like theme/width/placeholder). Wired reactively through all three adapters: React style.tokens, Vue style.tokens, Angular [styleTokens]. --blok-content-max-width is now honored by database centring and toolbar control placement.

    AddedAPI — New public editor.tokens getter/setter for runtime --blok-* theme tokens, with replace semantics and pre-ready buffering (like theme/width/placeholder). Wired reactively through all three adapters: React style.tokens, Vue style.tokens, Angular [styleTokens]. --blok-content-max-width is now honored by database centring and toolbar control placement.
    AddedTools — Custom-tool authoring fixes: tools.update(name, { toolbox }) now flips a tool's toolbox entry at runtime (permission-style insert gating no longer requires recreating the editor), including its insertion shortcut; React createReactBlock accepts a viewComponent rendered while the editor is read-only; React toolbox icons may be React elements; commit() echo idempotency is now a documented public contract.
    AddedEmbed — Google Docs/Sheets/Slides/Forms/Drive embeds render at a user-adjustable pixel height with a bottom resize handle (200–2000px), persisted to data.height. Aspect-ratio media providers (YouTube, Vimeo, …) are unchanged.
    FixedCDN bundles — dist/blok.iife.js and dist/blok.umd.js shipped zero generated Tailwind utilities since the v3→v4 migration, so every unpkg/jsDelivr consumer loaded an unstyled editor. Both configs now run the Tailwind plugin (+34KB gzip each), guarded by a dist-level assertion.
    FixedAdapters — Five root causes from a downstream audit: a stale controlled-data echo no longer clobbers the caret (bounded echo window instead of last-payload-only dedup); equalsOutputData compares block ids only when both sides carry one; React inline tools accept a titleKey for localization; the zero-specificity gutter default is a test-enforced public contract.
    FixedDependencies — Seven phantom dependencies (bare imports resolving only via hoisting, including @testing-library/jest-dom used by the global unit setup) are now declared, with a law test preventing new ones.
    Fixedi18n — Review passes completing Armenian, Croatian, Dhivehi, Filipino, Georgian, Gujarati, Hebrew, Hungarian, Indonesian, Japanese, Kannada and Khmer, plus tool interpolation variable forwarding.
    ChangedUpgraded to Node 26, Angular 22 and TypeScript 6, then root-caused six defects the upgrade shipped green — most importantly the entire unit-angular vitest project loading zero tests (a fake green), and the docs test suite missing the Node 26 webstorage guard.
    ChangedLocal E2E suite runtime cut from ~47.5 min to ~10 min (parallel/skip-when-fresh build:test, shared page per worker), plus broad E2E stabilization.
    ChangedFixed ESLint cache poisoning that replayed stale errors in CI lint runs.
  5. v1.2.6PatchJul 20, 2026
    AddedPaste — Google Docs tables used as fake column layouts (every row has exactly 2 or 3 cells) now paste as real column layouts instead of table blocks. Genuine tables (4+ columns, ragged rows, single column, Google Sheets, nested tables) still paste as tables.
    AddedAPI — Four first-class capabilities replacing host workarounds: a style.nativeSelection config opt-out for the forced ::selection repaint, public --blok-block-padding-top/-bottom/-inline tokens for compact read-only rendering, a static Blok.whenAllReady() collective-readiness aggregate, and createReactInlineTool in the React adapter with a full inline-tool destroy() lifecycle.
    FixedData integrity — Three silent data-loss defects fixed: code containing < was corrupted on render and save (if (a<b) became if (a), empty code blocks were dropped on save, and a document whose only block was / saved as empty. Tools can now declare a field as literal text via a PLAINTEXT sanitizer rule.
    FixedCaret — Highlighting a non-focusable block now blurs stale input focus, so Chromium can no longer restore the current block from a stale collapsed range.
    Fixedi18n — Locale audit corrections across dozens of locales, including Dutch color labels and shared toggle guidance.
  6. v1.2.5PatchJul 20, 2026
    Addedi18n — New Taiwan Traditional Chinese locale (zh-TW) with its own emoji dictionary, bringing the corpus to 69 locale variants. A full audit pass over every shipped locale corrected terminology and localized previously hardcoded runtime strings (media captions, database defaults, emoji category scopes, recent color labels, action search, move announcements), with hardened locale validation.
    AddedTheming — New style.tokens config lets each editor instance pass --blok-* token overrides that also reach body-mounted UI (popovers, menus). The edit-mode gutter now defaults to 56px and is owned by Blok, checklists get a dedicated padding token (falling back to the list token), hideToolbar config now actually hides the toolbar and collapses the gutter, and --blok-placeholder-color is a public hook.
    AddedInline toolbar — Restructured as a card with a convert row plus a five-column tool grid, including a new clear-format tool and redrawn toggle-heading icons.
    AddedColor — Text and background tunes merged into a single Color submenu; the color picker gained a Recently Used section remembering the last 5 colors; slash-menu color command titles are localized.
    AddedTable — Compact/comfortable text-size switch, grouped with density under a text-size submenu.
    AddedHeader — Heading level converts are grouped under a heading submenu in block settings.
    AddedImage — Overlay controls use discrete size tiers (full/medium/compact) instead of fluid scaling, keeping them legible at small widths.
    AddedData compatibility — Editor.js-shaped data is accepted losslessly: null-tolerant LooseOutputData inputs, public equalsOutputData/isEmptyOutputData utilities, echo-safe blocks.render() (re-rendering identical data is a no-op), and a synchronous isRendered flag.
    FixedPopovers — Block-settings menu placement fixes: the menu centers on the six-dots handle, stays attached to it near viewport edges, never touches the screen border, and submenus always open to the right and appear only when hovering the trigger or the submenu itself; page scroll is locked while the menu is open.
    FixedEditor — Toggle-heading level conversion no longer strands child blocks in a detached DOM (silent data loss); a save-time invariant gate now rejects stranded holders outright.
    FixedAdapters/Core — Six consumer runtime workarounds root-caused and fixed in core, types, and adapters.
    FixedUI — Inputs show a single focus indicator (no double border), and the popover search icon was removed.
    FixedAccessibility — Move and duplicate announcements are count-neutral and carry correct totals; search results announcements keep their context.
    ChangedCI — Shorter critical path (parallel build start, faster lint), with contract tests enforcing the workflow shape.
    ChangedTests — Animation-frame APIs polyfilled for jsdom environments; extreme-position e2e sweeps guard menu placement at screen edges.
  7. v1.2.4PatchJul 18, 2026
    Fixedi18n — Capitalized toolNames keys (e.g. toolNames.TestTool) resolve again in the toolbox: the lookup now tries the raw tool name first, then the capitalized key, restoring the published contract that 1.2.3's raw-name lookup silently dropped. An empty toolbox title no longer short-circuits the fallback chain and renders a blank slash-menu item — it is treated as absent and falls back to the capitalized tool name.
    ChangedCI — The docs site now deploys only on package releases, and the deploy is gated by a verifier that checks the published packages (tied to the release version family) before the site goes live.
  8. v1.2.3PatchJul 18, 2026
    AddedTheming — More host customization hooks: heading tokens (keyed off data-blok-heading-level) and embed tokens, a --blok-list-gap token for list spacing, and palette tokens declared at zero specificity via :where() so host overrides always win. --blok-content-max-width is now authoritative when the editor is in width: 'full' mode.
    AddedRead-only — The editor wrapper is stamped with data-blok-readonly as a public styling hook, and the block-controls gutter auto-collapses in read-only mode so content uses the full column.
    AddedAdapters — The three React-integration workarounds were removed by fixing their root causes in core.
    Fixedi18n — Custom tool titles now localize via toolNames.<toolName> dictionary keys.
    FixedImage — GIF→video auto-conversion is skipped when no video tool is registered, instead of failing the upload.
    ChangedBuild — dist/ output is now minified and JSON data is emitted as JSON.parse strings, cutting published bundle weight.
    ChangedDocs — Documented the theming hooks, data-blok-readonly attribute, contentAlign, toolbox: false gating, the GIF guard, the readOnly object form, and toolNames keys.
  9. v1.2.2PatchJul 17, 2026
    AddedTheming — New public --blok-* custom properties let host apps customize editor layout without reaching into internals: --blok-content-max-width (content column cap), --blok-editor-gutter-start/--blok-editor-gutter-end (space reserved for the floating block controls, RTL-correct), --blok-list-padding-start (list indent), and --blok-search-input-placeholder (popover search placeholder color). Defaults preserve current behavior; documented in the docs-site Styles API section.
    AddedReact — First-class block authoring: createReactBlock renders block tools authored as React components through a shared portal host inside the host app's React tree, so app-level context (providers, themes, stores) reaches block components directly — no more createRoot per block or context bridges. Every function in a tool's config (including nested ones like uploader.uploadByFile) is now re-bound to the latest render's closure, so inline closures work without freezing identities or recreating the editor.
    FixedFloating UI — A hardening sweep across every floating surface: popovers anchored inside nested scroll containers no longer drift or detach on scroll (snapshot anchors, virtual selection anchors, and fixed-position menus all track correctly); tooltips dismiss on nested scroll; the emoji picker and link hover card follow moving anchors; root boundary calculation is normalized for scrolled and 100vh host bodies. An architecture test now enforces that all floating UI goes through the central positioning module.
    FixedRenderer — Stored block data is now sanitized on render with the same per-tool sanitize config the Saver applies, closing stored-HTML injection for legacy data that never round-tripped through save (e.g. a raw <iframe width> baked into paragraph text overflowing its column). Fixed-width iframes/embeds are additionally capped at max-width: 100%.
    FixedLink — The hover card now requires actual pointer motion before opening, so it no longer opens when a link merely renders or scrolls under a stationary cursor.
    ChangedRelease — Preflight (eslint ∥ tsc ∥ vitest) and build pipelines were parallelized (~2× faster wall clock), with per-step timeouts so a hung build can no longer stall a release. GitHub Packages mirror tarballs now rewrite @bloklabs/core specifiers in every shipped file (previously react/vue types/index.d.ts still referenced the npm scope, breaking consumer tsc on GHP-only installs).
  10. v1.2.1PatchJul 16, 2026
    AddedImage — Images now display at the full width of the article by default. Previously an image without an explicit size preset rendered at the medium (520px) preset; the default is now the full preset. Images with an explicitly saved size are unaffected.
    FixedPopover — The search input's focus ring was clipped along its bottom edge by the context label's opaque background painting over it; the search wrapper now renders in the positioned paint layer so the full ring is visible. The gap between the search field and the context label was also widened slightly.
  11. v1.2.0MinorJul 16, 2026

    Media — Playback speed and loop preferences now persist across audio and video blocks. They are stored in localStorage under shared per-media-type keys (blok:audio:rate/loop, blok:video:rate/loop), joining the existing shared volume and per-source position keys, and are restored when a player attaches — without dirtying block data.

    AddedMedia — Playback speed and loop preferences now persist across audio and video blocks. They are stored in localStorage under shared per-media-type keys (blok:audio:rate/loop, blok:video:rate/loop), joining the existing shared volume and per-source position keys, and are restored when a player attaches — without dirtying block data.
    FixedQuote — Saving a quote block no longer strips href/target/rel from links (leaving dead anchors in stored content) or unwraps bold/italic marks. Quote now uses the same inline-text sanitize rules as paragraph and header, so links, formatting, and color styles survive save and conversion.
    FixedAudio — OneDrive share links from SPO-migrated accounts (the new /u/c/<cid> form) can't be resolved anonymously and produced a silently dead player; they now surface a clear "needs an uploader backend" error instead.
    FixedToolbar — The plus button and drag handle no longer stay stuck at the wrong offset after the slash-command popover opens or closes; the toolbar repositions on toolbox open/close instead of relying on a resize side effect.
    FixedToolbox — Opening the toolbox silenced the current block's mutation watching and never re-armed it, leaving the block permanently deaf to later content changes until re-render. Watching is now re-armed on both close paths, and the toolbar follows any inner-geometry change that doesn't resize the block holder.
    ChangedCI — The build artifact now ships the extracted packages/*/dist adapter bundles alongside dist/, fixing downstream unit and E2E jobs; yarn.lock was synced to the ^1.1.1 core peer range.
    ChangedDocs — README and the docs site updated for the @bloklabs/* package family; the rename notice was subsequently dropped from the README.
  12. v1.1.1PatchJul 15, 2026
    Changed`@bloklabs/core` has zero peer dependencies. The react/react-dom/vue optional peers are gone — installs no longer warn about frameworks you don't use, and the GitHub Packages peerDependenciesMeta-stripping bug (which forced Yarn Berry consumers to add a packageExtensions workaround) no longer applies. Delete that .yarnrc.yml entry after upgrading.
    ChangedAdapters declare hard, accurate peers: each requires its framework plus @bloklabs/core at the matching version.
    ChangedGitHub Packages mirrors: @dodopizza/blok remains the core mirror; adapters mirror as @dodopizza/blok-react, @dodopizza/blok-vue, @dodopizza/blok-angular; the CLI stays @dodopizza/blok-cli.
    ChangedMigration: the bundled codemod (npx -p @bloklabs/core migrate-from-editorjs) now also rewrites legacy @jackuait/* import specifiers and package.json dependency keys to the new names.
  13. v1.1.0MinorJul 15, 2026

    Audio — Share links from seven more services — Dropbox, OneDrive, GitHub, GitLab, Hugging Face, Google Cloud Storage, and Internet Archive — are recognized and rewritten to their direct-content form, so they play in the browser with no backend. Google Drive share links (hotlink-blocked server-side) are normalized and routed through the consumer's uploadByUrl backend, with a Drive-specific error message when none is configured. The error state gets a styled callout with a retry button.

    AddedAudio — Share links from seven more services — Dropbox, OneDrive, GitHub, GitLab, Hugging Face, Google Cloud Storage, and Internet Archive — are recognized and rewritten to their direct-content form, so they play in the browser with no backend. Google Drive share links (hotlink-blocked server-side) are normalized and routed through the consumer's uploadByUrl backend, with a Drive-specific error message when none is configured. The error state gets a styled callout with a retry button.
    AddedRead-only — readOnly now accepts an object form: { hideControls: true } enables read-only mode and suppresses the toolbar, block settings, and inline toolbar. Exposed via isControlsHidden, normalized across the React, Vue, and Angular adapters, and ReadOnlyModeConfig is exported from the types root.
    AddedImage — compress: { format: 'avif' } now produces real AVIF via WebCodecs when the canvas encoder cannot, and a new fallbackFormat option (e.g. 'webp') covers browsers with no AV1 encoder instead of silently uploading the original bytes.
    FixedAudio — Audio inserted by URL is now enriched like uploads: waveform, title/artist metadata, and cover art, failing soft to a plain scrubber when the host blocks the CORS fetch.
    FixedTable — Undo inside a table no longer duplicates cell blocks into invisible ghosts that reappear under the table after save; blocks placed at the top of a cell no longer drift to the bottom or become orphans on save. The Saver gains save-boundary guards for cell membership and cell block order (throw in dev/test, repair the emitted output in production).
    FixedTooltip — The tooltip bubble is click-transparent, so it never swallows clicks on controls it covers (e.g. color-picker swatches under a bottom-row tooltip).
    FixedPopover — Nested popovers no longer collapse to their padding in WebKit; the marker color picker rendered as a 12px sliver in Safari.
    FixedStyles — Body-mounted UI (link hover card, notifier toasts, drag previews) now carries the scope attribute, so its styles survive in consumer apps; a new architecture test enforces the invariant for every document.body mount.
    FixedAngular — The ng-packagr build stages the readonly-config module, fixing a CI-only TS2307; an architecture test now walks the adapter's import graph to catch unstaged modules.
    ChangedPlayground — Gallery empty states run the real tool per state (with per-state tool config) instead of static mockups, including a live Google Drive error demo.
    ChangedTests — Adversarial table undo probes (merge undo, insert undo/redo), tooltip click-transparency lifecycle guards, and an exhaustive swatch hit-test sweep.
  14. v1.0.0MajorJul 14, 2026

    Header — Toggle headings are now offered at all six levels, staying in sync 1:1 with regular headings.

    AddedHeader — Toggle headings are now offered at all six levels, staying in sync 1:1 with regular headings.
    FixedMigration — The legacy Editor.js grammar is now authored as ESM so consumer dev servers can load blok's source graph without a build step.
    FixedColumns — Blocks inserted via the plus button no longer save at the bottom of the column; saved order now matches the on-screen (WYSIWYG) order.
    FixedStyles — Injected utilities are scoped so a host application's CSS reset can't flatten the editor.
    ChangedMigration — Single-source LEGACY_GRAMMAR shared by both the runtime and the codemod; the codemod's source rewrite is now AST-guided (via the consumer's @babel/parser) to avoid mangling comments, strings, and unrelated identifiers.
    ChangedCI — Root-caused CI failures: scoped-utility drift on body-mounted UI, lint, and test flake fixes (webkit paste timing, six-level toggle-heading counts).
  15. v0.25.0MinorJul 13, 2026

    Spacer — New adjustable-height spacer block. Drag either edge to resize (dual-edge grips), with a text-block-height floor, snap-to-sibling and snap-to-column alignment guidelines, an on-edge capsule resize pill, and accent hover cues. Fully invisible in read-only/published renders.

    AddedSpacer — New adjustable-height spacer block. Drag either edge to resize (dual-edge grips), with a text-block-height floor, snap-to-sibling and snap-to-column alignment guidelines, an on-edge capsule resize pill, and accent hover cues. Fully invisible in read-only/published renders.
    AddedImage — Uploads are now automatically compressed and re-encoded (compress, on by default), with opt-in smaller output formats. In-cell images gain a resize floor and fluid chrome via container queries.
    AddedToolbar — Cmd/Ctrl+Slash opens the block menu in read-only mode.
    FixedTable — Large batch of Notion-parity fixes: paste-header handling, the cell color picker, the cell menu, arrow-key navigation between cells, and column width reset. The cell box now follows the caret (instead of the pointer) and the resize handle no longer forces overflow. Focus stays inside a cell when its content is deleted, the caret stays put after clearing a multi-cell selection, multi-line cell selections merge into one rounded shape, drag-selecting several lines within a single cell works, and list items scale to the cell font instead of outsizing sibling paragraphs.
    FixedColumns — Stranded resize separators left behind by removing a column no longer render as a phantom column.
    FixedCore — Never Tab-indent a block into a tool-owned container.
    FixedToolbox — Keep plus-button blocks on a table out of its cells, and anchor fuzzy search at word boundaries.
    FixedSelection — Stop hijacking intra-line text drags inside table cells.
    FixedEmbed — Validate stored URLs at render time (stored-XSS guard).
    FixedList — Keep bullet markers non-editable so Enter never ghosts an item.
    FixedToolbar — Read-only drag-handle refinements: announce it as a menu button, show a pointer cursor, and drop the ⌘/ and "Drag to move" hint lines; no read-only handle appears beside blocks that paint nothing.
    FixedTunes — Hide the copy-link shortcut hint in read-only mode.
    FixedStyles — Right contentAlign no longer collapses into centering, and preflight resets are scoped to @layer base so Blok's own utilities win.
    FixedReact — Guard against stale dist exports and a StrictMode readiness race.
  16. v0.24.3PatchJul 10, 2026
    AddedHeader — Opt-in anchorIds config derives stable heading anchor ids from heading text.
    FixedLink — Pad the edit-menu input wrapper so the focus ring isn't clipped, and enlarge the remove-link (trash) icon.
    ChangedCI — Fetch mirror tags before pushing to avoid creating over an existing tag.
  17. v0.24.2PatchJul 9, 2026
    AddedLink — New link.transform config, a superset of transformHref: consumers can set per-anchor href/target/rel plus extra attributes (class/title/data-*) without post-processing the rendered DOM. Applies consistently across every anchor path (render, paste, and hand-created links); omitted fields fall back to existing defaults (including the same-page _self rule) and extra attributes never clobber the managed href/target/rel.
    FixedColumns — Keep the inter-column gutter in read-only/published renders. The gap was previously produced entirely by the (no-op in read-only) resize handles, so read-only columns rendered flush; the gutter is now decoupled from the resizers.
    FixedLink — Center the hover card under the pointer (shifting near viewport edges) with a fixed gap to the link, and stop the block toolbar leaking through the card when hovering top-layer chrome.
    FixedNotifier — Fix top-layer placement so the toast stays in its corner (no UA Canvas box or top-left jump), remove the in-pill dismiss cross (auto-dismiss/Escape still close it), and tighten the pill's vertical padding.
  18. v0.24.1PatchJul 9, 2026
    FixedTypes — Fixed a publishing defect (introduced in 0.24.0) where importing @dodopizza/blok/react — or @dodopizza/blok/markdown — made a consumer's TypeScript compiler follow the published declarations into raw src/ implementation, producing spurious errors about unresolved micromark-util-types / @types/mdast (TS2307) and implicit any (TS7006). The public types/*.d.ts surface is now self-contained and no longer re-exports from src/.
    ChangedTypes — Mechanically enforce that no published types/*.d.ts re-exports or imports from src/, and generate the self-contained icon declarations from source (scripts/generate-icons-dts.mjs).
  19. v0.24.0MinorJul 9, 2026

    Vue — New first-class @jackuait/blok/vue adapter: BlokEditor component, useBlok, and provideBlok, plus createVueBlock/useBlocks for authoring custom blocks and driving the block tree from Vue. Custom Vue blocks support read-only in-place toggling.

    AddedVue — New first-class @jackuait/blok/vue adapter: BlokEditor component, useBlok, and provideBlok, plus createVueBlock/useBlocks for authoring custom blocks and driving the block tree from Vue. Custom Vue blocks support read-only in-place toggling.
    AddedAngular — New first-class @jackuait/blok/angular adapter shipped as an Angular Package Format build (ng-packagr): the editor component/directive, a block portal registry, the BLOK_BLOCK_CONTEXT render-context token, createAngularBlock authoring, and the reactive injectBlocks block-tree API.
    AddedReact — New useBlocks hook exported from @jackuait/blok/react: a reactive block-tree API with reads, insert (position + append-to-parent, explicit id, tunes, replace), move (before/after/toIndex), nest/unnest/remove/transact, insertMany, atomic insertTree for nested subtrees, and additive insertMarkdown. Block-creation semantics are hardened across hierarchy edges with compile-time drift guards against the core API.
    AddedAdapters — Closed React/Vue/Angular parity gaps across component paths and escape hatches; shared one blocks-api core so Vue's useBlocks reaches React parity, and extracted shared fillDefaults/PropSchema helpers. Custom-block authoring is now first-class on the public API surface.
    AddedAccessibility — Five-wave overhaul adapting shadcn/ui interaction patterns to Blok's UI primitives: dismissal-layer/popover teardown/scroll-lock/announcer foundations, an anchored-positioning engine and shared modal Dialog, keyboard reachability for toolbars/menus/radios/rename, and assistive-tech feedback parity across selection, drag, menus, and arrival.
    AddedLink — Clickable links with a hover card in both edit and read-only modes (with enter/leave animation), an edit mode featuring a title field and remove-link action, refined hover-card chrome, blocking of unsafe-scheme navigation, and a consistent same-page/anchor-link rule that opens such links in the same window across all link-creation paths.
    AddedBlocks — Structural parentId nesting: any block can now be nested inside any list (flat per-block indent), with list keyboard nesting and drag/serialization migrated onto the structural block tree.
    AddedKeyboard — Cmd+Left/Cmd+Right navigate between blocks at block edges; Backspace at the start of a nested block removes one indent level; mixed-list Tab indents both kinds; and numerous Notion-parity Tab/arrow/Delete/Backspace fixes.
    AddedPaste — Paste-without-formatting (Cmd/Ctrl+Shift+V); recovery of buildin/Notion toggles and soft breaks from lossy GFM HTML fallback.
    AddedInline — Link-markdown auto-format and a link-paste menu; shortcut-triggered Link/Equation/Marker now open a standalone menu positioned right under the selection.
    AddedPopover — Custom cross-platform scrollbar that hides the classic OS bar while keeping a stable gutter; reel-like edge distortion replacing the scroll haze.
    AddedConvert — Shared buildConvertMenuEntries with titleKey resolution, used by both block settings and the inline "Turn into" menu (which now lists the full text family), guarded by parity E2E.
    AddedImage — Configurable auto-retry on image load failure (default 5).
    FixedCRDT/Yjs — Undo/redo no longer yanks the caret to the top of the document; the caret restores to the correct position, split() inherits full tool data (correct heading undo caret), redo moves the caret to the new block on an Enter split, and five further Yjs sync gaps in tools and modules were closed.
    FixedList — Closed dozens of Notion-parity divergences across convert, keyboard, drag, selection, and copy/paste; source ordered lists renumber when an item is dragged away; bullet glyphs refresh on depth change.
    FixedText/Header — Fixed 30+ Notion-parity bugs by root cause (slash+space, duplicate pulse, indent toolbar, caret offset preservation on turn-into, and more).
    FixedTable — Preserve merged cells and lists when pasting external tables, and keep list markup when copying cells out to external apps.
    FixedPaste — Preserve lists and quote-ness in pasted blockquotes; pasted links use the default link color; the link menu shows on non-empty blocks without erasing content; closed remaining sanitizer/merge data-loss gaps found by an audit.
    FixedBlocks — Re-parent a merged block's children onto the survivor instead of orphaning them; release toggle children as siblings when turning a toggle into text; fire the tool moved() hook on setBlockParent; never write split text into a mutation-free decoration.
    FixedColumns — Match Notion's inter-column gutter spacing; restore DOM order when undoing column creation.
    FixedDrag — List-item drop line tucks under the text with a marker lead-in; depth changes apply on same-slot drops; non-list blocks stop previewing nested drops they can't reach.
    FixedSelection — Fake highlight matches the native selection color and stays visible while a menu input is focused; Cmd+A container-scoped staging.
    FixedMarker — Reset <mark> background so colored text never shows the browser's yellow highlight.
    FixedToggle — Arrow container stays a constant 28px square and pins to the first line for multi-line toggle/heading.
    FixedStyles — Reserve a scrollbar gutter on all scrollable components and keep it in nested inline-toolbar menus; auto-hide scrollbars system-style while keeping the gutter.
    ChangedPaste — Mechanically enforce the paste attribute law and the paste stamp law via architecture tests.
    ChangedTests — Repaired all CI-matrix E2E shards; added regression coverage across list keyboard shortcuts, columns undo order, popover scrollbar spec, and adapter integration/e2e.
    ChangedLint — Resolved all 69 root ESLint problems at the root cause.
  20. v0.23.5PatchJun 25, 2026
    AddedCore — The link config ({ target, rel, transformHref }) now also applies on the render and paste paths, not just the interactive link tool. Anchors coming from stored block HTML (rendered via blocks.render()) and <a> arriving through the clipboard now get the configured target/rel forced and transformHref applied to their href — so consumers no longer need to post-process the rendered or pasted DOM. Because the render path rewrites live anchors whose href round-trips into saved data, transformHref must be idempotent.
    AddedCore — New onBeforeRender(blocks) => blocks config transforms the blocks array before every render (the initial render and each blocks.render()), letting you run app-specific data migrations inside Blok instead of pre-processing the data yourself. It runs on the raw saved blocks before format analysis, so it can also inject blocks into an empty document.
    AddedCore — New onAfterRender(api) config fires after a render completes and the blocks are in the DOM (initial render and every blocks.render()), for post-render side effects such as scroll restoration — distinct from the once-only onReady.
    AddedCore — A stable data-blok-rendered attribute (exposed as DATA_ATTR.rendered) is now set on the editor wrapper when a render batch finishes inserting blocks, and removed while a re-render is in flight — a DOM-level render-readiness gate that complements the existing blocks:rendered event.
    AddedBlock Tunes — A custom tune's render(context) now receives an optional BlockTuneRenderContext whose getPopoverElement() returns the host tune popover element ([data-blok-popover]), so tunes can anchor sub-menus or portals inside Blok's popover without reaching into the DOM via closest(...). The element resolves once the popover mounts (it is null synchronously during render()).
    AddedReact — <BlokEditor>/useBlok now accept onBeforeRender and onAfterRender. Both are attached only when provided and are ref-stable, so updating the callbacks never recreates the editor.
  21. v0.23.4PatchJun 25, 2026
    AddedCore — New onSave(data, api) config delivers the full serialized OutputData (debounced via the existing change-batch window) whenever content changes — the "output half" of a controlled editor. Pair it with the data config to mirror editor state into your own store with a single callback instead of calling saver.save() by hand. Only user-driven changes trigger it; programmatic render() does not (the change observer is disabled during render), so a controlled round-trip won't recurse. Available to all consumers, not just React.
    AddedReact — <BlokEditor>/useBlok now accept onSave, making <BlokEditor data={data} onSave={setData} /> a true controlled component to pair with the reactive data prop from 0.23.3. The callback is ref-stable (never recreates the editor) and attached only when provided. Echoing the payload straight back via onSave={setData} is caret-stable: the adapter records the editor's own emitted output as the content baseline, so the round-trip deep-equal–dedupes to a no-op (no re-render, no caret reset) while genuine external data changes still render in place.
  22. v0.23.3PatchJun 25, 2026
    AddedReact — The <BlokEditor>/useBlok data prop is now reactive: passing new content re-renders the editor in place via editor.render() instead of being read only once at creation. Identical content is de-duplicated (deep-equality) so the caret is never clobbered, rapid changes are serialized, and a freshly-seeded editor is not double-rendered.
    AddedCore — New typed render events: blocks:rendered (payload { count }) fires when a batch finishes rendering, and block:rendered (payload { blockId }) fires per block. The runtime event-name constants BlocksRendered/BlockRendered are exported, so consumers can react to rendering instead of polling the DOM. The public Events API is now typed against an event/payload map while still accepting arbitrary string events.
    AddedCore — New link config ({ target, rel, transformHref }) lets consumers configure the anchors the link tool creates instead of post-processing the DOM. Defaults (_blank/nofollow) are preserved, configured values now survive save, and URL validation/allowlisting is unchanged.
    AddedPaste — New onBeforePaste(html) => string | null config hook transforms (or drops) raw clipboard HTML before Blok preprocessing; returning null falls back to plain-text paste.
    AddedAPI — New editor.tools.update(name, config) shallow-merges a tool's config in place — e.g. swap an uploader — without recreating the editor.
    ChangedTests — Exported stable TEST_ID constants (plus button, settings toggler, block wrapper) wired into the editor chrome via data-blok-testid, so consumers no longer query internal selectors.
  23. v0.23.2PatchJun 25, 2026
    ChangedDocs — Documented two React-adapter caveats. <BlokEditor> must not be wrapped in styled() or any HOC that reserves the theme prop: styled-components claims theme for its own ThemeProvider, so it never reaches the editor and theme sync silently breaks — render it directly and style the container via className. And deps values must be referentially stable (each value compared individually, not the array wrapper), otherwise the editor is recreated on every render. Both caveats now appear in the README, the docs site, and the BlokEditor/useBlok JSDoc and published type declarations.
  24. v0.23.1PatchJun 25, 2026
    AddedCore — A new editor.placeholder runtime API (get/set) lets consumers read and change the empty-paragraph placeholder on a live editor, mirroring the existing width API. Updates apply to existing blocks and to blocks created afterwards.
    AddedReact — <BlokEditor> now accepts a reactive placeholder prop (backed by the new core API) that updates the editor in place without recreating it, and forwards all standard <div> attributes — id, aria-*, data-*, and the like — to the editor container.
  25. v0.23.0MinorJun 24, 2026

    React — A blessed <BlokEditor> component is now the recommended way to embed Blok in React. It forwards a typed ref to the live editor instance, takes an uncontrolled data seed, and reactively syncs readOnly, autofocus, theme, and width props without recreating the editor. Its onReady callback fires after the ref commits, so consumers can safely call ref.current from inside it. The lower-level useBlok hook plus BlokContent remain available as an escape hatch.

    AddedReact — A blessed <BlokEditor> component is now the recommended way to embed Blok in React. It forwards a typed ref to the live editor instance, takes an uncontrolled data seed, and reactively syncs readOnly, autofocus, theme, and width props without recreating the editor. Its onReady callback fires after the ref commits, so consumers can safely call ref.current from inside it. The lower-level useBlok hook plus BlokContent remain available as an escape hatch.
    ChangedReact — useBlok now reactively syncs theme and width prop changes to the editor instance, mirroring the existing readOnly/autofocus pattern.
    ChangedDocs — The demo wrapper now dogfoods BlokEditor, and the README React section documents the recommended BlokEditor path, the uncontrolled data contract, reactive props, and the useBlok + BlokContent escape hatch.
    ChangedTests — Added e2e coverage for save-via-ref and live prop toggles, a published-vs-source type-drift guard, and data-blok-testid-based locators.
  26. v0.22.0MinorJun 24, 2026

    Paste — Content copied from buildin.ai now imports as native Blok blocks at full fidelity. buildin's clipboard carries a lossless text/next-space-blocks JSON payload beside a lossy Markdown/HTML twin; Blok previously fell back to the twin, where tables collapsed to literal |pipes|, media degraded to links, and callouts, toggles, columns, to-dos, and code language flattened away. A new handler decodes the JSON directly, reconstructing the same native blocks as a Blok→Blok paste — paragraphs, to-dos, H1–H4, tables (grid + parented cells), bulleted/numbered lists, toggles, dividers, quotes, callouts (emoji + colour), code (with language), equations, toggle-headings, column lists, and image/video/audio/file/embed-bookmark media. (Inline marks — bold/italic/link/colour — are a documented follow-up.)

    AddedPaste — Content copied from buildin.ai now imports as native Blok blocks at full fidelity. buildin's clipboard carries a lossless text/next-space-blocks JSON payload beside a lossy Markdown/HTML twin; Blok previously fell back to the twin, where tables collapsed to literal |pipes|, media degraded to links, and callouts, toggles, columns, to-dos, and code language flattened away. A new handler decodes the JSON directly, reconstructing the same native blocks as a Blok→Blok paste — paragraphs, to-dos, H1–H4, tables (grid + parented cells), bulleted/numbered lists, toggles, dividers, quotes, callouts (emoji + colour), code (with language), equations, toggle-headings, column lists, and image/video/audio/file/embed-bookmark media. (Inline marks — bold/italic/link/colour — are a documented follow-up.)
    FixedPaste — Callout body and colour now survive import from both Notion and buildin.ai. Blok's callout stores its body in child blocks, so the inline title/body text the parsers emitted as data.text was silently discarded — the callout is now emitted (colours only) plus a child paragraph carrying its text. Out-of-palette callout colours (e.g. buildin's British grey, or any name outside Blok's 9-colour preset) previously produced an undefined CSS variable that dropped both the background and the border; colours now normalize through Blok's preset palette (grey→gray; unknown names clamp to null).
  27. v0.21.1PatchJun 24, 2026
    AddedMedia — Image, video, audio, and file blocks can now be restricted to upload-only or link-only via configuration, so consumers can offer a single source instead of always exposing both.
    ChangedMedia — Deduped MediaSource into a single shared type across the media tools.
    ChangedDocs — Documented the audio block tool, and added upload-only and link-only empty states to the playground gallery.
  28. v0.21.0MinorJun 23, 2026

    Tests — Added regression coverage for HTML-over-Markdown routing, document-order preservation, internal-reference rescue, pasted audio titles, and date-glyph handling.

    FixedPaste — Rich clipboards (Notion and similar) ship both a faithful HTML payload and a lossy Markdown twin. Routing now prefers the HTML handler, so pasted images, links, and structure the Markdown twin drops are preserved.
    FixedPaste — Notion content keeps its document order: nested children no longer render above their parents (only table cells stay children-first, since the table tool resolves cell ids on insert). Internal references that previously vanished — sub-pages, linked databases / collection views, and inline page mentions — now paste as Notion bookmarks/links instead of being dropped or leaking the raw "‣" glyph, and uploaded media whose binary isn't on the clipboard becomes a Notion-link bookmark carrying the filename rather than a bare filename paragraph.
    FixedPaste — Pasted external Notion audio now shows its title (the player reads data.title, which was left blank), and a malformed inline date annotation no longer leaks the raw "‣" placeholder glyph.
    ChangedTests — Added regression coverage for HTML-over-Markdown routing, document-order preservation, internal-reference rescue, pasted audio titles, and date-glyph handling.
  29. v0.20.0MinorJun 22, 2026

    Paste — Content copied from Notion now migrates as native blocks with full state preserved. When Notion's lossless clipboard JSON is present it is used directly (the high-fidelity path), with an HTML fallback for sources that only expose markup. Inline equations and page mentions are mapped to their Blok equivalents.

    AddedPaste — Content copied from Notion now migrates as native blocks with full state preserved. When Notion's lossless clipboard JSON is present it is used directly (the high-fidelity path), with an HTML fallback for sources that only expose markup. Inline equations and page mentions are mapped to their Blok equivalents.
    AddedAudio — Custom cover art. A cover picker (file upload or image URL) opens from an editable overlay button on the player; covers can be set, replaced, or removed (via a "Remove cover" block setting), with an animated picker open, a sliding Upload/Link tab transition, a themed surface that matches the player, and i18n across all locales. Audio blocks with no cover now show an inertial spinning-vinyl turntable placeholder instead of an empty panel.
    FixedAudio — Repaired the transport controls and the video-style playback-speed menu, which now stays open after picking a preset. The volume bar fill is fixed so a muted track reads differently from a full one, and the playing waveform pulses smoothly without gouging its dots. The caption toggle stays on the compositor, and the cover picker no longer jumps height on tab swap, gets an explicit width so the URL field isn't cramped, and revokes leaked cover blobs on a destroy race.
    FixedTable — Pinned the top toolbar anchor flush to the table edge.
    ChangedTests — Added unit and e2e coverage for custom cover set/remove and for real Notion page-mention arity, and cleared the lint/type violations the cover-art work introduced.
  30. v0.19.2PatchJun 20, 2026
    ChangedTypes — OutputBlockData's data field is now typed Record<string, unknown> instead of any (matching BlockToolData and SavedData). Reading a property off a saved block's data — e.g. on save() output — now yields unknown rather than any, so code that indexes into block.data may need a cast or type guard. This is a type-only change with no runtime effect.
    FixedTypes — Published .d.ts declarations are now self-contained and no longer re-export raw src/*.ts. A bare import { Blok } from '@jackuait/blok' previously dragged editor source into the consumer's TypeScript program (through tooltip and popover → flipper), surfacing internal type errors under strict consumer flags such as noUncheckedIndexedAccess. The tooltip and popover declarations now inline their public types, so consuming the package no longer type-checks Blok's internals. (The opt-in /markdown subpath is unchanged.)
    FixedTypes — The published declarations are now internally consistent under skipLibCheck: false. Fixed an incorrect BlockToolData import path in the database/header/list tool declarations (which also produced spurious "incorrectly extends BlockTool" errors), added a missing InlineToolConstructable/InlineToolConstructorOptions import in the type entry, and removed phantom Dictionary/DictValue re-exports.
    ChangedDependencies — Moved nanoid to devDependencies; it is bundled into every dist artifact and was never a runtime external.
  31. v0.19.1PatchJun 20, 2026
    AddedTypes — isReady now resolves with the fully-initialized Blok instance (was Promise<void>), so const editor = await blok.isReady yields a ready, fully-typed editor without a cast. New exported PendingBlok type describes the surface available synchronously after new Blok() and before isReady resolves (isReady, destroy, theme, width) — type a reference held during that window as PendingBlok instead of widening to Partial<Blok>, then await isReady to narrow it to the full API. new Blok() still returns the full Blok, so existing usage is unaffected.
  32. v0.19.0MinorJun 20, 2026

    Width — New public width API on the editor instance: instance.width.get(), set('full' | 'narrow'), and toggle() switch the content layout between 'narrow' (the default, constrained to --max-width-content) and 'full' (the content max-width is removed so it fills its container). It mirrors the theme API, including buffering a set() call made before the editor is ready and replaying it once the editor is initialized.

    AddedWidth — New public width API on the editor instance: instance.width.get(), set('full' | 'narrow'), and toggle() switch the content layout between 'narrow' (the default, constrained to --max-width-content) and 'full' (the content max-width is removed so it fills its container). It mirrors the theme API, including buffering a set() call made before the editor is ready and replaying it once the editor is initialized.
    FixedTypes — Declare the history API on the exported Blok instance type. history (clear(), undo()/redo(), canUndo()/canRedo()) was already available at runtime; consumers no longer need to cast the instance to reach it.
  33. v0.18.0MinorJun 19, 2026

    Audio — New native Audio block tool. Now-playing card with cover art (lazy music-metadata extraction), a waveform canvas with click/drag seek, transport controls (play/pause, volume, playback speed, loop, keyboard shortcuts, persisted preferences), file and URL upload, paste handling routed away from the File block, read-only support, and i18n across all locales. The player card is a full-bleed redesign — a tall cover panel (music-note placeholder when there is no art), a hero waveform scrubber with rounded bars, a slim transport bar, and motion polish.

    AddedAudio — New native Audio block tool. Now-playing card with cover art (lazy music-metadata extraction), a waveform canvas with click/drag seek, transport controls (play/pause, volume, playback speed, loop, keyboard shortcuts, persisted preferences), file and URL upload, paste handling routed away from the File block, read-only support, and i18n across all locales. The player card is a full-bleed redesign — a tall cover panel (music-note placeholder when there is no art), a hero waveform scrubber with rounded bars, a slim transport bar, and motion polish.
    AddedMedia — Image, video, and audio blocks now accept any file of their media family (image/*, video/*, audio/*) by default. Restrict the accepted types through the existing types config, which now accepts both exact MIME types (image/png) and family wildcards (image/*).
    FixedTypes — Export File, Audio, and Video (and their data/config/uploader types) and add the file/audio/video keys to defaultBlockTools from the @jackuait/blok/tools types entry. The runtime already exported these tools; consumers no longer need a local ambient type shim to import them.
    ChangedPlayground — Audio block states in the block-states gallery (real ID3-tagged track and a "No cover art" state) plus an e2e harness for insert/upload/play/seek.
  34. v0.17.0MinorJun 19, 2026

    Video — New native Video block with a custom Airbnb-style player, brought to YouTube parity: full keyboard control (j/l/k, 0–9, Home/End, frame-step, volume, speed), a scrubber with buffered range, hover frame-preview tooltip and mini progress bar, an in-player gear menu (Notion-style playback speed with glide, loop, ambient-glow intensity), and view modes — picture-in-picture, a FLIP-morphed theater/cinema mode, and a fade-in ambient glow. Player polish includes click-to-toggle play/pause, a centre play/pause burst, press-and-hold for 2× playback, arrow-key ±5s seek with side indicators, idle auto-hide, buffer spinner, time-remaining toggle, right-click menu, stats overlay and persisted preferences.

    AddedVideo — New native Video block with a custom Airbnb-style player, brought to YouTube parity: full keyboard control (j/l/k, 0–9, Home/End, frame-step, volume, speed), a scrubber with buffered range, hover frame-preview tooltip and mini progress bar, an in-player gear menu (Notion-style playback speed with glide, loop, ambient-glow intensity), and view modes — picture-in-picture, a FLIP-morphed theater/cinema mode, and a fade-in ambient glow. Player polish includes click-to-toggle play/pause, a centre play/pause burst, press-and-hold for 2× playback, arrow-key ±5s seek with side indicators, idle auto-hide, buffer spinner, time-remaining toggle, right-click menu, stats overlay and persisted preferences.
    AddedVideo — Custom fullscreen surface with a top caption bar, a "Hide controls" tune for a control-free player, and GIF-style autoplay/loop tunes.
    AddedImage — Auto-convert dropped, pasted and remote-URL GIFs into a looping Video block via WebCodecs + webm-muxer, gated by the convertGifToVideo config (default on); the original GIF is kept on CORS failure, with a "Converting…" label shown during conversion.
    AddedMedia — 30MB default upload limit with per-type maxSize configuration and human-readable too-large errors.
    FixedPaste — URL paste always prompts now; the previous auto-embed behaviour has been removed. Breaking: consumers relying on silent auto-embed must opt in through the paste menu.
    FixedVideo — Reserve the aspect ratio before metadata loads to prevent squeeze-on-load, centre and letterbox the fullscreen player, strip editor chrome in fullscreen, and hide the bottom mini progress bar while fullscreen.
    FixedVideo — Exit theater mode reliably on Escape via a capture-phase listener with a smooth deferred dismiss, and drive the scrubber fill with requestAnimationFrame for smooth playback tracking.
    ChangedBuild — Move webm-muxer to devDependencies so it is bundled rather than treated as an external runtime dependency.
    ChangedREADME — Replace the logo with the optimized noodle mascot.
    ChangedPlayground — Use real self-hosted videos in the block-states gallery.
  35. v0.16.0MinorJun 16, 2026

    File — New File block tool. Tabbed empty state with upload (validation, progress bar, cancel), URL and drag-and-drop; per-type icon and tint; editable filename; consumer upload endpoints and download card. Rich preview modal dispatched by kind: PDF (top-layer modal with open-in-new-tab), Office (docx/xlsx/pptx via lazy renderers, xlsx parsed through JSZip), and text/code/markdown — including advanced markdown (math, footnotes, references, alerts, anchors, safe block-level raw HTML) with an animated Rendered ⇄ Raw toggle. Read-only support, i18n in every locale, and Storybook stories.

    AddedFile — New File block tool. Tabbed empty state with upload (validation, progress bar, cancel), URL and drag-and-drop; per-type icon and tint; editable filename; consumer upload endpoints and download card. Rich preview modal dispatched by kind: PDF (top-layer modal with open-in-new-tab), Office (docx/xlsx/pptx via lazy renderers, xlsx parsed through JSZip), and text/code/markdown — including advanced markdown (math, footnotes, references, alerts, anchors, safe block-level raw HTML) with an animated Rendered ⇄ Raw toggle. Read-only support, i18n in every locale, and Storybook stories.
    AddedEmbed — Generic embed: frame arbitrary URLs through a gated resolver, offered in the paste menu behind the linkPaste.allowGenericEmbed flag with an api.config accessor. Replace the source via an empty-state URL bar and an overlay more-menu item.
    AddedMigration — Complete Editor.js block-type coverage plus a drop-in UMD build; adapt legacy Editor.js inline tools and linkTool data.
    AddedPlayground — Block-states selector as a fixed left side menu; real docx/xlsx/pptx, code and text samples for the File block; richer quarterly-budget sheet; File block wired into the editor demo.
    FixedTable — Resolve merged-cell coordinate bugs; preserve merges on load; split overlapped merges on paste so no destination data is dropped; keep empty cells editable on the read-only→edit toggle; harden input, clipboard and move-guard handling.
    FixedFile — Unbreak pptx preview; vertically center the preview modal; stop wrong-colour strips and toggle flicker during preview transitions; block javascript: URLs in download hrefs.
    FixedBuild — Make the published install self-contained (ship src, keep markdown and nanoid as runtime deps) so bundlephobia can build; green the self-contained-install and css-token audits.
    ChangedRefactor — Extract table visual-subsystem orchestration into TableSubsystems; split BlockOperations into focused worker classes; share the media uploader empty state across the image and file tools.
    ChangedCode — Cover every Prism token in both the light and dark themes.
    ChangedLint — Resolve all lint errors by root cause and mute advisory-only rules.
    ChangedDocs — Refresh the README tool list and entry points; add a File block tool reference entry.
  36. v0.15.1PatchJun 13, 2026
    FixedTypes — Declare Embed and Bookmark (and their defaultBlockTools entries) in the published @jackuait/blok/tools types. The runtime exported them in 0.15.0 but the .d.ts did not, so import { Embed, Bookmark } failed to typecheck.
  37. v0.15.0MinorJun 12, 2026

    Link Paste — Pasting a URL now offers a Notion-style menu to keep it as a link, or convert it into a Bookmark card or rich Embed block. The pasted link shows immediately with the menu anchored at its end, and menu labels name the detected link type via provider metadata.

    AddedLink Paste — Pasting a URL now offers a Notion-style menu to keep it as a link, or convert it into a Bookmark card or rich Embed block. The pasted link shows immediately with the menu anchored at its end, and menu labels name the detected link type via provider metadata.
    AddedEmbed — Worldwide embed registry covering ~115 services across video, audio, social, documents, design and developer domains, including Google published docs/forms and draw.io. Per-source minimum resize widths keep each provider's iframe legible, and fixed-width providers hug their content with figure, handles and toolbar.
    AddedBookmark — Notion-parity bookmark card with a dev unfurl endpoint; crawler-UA retry recovers metadata from bot-blocked sites.
    AddedPlayground — Smooth cross-fade theme switching via View Transitions, plus an Airbnb-style neutral redesign.
    FixedEmbed — Preserve the live iframe across every editor action: caption and alignment toggles now apply in place instead of reloading the player. Selection highlight hugs the figure dimensions.
    FixedDrag & Drop — FLIP-animate the column drop moment and slim the vertical drop bar to read like the horizontal line.
    FixedSecurity — Harden URL-scheme filtering and neutralize XSS gaps in markdown paste, the inline link tool, and the paste/render pipeline.
    FixedTools — Implement setReadOnly on embed, bookmark and column tools so read-only toggles in place without a full re-render.
    FixedIcons — Unify the icon set on the 20×20 / 1.25 house spec; refine heading family, quote, caption, pencil, cells, toggles, and numbered-list glyphs.
    FixedCI — Pin Node 24.14.1 to dodge a Playwright install hang; share Playwright setup to stop Storybook browser install hanging; repair 6 failing CI specs (5 stale expectations, 1 real drop-indicator regression).
    ChangedDependencies — Resolve all 52 open Dependabot alerts; bump brace-expansion, ws, smol-toml.
    ChangedTests — Embed/bookmark/link stories with screenshot baselines, wave-2 embed visual-regression baselines, verified real sample URLs replacing fixtures, refreshed main.css golden snapshot.
    ChangedDocs & Playground — Embed, bookmark and link entries in tools data and the editor demo.
  38. v0.14.1PatchJun 8, 2026
    AddedTools — Register the Columns tool with a single Columns group key. Tool-group "provides" manifests expand into their underlying block tools during prepare(), so consumers add one key instead of wiring each block.
    FixedTools — Export Columns from public types for single-key registration; keep defaultBlockTools settings-only so the group key forwards settings without re-registering.
  39. v0.14.0MinorJun 5, 2026

    Columns — New side-by-side layout tool (#67). Create 2–5 column presets from the toolbox, or drag a block beside another to spawn a column. Drop anywhere left/right of a block to make a new column, or into a column body to stack inside it. Columns nest, auto-unwrap when emptied, and stack vertically on narrow viewports.

    AddedColumns — New side-by-side layout tool (#67). Create 2–5 column presets from the toolbox, or drag a block beside another to spawn a column. Drop anywhere left/right of a block to make a new column, or into a column body to stack inside it. Columns nest, auto-unwrap when emptied, and stack vertically on narrow viewports.
    AddedColumns — "Turn into columns" command wraps a multi-block selection into a column layout, available from the Convert-to menu.
    AddedColumns — Hover-revealed resize separators between columns: drag to resize, keyboard-resizable with ARIA slider semantics, double-click a divider to equalize widths.
    AddedColumns — Horizontal arrow keys traverse between sibling columns; new columns animate in Notion-style.
    AddedInline Toolbar — Appears instantly on selection release, no animation delay.
    FixedInline Toolbar — Removed entry animation that delayed appearance.
    Changedi18n — Column resize aria-labels and turn-into-columns strings across all locales.
    ChangedCI — Repair unit tests, e2e merge, and mirror push on master; mirror push works for both branch and tag events.
    ChangedTests — Exhaustive block-in-column compatibility suite, live-drag lifecycle specs for every block type, multi-select block-settings header i18n regression.
    ChangedPlayground — Columns example in the editor demo and block-states gallery.
  40. v0.13.2PatchMay 30, 2026
    FixedRead-Only — Collapse the empty bottom click-to-add zone to 0px in read-only mode and restore the configured min-height when editing
  41. v0.13.1PatchMay 29, 2026
    AddedImage — Auto-retry failed image loads with loading overlay; distinguish upload-failed vs broken-image error states; predict loading-placeholder dimensions from URL, SVG, and cache; pipe upload progress to bar (#41)
    AddedCodemod — Default migrated images to size: 'full' and inherit the stretched flag into migrated image size
    AddedBlock Link — Highlight pulse on hash-link arrival
    AddedRead-Only — Show copy-link menu on block hover
    AddedPlayground — Add loading image state demo in block-states gallery
    FixedImage — Force full width and compact overlay for short images; reuse looping-arrows glyph for replace icon
    FixedPaste — Keep Google Docs images inside tables and stop double-bolding headings; prevent default page background collapsing to gray preset
    FixedTable — Recover migrated cell text detached by a pre-fix save
    FixedToolbar — Align plus/drag handle with content lane for stretched blocks
    FixedBlock Settings — Anchor popover to trigger instead of (0,0); translate popover context label
    FixedDatabase — Center block toolbar on the title line
    Changedi18n — Translate strings identical to English across 25 locales
    ChangedLint — Resolve all ESLint and tsc problems
    ChangedImage — Move inline upload-failed SVG to icons module
    ChangedTests — Cover migrated cell content surviving load→save round-trip; fix CSS guard test failures from image loading shimmer
  42. v0.12.0MinorApr 22, 2026

    Image — New image block tool (#66): drag-drop/URL/file upload, captions, alt text via inline popover, resize handles with symmetric growth, edge-pinned aspect-ratio resize, crop editor (rect/circle/oval) in modal, fullscreen lightbox with wheel/pinch zoom, drag-to-pan, rubber-band, alignment popover (left/center/right), block settings entries (size/download/copy-url), three-dots overflow menu for narrow images, empty/uploading/error states with unified card design, light-theme crop editor, legacy editor.js shape migration

    AddedImage — New image block tool (#66): drag-drop/URL/file upload, captions, alt text via inline popover, resize handles with symmetric growth, edge-pinned aspect-ratio resize, crop editor (rect/circle/oval) in modal, fullscreen lightbox with wheel/pinch zoom, drag-to-pan, rubber-band, alignment popover (left/center/right), block settings entries (size/download/copy-url), three-dots overflow menu for narrow images, empty/uploading/error states with unified card design, light-theme crop editor, legacy editor.js shape migration
    AddedCode — Migrate from Shiki to Prism.js for syntax highlighting with lazy grammar loading and class-based applier; add auto-indent and bracket expansion on Enter; add Mermaid highlighting with One Dark/Light palette; gutter line-number click focuses the line
    AddedFonts — Bundle @fontsource fonts via generator script; new fontFamilySans/Serif/Mono/Handwriting config fields with CSS variable injection; font-display: swap for body text
    AddedPopover — Render above all elements via CSS Top Layer; nested-submenu viewport clamping on both axes; close transition via ghost clone; tighter item sizing; end-of-list padding hidden on empty search; simpler animations
    AddedToolbar — Hide plus and dots buttons while toolbox is open; place block settings popover left of the dots button
    AddedToolbox — Nowrap pill with tighter radius and unified plus/slash search styling
    AddedPlayground — Icon gallery lightbox; block states gallery tab; settings panel shortcuts; hide header on scroll; logotype image example
    AddedCSS Variables — Tokenize radii, spacing, icon sizes, border widths, z-index ladder, duration/easing, typography; extract direct rgba literals to palette tokens; migrate @apply arbitrary hex values; split actions-icon/divider vars; add audit test and visual regression baselines
    AddedDatabase — Match Notion card shadow and radius on kanban cards; showcase all 10 column color variants
    AddedBlock Settings — Add shortcut keys to i18n with regression tests
    AddedIcons — Migrate inline SVGs to shared icon layer
    FixedInline Toolbar — Tighten item padding and radius; suppress toolbar inside code blocks; apply symmetric top/bottom padding
    FixedCode — Pin caret color so it does not inherit Prism token colors; restore trailing <br> after highlight so Enter works once; refresh gutter/highlight after native paste; focus line end when clicking empty strip of short lines; scope inline-code styling to not leak into code block; support contenteditable="plaintext-only" and preserve view mode on undo; correct syntax highlighting offset calculation
    FixedToolbar — Reposition + / ⋮⋮ live while hovered block resizes; disable pointer-events on every actions descendant for left-edge blocks; keep slash search in inserted block after plus button
    FixedPopover — Distinguish synthesized hover from real hover; hide context label while searching; keep block settings menu visible and attached to dots trigger
    FixedBlock Manager — Skip cross-container auto-heal inside move group
    FixedTooltip — Anchor wrapper with position: fixed to survive page scroll; render above popover and survive UA stylesheet
    FixedFonts — Add error handling for font load failures
    ChangedStyles — Split main.css into 11 concern-files
    ChangedLicense — Add fork attribution and NOTICE file
    ChangedBuild — Replace shiki with prismjs
    ChangedTests — Fix 60+ unit + E2E failures across the suite; add Prism integration test for all highlightable languages
    ChangedChore — Untrack .vscode; remove stale root files; add favicon to dev playground; drop .editorconfig
  43. v0.11.1PatchApr 16, 2026
    AddedBundles — Ship CJS (require()) and IIFE (<script> tag / CDN) bundles alongside ESM; add "main", "browser", "unpkg", and "jsdelivr" fields to package.json
    ChangedREADME — Add installation section documenting ESM, CJS, and CDN usage
  44. v0.10.9PatchApr 14, 2026
    AddedToggle — Gray arrow icon when toggle body is empty
    FixedDrag — Eliminate "wrong block dropped" with multi-layer stale-block defense; block paste, undo/redo, and move shortcuts during active drag; integrate drag-reparent with undo as a single step
    FixedHierarchy — Reject dangling parentId at universal chokepoint; reconcile remote Yjs reparents; close remaining container drift vectors; exempt Yjs remote sync from dangling parent throw
    FixedPaste — Inherit container parent on replace-insert and x-blok root paste; harden container paste ejection across all container block types
    FixedCallout — Restore plus button and drag handle; stop paste from ejecting children via stale contentIds; prevent Enter from inserting new block inside callout
    FixedUndo — Collapse multi-block paste and alt-drag duplicate into one undo group; eliminate spurious entries from metadata-only writes
    FixedToolbar — Keep drag handle visible when editing inside table cell
    FixedInsert — Universally protect all Enter paths from nested-block leak
    FixedTable — Tighten list item spacing inside table cells
    FixedYjs — Map 'no-capture' origin to local to prevent mid-op sync clobbering tool state
    ChangedYjs — Make DocumentStore.ydoc private; enforce local origin whitelist with exhaustive mapper
    ChangedCI — Shard E2E tests via reusable workflow; add merge-reports job; run spec-file coverage validator on every PR; remove size-limit bundle size check
  45. v0.10.8PatchApr 13, 2026
    FixedTable — Normalize flat-array table child parents at every entry point
    FixedData Model — Recursively expand legacy nested toggleList/callout bodies
  46. v0.10.7PatchApr 13, 2026
    FixedTheme — Prevent nested editor instances from overriding parent theme on prepare
  47. v0.10.6PatchApr 12, 2026
    AddedConfig — Replace user.name with user.id + resolveUser callback for multi-editor identity tracking
    AddedKeyboard — Del shortcut for block delete; markdown shortcuts for quote (" + space) and code (` ` ` + space) blocks
    Fixedi18n — Use Blok locale for date formatting with full month names; strip trailing abbreviation suffixes for ru/uk locales
    FixedPopover — Display scroll haze instantly on open instead of fading in
    ChangedDeps — Add lodash-es resolution to pin ^4.18.0
  48. v0.10.5PatchApr 11, 2026
    AddedDatabase — DatabaseView rendering layer with kanban board DOM
    Fixedi18n — Localize hardcoded "Last edited" strings in block settings footer; add missing translations across 67 locales
    FixedTheme — Expose theme API before isReady to prevent dark theme race condition
    ChangedLint — Resolve all 226 lint issues across source and test files
    ChangedCI — Enable Corepack before setup-node to resolve Yarn version mismatch; remove dead version-check job
    ChangedTests — Resolve 119 failing tests across E2E, unit, and docs suites
  49. v0.10.4PatchApr 11, 2026
    AddedDatabase — Kanban board view with drag-and-drop cards and columns, card drawer with nested editor, inline title editing, list view with collapsible sections, multi-view tabs with drag reorder, property-based data model, column controls, backend sync, and read-only mode
    AddedCopy block link — CopyLinkTune block tune with Cmd+Ctrl+L shortcut and automatic scroll-to-block on URL hash load
    AddedBlock edit metadata — Track lastEditedAt/lastEditedBy on every block mutation with Yjs sync, saved output inclusion, and block settings footer display; new user config option
    AddedPopover — Scroll haze indicators on popover lists
    AddedShortcut keys — Render shortcut keys as SVG icons with readable tooltip on hover
    FixedInline tools — Preserve trailing nbsp through format/unformat cycles; preserve trailing spaces when applying inline formatting; extend trailing-whitespace range detection; unwrap whitespace-only bold ancestors when un-bolding partial selection
    FixedBlock — Default lastEditedAt to Date.now() so footer always shows; preserve user-provided block IDs and deduplicate on render; validate block ID format in constructor
    FixedPaste — Prevent new table block when pasting into table cell with lost focus; handle hsl/hsla color formats
    FixedScroll to block — Guard decodeURIComponent against malformed URL hash; encode block ID in URL hash
    FixedTheme — Prevent nested editor from resetting parent theme
  50. v0.10.3PatchApr 9, 2026
    FixedTable — Guard addBlockToCell and setCellBlocks against writing into covered (merged) cells; resolve paste target and copy source coordinates from model attributes instead of DOM visual position; fix overlay/pill missing and wrong merge/split button after rect expansion; expand selection rect to include full spans of merged cells; use logical cell coordinates in getCellPosition; don't intercept copy/cut when user has text selected in a single cell; reindexCoordinates assigns model coordinates instead of DOM physical indices; center row grip on merged cell using getBoundingClientRect
    FixedToolbar — Correct marginLeft for nested blocks and popover position when scrolled; restore focus to originally-typed block after plus+Escape
    FixedToolbox — Position popover at caret when inside nested blocks (toggle/callout)
    FixedKeyboard — Prevent text-jumping by preserving focus on toolbar interactions
  51. v0.10.0MinorApr 8, 2026

    Code block — New CodeTool with syntax highlighting (via Shiki), line numbers toggle, language selector popover, copy button, wrap toggle, and preview tab for KaTeX/Mermaid rendering

    AddedCode block — New CodeTool with syntax highlighting (via Shiki), line numbers toggle, language selector popover, copy button, wrap toggle, and preview tab for KaTeX/Mermaid rendering
    AddedInline code — New InlineCodeTool with CMD+E shortcut
    AddedQuote block — Notion-style quote block with size options submenu
    AddedDivider block — Horizontal rule block with --- markdown shortcut
    AddedCallout block — Callout block with emoji picker and skin tone persistence
    AddedToggle list — Collapsible toggle list block with drag & drop support inside toggles ([#46](https://github.com/JackUait/blok/pull/46), [#52](https://github.com/JackUait/blok/pull/52))
    AddedToggle headings — Toggle heading blocks with markdown shortcuts (>#, >##, >###) and body placeholder
    AddedMarker inline tool — Color text/background inline tool with color picker and dark mode support
    AddedUnderline & Strikethrough — New inline tools with CMD+U and CMD+SHIFT+S shortcuts
    AddedTable enhancements — Cell color picker, cell placement picker, HTML <table> rendering, corner drag, Tab/Arrow escape from cells, and cross-table block protection ([#38](https://github.com/JackUait/blok/pull/38), [#45](https://github.com/JackUait/blok/pull/45), [#63](https://github.com/JackUait/blok/pull/63))
    AddedMarkdown import — importMarkdown() API method and paste handler with GFM support including math (KaTeX) extensions
    AddedReact adapter — useBlok hook and BlokContent component for React integration
    AddedRead-only toggle — Seamless in-place readonly mode toggle with scroll position preservation
    AddedEditor width API — editor.width namespace with WidthManager module and config.width options
    AddedContent alignment — config.style.contentAlign option for global block content alignment
    AddedFont family config — config.style.fontFamily option for editor and popover typography
    AddedTheme API — ThemeAPI module for programmatic dark/light theme control
    AddedFuzzy toolbox search — Ranked fuzzy search in slash menu with animated filtering
    AddedToolbox plus button — Opens blocks menu directly without inserting /
    AddedLink suggestion chip — URL type detection chip in inline toolbar
    AddedGoogle Docs paste — Expand <details> tags into toggle blocks with parent-child wiring
    Addedblok-cli package — New @jackuait/blok-cli package with convert (HTML→JSON) and convert-gdocs commands
    Addedi18n search terms — Multilingual toolbox search via searchTermKeys across all 68 locales
    FixedDrag & drop — Toggle hierarchy, ghost preview, subtree depth preservation, and spring-load auto-expand for closed toggles
    FixedToolbar — Drag handle reachability, left-edge overflow, and actions not intercepting toggle arrow clicks
    FixedInline toolbar — Cross-block selection positioning, background element cleanup on close
    FixedTable — Cross-table block stealing, undo/redo focus, cell selection border persistence, and arrow key navigation between blocks
    FixedMarker — Partial selection color removal, dark theme palette, and active color display on toolbar button
    FixedToggle — Backspace/Delete boundary crossing, undo atomicity for Enter, children DOM nesting, and collapse in read-only mode
    FixedList — Tab indent for multi-selected items, depth reduction cascade on outdent, and bullet marker pinning
    FixedPaste — Table cell content appearing outside table, marker formatting preservation, and math formula detection
  52. v0.5.0MinorJan 23, 2026

    CRDT-based undo/redo — The undo/redo system now uses Conflict-Free Replicated Data Type principles for better conflict resolution and history tracking

    AddedCRDT-based undo/redo — The undo/redo system now uses Conflict-Free Replicated Data Type principles for better conflict resolution and history tracking
    Fixedtoolbar hover behavior after cross-block selection — The inline toolbar now resets its positioning state when extending selections across multiple blocks
    FixedPatternPasteEvent for internal cut/paste — Internal cut and paste operations now emit PatternPasteEvent, so external code can react to all clipboard actions
  53. v0.4.1-beta.5PatchDec 7, 2025
    FixedTailwind CSS conflicts — Fixed CSS conflicts that caused external plugins to break by isolating Tailwind's style precedence
    Addeddata-blok-header-level attribute — Headers in the formatting popover now include a data-blok-header-level attribute for styling and testing hooks
  54. v0.4.1-beta.3PatchDec 6, 2025
    Addedundo/redo — Added keyboard shortcuts (Ctrl/Cmd+Z and Ctrl/Cmd+Shift+Z) for editing history navigation
  55. v0.4.1-beta.0PatchDec 16, 2025
    AddedRTL language support — Added translations for Hebrew, Persian, Urdu, Yiddish, Pashto, Sindhi, Uyghur, Kurdish, and Dhivehi with right-to-left layout
    AddedEastern European languages — Added Czech, Romanian, and Hungarian translations
    AddedSoutheast Asian languages — Added Thai, Ukrainian, and Greek translations
    AddedSouth Asian languages — Added Hindi, Bengali, Indonesian, and Vietnamese translations
    AddedTurkic languages — Added Turkish and Azerbaijani translations
    AddedArabic — Added Arabic translation with RTL support
    AddedNorthern European languages — Added Dutch, Polish, and Swedish translations
    AddedKorean, Japanese, Italian, Portuguese, German, French, Spanish — Added translations
    AddedArmenian, Chinese, Russian — Added translations
    Addedrename checklist to to-do list — Changed terminology from "checklist" to "to-do list"
    Addeddrag & drop — Rewrote the drag and drop system for smoother interactions
    Addedflat data model — Changed from nested to flat structure using parentId and contentIds references
    Addedlists: flat data model — List items now use the flat data structure
    Addedkeyboard navigation — Added keyboard shortcuts for editing without the mouse
    Addedlist tools — Added numbered lists, ordered (nested) lists, and to-do lists with checkboxes
    Addedparagraph tool: custom configuration — The paragraph tool supports custom configuration for placeholder text and styling
    Addedheader tool: custom configuration — The header tool supports custom configuration for levels and placeholder text
    Addednavigation mode — Added arrow key navigation through blocks, separate from text editing
    AddedUX improvements — Focus management, cursor positioning, and block interactions
    Fixedtranslation keys: camelCase — Converted all translation keys to camelCase
    Fixedtranslation key parsing — Fixed nested translation key parsing
    Fixedremove redundant translation keys — Cleaned up duplicate and unused translation keys
    Fixedfix Russian translation — Corrected a missing word in the Russian translation
    Fixedfake selection display — Fixed how fake (visual-only) selections render
    Fixedclose inline toolbar on outside click — The inline toolbar now closes when clicking outside the editor
    Fixedtoolbar centering — Fixed toolbar positioning to stay centered regardless of content width
  56. v0.3.1-beta.0PatchDec 3, 2025
    Changedcodemod improvements — Better pattern matching and safer transformations for the Editor.js migration
  57. v0.3.0MinorDec 2, 2025

    bundle paragraph and header tools — These tools are now included by default in the core bundle

    Addedbundle paragraph and header tools — These tools are now included by default in the core bundle
  58. v0.2.0MinorDec 2, 2025

    drag & drop — Block reordering via the block handle (☰) icon

    Addeddrag & drop — Block reordering via the block handle (☰) icon
    Fixedremove debug logging — Cleaned up console.log statements and resolved performance bottlenecks
    Changedrebrand to Blok — Updated logos, color schemes, and documentation
  59. v0.1.0MinorNov 24, 2025

    fork from Editor.js — Blok forked from Editor.js, preserving the block-based editing architecture

    Changedfork from Editor.js — Blok forked from Editor.js, preserving the block-based editing architecture
    Changedinitial feature set — Block management, inline formatting, slash toolbox, and plugin system