@jackuait/blok-cli 0.10.0-beta.15

package/bin/blok-cli.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+
+import { readFileSync } from 'node:fs';
+import { run } from '../dist/cli.mjs';
+
+const version = process.env.npm_package_version
+  || JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf-8')).version;
+const args = process.argv.slice(2);
+
+run(args, version);

package/dist/cli.mjs

@@ -0,0 +1,51 @@
+import * as e from "node:fs";
+//#region src/cli/commands/migrationContent.ts
+var t = "# Migrating from EditorJS to Blok\n\nThis guide covers the breaking changes when migrating from EditorJS to Blok.\n\n## Table of Contents\n\n- [Core Changes](#core-changes)\n- [Data Attributes](#data-attributes)\n- [CSS Classes](#css-classes)\n- [Bundled Tools](#bundled-tools)\n  - [Tool Configuration](#tool-configuration)\n  - [Lifecycle Hooks](#lifecycle-hooks)\n  - [Delimiter → Divider](#delimiter--divider)\n- [Configuration Defaults](#configuration-defaults)\n- [New API Methods](#new-api-methods)\n- [DOM Selectors](#dom-selectors)\n- [E2E Test Selectors](#e2e-test-selectors)\n\n---\n\n## Core Changes\n\n### Class Name\n\n```diff\n- import EditorJS from '@editorjs/editorjs';\n+ import Blok from '@jackuait/blok';\n\n- const editor = new EditorJS({ ... });\n+ const editor = new Blok({ ... });\n```\n\n### Default Holder\n\nThe default holder ID changed from `editorjs` to `blok`:\n\n```diff\n- <div id=\"editorjs\"></div>\n+ <div id=\"blok\"></div>\n```\n\nOr specify explicitly:\n\n```javascript\nconst editor = new Blok({\n  holder: 'my-editor', // works the same as before\n});\n```\n\n### TypeScript Types\n\n```diff\n- import type { EditorConfig, OutputData } from '@editorjs/editorjs';\n+ import type { BlokConfig, OutputData } from '@jackuait/blok';\n```\n\n---\n\n## Data Attributes\n\nBlok uses `data-blok-*` attributes instead of EditorJS's mixed naming conventions.\n\n| EditorJS | Blok |\n|----------|------|\n| `data-id` | `data-blok-id` |\n| `data-item-name` | `data-blok-item-name` |\n| `data-empty` | `data-blok-empty` |\n| `.ce-block--selected` (class) | `data-blok-selected=\"true\"` |\n| — | `data-blok-component` (tool name) |\n| — | `data-blok-interface` (element type) |\n| — | `data-blok-testid` (testing) |\n| — | `data-blok-opened` (toolbar state) |\n| — | `data-blok-placeholder` |\n| — | `data-blok-stretched` |\n| — | `data-blok-focused` |\n| — | `data-blok-popover-opened` |\n| — | `data-blok-tool` (tool name on rendered element) |\n| — | `data-blok-dragging` (block being dragged) |\n| — | `data-blok-hidden` (hidden state) |\n| — | `data-blok-rtl` (RTL mode) |\n| — | `data-blok-drag-handle` (drag handle element) |\n| — | `data-blok-overlay` (selection overlay) |\n| — | `data-blok-overlay-rectangle` (selection rectangle) |\n\n### Querying Blocks\n\n```diff\n- document.querySelector('[data-id=\"abc123\"]');\n+ document.querySelector('[data-blok-id=\"abc123\"]');\n\n- document.querySelector('[data-item-name=\"bold\"]');\n+ document.querySelector('[data-blok-item-name=\"bold\"]');\n```\n\n---\n\n## CSS Classes\n\nBlok replaces BEM class names with data attributes for selection.\n\n### Editor Wrapper\n\n| EditorJS | Blok |\n|----------|------|\n| `.codex-editor` | `[data-blok-editor]` |\n| `.codex-editor__redactor` | `[data-blok-redactor]` |\n| `.codex-editor--rtl` | `[data-blok-rtl=\"true\"]` |\n\n### Block Elements\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-block` | `[data-blok-element]` |\n| `.ce-block--selected` | `[data-blok-selected=\"true\"]` |\n| `.ce-block--stretched` | `[data-blok-stretched=\"true\"]` |\n| `.ce-block--focused` | `[data-blok-focused=\"true\"]` |\n| `.ce-block__content` | `[data-blok-element-content]` |\n\n### Toolbar\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-toolbar` | `[data-blok-toolbar]` |\n| `.ce-toolbar__plus` | `[data-blok-testid=\"plus-button\"]` |\n| `.ce-toolbar__settings-btn` | `[data-blok-settings-toggler]` |\n| `.ce-toolbar__actions` | `[data-blok-testid=\"toolbar-actions\"]` |\n| `.ce-toolbox` | `[data-blok-toolbox]` |\n| `.ce-toolbox--opened` | `[data-blok-toolbox][data-blok-opened=\"true\"]` |\n\n### Inline Toolbar\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-inline-toolbar` | `[data-blok-testid=\"inline-toolbar\"]` |\n| `.ce-inline-tool` | `[data-blok-testid=\"inline-tool\"]` |\n| `.ce-inline-tool--link` | `[data-blok-testid=\"inline-tool-link\"]` |\n| `.ce-inline-tool--bold` | `[data-blok-testid=\"inline-tool-bold\"]` |\n| `.ce-inline-tool--italic` | `[data-blok-testid=\"inline-tool-italic\"]` |\n\n### Popover\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-popover` | `[data-blok-popover]` |\n| `.ce-popover--opened` | `[data-blok-popover][data-blok-opened=\"true\"]` |\n| `.ce-popover__container` | `[data-blok-popover-container]` |\n| `.ce-popover-item` | `[data-blok-testid=\"popover-item\"]` |\n| `.ce-popover-item--focused` | `[data-blok-focused=\"true\"]` |\n| `.ce-popover-item--confirmation` | `[data-blok-confirmation=\"true\"]` |\n| `.ce-popover-item__icon` | `[data-blok-testid=\"popover-item-icon\"]` |\n| `.ce-popover-item__icon--tool` | `[data-blok-testid=\"popover-item-icon-tool\"]` |\n\n### Tool-Specific Classes\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-paragraph` | `[data-blok-tool=\"paragraph\"]` |\n| `.ce-header` | `[data-blok-tool=\"header\"]` |\n\n### Conversion Toolbar & Settings\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-conversion-toolbar` | `[data-blok-testid=\"conversion-toolbar\"]` |\n| `.ce-conversion-tool` | `[data-blok-testid=\"conversion-tool\"]` |\n| `.ce-settings` | `[data-blok-testid=\"block-settings\"]` |\n| `.ce-tune` | `[data-blok-testid=\"block-tune\"]` |\n\n### Other Elements\n\n| EditorJS | Blok |\n|----------|------|\n| `.ce-stub` | `[data-blok-stub]` |\n| `.ce-drag-handle` | `[data-blok-drag-handle]` |\n| `.ce-ragged-right` | `[data-blok-ragged-right=\"true\"]` |\n\n### CDX List Classes\n\n| EditorJS | Blok |\n|----------|------|\n| `.cdx-list` | `[data-blok-list]` |\n| `.cdx-list__item` | `[data-blok-list-item]` |\n| `.cdx-list--ordered` | `[data-blok-list=\"ordered\"]` |\n| `.cdx-list--unordered` | `[data-blok-list=\"unordered\"]` |\n\n### CDX Utility Classes\n\n| EditorJS | Blok |\n|----------|------|\n| `.cdx-button` | `[data-blok-button]` |\n| `.cdx-input` | `[data-blok-input]` |\n| `.cdx-loader` | `[data-blok-loader]` |\n| `.cdx-search-field` | `[data-blok-search-field]` |\n\n---\n\n## Bundled Tools\n\nBlok includes Header and Paragraph tools. No external packages needed:\n\n```diff\n- import Header from '@editorjs/header';\n- import Paragraph from '@editorjs/paragraph';\n\n+ import Blok from '@jackuait/blok';\n\nconst editor = new Blok({\n  tools: {\n-   header: Header,\n-   paragraph: Paragraph,\n+   header: Blok.Header,\n+   paragraph: Blok.Paragraph, // optional, it's the default\n  },\n});\n```\n\n### Tool Configuration\n\nBoth bundled tools accept configuration options:\n\n#### HeaderConfig\n\n```typescript\nimport type { HeaderConfig } from '@jackuait/blok';\n\nconst editor = new Blok({\n  tools: {\n    header: {\n      class: Blok.Header,\n      config: {\n        placeholder: 'Enter a heading',\n        levels: [2, 3, 4],      // Restrict to H2-H4 only\n        defaultLevel: 2,        // Default to H2\n      } as HeaderConfig,\n    },\n  },\n});\n```\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `placeholder` | `string` | `''` | Placeholder text for empty header |\n| `levels` | `number[]` | `[1,2,3,4,5,6]` | Available heading levels (1-6) |\n| `defaultLevel` | `number` | `2` | Default heading level |\n\n#### ParagraphConfig\n\n```typescript\nimport type { ParagraphConfig } from '@jackuait/blok';\n\nconst editor = new Blok({\n  tools: {\n    paragraph: {\n      class: Blok.Paragraph,\n      config: {\n        placeholder: 'Start typing...',\n        preserveBlank: true,\n      } as ParagraphConfig,\n    },\n  },\n});\n```\n\n| Option | Type | Default | Description |\n|--------|------|---------|-------------|\n| `placeholder` | `string` | `''` | Placeholder text for empty paragraph |\n| `preserveBlank` | `boolean` | `false` | Keep empty paragraphs when saving |\n\n### Delimiter → Divider\n\nEditor.js's `@editorjs/delimiter` is replaced by Blok's built-in `divider` tool:\n\n```diff\n- import Delimiter from '@editorjs/delimiter';\n\nconst editor = new Blok({\n  tools: {\n-   delimiter: Delimiter,\n+   divider: Blok.Divider,\n  },\n});\n```\n\n**Saved data migration:** The block type name changed from `\"delimiter\"` to `\"divider\"`. The data format is identical (empty `{}`):\n\n```diff\n  {\n-   \"type\": \"delimiter\",\n+   \"type\": \"divider\",\n    \"data\": {}\n  }\n```\n\n> **Note:** Blok automatically recognizes `\"delimiter\"` blocks and renders them as dividers, so existing articles work without data migration. However, renaming the type in your database is recommended for consistency.\n\n---\n\n## Configuration Defaults\n\n| Option | EditorJS | Blok |\n|--------|----------|------|\n| `holder` | `\"editorjs\"` | `\"blok\"` |\n| `defaultBlock` | `\"paragraph\"` | `\"paragraph\"` |\n\n---\n\n## New API Methods\n\nBlok exposes shorthand methods directly on the instance:\n\n```javascript\nconst editor = new Blok({ ... });\n\n// Shorthand methods\nawait editor.save();      // Same as editor.saver.save()\neditor.clear();           // Same as editor.blocks.clear()\nawait editor.render(data);// Same as editor.blocks.render(data)\neditor.focus();           // Same as editor.caret.focus()\n\n// Event methods\neditor.on('change', handler);   // Same as editor.events.on()\neditor.off('change', handler);  // Same as editor.events.off()\neditor.emit('custom', data);    // Same as editor.events.emit()\n```\n\n---\n\n## DOM Selectors\n\nBlok uses consistent `data-blok-interface` attributes for major UI components:\n\n```javascript\n// Find the editor wrapper\nconst editorWrapper = document.querySelector('[data-blok-interface=\"blok\"]');\n\n// Find inline toolbar\nconst inlineToolbar = document.querySelector('[data-blok-interface=\"inline-toolbar\"]');\n\n// Find tooltip\nconst tooltip = document.querySelector('[data-blok-interface=\"tooltip\"]');\n```\n\nThese selectors are stable and recommended for programmatic access to Blok's UI components.\n\n### Key Changes\n\n1. **Prefix custom classes** with `blok-` instead of `ce-` or `cdx-`\n2. **Use `data-blok-*`** attributes instead of `data-*`\n\n---\n\n## E2E Test Selectors\n\nUpdate your test selectors to use Blok's `data-blok-testid` attributes:\n\n| EditorJS | Blok |\n|----------|------|\n| `[data-cy=editorjs]` | `[data-blok-testid=\"blok-editor\"]` |\n| `.ce-block` | `[data-blok-element]` |\n| `.ce-block__content` | `[data-blok-element-content]` |\n| `.ce-toolbar` | `[data-blok-toolbar]` |\n| `.ce-toolbar__plus` | `[data-blok-testid=\"plus-button\"]` |\n| `.ce-toolbar__settings-btn` | `[data-blok-settings-toggler]` |\n| `.ce-toolbar__actions` | `[data-blok-testid=\"toolbar-actions\"]` |\n| `.ce-toolbox` | `[data-blok-toolbox]` |\n| `.ce-inline-toolbar` | `[data-blok-testid=\"inline-toolbar\"]` |\n| `.ce-popover` | `[data-blok-popover]` |\n| `.ce-popover-item` | `[data-blok-testid=\"popover-item\"]` |\n| `[data-item-name=\"...\"]` | `[data-blok-item-name=\"...\"]` |\n\n### Playwright Example\n\n```diff\n// EditorJS\n- await page.locator('[data-cy=editorjs] .ce-block').click();\n- await page.locator('.ce-toolbar__settings-btn').click();\n- await page.locator('[data-item-name=\"delete\"]').click();\n\n// Blok\n+ await page.locator('[data-blok-element]').click();\n+ await page.locator('[data-blok-settings-toggler]').click();\n+ await page.locator('[data-blok-item-name=\"delete\"]').click();\n```\n\n### Additional Test Selectors\n\n| Element | Selector |\n|---------|----------|\n| Block tunes popover | `[data-blok-testid=\"block-tunes-popover\"]` |\n| Popover search input | `[data-blok-testid=\"popover-search-input\"]` |\n| Popover item title | `[data-blok-testid=\"popover-item-title\"]` |\n| Popover overlay | `[data-blok-testid=\"popover-overlay\"]` |\n| Inline tool input | `[data-blok-testid=\"inline-tool-input\"]` |\n| Tooltip | `[data-blok-testid=\"tooltip\"]` |\n| Redactor | `[data-blok-testid=\"redactor\"]` |\n| Toolbox | `[data-blok-testid=\"toolbox\"]` |\n| Toolbox popover | `[data-blok-testid=\"toolbox-popover\"]` |\n| Selection overlay | `[data-blok-testid=\"overlay\"]` |\n| Selection rectangle | `[data-blok-testid=\"overlay-rectangle\"]` |\n\n---\n\n### State Selectors\n\n| State | Selector |\n|-------|----------|\n| Toolbar opened | `[data-blok-opened=\"true\"]` |\n| Block selected | `[data-blok-selected=\"true\"]` |\n| Popover opened | `[data-blok-popover-opened=\"true\"]` |\n| Item focused | `[data-blok-focused=\"true\"]` |\n| Item disabled | `[data-blok-disabled=\"true\"]` |\n| Nested popover | `[data-blok-nested=\"true\"]` |\n| Toolbox opened | `[data-blok-toolbox-opened=\"true\"]` |\n| Block dragging | `[data-blok-dragging=\"true\"]` |\n| Element hidden | `[data-blok-hidden=\"true\"]` |\n| RTL mode | `[data-blok-rtl=\"true\"]` |\n\n---\n\n## Quick Checklist\n\n- [ ] Replace `new EditorJS` with `new Blok`\n- [ ] Update imports from `@editorjs/*` to `@jackuait/blok`\n- [ ] Change holder from `editorjs` to `blok` (or specify explicitly)\n- [ ] Use bundled tools: `Blok.Header`, `Blok.Paragraph`\n- [ ] Replace `@editorjs/delimiter` with built-in `Blok.Divider`\n- [ ] Update `EditorConfig` type to `BlokConfig`\n- [ ] Replace `data-id` with `data-blok-id` in queries\n- [ ] Replace `data-item-name` with `data-blok-item-name`\n- [ ] Replace `.ce-*` selectors with `[data-blok-*]` attributes\n- [ ] Replace `.cdx-*` selectors with `[data-blok-*]` attributes\n- [ ] Update E2E test selectors\n", n = (e) => [
+	"# Blok Migration Guide (for LLM-assisted migration)",
+	"",
+	"> This document contains everything needed to migrate a project from EditorJS to Blok.",
+	"> Apply these changes systematically to the user's codebase.",
+	`> Current Blok version: ${e}`,
+	"",
+	"---",
+	""
+].join("\n") + t, r = (t, n) => {
+	n ? (e.writeFileSync(n, t, "utf-8"), process.stderr.write(`Written to ${n}\n`)) : process.stdout.write(t);
+}, i = "Usage: blok-cli [options]\n\nOptions:\n  --convert-html       Convert legacy HTML from stdin to Blok JSON (stdout)\n  --migration          Output the EditorJS to Blok migration guide (LLM-friendly)\n  --output <file>      Write output to a file instead of stdout\n  --help               Show this help message\n\nExamples:\n  npx @jackuait/blok-cli --convert-html < article.html\n  npx @jackuait/blok-cli --convert-html < article.html --output article.json\n  npx @jackuait/blok-cli --migration\n  npx @jackuait/blok-cli --migration | pbcopy\n  npx @jackuait/blok-cli --migration --output migration-guide.md\n", a = (e) => {
+	if (e.includes("--help")) return { command: "help" };
+	if (e.includes("--convert-html")) {
+		let t = e.indexOf("--output");
+		return {
+			command: "convert-html",
+			output: t === -1 ? void 0 : e[t + 1]
+		};
+	}
+	if (e.includes("--migration")) {
+		let t = e.indexOf("--output");
+		return {
+			command: "migration",
+			output: t === -1 ? void 0 : e[t + 1]
+		};
+	}
+	return { command: null };
+}, o = async (e, t) => {
+	let { command: o, output: s } = a(e);
+	switch (o) {
+		case "convert-html": {
+			let e = new (await (import("jsdom"))).JSDOM("");
+			globalThis.DOMParser = e.window.DOMParser, globalThis.Node = e.window.Node;
+			let { convertHtml: t } = await import("./convert-html-CnpK6ocW.mjs");
+			r(t((await import("node:fs")).readFileSync("/dev/stdin", "utf-8")), s);
+			break;
+		}
+		case "migration":
+			r(n(t), s);
+			break;
+		case "help":
+		case null:
+			process.stdout.write(i);
+			break;
+	}
+};
+//#endregion
+export { o as run };

