@ecsplico/editor 0.0.0-stage → 2.0.0

package/dist/core/block-convert.js

@@ -0,0 +1,164 @@
+import { TYPE_ABILITIES } from "./schema/abilities.js";
+import { abilitiesAt } from "./abilities.js";
+import { isBlockContainer, isChromeNode } from "./schema/node-flags.js";
+import { convertCoreBlocks, convertTargetId, coreConversionTargets, isCoreTarget, parseCoreTarget } from "./convert.js";
+import { conversionsOf } from "./pipeline.js";
+import { Extension } from "@tiptap/core";
+import { Selection } from "@tiptap/pm/state";
+import { Fragment } from "@tiptap/pm/model";
+//#region src/core/block-convert.ts
+const CORE_LABELS = {
+	paragraph: {
+		key: "block.paragraph",
+		icon: "i-lucide-pilcrow"
+	},
+	bulletList: {
+		key: "block.bulletList",
+		icon: "i-lucide-list"
+	},
+	orderedList: {
+		key: "block.orderedList",
+		icon: "i-lucide-list-ordered"
+	},
+	blockquote: {
+		key: "block.blockquote",
+		icon: "i-lucide-text-quote"
+	},
+	codeBlock: {
+		key: "block.codeBlock",
+		icon: "i-lucide-square-code"
+	}
+};
+/**
+* The standard conversions: paragraphs, headings, lists, quotes and code blocks into each other. Declines every other
+* target, so features that add targets (speaker segments, composites) own them in their own providers.
+*/
+const coreConversions = {
+	targets: (_editor, node) => coreConversionTargets(node),
+	parseTarget: parseCoreTarget,
+	label: (target, t) => {
+		if (target.type === "heading") return {
+			label: t("block.heading", { level: target.level }),
+			icon: `i-lucide-heading-${target.level}`
+		};
+		const core = isCoreTarget(target) ? CORE_LABELS[target.type] : void 0;
+		return core ? {
+			label: t(core.key),
+			icon: core.icon
+		} : null;
+	},
+	convert: (state, $start, target) => {
+		const node = $start.nodeAfter;
+		if (!node) return null;
+		const blocks = convertCoreBlocks(state.schema, [node], target);
+		return blocks ? {
+			from: $start.pos,
+			to: $start.pos + node.nodeSize,
+			blocks
+		} : null;
+	}
+};
+/** The provider that owns `target`: the first, in feature order, that parses its id. */
+function targetOwner(providers, target) {
+	const id = convertTargetId(target);
+	return providers.find((provider) => provider.parseTarget(id) !== null);
+}
+/** The target `id` names, by its owner; null when no provider knows it. */
+function parseConversionTarget(providers, id) {
+	for (const provider of providers) {
+		const target = provider.parseTarget(id);
+		if (target) return target;
+	}
+	return null;
+}
+/** Label (in the language of `t`) and icon of `target`, from its owner. */
+function conversionLabel(providers, target, t) {
+	const label = targetOwner(providers, target)?.label(target, t);
+	if (!label) throw new Error(`@ecsplico/editor: no conversion provider owns the target "${convertTargetId(target)}"`);
+	return label;
+}
+/** The targets offered for `node` per provider, in feature order; a target id offered twice is an error. */
+function conversionTargetGroups(providers, editor, node) {
+	const offered = /* @__PURE__ */ new Set();
+	return providers.map((provider) => provider.targets(editor, node).filter((target) => {
+		const id = convertTargetId(target);
+		if (offered.has(id)) throw new Error(`@ecsplico/editor: the conversion target "${id}" is advertised by more than one provider`);
+		offered.add(id);
+		return true;
+	}));
+}
+/** The `$pos` right in front of the block to convert; a chrome node stands for its parent block. */
+function blockStart(state, pos) {
+	let $start;
+	if (pos === void 0) {
+		const { $head } = state.selection;
+		let depth = $head.depth;
+		while (depth > 0 && !isBlockContainer($head.node(depth - 1))) depth--;
+		if (depth === 0) return null;
+		$start = state.doc.resolve($head.before(depth));
+	} else {
+		if (pos < 0 || pos >= state.doc.content.size) return null;
+		$start = state.doc.resolve(pos);
+	}
+	const node = $start.nodeAfter;
+	if (!node) return null;
+	return isChromeNode(node) ? state.doc.resolve($start.before()) : $start;
+}
+/**
+* The conversion of the block right after `$start` into `target`: the range it replaces and the converted blocks.
+* A provider claiming the source block (`handlesSource`) executes; otherwise the target's owner does. Null when the
+* conversion changes nothing or the result does not fit there (`parent.canReplace`). Shared by `convertBlockTo` and
+* the chat's `convert` op.
+*/
+function blockConversion(providers, state, $start, target) {
+	const node = $start.nodeAfter;
+	if (!node) return null;
+	const conversion = (providers.find((candidate) => candidate.handlesSource?.(node)) ?? targetOwner(providers, target))?.convert(state, $start, target);
+	if (!conversion) return null;
+	const parent = $start.parent;
+	const $end = state.doc.resolve(conversion.to);
+	if ($end.parent !== parent || !parent.canReplace($start.index(), $end.index(), Fragment.from(conversion.blocks))) return null;
+	return conversion;
+}
+/**
+* Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“
+* block action and the toolbar's conversion groups. One transaction, so one undo step.
+*/
+const BlockConvert = Extension.create({
+	name: "blockConvert",
+	addCommands() {
+		return { convertBlockTo: (target, pos) => ({ editor, state, tr, dispatch }) => {
+			const $start = blockStart(state, pos);
+			const conversion = $start && blockConversion(conversionsOf(editor), state, $start, target);
+			if (!conversion) return false;
+			if (dispatch) {
+				tr.replaceWith(conversion.from, conversion.to, conversion.blocks);
+				const $first = tr.doc.resolve(conversion.from);
+				tr.setSelection(Selection.findFrom($first, 1, true) ?? Selection.near($first)).scrollIntoView();
+			}
+			return true;
+		} };
+	}
+});
+/**
+* „Umwandeln in …“ entries for the block `target`: the targets the providers offer whose type the block's container
+* allows (`TYPE_ABILITIES`), one separated group per provider in feature order. A list item stands for its list.
+*/
+function convertMenuItems(editor, target, t) {
+	let { node, pos } = target;
+	if (node.type.name === "listItem") {
+		const $item = editor.state.doc.resolve(pos);
+		node = $item.parent;
+		pos = $item.before();
+	}
+	const providers = conversionsOf(editor);
+	const abilities = abilitiesAt(editor, pos);
+	return conversionTargetGroups(providers, editor, node).map((targets) => targets.filter((to) => !TYPE_ABILITIES[to.type] || abilities.has(TYPE_ABILITIES[to.type])).map((to) => ({
+		...conversionLabel(providers, to, t),
+		onSelect: () => editor.chain().focus().convertBlockTo(to, pos).run()
+	}))).filter((items) => items.length > 0).flatMap((items, index) => index ? [{ type: "separator" }, ...items] : items);
+}
+//#endregion
+export { BlockConvert, blockConversion, conversionLabel, conversionTargetGroups, convertMenuItems, coreConversions, parseConversionTarget, targetOwner };
+
+//# sourceMappingURL=block-convert.js.map

