@ecsplico/editor 2.1.1 → 3.0.0

package/dist/core/context.js

@@ -1,8 +1,9 @@
+import { BackendError } from "./backend.js";
 import { createTranslator } from "../i18n/index.js";
 import { parseEditorSettings } from "../settings/index.js";
+import { createFetchBackend } from "./http-backend.js";
 import { silentNotifier } from "./notify.js";
 import { createStore } from "./store.js";
-import { ofetch } from "ofetch";
 //#region src/core/context.ts
 const STORAGE_KEY = "tiptap-editor:settings";
 /** Pause after the last change before the settings are sent to the server (ms). */
@@ -20,19 +21,20 @@ function writeLocal(settings) {
 	} catch {}
 }
 /**
-* The editor context of an app: the settings shared by all editors of the app, and the HTTP client. Framework-free;
+* The editor context of an app: the settings shared by all editors of the app, and the backend. Framework-free;
 * the Vue layer installs it with `app.use(createEditor())`, the React layer provides it through
 * `EditorContextProvider`. The settings are read from localStorage right away (client only) and every change is
-* written back. With `settings.remote`, `GET /api/editor/settings` (on `load()`, which the settings hooks call) answers:
-* `200` replaces them with the user's account settings (`synced`), `204` (the host's adapter keeps no settings), `401`
-* or a network error keep the local ones; once synced every change is also sent to the server (`PUT`, debounced).
-* Subscription and timer stop with `dispose()`.
+* written back. With a backend that offers `settings`, `backend.settings.load()` (on `load()`, which
+* the settings hooks call) answers: the user's account settings replace them (`synced`), `null` (the account has none
+* yet) makes the account take this browser's, a refusal (`401`, `501`) or a network error keeps the local ones; once
+* synced every change is also sent to the backend (`save`, debounced). Subscription and timer stop with `dispose()`.
 */
 function createEditorContext(options = {}) {
-	const fetcher = options.fetch ?? ofetch;
-	const remoteMode = options.settings?.remote === true;
+	const backend = options.backend ?? createFetchBackend();
+	let remoteStore = backend.settings;
+	const remoteMode = remoteStore !== void 0;
 	const settings = createStore(parseEditorSettings(null));
-	const ready = createStore(!remoteMode);
+	const ready = createStore(!remoteMode && backend.ready === void 0);
 	const synced = createStore(false);
 	let loading = false;
 	let loadRemote = () => {};
@@ -49,13 +51,14 @@ function createEditorContext(options = {}) {
 		ready,
 		synced,
 		load,
-		fetch: fetcher,
+		backend,
 		ai: options.ai,
 		notify: options.notify ?? silentNotifier,
 		locale,
 		t,
 		dispose: () => dispose()
 	};
+	if (!remoteMode) backend.ready?.then(() => ready.set(true));
 	if (!("window" in globalThis)) return context;
 	settings.set(readLocal());
 	writeLocal(settings.get());
@@ -68,13 +71,10 @@ function createEditorContext(options = {}) {
 		timer = setTimeout(() => {
 			const json = JSON.stringify(value);
 			if (json === remote) return;
-			fetcher("/api/editor/settings", {
-				method: "PUT",
-				body: value
-			}).then(() => {
+			remoteStore?.save(value).then(() => {
 				remote = json;
 			}).catch((error) => {
-				if (error?.statusCode !== 501) console.warn(`tiptap-editor: ${t("settings.saveFailed")}`, error);
+				if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) console.warn(`tiptap-editor: ${t("settings.saveFailed")}`, error);
 			});
 		}, PUT_DEBOUNCE);
 	}
@@ -87,16 +87,19 @@ function createEditorContext(options = {}) {
 		clearTimeout(timer);
 		unsubscribe();
 	};
-	if (!remoteMode) return context;
-	loadRemote = () => fetcher.raw("/api/editor/settings").then((response) => {
-		if (!active || response.status !== 200) return;
+	if (!remoteStore) return context;
+	loadRemote = () => Promise.resolve(backend.ready).then(() => {
+		remoteStore = backend.settings;
+		return remoteStore?.load();
+	}).then((stored) => {
+		if (!active || !remoteStore) return;
 		synced.set(true);
-		if (response._data) {
-			settings.set(parseEditorSettings(response._data));
+		if (stored) {
+			settings.set(parseEditorSettings(stored));
 			remote = JSON.stringify(settings.get());
 		} else push(settings.get());
 	}).catch((error) => {
-		console.warn(`tiptap-editor: ${t("settings.loadFailed")}`, error);
+		if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) console.warn(`tiptap-editor: ${t("settings.loadFailed")}`, error);
 	}).finally(() => {
 		ready.set(true);
 	});

package/dist/core/context.js.map

@@ -1 +1 @@
-{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["import { type $Fetch, ofetch } from 'ofetch'\nimport { createTranslator, DEFAULT_LOCALE, type Locale, type Messages, type Translate } from '../i18n'\nimport { type EditorSettings, type ModelSlot, parseEditorSettings } from '../settings'\nimport { type Notifier, silentNotifier } from './notify'\nimport { createStore, type ReadonlyStore, type Store } from './store'\n\nconst STORAGE_KEY = 'tiptap-editor:settings'\n/** Pause after the last change before the settings are sent to the server (ms). */\nconst PUT_DEBOUNCE = 500\n\n/** Inert public AI configuration (set by the Nuxt client plugin); only the AI feature reads it. */\nexport interface EditorAiConfig {\n  slots: Record<ModelSlot, string>\n  transcription: boolean\n}\n\nexport interface EditorContextOptions {\n  /** HTTP client of every feature request (default: ofetch). */\n  fetch?: $Fetch\n  settings?: {\n    /** Keep the settings per account through `GET`/`PUT /api/editor/settings`; default false (this browser only). */\n    remote?: boolean\n  }\n  ai?: EditorAiConfig\n  /** Shows app-level notices (e.g. model profiles); default: dropped (`silentNotifier`). */\n  notify?: Notifier\n  /** Language of every string the editor renders (toolbar, slash menu, settings, AI, notices); default `'de'`. Fixed for the life of the context. */\n  locale?: Locale\n  /** Overrides of single messages by key (`{ 'toolbar.bold': 'Strong' }`); the rest comes from the catalog of `locale`. */\n  messages?: Partial<Messages>\n}\n\n/** What `createEditorContext` returns: shared by all editors of an app. One per app: there is no process-global state. */\nexport interface EditorContext {\n  settings: Store<EditorSettings>\n  /** True once the stored settings are usable: immediately in local mode, after the server answered in remote mode. */\n  ready: ReadonlyStore<boolean>\n  /** True once the account's settings from the server are in effect (always false in local mode). */\n  synced: ReadonlyStore<boolean>\n  /**\n   * Starts the account-settings load of remote mode (idempotent, no-op in local mode). The framework layers'\n   * settings hooks call it, so the server is asked only once an editor-side component needs the settings (not on a\n   * login page).\n   */\n  load: () => void\n  fetch: $Fetch\n  ai: EditorAiConfig | undefined\n  /** Notices of app-level models; surfaces hand features their own `FeatureContext.notify`. */\n  notify: Notifier\n  /** The language of the editor's strings (`options.locale`, default `'de'`). */\n  locale: Locale\n  /** Renders a message of the catalog (with the host's `messages` applied): `t('toolbar.bold')`, `t('ai.run', { task })`. */\n  t: Translate\n  /** Stops the persistence (store subscription and pending server write); call when the app goes away. */\n  dispose: () => void\n}\n\nfunction readLocal(): EditorSettings {\n  try {\n    // Also migrates the flat `{ headingConversionScope }` of the per-browser settings before version 1.\n    return parseEditorSettings(JSON.parse(localStorage.getItem(STORAGE_KEY) ?? 'null'))\n  }\n  catch {\n    // Unreadable or corrupt (or no) storage: the defaults.\n    return parseEditorSettings(null)\n  }\n}\n\nfunction writeLocal(settings: EditorSettings) {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(settings))\n  }\n  catch {\n    // Storage unavailable (e.g. privacy mode): the settings last for this session only.\n  }\n}\n\n/**\n * The editor context of an app: the settings shared by all editors of the app, and the HTTP client. Framework-free;\n * the Vue layer installs it with `app.use(createEditor())`, the React layer provides it through\n * `EditorContextProvider`. The settings are read from localStorage right away (client only) and every change is\n * written back. With `settings.remote`, `GET /api/editor/settings` (on `load()`, which the settings hooks call) answers:\n * `200` replaces them with the user's account settings (`synced`), `204` (the host's adapter keeps no settings), `401`\n * or a network error keep the local ones; once synced every change is also sent to the server (`PUT`, debounced).\n * Subscription and timer stop with `dispose()`.\n */\nexport function createEditorContext(options: EditorContextOptions = {}): EditorContext {\n  const fetcher = options.fetch ?? ofetch\n  const remoteMode = options.settings?.remote === true\n  const settings = createStore<EditorSettings>(parseEditorSettings(null))\n  const ready = createStore(!remoteMode)\n  const synced = createStore(false)\n  let loading = false\n  let loadRemote = () => {}\n  const load = () => {\n    if (loading) return\n    loading = true\n    loadRemote()\n  }\n  let dispose = () => {}\n  const locale = options.locale ?? DEFAULT_LOCALE\n  const t = createTranslator(locale, options.messages)\n  const context: EditorContext = { settings, ready, synced, load, fetch: fetcher, ai: options.ai, notify: options.notify ?? silentNotifier, locale, t, dispose: () => dispose() }\n  // No browser storage (server render): defaults, nothing to persist.\n  if (!('window' in globalThis)) return context\n\n  settings.set(readLocal())\n  writeLocal(settings.get())\n\n  /** JSON of the settings the server holds, so values that came from it are not sent back. */\n  let remote = ''\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let active = true\n  function push(value: EditorSettings) {\n    clearTimeout(timer)\n    timer = setTimeout(() => {\n      const json = JSON.stringify(value)\n      if (json === remote) return\n      fetcher('/api/editor/settings', { method: 'PUT', body: value })\n        .then(() => { remote = json })\n        .catch((error: unknown) => {\n          // 501: the adapter stores no settings; nothing to report.\n          if ((error as { statusCode?: unknown } | null)?.statusCode !== 501) {\n            console.warn(`tiptap-editor: ${t('settings.saveFailed')}`, error)\n          }\n        })\n    }, PUT_DEBOUNCE)\n  }\n\n  const unsubscribe = settings.subscribe((value) => {\n    writeLocal(value)\n    if (synced.get()) push(value)\n  })\n  dispose = () => {\n    active = false\n    clearTimeout(timer)\n    unsubscribe()\n  }\n\n  if (!remoteMode) return context\n  loadRemote = () => fetcher.raw<EditorSettings | null>('/api/editor/settings')\n    .then((response) => {\n      if (!active || response.status !== 200) return\n      synced.set(true)\n      if (response._data) {\n        settings.set(parseEditorSettings(response._data))\n        remote = JSON.stringify(settings.get())\n      }\n      // The account has no settings yet: it takes this browser's.\n      else push(settings.get())\n    })\n    .catch((error: unknown) => {\n      console.warn(`tiptap-editor: ${t('settings.loadFailed')}`, error)\n    })\n    .finally(() => { ready.set(true) })\n  return context\n}\n"],"mappings":";;;;;;AAMA,MAAM,cAAc;;AAEpB,MAAM,eAAe;AAiDrB,SAAS,YAA4B;CACnC,IAAI;EAEF,OAAO,oBAAoB,KAAK,MAAM,aAAa,QAAQ,WAAW,KAAK,MAAM,CAAC;CACpF,QACM;EAEJ,OAAO,oBAAoB,IAAI;CACjC;AACF;AAEA,SAAS,WAAW,UAA0B;CAC5C,IAAI;EACF,aAAa,QAAQ,aAAa,KAAK,UAAU,QAAQ,CAAC;CAC5D,QACM,CAEN;AACF;;;;;;;;;;AAWA,SAAgB,oBAAoB,UAAgC,CAAC,GAAkB;CACrF,MAAM,UAAU,QAAQ,SAAS;CACjC,MAAM,aAAa,QAAQ,UAAU,WAAW;CAChD,MAAM,WAAW,YAA4B,oBAAoB,IAAI,CAAC;CACtE,MAAM,QAAQ,YAAY,CAAC,UAAU;CACrC,MAAM,SAAS,YAAY,KAAK;CAChC,IAAI,UAAU;CACd,IAAI,mBAAmB,CAAC;CACxB,MAAM,aAAa;EACjB,IAAI,SAAS;EACb,UAAU;EACV,WAAW;CACb;CACA,IAAI,gBAAgB,CAAC;CACrB,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,QAAQ;CACnD,MAAM,UAAyB;EAAE;EAAU;EAAO;EAAQ;EAAM,OAAO;EAAS,IAAI,QAAQ;EAAI,QAAQ,QAAQ,UAAU;EAAgB;EAAQ;EAAG,eAAe,QAAQ;CAAE;CAE9K,IAAI,EAAE,YAAY,aAAa,OAAO;CAEtC,SAAS,IAAI,UAAU,CAAC;CACxB,WAAW,SAAS,IAAI,CAAC;;CAGzB,IAAI,SAAS;CACb,IAAI;CACJ,IAAI,SAAS;CACb,SAAS,KAAK,OAAuB;EACnC,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,OAAO,KAAK,UAAU,KAAK;GACjC,IAAI,SAAS,QAAQ;GACrB,QAAQ,wBAAwB;IAAE,QAAQ;IAAO,MAAM;GAAM,CAAC,CAAC,CAC5D,WAAW;IAAE,SAAS;GAAK,CAAC,CAAC,CAC7B,OAAO,UAAmB;IAEzB,IAAK,OAA2C,eAAe,KAC7D,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;GAEpE,CAAC;EACL,GAAG,YAAY;CACjB;CAEA,MAAM,cAAc,SAAS,WAAW,UAAU;EAChD,WAAW,KAAK;EAChB,IAAI,OAAO,IAAI,GAAG,KAAK,KAAK;CAC9B,CAAC;CACD,gBAAgB;EACd,SAAS;EACT,aAAa,KAAK;EAClB,YAAY;CACd;CAEA,IAAI,CAAC,YAAY,OAAO;CACxB,mBAAmB,QAAQ,IAA2B,sBAAsB,CAAC,CAC1E,MAAM,aAAa;EAClB,IAAI,CAAC,UAAU,SAAS,WAAW,KAAK;EACxC,OAAO,IAAI,IAAI;EACf,IAAI,SAAS,OAAO;GAClB,SAAS,IAAI,oBAAoB,SAAS,KAAK,CAAC;GAChD,SAAS,KAAK,UAAU,SAAS,IAAI,CAAC;EACxC,OAEK,KAAK,SAAS,IAAI,CAAC;CAC1B,CAAC,CAAC,CACD,OAAO,UAAmB;EACzB,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;CAClE,CAAC,CAAC,CACD,cAAc;EAAE,MAAM,IAAI,IAAI;CAAE,CAAC;CACpC,OAAO;AACT"}
+{"version":3,"file":"context.js","names":[],"sources":["../../src/core/context.ts"],"sourcesContent":["import type { EditorPublicConfig } from '../config'\nimport { createTranslator, DEFAULT_LOCALE, type Locale, type Messages, type Translate } from '../i18n'\nimport { type EditorSettings, parseEditorSettings } from '../settings'\nimport { BackendError, type EditorBackend } from './backend'\nimport { createFetchBackend } from './http-backend'\nimport { type Notifier, silentNotifier } from './notify'\nimport { createStore, type ReadonlyStore, type Store } from './store'\n\nconst STORAGE_KEY = 'tiptap-editor:settings'\n/** Pause after the last change before the settings are sent to the server (ms). */\nconst PUT_DEBOUNCE = 500\n\n/** Inert public AI configuration (set by the Nuxt client plugin); only the AI feature reads it. Defined with the public config view. */\nexport type EditorAiConfig = EditorPublicConfig['ai']\n\nexport interface EditorContextOptions {\n  /**\n   * Where documents, uploads, mention lookups, settings, themes and AI come from (default: the HTTP routes of the Nuxt\n   * module over the platform `fetch`, `createFetchBackend`). A backend that offers `settings` keeps the settings per\n   * account (`backend.settings`); without it they stay in this browser.\n   */\n  backend?: EditorBackend\n  ai?: EditorAiConfig\n  /** Shows app-level notices (e.g. model profiles); default: dropped (`silentNotifier`). */\n  notify?: Notifier\n  /** Language of every string the editor renders (toolbar, slash menu, settings, AI, notices); default `'de'`. Fixed for the life of the context. */\n  locale?: Locale\n  /** Overrides of single messages by key (`{ 'toolbar.bold': 'Strong' }`); the rest comes from the catalog of `locale`. */\n  messages?: Partial<Messages>\n}\n\n/** What `createEditorContext` returns: shared by all editors of an app. One per app: there is no process-global state. */\nexport interface EditorContext {\n  settings: Store<EditorSettings>\n  /** True once the stored settings are usable: immediately in local mode, after the server answered in remote mode. */\n  ready: ReadonlyStore<boolean>\n  /** True once the account's settings from the server are in effect (always false in local mode). */\n  synced: ReadonlyStore<boolean>\n  /**\n   * Starts the account-settings load of remote mode (idempotent, no-op in local mode). The framework layers'\n   * settings hooks call it, so the server is asked only once an editor-side component needs the settings (not on a\n   * login page).\n   */\n  load: () => void\n  backend: EditorBackend\n  ai: EditorAiConfig | undefined\n  /** Notices of app-level models; surfaces hand features their own `FeatureContext.notify`. */\n  notify: Notifier\n  /** The language of the editor's strings (`options.locale`, default `'de'`). */\n  locale: Locale\n  /** Renders a message of the catalog (with the host's `messages` applied): `t('toolbar.bold')`, `t('ai.run', { task })`. */\n  t: Translate\n  /** Stops the persistence (store subscription and pending server write); call when the app goes away. */\n  dispose: () => void\n}\n\nfunction readLocal(): EditorSettings {\n  try {\n    // Also migrates the flat `{ headingConversionScope }` of the per-browser settings before version 1.\n    return parseEditorSettings(JSON.parse(localStorage.getItem(STORAGE_KEY) ?? 'null'))\n  }\n  catch {\n    // Unreadable or corrupt (or no) storage: the defaults.\n    return parseEditorSettings(null)\n  }\n}\n\nfunction writeLocal(settings: EditorSettings) {\n  try {\n    localStorage.setItem(STORAGE_KEY, JSON.stringify(settings))\n  }\n  catch {\n    // Storage unavailable (e.g. privacy mode): the settings last for this session only.\n  }\n}\n\n/**\n * The editor context of an app: the settings shared by all editors of the app, and the backend. Framework-free;\n * the Vue layer installs it with `app.use(createEditor())`, the React layer provides it through\n * `EditorContextProvider`. The settings are read from localStorage right away (client only) and every change is\n * written back. With a backend that offers `settings`, `backend.settings.load()` (on `load()`, which\n * the settings hooks call) answers: the user's account settings replace them (`synced`), `null` (the account has none\n * yet) makes the account take this browser's, a refusal (`401`, `501`) or a network error keeps the local ones; once\n * synced every change is also sent to the backend (`save`, debounced). Subscription and timer stop with `dispose()`.\n */\nexport function createEditorContext(options: EditorContextOptions = {}): EditorContext {\n  const backend = options.backend ?? createFetchBackend()\n  // `let`: a probing backend (`backend.ready`) may drop `settings` before the first load.\n  let remoteStore = backend.settings\n  const remoteMode = remoteStore !== undefined\n  const settings = createStore<EditorSettings>(parseEditorSettings(null))\n  const ready = createStore(!remoteMode && backend.ready === undefined)\n  const synced = createStore(false)\n  let loading = false\n  let loadRemote = () => {}\n  const load = () => {\n    if (loading) return\n    loading = true\n    loadRemote()\n  }\n  let dispose = () => {}\n  const locale = options.locale ?? DEFAULT_LOCALE\n  const t = createTranslator(locale, options.messages)\n  const context: EditorContext = { settings, ready, synced, load, backend, ai: options.ai, notify: options.notify ?? silentNotifier, locale, t, dispose: () => dispose() }\n  // Local mode: ready once the backend knows its capabilities (remote mode: after the settings load, which waits for it).\n  if (!remoteMode) void backend.ready?.then(() => ready.set(true))\n  // No browser storage (server render): defaults, nothing to persist.\n  if (!('window' in globalThis)) return context\n\n  settings.set(readLocal())\n  writeLocal(settings.get())\n\n  /** JSON of the settings the server holds, so values that came from it are not sent back. */\n  let remote = ''\n  let timer: ReturnType<typeof setTimeout> | undefined\n  let active = true\n  function push(value: EditorSettings) {\n    clearTimeout(timer)\n    timer = setTimeout(() => {\n      const json = JSON.stringify(value)\n      if (json === remote) return\n      remoteStore?.save(value)\n        .then(() => { remote = json })\n        .catch((error: unknown) => {\n          // 501/404: the host serves no settings (no `settings` port, so no route); nothing to report.\n          if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n            console.warn(`tiptap-editor: ${t('settings.saveFailed')}`, error)\n          }\n        })\n    }, PUT_DEBOUNCE)\n  }\n\n  const unsubscribe = settings.subscribe((value) => {\n    writeLocal(value)\n    if (synced.get()) push(value)\n  })\n  dispose = () => {\n    active = false\n    clearTimeout(timer)\n    unsubscribe()\n  }\n\n  if (!remoteStore) return context\n  loadRemote = () => Promise.resolve(backend.ready)\n    .then(() => {\n      remoteStore = backend.settings\n      return remoteStore?.load()\n    })\n    .then((stored) => {\n      // The probe dropped `settings` (the server keeps none): the account has no settings, the local ones stay.\n      if (!active || !remoteStore) return\n      synced.set(true)\n      if (stored) {\n        settings.set(parseEditorSettings(stored))\n        remote = JSON.stringify(settings.get())\n      }\n      // The account has no settings yet: it takes this browser's.\n      else push(settings.get())\n    })\n    .catch((error: unknown) => {\n      // 501/404: the host serves no settings; the local ones stay and there is nothing to report.\n      if (!(error instanceof BackendError && (error.status === 501 || error.status === 404))) {\n        console.warn(`tiptap-editor: ${t('settings.loadFailed')}`, error)\n      }\n    })\n    .finally(() => { ready.set(true) })\n  return context\n}\n"],"mappings":";;;;;;;AAQA,MAAM,cAAc;;AAEpB,MAAM,eAAe;AA8CrB,SAAS,YAA4B;CACnC,IAAI;EAEF,OAAO,oBAAoB,KAAK,MAAM,aAAa,QAAQ,WAAW,KAAK,MAAM,CAAC;CACpF,QACM;EAEJ,OAAO,oBAAoB,IAAI;CACjC;AACF;AAEA,SAAS,WAAW,UAA0B;CAC5C,IAAI;EACF,aAAa,QAAQ,aAAa,KAAK,UAAU,QAAQ,CAAC;CAC5D,QACM,CAEN;AACF;;;;;;;;;;AAWA,SAAgB,oBAAoB,UAAgC,CAAC,GAAkB;CACrF,MAAM,UAAU,QAAQ,WAAW,mBAAmB;CAEtD,IAAI,cAAc,QAAQ;CAC1B,MAAM,aAAa,gBAAgB,KAAA;CACnC,MAAM,WAAW,YAA4B,oBAAoB,IAAI,CAAC;CACtE,MAAM,QAAQ,YAAY,CAAC,cAAc,QAAQ,UAAU,KAAA,CAAS;CACpE,MAAM,SAAS,YAAY,KAAK;CAChC,IAAI,UAAU;CACd,IAAI,mBAAmB,CAAC;CACxB,MAAM,aAAa;EACjB,IAAI,SAAS;EACb,UAAU;EACV,WAAW;CACb;CACA,IAAI,gBAAgB,CAAC;CACrB,MAAM,SAAS,QAAQ,UAAA;CACvB,MAAM,IAAI,iBAAiB,QAAQ,QAAQ,QAAQ;CACnD,MAAM,UAAyB;EAAE;EAAU;EAAO;EAAQ;EAAM;EAAS,IAAI,QAAQ;EAAI,QAAQ,QAAQ,UAAU;EAAgB;EAAQ;EAAG,eAAe,QAAQ;CAAE;CAEvK,IAAI,CAAC,YAAY,QAAa,OAAO,WAAW,MAAM,IAAI,IAAI,CAAC;CAE/D,IAAI,EAAE,YAAY,aAAa,OAAO;CAEtC,SAAS,IAAI,UAAU,CAAC;CACxB,WAAW,SAAS,IAAI,CAAC;;CAGzB,IAAI,SAAS;CACb,IAAI;CACJ,IAAI,SAAS;CACb,SAAS,KAAK,OAAuB;EACnC,aAAa,KAAK;EAClB,QAAQ,iBAAiB;GACvB,MAAM,OAAO,KAAK,UAAU,KAAK;GACjC,IAAI,SAAS,QAAQ;GACrB,aAAa,KAAK,KAAK,CAAC,CACrB,WAAW;IAAE,SAAS;GAAK,CAAC,CAAC,CAC7B,OAAO,UAAmB;IAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;GAEpE,CAAC;EACL,GAAG,YAAY;CACjB;CAEA,MAAM,cAAc,SAAS,WAAW,UAAU;EAChD,WAAW,KAAK;EAChB,IAAI,OAAO,IAAI,GAAG,KAAK,KAAK;CAC9B,CAAC;CACD,gBAAgB;EACd,SAAS;EACT,aAAa,KAAK;EAClB,YAAY;CACd;CAEA,IAAI,CAAC,aAAa,OAAO;CACzB,mBAAmB,QAAQ,QAAQ,QAAQ,KAAK,CAAC,CAC9C,WAAW;EACV,cAAc,QAAQ;EACtB,OAAO,aAAa,KAAK;CAC3B,CAAC,CAAC,CACD,MAAM,WAAW;EAEhB,IAAI,CAAC,UAAU,CAAC,aAAa;EAC7B,OAAO,IAAI,IAAI;EACf,IAAI,QAAQ;GACV,SAAS,IAAI,oBAAoB,MAAM,CAAC;GACxC,SAAS,KAAK,UAAU,SAAS,IAAI,CAAC;EACxC,OAEK,KAAK,SAAS,IAAI,CAAC;CAC1B,CAAC,CAAC,CACD,OAAO,UAAmB;EAEzB,IAAI,EAAE,iBAAiB,iBAAiB,MAAM,WAAW,OAAO,MAAM,WAAW,OAC/E,QAAQ,KAAK,kBAAkB,EAAE,qBAAqB,KAAK,KAAK;CAEpE,CAAC,CAAC,CACD,cAAc;EAAE,MAAM,IAAI,IAAI;CAAE,CAAC;CACpC,OAAO;AACT"}

package/dist/core/core-feature.d.ts

@@ -4,14 +4,29 @@ import { EditorFeature, FeatureContext } from "./feature.js";
 /** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */
 export declare const coreBlockActions: (ctx: FeatureContext) => readonly BlockAction[];
 /**
- * The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim
- * `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),
- * BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the
- * `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar
- * groups, and the duplicate/delete/convert block actions.
- * StarterKit's undo history is off when a collaboration session brings its own.
+ * The content base of every editor: StarterKit with StrikeX, block IDs and node flags, the verbatim `OpaqueFence` for
+ * Markdown fences of unknown kinds, Markdown, abilities and metadata infrastructure and the standard conversions.
+ * StarterKit's undo history is off when a collaboration session brings its own. Its `schemaExtensions` are the base
+ * of the server schema (`schemaExtensionsOf` appends `BlockId`). A headless editor (Markdown conversion, viewer,
+ * validation) is `coreContentFeature()` plus other features without `coreUiFeature()`.
  * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
  */
-export declare function coreFeature(): EditorFeature<never>;
+export declare function coreContentFeature(): EditorFeature<never>;
+/**
+ * What a framework layer binds to `core-ui`: the ⌘K palette component, mounted as an overlay of the surface (it reads
+ * `ui.paletteOpen` and the editor's commands; `EditorCommandPalette` of `/vue` and `/react`). `C` is the layer's component type.
+ */
+export interface CoreUi<C> {
+  palette: C;
+}
+/**
+ * The editing UX of a simple editor: Placeholder (marks empty textblocks `is-empty`), BlockFlash (`revealBlock`),
+ * BlockConvert, local DocAnchors, the `/` menu (the commands with a `slash` placement: the block types here, more from
+ * other features and the host), the undo/redo, formatting and block commands with their toolbar groups, and the
+ * duplicate/delete/convert block actions. Needs `core-content`.
+ * Given `ui` (the framework layer's palette component) it also has the ⌘K command palette: Mod-k and the overlay.
+ * Without `ui` it contributes no components (`EditorFeature<never>`), so it fits a headless preset of any framework layer.
+ */
+export declare function coreUiFeature<C = never>(ui?: CoreUi<C>): EditorFeature<C>;
 //#endregion
 //# sourceMappingURL=core-feature.d.ts.map

package/dist/core/core-feature.js

@@ -1,16 +1,18 @@
 import { ABILITY } from "./schema/abilities.js";
 import { Abilities } from "./abilities.js";
+import { Metadata } from "./metadata.js";
 import { BlockId } from "./schema/block-ids.js";
 import { NodeFlags } from "./schema/node-flags.js";
 import { BlockConvert, convertMenuItems, coreConversions } from "./block-convert.js";
 import { BlockFlash } from "./block-flash.js";
 import { DocAnchors } from "./doc-anchors.js";
 import { DocumentMarkdown } from "./document-markdown.js";
-import { Metadata } from "./metadata.js";
 import { OpaqueFence } from "./schema/opaque-fence.js";
 import { StrikeX } from "./schema/strike.js";
+import { coreContentSchemaExtensions } from "./schema/index.js";
 import { SlashCommand } from "./slash.js";
-import { coreToolbarGroups } from "./toolbar-items.js";
+import { CORE_TOOLBAR_GROUPS, coreCommands } from "./toolbar-items.js";
+import { Extension } from "@tiptap/core";
 import { Placeholder } from "@tiptap/extensions";
 import StarterKit from "@tiptap/starter-kit";
 //#region src/core/core-feature.ts
@@ -48,17 +50,18 @@ const coreBlockActions = (ctx) => [
 	}
 ];
 /**
-* The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim
-* `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),
-* BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the
-* `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar
-* groups, and the duplicate/delete/convert block actions.
-* StarterKit's undo history is off when a collaboration session brings its own.
+* The content base of every editor: StarterKit with StrikeX, block IDs and node flags, the verbatim `OpaqueFence` for
+* Markdown fences of unknown kinds, Markdown, abilities and metadata infrastructure and the standard conversions.
+* StarterKit's undo history is off when a collaboration session brings its own. Its `schemaExtensions` are the base
+* of the server schema (`schemaExtensionsOf` appends `BlockId`). A headless editor (Markdown conversion, viewer,
+* validation) is `coreContentFeature()` plus other features without `coreUiFeature()`.
 * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.
 */
-function coreFeature() {
+function coreContentFeature() {
 	return {
-		id: "core",
+		id: "core-content",
+		dimension: "content",
+		schemaExtensions: coreContentSchemaExtensions,
 		extensions: (ctx) => [
 			Abilities.configure(ctx.abilities),
 			StarterKit.configure({
@@ -72,29 +75,59 @@ function coreFeature() {
 			StrikeX,
 			NodeFlags,
 			OpaqueFence,
+			Metadata.configure({ registry: ctx.metadata }),
+			BlockId,
+			DocumentMarkdown
+		],
+		conversions: [coreConversions]
+	};
+}
+/** Mod-k toggles the palette of this editor's surface. */
+function paletteShortcut(ctx) {
+	return Extension.create({
+		name: "commandPaletteShortcut",
+		addKeyboardShortcuts: () => ({ "Mod-k": () => {
+			ctx.ui.togglePalette();
+			return true;
+		} })
+	});
+}
+/**
+* The editing UX of a simple editor: Placeholder (marks empty textblocks `is-empty`), BlockFlash (`revealBlock`),
+* BlockConvert, local DocAnchors, the `/` menu (the commands with a `slash` placement: the block types here, more from
+* other features and the host), the undo/redo, formatting and block commands with their toolbar groups, and the
+* duplicate/delete/convert block actions. Needs `core-content`.
+* Given `ui` (the framework layer's palette component) it also has the ⌘K command palette: Mod-k and the overlay.
+* Without `ui` it contributes no components (`EditorFeature<never>`), so it fits a headless preset of any framework layer.
+*/
+function coreUiFeature(ui) {
+	return {
+		id: "core-ui",
+		dimension: "interaction",
+		requires: ["core-content"],
+		extensions: (ctx) => [
 			Placeholder.configure({
 				includeChildren: true,
 				showOnlyCurrent: false,
 				placeholder: ""
 			}),
-			Metadata.configure({ registry: ctx.metadata }),
 			SlashCommand.configure({
-				items: ctx.slashCommands(),
+				commands: ctx.commands(),
 				emptyText: ctx.t("slash.empty"),
 				loadingText: ctx.t("common.loading")
 			}),
-			BlockId,
-			DocumentMarkdown,
 			BlockFlash,
 			BlockConvert,
-			DocAnchors.configure({ resolver: ctx.anchorResolver })
+			DocAnchors.configure({ resolver: ctx.anchorResolver }),
+			...ui ? [paletteShortcut(ctx)] : []
 		],
-		toolbar: (ctx) => coreToolbarGroups(ctx),
+		toolbarGroups: CORE_TOOLBAR_GROUPS,
+		commands: coreCommands,
 		blockActions: (ctx) => [...coreBlockActions(ctx)],
-		conversions: [coreConversions]
+		...ui && { overlays: [ui.palette] }
 	};
 }
 //#endregion
-export { coreBlockActions, coreFeature };
+export { coreBlockActions, coreContentFeature, coreUiFeature };
 
 //# sourceMappingURL=core-feature.js.map

package/dist/core/core-feature.js.map

@@ -1 +1 @@
-{"version":3,"file":"core-feature.js","names":[],"sources":["../../src/core/core-feature.ts"],"sourcesContent":["import { Placeholder } from '@tiptap/extensions'\nimport StarterKit from '@tiptap/starter-kit'\nimport { Abilities } from './abilities'\nimport { BlockConvert, coreConversions, convertMenuItems } from './block-convert'\nimport { BlockFlash } from './block-flash'\nimport { DocAnchors } from './doc-anchors'\nimport { DocumentMarkdown } from './document-markdown'\nimport type { BlockAction } from './extension-points'\nimport type { EditorFeature, FeatureContext } from './feature'\nimport { Metadata } from './metadata'\nimport { ABILITY } from './schema/abilities'\nimport { BlockId } from './schema/block-ids'\nimport { NodeFlags } from './schema/node-flags'\nimport { OpaqueFence } from './schema/opaque-fence'\nimport { StrikeX } from './schema/strike'\nimport { SlashCommand } from './slash'\nimport { coreToolbarGroups } from './toolbar-items'\n\n/** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */\nexport const coreBlockActions = (ctx: FeatureContext): readonly BlockAction[] => [\n  {\n    id: 'convert',\n    label: ctx.t('block.convert'),\n    icon: 'i-lucide-replace',\n    ability: ABILITY.blockConvert,\n    order: 1000,\n    menu: ({ editor, node, pos }) => convertMenuItems(editor, { node, pos }, ctx.t),\n  },\n  {\n    id: 'duplicate',\n    label: ctx.t('block.duplicate'),\n    icon: 'i-lucide-copy',\n    ability: ABILITY.blockDuplicate,\n    order: 1010,\n    // BlockId's dedupe plugin gives the copy (and every block nested in it) fresh ids.\n    run: ({ editor, node, pos }) => editor.chain().insertContentAt(pos + node.nodeSize, node.toJSON()).run(),\n  },\n  {\n    id: 'delete',\n    label: ctx.t('block.delete'),\n    icon: 'i-lucide-trash-2',\n    ability: ABILITY.blockDelete,\n    order: 1020,\n    run: ({ editor, node, pos }) => editor.chain().focus().deleteRange({ from: pos, to: pos + node.nodeSize }).run(),\n  },\n]\n\n/**\n * The base of every editor, and all a simple editor is: StarterKit with StrikeX, block IDs and node flags, the verbatim\n * `OpaqueFence` for Markdown fences of unknown kinds, Markdown, Placeholder (marks empty textblocks `is-empty`),\n * BlockFlash (`revealBlock`), local DocAnchors, abilities and metadata infrastructure, the standard conversions, the\n * `/` menu (without commands of its own: hosts and other features fill it), the undo/redo, formatting and block toolbar\n * groups, and the duplicate/delete/convert block actions.\n * StarterKit's undo history is off when a collaboration session brings its own.\n * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.\n */\nexport function coreFeature(): EditorFeature<never> {\n  return {\n    id: 'core',\n    extensions: ctx => [\n      Abilities.configure(ctx.abilities),\n      StarterKit.configure({ strike: false, undoRedo: ctx.collaboration ? false : undefined, dropcursor: { color: 'var(--sk-primary)', width: 2 } }),\n      StrikeX,\n      NodeFlags,\n      OpaqueFence,\n      Placeholder.configure({ includeChildren: true, showOnlyCurrent: false, placeholder: '' }),\n      Metadata.configure({ registry: ctx.metadata }),\n      SlashCommand.configure({ items: ctx.slashCommands(), emptyText: ctx.t('slash.empty'), loadingText: ctx.t('common.loading') }),\n      BlockId,\n      DocumentMarkdown,\n      BlockFlash,\n      BlockConvert,\n      DocAnchors.configure({ resolver: ctx.anchorResolver }),\n    ],\n    toolbar: ctx => coreToolbarGroups(ctx),\n    blockActions: ctx => [...coreBlockActions(ctx)],\n    conversions: [coreConversions],\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAmBA,MAAa,oBAAoB,QAAgD;CAC/E;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,eAAe;EAC5B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,OAAO,EAAE,QAAQ,MAAM,UAAU,iBAAiB,QAAQ;GAAE;GAAM;EAAI,GAAG,IAAI,CAAC;CAChF;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,iBAAiB;EAC9B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EAEP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,gBAAgB,MAAM,KAAK,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI;CACzG;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,cAAc;EAC3B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;GAAE,MAAM;GAAK,IAAI,MAAM,KAAK;EAAS,CAAC,CAAC,CAAC,IAAI;CACjH;AACF;;;;;;;;;;AAWA,SAAgB,cAAoC;CAClD,OAAO;EACL,IAAI;EACJ,aAAY,QAAO;GACjB,UAAU,UAAU,IAAI,SAAS;GACjC,WAAW,UAAU;IAAE,QAAQ;IAAO,UAAU,IAAI,gBAAgB,QAAQ,KAAA;IAAW,YAAY;KAAE,OAAO;KAAqB,OAAO;IAAE;GAAE,CAAC;GAC7I;GACA;GACA;GACA,YAAY,UAAU;IAAE,iBAAiB;IAAM,iBAAiB;IAAO,aAAa;GAAG,CAAC;GACxF,SAAS,UAAU,EAAE,UAAU,IAAI,SAAS,CAAC;GAC7C,aAAa,UAAU;IAAE,OAAO,IAAI,cAAc;IAAG,WAAW,IAAI,EAAE,aAAa;IAAG,aAAa,IAAI,EAAE,gBAAgB;GAAE,CAAC;GAC5H;GACA;GACA;GACA;GACA,WAAW,UAAU,EAAE,UAAU,IAAI,eAAe,CAAC;EACvD;EACA,UAAS,QAAO,kBAAkB,GAAG;EACrC,eAAc,QAAO,CAAC,GAAG,iBAAiB,GAAG,CAAC;EAC9C,aAAa,CAAC,eAAe;CAC/B;AACF"}
+{"version":3,"file":"core-feature.js","names":[],"sources":["../../src/core/core-feature.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport { Placeholder } from '@tiptap/extensions'\nimport StarterKit from '@tiptap/starter-kit'\nimport { Abilities } from './abilities'\nimport { BlockConvert, coreConversions, convertMenuItems } from './block-convert'\nimport { BlockFlash } from './block-flash'\nimport { DocAnchors } from './doc-anchors'\nimport { DocumentMarkdown } from './document-markdown'\nimport type { BlockAction } from './extension-points'\nimport type { EditorFeature, FeatureContext } from './feature'\nimport { Metadata } from './metadata'\nimport { coreContentSchemaExtensions } from './schema'\nimport { ABILITY } from './schema/abilities'\nimport { BlockId } from './schema/block-ids'\nimport { NodeFlags } from './schema/node-flags'\nimport { OpaqueFence } from './schema/opaque-fence'\nimport { StrikeX } from './schema/strike'\nimport { SlashCommand } from './slash'\nimport { CORE_TOOLBAR_GROUPS, coreCommands } from './toolbar-items'\n\n/** Hover actions every editor with block UI has: „Umwandeln in …“, duplicate, delete (in this order, after features' own). */\nexport const coreBlockActions = (ctx: FeatureContext): readonly BlockAction[] => [\n  {\n    id: 'convert',\n    label: ctx.t('block.convert'),\n    icon: 'i-lucide-replace',\n    ability: ABILITY.blockConvert,\n    order: 1000,\n    menu: ({ editor, node, pos }) => convertMenuItems(editor, { node, pos }, ctx.t),\n  },\n  {\n    id: 'duplicate',\n    label: ctx.t('block.duplicate'),\n    icon: 'i-lucide-copy',\n    ability: ABILITY.blockDuplicate,\n    order: 1010,\n    // BlockId's dedupe plugin gives the copy (and every block nested in it) fresh ids.\n    run: ({ editor, node, pos }) => editor.chain().insertContentAt(pos + node.nodeSize, node.toJSON()).run(),\n  },\n  {\n    id: 'delete',\n    label: ctx.t('block.delete'),\n    icon: 'i-lucide-trash-2',\n    ability: ABILITY.blockDelete,\n    order: 1020,\n    run: ({ editor, node, pos }) => editor.chain().focus().deleteRange({ from: pos, to: pos + node.nodeSize }).run(),\n  },\n]\n\n/**\n * The content base of every editor: StarterKit with StrikeX, block IDs and node flags, the verbatim `OpaqueFence` for\n * Markdown fences of unknown kinds, Markdown, abilities and metadata infrastructure and the standard conversions.\n * StarterKit's undo history is off when a collaboration session brings its own. Its `schemaExtensions` are the base\n * of the server schema (`schemaExtensionsOf` appends `BlockId`). A headless editor (Markdown conversion, viewer,\n * validation) is `coreContentFeature()` plus other features without `coreUiFeature()`.\n * Contributes no components (`EditorFeature<never>`), so it fits a preset of any framework layer.\n */\nexport function coreContentFeature(): EditorFeature<never> {\n  return {\n    id: 'core-content',\n    dimension: 'content',\n    schemaExtensions: coreContentSchemaExtensions,\n    extensions: ctx => [\n      Abilities.configure(ctx.abilities),\n      StarterKit.configure({ strike: false, undoRedo: ctx.collaboration ? false : undefined, dropcursor: { color: 'var(--sk-primary)', width: 2 } }),\n      StrikeX,\n      NodeFlags,\n      OpaqueFence,\n      Metadata.configure({ registry: ctx.metadata }),\n      BlockId,\n      DocumentMarkdown,\n    ],\n    conversions: [coreConversions],\n  }\n}\n\n/**\n * What a framework layer binds to `core-ui`: the ⌘K palette component, mounted as an overlay of the surface (it reads\n * `ui.paletteOpen` and the editor's commands; `EditorCommandPalette` of `/vue` and `/react`). `C` is the layer's component type.\n */\nexport interface CoreUi<C> {\n  palette: C\n}\n\n/** Mod-k toggles the palette of this editor's surface. */\nfunction paletteShortcut(ctx: FeatureContext): AnyExtension {\n  return Extension.create({\n    name: 'commandPaletteShortcut',\n    addKeyboardShortcuts: () => ({\n      'Mod-k': () => {\n        ctx.ui.togglePalette()\n        return true\n      },\n    }),\n  })\n}\n\n/**\n * The editing UX of a simple editor: Placeholder (marks empty textblocks `is-empty`), BlockFlash (`revealBlock`),\n * BlockConvert, local DocAnchors, the `/` menu (the commands with a `slash` placement: the block types here, more from\n * other features and the host), the undo/redo, formatting and block commands with their toolbar groups, and the\n * duplicate/delete/convert block actions. Needs `core-content`.\n * Given `ui` (the framework layer's palette component) it also has the ⌘K command palette: Mod-k and the overlay.\n * Without `ui` it contributes no components (`EditorFeature<never>`), so it fits a headless preset of any framework layer.\n */\nexport function coreUiFeature<C = never>(ui?: CoreUi<C>): EditorFeature<C> {\n  return {\n    id: 'core-ui',\n    dimension: 'interaction',\n    requires: ['core-content'],\n    extensions: ctx => [\n      Placeholder.configure({ includeChildren: true, showOnlyCurrent: false, placeholder: '' }),\n      SlashCommand.configure({ commands: ctx.commands(), emptyText: ctx.t('slash.empty'), loadingText: ctx.t('common.loading') }),\n      BlockFlash,\n      BlockConvert,\n      DocAnchors.configure({ resolver: ctx.anchorResolver }),\n      ...(ui ? [paletteShortcut(ctx)] : []),\n    ],\n    toolbarGroups: CORE_TOOLBAR_GROUPS,\n    commands: coreCommands,\n    blockActions: ctx => [...coreBlockActions(ctx)],\n    ...(ui && { overlays: [ui.palette] }),\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAqBA,MAAa,oBAAoB,QAAgD;CAC/E;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,eAAe;EAC5B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,OAAO,EAAE,QAAQ,MAAM,UAAU,iBAAiB,QAAQ;GAAE;GAAM;EAAI,GAAG,IAAI,CAAC;CAChF;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,iBAAiB;EAC9B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EAEP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,gBAAgB,MAAM,KAAK,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,IAAI;CACzG;CACA;EACE,IAAI;EACJ,OAAO,IAAI,EAAE,cAAc;EAC3B,MAAM;EACN,SAAS,QAAQ;EACjB,OAAO;EACP,MAAM,EAAE,QAAQ,MAAM,UAAU,OAAO,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;GAAE,MAAM;GAAK,IAAI,MAAM,KAAK;EAAS,CAAC,CAAC,CAAC,IAAI;CACjH;AACF;;;;;;;;;AAUA,SAAgB,qBAA2C;CACzD,OAAO;EACL,IAAI;EACJ,WAAW;EACX,kBAAkB;EAClB,aAAY,QAAO;GACjB,UAAU,UAAU,IAAI,SAAS;GACjC,WAAW,UAAU;IAAE,QAAQ;IAAO,UAAU,IAAI,gBAAgB,QAAQ,KAAA;IAAW,YAAY;KAAE,OAAO;KAAqB,OAAO;IAAE;GAAE,CAAC;GAC7I;GACA;GACA;GACA,SAAS,UAAU,EAAE,UAAU,IAAI,SAAS,CAAC;GAC7C;GACA;EACF;EACA,aAAa,CAAC,eAAe;CAC/B;AACF;;AAWA,SAAS,gBAAgB,KAAmC;CAC1D,OAAO,UAAU,OAAO;EACtB,MAAM;EACN,6BAA6B,EAC3B,eAAe;GACb,IAAI,GAAG,cAAc;GACrB,OAAO;EACT,EACF;CACF,CAAC;AACH;;;;;;;;;AAUA,SAAgB,cAAyB,IAAkC;CACzE,OAAO;EACL,IAAI;EACJ,WAAW;EACX,UAAU,CAAC,cAAc;EACzB,aAAY,QAAO;GACjB,YAAY,UAAU;IAAE,iBAAiB;IAAM,iBAAiB;IAAO,aAAa;GAAG,CAAC;GACxF,aAAa,UAAU;IAAE,UAAU,IAAI,SAAS;IAAG,WAAW,IAAI,EAAE,aAAa;IAAG,aAAa,IAAI,EAAE,gBAAgB;GAAE,CAAC;GAC1H;GACA;GACA,WAAW,UAAU,EAAE,UAAU,IAAI,eAAe,CAAC;GACrD,GAAI,KAAK,CAAC,gBAAgB,GAAG,CAAC,IAAI,CAAC;EACrC;EACA,eAAe;EACf,UAAU;EACV,eAAc,QAAO,CAAC,GAAG,iBAAiB,GAAG,CAAC;EAC9C,GAAI,MAAM,EAAE,UAAU,CAAC,GAAG,OAAO,EAAE;CACrC;AACF"}

package/dist/core/define-editor.d.ts

@@ -3,9 +3,10 @@ import { EditorFeature, EditorPreset, SettingsTab } from "./feature.js";
 //#region src/core/define-editor.d.ts
 /**
  * Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither
- * deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed
- * and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
- * `formatAiResult`) contributed twice. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
+ * deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed,
+ * a toolbar group declared by two features (`toolbarGroups`) and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
+ * `formatAiResult`) contributed twice. A command naming a toolbar group no feature declares needs the feature context
+ * to build the commands: `toolbarOf` throws it. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
  * concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.
  * `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.
  */

package/dist/core/define-editor.js

@@ -1,26 +1,33 @@
-import { DEFAULT_BLOCK_PIPELINE } from "./pipeline.js";
 import { SINGLETON_PIPELINE_HOOKS } from "./feature.js";
+import { DEFAULT_BLOCK_PIPELINE } from "./pipeline.js";
+import { fail as fail$1 } from "./util.js";
 //#region src/core/define-editor.ts
 const FEATURE_SINGLETONS = ["anchorResolver", "formatAiResult"];
-function fail(message) {
-	throw new Error(`@ecsplico/editor: defineEditor: ${message}`);
-}
+const fail = (message) => fail$1(message, "defineEditor");
 /**
 * Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither
-* deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed
-* and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
-* `formatAiResult`) contributed twice. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
+* deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed,
+* a toolbar group declared by two features (`toolbarGroups`) and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,
+* `formatAiResult`) contributed twice. A command naming a toolbar group no feature declares needs the feature context
+* to build the commands: `toolbarOf` throws it. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`
 * concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.
 * `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.
 */
 function defineEditor(config) {
 	const features = Object.freeze([...config.features]);
 	const ids = /* @__PURE__ */ new Set();
+	for (const feature of features) if (!feature.dimension) fail(`feature "${feature.id}" declares no dimension`);
 	for (const feature of features) {
 		if (ids.has(feature.id)) fail(`duplicate feature id "${feature.id}"`);
 		ids.add(feature.id);
 	}
 	for (const feature of features) for (const required of feature.requires ?? []) if (!ids.has(required)) fail(`feature "${feature.id}" requires "${required}", which is not installed`);
+	const groups = /* @__PURE__ */ new Map();
+	for (const feature of features) for (const group of feature.toolbarGroups ?? []) {
+		const owner = groups.get(group.id);
+		if (owner) fail(`features "${owner}" and "${feature.id}" both declare toolbar group "${group.id}"`);
+		groups.set(group.id, feature.id);
+	}
 	const owners = /* @__PURE__ */ new Map();
 	const claim = (hook, feature) => {
 		const owner = owners.get(hook);

package/dist/core/define-editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-editor.js","names":[],"sources":["../../src/core/define-editor.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport { type AiBlock, type AiBlockDataProvider, type AiContext, type AiContextKind, type BlockPipeline, type ConversionProvider, type EditorFeature, type EditorPreset, type SettingsTab, SINGLETON_PIPELINE_HOOKS } from './feature'\nimport { DEFAULT_BLOCK_PIPELINE } from './pipeline'\n\nconst FEATURE_SINGLETONS = ['anchorResolver', 'formatAiResult'] as const satisfies readonly (keyof EditorFeature)[]\n\nfunction fail(message: string): never {\n  throw new Error(`@ecsplico/editor: defineEditor: ${message}`)\n}\n\n/**\n * Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither\n * deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed\n * and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,\n * `formatAiResult`) contributed twice. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`\n * concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.\n * `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.\n */\nexport function defineEditor<C = unknown>(config: { features: readonly EditorFeature<C>[] }): EditorPreset<C> {\n  const features = Object.freeze([...config.features])\n  const ids = new Set<string>()\n  for (const feature of features) {\n    if (ids.has(feature.id)) fail(`duplicate feature id \"${feature.id}\"`)\n    ids.add(feature.id)\n  }\n  for (const feature of features) {\n    for (const required of feature.requires ?? []) {\n      if (!ids.has(required)) fail(`feature \"${feature.id}\" requires \"${required}\", which is not installed`)\n    }\n  }\n\n  const owners = new Map<string, string>()\n  const claim = (hook: string, feature: EditorFeature<C>) => {\n    const owner = owners.get(hook)\n    if (owner) fail(`features \"${owner}\" and \"${feature.id}\" both contribute the singleton hook \"${hook}\"`)\n    owners.set(hook, feature.id)\n  }\n  const pipeline: BlockPipeline = { ...DEFAULT_BLOCK_PIPELINE }\n  const normalizers: BlockPipeline['normalize'][] = []\n  for (const feature of features) {\n    for (const hook of FEATURE_SINGLETONS) if (feature[hook]) claim(hook, feature)\n    const blocks = feature.blocks\n    if (!blocks) continue\n    if (blocks.normalize) normalizers.push(blocks.normalize)\n    for (const hook of SINGLETON_PIPELINE_HOOKS) {\n      const fn = blocks[hook]\n      if (!fn) continue\n      claim(hook, feature)\n      Object.assign(pipeline, { [hook]: fn })\n    }\n  }\n  if (normalizers.length) pipeline.normalize = (editor, blocks) => normalizers.reduce((current, normalize) => normalize(editor, current), blocks)\n\n  const conversions: ConversionProvider[] = features.flatMap(feature => [...(feature.conversions ?? [])])\n  const contexts = features.flatMap(feature => feature.aiContext ? [{ id: feature.id, read: feature.aiContext }] : [])\n  const aiContext = contexts.length\n    ? (editor: Editor): AiContext => {\n        const merged: { kinds: AiContextKind[], blocks: AiBlock[], structure?: AiContext['structure'], owner?: string } = { kinds: [], blocks: [] }\n        const blockIds = new Set<string>()\n        for (const { id, read } of contexts) {\n          const context = read(editor)\n          merged.kinds.push(...(context.kinds ?? []))\n          for (const block of context.blocks ?? []) {\n            if (blockIds.has(block.id)) fail(`the AI block \"${block.id}\" is described by more than one feature`)\n            blockIds.add(block.id)\n            merged.blocks.push(block)\n          }\n          if (context.structure === undefined) continue\n          if (merged.owner) fail(`features \"${merged.owner}\" and \"${id}\" both set aiContext.structure`)\n          merged.owner = id\n          merged.structure = context.structure\n        }\n        return { kinds: merged.kinds, blocks: merged.blocks, ...(merged.structure && { structure: merged.structure }) }\n      }\n    : undefined\n  const dataProviders = features.flatMap(feature => feature.aiBlockData ? [feature.aiBlockData] : [])\n  const aiBlockData: AiBlockDataProvider | undefined = dataProviders.length\n    ? async request => (await Promise.all(dataProviders.map(provide => provide(request)))).flat()\n    : undefined\n  const formatAiResult = features.find(feature => feature.formatAiResult)?.formatAiResult\n  return Object.freeze({\n    features,\n    pipeline: Object.freeze(pipeline),\n    conversions: Object.freeze(conversions),\n    ...(aiContext && { aiContext }),\n    ...(aiBlockData && { aiBlockData }),\n    ...(formatAiResult && { formatAiResult }),\n  })\n}\n\n/**\n * The settings tabs the features of `preset` contribute for the app context `ctx` (labels in its language), in feature\n * order; none means there is no settings UI. Throws when two features contribute the same tab id.\n */\nexport function settingsTabsOf<C = unknown>(preset: EditorPreset<C>, ctx: EditorContext): readonly SettingsTab<C>[] {\n  const owners = new Map<string, string>()\n  return preset.features.flatMap((feature) => {\n    const tabs = feature.settingsTabs?.(ctx) ?? []\n    for (const tab of tabs) {\n      const owner = owners.get(tab.id)\n      if (owner) fail(`features \"${owner}\" and \"${feature.id}\" both contribute the settings tab \"${tab.id}\"`)\n      owners.set(tab.id, feature.id)\n    }\n    return tabs\n  })\n}\n\n/** Features of `preset` that fill the contribution `key`, in order. */\nexport function contributions<C, K extends keyof EditorFeature<C>>(preset: EditorPreset<C>, key: K): NonNullable<EditorFeature<C>[K]>[] {\n  return preset.features.flatMap(feature => feature[key] ? [feature[key] as NonNullable<EditorFeature<C>[K]>] : [])\n}\n"],"mappings":"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"}
+{"version":3,"file":"define-editor.js","names":["failWith"],"sources":["../../src/core/define-editor.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport { type AiBlock, type AiBlockDataProvider, type AiContext, type AiContextKind, type BlockPipeline, type ConversionProvider, type EditorFeature, type EditorPreset, type SettingsTab, SINGLETON_PIPELINE_HOOKS } from './feature'\nimport { DEFAULT_BLOCK_PIPELINE } from './pipeline'\nimport { fail as failWith } from './util'\n\nconst FEATURE_SINGLETONS = ['anchorResolver', 'formatAiResult'] as const satisfies readonly (keyof EditorFeature)[]\n\nconst fail = (message: string): never => failWith(message, 'defineEditor')\n\n/**\n * Validates `features` and resolves their pipeline and conversion providers. Keeps the given order; neither\n * deduplicates nor installs missing dependencies. Throws on duplicate ids, a `requires` entry that is not installed,\n * a toolbar group declared by two features (`toolbarGroups`) and a singleton hook (`parseMarkdown`, `segment`, `structure`, `wrapImport`, `migrateContent`, `anchorResolver`,\n * `formatAiResult`) contributed twice. A command naming a toolbar group no feature declares needs the feature context\n * to build the commands: `toolbarOf` throws it. `normalize` hooks chain left to right. `aiContext` contributions merge (`kinds` and `blocks`\n * concatenated in feature order, `structure` from one feature only); their conflicts surface when the merged `aiContext` reads the editor.\n * `aiBlockData` contributions are additive too: they run in parallel per block and their data concatenate in feature order.\n */\nexport function defineEditor<C = unknown>(config: { features: readonly EditorFeature<C>[] }): EditorPreset<C> {\n  const features = Object.freeze([...config.features])\n  const ids = new Set<string>()\n  for (const feature of features) {\n    if (!feature.dimension) fail(`feature \"${feature.id}\" declares no dimension`)\n  }\n  for (const feature of features) {\n    if (ids.has(feature.id)) fail(`duplicate feature id \"${feature.id}\"`)\n    ids.add(feature.id)\n  }\n  for (const feature of features) {\n    for (const required of feature.requires ?? []) {\n      if (!ids.has(required)) fail(`feature \"${feature.id}\" requires \"${required}\", which is not installed`)\n    }\n  }\n  const groups = new Map<string, string>()\n  for (const feature of features) {\n    for (const group of feature.toolbarGroups ?? []) {\n      const owner = groups.get(group.id)\n      if (owner) fail(`features \"${owner}\" and \"${feature.id}\" both declare toolbar group \"${group.id}\"`)\n      groups.set(group.id, feature.id)\n    }\n  }\n\n  const owners = new Map<string, string>()\n  const claim = (hook: string, feature: EditorFeature<C>) => {\n    const owner = owners.get(hook)\n    if (owner) fail(`features \"${owner}\" and \"${feature.id}\" both contribute the singleton hook \"${hook}\"`)\n    owners.set(hook, feature.id)\n  }\n  const pipeline: BlockPipeline = { ...DEFAULT_BLOCK_PIPELINE }\n  const normalizers: BlockPipeline['normalize'][] = []\n  for (const feature of features) {\n    for (const hook of FEATURE_SINGLETONS) if (feature[hook]) claim(hook, feature)\n    const blocks = feature.blocks\n    if (!blocks) continue\n    if (blocks.normalize) normalizers.push(blocks.normalize)\n    for (const hook of SINGLETON_PIPELINE_HOOKS) {\n      const fn = blocks[hook]\n      if (!fn) continue\n      claim(hook, feature)\n      Object.assign(pipeline, { [hook]: fn })\n    }\n  }\n  if (normalizers.length) pipeline.normalize = (editor, blocks) => normalizers.reduce((current, normalize) => normalize(editor, current), blocks)\n\n  const conversions: ConversionProvider[] = features.flatMap(feature => [...(feature.conversions ?? [])])\n  const contexts = features.flatMap(feature => feature.aiContext ? [{ id: feature.id, read: feature.aiContext }] : [])\n  const aiContext = contexts.length\n    ? (editor: Editor): AiContext => {\n        const merged: { kinds: AiContextKind[], blocks: AiBlock[], structure?: AiContext['structure'], owner?: string } = { kinds: [], blocks: [] }\n        const blockIds = new Set<string>()\n        for (const { id, read } of contexts) {\n          const context = read(editor)\n          merged.kinds.push(...(context.kinds ?? []))\n          for (const block of context.blocks ?? []) {\n            if (blockIds.has(block.id)) fail(`the AI block \"${block.id}\" is described by more than one feature`)\n            blockIds.add(block.id)\n            merged.blocks.push(block)\n          }\n          if (context.structure === undefined) continue\n          if (merged.owner) fail(`features \"${merged.owner}\" and \"${id}\" both set aiContext.structure`)\n          merged.owner = id\n          merged.structure = context.structure\n        }\n        return { kinds: merged.kinds, blocks: merged.blocks, ...(merged.structure && { structure: merged.structure }) }\n      }\n    : undefined\n  const dataProviders = features.flatMap(feature => feature.aiBlockData ? [feature.aiBlockData] : [])\n  const aiBlockData: AiBlockDataProvider | undefined = dataProviders.length\n    ? async request => (await Promise.all(dataProviders.map(provide => provide(request)))).flat()\n    : undefined\n  const formatAiResult = features.find(feature => feature.formatAiResult)?.formatAiResult\n  return Object.freeze({\n    features,\n    pipeline: Object.freeze(pipeline),\n    conversions: Object.freeze(conversions),\n    ...(aiContext && { aiContext }),\n    ...(aiBlockData && { aiBlockData }),\n    ...(formatAiResult && { formatAiResult }),\n  })\n}\n\n/**\n * The settings tabs the features of `preset` contribute for the app context `ctx` (labels in its language), in feature\n * order; none means there is no settings UI. Throws when two features contribute the same tab id.\n */\nexport function settingsTabsOf<C = unknown>(preset: EditorPreset<C>, ctx: EditorContext): readonly SettingsTab<C>[] {\n  const owners = new Map<string, string>()\n  return preset.features.flatMap((feature) => {\n    const tabs = feature.settingsTabs?.(ctx) ?? []\n    for (const tab of tabs) {\n      const owner = owners.get(tab.id)\n      if (owner) fail(`features \"${owner}\" and \"${feature.id}\" both contribute the settings tab \"${tab.id}\"`)\n      owners.set(tab.id, feature.id)\n    }\n    return tabs\n  })\n}\n\n/** Features of `preset` that fill the contribution `key`, in order. */\nexport function contributions<C, K extends keyof EditorFeature<C>>(preset: EditorPreset<C>, key: K): NonNullable<EditorFeature<C>[K]>[] {\n  return preset.features.flatMap(feature => feature[key] ? [feature[key] as NonNullable<EditorFeature<C>[K]>] : [])\n}\n"],"mappings":"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"}

package/dist/core/document-markdown.js

@@ -19,11 +19,20 @@ function withoutMarks(json, invisible) {
 */
 const DocumentMarkdown = Markdown.extend({ onBeforeCreate(event) {
 	this.parent?.(event);
-	const invisible = new Set(this.editor.extensionManager.extensions.filter((extension) => extension.type === "mark" && getExtensionField(extension, "markdownInvisible")).map((extension) => extension.name));
-	if (!invisible.size) return;
+	const extensions = this.editor.extensionManager.extensions;
+	const invisible = new Set(extensions.filter((extension) => extension.type === "mark" && getExtensionField(extension, "markdownInvisible")).map((extension) => extension.name));
+	const prepares = extensions.flatMap((extension) => {
+		const prepare = extension.type === "node" ? getExtensionField(extension, "markdownPrepare") : void 0;
+		return prepare ? [prepare] : [];
+	});
+	if (!invisible.size && !prepares.length) return;
 	const manager = this.storage.manager;
 	const serialize = manager.serialize.bind(manager);
-	manager.serialize = (json) => serialize(json && withoutMarks(json, invisible));
+	manager.serialize = (json) => {
+		if (!json) return serialize(json);
+		const prepared = prepares.reduce((current, prepare) => prepare(current, this.editor), json);
+		return serialize(invisible.size ? withoutMarks(prepared, invisible) : prepared);
+	};
 } });
 //#endregion
 export { DocumentMarkdown };

package/dist/core/document-markdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-markdown.js","names":[],"sources":["../../src/core/document-markdown.ts"],"sourcesContent":["import { getExtensionField, type JSONContent } from '@tiptap/core'\nimport { Markdown } from '@tiptap/markdown'\nimport './schema/mark-flags'\n\n/** `json` without the marks named in `invisible` on any node; the runs they split become identically marked neighbours. */\nfunction withoutMarks(json: JSONContent, invisible: ReadonlySet<string>): JSONContent {\n  return {\n    ...json,\n    ...(json.marks && { marks: json.marks.filter(mark => !invisible.has(mark.type)) }),\n    ...(json.content && { content: json.content.map(child => withoutMarks(child, invisible)) }),\n  }\n}\n\n/**\n * `@tiptap/markdown`'s `Markdown` whose serializer ignores every mark that declares `markdownInvisible` (author and\n * comment marks): `editor.getMarkdown()` and every `editor.markdown.serialize()` (AI context and selection, chat\n * blocks, summaries, transcript cleanup) render as if those marks did not exist. `@tiptap/markdown` already renders\n * marks without a handler as nothing, but they still split text runs, and its mark-boundary logic then closes and\n * reopens the formatting around the split (`Ein **Sa**<strong>btz</strong>` for one bold word with another author's\n * letter inside). The document keeps the marks. Use it instead of `Markdown` in every editor of a preset.\n */\nexport const DocumentMarkdown = Markdown.extend({\n  onBeforeCreate(event) {\n    this.parent?.(event)\n    const invisible = new Set(\n      this.editor.extensionManager.extensions\n        .filter(extension => extension.type === 'mark' && getExtensionField<boolean | undefined>(extension, 'markdownInvisible'))\n        .map(extension => extension.name),\n    )\n    if (!invisible.size) return\n    // `getMarkdown()` serializes through the same manager instance as `editor.markdown`.\n    const manager = this.storage.manager\n    const serialize = manager.serialize.bind(manager)\n    manager.serialize = json => serialize(json && withoutMarks(json, invisible))\n  },\n})\n"],"mappings":";;;;AAKA,SAAS,aAAa,MAAmB,WAA6C;CACpF,OAAO;EACL,GAAG;EACH,GAAI,KAAK,SAAS,EAAE,OAAO,KAAK,MAAM,QAAO,SAAQ,CAAC,UAAU,IAAI,KAAK,IAAI,CAAC,EAAE;EAChF,GAAI,KAAK,WAAW,EAAE,SAAS,KAAK,QAAQ,KAAI,UAAS,aAAa,OAAO,SAAS,CAAC,EAAE;CAC3F;AACF;;;;;;;;;AAUA,MAAa,mBAAmB,SAAS,OAAO,EAC9C,eAAe,OAAO;CACpB,KAAK,SAAS,KAAK;CACnB,MAAM,YAAY,IAAI,IACpB,KAAK,OAAO,iBAAiB,WAC1B,QAAO,cAAa,UAAU,SAAS,UAAU,kBAAuC,WAAW,mBAAmB,CAAC,CAAC,CACxH,KAAI,cAAa,UAAU,IAAI,CACpC;CACA,IAAI,CAAC,UAAU,MAAM;CAErB,MAAM,UAAU,KAAK,QAAQ;CAC7B,MAAM,YAAY,QAAQ,UAAU,KAAK,OAAO;CAChD,QAAQ,aAAY,SAAQ,UAAU,QAAQ,aAAa,MAAM,SAAS,CAAC;AAC7E,EACF,CAAC"}
+{"version":3,"file":"document-markdown.js","names":[],"sources":["../../src/core/document-markdown.ts"],"sourcesContent":["import { getExtensionField, type JSONContent, type NodeConfig } from '@tiptap/core'\nimport { Markdown } from '@tiptap/markdown'\nimport './schema/mark-flags'\n\n/** `json` without the marks named in `invisible` on any node; the runs they split become identically marked neighbours. */\nfunction withoutMarks(json: JSONContent, invisible: ReadonlySet<string>): JSONContent {\n  return {\n    ...json,\n    ...(json.marks && { marks: json.marks.filter(mark => !invisible.has(mark.type)) }),\n    ...(json.content && { content: json.content.map(child => withoutMarks(child, invisible)) }),\n  }\n}\n\n/**\n * `@tiptap/markdown`'s `Markdown` whose serializer ignores every mark that declares `markdownInvisible` (author and\n * comment marks): `editor.getMarkdown()` and every `editor.markdown.serialize()` (AI context and selection, chat\n * blocks, summaries, transcript cleanup) render as if those marks did not exist. `@tiptap/markdown` already renders\n * marks without a handler as nothing, but they still split text runs, and its mark-boundary logic then closes and\n * reopens the formatting around the split (`Ein **Sa**<strong>btz</strong>` for one bold word with another author's\n * letter inside). The document keeps the marks. Use it instead of `Markdown` in every editor of a preset.\n */\nexport const DocumentMarkdown = Markdown.extend({\n  onBeforeCreate(event) {\n    this.parent?.(event)\n    const extensions = this.editor.extensionManager.extensions\n    const invisible = new Set(\n      extensions\n        .filter(extension => extension.type === 'mark' && getExtensionField<boolean | undefined>(extension, 'markdownInvisible'))\n        .map(extension => extension.name),\n    )\n    const prepares = extensions.flatMap((extension) => {\n      const prepare = extension.type === 'node' ? getExtensionField<NodeConfig['markdownPrepare']>(extension, 'markdownPrepare') : undefined\n      return prepare ? [prepare] : []\n    })\n    if (!invisible.size && !prepares.length) return\n    // `getMarkdown()` serializes through the same manager instance as `editor.markdown`.\n    const manager = this.storage.manager\n    const serialize = manager.serialize.bind(manager)\n    manager.serialize = (json) => {\n      if (!json) return serialize(json)\n      const prepared = prepares.reduce((current, prepare) => prepare(current, this.editor), json)\n      return serialize(invisible.size ? withoutMarks(prepared, invisible) : prepared)\n    }\n  },\n})\n"],"mappings":";;;;AAKA,SAAS,aAAa,MAAmB,WAA6C;CACpF,OAAO;EACL,GAAG;EACH,GAAI,KAAK,SAAS,EAAE,OAAO,KAAK,MAAM,QAAO,SAAQ,CAAC,UAAU,IAAI,KAAK,IAAI,CAAC,EAAE;EAChF,GAAI,KAAK,WAAW,EAAE,SAAS,KAAK,QAAQ,KAAI,UAAS,aAAa,OAAO,SAAS,CAAC,EAAE;CAC3F;AACF;;;;;;;;;AAUA,MAAa,mBAAmB,SAAS,OAAO,EAC9C,eAAe,OAAO;CACpB,KAAK,SAAS,KAAK;CACnB,MAAM,aAAa,KAAK,OAAO,iBAAiB;CAChD,MAAM,YAAY,IAAI,IACpB,WACG,QAAO,cAAa,UAAU,SAAS,UAAU,kBAAuC,WAAW,mBAAmB,CAAC,CAAC,CACxH,KAAI,cAAa,UAAU,IAAI,CACpC;CACA,MAAM,WAAW,WAAW,SAAS,cAAc;EACjD,MAAM,UAAU,UAAU,SAAS,SAAS,kBAAiD,WAAW,iBAAiB,IAAI,KAAA;EAC7H,OAAO,UAAU,CAAC,OAAO,IAAI,CAAC;CAChC,CAAC;CACD,IAAI,CAAC,UAAU,QAAQ,CAAC,SAAS,QAAQ;CAEzC,MAAM,UAAU,KAAK,QAAQ;CAC7B,MAAM,YAAY,QAAQ,UAAU,KAAK,OAAO;CAChD,QAAQ,aAAa,SAAS;EAC5B,IAAI,CAAC,MAAM,OAAO,UAAU,IAAI;EAChC,MAAM,WAAW,SAAS,QAAQ,SAAS,YAAY,QAAQ,SAAS,KAAK,MAAM,GAAG,IAAI;EAC1F,OAAO,UAAU,UAAU,OAAO,aAAa,UAAU,SAAS,IAAI,QAAQ;CAChF;AACF,EACF,CAAC"}

package/dist/core/editor-ui.d.ts

@@ -1,6 +1,6 @@
-import { BlockAction } from "./extension-points.js";
 import { Notifier } from "./notify.js";
 import { EditorContext } from "./context.js";
+import { BlockAction } from "./extension-points.js";
 import { EditorPreset, FeatureContext } from "./feature.js";
 import { Editor } from "@tiptap/core";
 //#region src/core/editor-ui.d.ts
@@ -17,6 +17,13 @@ export interface EditorUi {
   toggleComments: () => void;
   /** Whether the comments margin is open (read-only; for toggles' active state). */
   readonly commentsOpen: boolean;
+  /**
+   * Opens or closes the editor's ⌘K command palette (the surface's own state; the `core-ui` feature binds Mod-k to it
+   * when it was given a palette component).
+   */
+  togglePalette: () => void;
+  /** Whether the command palette is open (read-only). */
+  readonly paletteOpen: boolean;
 }
 /** What a mounted surface registers for its editor instance: the components beside it read it by `editor`. */
 export interface EditorEntry {

package/dist/core/editor-ui.js

@@ -35,10 +35,10 @@ function notifierOf(editor, app) {
 }
 /**
 * The `FeatureContext` a component placed beside an editor (the toolbar) hands feature factories. App-level members
-* (`app`, `locale`, `t`, `settings`, `fetch`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,
-* `upload`, `collaboration`, `anchorResolver`, `abilities`, `slashCommands`) is read from the entry registered for
+* (`app`, `locale`, `t`, `settings`, `backend`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,
+* `collaboration`, `anchorResolver`, `abilities`, `commands`) is read from the entry registered for
 * `getEditor()` each time it is used, so the context follows the editor while it changes and falls back to inert values
-* (an empty metadata registry, no-op chrome, `commentsOpen: false`) while there is none. `notify` is `notifierOf`.
+* (an empty metadata registry, no-op chrome, `commentsOpen: false`, `paletteOpen: false`) while there is none. `notify` is `notifierOf`.
 */
 function borrowedFeatureContext(options) {
 	const { app, getEditor } = options;
@@ -56,7 +56,7 @@ function borrowedFeatureContext(options) {
 		t: app.t,
 		settings: options.settings ?? app.settings,
 		notify: notifierOf(rawEditor, app),
-		fetch: app.fetch,
+		backend: app.backend,
 		ai: app.ai,
 		get metadata() {
 			return entry()?.ctx.metadata ?? fallbackMetadata;
@@ -67,14 +67,15 @@ function borrowedFeatureContext(options) {
 			toggleComments: () => ui()?.toggleComments(),
 			get commentsOpen() {
 				return ui()?.commentsOpen ?? false;
+			},
+			togglePalette: () => ui()?.togglePalette(),
+			get paletteOpen() {
+				return ui()?.paletteOpen ?? false;
 			}
 		},
 		get documentId() {
 			return entry()?.ctx.documentId;
 		},
-		get upload() {
-			return entry()?.ctx.upload;
-		},
 		get collaboration() {
 			return entry()?.ctx.collaboration;
 		},
@@ -84,7 +85,7 @@ function borrowedFeatureContext(options) {
 		get abilities() {
 			return entry()?.ctx.abilities ?? {};
 		},
-		slashCommands: () => entry()?.ctx.slashCommands() ?? [],
+		commands: () => entry()?.ctx.commands() ?? [],
 		getEditor
 	};
 }

package/dist/core/editor-ui.js.map

@@ -1 +1 @@
-{"version":3,"file":"editor-ui.js","names":[],"sources":["../../src/core/editor-ui.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport type { EditorPreset, FeatureContext } from './feature'\nimport type { BlockAction } from './extension-points'\nimport { createMetadataRegistry } from './metadata'\nimport type { Notifier } from './notify'\n\n/** Editor chrome an `EditorSurface` owns, for the components around it. Settings tabs are the ids features contribute. */\nexport interface EditorUi {\n  /** Opens the settings UI, on `tab` when given (else on the tab shown last). */\n  openSettings: (tab?: string) => void\n  /** Opens or closes the editor's AI sidebar (the surface's `sidebarOpen` model, which the host binds). */\n  toggleSidebar: () => void\n  /**\n   * Opens or closes the editor's comments margin (the surface's `commentsOpen` model, which the host binds). Opening it\n   * closes the AI sidebar and vice versa.\n   */\n  toggleComments: () => void\n  /** Whether the comments margin is open (read-only; for toggles' active state). */\n  readonly commentsOpen: boolean\n}\n\n/** What a mounted surface registers for its editor instance: the components beside it read it by `editor`. */\nexport interface EditorEntry {\n  ui: EditorUi\n  preset: EditorPreset\n  ctx: FeatureContext\n  /** Features' block actions followed by the host's, for the overlay that renders them. */\n  blockActions: readonly BlockAction[]\n}\n\n/** Each mounted surface's entry by its Tiptap editor (raw, unproxied instance), for components outside its subtree. */\nconst entries = new WeakMap<Editor, EditorEntry>()\n\n/**\n * Makes `entry` reachable through `editorEntryOf(editor)` (and the framework layers' `useEditorUi(editor)`); returns the\n * unregister function. The surface registers once its editor exists (before emitting `ready`) and unregisters on unmount.\n * Pass the raw editor: framework proxies (e.g. Vue reactive wrappers) are different WeakMap keys.\n */\nexport function registerEditor(editor: Editor, entry: EditorEntry): () => void {\n  entries.set(editor, entry)\n  return () => {\n    if (entries.get(editor) === entry) entries.delete(editor)\n  }\n}\n\n/** The surface entry registered for `editor` (the raw instance); undefined for an unregistered or missing editor. */\nexport function editorEntryOf(editor: Editor | undefined): EditorEntry | undefined {\n  return editor ? entries.get(editor) : undefined\n}\n\n/**\n * The one notifier policy: a notice goes to the surface notifier of `editor` (`createEditor`/`EditorSurface` of the\n * host) while it has one, else to the app context's. Both are resolved when a notice is shown (also `dismiss`), so a\n * request that finishes after an await still reaches the current surface. Pass `editor` (the raw instance) and `app` as\n * getters when they change over the notifier's life.\n */\nexport function notifierOf(editor: Editor | undefined | (() => Editor | undefined), app: Pick<EditorContext, 'notify'> | (() => Pick<EditorContext, 'notify'>)): Notifier {\n  const resolve = (): Notifier => {\n    const instance = typeof editor === 'function' ? editor() : editor\n    return editorEntryOf(instance)?.ctx.notify ?? (typeof app === 'function' ? app() : app).notify\n  }\n  const notify: Notifier = notice => resolve()(notice)\n  notify.dismiss = (id) => { resolve().dismiss?.(id) }\n  return notify\n}\n\nexport interface BorrowedFeatureContextOptions {\n  app: EditorContext\n  /** The editor the borrowing component works on, as its framework layer holds it; `undefined` while there is none. */\n  getEditor: () => Editor | undefined\n  /** Maps the held editor to the raw instance surfaces register (default: identity). Vue passes `toRaw`. */\n  unwrap?: (editor: Editor) => Editor\n  /** The `settings` the context exposes (default: the app's); a framework layer may wrap it so rendering tracks changes. */\n  settings?: FeatureContext['settings']\n}\n\n/**\n * The `FeatureContext` a component placed beside an editor (the toolbar) hands feature factories. App-level members\n * (`app`, `locale`, `t`, `settings`, `fetch`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,\n * `upload`, `collaboration`, `anchorResolver`, `abilities`, `slashCommands`) is read from the entry registered for\n * `getEditor()` each time it is used, so the context follows the editor while it changes and falls back to inert values\n * (an empty metadata registry, no-op chrome, `commentsOpen: false`) while there is none. `notify` is `notifierOf`.\n */\nexport function borrowedFeatureContext(options: BorrowedFeatureContextOptions): FeatureContext {\n  const { app, getEditor } = options\n  const unwrap = options.unwrap ?? (editor => editor)\n  const rawEditor = () => {\n    const editor = getEditor()\n    return editor && unwrap(editor)\n  }\n  const fallbackMetadata = createMetadataRegistry()\n  const entry = () => editorEntryOf(rawEditor())\n  const ui = () => entry()?.ui\n  return {\n    app,\n    locale: app.locale,\n    t: app.t,\n    settings: options.settings ?? app.settings,\n    notify: notifierOf(rawEditor, app),\n    fetch: app.fetch,\n    ai: app.ai,\n    get metadata() { return entry()?.ctx.metadata ?? fallbackMetadata },\n    ui: {\n      openSettings: tab => ui()?.openSettings(tab),\n      toggleSidebar: () => ui()?.toggleSidebar(),\n      toggleComments: () => ui()?.toggleComments(),\n      get commentsOpen() { return ui()?.commentsOpen ?? false },\n    },\n    get documentId() { return entry()?.ctx.documentId },\n    get upload() { return entry()?.ctx.upload },\n    get collaboration() { return entry()?.ctx.collaboration },\n    get anchorResolver() { return entry()?.ctx.anchorResolver ?? null },\n    get abilities() { return entry()?.ctx.abilities ?? {} },\n    slashCommands: () => entry()?.ctx.slashCommands() ?? [],\n    getEditor,\n  }\n}\n"],"mappings":";;;AAgCA,MAAM,0BAAU,IAAI,QAA6B;;;;;;AAOjD,SAAgB,eAAe,QAAgB,OAAgC;CAC7E,QAAQ,IAAI,QAAQ,KAAK;CACzB,aAAa;EACX,IAAI,QAAQ,IAAI,MAAM,MAAM,OAAO,QAAQ,OAAO,MAAM;CAC1D;AACF;;AAGA,SAAgB,cAAc,QAAqD;CACjF,OAAO,SAAS,QAAQ,IAAI,MAAM,IAAI,KAAA;AACxC;;;;;;;AAQA,SAAgB,WAAW,QAAyD,KAAsF;CACxK,MAAM,gBAA0B;EAE9B,OAAO,cADU,OAAO,WAAW,aAAa,OAAO,IAAI,MAC9B,CAAC,EAAE,IAAI,WAAW,OAAO,QAAQ,aAAa,IAAI,IAAI,IAAA,CAAK;CAC1F;CACA,MAAM,UAAmB,WAAU,QAAQ,CAAC,CAAC,MAAM;CACnD,OAAO,WAAW,OAAO;EAAE,QAAQ,CAAC,CAAC,UAAU,EAAE;CAAE;CACnD,OAAO;AACT;;;;;;;;AAmBA,SAAgB,uBAAuB,SAAwD;CAC7F,MAAM,EAAE,KAAK,cAAc;CAC3B,MAAM,SAAS,QAAQ,YAAW,WAAU;CAC5C,MAAM,kBAAkB;EACtB,MAAM,SAAS,UAAU;EACzB,OAAO,UAAU,OAAO,MAAM;CAChC;CACA,MAAM,mBAAmB,uBAAuB;CAChD,MAAM,cAAc,cAAc,UAAU,CAAC;CAC7C,MAAM,WAAW,MAAM,CAAC,EAAE;CAC1B,OAAO;EACL;EACA,QAAQ,IAAI;EACZ,GAAG,IAAI;EACP,UAAU,QAAQ,YAAY,IAAI;EAClC,QAAQ,WAAW,WAAW,GAAG;EACjC,OAAO,IAAI;EACX,IAAI,IAAI;EACR,IAAI,WAAW;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,YAAY;EAAiB;EAClE,IAAI;GACF,eAAc,QAAO,GAAG,CAAC,EAAE,aAAa,GAAG;GAC3C,qBAAqB,GAAG,CAAC,EAAE,cAAc;GACzC,sBAAsB,GAAG,CAAC,EAAE,eAAe;GAC3C,IAAI,eAAe;IAAE,OAAO,GAAG,CAAC,EAAE,gBAAgB;GAAM;EAC1D;EACA,IAAI,aAAa;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAW;EAClD,IAAI,SAAS;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAO;EAC1C,IAAI,gBAAgB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAc;EACxD,IAAI,iBAAiB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,kBAAkB;EAAK;EAClE,IAAI,YAAY;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC;EAAE;EACtD,qBAAqB,MAAM,CAAC,EAAE,IAAI,cAAc,KAAK,CAAC;EACtD;CACF;AACF"}
+{"version":3,"file":"editor-ui.js","names":[],"sources":["../../src/core/editor-ui.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport type { EditorContext } from './context'\nimport type { EditorPreset, FeatureContext } from './feature'\nimport type { BlockAction } from './extension-points'\nimport { createMetadataRegistry } from './metadata'\nimport type { Notifier } from './notify'\n\n/** Editor chrome an `EditorSurface` owns, for the components around it. Settings tabs are the ids features contribute. */\nexport interface EditorUi {\n  /** Opens the settings UI, on `tab` when given (else on the tab shown last). */\n  openSettings: (tab?: string) => void\n  /** Opens or closes the editor's AI sidebar (the surface's `sidebarOpen` model, which the host binds). */\n  toggleSidebar: () => void\n  /**\n   * Opens or closes the editor's comments margin (the surface's `commentsOpen` model, which the host binds). Opening it\n   * closes the AI sidebar and vice versa.\n   */\n  toggleComments: () => void\n  /** Whether the comments margin is open (read-only; for toggles' active state). */\n  readonly commentsOpen: boolean\n  /**\n   * Opens or closes the editor's ⌘K command palette (the surface's own state; the `core-ui` feature binds Mod-k to it\n   * when it was given a palette component).\n   */\n  togglePalette: () => void\n  /** Whether the command palette is open (read-only). */\n  readonly paletteOpen: boolean\n}\n\n/** What a mounted surface registers for its editor instance: the components beside it read it by `editor`. */\nexport interface EditorEntry {\n  ui: EditorUi\n  preset: EditorPreset\n  ctx: FeatureContext\n  /** Features' block actions followed by the host's, for the overlay that renders them. */\n  blockActions: readonly BlockAction[]\n}\n\n/** Each mounted surface's entry by its Tiptap editor (raw, unproxied instance), for components outside its subtree. */\nconst entries = new WeakMap<Editor, EditorEntry>()\n\n/**\n * Makes `entry` reachable through `editorEntryOf(editor)` (and the framework layers' `useEditorUi(editor)`); returns the\n * unregister function. The surface registers once its editor exists (before emitting `ready`) and unregisters on unmount.\n * Pass the raw editor: framework proxies (e.g. Vue reactive wrappers) are different WeakMap keys.\n */\nexport function registerEditor(editor: Editor, entry: EditorEntry): () => void {\n  entries.set(editor, entry)\n  return () => {\n    if (entries.get(editor) === entry) entries.delete(editor)\n  }\n}\n\n/** The surface entry registered for `editor` (the raw instance); undefined for an unregistered or missing editor. */\nexport function editorEntryOf(editor: Editor | undefined): EditorEntry | undefined {\n  return editor ? entries.get(editor) : undefined\n}\n\n/**\n * The one notifier policy: a notice goes to the surface notifier of `editor` (`createEditor`/`EditorSurface` of the\n * host) while it has one, else to the app context's. Both are resolved when a notice is shown (also `dismiss`), so a\n * request that finishes after an await still reaches the current surface. Pass `editor` (the raw instance) and `app` as\n * getters when they change over the notifier's life.\n */\nexport function notifierOf(editor: Editor | undefined | (() => Editor | undefined), app: Pick<EditorContext, 'notify'> | (() => Pick<EditorContext, 'notify'>)): Notifier {\n  const resolve = (): Notifier => {\n    const instance = typeof editor === 'function' ? editor() : editor\n    return editorEntryOf(instance)?.ctx.notify ?? (typeof app === 'function' ? app() : app).notify\n  }\n  const notify: Notifier = notice => resolve()(notice)\n  notify.dismiss = (id) => { resolve().dismiss?.(id) }\n  return notify\n}\n\nexport interface BorrowedFeatureContextOptions {\n  app: EditorContext\n  /** The editor the borrowing component works on, as its framework layer holds it; `undefined` while there is none. */\n  getEditor: () => Editor | undefined\n  /** Maps the held editor to the raw instance surfaces register (default: identity). Vue passes `toRaw`. */\n  unwrap?: (editor: Editor) => Editor\n  /** The `settings` the context exposes (default: the app's); a framework layer may wrap it so rendering tracks changes. */\n  settings?: FeatureContext['settings']\n}\n\n/**\n * The `FeatureContext` a component placed beside an editor (the toolbar) hands feature factories. App-level members\n * (`app`, `locale`, `t`, `settings`, `backend`, `ai`) come from the app context; everything per-surface (`metadata`, `ui`, `documentId`,\n * `collaboration`, `anchorResolver`, `abilities`, `commands`) is read from the entry registered for\n * `getEditor()` each time it is used, so the context follows the editor while it changes and falls back to inert values\n * (an empty metadata registry, no-op chrome, `commentsOpen: false`, `paletteOpen: false`) while there is none. `notify` is `notifierOf`.\n */\nexport function borrowedFeatureContext(options: BorrowedFeatureContextOptions): FeatureContext {\n  const { app, getEditor } = options\n  const unwrap = options.unwrap ?? (editor => editor)\n  const rawEditor = () => {\n    const editor = getEditor()\n    return editor && unwrap(editor)\n  }\n  const fallbackMetadata = createMetadataRegistry()\n  const entry = () => editorEntryOf(rawEditor())\n  const ui = () => entry()?.ui\n  return {\n    app,\n    locale: app.locale,\n    t: app.t,\n    settings: options.settings ?? app.settings,\n    notify: notifierOf(rawEditor, app),\n    backend: app.backend,\n    ai: app.ai,\n    get metadata() { return entry()?.ctx.metadata ?? fallbackMetadata },\n    ui: {\n      openSettings: tab => ui()?.openSettings(tab),\n      toggleSidebar: () => ui()?.toggleSidebar(),\n      toggleComments: () => ui()?.toggleComments(),\n      get commentsOpen() { return ui()?.commentsOpen ?? false },\n      togglePalette: () => ui()?.togglePalette(),\n      get paletteOpen() { return ui()?.paletteOpen ?? false },\n    },\n    get documentId() { return entry()?.ctx.documentId },\n    get collaboration() { return entry()?.ctx.collaboration },\n    get anchorResolver() { return entry()?.ctx.anchorResolver ?? null },\n    get abilities() { return entry()?.ctx.abilities ?? {} },\n    commands: () => entry()?.ctx.commands() ?? [],\n    getEditor,\n  }\n}\n"],"mappings":";;;AAuCA,MAAM,0BAAU,IAAI,QAA6B;;;;;;AAOjD,SAAgB,eAAe,QAAgB,OAAgC;CAC7E,QAAQ,IAAI,QAAQ,KAAK;CACzB,aAAa;EACX,IAAI,QAAQ,IAAI,MAAM,MAAM,OAAO,QAAQ,OAAO,MAAM;CAC1D;AACF;;AAGA,SAAgB,cAAc,QAAqD;CACjF,OAAO,SAAS,QAAQ,IAAI,MAAM,IAAI,KAAA;AACxC;;;;;;;AAQA,SAAgB,WAAW,QAAyD,KAAsF;CACxK,MAAM,gBAA0B;EAE9B,OAAO,cADU,OAAO,WAAW,aAAa,OAAO,IAAI,MAC9B,CAAC,EAAE,IAAI,WAAW,OAAO,QAAQ,aAAa,IAAI,IAAI,IAAA,CAAK;CAC1F;CACA,MAAM,UAAmB,WAAU,QAAQ,CAAC,CAAC,MAAM;CACnD,OAAO,WAAW,OAAO;EAAE,QAAQ,CAAC,CAAC,UAAU,EAAE;CAAE;CACnD,OAAO;AACT;;;;;;;;AAmBA,SAAgB,uBAAuB,SAAwD;CAC7F,MAAM,EAAE,KAAK,cAAc;CAC3B,MAAM,SAAS,QAAQ,YAAW,WAAU;CAC5C,MAAM,kBAAkB;EACtB,MAAM,SAAS,UAAU;EACzB,OAAO,UAAU,OAAO,MAAM;CAChC;CACA,MAAM,mBAAmB,uBAAuB;CAChD,MAAM,cAAc,cAAc,UAAU,CAAC;CAC7C,MAAM,WAAW,MAAM,CAAC,EAAE;CAC1B,OAAO;EACL;EACA,QAAQ,IAAI;EACZ,GAAG,IAAI;EACP,UAAU,QAAQ,YAAY,IAAI;EAClC,QAAQ,WAAW,WAAW,GAAG;EACjC,SAAS,IAAI;EACb,IAAI,IAAI;EACR,IAAI,WAAW;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,YAAY;EAAiB;EAClE,IAAI;GACF,eAAc,QAAO,GAAG,CAAC,EAAE,aAAa,GAAG;GAC3C,qBAAqB,GAAG,CAAC,EAAE,cAAc;GACzC,sBAAsB,GAAG,CAAC,EAAE,eAAe;GAC3C,IAAI,eAAe;IAAE,OAAO,GAAG,CAAC,EAAE,gBAAgB;GAAM;GACxD,qBAAqB,GAAG,CAAC,EAAE,cAAc;GACzC,IAAI,cAAc;IAAE,OAAO,GAAG,CAAC,EAAE,eAAe;GAAM;EACxD;EACA,IAAI,aAAa;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAW;EAClD,IAAI,gBAAgB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI;EAAc;EACxD,IAAI,iBAAiB;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,kBAAkB;EAAK;EAClE,IAAI,YAAY;GAAE,OAAO,MAAM,CAAC,EAAE,IAAI,aAAa,CAAC;EAAE;EACtD,gBAAgB,MAAM,CAAC,EAAE,IAAI,SAAS,KAAK,CAAC;EAC5C;CACF;AACF"}