@verbb/plugin-kit-tiptap-core 2.0.0

package/dist/toolbar/toolbar-schema.js

@@ -0,0 +1,340 @@
+import { isTiptapButtonActive, isTiptapButtonName, runTiptapButton } from "./button-registry.js";
+//#region src/toolbar/toolbar-schema.ts
+var DEFAULT_HEADING_LEVELS = [
+	1,
+	2,
+	3,
+	4
+];
+var PRESET_DEFAULT_ICONS = {
+	formatting: "paragraph",
+	headings: "heading",
+	lists: "unordered-list",
+	align: "align-left"
+};
+var VALID_PRESETS = new Set([
+	"formatting",
+	"headings",
+	"lists",
+	"align"
+]);
+function isFormattingToolbarPreset(preset) {
+	return preset === "formatting";
+}
+function isHeadingsOnlyToolbarPreset(preset) {
+	return preset === "headings";
+}
+function getToolbarGroupDefaultIcon(group) {
+	if (group.preset) return PRESET_DEFAULT_ICONS[group.preset];
+	return getToolbarGroupItems(group)[0] ?? "bold";
+}
+var SEPARATOR_TOKENS = new Set(["|", "separator"]);
+function isToolbarSeparatorToken(value) {
+	return SEPARATOR_TOKENS.has(value);
+}
+function expandPresetItems(group) {
+	if (group.items?.length) return group.items.filter((item) => typeof item === "string" && isTiptapButtonName(item));
+	switch (group.preset) {
+		case "formatting": return [
+			...(group.headingLevels ?? DEFAULT_HEADING_LEVELS).map((level) => `h${level}`),
+			"blockquote",
+			"code-block"
+		];
+		case "headings": return (group.headingLevels ?? DEFAULT_HEADING_LEVELS).map((level) => `h${level}`);
+		case "lists": return ["unordered-list", "ordered-list"];
+		case "align": return [
+			"align-left",
+			"align-center",
+			"align-right",
+			"align-justify"
+		];
+		default: return [];
+	}
+}
+function getToolbarGroupItems(group) {
+	return expandPresetItems(group);
+}
+function flattenToolbarButtonNames(nodes) {
+	const names = [];
+	nodes.forEach((node) => {
+		if (node.type === "button") {
+			names.push(node.name);
+			return;
+		}
+		if (node.type === "group") names.push(...getToolbarGroupItems(node.group));
+	});
+	return names;
+}
+function toolbarIncludesButton(nodes, buttonName) {
+	return flattenToolbarButtonNames(nodes).includes(buttonName);
+}
+function normalizeGroupItemDefinition(raw) {
+	if (typeof raw === "string") {
+		const token = raw.trim();
+		if (!token) return null;
+		if (isToolbarSeparatorToken(token)) return token;
+		if (token === "paragraph") return "paragraph";
+		return normalizeButtonName(token);
+	}
+	if (!raw || typeof raw !== "object") return null;
+	const record = raw;
+	if (record.type === "separator") return { type: "separator" };
+	if (record.type === "item" && typeof record.name === "string") {
+		if (record.name === "paragraph") return "paragraph";
+		return normalizeButtonName(record.name);
+	}
+	return null;
+}
+function normalizeGroupItemDefinitions(raw) {
+	return raw.map((item) => normalizeGroupItemDefinition(item)).filter((item) => item !== null);
+}
+function isGroupItemSeparator(item) {
+	return item === "|" || item === "separator" || typeof item === "object" && item.type === "separator";
+}
+function isToolbarGroupMenuButton(item) {
+	return !isGroupItemSeparator(item);
+}
+function groupItemDefinitionsToMenuEntries(items) {
+	return items.flatMap((item) => {
+		if (isGroupItemSeparator(item)) return [{ type: "separator" }];
+		if (!isToolbarGroupMenuButton(item)) return [];
+		return [{
+			type: "item",
+			name: item
+		}];
+	});
+}
+function getToolbarGroupMenuButtons(group) {
+	return getToolbarGroupMenuItems(group).filter((entry) => entry.type === "item").map((entry) => entry.name);
+}
+function normalizeButtonName(value) {
+	return isTiptapButtonName(value) ? value : null;
+}
+function normalizeHeadingLevels(value) {
+	if (!Array.isArray(value)) return;
+	const levels = value.map((level) => Number(level)).filter((level) => [
+		1,
+		2,
+		3,
+		4,
+		5,
+		6
+	].includes(level));
+	return levels.length > 0 ? levels : void 0;
+}
+function normalizeToolbarGroup(raw) {
+	const source = typeof raw.group === "object" && raw.group !== null ? raw.group : raw;
+	const preset = typeof source.preset === "string" ? source.preset : void 0;
+	const label = typeof source.label === "string" ? source.label : void 0;
+	const iconRaw = typeof source.icon === "string" ? source.icon : void 0;
+	const icon = iconRaw ? normalizeButtonName(iconRaw) ?? void 0 : void 0;
+	const headingLevels = normalizeHeadingLevels(source.headingLevels);
+	const items = Array.isArray(source.items) ? normalizeGroupItemDefinitions(source.items) : void 0;
+	if (!preset && !items?.length) return null;
+	if (preset && !VALID_PRESETS.has(preset)) return null;
+	return {
+		type: "group",
+		group: {
+			...label ? { label } : {},
+			...icon ? { icon } : {},
+			...preset ? { preset } : {},
+			...items?.length ? { items } : {},
+			...headingLevels ? { headingLevels } : {}
+		}
+	};
+}
+function normalizeToolbarNode(raw) {
+	if (typeof raw === "string") {
+		const token = raw.trim();
+		if (!token) return null;
+		if (isToolbarSeparatorToken(token)) return { type: "separator" };
+		const buttonName = normalizeButtonName(token);
+		return buttonName ? {
+			type: "button",
+			name: buttonName
+		} : null;
+	}
+	if (!raw || typeof raw !== "object") return null;
+	const record = raw;
+	if (record.type === "separator") return { type: "separator" };
+	if (record.type === "button" && typeof record.name === "string") {
+		const buttonName = normalizeButtonName(record.name);
+		return buttonName ? {
+			type: "button",
+			name: buttonName
+		} : null;
+	}
+	if (record.type === "group" || record.preset || record.items || record.group) return normalizeToolbarGroup(record);
+	if (typeof record.button === "string") {
+		const buttonName = normalizeButtonName(record.button);
+		return buttonName ? {
+			type: "button",
+			name: buttonName
+		} : null;
+	}
+	return null;
+}
+function normalizeToolbarNodes(raw) {
+	return raw.map((item) => normalizeToolbarNode(item)).filter((item) => item !== null);
+}
+function parseToolbarConfig(input) {
+	if (input === null || input === void 0 || input === "") return [{
+		type: "button",
+		name: "bold"
+	}, {
+		type: "button",
+		name: "italic"
+	}];
+	if (Array.isArray(input)) {
+		const normalized = normalizeToolbarNodes(input);
+		return normalized.length > 0 ? normalized : [{
+			type: "button",
+			name: "bold"
+		}, {
+			type: "button",
+			name: "italic"
+		}];
+	}
+	if (typeof input === "string") {
+		const trimmed = input.trim();
+		if (!trimmed) return [{
+			type: "button",
+			name: "bold"
+		}, {
+			type: "button",
+			name: "italic"
+		}];
+		if (trimmed.startsWith("[")) try {
+			const parsed = JSON.parse(trimmed);
+			return Array.isArray(parsed) ? parseToolbarConfig(parsed) : parseToolbarConfig(null);
+		} catch {
+			return parseToolbarConfig(null);
+		}
+		return parseToolbarConfig(trimmed.split(",").map((token) => token.trim()).filter(Boolean));
+	}
+	return parseToolbarConfig(null);
+}
+function runToolbarButton(editor, buttonName, options = {}) {
+	if (buttonName === "paragraph") return editor.chain().focus().setParagraph().run();
+	return runTiptapButton(editor, buttonName, options);
+}
+function isToolbarButtonActive(editor, buttonName) {
+	if (buttonName === "paragraph") return editor.isActive("paragraph") && !editor.isActive("heading");
+	return isTiptapButtonActive(editor, buttonName);
+}
+function getActiveHeadingLevel(editor) {
+	for (const level of [
+		1,
+		2,
+		3,
+		4,
+		5,
+		6
+	]) if (editor.isActive("heading", { level })) return level;
+	return null;
+}
+function getToolbarGroupTriggerState(editor, group) {
+	const fallbackIcon = group.icon ?? getToolbarGroupDefaultIcon(group);
+	const menuButtons = getToolbarGroupMenuButtons(group);
+	if (isHeadingsOnlyToolbarPreset(group.preset)) {
+		const activeLevel = getActiveHeadingLevel(editor);
+		if (activeLevel) {
+			const name = `h${activeLevel}`;
+			return {
+				activeName: name,
+				label: `H${activeLevel}`,
+				isActive: true,
+				icon: name
+			};
+		}
+		return {
+			activeName: null,
+			label: "",
+			isActive: false,
+			icon: "heading"
+		};
+	}
+	if (isFormattingToolbarPreset(group.preset)) {
+		const activeLevel = getActiveHeadingLevel(editor);
+		if (activeLevel) {
+			const name = `h${activeLevel}`;
+			return {
+				activeName: name,
+				label: `H${activeLevel}`,
+				isActive: true,
+				icon: name
+			};
+		}
+		if (isToolbarButtonActive(editor, "blockquote")) return {
+			activeName: "blockquote",
+			label: "",
+			isActive: true,
+			icon: "blockquote"
+		};
+		if (isToolbarButtonActive(editor, "code-block")) return {
+			activeName: "code-block",
+			label: "",
+			isActive: true,
+			icon: "code-block"
+		};
+		return {
+			activeName: "paragraph",
+			label: "Text",
+			isActive: isToolbarButtonActive(editor, "paragraph"),
+			icon: "paragraph"
+		};
+	}
+	const activeName = menuButtons.find((name) => isToolbarButtonActive(editor, name)) ?? null;
+	if (activeName) {
+		const icon = activeName === "paragraph" ? "paragraph" : isTiptapButtonName(activeName) ? activeName : fallbackIcon;
+		return {
+			activeName: activeName === "paragraph" ? "paragraph" : activeName,
+			label: activeName === "paragraph" ? "Text" : group.label ?? activeName,
+			isActive: true,
+			icon
+		};
+	}
+	return {
+		activeName: null,
+		label: group.label ?? "",
+		isActive: false,
+		icon: fallbackIcon
+	};
+}
+function getFormattingHeadingLevels(group) {
+	return group.headingLevels ?? DEFAULT_HEADING_LEVELS;
+}
+function getFormattingMenuEntries(group) {
+	return [
+		{
+			type: "item",
+			name: "paragraph"
+		},
+		{ type: "separator" },
+		...getFormattingHeadingLevels(group).map((level) => ({
+			type: "item",
+			name: `h${level}`
+		})),
+		{ type: "separator" },
+		{
+			type: "item",
+			name: "blockquote"
+		},
+		{
+			type: "item",
+			name: "code-block"
+		}
+	];
+}
+function getToolbarGroupMenuItems(group) {
+	if (group.items?.length) return groupItemDefinitionsToMenuEntries(group.items);
+	if (isFormattingToolbarPreset(group.preset)) return getFormattingMenuEntries(group);
+	return getToolbarGroupItems(group).map((name) => ({
+		type: "item",
+		name
+	}));
+}
+//#endregion
+export { expandPresetItems, flattenToolbarButtonNames, getToolbarGroupDefaultIcon, getToolbarGroupItems, getToolbarGroupMenuItems, getToolbarGroupTriggerState, isFormattingToolbarPreset, isHeadingsOnlyToolbarPreset, isToolbarButtonActive, isToolbarSeparatorToken, normalizeToolbarNodes, parseToolbarConfig, runToolbarButton, toolbarIncludesButton };
+
+//# sourceMappingURL=toolbar-schema.js.map

