@ecsplico/editor 2.1.2 → 3.1.0

package/dist/core/http-backend.js

@@ -0,0 +1,195 @@
+import { BackendError } from "./backend.js";
+import { AI_API, EDITOR_API, documentUrl } from "./api-routes.js";
+//#region src/core/http-backend.ts
+function platformSend(url, { method, headers: extra, body, query, signal } = {}) {
+	const headers = new Headers(extra);
+	let payload;
+	if (typeof body === "string" || typeof FormData !== "undefined" && body instanceof FormData) payload = body;
+	else if (body !== void 0) {
+		headers.set("content-type", "application/json");
+		payload = JSON.stringify(body);
+	}
+	const target = query ? `${url}?${new URLSearchParams(query)}` : url;
+	return globalThis.fetch(target, {
+		...method && { method },
+		headers,
+		...payload !== void 0 && { body: payload },
+		...signal && { signal }
+	});
+}
+/** The request through `fetcher.raw`: the response comes back unread (`stream`), a non-2xx one is a result, not an exception. */
+function fetcherSend(fetcher) {
+	return (url, { method, headers, body, query, signal } = {}) => {
+		const options = {
+			responseType: "stream",
+			ignoreResponseError: true
+		};
+		if (method) options.method = method;
+		if (headers) options.headers = headers;
+		if (body !== void 0) options.body = body;
+		if (query) options.query = query;
+		if (signal) options.signal = signal;
+		return fetcher.raw(url, options);
+	};
+}
+/** The transport of `fetch` (default: the platform `fetch`). */
+function createTransport(fetcher) {
+	const send = fetcher ? fetcherSend(fetcher) : platformSend;
+	async function check(response) {
+		if (response.ok) return response;
+		let message = `HTTP ${response.status}`;
+		try {
+			const json = await response.json();
+			message = json.statusMessage || json.message || message;
+		} catch {}
+		throw new BackendError(message, response.status);
+	}
+	return {
+		send,
+		check,
+		request: async (url, request) => check(await send(url, request))
+	};
+}
+/** Drops a response whose body nobody reads, so the connection is released. */
+const discard = (response) => response.body?.cancel().catch(() => void 0);
+/** The event of an SSE block (`event: x\ndata: {json}`); `data` is `{}` without a payload or with a malformed one. */
+function streamEvent(raw) {
+	let event = "message";
+	let data = "";
+	for (const line of raw.split("\n")) if (line.startsWith("event:")) event = line.slice(6).trim();
+	else if (line.startsWith("data:")) data += line.slice(5).trimStart();
+	let payload = {};
+	if (data) try {
+		payload = JSON.parse(data);
+	} catch {
+		payload = {};
+	}
+	return {
+		event,
+		data: payload
+	};
+}
+/** The editor's HTTP routes as an `EditorBackend` without `collaboration` and `comments`. */
+function createFetchBackend(options = {}) {
+	const base = options.base ?? "";
+	const { request, send, check } = createTransport(options.fetch);
+	const editor = (path) => `${base}${EDITOR_API}${path}`;
+	const ai = (path) => `${base}${AI_API}${path}`;
+	/** The JSON answer of a request that must succeed. */
+	const json = async (url, init) => (await request(url, init)).json();
+	/** A request that must succeed and whose answer is of no interest. */
+	const sent = async (url, init) => {
+		await discard(await request(url, init));
+	};
+	return {
+		name: "http",
+		documents: {
+			async load(id) {
+				const response = await send(`${base}${documentUrl(id)}`);
+				if (response.status === 404) {
+					await discard(response);
+					return null;
+				}
+				return (await check(response)).json();
+			},
+			save: (id, content) => sent(`${base}${documentUrl(id)}`, {
+				method: "PUT",
+				body: content
+			})
+		},
+		assets: { upload(documentId, file) {
+			const body = new FormData();
+			body.append("file", file);
+			return json(editor(`/assets/${documentId}`), {
+				method: "POST",
+				body
+			});
+		} },
+		users: { search: (query, signal) => json(editor("/users"), {
+			query: { q: query },
+			signal
+		}) },
+		tags: { search: (query, signal) => json(editor("/tags"), {
+			query: { q: query },
+			signal
+		}) },
+		settings: {
+			async load() {
+				const response = await request(editor("/settings"));
+				return response.status === 200 ? await response.json() : null;
+			},
+			save: (settings) => sent(editor("/settings"), {
+				method: "PUT",
+				body: settings
+			})
+		},
+		themes: {
+			list: () => json(editor("/themes")),
+			css: async (id) => (await request(editor(`/themes/${encodeURIComponent(id)}`))).text(),
+			store({ css, manifest }) {
+				const body = new FormData();
+				body.append("css", css);
+				if (manifest) body.append("manifest", manifest);
+				return json(editor("/themes"), {
+					method: "POST",
+					body
+				});
+			},
+			async remove(id) {
+				await sent(editor(`/themes/${encodeURIComponent(id)}`), { method: "DELETE" });
+				return true;
+			}
+		},
+		ai: {
+			models: () => json(ai("/models")),
+			complete: (body, signal) => json(ai("/complete"), {
+				method: "POST",
+				body,
+				signal
+			}),
+			async *stream(path, body, signal) {
+				const response = await request(ai(`/${path}`), {
+					method: "POST",
+					body,
+					signal
+				});
+				if (!response.body) throw new BackendError(`HTTP ${response.status}`, response.status);
+				const reader = response.body.getReader();
+				const decoder = new TextDecoder();
+				let buffer = "";
+				try {
+					while (true) {
+						const { value, done } = await reader.read();
+						if (done) break;
+						buffer += decoder.decode(value, { stream: true }).replace(/\r\n/g, "\n");
+						let index = buffer.indexOf("\n\n");
+						while (index !== -1) {
+							const event = streamEvent(buffer.slice(0, index));
+							yield event;
+							if (event.event === "done" || event.event === "error") return;
+							buffer = buffer.slice(index + 2);
+							index = buffer.indexOf("\n\n");
+						}
+					}
+					if (buffer.trim()) yield streamEvent(buffer);
+				} finally {
+					await reader.cancel().catch(() => void 0);
+				}
+			},
+			transcriptCleanup: (body, signal) => json(ai("/transcript-cleanup"), {
+				method: "POST",
+				body,
+				signal
+			}),
+			extract: (body, signal) => json(ai("/extract"), {
+				method: "POST",
+				body,
+				signal
+			})
+		}
+	};
+}
+//#endregion
+export { createFetchBackend, createTransport };
+
+//# sourceMappingURL=http-backend.js.map