package/dist/convert-html-CnpK6ocW.mjs

@@ -0,0 +1,603 @@
+//#region src/cli/commands/convert-html/preprocessor.ts
+function e(e) {
+	t(e), r(e), s(e), c(e), l(e), d(e);
+}
+function t(e) {
+	let t = e.ownerDocument;
+	for (let n of Array.from(e.querySelectorAll("div[style]"))) {
+		if (n.closest("table")) continue;
+		let e = o(n);
+		if (!e || i(e)) continue;
+		let r = t.createElement("aside");
+		r.style.backgroundColor = e, r.append(...Array.from(n.childNodes));
+		let a;
+		for (; (a = Array.from(r.querySelectorAll(":scope > div")).filter((e) => !e.getAttribute("style") && !e.getAttribute("class"))).length > 0;) for (let e of a) e.replaceWith(...Array.from(e.childNodes));
+		for (let e of Array.from(r.querySelectorAll("p"))) {
+			let t = e.lastElementChild;
+			t?.tagName === "BR" && t.remove();
+		}
+		n.replaceWith(r);
+	}
+}
+var n = 250;
+function r(e) {
+	let t = e.querySelectorAll("[style*=\"background-color\"]");
+	for (let e of Array.from(t)) i(e.style.backgroundColor) && (e.style.removeProperty("background-color"), e.getAttribute("style")?.trim() === "" && e.removeAttribute("style"), a(e) && e.replaceWith(...Array.from(e.childNodes)));
+}
+function i(e) {
+	if (!e) return !1;
+	let t = e.replace(/\s/g, "").toLowerCase();
+	if (t === "transparent") return !0;
+	let r = t.match(/^rgba?\((\d+),(\d+),(\d+)(?:,([^)]+))?\)$/);
+	if (!r) return !1;
+	if ((r[4] === void 0 ? 1 : parseFloat(r[4])) === 0) return !0;
+	let i = parseInt(r[1], 10), a = parseInt(r[2], 10), o = parseInt(r[3], 10);
+	return i >= n && a >= n && o >= n;
+}
+function a(e) {
+	return e.attributes.length > 0 ? !1 : (e.textContent ?? "").replace(/[\s\u00A0]/g, "").length === 0;
+}
+function o(e) {
+	if (e.style.backgroundColor) return e.style.backgroundColor;
+	let t = (e.getAttribute("style") ?? "").match(/background:\s*([^;]+)/i);
+	if (t) {
+		let e = t[1].trim().match(/^(rgb[a]?\([^)]+\)|#[0-9a-fA-F]{3,8}|[a-z]+)$/i);
+		if (e) return e[1];
+	}
+	return "";
+}
+function s(e) {
+	let t = e.ownerDocument;
+	for (let n of Array.from(e.querySelectorAll("td, th"))) {
+		let e = n.querySelectorAll("p");
+		if (e.length !== 0) {
+			for (let n of Array.from(e)) {
+				if (n.innerHTML.trim() === "" || n.innerHTML.trim() === " ") {
+					n.remove();
+					continue;
+				}
+				let e = t.createDocumentFragment();
+				e.append(...Array.from(n.childNodes)), e.append(t.createElement("br")), n.replaceWith(e);
+			}
+			f(n);
+		}
+	}
+}
+function c(e) {
+	for (let t of Array.from(e.querySelectorAll("p"))) t.closest("td") || t.closest("th") || (t.textContent ?? "").replace(/[\s\u00A0]/g, "").length === 0 && t.remove();
+}
+function l(e) {
+	let t = e.ownerDocument;
+	for (let n of Array.from(e.querySelectorAll("del, strike"))) {
+		let e = t.createElement("s");
+		e.append(...Array.from(n.childNodes)), n.replaceWith(e);
+	}
+}
+var u = /^[\u2022\u00B7][\s\u00A0]*|^-\s/;
+function d(e) {
+	let t = e.ownerDocument, n = Array.from(e.childNodes), r = null;
+	for (let e of n) {
+		if (e.nodeType !== Node.ELEMENT_NODE) continue;
+		let n = e;
+		if (n.tagName !== "P") {
+			r = null;
+			continue;
+		}
+		let i = n.textContent ?? "";
+		if (!u.test(i)) {
+			r = null;
+			continue;
+		}
+		r || (r = t.createElement("ul"), n.before(r));
+		let a = t.createElement("li"), o = p(n);
+		o && (o.textContent = (o.textContent ?? "").replace(u, "")), a.append(...Array.from(n.childNodes)), r.appendChild(a), n.remove();
+	}
+}
+function f(e) {
+	let t = e.lastChild;
+	for (; t;) if (t.nodeType === Node.ELEMENT_NODE && t.tagName === "BR") {
+		let e = t.previousSibling;
+		t.remove(), t = e;
+	} else if (t.nodeType === Node.TEXT_NODE && t.textContent?.trim() === "") {
+		let e = t.previousSibling;
+		t.remove(), t = e;
+	} else break;
+}
+function p(e) {
+	if (e.nodeType === Node.TEXT_NODE) return e;
+	for (let t of Array.from(e.childNodes)) {
+		let e = p(t);
+		if (e) return e;
+	}
+	return null;
+}
+//#endregion
+//#region src/cli/commands/convert-html/sanitizer.ts
+var m = {
+	B: !0,
+	STRONG: !0,
+	I: !0,
+	EM: !0,
+	A: new Set(["href"]),
+	S: !0,
+	U: !0,
+	CODE: !0,
+	MARK: new Set(["style"]),
+	BR: !0,
+	P: !0,
+	H1: !0,
+	H2: !0,
+	H3: !0,
+	H4: !0,
+	H5: !0,
+	H6: !0,
+	UL: !0,
+	OL: !0,
+	LI: new Set(["aria-level"]),
+	TABLE: !0,
+	THEAD: !0,
+	TBODY: !0,
+	TR: !0,
+	TD: new Set(["style"]),
+	TH: new Set(["style"]),
+	BLOCKQUOTE: !0,
+	PRE: !0,
+	HR: !0,
+	ASIDE: new Set(["style"]),
+	DETAILS: !0,
+	SUMMARY: !0,
+	IMG: new Set(["src", "style"])
+};
+function h(e) {
+	g(e);
+}
+function g(e) {
+	let t = Array.from(e.childNodes);
+	for (let e of t) {
+		if (e.nodeType !== e.ELEMENT_NODE) continue;
+		let n = e, r = m[n.tagName];
+		if (r === void 0) {
+			let e = Array.from(n.childNodes);
+			for (let t of e) n.before(t);
+			n.remove();
+			for (let n of e) n.nodeType === n.ELEMENT_NODE && t.push(n);
+		} else {
+			if (r !== !0) for (let e of Array.from(n.attributes)) r.has(e.name) || n.removeAttribute(e.name);
+			else for (let e of Array.from(n.attributes)) n.removeAttribute(e.name);
+			g(n);
+		}
+	}
+}
+//#endregion
+//#region src/cli/commands/convert-html/id-generator.ts
+function _() {
+	let e = /* @__PURE__ */ new Map();
+	return (t) => {
+		let n = (e.get(t) ?? 0) + 1;
+		return e.set(t, n), `${t}-${n}`;
+	};
+}
+//#endregion
+//#region src/components/shared/color-presets.ts
+var v = [
+	{
+		name: "gray",
+		text: "#787774",
+		bg: "#f1f1ef"
+	},
+	{
+		name: "brown",
+		text: "#9f6b53",
+		bg: "#f4eeee"
+	},
+	{
+		name: "orange",
+		text: "#d9730d",
+		bg: "#fbecdd"
+	},
+	{
+		name: "yellow",
+		text: "#cb9b00",
+		bg: "#fbf3db"
+	},
+	{
+		name: "green",
+		text: "#448361",
+		bg: "#edf3ec"
+	},
+	{
+		name: "blue",
+		text: "#337ea9",
+		bg: "#e7f3f8"
+	},
+	{
+		name: "purple",
+		text: "#9065b0",
+		bg: "#f6f3f9"
+	},
+	{
+		name: "pink",
+		text: "#c14c8a",
+		bg: "#f9f0f5"
+	},
+	{
+		name: "red",
+		text: "#d44c47",
+		bg: "#fdebec"
+	}
+], y = [
+	{
+		name: "gray",
+		text: "#9b9b9b",
+		bg: "#2f2f2f"
+	},
+	{
+		name: "brown",
+		text: "#c59177",
+		bg: "#452a1c"
+	},
+	{
+		name: "orange",
+		text: "#dc8c47",
+		bg: "#4d2f14"
+	},
+	{
+		name: "yellow",
+		text: "#d4ab49",
+		bg: "#544012"
+	},
+	{
+		name: "green",
+		text: "#5db184",
+		bg: "#1e432f"
+	},
+	{
+		name: "blue",
+		text: "#5c9fcc",
+		bg: "#123a54"
+	},
+	{
+		name: "purple",
+		text: "#a67dca",
+		bg: "#341d49"
+	},
+	{
+		name: "pink",
+		text: "#d45e99",
+		bg: "#4b1b33"
+	},
+	{
+		name: "red",
+		text: "#dd5e5a",
+		bg: "#4e1a18"
+	}
+];
+//#endregion
+//#region src/components/utils/color-mapping.ts
+function b(e, t, n) {
+	let r = t / 100, i = n / 100;
+	if (r === 0) {
+		let e = Math.round(i * 255);
+		return [
+			e,
+			e,
+			e
+		];
+	}
+	let a = (e) => e < 0 ? e + 1 : e > 1 ? e - 1 : e, o = (e, t, n) => {
+		let r = a(n);
+		return r < 1 / 6 ? e + (t - e) * 6 * r : r < 1 / 2 ? t : r < 2 / 3 ? e + (t - e) * (2 / 3 - r) * 6 : e;
+	}, s = i < .5 ? i * (1 + r) : i + r - i * r, c = 2 * i - s, l = e / 360;
+	return [
+		Math.round(o(c, s, l + 1 / 3) * 255),
+		Math.round(o(c, s, l) * 255),
+		Math.round(o(c, s, l - 1 / 3) * 255)
+	];
+}
+function x(e) {
+	let t = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(e);
+	if (t) return [
+		parseInt(t[1], 16),
+		parseInt(t[2], 16),
+		parseInt(t[3], 16)
+	];
+	let n = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})[0-9a-f]{2}$/i.exec(e);
+	if (n) return [
+		parseInt(n[1], 16),
+		parseInt(n[2], 16),
+		parseInt(n[3], 16)
+	];
+	let r = /^#([0-9a-f])([0-9a-f])([0-9a-f])$/i.exec(e);
+	if (r) return [
+		parseInt(r[1] + r[1], 16),
+		parseInt(r[2] + r[2], 16),
+		parseInt(r[3] + r[3], 16)
+	];
+	let i = /^#([0-9a-f])([0-9a-f])([0-9a-f])[0-9a-f]$/i.exec(e);
+	if (i) return [
+		parseInt(i[1] + i[1], 16),
+		parseInt(i[2] + i[2], 16),
+		parseInt(i[3] + i[3], 16)
+	];
+	let a = /^rgba?\(\s*(\d{1,3})\s*,\s*(\d{1,3})\s*,\s*(\d{1,3})\s*(?:,\s*[\d.]+\s*)?\)$/i.exec(e);
+	if (a) return [
+		Number(a[1]),
+		Number(a[2]),
+		Number(a[3])
+	];
+	let o = /^hsla?\(\s*([\d.]+)\s*,\s*([\d.]+)%\s*,\s*([\d.]+)%\s*(?:,\s*[\d.]+\s*)?\)$/i.exec(e);
+	return o ? b(Number(o[1]), Number(o[2]), Number(o[3])) : null;
+}
+var S = .1;
+function C(e) {
+	let t = e[0] / 255, n = e[1] / 255, r = e[2] / 255, i = Math.max(t, n, r), a = Math.min(t, n, r), o = (i + a) / 2;
+	if (i === a) return [
+		0,
+		0,
+		o
+	];
+	let s = i - a, c = o > .5 ? s / (2 - i - a) : s / (i + a);
+	return [
+		((e) => e === t ? ((n - r) / s + (n < r ? 6 : 0)) / 6 : e === n ? ((r - t) / s + 2) / 6 : ((t - n) / s + 4) / 6)(i) * 360,
+		c,
+		o
+	];
+}
+function w(e, t) {
+	let n = e[1] < S, r = t[1] < S;
+	if (n && r) {
+		let n = Math.abs(e[2] - t[2]);
+		return n * n;
+	}
+	if (n !== r) return 1e3;
+	let i = Math.abs(e[0] - t[0]), a = Math.min(i, 360 - i) / 180, o = Math.abs(e[1] - t[1]), s = Math.abs(e[2] - t[2]);
+	return 8 * a * a + 1 * o * o + 1 * s * s;
+}
+function T(e, t) {
+	let n = x(e);
+	if (n === null) return null;
+	let r = C(n);
+	return [...v, ...y].reduce((e, n) => {
+		let i = x(n[t]);
+		if (i === null) return e;
+		let a = w(r, C(i));
+		return e === null || a < e.distance ? {
+			name: n.name,
+			distance: a
+		} : e;
+	}, null)?.name ?? null;
+}
+//#endregion
+//#region src/cli/commands/convert-html/block-builder.ts
+function E(e) {
+	let t = _(), n = [];
+	for (let r of Array.from(e.childNodes)) D(r, n, t);
+	return n;
+}
+function D(e, t, n) {
+	if (e.nodeType === Node.TEXT_NODE) {
+		let r = e.textContent?.trim() ?? "";
+		r && t.push({
+			id: n("paragraph"),
+			type: "paragraph",
+			data: { text: r }
+		});
+		return;
+	}
+	if (e.nodeType !== Node.ELEMENT_NODE) return;
+	let r = e, i = r.tagName;
+	if (i === "P") {
+		t.push({
+			id: n("paragraph"),
+			type: "paragraph",
+			data: { text: r.innerHTML }
+		});
+		return;
+	}
+	if (/^H[1-6]$/.test(i)) {
+		let e = Number(i[1]);
+		t.push({
+			id: n("header"),
+			type: "header",
+			data: {
+				text: r.innerHTML,
+				level: e
+			}
+		});
+		return;
+	}
+	if (i === "BLOCKQUOTE") {
+		t.push({
+			id: n("quote"),
+			type: "quote",
+			data: {
+				text: r.innerHTML,
+				size: "default"
+			}
+		});
+		return;
+	}
+	if (i === "PRE") {
+		t.push({
+			id: n("code"),
+			type: "code",
+			data: {
+				code: r.textContent ?? "",
+				language: "plain-text"
+			}
+		});
+		return;
+	}
+	if (i === "HR") {
+		t.push({
+			id: n("divider"),
+			type: "divider",
+			data: {}
+		});
+		return;
+	}
+	if (i === "IMG") {
+		let e = r.getAttribute("src") ?? "", i = j(r, "width"), a = null;
+		if (i) {
+			let e = parseInt(i, 10);
+			isNaN(e) || (a = e);
+		}
+		t.push({
+			id: n("image"),
+			type: "image",
+			data: { url: e },
+			stretched: null,
+			key: null,
+			width: a
+		});
+		return;
+	}
+	if (i === "DETAILS") {
+		let e = r.querySelector("summary"), i = e ? e.innerHTML : r.innerHTML;
+		t.push({
+			id: n("toggle"),
+			type: "toggle",
+			data: { text: i }
+		});
+		return;
+	}
+	if (i === "UL" || i === "OL") {
+		O(r, i === "OL" ? "ordered" : "unordered", 0, t, n);
+		return;
+	}
+	if (i === "TABLE") {
+		k(r, t, n);
+		return;
+	}
+	if (i === "ASIDE") {
+		A(r, t, n);
+		return;
+	}
+	t.push({
+		id: n("paragraph"),
+		type: "paragraph",
+		data: { text: r.innerHTML }
+	});
+}
+function O(e, t, n, r, i) {
+	let a = e.getAttribute("start"), o = a ? Number(a) : null, s = !0;
+	for (let a of Array.from(e.children)) {
+		if (a.tagName !== "LI") continue;
+		let e = a.cloneNode(!0), c = [];
+		for (let t of Array.from(e.querySelectorAll("ul, ol"))) c.push(t.cloneNode(!0)), t.remove();
+		let l = e.innerHTML.trim(), u = a.getAttribute("aria-level"), d = n;
+		u && (d = Math.max(0, parseInt(u, 10) - 1)), r.push({
+			id: i("list"),
+			type: "list",
+			data: {
+				text: l,
+				style: t,
+				depth: d === 0 ? null : d,
+				checked: null,
+				start: s && o !== null ? o : null
+			}
+		}), s = !1;
+		for (let e of c) O(e, e.tagName === "OL" ? "ordered" : "unordered", n + 1, r, i);
+	}
+}
+function k(e, t, n) {
+	let r = n("table"), i = Array.from(e.querySelectorAll("tr")), a = !1, o = [];
+	for (let e = 0; e < i.length; e++) {
+		let s = i[e], c = Array.from(s.querySelectorAll("td, th"));
+		e === 0 && c.some((e) => e.tagName === "TH") && (a = !0);
+		let l = [];
+		for (let e of c) {
+			let i = e, a = i.innerHTML.trim();
+			if (a) {
+				let e = n("paragraph");
+				t.push({
+					id: e,
+					type: "paragraph",
+					parent: r,
+					data: { text: a }
+				});
+				let o = j(i, "background-color"), s = j(i, "color");
+				l.push({
+					blocks: [e],
+					color: o ? T(o, "bg") : null,
+					textColor: s ? T(s, "text") : null
+				});
+			} else l.push({
+				blocks: [],
+				color: null,
+				textColor: null
+			});
+		}
+		o.push(l);
+	}
+	let s = (i[0] ? Array.from(i[0].querySelectorAll("td, th")) : []).map((e) => {
+		let t = j(e, "width");
+		if (t) {
+			let e = parseInt(t, 10);
+			return isNaN(e) ? null : e;
+		}
+		return null;
+	}), c = s.some((e) => e !== null), l = {
+		id: r,
+		type: "table",
+		data: {
+			withHeadings: a,
+			withHeadingColumn: !1,
+			content: o,
+			...c ? { colWidths: s } : {}
+		}
+	}, u = t.findIndex((e) => e.parent === r);
+	u >= 0 ? t.splice(u, 0, l) : t.push(l);
+}
+function A(e, t, n) {
+	let r = n("callout"), i = j(e, "background-color"), a = i ? T(i, "bg") : null, o = [];
+	for (let i of Array.from(e.childNodes)) if (i.nodeType === Node.ELEMENT_NODE) {
+		let e = i, a = n("paragraph");
+		t.push({
+			id: a,
+			type: "paragraph",
+			parent: r,
+			data: { text: e.innerHTML }
+		}), o.push(a);
+	} else if (i.nodeType === Node.TEXT_NODE) {
+		let e = i.textContent?.trim() ?? "";
+		if (e) {
+			let i = n("paragraph");
+			t.push({
+				id: i,
+				type: "paragraph",
+				parent: r,
+				data: { text: e }
+			}), o.push(i);
+		}
+	}
+	let s = t.findIndex((e) => e.parent === r), c = {
+		id: r,
+		type: "callout",
+		data: {
+			emoji: "💡",
+			backgroundColor: a ?? "gray"
+		},
+		content: o
+	};
+	s >= 0 ? t.splice(s, 0, c) : t.push(c);
+}
+function j(e, t) {
+	let n = e.getAttribute("style");
+	if (!n) return null;
+	let r = RegExp(`(?<![\\-a-z])${t}\\s*:\\s*([^;]+)`).exec(n);
+	return r ? r[1].trim() : null;
+}
+//#endregion
+//#region src/cli/commands/convert-html/index.ts
+function M(t) {
+	let n = new DOMParser().parseFromString(t, "text/html").body;
+	e(n), h(n);
+	let r = {
+		version: "2.31.0",
+		blocks: E(n)
+	};
+	return JSON.stringify(r);
+}
+//#endregion
+export { M as convertHtml };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@jackuait/blok-cli",
+  "version": "0.10.0-beta.15",
+  "description": "CLI tools for Blok — convert HTML to Blok JSON, generate migration guides",
+  "bin": {
+    "blok-cli": "bin/blok-cli.mjs"
+  },
+  "files": [
+    "bin",
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "blok",
+    "cli",
+    "html-to-json",
+    "editorjs",
+    "migration",
+    "rich-text"
+  ],
+  "author": "JackUait",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/JackUait/blok.git",
+    "directory": "packages/cli"
+  },
+  "dependencies": {
+    "jsdom": "28.1.0"
+  }
+}