@ecsplico/editor 2.1.2 → 3.0.0

package/dist/core/index.d.ts

@@ -1,28 +1,33 @@
-import { MenuItem, ToolbarGroup, ToolbarItem, commandItem, mergeToolbarGroups } from "./toolbar.js";
-import { AbilitiesOptions, BlockAction, BlockActionContext, BlockTarget, SlashCommandItem } from "./extension-points.js";
-import { Abilities, AbilitiesStorage, DEFAULT_ABILITY_RULES, abilitiesAt, abilitiesAtSelection, hasAbility } from "./abilities.js";
-import { CORE_TARGET_IDS, ConvertTarget, Converter, ForeignBlocks, TextblockSpec, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
+import { ReadonlyStore, Store, createStore, derived } from "./store.js";
 import { CATALOGS, DEFAULT_LOCALE, LOCALES, Locale, MessageKey, MessageParams, Messages, Translate, createTranslator, isLocale } from "../i18n/index.js";
+import { BackendCapability } from "./backend-capability.js";
+import { AiStreamEvent, BackendCommentsOptions, BackendError, CollaborationToken, EditorBackend } from "./backend.js";
 import { Notice, Notifier, silentNotifier } from "./notify.js";
-import { ReadonlyStore, Store, createStore, derived } from "./store.js";
 import { EditorAiConfig, EditorContext, EditorContextOptions, createEditorContext } from "./context.js";
+import { CORE_TARGET_IDS, ConvertTarget, Converter, ForeignBlocks, TextblockSpec, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
+import { CommandBase, CommandDef, CommandState, Creates, InsertGuard, MenuItem, PlacedToolbarGroup, ToolbarGroupDef } from "./command-types.js";
+import { AbilitiesOptions, BlockAction, BlockActionContext, BlockTarget } from "./extension-points.js";
 import { EditorEntry, EditorUi, editorEntryOf, notifierOf, registerEditor } from "./editor-ui.js";
 import { EditorMetadata, METADATA_LIST, MetadataItem, MetadataQuery, MetadataSource } from "./metadata-types.js";
 import { Metadata, MetadataRegistry, createMetadataRegistry, filterMetadataItems, metadataOf } from "./metadata.js";
-import { AiBlock, AiBlockDataProvider, AiBlockDataRequest, AiBlockDatum, AiContext, AiContextKind, AnchorResolver, AuthorIdentity, BlockPipeline, CollaborationSession, ConversionProvider, EditorFeature, EditorPreset, FeatureContext, SINGLETON_PIPELINE_HOOKS, SettingsTab, UploadFn } from "./feature.js";
+import { AiBlock, AiBlockDataProvider, AiBlockDataRequest, AiBlockDatum, AiContext, AiContextKind, AnchorResolver, AuthorIdentity, BlockPipeline, CollaborationSession, ConversionProvider, Dimension, EditorFeature, EditorPreset, FeatureContext, SINGLETON_PIPELINE_HOOKS, SettingsTab } from "./feature.js";
+import { Abilities, AbilitiesStorage, DEFAULT_ABILITY_RULES, abilitiesAt, abilitiesAtSelection, hasAbility } from "./abilities.js";
 import { BlockConvert, blockConversion, conversionLabel, conversionTargetGroups, convertMenuItems, coreConversions, parseConversionTarget, targetOwner } from "./block-convert.js";
 import { startBlockDrag } from "./block-drag.js";
 import { BlockFlash } from "./block-flash.js";
-import { coreBlockActions, coreFeature } from "./core-feature.js";
+import { CoreUi, coreBlockActions, coreContentFeature, coreUiFeature } from "./core-feature.js";
+import { canCreateAt, command, commandState, commandsOf, guardsAccept, toolbarOf } from "./commands.js";
 import { contributions, defineEditor, settingsTabsOf } from "./define-editor.js";
 import { DocumentMarkdown } from "./document-markdown.js";
 import { downloadText } from "./download.js";
 import { DocAnchor, DocAnchors, DocAnchorsMeta, DocAnchorsOptions, anchorResolverOf, captureRange, docAnchorsKey, releaseRanges, resolveRange } from "./doc-anchors.js";
 import { FeatureContextOptions, blockActionsOf, createFeatureContext } from "./feature-context.js";
 import { fetchErrorMessage } from "./fetch-error.js";
+import { sha256Hex } from "./hash.js";
+import { PALETTE_OTHER_GROUP, PaletteEntry, PaletteGroup, filterPalette, paletteGroupsOf } from "./palette.js";
 import { DEFAULT_BLOCK_PIPELINE, PresetStorage, aiBlockDataOf, aiContextOf, conversionsOf, formatAiResultOf, parseBlocks, pipelineOf, presetExtension, structureBlocks, wrapImportBlocks } from "./pipeline.js";
 import { selectionRange } from "./selection-range.js";
 import { SlashCommand, SlashCommandOptions, SlashCommandPluginKey } from "./slash.js";
 import { SuggestionDisplay, SuggestionListProps, SuggestionPopup, SuggestionPopupHandle, SuggestionPopupRenderer, createSuggestionRender, suggestionPopupOf } from "./suggestion-popup.js";
-import { coreToolbarGroups } from "./toolbar-items.js";
-export { Abilities, type AbilitiesOptions, type AbilitiesStorage, type AiBlock, type AiBlockDataProvider, type AiBlockDataRequest, type AiBlockDatum, type AiContext, type AiContextKind, type AnchorResolver, type AuthorIdentity, type BlockAction, type BlockActionContext, BlockConvert, BlockFlash, type BlockPipeline, type BlockTarget, CATALOGS, CORE_TARGET_IDS, type CollaborationSession, type ConversionProvider, type ConvertTarget, type Converter, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, type DocAnchor, DocAnchors, type DocAnchorsMeta, type DocAnchorsOptions, DocumentMarkdown, type EditorAiConfig, type EditorContext, type EditorContextOptions, type EditorEntry, type EditorFeature, type EditorMetadata, type EditorPreset, type EditorUi, type FeatureContext, type FeatureContextOptions, type ForeignBlocks, LOCALES, type Locale, METADATA_LIST, type MenuItem, type MessageKey, type MessageParams, type Messages, Metadata, type MetadataItem, type MetadataQuery, type MetadataRegistry, type MetadataSource, type Notice, type Notifier, type PresetStorage, type ReadonlyStore, SINGLETON_PIPELINE_HOOKS, type SettingsTab, SlashCommand, type SlashCommandItem, type SlashCommandOptions, SlashCommandPluginKey, type Store, type SuggestionDisplay, type SuggestionListProps, SuggestionPopup, type SuggestionPopupHandle, type SuggestionPopupRenderer, type TextblockSpec, type ToolbarGroup, type ToolbarItem, type Translate, type UploadFn, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, captureRange, childrenOf, commandItem, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreConversionTargets, coreConversions, coreFeature, coreToolbarGroups, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, finishConversion, formatAiResultOf, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, mergeToolbarGroups, metadataOf, notifierOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, wrapImportBlocks };
+import { CORE_TOOLBAR_GROUPS, coreCommands } from "./toolbar-items.js";
+export { Abilities, type AbilitiesOptions, type AbilitiesStorage, type AiBlock, type AiBlockDataProvider, type AiBlockDataRequest, type AiBlockDatum, type AiContext, type AiContextKind, type AiStreamEvent, type AnchorResolver, type AuthorIdentity, type BackendCapability, type BackendCommentsOptions, BackendError, type BlockAction, type BlockActionContext, BlockConvert, BlockFlash, type BlockPipeline, type BlockTarget, CATALOGS, CORE_TARGET_IDS, CORE_TOOLBAR_GROUPS, type CollaborationSession, type CollaborationToken, type CommandBase, type CommandDef, type CommandState, type ConversionProvider, type ConvertTarget, type Converter, type CoreUi, type Creates, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, type Dimension, type DocAnchor, DocAnchors, type DocAnchorsMeta, type DocAnchorsOptions, DocumentMarkdown, type EditorAiConfig, type EditorBackend, type EditorContext, type EditorContextOptions, type EditorEntry, type EditorFeature, type EditorMetadata, type EditorPreset, type EditorUi, type FeatureContext, type FeatureContextOptions, type ForeignBlocks, type InsertGuard, LOCALES, type Locale, METADATA_LIST, type MenuItem, type MessageKey, type MessageParams, type Messages, Metadata, type MetadataItem, type MetadataQuery, type MetadataRegistry, type MetadataSource, type Notice, type Notifier, PALETTE_OTHER_GROUP, type PaletteEntry, type PaletteGroup, type PlacedToolbarGroup, type PresetStorage, type ReadonlyStore, SINGLETON_PIPELINE_HOOKS, type SettingsTab, SlashCommand, type SlashCommandOptions, SlashCommandPluginKey, type Store, type SuggestionDisplay, type SuggestionListProps, SuggestionPopup, type SuggestionPopupHandle, type SuggestionPopupRenderer, type TextblockSpec, type ToolbarGroupDef, type Translate, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, canCreateAt, captureRange, childrenOf, command, commandState, commandsOf, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreCommands, coreContentFeature, coreConversionTargets, coreConversions, coreUiFeature, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, filterPalette, finishConversion, formatAiResultOf, guardsAccept, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, metadataOf, notifierOf, paletteGroupsOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, sha256Hex, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, toolbarOf, wrapImportBlocks };

package/dist/core/index.js

@@ -1,27 +1,30 @@
 import { Abilities, DEFAULT_ABILITY_RULES, abilitiesAt, abilitiesAtSelection, hasAbility } from "./abilities.js";
-import { CORE_TARGET_IDS, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
+import { SINGLETON_PIPELINE_HOOKS } from "./feature.js";
 import { DEFAULT_BLOCK_PIPELINE, aiBlockDataOf, aiContextOf, conversionsOf, formatAiResultOf, parseBlocks, pipelineOf, presetExtension, structureBlocks, wrapImportBlocks } from "./pipeline.js";
+import { contributions, defineEditor, settingsTabsOf } from "./define-editor.js";
+import { Metadata, createMetadataRegistry, filterMetadataItems, metadataOf } from "./metadata.js";
+import { editorEntryOf, notifierOf, registerEditor } from "./editor-ui.js";
+import { canCreateAt, command, commandState, commandsOf, guardsAccept, toolbarOf } from "./commands.js";
+import { CORE_TARGET_IDS, childrenOf, convertCoreBlocks, convertTargetId, coreConversionTargets, createConverter, finishConversion, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isQuoteNode, isTextblockNode, isWrapperBlock, parseCoreTarget, textblockSpecOf } from "./convert.js";
 import { BlockConvert, blockConversion, conversionLabel, conversionTargetGroups, convertMenuItems, coreConversions, parseConversionTarget, targetOwner } from "./block-convert.js";
 import { startBlockDrag } from "./block-drag.js";
 import { BlockFlash } from "./block-flash.js";
+import { BackendError } from "./backend.js";
 import { CATALOGS, DEFAULT_LOCALE, LOCALES, createTranslator, isLocale } from "../i18n/index.js";
 import { silentNotifier } from "./notify.js";
 import { createStore, derived } from "./store.js";
 import { createEditorContext } from "./context.js";
 import { DocAnchors, anchorResolverOf, captureRange, docAnchorsKey, releaseRanges, resolveRange } from "./doc-anchors.js";
 import { DocumentMarkdown } from "./document-markdown.js";
-import { Metadata, createMetadataRegistry, filterMetadataItems, metadataOf } from "./metadata.js";
 import { SuggestionPopup, createSuggestionRender, suggestionPopupOf } from "./suggestion-popup.js";
 import { SlashCommand, SlashCommandPluginKey } from "./slash.js";
-import { commandItem, mergeToolbarGroups } from "./toolbar.js";
-import { coreToolbarGroups } from "./toolbar-items.js";
-import { coreBlockActions, coreFeature } from "./core-feature.js";
-import { SINGLETON_PIPELINE_HOOKS } from "./feature.js";
-import { contributions, defineEditor, settingsTabsOf } from "./define-editor.js";
+import { CORE_TOOLBAR_GROUPS, coreCommands } from "./toolbar-items.js";
+import { coreBlockActions, coreContentFeature, coreUiFeature } from "./core-feature.js";
 import { downloadText } from "./download.js";
-import { editorEntryOf, notifierOf, registerEditor } from "./editor-ui.js";
 import { blockActionsOf, createFeatureContext } from "./feature-context.js";
 import { fetchErrorMessage } from "./fetch-error.js";
+import { sha256Hex } from "./hash.js";
 import { METADATA_LIST } from "./metadata-types.js";
+import { PALETTE_OTHER_GROUP, filterPalette, paletteGroupsOf } from "./palette.js";
 import { selectionRange } from "./selection-range.js";
-export { Abilities, BlockConvert, BlockFlash, CATALOGS, CORE_TARGET_IDS, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, DocAnchors, DocumentMarkdown, LOCALES, METADATA_LIST, Metadata, SINGLETON_PIPELINE_HOOKS, SlashCommand, SlashCommandPluginKey, SuggestionPopup, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, captureRange, childrenOf, commandItem, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreConversionTargets, coreConversions, coreFeature, coreToolbarGroups, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, finishConversion, formatAiResultOf, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, mergeToolbarGroups, metadataOf, notifierOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, wrapImportBlocks };
+export { Abilities, BackendError, BlockConvert, BlockFlash, CATALOGS, CORE_TARGET_IDS, CORE_TOOLBAR_GROUPS, DEFAULT_ABILITY_RULES, DEFAULT_BLOCK_PIPELINE, DEFAULT_LOCALE, DocAnchors, DocumentMarkdown, LOCALES, METADATA_LIST, Metadata, PALETTE_OTHER_GROUP, SINGLETON_PIPELINE_HOOKS, SlashCommand, SlashCommandPluginKey, SuggestionPopup, abilitiesAt, abilitiesAtSelection, aiBlockDataOf, aiContextOf, anchorResolverOf, blockActionsOf, blockConversion, canCreateAt, captureRange, childrenOf, command, commandState, commandsOf, contributions, conversionLabel, conversionTargetGroups, conversionsOf, convertCoreBlocks, convertMenuItems, convertTargetId, coreBlockActions, coreCommands, coreContentFeature, coreConversionTargets, coreConversions, coreUiFeature, createConverter, createEditorContext, createFeatureContext, createMetadataRegistry, createStore, createSuggestionRender, createTranslator, defineEditor, derived, docAnchorsKey, downloadText, editorEntryOf, fetchErrorMessage, filterMetadataItems, filterPalette, finishConversion, formatAiResultOf, guardsAccept, hasAbility, isCoreSource, isCoreTarget, isCurrentTarget, isListNode, isLocale, isQuoteNode, isTextblockNode, isWrapperBlock, metadataOf, notifierOf, paletteGroupsOf, parseBlocks, parseConversionTarget, parseCoreTarget, pipelineOf, presetExtension, registerEditor, releaseRanges, resolveRange, selectionRange, settingsTabsOf, sha256Hex, silentNotifier, startBlockDrag, structureBlocks, suggestionPopupOf, targetOwner, textblockSpecOf, toolbarOf, wrapImportBlocks };

package/dist/core/palette.d.ts

@@ -0,0 +1,48 @@
+import { EditorEntry } from "./editor-ui.js";
+import { Editor } from "@tiptap/core";
+//#region src/core/palette.d.ts
+/** One row of the palette: a command (leaf, `run`) or a menu command with its menu rows as `children` (the second level). */
+export interface PaletteEntry {
+  /** The command id; a row of a menu command is `<command id>:<index>`. */
+  id: string;
+  /** Already translated. */
+  label: string;
+  /** Iconify name, e.g. `i-lucide-table`; empty when the row has none. */
+  icon: string;
+  /** Shortcut keys, e.g. `['meta', 'b']`. */
+  kbds?: string[];
+  description?: string;
+  /** `commandState(...).enabled === false` (a menu command without an enabled row is disabled too). */
+  disabled: boolean;
+  /** The command is on at the selection (toggle style). */
+  active: boolean;
+  /** Runs the command; absent on a row that opens a second level. */
+  run?: () => void;
+  /** The rows of a menu command; selecting the entry opens them. */
+  children?: PaletteEntry[];
+}
+/** The entries of one toolbar group, in the group's order; commands without a toolbar group are the last group (`other`). */
+export interface PaletteGroup {
+  id: string;
+  /** Already translated. */
+  label: string;
+  entries: PaletteEntry[];
+}
+/** The id and heading key of the group that holds the commands without a toolbar group. */
+export declare const PALETTE_OTHER_GROUP = "other";
+/**
+ * The palette of `editor`: every command of its surface (the features' commands after the host's `commands` transformer)
+ * that is listed (`palette !== false`, never a `component` command) and visible, grouped by toolbar group in the
+ * toolbar's order, the ungrouped commands last. Each entry's state is `commandState(editor, cmd, 'selection')`; menu
+ * commands carry the rows of their menu as a second level. Evaluated at call time: build it when the palette opens.
+ * `editor` is the raw instance the surface registered.
+ */
+export declare function paletteGroupsOf(editor: Editor, entry: Pick<EditorEntry, 'preset' | 'ctx'>): PaletteGroup[];
+/**
+ * The groups with only the entries matching `query`: case-insensitive, `query` is a prefix or any substring of the
+ * entry's label or command id; entries that start with it come first. Empty groups drop out; a blank query keeps
+ * everything. Only the first level is filtered (a menu command's rows are the framework search's job).
+ */
+export declare function filterPalette(groups: readonly PaletteGroup[], query: string): PaletteGroup[];
+//#endregion
+//# sourceMappingURL=palette.d.ts.map

package/dist/core/palette.js

@@ -0,0 +1,95 @@
+import { commandState, placeInGroups, toolbarGroupsOf } from "./commands.js";
+//#region src/core/palette.ts
+/** The id and heading key of the group that holds the commands without a toolbar group. */
+const PALETTE_OTHER_GROUP = "other";
+function entryOf(editor, cmd, state) {
+	if ("component" in cmd) return void 0;
+	const base = {
+		id: cmd.id,
+		label: cmd.label,
+		icon: cmd.icon,
+		...cmd.kbds && { kbds: cmd.kbds },
+		active: state.active
+	};
+	if ("run" in cmd) return {
+		...base,
+		disabled: !state.enabled,
+		run: () => cmd.run(editor)
+	};
+	const children = cmd.menu(editor).flatMap((item, index) => {
+		if (item.type || item.label === void 0) return [];
+		return [{
+			id: `${cmd.id}:${index}`,
+			label: item.label,
+			icon: item.icon ?? "",
+			...item.description !== void 0 && { description: item.description },
+			disabled: !!item.disabled,
+			active: false,
+			...item.onSelect && { run: item.onSelect }
+		}];
+	});
+	return {
+		...base,
+		disabled: !state.enabled || !children.some((child) => !child.disabled),
+		children
+	};
+}
+/**
+* The palette of `editor`: every command of its surface (the features' commands after the host's `commands` transformer)
+* that is listed (`palette !== false`, never a `component` command) and visible, grouped by toolbar group in the
+* toolbar's order, the ungrouped commands last. Each entry's state is `commandState(editor, cmd, 'selection')`; menu
+* commands carry the rows of their menu as a second level. Evaluated at call time: build it when the palette opens.
+* `editor` is the raw instance the surface registered.
+*/
+function paletteGroupsOf(editor, entry) {
+	const { preset, ctx } = entry;
+	const rows = /* @__PURE__ */ new Map();
+	for (const cmd of ctx.commands()) {
+		if (cmd.palette === false) continue;
+		const state = commandState(editor, cmd, "selection");
+		if (!state.visible) continue;
+		const row = entryOf(editor, cmd, state);
+		if (row) rows.set(cmd, row);
+	}
+	const other = [];
+	const groups = placeInGroups(toolbarGroupsOf(preset), [...rows.keys()], (cmd) => other.push(rows.get(cmd))).filter((group) => group.items.length > 0 && (!group.visible || group.visible(editor))).map((group) => ({
+		id: group.id,
+		label: group.labelKey ? ctx.t(group.labelKey) : group.id,
+		entries: group.items.map((cmd) => rows.get(cmd))
+	}));
+	if (other.length) groups.push({
+		id: PALETTE_OTHER_GROUP,
+		label: ctx.t("palette.group.other"),
+		entries: other
+	});
+	return groups;
+}
+/**
+* The groups with only the entries matching `query`: case-insensitive, `query` is a prefix or any substring of the
+* entry's label or command id; entries that start with it come first. Empty groups drop out; a blank query keeps
+* everything. Only the first level is filtered (a menu command's rows are the framework search's job).
+*/
+function filterPalette(groups, query) {
+	const needle = query.trim().toLowerCase();
+	if (!needle) return [...groups];
+	const rank = (entry) => {
+		const label = entry.label.toLowerCase();
+		const id = entry.id.toLowerCase();
+		if (label.startsWith(needle) || id.startsWith(needle)) return 0;
+		return label.includes(needle) || id.includes(needle) ? 1 : void 0;
+	};
+	return groups.flatMap((group) => {
+		const entries = group.entries.flatMap((entry) => rank(entry) === void 0 ? [] : [{
+			entry,
+			rank: rank(entry)
+		}]).sort((a, b) => a.rank - b.rank).map((item) => item.entry);
+		return entries.length ? [{
+			...group,
+			entries
+		}] : [];
+	});
+}
+//#endregion
+export { PALETTE_OTHER_GROUP, filterPalette, paletteGroupsOf };
+
+//# sourceMappingURL=palette.js.map

package/dist/core/palette.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"palette.js","names":[],"sources":["../../src/core/palette.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { type CommandDef, commandState, placeInGroups, toolbarGroupsOf } from './commands'\nimport type { EditorEntry } from './editor-ui'\n\n// The ⌘K palette's model, framework-free: the framework layers (`vue/components/EditorCommandPalette.vue`,\n// `react/EditorCommandPalette.tsx`) render `PaletteGroup`s and own nothing but the dialog and the search box.\n\n/** One row of the palette: a command (leaf, `run`) or a menu command with its menu rows as `children` (the second level). */\nexport interface PaletteEntry {\n  /** The command id; a row of a menu command is `<command id>:<index>`. */\n  id: string\n  /** Already translated. */\n  label: string\n  /** Iconify name, e.g. `i-lucide-table`; empty when the row has none. */\n  icon: string\n  /** Shortcut keys, e.g. `['meta', 'b']`. */\n  kbds?: string[]\n  description?: string\n  /** `commandState(...).enabled === false` (a menu command without an enabled row is disabled too). */\n  disabled: boolean\n  /** The command is on at the selection (toggle style). */\n  active: boolean\n  /** Runs the command; absent on a row that opens a second level. */\n  run?: () => void\n  /** The rows of a menu command; selecting the entry opens them. */\n  children?: PaletteEntry[]\n}\n\n/** The entries of one toolbar group, in the group's order; commands without a toolbar group are the last group (`other`). */\nexport interface PaletteGroup {\n  id: string\n  /** Already translated. */\n  label: string\n  entries: PaletteEntry[]\n}\n\n/** The id and heading key of the group that holds the commands without a toolbar group. */\nexport const PALETTE_OTHER_GROUP = 'other'\n\nfunction entryOf(editor: Editor, cmd: CommandDef, state: { enabled: boolean, active: boolean }): PaletteEntry | undefined {\n  if ('component' in cmd) return undefined\n  const base = { id: cmd.id, label: cmd.label, icon: cmd.icon, ...(cmd.kbds && { kbds: cmd.kbds }), active: state.active }\n  if ('run' in cmd) return { ...base, disabled: !state.enabled, run: () => cmd.run(editor) }\n  const children = cmd.menu(editor).flatMap((item, index): PaletteEntry[] => {\n    if (item.type || item.label === undefined) return []\n    return [{\n      id: `${cmd.id}:${index}`,\n      label: item.label,\n      icon: item.icon ?? '',\n      ...(item.description !== undefined && { description: item.description }),\n      disabled: !!item.disabled,\n      active: false,\n      ...(item.onSelect && { run: item.onSelect }),\n    }]\n  })\n  return { ...base, disabled: !state.enabled || !children.some(child => !child.disabled), children }\n}\n\n/**\n * The palette of `editor`: every command of its surface (the features' commands after the host's `commands` transformer)\n * that is listed (`palette !== false`, never a `component` command) and visible, grouped by toolbar group in the\n * toolbar's order, the ungrouped commands last. Each entry's state is `commandState(editor, cmd, 'selection')`; menu\n * commands carry the rows of their menu as a second level. Evaluated at call time: build it when the palette opens.\n * `editor` is the raw instance the surface registered.\n */\nexport function paletteGroupsOf(editor: Editor, entry: Pick<EditorEntry, 'preset' | 'ctx'>): PaletteGroup[] {\n  const { preset, ctx } = entry\n  const rows = new Map<CommandDef, PaletteEntry>()\n  for (const cmd of ctx.commands()) {\n    if (cmd.palette === false) continue\n    const state = commandState(editor, cmd, 'selection')\n    if (!state.visible) continue\n    const row = entryOf(editor, cmd, state)\n    if (row) rows.set(cmd, row)\n  }\n  // Unlike the toolbar, a command naming a group no feature declares is not an error here: it is listed under `other`.\n  const other: PaletteEntry[] = []\n  const groups: PaletteGroup[] = placeInGroups(toolbarGroupsOf(preset), [...rows.keys()], cmd => other.push(rows.get(cmd)!))\n    .filter(group => group.items.length > 0 && (!group.visible || group.visible(editor)))\n    .map(group => ({ id: group.id, label: group.labelKey ? ctx.t(group.labelKey) : group.id, entries: group.items.map(cmd => rows.get(cmd)!) }))\n  if (other.length) groups.push({ id: PALETTE_OTHER_GROUP, label: ctx.t('palette.group.other'), entries: other })\n  return groups\n}\n\n/**\n * The groups with only the entries matching `query`: case-insensitive, `query` is a prefix or any substring of the\n * entry's label or command id; entries that start with it come first. Empty groups drop out; a blank query keeps\n * everything. Only the first level is filtered (a menu command's rows are the framework search's job).\n */\nexport function filterPalette(groups: readonly PaletteGroup[], query: string): PaletteGroup[] {\n  const needle = query.trim().toLowerCase()\n  if (!needle) return [...groups]\n  const rank = (entry: PaletteEntry) => {\n    const label = entry.label.toLowerCase()\n    const id = entry.id.toLowerCase()\n    if (label.startsWith(needle) || id.startsWith(needle)) return 0\n    return label.includes(needle) || id.includes(needle) ? 1 : undefined\n  }\n  return groups.flatMap((group) => {\n    const entries = group.entries\n      .flatMap(entry => (rank(entry) === undefined ? [] : [{ entry, rank: rank(entry)! }]))\n      .sort((a, b) => a.rank - b.rank)\n      .map(item => item.entry)\n    return entries.length ? [{ ...group, entries }] : []\n  })\n}\n"],"mappings":";;;AAqCA,MAAa,sBAAsB;AAEnC,SAAS,QAAQ,QAAgB,KAAiB,OAAwE;CACxH,IAAI,eAAe,KAAK,OAAO,KAAA;CAC/B,MAAM,OAAO;EAAE,IAAI,IAAI;EAAI,OAAO,IAAI;EAAO,MAAM,IAAI;EAAM,GAAI,IAAI,QAAQ,EAAE,MAAM,IAAI,KAAK;EAAI,QAAQ,MAAM;CAAO;CACvH,IAAI,SAAS,KAAK,OAAO;EAAE,GAAG;EAAM,UAAU,CAAC,MAAM;EAAS,WAAW,IAAI,IAAI,MAAM;CAAE;CACzF,MAAM,WAAW,IAAI,KAAK,MAAM,CAAC,CAAC,SAAS,MAAM,UAA0B;EACzE,IAAI,KAAK,QAAQ,KAAK,UAAU,KAAA,GAAW,OAAO,CAAC;EACnD,OAAO,CAAC;GACN,IAAI,GAAG,IAAI,GAAG,GAAG;GACjB,OAAO,KAAK;GACZ,MAAM,KAAK,QAAQ;GACnB,GAAI,KAAK,gBAAgB,KAAA,KAAa,EAAE,aAAa,KAAK,YAAY;GACtE,UAAU,CAAC,CAAC,KAAK;GACjB,QAAQ;GACR,GAAI,KAAK,YAAY,EAAE,KAAK,KAAK,SAAS;EAC5C,CAAC;CACH,CAAC;CACD,OAAO;EAAE,GAAG;EAAM,UAAU,CAAC,MAAM,WAAW,CAAC,SAAS,MAAK,UAAS,CAAC,MAAM,QAAQ;EAAG;CAAS;AACnG;;;;;;;;AASA,SAAgB,gBAAgB,QAAgB,OAA4D;CAC1G,MAAM,EAAE,QAAQ,QAAQ;CACxB,MAAM,uBAAO,IAAI,IAA8B;CAC/C,KAAK,MAAM,OAAO,IAAI,SAAS,GAAG;EAChC,IAAI,IAAI,YAAY,OAAO;EAC3B,MAAM,QAAQ,aAAa,QAAQ,KAAK,WAAW;EACnD,IAAI,CAAC,MAAM,SAAS;EACpB,MAAM,MAAM,QAAQ,QAAQ,KAAK,KAAK;EACtC,IAAI,KAAK,KAAK,IAAI,KAAK,GAAG;CAC5B;CAEA,MAAM,QAAwB,CAAC;CAC/B,MAAM,SAAyB,cAAc,gBAAgB,MAAM,GAAG,CAAC,GAAG,KAAK,KAAK,CAAC,IAAG,QAAO,MAAM,KAAK,KAAK,IAAI,GAAG,CAAE,CAAC,CAAC,CACvH,QAAO,UAAS,MAAM,MAAM,SAAS,MAAM,CAAC,MAAM,WAAW,MAAM,QAAQ,MAAM,EAAE,CAAC,CACpF,KAAI,WAAU;EAAE,IAAI,MAAM;EAAI,OAAO,MAAM,WAAW,IAAI,EAAE,MAAM,QAAQ,IAAI,MAAM;EAAI,SAAS,MAAM,MAAM,KAAI,QAAO,KAAK,IAAI,GAAG,CAAE;CAAE,EAAE;CAC7I,IAAI,MAAM,QAAQ,OAAO,KAAK;EAAE,IAAI;EAAqB,OAAO,IAAI,EAAE,qBAAqB;EAAG,SAAS;CAAM,CAAC;CAC9G,OAAO;AACT;;;;;;AAOA,SAAgB,cAAc,QAAiC,OAA+B;CAC5F,MAAM,SAAS,MAAM,KAAK,CAAC,CAAC,YAAY;CACxC,IAAI,CAAC,QAAQ,OAAO,CAAC,GAAG,MAAM;CAC9B,MAAM,QAAQ,UAAwB;EACpC,MAAM,QAAQ,MAAM,MAAM,YAAY;EACtC,MAAM,KAAK,MAAM,GAAG,YAAY;EAChC,IAAI,MAAM,WAAW,MAAM,KAAK,GAAG,WAAW,MAAM,GAAG,OAAO;EAC9D,OAAO,MAAM,SAAS,MAAM,KAAK,GAAG,SAAS,MAAM,IAAI,IAAI,KAAA;CAC7D;CACA,OAAO,OAAO,SAAS,UAAU;EAC/B,MAAM,UAAU,MAAM,QACnB,SAAQ,UAAU,KAAK,KAAK,MAAM,KAAA,IAAY,CAAC,IAAI,CAAC;GAAE;GAAO,MAAM,KAAK,KAAK;EAAG,CAAC,CAAE,CAAC,CACpF,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAC/B,KAAI,SAAQ,KAAK,KAAK;EACzB,OAAO,QAAQ,SAAS,CAAC;GAAE,GAAG;GAAO;EAAQ,CAAC,IAAI,CAAC;CACrD,CAAC;AACH"}

package/dist/core/schema/abilities.d.ts

@@ -14,6 +14,7 @@ export declare const ABILITY: {
   readonly media: "insert.media";
   readonly record: "insert.record";
   readonly mention: "insert.mention";
+  readonly reference: "insert.reference";
   readonly tag: "insert.tag";
   readonly aiRewrite: "ai.rewrite";
   readonly aiGenerate: "ai.generate";
@@ -24,7 +25,7 @@ export declare const ABILITY: {
   readonly compositeMeta: "composite.meta";
   readonly compositeSummarize: "composite.summarize";
   readonly compositeExport: "composite.export";
-  readonly compositeTranscribe: "composite.transcribe";
+  readonly compositeDerive: "composite.derive";
 };
 export type Ability = (typeof ABILITY)[keyof typeof ABILITY] | (string & {});
 /** How a node changes the abilities of everything inside it: `grants`, then `revokes`; `own` only applies when it is the innermost node. */

package/dist/core/schema/abilities.js

@@ -13,6 +13,7 @@ const ABILITY = {
 	media: "insert.media",
 	record: "insert.record",
 	mention: "insert.mention",
+	reference: "insert.reference",
 	tag: "insert.tag",
 	aiRewrite: "ai.rewrite",
 	aiGenerate: "ai.generate",
@@ -23,7 +24,7 @@ const ABILITY = {
 	compositeMeta: "composite.meta",
 	compositeSummarize: "composite.summarize",
 	compositeExport: "composite.export",
-	compositeTranscribe: "composite.transcribe"
+	compositeDerive: "composite.derive"
 };
 /** Everything a plain paragraph at document root can do. `composite.*` are `own` abilities of composites only. */
 const ROOT_ABILITIES = [
@@ -39,6 +40,7 @@ const ROOT_ABILITIES = [
 	ABILITY.media,
 	ABILITY.record,
 	ABILITY.mention,
+	ABILITY.reference,
 	ABILITY.tag,
 	ABILITY.aiRewrite,
 	ABILITY.aiGenerate,
@@ -61,6 +63,7 @@ const TEXT_ABILITIES = [
 	ABILITY.media,
 	ABILITY.record,
 	ABILITY.mention,
+	ABILITY.reference,
 	ABILITY.tag,
 	ABILITY.aiRewrite,
 	ABILITY.aiGenerate,
@@ -88,6 +91,7 @@ const TYPE_ABILITIES = {
 	video: ABILITY.media,
 	file: ABILITY.media,
 	mention: ABILITY.mention,
+	reference: ABILITY.reference,
 	tag: ABILITY.tag
 };
 /**

package/dist/core/schema/abilities.js.map

@@ -1 +1 @@
-{"version":3,"file":"abilities.js","names":[],"sources":["../../../src/core/schema/abilities.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\n\n// Vue-free and server-importable: node schemas shared with the server declare their rule via `NodeConfig.abilities`.\n\n/** Ability ids. Hosts may add their own strings; these are the ones the editor itself checks. */\nexport const ABILITY = {\n  marks: 'format.marks',\n  headings: 'format.headings',\n  lists: 'format.lists',\n  blockquote: 'format.blockquote',\n  codeBlock: 'format.codeBlock',\n  rule: 'format.rule',\n  blockContent: 'block.content',\n  composite: 'format.composite',\n  transcript: 'transcript.segment',\n  media: 'insert.media',\n  record: 'insert.record',\n  mention: 'insert.mention',\n  tag: 'insert.tag',\n  aiRewrite: 'ai.rewrite',\n  aiGenerate: 'ai.generate',\n  aiAutocomplete: 'ai.autocomplete',\n  blockDelete: 'block.delete',\n  blockDuplicate: 'block.duplicate',\n  blockConvert: 'block.convert',\n  compositeMeta: 'composite.meta',\n  compositeSummarize: 'composite.summarize',\n  compositeExport: 'composite.export',\n  compositeTranscribe: 'composite.transcribe',\n} as const\n\nexport type Ability = (typeof ABILITY)[keyof typeof ABILITY] | (string & {})\n\n/** How a node changes the abilities of everything inside it: `grants`, then `revokes`; `own` only applies when it is the innermost node. */\nexport interface AbilityRule {\n  grants?: readonly Ability[]\n  revokes?: readonly Ability[]\n  own?: readonly Ability[]\n}\n\nexport type AbilityRuleSource = AbilityRule | ((node: PMNode) => AbilityRule)\n\n/** Everything a plain paragraph at document root can do. `composite.*` are `own` abilities of composites only. */\nexport const ROOT_ABILITIES: readonly Ability[] = [\n  ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.codeBlock, ABILITY.rule, ABILITY.blockContent, ABILITY.composite,\n  ABILITY.transcript, ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.tag, ABILITY.aiRewrite, ABILITY.aiGenerate,\n  ABILITY.aiAutocomplete, ABILITY.blockDelete, ABILITY.blockDuplicate, ABILITY.blockConvert,\n]\n\n/** Text-editing abilities an atom block (image/audio/video) or a tags row can never have. */\nexport const TEXT_ABILITIES: readonly Ability[] = [\n  ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.codeBlock, ABILITY.rule, ABILITY.blockContent, ABILITY.composite,\n  ABILITY.transcript, ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.tag, ABILITY.aiRewrite, ABILITY.aiGenerate,\n  ABILITY.aiAutocomplete,\n]\n\n/** Node/mark type → ability its creation/toggling needs (toolbar fallback, shortcut + input-rule gate). */\nexport const TYPE_ABILITIES: Readonly<Record<string, Ability>> = {\n  bold: ABILITY.marks,\n  italic: ABILITY.marks,\n  strike: ABILITY.marks,\n  code: ABILITY.marks,\n  heading: ABILITY.headings,\n  bulletList: ABILITY.lists,\n  orderedList: ABILITY.lists,\n  listItem: ABILITY.lists,\n  taskList: ABILITY.lists,\n  taskItem: ABILITY.lists,\n  blockquote: ABILITY.blockquote,\n  codeBlock: ABILITY.codeBlock,\n  horizontalRule: ABILITY.rule,\n  composite: ABILITY.composite,\n  transcriptSegment: ABILITY.transcript,\n  image: ABILITY.media,\n  audio: ABILITY.media,\n  video: ABILITY.media,\n  file: ABILITY.media,\n  mention: ABILITY.mention,\n  tag: ABILITY.tag,\n}\n\n/**\n * Abilities at the end of `chain` (ancestors from depth 1 down to and including the innermost node):\n * start with `root`; per node add its `grants`, remove its `revokes`; finally add the innermost node's `own`.\n */\nexport function resolveAbilities(rules: ReadonlyMap<string, AbilityRuleSource>, root: readonly Ability[], chain: readonly PMNode[]): ReadonlySet<Ability> {\n  const set = new Set<Ability>(root)\n  let own: readonly Ability[] | undefined\n  for (const node of chain) {\n    const source = rules.get(node.type.name)\n    const rule = typeof source === 'function' ? source(node) : source\n    for (const ability of rule?.grants ?? []) set.add(ability)\n    for (const ability of rule?.revokes ?? []) set.delete(ability)\n    own = rule?.own\n  }\n  for (const ability of own ?? []) set.add(ability)\n  return set\n}\n\ndeclare module '@tiptap/core' {\n  interface NodeConfig<Options, Storage> {\n    /** Abilities this node grants/revokes for its content (`own`: only when it is the innermost node). Host rules override it. */\n    abilities?: AbilityRuleSource\n  }\n}\n"],"mappings":";;AAKA,MAAa,UAAU;CACrB,OAAO;CACP,UAAU;CACV,OAAO;CACP,YAAY;CACZ,WAAW;CACX,MAAM;CACN,cAAc;CACd,WAAW;CACX,YAAY;CACZ,OAAO;CACP,QAAQ;CACR,SAAS;CACT,KAAK;CACL,WAAW;CACX,YAAY;CACZ,gBAAgB;CAChB,aAAa;CACb,gBAAgB;CAChB,cAAc;CACd,eAAe;CACf,oBAAoB;CACpB,iBAAiB;CACjB,qBAAqB;AACvB;;AAcA,MAAa,iBAAqC;CAChD,QAAQ;CAAO,QAAQ;CAAU,QAAQ;CAAO,QAAQ;CAAY,QAAQ;CAAW,QAAQ;CAAM,QAAQ;CAAc,QAAQ;CACnI,QAAQ;CAAY,QAAQ;CAAO,QAAQ;CAAQ,QAAQ;CAAS,QAAQ;CAAK,QAAQ;CAAW,QAAQ;CAC5G,QAAQ;CAAgB,QAAQ;CAAa,QAAQ;CAAgB,QAAQ;AAC/E;;AAGA,MAAa,iBAAqC;CAChD,QAAQ;CAAO,QAAQ;CAAU,QAAQ;CAAO,QAAQ;CAAY,QAAQ;CAAW,QAAQ;CAAM,QAAQ;CAAc,QAAQ;CACnI,QAAQ;CAAY,QAAQ;CAAO,QAAQ;CAAQ,QAAQ;CAAS,QAAQ;CAAK,QAAQ;CAAW,QAAQ;CAC5G,QAAQ;AACV;;AAGA,MAAa,iBAAoD;CAC/D,MAAM,QAAQ;CACd,QAAQ,QAAQ;CAChB,QAAQ,QAAQ;CAChB,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,YAAY,QAAQ;CACpB,aAAa,QAAQ;CACrB,UAAU,QAAQ;CAClB,UAAU,QAAQ;CAClB,UAAU,QAAQ;CAClB,YAAY,QAAQ;CACpB,WAAW,QAAQ;CACnB,gBAAgB,QAAQ;CACxB,WAAW,QAAQ;CACnB,mBAAmB,QAAQ;CAC3B,OAAO,QAAQ;CACf,OAAO,QAAQ;CACf,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,KAAK,QAAQ;AACf;;;;;AAMA,SAAgB,iBAAiB,OAA+C,MAA0B,OAAgD;CACxJ,MAAM,MAAM,IAAI,IAAa,IAAI;CACjC,IAAI;CACJ,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,MAAM,IAAI,KAAK,KAAK,IAAI;EACvC,MAAM,OAAO,OAAO,WAAW,aAAa,OAAO,IAAI,IAAI;EAC3D,KAAK,MAAM,WAAW,MAAM,UAAU,CAAC,GAAG,IAAI,IAAI,OAAO;EACzD,KAAK,MAAM,WAAW,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,OAAO;EAC7D,MAAM,MAAM;CACd;CACA,KAAK,MAAM,WAAW,OAAO,CAAC,GAAG,IAAI,IAAI,OAAO;CAChD,OAAO;AACT"}
+{"version":3,"file":"abilities.js","names":[],"sources":["../../../src/core/schema/abilities.ts"],"sourcesContent":["import type { Node as PMNode } from '@tiptap/pm/model'\n\n// Vue-free and server-importable: node schemas shared with the server declare their rule via `NodeConfig.abilities`.\n\n/** Ability ids. Hosts may add their own strings; these are the ones the editor itself checks. */\nexport const ABILITY = {\n  marks: 'format.marks',\n  headings: 'format.headings',\n  lists: 'format.lists',\n  blockquote: 'format.blockquote',\n  codeBlock: 'format.codeBlock',\n  rule: 'format.rule',\n  blockContent: 'block.content',\n  composite: 'format.composite',\n  transcript: 'transcript.segment',\n  media: 'insert.media',\n  record: 'insert.record',\n  mention: 'insert.mention',\n  reference: 'insert.reference',\n  tag: 'insert.tag',\n  aiRewrite: 'ai.rewrite',\n  aiGenerate: 'ai.generate',\n  aiAutocomplete: 'ai.autocomplete',\n  blockDelete: 'block.delete',\n  blockDuplicate: 'block.duplicate',\n  blockConvert: 'block.convert',\n  compositeMeta: 'composite.meta',\n  compositeSummarize: 'composite.summarize',\n  compositeExport: 'composite.export',\n  compositeDerive: 'composite.derive',\n} as const\n\nexport type Ability = (typeof ABILITY)[keyof typeof ABILITY] | (string & {})\n\n/** How a node changes the abilities of everything inside it: `grants`, then `revokes`; `own` only applies when it is the innermost node. */\nexport interface AbilityRule {\n  grants?: readonly Ability[]\n  revokes?: readonly Ability[]\n  own?: readonly Ability[]\n}\n\nexport type AbilityRuleSource = AbilityRule | ((node: PMNode) => AbilityRule)\n\n/** Everything a plain paragraph at document root can do. `composite.*` are `own` abilities of composites only. */\nexport const ROOT_ABILITIES: readonly Ability[] = [\n  ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.codeBlock, ABILITY.rule, ABILITY.blockContent, ABILITY.composite,\n  ABILITY.transcript, ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.reference, ABILITY.tag, ABILITY.aiRewrite, ABILITY.aiGenerate,\n  ABILITY.aiAutocomplete, ABILITY.blockDelete, ABILITY.blockDuplicate, ABILITY.blockConvert,\n]\n\n/** Text-editing abilities an atom block (image/audio/video) or a tags row can never have. */\nexport const TEXT_ABILITIES: readonly Ability[] = [\n  ABILITY.marks, ABILITY.headings, ABILITY.lists, ABILITY.blockquote, ABILITY.codeBlock, ABILITY.rule, ABILITY.blockContent, ABILITY.composite,\n  ABILITY.transcript, ABILITY.media, ABILITY.record, ABILITY.mention, ABILITY.reference, ABILITY.tag, ABILITY.aiRewrite, ABILITY.aiGenerate,\n  ABILITY.aiAutocomplete,\n]\n\n/** Node/mark type → ability its creation/toggling needs (toolbar fallback, shortcut + input-rule gate). */\nexport const TYPE_ABILITIES: Readonly<Record<string, Ability>> = {\n  bold: ABILITY.marks,\n  italic: ABILITY.marks,\n  strike: ABILITY.marks,\n  code: ABILITY.marks,\n  heading: ABILITY.headings,\n  bulletList: ABILITY.lists,\n  orderedList: ABILITY.lists,\n  listItem: ABILITY.lists,\n  taskList: ABILITY.lists,\n  taskItem: ABILITY.lists,\n  blockquote: ABILITY.blockquote,\n  codeBlock: ABILITY.codeBlock,\n  horizontalRule: ABILITY.rule,\n  composite: ABILITY.composite,\n  transcriptSegment: ABILITY.transcript,\n  image: ABILITY.media,\n  audio: ABILITY.media,\n  video: ABILITY.media,\n  file: ABILITY.media,\n  mention: ABILITY.mention,\n  reference: ABILITY.reference,\n  tag: ABILITY.tag,\n}\n\n/**\n * Abilities at the end of `chain` (ancestors from depth 1 down to and including the innermost node):\n * start with `root`; per node add its `grants`, remove its `revokes`; finally add the innermost node's `own`.\n */\nexport function resolveAbilities(rules: ReadonlyMap<string, AbilityRuleSource>, root: readonly Ability[], chain: readonly PMNode[]): ReadonlySet<Ability> {\n  const set = new Set<Ability>(root)\n  let own: readonly Ability[] | undefined\n  for (const node of chain) {\n    const source = rules.get(node.type.name)\n    const rule = typeof source === 'function' ? source(node) : source\n    for (const ability of rule?.grants ?? []) set.add(ability)\n    for (const ability of rule?.revokes ?? []) set.delete(ability)\n    own = rule?.own\n  }\n  for (const ability of own ?? []) set.add(ability)\n  return set\n}\n\ndeclare module '@tiptap/core' {\n  interface NodeConfig<Options, Storage> {\n    /** Abilities this node grants/revokes for its content (`own`: only when it is the innermost node). Host rules override it. */\n    abilities?: AbilityRuleSource\n  }\n}\n"],"mappings":";;AAKA,MAAa,UAAU;CACrB,OAAO;CACP,UAAU;CACV,OAAO;CACP,YAAY;CACZ,WAAW;CACX,MAAM;CACN,cAAc;CACd,WAAW;CACX,YAAY;CACZ,OAAO;CACP,QAAQ;CACR,SAAS;CACT,WAAW;CACX,KAAK;CACL,WAAW;CACX,YAAY;CACZ,gBAAgB;CAChB,aAAa;CACb,gBAAgB;CAChB,cAAc;CACd,eAAe;CACf,oBAAoB;CACpB,iBAAiB;CACjB,iBAAiB;AACnB;;AAcA,MAAa,iBAAqC;CAChD,QAAQ;CAAO,QAAQ;CAAU,QAAQ;CAAO,QAAQ;CAAY,QAAQ;CAAW,QAAQ;CAAM,QAAQ;CAAc,QAAQ;CACnI,QAAQ;CAAY,QAAQ;CAAO,QAAQ;CAAQ,QAAQ;CAAS,QAAQ;CAAW,QAAQ;CAAK,QAAQ;CAAW,QAAQ;CAC/H,QAAQ;CAAgB,QAAQ;CAAa,QAAQ;CAAgB,QAAQ;AAC/E;;AAGA,MAAa,iBAAqC;CAChD,QAAQ;CAAO,QAAQ;CAAU,QAAQ;CAAO,QAAQ;CAAY,QAAQ;CAAW,QAAQ;CAAM,QAAQ;CAAc,QAAQ;CACnI,QAAQ;CAAY,QAAQ;CAAO,QAAQ;CAAQ,QAAQ;CAAS,QAAQ;CAAW,QAAQ;CAAK,QAAQ;CAAW,QAAQ;CAC/H,QAAQ;AACV;;AAGA,MAAa,iBAAoD;CAC/D,MAAM,QAAQ;CACd,QAAQ,QAAQ;CAChB,QAAQ,QAAQ;CAChB,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,YAAY,QAAQ;CACpB,aAAa,QAAQ;CACrB,UAAU,QAAQ;CAClB,UAAU,QAAQ;CAClB,UAAU,QAAQ;CAClB,YAAY,QAAQ;CACpB,WAAW,QAAQ;CACnB,gBAAgB,QAAQ;CACxB,WAAW,QAAQ;CACnB,mBAAmB,QAAQ;CAC3B,OAAO,QAAQ;CACf,OAAO,QAAQ;CACf,OAAO,QAAQ;CACf,MAAM,QAAQ;CACd,SAAS,QAAQ;CACjB,WAAW,QAAQ;CACnB,KAAK,QAAQ;AACf;;;;;AAMA,SAAgB,iBAAiB,OAA+C,MAA0B,OAAgD;CACxJ,MAAM,MAAM,IAAI,IAAa,IAAI;CACjC,IAAI;CACJ,KAAK,MAAM,QAAQ,OAAO;EACxB,MAAM,SAAS,MAAM,IAAI,KAAK,KAAK,IAAI;EACvC,MAAM,OAAO,OAAO,WAAW,aAAa,OAAO,IAAI,IAAI;EAC3D,KAAK,MAAM,WAAW,MAAM,UAAU,CAAC,GAAG,IAAI,IAAI,OAAO;EACzD,KAAK,MAAM,WAAW,MAAM,WAAW,CAAC,GAAG,IAAI,OAAO,OAAO;EAC7D,MAAM,MAAM;CACd;CACA,KAAK,MAAM,WAAW,OAAO,CAAC,GAAG,IAAI,IAAI,OAAO;CAChD,OAAO;AACT"}

package/dist/core/schema/index.d.ts

@@ -5,17 +5,23 @@ import { HEX_COLOR } from "./hex-color.js";
 import { NodeFlags, isBlockContainer, isChromeNode, isEditorBlock } from "./node-flags.js";
 import { OpaqueFence } from "./opaque-fence.js";
 import { StrikeX } from "./strike.js";
+import { schemaExtensionsOf } from "./of-features.js";
 import { AnyExtension, JSONContent } from "@tiptap/core";
 //#region src/core/schema/index.d.ts
 /**
- * Base Vue-free nodes and marks of every editor: StarterKit (history off: the surface enables it for standalone
- * editors, collaboration brings its own), StrikeX, the node-flags extension, `OpaqueFence` (Markdown fences of unknown
- * kinds, kept verbatim) and `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only
- * run in an editor). The server builds its schema from these as well (`getSchema(...)`).
+ * The Vue-free nodes and marks of the content base (`core-content` feature): StarterKit (history off: the surface enables
+ * it for standalone editors, collaboration brings its own), StrikeX, the node-flags extension and `OpaqueFence` (Markdown
+ * fences of unknown kinds, kept verbatim). Without `BlockId`: `schemaExtensionsOf` appends it last.
+ */
+export declare const coreContentSchemaExtensions: () => AnyExtension[];
+/**
+ * Base Vue-free nodes and marks of every editor: `coreContentSchemaExtensions()` and `BlockId`, which adds the `id`
+ * attribute to every block type (its ID-assigning plugins only run in an editor). The server builds its schema from
+ * these as well (`getSchema(...)`).
  */
 export declare const coreSchemaExtensions: () => AnyExtension[];
 /** Content of a fresh, empty document. */
 export declare const EMPTY_EDITOR_CONTENT: JSONContent;
 //#endregion
-export { ABILITY, Ability, AbilityRule, AbilityRuleSource, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities };
+export { ABILITY, Ability, AbilityRule, AbilityRuleSource, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities, schemaExtensionsOf };
 //# sourceMappingURL=index.d.ts.map

package/dist/core/schema/index.js

@@ -4,30 +4,35 @@ import { NodeFlags, isBlockContainer, isChromeNode, isEditorBlock } from "./node
 import { OpaqueFence } from "./opaque-fence.js";
 import { StrikeX } from "./strike.js";
 import { HEX_COLOR } from "./hex-color.js";
+import { schemaExtensionsOf } from "./of-features.js";
 import StarterKit from "@tiptap/starter-kit";
 //#region src/core/schema/index.ts
 /**
-* Base Vue-free nodes and marks of every editor: StarterKit (history off: the surface enables it for standalone
-* editors, collaboration brings its own), StrikeX, the node-flags extension, `OpaqueFence` (Markdown fences of unknown
-* kinds, kept verbatim) and `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only
-* run in an editor). The server builds its schema from these as well (`getSchema(...)`).
+* The Vue-free nodes and marks of the content base (`core-content` feature): StarterKit (history off: the surface enables
+* it for standalone editors, collaboration brings its own), StrikeX, the node-flags extension and `OpaqueFence` (Markdown
+* fences of unknown kinds, kept verbatim). Without `BlockId`: `schemaExtensionsOf` appends it last.
 */
-const coreSchemaExtensions = () => [
+const coreContentSchemaExtensions = () => [
 	StarterKit.configure({
 		strike: false,
 		undoRedo: false
 	}),
 	StrikeX,
 	NodeFlags,
-	OpaqueFence,
-	BlockId
+	OpaqueFence
 ];
+/**
+* Base Vue-free nodes and marks of every editor: `coreContentSchemaExtensions()` and `BlockId`, which adds the `id`
+* attribute to every block type (its ID-assigning plugins only run in an editor). The server builds its schema from
+* these as well (`getSchema(...)`).
+*/
+const coreSchemaExtensions = () => [...coreContentSchemaExtensions(), BlockId];
 /** Content of a fresh, empty document. */
 const EMPTY_EDITOR_CONTENT = {
 	type: "doc",
 	content: [{ type: "paragraph" }]
 };
 //#endregion
-export { ABILITY, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, EMPTY_EDITOR_CONTENT, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, coreSchemaExtensions, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities };
+export { ABILITY, BLOCK_ID_ATTR, BLOCK_ID_TYPES, BlockId, EMPTY_EDITOR_CONTENT, HEX_COLOR, NodeFlags, OpaqueFence, ROOT_ABILITIES, StrikeX, TEXT_ABILITIES, TYPE_ABILITIES, assignBlockIds, blockIdOf, coreContentSchemaExtensions, coreSchemaExtensions, findBlockById, isBlockContainer, isChromeNode, isEditorBlock, newBlockId, resolveAbilities, schemaExtensionsOf };
 
 //# sourceMappingURL=index.js.map

package/dist/core/schema/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/core/schema/index.ts"],"sourcesContent":["import type { AnyExtension, JSONContent } from '@tiptap/core'\nimport StarterKit from '@tiptap/starter-kit'\nimport { BlockId } from './block-ids'\nimport { NodeFlags } from './node-flags'\nimport { OpaqueFence } from './opaque-fence'\nimport { StrikeX } from './strike'\n\nexport * from './abilities'\nexport * from './block-ids'\nexport * from './hex-color'\nexport * from './mark-flags'\nexport * from './node-flags'\nexport { OpaqueFence } from './opaque-fence'\nexport { StrikeX } from './strike'\n\n/**\n * Base Vue-free nodes and marks of every editor: StarterKit (history off: the surface enables it for standalone\n * editors, collaboration brings its own), StrikeX, the node-flags extension, `OpaqueFence` (Markdown fences of unknown\n * kinds, kept verbatim) and `BlockId`, which adds the `id` attribute to every block type (its ID-assigning plugins only\n * run in an editor). The server builds its schema from these as well (`getSchema(...)`).\n */\nexport const coreSchemaExtensions = (): AnyExtension[] => [StarterKit.configure({ strike: false, undoRedo: false }), StrikeX, NodeFlags, OpaqueFence, BlockId]\n\n/** Content of a fresh, empty document. */\nexport const EMPTY_EDITOR_CONTENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n"],"mappings":";;;;;;;;;;;;;;AAqBA,MAAa,6BAA6C;CAAC,WAAW,UAAU;EAAE,QAAQ;EAAO,UAAU;CAAM,CAAC;CAAG;CAAS;CAAW;CAAa;AAAO;;AAG7J,MAAa,uBAAoC;CAAE,MAAM;CAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;AAAE"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/core/schema/index.ts"],"sourcesContent":["import type { AnyExtension, JSONContent } from '@tiptap/core'\nimport StarterKit from '@tiptap/starter-kit'\nimport { BlockId } from './block-ids'\nimport { NodeFlags } from './node-flags'\nimport { OpaqueFence } from './opaque-fence'\nimport { StrikeX } from './strike'\n\nexport * from './abilities'\nexport * from './block-ids'\nexport * from './hex-color'\nexport * from './mark-flags'\nexport * from './node-flags'\nexport { OpaqueFence } from './opaque-fence'\nexport { StrikeX } from './strike'\nexport { schemaExtensionsOf } from './of-features'\n\n/**\n * The Vue-free nodes and marks of the content base (`core-content` feature): StarterKit (history off: the surface enables\n * it for standalone editors, collaboration brings its own), StrikeX, the node-flags extension and `OpaqueFence` (Markdown\n * fences of unknown kinds, kept verbatim). Without `BlockId`: `schemaExtensionsOf` appends it last.\n */\nexport const coreContentSchemaExtensions = (): AnyExtension[] => [StarterKit.configure({ strike: false, undoRedo: false }), StrikeX, NodeFlags, OpaqueFence]\n\n/**\n * Base Vue-free nodes and marks of every editor: `coreContentSchemaExtensions()` and `BlockId`, which adds the `id`\n * attribute to every block type (its ID-assigning plugins only run in an editor). The server builds its schema from\n * these as well (`getSchema(...)`).\n */\nexport const coreSchemaExtensions = (): AnyExtension[] => [...coreContentSchemaExtensions(), BlockId]\n\n/** Content of a fresh, empty document. */\nexport const EMPTY_EDITOR_CONTENT: JSONContent = { type: 'doc', content: [{ type: 'paragraph' }] }\n"],"mappings":";;;;;;;;;;;;;;AAqBA,MAAa,oCAAoD;CAAC,WAAW,UAAU;EAAE,QAAQ;EAAO,UAAU;CAAM,CAAC;CAAG;CAAS;CAAW;AAAW;;;;;;AAO3J,MAAa,6BAA6C,CAAC,GAAG,4BAA4B,GAAG,OAAO;;AAGpG,MAAa,uBAAoC;CAAE,MAAM;CAAO,SAAS,CAAC,EAAE,MAAM,YAAY,CAAC;AAAE"}

package/dist/core/schema/mark-flags.d.ts

@@ -1,3 +1,4 @@
+import { JSONContent } from "@tiptap/core";
 //#region src/core/schema/mark-flags.d.ts
 declare module '@tiptap/core' {
   interface MarkConfig<Options, Storage> {
@@ -7,6 +8,12 @@ declare module '@tiptap/core' {
      */
     markdownInvisible?: boolean;
   }
+  interface NodeConfig<Options, Storage> {
+    /**
+     * Rewrites the document JSON just before `editor.markdown.serialize` renders it (every node extension that declares it,
+     * in extension order), e.g. to drop attributes that must not reach the Markdown. Must not modify its input.
+     */
+    markdownPrepare?: (json: JSONContent, editor: Editor) => JSONContent;
+  }
 }
-export {};
 //# sourceMappingURL=mark-flags.d.ts.map

package/dist/core/schema/of-features.d.ts

@@ -0,0 +1,13 @@
+import { EditorFeature } from "../feature.js";
+import { AnyExtension } from "@tiptap/core";
+//#region src/core/schema/of-features.d.ts
+/**
+ * The server schema of a feature list: every feature's Vue-free `schemaExtensions` in feature order, then `BlockId`
+ * (it adds the `id` attribute to every block type, so it comes last). The content features carry the document model;
+ * an interaction feature may also declare `schemaExtensions` for marks that stored documents contain (`comments`), so
+ * the collection looks at the declaration, not at the dimension. Takes the schema-bearing slice of a feature, so
+ * server code can pass schema-only sources and never load a feature's UI.
+ */
+export declare const schemaExtensionsOf: (features: readonly Pick<EditorFeature, "schemaExtensions">[]) => AnyExtension[];
+//#endregion
+//# sourceMappingURL=of-features.d.ts.map

package/dist/core/schema/of-features.js

@@ -0,0 +1,14 @@
+import { BlockId } from "./block-ids.js";
+//#region src/core/schema/of-features.ts
+/**
+* The server schema of a feature list: every feature's Vue-free `schemaExtensions` in feature order, then `BlockId`
+* (it adds the `id` attribute to every block type, so it comes last). The content features carry the document model;
+* an interaction feature may also declare `schemaExtensions` for marks that stored documents contain (`comments`), so
+* the collection looks at the declaration, not at the dimension. Takes the schema-bearing slice of a feature, so
+* server code can pass schema-only sources and never load a feature's UI.
+*/
+const schemaExtensionsOf = (features) => [...features.flatMap((feature) => feature.schemaExtensions?.() ?? []), BlockId];
+//#endregion
+export { schemaExtensionsOf };
+
+//# sourceMappingURL=of-features.js.map

package/dist/core/schema/of-features.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"of-features.js","names":[],"sources":["../../../src/core/schema/of-features.ts"],"sourcesContent":["import type { AnyExtension } from '@tiptap/core'\nimport type { EditorFeature } from '../feature'\nimport { BlockId } from './block-ids'\n\n/**\n * The server schema of a feature list: every feature's Vue-free `schemaExtensions` in feature order, then `BlockId`\n * (it adds the `id` attribute to every block type, so it comes last). The content features carry the document model;\n * an interaction feature may also declare `schemaExtensions` for marks that stored documents contain (`comments`), so\n * the collection looks at the declaration, not at the dimension. Takes the schema-bearing slice of a feature, so\n * server code can pass schema-only sources and never load a feature's UI.\n */\nexport const schemaExtensionsOf = (features: readonly Pick<EditorFeature, 'schemaExtensions'>[]): AnyExtension[] =>\n  [...features.flatMap(feature => feature.schemaExtensions?.() ?? []), BlockId]\n"],"mappings":";;;;;;;;;AAWA,MAAa,sBAAsB,aACjC,CAAC,GAAG,SAAS,SAAQ,YAAW,QAAQ,mBAAmB,KAAK,CAAC,CAAC,GAAG,OAAO"}

package/dist/core/slash.d.ts

@@ -1,10 +1,11 @@
-import { SlashCommandItem } from "./extension-points.js";
+import { CommandDef } from "./command-types.js";
+import "./commands.js";
 import { Extension } from "@tiptap/core";
 import { PluginKey } from "@tiptap/pm/state";
 //#region src/core/slash.d.ts
 export interface SlashCommandOptions {
-  /** The final `/` menu: features' commands after the host's `slashCommands` transformer. */
-  items: SlashCommandItem[];
+  /** The final command list (features' commands after the host's `commands` transformer); the ones with a `slash` placement make the menu. */
+  commands: CommandDef[];
   /** Popup text while no command matches the typed query (`ctx.t('slash.empty')`). */
   emptyText: string;
   /** Popup text while the commands are pending (`ctx.t('common.loading')`). */
@@ -14,9 +15,10 @@ export interface SlashCommandOptions {
 export declare const SlashCommandPluginKey: PluginKey<any>;
 /**
  * `/` menu on an empty line: typing `/` as the only content of a textblock (outside code) opens the shared suggestion
- * popup with the commands allowed at the caret (`SlashCommandItem.ability`) whose id or label starts with the typed
- * query; picking one deletes `/query` and runs it. A query no allowed command matches (`/foo`) shows nothing and stays
- * plain text. The commands come from features and the host; the core feature has none of its own.
+ * popup with the commands that have a `slash` placement and are visible and enabled at the caret (`commandState`: ability,
+ * structural check, schema and accepted-children fit) whose slash id or label starts with the typed query; picking one
+ * deletes `/query` and runs it. A query no such command matches (`/foo`) shows nothing and stays plain text. The commands
+ * come from features and the host.
  * Client-only: not part of the Vue-free schema.
  */
 export declare const SlashCommand: Extension<SlashCommandOptions, any>;

package/dist/core/slash.js

@@ -1,33 +1,41 @@
-import { abilitiesAt } from "./abilities.js";
+import { commandState } from "./commands.js";
 import { createSuggestionRender } from "./suggestion-popup.js";
 import { Extension } from "@tiptap/core";
 import { PluginKey } from "@tiptap/pm/state";
 import { Suggestion } from "@tiptap/suggestion";
 //#region src/core/slash.ts
-function matching(items, query, abilities) {
+const slashIdOf = (cmd) => cmd.slash.id ?? cmd.id;
+/** The slash commands that are visible and enabled at the caret (`$at` when the editor state lags, see `commandState`) and whose slash id or label starts with `query`. */
+function matching(editor, commands, query, $at) {
 	const q = query.toLowerCase();
-	return items.filter((item) => (!item.ability || abilities.has(item.ability)) && (item.id.startsWith(q) || item.label.toLowerCase().startsWith(q)));
+	return commands.filter((cmd) => {
+		if (!cmd.slash || !("run" in cmd)) return false;
+		if (!(slashIdOf(cmd).startsWith(q) || cmd.label.toLowerCase().startsWith(q))) return false;
+		const state = commandState(editor, cmd, "caret", $at);
+		return state.visible && state.enabled;
+	});
 }
 /** Own key, so the `/` popup runs next to the `@` and `#` popups. */
 const SlashCommandPluginKey = new PluginKey("slashCommand");
 /**
 * `/` menu on an empty line: typing `/` as the only content of a textblock (outside code) opens the shared suggestion
-* popup with the commands allowed at the caret (`SlashCommandItem.ability`) whose id or label starts with the typed
-* query; picking one deletes `/query` and runs it. A query no allowed command matches (`/foo`) shows nothing and stays
-* plain text. The commands come from features and the host; the core feature has none of its own.
+* popup with the commands that have a `slash` placement and are visible and enabled at the caret (`commandState`: ability,
+* structural check, schema and accepted-children fit) whose slash id or label starts with the typed query; picking one
+* deletes `/query` and runs it. A query no such command matches (`/foo`) shows nothing and stays plain text. The commands
+* come from features and the host.
 * Client-only: not part of the Vue-free schema.
 */
 const SlashCommand = Extension.create({
 	name: "slashCommand",
 	addOptions() {
 		return {
-			items: [],
+			commands: [],
 			emptyText: "",
 			loadingText: ""
 		};
 	},
 	addProseMirrorPlugins() {
-		const { items, emptyText, loadingText } = this.options;
+		const { commands, emptyText, loadingText } = this.options;
 		return [Suggestion({
 			pluginKey: SlashCommandPluginKey,
 			editor: this.editor,
@@ -35,18 +43,18 @@ const SlashCommand = Extension.create({
 			startOfLine: true,
 			shouldShow: ({ editor, range, query, transaction }) => {
 				const $from = transaction.doc.resolve(range.from);
-				return $from.parentOffset === 0 && range.to === $from.end() && !$from.parent.type.spec.code && matching(items, query, abilitiesAt(editor, $from)).length > 0;
+				return $from.parentOffset === 0 && range.to === $from.end() && !$from.parent.type.spec.code && matching(editor, commands, query, $from).length > 0;
 			},
-			items: ({ editor, query }) => matching(items, query, abilitiesAt(editor, editor.state.selection.$from)),
-			command: ({ editor, range, props: item }) => {
+			items: ({ editor, query }) => matching(editor, commands, query),
+			command: ({ editor, range, props: cmd }) => {
 				editor.chain().focus().deleteRange(range).run();
-				item.run(editor);
+				cmd.run(editor);
 			},
 			render: createSuggestionRender({
-				display: (item) => ({
-					label: item.label,
-					description: `/${item.id}`,
-					icon: item.icon
+				display: (cmd) => ({
+					label: cmd.label,
+					description: `/${slashIdOf(cmd)}`,
+					icon: cmd.icon
 				}),
 				emptyText,
 				loadingText