package/dist/core/http-backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-backend.js","names":[],"sources":["../../src/core/http-backend.ts"],"sourcesContent":["import type { JSONContent } from '@tiptap/core'\nimport type { $Fetch, FetchOptions } from 'ofetch'\nimport type { EditorSettings } from '../settings'\nimport { AI_API, documentUrl, EDITOR_API } from './api-routes'\nimport { type AiStreamEvent, BackendError, type EditorBackend } from './backend'\nimport type { ExtractResponse, MentionUser } from './backend-types'\n\n// The request-response half of the HTTP backend: documents, assets, users, tags, settings, themes and AI over the\n// `/api/editor` and `/api/ai` routes. `createHttpBackend` (`@ecsplico/editor/adapters/http`) adds the two capabilities that\n// need Yjs and the comments client; `createEditorContext` defaults to this half so no editor bundle carries those.\n// Requests go out through the platform `fetch`; a `$Fetch` (ofetch, Nuxt's `$fetch`) is used only when the host hands one\n// in, so no bundle pulls `ofetch` in unasked (the type import above is erased).\n\nexport interface FetchBackendOptions {\n  /** HTTP client (default: the platform `fetch`); Nuxt hosts pass `useNuxtApp().$fetch` (it resolves relative paths while rendering on the server). */\n  fetch?: $Fetch\n  /** Prefix of every path (`https://api.example.com`); default `''` (same origin). */\n  base?: string\n}\n\n/** One request of the transport: `body` is sent as it is when it is a string or `FormData`, else JSON-serialised; `query` becomes the query string. */\nexport interface HttpRequest {\n  method?: string\n  headers?: Record<string, string>\n  body?: unknown\n  query?: Record<string, string>\n  signal?: AbortSignal | undefined\n}\n\nexport interface HttpTransport {\n  /** Sends the request and resolves with the response whatever its status; rejects only on a network failure or abort. */\n  send: (url: string, request?: HttpRequest) => Promise<Response>\n  /** `response` itself when it is 2xx; otherwise rejects with a `BackendError` (the server's `statusMessage`/`message`, else `HTTP <status>`). */\n  check: (response: Response) => Promise<Response>\n  /** `send` then `check`. */\n  request: (url: string, request?: HttpRequest) => Promise<Response>\n}\n\nfunction platformSend(url: string, { method, headers: extra, body, query, signal }: HttpRequest = {}): Promise<Response> {\n  const headers = new Headers(extra)\n  let payload: BodyInit | undefined\n  if (typeof body === 'string' || (typeof FormData !== 'undefined' && body instanceof FormData)) payload = body\n  else if (body !== undefined) {\n    headers.set('content-type', 'application/json')\n    payload = JSON.stringify(body)\n  }\n  const target = query ? `${url}?${new URLSearchParams(query)}` : url\n  return globalThis.fetch(target, { ...(method && { method }), headers, ...(payload !== undefined && { body: payload }), ...(signal && { signal }) })\n}\n\n/** The request through `fetcher.raw`: the response comes back unread (`stream`), a non-2xx one is a result, not an exception. */\nfunction fetcherSend(fetcher: $Fetch) {\n  return (url: string, { method, headers, body, query, signal }: HttpRequest = {}): Promise<Response> => {\n    const options: FetchOptions<'stream'> = { responseType: 'stream', ignoreResponseError: true }\n    if (method) options.method = method\n    if (headers) options.headers = headers\n    if (body !== undefined) options.body = body as Record<string, unknown>\n    if (query) options.query = query\n    if (signal) options.signal = signal\n    return fetcher.raw(url, options)\n  }\n}\n\n/** The transport of `fetch` (default: the platform `fetch`). */\nexport function createTransport(fetcher?: $Fetch): HttpTransport {\n  const send = fetcher ? fetcherSend(fetcher) : platformSend\n  async function check(response: Response) {\n    if (response.ok) return response\n    let message = `HTTP ${response.status}`\n    try {\n      const json = await response.json() as { statusMessage?: string, message?: string }\n      message = json.statusMessage || json.message || message\n    }\n    catch { /* non-JSON error body */ }\n    throw new BackendError(message, response.status)\n  }\n  return { send, check, request: async (url, request) => check(await send(url, request)) }\n}\n\n/** Drops a response whose body nobody reads, so the connection is released. */\nconst discard = (response: Response) => response.body?.cancel().catch(() => undefined)\n\n/** The event of an SSE block (`event: x\\ndata: {json}`); `data` is `{}` without a payload or with a malformed one. */\nfunction streamEvent(raw: string): AiStreamEvent {\n  let event = 'message'\n  let data = ''\n  for (const line of raw.split('\\n')) {\n    if (line.startsWith('event:')) event = line.slice(6).trim()\n    else if (line.startsWith('data:')) data += line.slice(5).trimStart()\n  }\n  let payload: unknown = {}\n  if (data) {\n    try {\n      payload = JSON.parse(data)\n    }\n    catch {\n      payload = {}\n    }\n  }\n  return { event: event as AiStreamEvent['event'], data: payload }\n}\n\n/** The editor's HTTP routes as an `EditorBackend` without `collaboration` and `comments`. */\nexport function createFetchBackend(options: FetchBackendOptions = {}): EditorBackend {\n  const base = options.base ?? ''\n  const { request, send, check } = createTransport(options.fetch)\n  const editor = (path: string) => `${base}${EDITOR_API}${path}`\n  const ai = (path: string) => `${base}${AI_API}${path}`\n  /** The JSON answer of a request that must succeed. */\n  const json = async <T>(url: string, init?: HttpRequest) => (await request(url, init)).json() as Promise<T>\n  /** A request that must succeed and whose answer is of no interest. */\n  const sent = async (url: string, init?: HttpRequest) => { await discard(await request(url, init)) }\n\n  return {\n    name: 'http',\n    documents: {\n      async load(id) {\n        const response = await send(`${base}${documentUrl(id)}`)\n        if (response.status === 404) {\n          await discard(response)\n          return null\n        }\n        return (await check(response)).json() as Promise<JSONContent>\n      },\n      save: (id, content) => sent(`${base}${documentUrl(id)}`, { method: 'PUT', body: content }),\n    },\n    assets: {\n      upload(documentId, file) {\n        const body = new FormData()\n        body.append('file', file)\n        return json<{ url: string, sha256?: string }>(editor(`/assets/${documentId}`), { method: 'POST', body })\n      },\n    },\n    users: {\n      search: (query, signal) => json<MentionUser[]>(editor('/users'), { query: { q: query }, signal }),\n    },\n    tags: {\n      search: (query, signal) => json<string[]>(editor('/tags'), { query: { q: query }, signal }),\n    },\n    settings: {\n      async load() {\n        const response = await request(editor('/settings'))\n        // 204: the host keeps no settings for this account.\n        return response.status === 200 ? await response.json() as EditorSettings | null : null\n      },\n      save: settings => sent(editor('/settings'), { method: 'PUT', body: settings }),\n    },\n    themes: {\n      list: () => json(editor('/themes')),\n      css: async id => (await request(editor(`/themes/${encodeURIComponent(id)}`))).text(),\n      store({ css, manifest }) {\n        const body = new FormData()\n        body.append('css', css)\n        if (manifest) body.append('manifest', manifest)\n        return json(editor('/themes'), { method: 'POST', body })\n      },\n      async remove(id) {\n        await sent(editor(`/themes/${encodeURIComponent(id)}`), { method: 'DELETE' })\n        return true\n      },\n    },\n    ai: {\n      models: () => json(ai('/models')),\n      complete: (body, signal) => json<{ text: string }>(ai('/complete'), { method: 'POST', body, signal }),\n      async* stream(path, body, signal) {\n        const response = await request(ai(`/${path}`), { method: 'POST', body, signal })\n        if (!response.body) throw new BackendError(`HTTP ${response.status}`, response.status)\n        const reader = response.body.getReader()\n        const decoder = new TextDecoder()\n        let buffer = ''\n        try {\n          while (true) {\n            const { value, done } = await reader.read()\n            if (done) break\n            buffer += decoder.decode(value, { stream: true }).replace(/\\r\\n/g, '\\n')\n            let index = buffer.indexOf('\\n\\n')\n            while (index !== -1) {\n              const event = streamEvent(buffer.slice(0, index))\n              yield event\n              if (event.event === 'done' || event.event === 'error') return\n              buffer = buffer.slice(index + 2)\n              index = buffer.indexOf('\\n\\n')\n            }\n          }\n          if (buffer.trim()) yield streamEvent(buffer)\n        }\n        finally {\n          await reader.cancel().catch(() => undefined)\n        }\n      },\n      transcriptCleanup: (body, signal) => json(ai('/transcript-cleanup'), { method: 'POST', body, signal }),\n      extract: (body, signal) => json<ExtractResponse>(ai('/extract'), { method: 'POST', body, signal }),\n    },\n  }\n}\n"],"mappings":"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"}

package/dist/core/index.d.ts

@@ -1,28 +1,34 @@
-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, TransactionGuard } 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 { TransactionGuards, TransactionGuardsOptions, transactionGuardExtensions } from "./transaction-guards.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 TransactionGuard, TransactionGuards, type TransactionGuardsOptions, 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, transactionGuardExtensions, wrapImportBlocks };

package/dist/core/index.js

@@ -1,27 +1,31 @@
 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 { TransactionGuards, transactionGuardExtensions } from "./transaction-guards.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, TransactionGuards, 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, transactionGuardExtensions, 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