package/dist/toolbar/toolbar-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toolbar-schema.js","names":[],"sources":["../../src/toolbar/toolbar-schema.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core';\n\nimport {\n    isTiptapButtonActive,\n    isTiptapButtonName,\n    runTiptapButton,\n    type RunTiptapButtonOptions,\n    type TiptapButtonName,\n} from './button-registry.js';\n\n/** Toolbar chrome icons that are not editor commands. */\nexport type ToolbarIconName = TiptapButtonName | 'paragraph' | 'heading';\n\nexport type ToolbarSeparatorToken = '|' | 'separator';\n\n/** Paragraph, headings, blockquote, and code block. */\nexport type ToolbarFormattingPreset = 'formatting';\n\n/** Heading levels only — TipTap-style trigger with icon menu items. */\nexport type ToolbarHeadingsPreset = 'headings';\n\nexport type ToolbarGroupPreset = ToolbarFormattingPreset | ToolbarHeadingsPreset | 'lists' | 'align';\n\nexport type ToolbarHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;\n\nexport type ToolbarGroupMenuButton = TiptapButtonName | 'paragraph';\n\nexport type ToolbarGroupMenuEntry =\n    | { type: 'item'; name: ToolbarGroupMenuButton }\n    | { type: 'separator' };\n\n/** Custom dropdown item — buttons, paragraph, or separators. */\nexport type ToolbarGroupItemDefinition =\n    | ToolbarGroupMenuButton\n    | ToolbarSeparatorToken\n    | { type: 'separator' };\n\nexport type ToolbarGroup = {\n    label?: string;\n    icon?: TiptapButtonName;\n    preset?: ToolbarGroupPreset;\n    items?: ToolbarGroupItemDefinition[];\n    headingLevels?: ToolbarHeadingLevel[];\n};\n\nexport type ToolbarButtonNode = {\n    type: 'button';\n    name: TiptapButtonName;\n};\n\nexport type ToolbarSeparatorNode = {\n    type: 'separator';\n};\n\nexport type ToolbarGroupNode = {\n    type: 'group';\n    group: ToolbarGroup;\n};\n\nexport type ToolbarNode = ToolbarButtonNode | ToolbarSeparatorNode | ToolbarGroupNode;\n\nexport type ToolbarGroupTriggerState = {\n    /** Active item inside the group, or `paragraph` for formatting presets when in body text. */\n    activeName: TiptapButtonName | 'paragraph' | null;\n    /** Short label for the trigger (e.g. `H2`, `Text`). */\n    label: string;\n    /** Whether any item in the group is currently active. */\n    isActive: boolean;\n    /** Icon to render on the trigger when no text label is preferred. */\n    icon: ToolbarIconName;\n};\n\nconst DEFAULT_HEADING_LEVELS: ToolbarHeadingLevel[] = [1, 2, 3, 4];\n\nconst PRESET_DEFAULT_ICONS: Record<ToolbarGroupPreset, ToolbarIconName> = {\n    formatting: 'paragraph',\n    headings: 'heading',\n    lists: 'unordered-list',\n    align: 'align-left',\n};\n\nconst VALID_PRESETS = new Set<string>(['formatting', 'headings', 'lists', 'align']);\n\nexport function isFormattingToolbarPreset(preset?: ToolbarGroupPreset): preset is ToolbarFormattingPreset {\n    return preset === 'formatting';\n}\n\nexport function isHeadingsOnlyToolbarPreset(preset?: ToolbarGroupPreset): preset is ToolbarHeadingsPreset {\n    return preset === 'headings';\n}\n\nexport function getToolbarGroupDefaultIcon(group: ToolbarGroup): ToolbarIconName {\n    if (group.preset) {\n        return PRESET_DEFAULT_ICONS[group.preset];\n    }\n\n    const items = getToolbarGroupItems(group);\n\n    return items[0] ?? 'bold';\n}\n\nconst SEPARATOR_TOKENS = new Set<string>(['|', 'separator']);\n\nexport function isToolbarSeparatorToken(value: string): value is ToolbarSeparatorToken {\n    return SEPARATOR_TOKENS.has(value);\n}\n\nexport function expandPresetItems(group: ToolbarGroup): TiptapButtonName[] {\n    if (group.items?.length) {\n        return group.items\n            .filter((item): item is TiptapButtonName => typeof item === 'string' && isTiptapButtonName(item));\n    }\n\n    switch (group.preset) {\n        case 'formatting': {\n            const levels = group.headingLevels ?? DEFAULT_HEADING_LEVELS;\n            return [\n                ...levels.map((level) => `h${level}` as TiptapButtonName),\n                'blockquote',\n                'code-block',\n            ];\n        }\n        case 'headings': {\n            const levels = group.headingLevels ?? DEFAULT_HEADING_LEVELS;\n            return levels.map((level) => `h${level}` as TiptapButtonName);\n        }\n        case 'lists':\n            return ['unordered-list', 'ordered-list'];\n        case 'align':\n            return ['align-left', 'align-center', 'align-right', 'align-justify'];\n        default:\n            return [];\n    }\n}\n\nexport function getToolbarGroupItems(group: ToolbarGroup): TiptapButtonName[] {\n    return expandPresetItems(group);\n}\n\nexport function flattenToolbarButtonNames(nodes: ToolbarNode[]): TiptapButtonName[] {\n    const names: TiptapButtonName[] = [];\n\n    nodes.forEach((node) => {\n        if (node.type === 'button') {\n            names.push(node.name);\n            return;\n        }\n\n        if (node.type === 'group') {\n            names.push(...getToolbarGroupItems(node.group));\n        }\n    });\n\n    return names;\n}\n\nexport function toolbarIncludesButton(nodes: ToolbarNode[], buttonName: string): boolean {\n    return flattenToolbarButtonNames(nodes).includes(buttonName as TiptapButtonName);\n}\n\nfunction normalizeGroupItemDefinition(raw: unknown): ToolbarGroupItemDefinition | null {\n    if (typeof raw === 'string') {\n        const token = raw.trim();\n\n        if (!token) {\n            return null;\n        }\n\n        if (isToolbarSeparatorToken(token)) {\n            return token;\n        }\n\n        if (token === 'paragraph') {\n            return 'paragraph';\n        }\n\n        return normalizeButtonName(token);\n    }\n\n    if (!raw || typeof raw !== 'object') {\n        return null;\n    }\n\n    const record = raw as Record<string, unknown>;\n\n    if (record.type === 'separator') {\n        return { type: 'separator' };\n    }\n\n    if (record.type === 'item' && typeof record.name === 'string') {\n        if (record.name === 'paragraph') {\n            return 'paragraph';\n        }\n\n        return normalizeButtonName(record.name);\n    }\n\n    return null;\n}\n\nfunction normalizeGroupItemDefinitions(raw: unknown[]): ToolbarGroupItemDefinition[] {\n    return raw\n        .map((item) => normalizeGroupItemDefinition(item))\n        .filter((item): item is ToolbarGroupItemDefinition => item !== null);\n}\n\nfunction isGroupItemSeparator(item: ToolbarGroupItemDefinition): boolean {\n    return item === '|' || item === 'separator' || (typeof item === 'object' && item.type === 'separator');\n}\n\nfunction isToolbarGroupMenuButton(item: ToolbarGroupItemDefinition): item is ToolbarGroupMenuButton {\n    return !isGroupItemSeparator(item);\n}\n\nfunction groupItemDefinitionsToMenuEntries(items: ToolbarGroupItemDefinition[]): ToolbarGroupMenuEntry[] {\n    return items.flatMap((item) => {\n        if (isGroupItemSeparator(item)) {\n            return [{ type: 'separator' as const }];\n        }\n\n        if (!isToolbarGroupMenuButton(item)) {\n            return [];\n        }\n\n        return [{ type: 'item' as const, name: item }];\n    });\n}\n\nfunction getToolbarGroupMenuButtons(group: ToolbarGroup): ToolbarGroupMenuButton[] {\n    return getToolbarGroupMenuItems(group)\n        .filter((entry): entry is { type: 'item'; name: ToolbarGroupMenuButton } => entry.type === 'item')\n        .map((entry) => entry.name);\n}\n\nfunction normalizeButtonName(value: string): TiptapButtonName | null {\n    return isTiptapButtonName(value) ? value : null;\n}\n\nfunction normalizeHeadingLevels(value: unknown): ToolbarHeadingLevel[] | undefined {\n    if (!Array.isArray(value)) {\n        return undefined;\n    }\n\n    const levels = value\n        .map((level) => Number(level))\n        .filter((level): level is ToolbarHeadingLevel => [1, 2, 3, 4, 5, 6].includes(level));\n\n    return levels.length > 0 ? levels : undefined;\n}\n\nfunction normalizeToolbarGroup(raw: Record<string, unknown>): ToolbarGroupNode | null {\n    const source = typeof raw.group === 'object' && raw.group !== null\n        ? raw.group as Record<string, unknown>\n        : raw;\n\n    const preset = typeof source.preset === 'string' ? source.preset : undefined;\n    const label = typeof source.label === 'string' ? source.label : undefined;\n    const iconRaw = typeof source.icon === 'string' ? source.icon : undefined;\n    const icon = iconRaw ? normalizeButtonName(iconRaw) ?? undefined : undefined;\n    const headingLevels = normalizeHeadingLevels(source.headingLevels);\n\n    const items = Array.isArray(source.items)\n        ? normalizeGroupItemDefinitions(source.items)\n        : undefined;\n\n    if (!preset && !items?.length) {\n        return null;\n    }\n\n    if (preset && !VALID_PRESETS.has(preset)) {\n        return null;\n    }\n\n    return {\n        type: 'group',\n        group: {\n            ...(label ? { label } : {}),\n            ...(icon ? { icon } : {}),\n            ...(preset ? { preset: preset as ToolbarGroupPreset } : {}),\n            ...(items?.length ? { items } : {}),\n            ...(headingLevels ? { headingLevels } : {}),\n        },\n    };\n}\n\nfunction normalizeToolbarNode(raw: unknown): ToolbarNode | null {\n    if (typeof raw === 'string') {\n        const token = raw.trim();\n\n        if (!token) {\n            return null;\n        }\n\n        if (isToolbarSeparatorToken(token)) {\n            return { type: 'separator' };\n        }\n\n        const buttonName = normalizeButtonName(token);\n\n        return buttonName ? { type: 'button', name: buttonName } : null;\n    }\n\n    if (!raw || typeof raw !== 'object') {\n        return null;\n    }\n\n    const record = raw as Record<string, unknown>;\n\n    if (record.type === 'separator') {\n        return { type: 'separator' };\n    }\n\n    if (record.type === 'button' && typeof record.name === 'string') {\n        const buttonName = normalizeButtonName(record.name);\n        return buttonName ? { type: 'button', name: buttonName } : null;\n    }\n\n    if (record.type === 'group' || record.preset || record.items || record.group) {\n        return normalizeToolbarGroup(record);\n    }\n\n    if (typeof record.button === 'string') {\n        const buttonName = normalizeButtonName(record.button);\n        return buttonName ? { type: 'button', name: buttonName } : null;\n    }\n\n    return null;\n}\n\nexport function normalizeToolbarNodes(raw: unknown[]): ToolbarNode[] {\n    return raw\n        .map((item) => normalizeToolbarNode(item))\n        .filter((item): item is ToolbarNode => item !== null);\n}\n\nexport function parseToolbarConfig(input: unknown): ToolbarNode[] {\n    if (input === null || input === undefined || input === '') {\n        return [\n            { type: 'button', name: 'bold' },\n            { type: 'button', name: 'italic' },\n        ];\n    }\n\n    if (Array.isArray(input)) {\n        const normalized = normalizeToolbarNodes(input);\n        return normalized.length > 0 ? normalized : [\n            { type: 'button', name: 'bold' },\n            { type: 'button', name: 'italic' },\n        ];\n    }\n\n    if (typeof input === 'string') {\n        const trimmed = input.trim();\n\n        if (!trimmed) {\n            return [\n                { type: 'button', name: 'bold' },\n                { type: 'button', name: 'italic' },\n            ];\n        }\n\n        if (trimmed.startsWith('[')) {\n            try {\n                const parsed = JSON.parse(trimmed) as unknown;\n                return Array.isArray(parsed) ? parseToolbarConfig(parsed) : parseToolbarConfig(null);\n            } catch {\n                return parseToolbarConfig(null);\n            }\n        }\n\n        return parseToolbarConfig(\n            trimmed\n                .split(',')\n                .map((token) => token.trim())\n                .filter(Boolean),\n        );\n    }\n\n    return parseToolbarConfig(null);\n}\n\nexport function runToolbarButton(\n    editor: Editor,\n    buttonName: string,\n    options: RunTiptapButtonOptions = {},\n): boolean {\n    if (buttonName === 'paragraph') {\n        return editor.chain().focus().setParagraph().run();\n    }\n\n    return runTiptapButton(editor, buttonName, options);\n}\n\nexport function isToolbarButtonActive(editor: Editor, buttonName: string): boolean {\n    if (buttonName === 'paragraph') {\n        return editor.isActive('paragraph') && !editor.isActive('heading');\n    }\n\n    return isTiptapButtonActive(editor, buttonName);\n}\n\nfunction getActiveHeadingLevel(editor: Editor): ToolbarHeadingLevel | null {\n    for (const level of [1, 2, 3, 4, 5, 6] as const) {\n        if (editor.isActive('heading', { level })) {\n            return level;\n        }\n    }\n\n    return null;\n}\n\nexport function getToolbarGroupTriggerState(\n    editor: Editor,\n    group: ToolbarGroup,\n): ToolbarGroupTriggerState {\n    const fallbackIcon = group.icon ?? getToolbarGroupDefaultIcon(group);\n    const menuButtons = getToolbarGroupMenuButtons(group);\n\n    if (isHeadingsOnlyToolbarPreset(group.preset)) {\n        const activeLevel = getActiveHeadingLevel(editor);\n\n        if (activeLevel) {\n            const name = `h${activeLevel}` as TiptapButtonName;\n            return {\n                activeName: name,\n                label: `H${activeLevel}`,\n                isActive: true,\n                icon: name,\n            };\n        }\n\n        return {\n            activeName: null,\n            label: '',\n            isActive: false,\n            icon: 'heading',\n        };\n    }\n\n    if (isFormattingToolbarPreset(group.preset)) {\n        const activeLevel = getActiveHeadingLevel(editor);\n\n        if (activeLevel) {\n            const name = `h${activeLevel}` as TiptapButtonName;\n            return {\n                activeName: name,\n                label: `H${activeLevel}`,\n                isActive: true,\n                icon: name,\n            };\n        }\n\n        if (isToolbarButtonActive(editor, 'blockquote')) {\n            return {\n                activeName: 'blockquote',\n                label: '',\n                isActive: true,\n                icon: 'blockquote',\n            };\n        }\n\n        if (isToolbarButtonActive(editor, 'code-block')) {\n            return {\n                activeName: 'code-block',\n                label: '',\n                isActive: true,\n                icon: 'code-block',\n            };\n        }\n\n        return {\n            activeName: 'paragraph',\n            label: 'Text',\n            isActive: isToolbarButtonActive(editor, 'paragraph'),\n            icon: 'paragraph',\n        };\n    }\n\n    const activeName = menuButtons.find((name) => isToolbarButtonActive(editor, name)) ?? null;\n\n    if (activeName) {\n        const icon = activeName === 'paragraph'\n            ? 'paragraph'\n            : (isTiptapButtonName(activeName) ? activeName : fallbackIcon);\n\n        return {\n            activeName: activeName === 'paragraph' ? 'paragraph' : activeName,\n            label: activeName === 'paragraph' ? 'Text' : (group.label ?? activeName),\n            isActive: true,\n            icon,\n        };\n    }\n\n    return {\n        activeName: null,\n        label: group.label ?? '',\n        isActive: false,\n        icon: fallbackIcon,\n    };\n}\n\nfunction getFormattingHeadingLevels(group: ToolbarGroup): ToolbarHeadingLevel[] {\n    return group.headingLevels ?? DEFAULT_HEADING_LEVELS;\n}\n\nfunction getFormattingMenuEntries(group: ToolbarGroup): ToolbarGroupMenuEntry[] {\n    const headings = getFormattingHeadingLevels(group).map((level) => ({\n        type: 'item' as const,\n        name: `h${level}` as TiptapButtonName,\n    }));\n\n    return [\n        { type: 'item', name: 'paragraph' },\n        { type: 'separator' },\n        ...headings,\n        { type: 'separator' },\n        { type: 'item', name: 'blockquote' },\n        { type: 'item', name: 'code-block' },\n    ];\n}\n\nexport function getToolbarGroupMenuItems(group: ToolbarGroup): ToolbarGroupMenuEntry[] {\n    if (group.items?.length) {\n        return groupItemDefinitionsToMenuEntries(group.items);\n    }\n\n    if (isFormattingToolbarPreset(group.preset)) {\n        return getFormattingMenuEntries(group);\n    }\n\n    return getToolbarGroupItems(group).map((name) => ({ type: 'item', name }));\n}\n"],"mappings":"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"}

package/dist/types/variable-option.d.ts

@@ -0,0 +1,10 @@
+export type VariableOption = {
+    label: string;
+    value: string;
+    children?: VariableOption[];
+    /** For child items: selector | format | value. */
+    type?: string;
+    [key: string]: unknown;
+};
+export type VariableCategories = Record<string, VariableOption[]>;
+//# sourceMappingURL=variable-option.d.ts.map

package/dist/types/variable-option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-option.d.ts","sourceRoot":"","sources":["../../src/types/variable-option.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAC5B,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,99 @@
+{
+    "name": "@verbb/plugin-kit-tiptap-core",
+    "version": "2.0.0",
+    "type": "module",
+    "main": "dist/index.js",
+    "module": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "CHANGELOG.md",
+        "LICENSE.md"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/verbb/plugin-kit.git",
+        "directory": "plugin-kit-tiptap-core"
+    },
+    "bugs": {
+        "url": "https://github.com/verbb/plugin-kit/issues"
+    },
+    "homepage": "https://docs.verbb.io/plugin-kit",
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js"
+        },
+        "./serialization/editor": {
+            "types": "./dist/serialization/editor.d.ts",
+            "import": "./dist/serialization/editor.js"
+        },
+        "./serialization/input": {
+            "types": "./dist/serialization/input.d.ts",
+            "import": "./dist/serialization/input.js"
+        },
+        "./links": {
+            "types": "./dist/links/index.d.ts",
+            "import": "./dist/links/index.js"
+        },
+        "./extensions": {
+            "types": "./dist/extensions/index.d.ts",
+            "import": "./dist/extensions/index.js"
+        },
+        "./toolbar": {
+            "types": "./dist/toolbar/index.d.ts",
+            "import": "./dist/toolbar/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "scripts": {
+        "build": "vite build",
+        "dev": "vite build --watch",
+        "test": "vitest run"
+    },
+    "license": "MIT",
+    "dependencies": {
+        "@tiptap/core": "^3.22.4",
+        "@tiptap/extension-blockquote": "^3.22.4",
+        "@tiptap/extension-bold": "^3.22.4",
+        "@tiptap/extension-bullet-list": "^3.22.4",
+        "@tiptap/extension-code": "^3.22.4",
+        "@tiptap/extension-code-block": "^3.22.4",
+        "@tiptap/extension-document": "^3.22.4",
+        "@tiptap/extension-dropcursor": "^3.22.4",
+        "@tiptap/extension-gapcursor": "^3.22.4",
+        "@tiptap/extension-hard-break": "^3.22.4",
+        "@tiptap/extension-heading": "^3.22.4",
+        "@tiptap/extension-highlight": "^3.22.4",
+        "@tiptap/extension-history": "^3.22.4",
+        "@tiptap/extension-horizontal-rule": "^3.22.4",
+        "@tiptap/extension-italic": "^3.22.4",
+        "@tiptap/extension-link": "^3.22.4",
+        "@tiptap/extension-list-item": "^3.22.4",
+        "@tiptap/extension-ordered-list": "^3.22.4",
+        "@tiptap/extension-paragraph": "^3.22.4",
+        "@tiptap/extension-strike": "^3.22.4",
+        "@tiptap/extension-subscript": "^3.22.4",
+        "@tiptap/extension-superscript": "^3.22.4",
+        "@tiptap/extension-table": "^3.22.4",
+        "@tiptap/extension-table-cell": "^3.22.4",
+        "@tiptap/extension-table-header": "^3.22.4",
+        "@tiptap/extension-table-row": "^3.22.4",
+        "@tiptap/extension-text": "^3.22.4",
+        "@tiptap/extension-text-align": "^3.22.4",
+        "@tiptap/extension-underline": "^3.22.4",
+        "@tiptap/pm": "^3.22.4"
+    },
+    "devDependencies": {
+        "typescript": "^6.0.3",
+        "vite": "^8.0.10",
+        "vite-plugin-dts": "^4.5.4",
+        "vitest": "^4.1.5"
+    }
+}