package/dist/core/block-convert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-convert.js","names":[],"sources":["../../src/core/block-convert.ts"],"sourcesContent":["import { type Editor, Extension } from '@tiptap/core'\nimport { Fragment, type Node as PMNode, type ResolvedPos } from '@tiptap/pm/model'\nimport { type EditorState, Selection } from '@tiptap/pm/state'\nimport { abilitiesAt } from './abilities'\nimport { type ConvertTarget, convertCoreBlocks, convertTargetId, coreConversionTargets, isCoreTarget, parseCoreTarget } from './convert'\nimport type { BlockTarget } from './extension-points'\nimport type { ConversionProvider } from './feature'\nimport type { MessageKey, Translate } from '../i18n'\nimport { conversionsOf } from './pipeline'\nimport { isBlockContainer, isChromeNode } from './schema/node-flags'\nimport { TYPE_ABILITIES } from './schema/abilities'\nimport type { MenuItem } from './toolbar'\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    blockConvert: {\n      /**\n       * Convert the block at `pos` (default: the caret's block in the document or another block container; a chrome\n       * node stands for its parent) into `target`. False when the conversion changes nothing or is impossible there.\n       */\n      convertBlockTo: (target: ConvertTarget, pos?: number) => ReturnType\n    }\n  }\n}\n\nconst CORE_LABELS: Record<string, { key: MessageKey, icon: string }> = {\n  paragraph: { key: 'block.paragraph', icon: 'i-lucide-pilcrow' },\n  bulletList: { key: 'block.bulletList', icon: 'i-lucide-list' },\n  orderedList: { key: 'block.orderedList', icon: 'i-lucide-list-ordered' },\n  blockquote: { key: 'block.blockquote', icon: 'i-lucide-text-quote' },\n  codeBlock: { key: 'block.codeBlock', icon: 'i-lucide-square-code' },\n}\n\n/**\n * The standard conversions: paragraphs, headings, lists, quotes and code blocks into each other. Declines every other\n * target, so features that add targets (speaker segments, composites) own them in their own providers.\n */\nexport const coreConversions: ConversionProvider = {\n  targets: (_editor, node) => coreConversionTargets(node),\n  parseTarget: parseCoreTarget,\n  label: (target, t) => {\n    if (target.type === 'heading') return { label: t('block.heading', { level: target.level }), icon: `i-lucide-heading-${target.level}` }\n    const core = isCoreTarget(target) ? CORE_LABELS[target.type] : undefined\n    return core ? { label: t(core.key), icon: core.icon } : null\n  },\n  convert: (state, $start, target) => {\n    const node = $start.nodeAfter\n    if (!node) return null\n    const blocks = convertCoreBlocks(state.schema, [node], target)\n    return blocks ? { from: $start.pos, to: $start.pos + node.nodeSize, blocks } : null\n  },\n}\n\n/** The provider that owns `target`: the first, in feature order, that parses its id. */\nexport function targetOwner(providers: readonly ConversionProvider[], target: ConvertTarget): ConversionProvider | undefined {\n  const id = convertTargetId(target)\n  return providers.find(provider => provider.parseTarget(id) !== null)\n}\n\n/** The target `id` names, by its owner; null when no provider knows it. */\nexport function parseConversionTarget(providers: readonly ConversionProvider[], id: string): ConvertTarget | null {\n  for (const provider of providers) {\n    const target = provider.parseTarget(id)\n    if (target) return target\n  }\n  return null\n}\n\n/** Label (in the language of `t`) and icon of `target`, from its owner. */\nexport function conversionLabel(providers: readonly ConversionProvider[], target: ConvertTarget, t: Translate): { label: string, icon: string } {\n  const label = targetOwner(providers, target)?.label(target, t)\n  if (!label) throw new Error(`@ecsplico/editor: no conversion provider owns the target \"${convertTargetId(target)}\"`)\n  return label\n}\n\n/** The targets offered for `node` per provider, in feature order; a target id offered twice is an error. */\nexport function conversionTargetGroups(providers: readonly ConversionProvider[], editor: Editor, node: PMNode): ConvertTarget[][] {\n  const offered = new Set<string>()\n  return providers.map(provider => provider.targets(editor, node).filter((target) => {\n    const id = convertTargetId(target)\n    if (offered.has(id)) throw new Error(`@ecsplico/editor: the conversion target \"${id}\" is advertised by more than one provider`)\n    offered.add(id)\n    return true\n  }))\n}\n\n/** The `$pos` right in front of the block to convert; a chrome node stands for its parent block. */\nfunction blockStart(state: EditorState, pos: number | undefined): ResolvedPos | null {\n  let $start: ResolvedPos\n  if (pos === undefined) {\n    // The caret's block whose parent is a block container (the document, a composite).\n    const { $head } = state.selection\n    let depth = $head.depth\n    while (depth > 0 && !isBlockContainer($head.node(depth - 1))) depth--\n    if (depth === 0) return null\n    $start = state.doc.resolve($head.before(depth))\n  }\n  else {\n    if (pos < 0 || pos >= state.doc.content.size) return null\n    $start = state.doc.resolve(pos)\n  }\n  const node = $start.nodeAfter\n  if (!node) return null\n  return isChromeNode(node) ? state.doc.resolve($start.before()) : $start\n}\n\n/**\n * The conversion of the block right after `$start` into `target`: the range it replaces and the converted blocks.\n * A provider claiming the source block (`handlesSource`) executes; otherwise the target's owner does. Null when the\n * conversion changes nothing or the result does not fit there (`parent.canReplace`). Shared by `convertBlockTo` and\n * the chat's `convert` op.\n */\nexport function blockConversion(providers: readonly ConversionProvider[], state: EditorState, $start: ResolvedPos, target: ConvertTarget): { from: number, to: number, blocks: PMNode[] } | null {\n  const node = $start.nodeAfter\n  if (!node) return null\n  const provider = providers.find(candidate => candidate.handlesSource?.(node)) ?? targetOwner(providers, target)\n  const conversion = provider?.convert(state, $start, target)\n  if (!conversion) return null\n  const parent = $start.parent\n  const $end = state.doc.resolve(conversion.to)\n  if ($end.parent !== parent || !parent.canReplace($start.index(), $end.index(), Fragment.from(conversion.blocks))) return null\n  return conversion\n}\n\n/**\n * Client-only, no schema: the `convertBlockTo` command over the preset's conversion providers — the „Umwandeln in …“\n * block action and the toolbar's conversion groups. One transaction, so one undo step.\n */\nexport const BlockConvert = Extension.create({\n  name: 'blockConvert',\n\n  addCommands() {\n    return {\n      convertBlockTo: (target, pos) => ({ editor, state, tr, dispatch }) => {\n        const $start = blockStart(state, pos)\n        const conversion = $start && blockConversion(conversionsOf(editor), state, $start, target)\n        if (!conversion) return false\n        if (dispatch) {\n          tr.replaceWith(conversion.from, conversion.to, conversion.blocks)\n          const $first = tr.doc.resolve(conversion.from)\n          tr.setSelection(Selection.findFrom($first, 1, true) ?? Selection.near($first)).scrollIntoView()\n        }\n        return true\n      },\n    }\n  },\n})\n\n/**\n * „Umwandeln in …“ entries for the block `target`: the targets the providers offer whose type the block's container\n * allows (`TYPE_ABILITIES`), one separated group per provider in feature order. A list item stands for its list.\n */\nexport function convertMenuItems(editor: Editor, target: BlockTarget, t: Translate): MenuItem[] {\n  let { node, pos } = target\n  if (node.type.name === 'listItem') {\n    const $item = editor.state.doc.resolve(pos)\n    node = $item.parent\n    pos = $item.before()\n  }\n  const providers = conversionsOf(editor)\n  const abilities = abilitiesAt(editor, pos)\n  const groups = conversionTargetGroups(providers, editor, node)\n    .map(targets => targets\n      .filter(to => !TYPE_ABILITIES[to.type] || abilities.has(TYPE_ABILITIES[to.type]!))\n      .map((to): MenuItem => ({\n        ...conversionLabel(providers, to, t),\n        onSelect: () => editor.chain().focus().convertBlockTo(to, pos).run(),\n      })))\n    .filter(items => items.length > 0)\n  return groups.flatMap((items, index) => index ? [{ type: 'separator' } as const, ...items] : items)\n}\n"],"mappings":"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"}

package/dist/core/block-drag.d.ts

@@ -0,0 +1,12 @@
+import { Editor } from "@tiptap/core";
+//#region src/core/block-drag.d.ts
+/**
+ * Starts a drag of the block at `pos` from a drag source outside the editor's DOM (the kind icon of a composite, a
+ * permanent drag handle), the way the upstream drag handle does it: the block becomes the `NodeSelection`, the drag
+ * image is a styled clone of the block, and `view.dragging` tells ProseMirror that dropping inside the editor moves the
+ * node (`Alt` copies it). Call it from the source's `dragstart`; returns false, and starts nothing, when the editor is
+ * read-only or `pos` holds no selectable block.
+ */
+export declare function startBlockDrag(editor: Editor, event: DragEvent, pos: number): boolean;
+//#endregion
+//# sourceMappingURL=block-drag.d.ts.map

package/dist/core/block-drag.js

@@ -0,0 +1,62 @@
+import { NodeSelection } from "@tiptap/pm/state";
+//#region src/core/block-drag.ts
+/** The element with every computed style written inline, so it looks the same outside the editor's stylesheet scope. */
+function cloneWithStyles(source) {
+	const clone = source.cloneNode(true);
+	const from = [source, ...source.getElementsByTagName("*")];
+	const to = [clone, ...clone.getElementsByTagName("*")];
+	from.forEach((element, index) => {
+		const style = getComputedStyle(element);
+		const target = to[index];
+		if (target) target.style.cssText = Array.from(style, (name) => `${name}:${style.getPropertyValue(name)};`).join("");
+	});
+	return clone;
+}
+/**
+* Starts a drag of the block at `pos` from a drag source outside the editor's DOM (the kind icon of a composite, a
+* permanent drag handle), the way the upstream drag handle does it: the block becomes the `NodeSelection`, the drag
+* image is a styled clone of the block, and `view.dragging` tells ProseMirror that dropping inside the editor moves the
+* node (`Alt` copies it). Call it from the source's `dragstart`; returns false, and starts nothing, when the editor is
+* read-only or `pos` holds no selectable block.
+*/
+function startBlockDrag(editor, event, pos) {
+	const { view } = editor;
+	const { dataTransfer } = event;
+	const node = view.state.doc.nodeAt(pos);
+	const dom = view.nodeDOM(pos);
+	if (!editor.isEditable || !dataTransfer || !node || !NodeSelection.isSelectable(node) || !(dom instanceof HTMLElement)) return false;
+	const selection = NodeSelection.create(view.state.doc, pos);
+	const direction = getComputedStyle(dom).direction;
+	const clone = cloneWithStyles(dom);
+	clone.style.margin = "0";
+	const preview = document.createElement("div");
+	preview.setAttribute("dir", direction);
+	preview.style.position = "absolute";
+	preview.style.top = "-10000px";
+	preview.append(clone);
+	document.body.append(preview);
+	dataTransfer.clearData();
+	dataTransfer.setData("text/plain", node.textContent);
+	dataTransfer.effectAllowed = "copyMove";
+	dataTransfer.setDragImage(preview, direction === "rtl" ? preview.getBoundingClientRect().width : 0, 0);
+	const dragging = {
+		slice: selection.content(),
+		move: true,
+		node: selection
+	};
+	view.dragging = dragging;
+	view.dispatch(view.state.tr.setSelection(selection));
+	const end = () => {
+		preview.remove();
+		if (view.dragging === dragging) view.dragging = null;
+		document.removeEventListener("drop", end);
+		document.removeEventListener("dragend", end);
+	};
+	document.addEventListener("drop", end);
+	document.addEventListener("dragend", end);
+	return true;
+}
+//#endregion
+export { startBlockDrag };
+
+//# sourceMappingURL=block-drag.js.map

package/dist/core/block-drag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-drag.js","names":[],"sources":["../../src/core/block-drag.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { NodeSelection } from '@tiptap/pm/state'\n\n/** The element with every computed style written inline, so it looks the same outside the editor's stylesheet scope. */\nfunction cloneWithStyles(source: HTMLElement): HTMLElement {\n  const clone = source.cloneNode(true) as HTMLElement\n  const from = [source, ...source.getElementsByTagName('*')]\n  const to = [clone, ...clone.getElementsByTagName('*')] as HTMLElement[]\n  from.forEach((element, index) => {\n    const style = getComputedStyle(element)\n    const target = to[index]\n    if (target) target.style.cssText = Array.from(style, name => `${name}:${style.getPropertyValue(name)};`).join('')\n  })\n  return clone\n}\n\n/**\n * Starts a drag of the block at `pos` from a drag source outside the editor's DOM (the kind icon of a composite, a\n * permanent drag handle), the way the upstream drag handle does it: the block becomes the `NodeSelection`, the drag\n * image is a styled clone of the block, and `view.dragging` tells ProseMirror that dropping inside the editor moves the\n * node (`Alt` copies it). Call it from the source's `dragstart`; returns false, and starts nothing, when the editor is\n * read-only or `pos` holds no selectable block.\n */\nexport function startBlockDrag(editor: Editor, event: DragEvent, pos: number): boolean {\n  const { view } = editor\n  const { dataTransfer } = event\n  const node = view.state.doc.nodeAt(pos)\n  const dom = view.nodeDOM(pos)\n  if (!editor.isEditable || !dataTransfer || !node || !NodeSelection.isSelectable(node) || !(dom instanceof HTMLElement)) return false\n\n  const selection = NodeSelection.create(view.state.doc, pos)\n  const direction = getComputedStyle(dom).direction\n  const clone = cloneWithStyles(dom)\n  clone.style.margin = '0'\n  const preview = document.createElement('div')\n  preview.setAttribute('dir', direction)\n  preview.style.position = 'absolute'\n  preview.style.top = '-10000px'\n  preview.append(clone)\n  document.body.append(preview)\n\n  dataTransfer.clearData()\n  dataTransfer.setData('text/plain', node.textContent)\n  dataTransfer.effectAllowed = 'copyMove'\n  dataTransfer.setDragImage(preview, direction === 'rtl' ? preview.getBoundingClientRect().width : 0, 0)\n\n  // `node` is read by ProseMirror's drop handler to delete exactly the dragged node, but is not in the public type.\n  const dragging = { slice: selection.content(), move: true, node: selection } as typeof view.dragging\n  view.dragging = dragging\n  view.dispatch(view.state.tr.setSelection(selection))\n\n  // The source may be gone after a drop (its overlay re-renders), and then sends no `dragend`: listen on the document.\n  const end = () => {\n    preview.remove()\n    if (view.dragging === dragging) view.dragging = null\n    document.removeEventListener('drop', end)\n    document.removeEventListener('dragend', end)\n  }\n  document.addEventListener('drop', end)\n  document.addEventListener('dragend', end)\n  return true\n}\n"],"mappings":";;;AAIA,SAAS,gBAAgB,QAAkC;CACzD,MAAM,QAAQ,OAAO,UAAU,IAAI;CACnC,MAAM,OAAO,CAAC,QAAQ,GAAG,OAAO,qBAAqB,GAAG,CAAC;CACzD,MAAM,KAAK,CAAC,OAAO,GAAG,MAAM,qBAAqB,GAAG,CAAC;CACrD,KAAK,SAAS,SAAS,UAAU;EAC/B,MAAM,QAAQ,iBAAiB,OAAO;EACtC,MAAM,SAAS,GAAG;EAClB,IAAI,QAAQ,OAAO,MAAM,UAAU,MAAM,KAAK,QAAO,SAAQ,GAAG,KAAK,GAAG,MAAM,iBAAiB,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,EAAE;CAClH,CAAC;CACD,OAAO;AACT;;;;;;;;AASA,SAAgB,eAAe,QAAgB,OAAkB,KAAsB;CACrF,MAAM,EAAE,SAAS;CACjB,MAAM,EAAE,iBAAiB;CACzB,MAAM,OAAO,KAAK,MAAM,IAAI,OAAO,GAAG;CACtC,MAAM,MAAM,KAAK,QAAQ,GAAG;CAC5B,IAAI,CAAC,OAAO,cAAc,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,aAAa,IAAI,KAAK,EAAE,eAAe,cAAc,OAAO;CAE/H,MAAM,YAAY,cAAc,OAAO,KAAK,MAAM,KAAK,GAAG;CAC1D,MAAM,YAAY,iBAAiB,GAAG,CAAC,CAAC;CACxC,MAAM,QAAQ,gBAAgB,GAAG;CACjC,MAAM,MAAM,SAAS;CACrB,MAAM,UAAU,SAAS,cAAc,KAAK;CAC5C,QAAQ,aAAa,OAAO,SAAS;CACrC,QAAQ,MAAM,WAAW;CACzB,QAAQ,MAAM,MAAM;CACpB,QAAQ,OAAO,KAAK;CACpB,SAAS,KAAK,OAAO,OAAO;CAE5B,aAAa,UAAU;CACvB,aAAa,QAAQ,cAAc,KAAK,WAAW;CACnD,aAAa,gBAAgB;CAC7B,aAAa,aAAa,SAAS,cAAc,QAAQ,QAAQ,sBAAsB,CAAC,CAAC,QAAQ,GAAG,CAAC;CAGrG,MAAM,WAAW;EAAE,OAAO,UAAU,QAAQ;EAAG,MAAM;EAAM,MAAM;CAAU;CAC3E,KAAK,WAAW;CAChB,KAAK,SAAS,KAAK,MAAM,GAAG,aAAa,SAAS,CAAC;CAGnD,MAAM,YAAY;EAChB,QAAQ,OAAO;EACf,IAAI,KAAK,aAAa,UAAU,KAAK,WAAW;EAChD,SAAS,oBAAoB,QAAQ,GAAG;EACxC,SAAS,oBAAoB,WAAW,GAAG;CAC7C;CACA,SAAS,iBAAiB,QAAQ,GAAG;CACrC,SAAS,iBAAiB,WAAW,GAAG;CACxC,OAAO;AACT"}

package/dist/core/block-flash.d.ts

@@ -0,0 +1,19 @@
+import { Extension } from "@tiptap/core";
+//#region src/core/block-flash.d.ts
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    blockFlash: {
+      /** Scrolls block `id` into view and briefly highlights it (local decoration); false when the block is gone. */
+      revealBlock: (id: string) => ReturnType;
+    };
+  }
+}
+/**
+ * Client-only reveal of a block by its ID (quote links of the document chat): scrolls to it and highlights it with the
+ * `block-flash` class. The highlight is a local decoration, so neither Yjs nor other users see it.
+ */
+export declare const BlockFlash: Extension<object, {
+  timer: number | undefined;
+}>;
+//#endregion
+//# sourceMappingURL=block-flash.d.ts.map

package/dist/core/block-flash.js

@@ -0,0 +1,66 @@
+import { findBlockById } from "./schema/block-ids.js";
+import { Extension } from "@tiptap/core";
+import { Plugin, PluginKey } from "@tiptap/pm/state";
+import { Decoration, DecorationSet } from "@tiptap/pm/view";
+//#region src/core/block-flash.ts
+/** Keep in sync with the `block-flash` animations in editor.css. */
+const FLASH_MS = 1600;
+const blockFlashKey = new PluginKey("blockFlash");
+/**
+* Client-only reveal of a block by its ID (quote links of the document chat): scrolls to it and highlights it with the
+* `block-flash` class. The highlight is a local decoration, so neither Yjs nor other users see it.
+*/
+const BlockFlash = Extension.create({
+	name: "blockFlash",
+	addStorage() {
+		return { timer: void 0 };
+	},
+	onDestroy() {
+		clearTimeout(this.storage.timer);
+	},
+	addCommands() {
+		return { revealBlock: (id) => ({ editor, view, state, tr, dispatch }) => {
+			const found = findBlockById(tr.doc, id);
+			if (!found) return false;
+			if (!dispatch) return true;
+			const dom = view.nodeDOM(found.pos);
+			if (dom instanceof HTMLElement) dom.scrollIntoView({
+				behavior: "smooth",
+				block: "center"
+			});
+			const alt = !blockFlashKey.getState(state)?.alt;
+			tr.setMeta(blockFlashKey, {
+				id,
+				alt
+			}).setMeta("addToHistory", false);
+			clearTimeout(this.storage.timer);
+			this.storage.timer = window.setTimeout(() => {
+				if (!editor.isDestroyed) editor.view.dispatch(editor.state.tr.setMeta(blockFlashKey, null).setMeta("addToHistory", false));
+			}, FLASH_MS);
+			return true;
+		} };
+	},
+	addProseMirrorPlugins() {
+		return [new Plugin({
+			key: blockFlashKey,
+			state: {
+				init: () => null,
+				apply: (tr, flash) => {
+					const meta = tr.getMeta(blockFlashKey);
+					return meta === void 0 ? flash : meta;
+				}
+			},
+			props: { decorations(state) {
+				const flash = blockFlashKey.getState(state);
+				const found = flash ? findBlockById(state.doc, flash.id) : null;
+				if (!found) return null;
+				const className = flash.alt ? "block-flash block-flash--alt" : "block-flash";
+				return DecorationSet.create(state.doc, [Decoration.node(found.pos, found.pos + found.node.nodeSize, { class: className })]);
+			} }
+		})];
+	}
+});
+//#endregion
+export { BlockFlash };
+
+//# sourceMappingURL=block-flash.js.map

package/dist/core/block-flash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block-flash.js","names":[],"sources":["../../src/core/block-flash.ts"],"sourcesContent":["import { Extension } from '@tiptap/core'\nimport { Plugin, PluginKey } from '@tiptap/pm/state'\nimport { Decoration, DecorationSet } from '@tiptap/pm/view'\nimport { findBlockById } from './schema/block-ids'\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    blockFlash: {\n      /** Scrolls block `id` into view and briefly highlights it (local decoration); false when the block is gone. */\n      revealBlock: (id: string) => ReturnType\n    }\n  }\n}\n\n/** Keep in sync with the `block-flash` animations in editor.css. */\nconst FLASH_MS = 1600\n\n/** The highlighted block; `alt` flips on every reveal, which switches the animation and so restarts it. */\ninterface FlashState { id: string, alt: boolean }\n\nconst blockFlashKey = new PluginKey<FlashState | null>('blockFlash')\n\n/**\n * Client-only reveal of a block by its ID (quote links of the document chat): scrolls to it and highlights it with the\n * `block-flash` class. The highlight is a local decoration, so neither Yjs nor other users see it.\n */\nexport const BlockFlash = Extension.create<object, { timer: number | undefined }>({\n  name: 'blockFlash',\n\n  addStorage() {\n    return { timer: undefined }\n  },\n\n  onDestroy() {\n    clearTimeout(this.storage.timer)\n  },\n\n  addCommands() {\n    return {\n      revealBlock: id => ({ editor, view, state, tr, dispatch }) => {\n        const found = findBlockById(tr.doc, id)\n        if (!found) return false\n        if (!dispatch) return true\n        const dom = view.nodeDOM(found.pos)\n        if (dom instanceof HTMLElement) dom.scrollIntoView({ behavior: 'smooth', block: 'center' })\n        const alt = !blockFlashKey.getState(state)?.alt\n        tr.setMeta(blockFlashKey, { id, alt } satisfies FlashState).setMeta('addToHistory', false)\n        clearTimeout(this.storage.timer)\n        this.storage.timer = window.setTimeout(() => {\n          if (!editor.isDestroyed) editor.view.dispatch(editor.state.tr.setMeta(blockFlashKey, null).setMeta('addToHistory', false))\n        }, FLASH_MS)\n        return true\n      },\n    }\n  },\n\n  addProseMirrorPlugins() {\n    return [\n      new Plugin<FlashState | null>({\n        key: blockFlashKey,\n        state: {\n          init: () => null,\n          apply: (tr, flash) => {\n            const meta = tr.getMeta(blockFlashKey) as FlashState | null | undefined\n            return meta === undefined ? flash : meta\n          },\n        },\n        props: {\n          decorations(state) {\n            const flash = blockFlashKey.getState(state)\n            const found = flash ? findBlockById(state.doc, flash.id) : null\n            if (!found) return null\n            const className = flash!.alt ? 'block-flash block-flash--alt' : 'block-flash'\n            return DecorationSet.create(state.doc, [Decoration.node(found.pos, found.pos + found.node.nodeSize, { class: className })])\n          },\n        },\n      }),\n    ]\n  },\n})\n"],"mappings":";;;;;;AAeA,MAAM,WAAW;AAKjB,MAAM,gBAAgB,IAAI,UAA6B,YAAY;;;;;AAMnE,MAAa,aAAa,UAAU,OAA8C;CAChF,MAAM;CAEN,aAAa;EACX,OAAO,EAAE,OAAO,KAAA,EAAU;CAC5B;CAEA,YAAY;EACV,aAAa,KAAK,QAAQ,KAAK;CACjC;CAEA,cAAc;EACZ,OAAO,EACL,cAAa,QAAO,EAAE,QAAQ,MAAM,OAAO,IAAI,eAAe;GAC5D,MAAM,QAAQ,cAAc,GAAG,KAAK,EAAE;GACtC,IAAI,CAAC,OAAO,OAAO;GACnB,IAAI,CAAC,UAAU,OAAO;GACtB,MAAM,MAAM,KAAK,QAAQ,MAAM,GAAG;GAClC,IAAI,eAAe,aAAa,IAAI,eAAe;IAAE,UAAU;IAAU,OAAO;GAAS,CAAC;GAC1F,MAAM,MAAM,CAAC,cAAc,SAAS,KAAK,CAAC,EAAE;GAC5C,GAAG,QAAQ,eAAe;IAAE;IAAI;GAAI,CAAsB,CAAC,CAAC,QAAQ,gBAAgB,KAAK;GACzF,aAAa,KAAK,QAAQ,KAAK;GAC/B,KAAK,QAAQ,QAAQ,OAAO,iBAAiB;IAC3C,IAAI,CAAC,OAAO,aAAa,OAAO,KAAK,SAAS,OAAO,MAAM,GAAG,QAAQ,eAAe,IAAI,CAAC,CAAC,QAAQ,gBAAgB,KAAK,CAAC;GAC3H,GAAG,QAAQ;GACX,OAAO;EACT,EACF;CACF;CAEA,wBAAwB;EACtB,OAAO,CACL,IAAI,OAA0B;GAC5B,KAAK;GACL,OAAO;IACL,YAAY;IACZ,QAAQ,IAAI,UAAU;KACpB,MAAM,OAAO,GAAG,QAAQ,aAAa;KACrC,OAAO,SAAS,KAAA,IAAY,QAAQ;IACtC;GACF;GACA,OAAO,EACL,YAAY,OAAO;IACjB,MAAM,QAAQ,cAAc,SAAS,KAAK;IAC1C,MAAM,QAAQ,QAAQ,cAAc,MAAM,KAAK,MAAM,EAAE,IAAI;IAC3D,IAAI,CAAC,OAAO,OAAO;IACnB,MAAM,YAAY,MAAO,MAAM,iCAAiC;IAChE,OAAO,cAAc,OAAO,MAAM,KAAK,CAAC,WAAW,KAAK,MAAM,KAAK,MAAM,MAAM,MAAM,KAAK,UAAU,EAAE,OAAO,UAAU,CAAC,CAAC,CAAC;GAC5H,EACF;EACF,CAAC,CACH;CACF;AACF,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,63 @@
+import { Locale, Messages, Translate } from "../i18n/index.js";
+import { ModelSlot } from "../settings/values.js";
+import { EditorSettings } from "../settings/index.js";
+import { Notifier } from "./notify.js";
+import { ReadonlyStore, Store } from "./store.js";
+import { $Fetch } from "ofetch";
+//#region src/core/context.d.ts
+/** Inert public AI configuration (set by the Nuxt client plugin); only the AI feature reads it. */
+export interface EditorAiConfig {
+  slots: Record<ModelSlot, string>;
+  transcription: boolean;
+}
+export interface EditorContextOptions {
+  /** HTTP client of every feature request (default: ofetch). */
+  fetch?: $Fetch;
+  settings?: {
+    /** Keep the settings per account through `GET`/`PUT /api/editor/settings`; default false (this browser only). */
+    remote?: boolean;
+  };
+  ai?: EditorAiConfig;
+  /** Shows app-level notices (e.g. model profiles); default: dropped (`silentNotifier`). */
+  notify?: Notifier;
+  /** Language of every string the editor renders (toolbar, slash menu, settings, AI, notices); default `'de'`. Fixed for the life of the context. */
+  locale?: Locale;
+  /** Overrides of single messages by key (`{ 'toolbar.bold': 'Strong' }`); the rest comes from the catalog of `locale`. */
+  messages?: Partial<Messages>;
+}
+/** What `createEditorContext` returns: shared by all editors of an app. One per app: there is no process-global state. */
+export interface EditorContext {
+  settings: Store<EditorSettings>;
+  /** True once the stored settings are usable: immediately in local mode, after the server answered in remote mode. */
+  ready: ReadonlyStore<boolean>;
+  /** True once the account's settings from the server are in effect (always false in local mode). */
+  synced: ReadonlyStore<boolean>;
+  /**
+   * Starts the account-settings load of remote mode (idempotent, no-op in local mode). The framework layers'
+   * settings hooks call it, so the server is asked only once an editor-side component needs the settings (not on a
+   * login page).
+   */
+  load: () => void;
+  fetch: $Fetch;
+  ai: EditorAiConfig | undefined;
+  /** Notices of app-level models; surfaces hand features their own `FeatureContext.notify`. */
+  notify: Notifier;
+  /** The language of the editor's strings (`options.locale`, default `'de'`). */
+  locale: Locale;
+  /** Renders a message of the catalog (with the host's `messages` applied): `t('toolbar.bold')`, `t('ai.run', { task })`. */
+  t: Translate;
+  /** Stops the persistence (store subscription and pending server write); call when the app goes away. */
+  dispose: () => void;
+}
+/**
+ * The editor context of an app: the settings shared by all editors of the app, and the HTTP client. 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()`.
+ */
+export declare function createEditorContext(options?: EditorContextOptions): EditorContext;
+//#endregion
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.js

@@ -0,0 +1,108 @@
+import { createTranslator } from "../i18n/index.js";
+import { parseEditorSettings } from "../settings/index.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). */
+const PUT_DEBOUNCE = 500;
+function readLocal() {
+	try {
+		return parseEditorSettings(JSON.parse(localStorage.getItem(STORAGE_KEY) ?? "null"));
+	} catch {
+		return parseEditorSettings(null);
+	}
+}
+function writeLocal(settings) {
+	try {
+		localStorage.setItem(STORAGE_KEY, JSON.stringify(settings));
+	} catch {}
+}
+/**
+* The editor context of an app: the settings shared by all editors of the app, and the HTTP client. 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()`.
+*/
+function createEditorContext(options = {}) {
+	const fetcher = options.fetch ?? ofetch;
+	const remoteMode = options.settings?.remote === true;
+	const settings = createStore(parseEditorSettings(null));
+	const ready = createStore(!remoteMode);
+	const synced = createStore(false);
+	let loading = false;
+	let loadRemote = () => {};
+	const load = () => {
+		if (loading) return;
+		loading = true;
+		loadRemote();
+	};
+	let dispose = () => {};
+	const locale = options.locale ?? "de";
+	const t = createTranslator(locale, options.messages);
+	const context = {
+		settings,
+		ready,
+		synced,
+		load,
+		fetch: fetcher,
+		ai: options.ai,
+		notify: options.notify ?? silentNotifier,
+		locale,
+		t,
+		dispose: () => dispose()
+	};
+	if (!("window" in globalThis)) return context;
+	settings.set(readLocal());
+	writeLocal(settings.get());
+	/** JSON of the settings the server holds, so values that came from it are not sent back. */
+	let remote = "";
+	let timer;
+	let active = true;
+	function push(value) {
+		clearTimeout(timer);
+		timer = setTimeout(() => {
+			const json = JSON.stringify(value);
+			if (json === remote) return;
+			fetcher("/api/editor/settings", {
+				method: "PUT",
+				body: value
+			}).then(() => {
+				remote = json;
+			}).catch((error) => {
+				if (error?.statusCode !== 501) console.warn(`tiptap-editor: ${t("settings.saveFailed")}`, error);
+			});
+		}, PUT_DEBOUNCE);
+	}
+	const unsubscribe = settings.subscribe((value) => {
+		writeLocal(value);
+		if (synced.get()) push(value);
+	});
+	dispose = () => {
+		active = false;
+		clearTimeout(timer);
+		unsubscribe();
+	};
+	if (!remoteMode) return context;
+	loadRemote = () => fetcher.raw("/api/editor/settings").then((response) => {
+		if (!active || response.status !== 200) return;
+		synced.set(true);
+		if (response._data) {
+			settings.set(parseEditorSettings(response._data));
+			remote = JSON.stringify(settings.get());
+		} else push(settings.get());
+	}).catch((error) => {
+		console.warn(`tiptap-editor: ${t("settings.loadFailed")}`, error);
+	}).finally(() => {
+		ready.set(true);
+	});
+	return context;
+}
+//#endregion
+export { createEditorContext };
+
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

@@ -0,0 +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"}