@ecsplico/editor 0.0.0-stage → 1.0.0

package/dist/features/comments/react/SettingsCommentsTab.js

@@ -0,0 +1,77 @@
+import { COMMENTS_LAYOUTS } from "../../../settings/values.js";
+import { useEditorI18n } from "../../../react/use-editor-i18n.js";
+import { useEditorSettings } from "../../../react/settings.js";
+import { SettingsSection } from "../../../react/SettingsSection.js";
+import { Label } from "../../../react/ui/label.js";
+import { RadioGroup, RadioGroupItem } from "../../../react/ui/radio-group.js";
+import { useId } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/features/comments/react/SettingsCommentsTab.tsx
+function layoutItems(t) {
+	return [{
+		label: t("comments.layout.margin.label"),
+		description: t("comments.layout.margin.description"),
+		value: "margin"
+	}, {
+		label: t("comments.layout.inline.label"),
+		description: t("comments.layout.inline.description"),
+		value: "inline"
+	}];
+}
+/** „Kommentare“: where the comments of a shared document are shown. */
+function SettingsCommentsTab() {
+	const { settings, update } = useEditorSettings();
+	const { t } = useEditorI18n();
+	const legend = useId();
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex flex-col gap-8",
+		children: /* @__PURE__ */ jsx(SettingsSection, {
+			title: t("comments.tab"),
+			children: /* @__PURE__ */ jsxs("div", {
+				className: "py-3",
+				children: [/* @__PURE__ */ jsx("p", {
+					id: legend,
+					className: "mb-2 text-sm font-medium text-foreground",
+					children: t("comments.layout.legend")
+				}), /* @__PURE__ */ jsx(RadioGroup, {
+					"aria-labelledby": legend,
+					orientation: "horizontal",
+					className: "flex flex-wrap gap-4",
+					value: settings.editing.commentsLayout,
+					onValueChange: (value) => {
+						const layout = COMMENTS_LAYOUTS.find((candidate) => candidate === value);
+						if (layout) update((draft) => {
+							draft.editing.commentsLayout = layout;
+						});
+					},
+					children: layoutItems(t).map((item) => /* @__PURE__ */ jsx(LayoutOption, { item }, item.value))
+				})]
+			})
+		})
+	});
+}
+function LayoutOption({ item }) {
+	const id = useId();
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex items-start gap-2",
+		children: [/* @__PURE__ */ jsx(RadioGroupItem, {
+			id,
+			value: item.value,
+			className: "mt-0.5"
+		}), /* @__PURE__ */ jsxs(Label, {
+			htmlFor: id,
+			className: "flex-col items-start gap-0.5",
+			children: [/* @__PURE__ */ jsx("span", {
+				className: "text-sm font-medium text-foreground",
+				children: item.label
+			}), /* @__PURE__ */ jsx("span", {
+				className: "text-sm font-normal text-muted-foreground",
+				children: item.description
+			})]
+		})]
+	});
+}
+//#endregion
+export { SettingsCommentsTab };
+
+//# sourceMappingURL=SettingsCommentsTab.js.map

package/dist/features/comments/react/SettingsCommentsTab.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SettingsCommentsTab.js","names":[],"sources":["../../../../src/features/comments/react/SettingsCommentsTab.tsx"],"sourcesContent":["import { useId } from 'react'\nimport { useEditorSettings } from '../../../react/settings'\nimport { SettingsSection } from '../../../react/SettingsSection'\nimport { Label } from '../../../react/ui/label'\nimport { RadioGroup, RadioGroupItem } from '../../../react/ui/radio-group'\nimport { useEditorI18n } from '../../../react/use-editor-i18n'\nimport type { Translate } from '../../../i18n'\nimport { COMMENTS_LAYOUTS, type CommentsLayout } from '../schema'\n\nfunction layoutItems(t: Translate): { label: string, description: string, value: CommentsLayout }[] {\n  return [\n    { label: t('comments.layout.margin.label'), description: t('comments.layout.margin.description'), value: 'margin' },\n    { label: t('comments.layout.inline.label'), description: t('comments.layout.inline.description'), value: 'inline' },\n  ]\n}\n\n/** „Kommentare“: where the comments of a shared document are shown. */\nexport function SettingsCommentsTab() {\n  const { settings, update } = useEditorSettings()\n  const { t } = useEditorI18n()\n  const legend = useId()\n  return (\n    <div className=\"flex flex-col gap-8\">\n      <SettingsSection title={t('comments.tab')}>\n        <div className=\"py-3\">\n          <p id={legend} className=\"mb-2 text-sm font-medium text-foreground\">{t('comments.layout.legend')}</p>\n          <RadioGroup\n            aria-labelledby={legend}\n            orientation=\"horizontal\"\n            className=\"flex flex-wrap gap-4\"\n            value={settings.editing.commentsLayout}\n            onValueChange={(value) => {\n              const layout = COMMENTS_LAYOUTS.find(candidate => candidate === value)\n              if (layout) update((draft) => { draft.editing.commentsLayout = layout })\n            }}\n          >\n            {layoutItems(t).map(item => <LayoutOption key={item.value} item={item} />)}\n          </RadioGroup>\n        </div>\n      </SettingsSection>\n    </div>\n  )\n}\n\nfunction LayoutOption({ item }: { item: ReturnType<typeof layoutItems>[number] }) {\n  const id = useId()\n  return (\n    <div className=\"flex items-start gap-2\">\n      <RadioGroupItem id={id} value={item.value} className=\"mt-0.5\" />\n      <Label htmlFor={id} className=\"flex-col items-start gap-0.5\">\n        <span className=\"text-sm font-medium text-foreground\">{item.label}</span>\n        <span className=\"text-sm font-normal text-muted-foreground\">{item.description}</span>\n      </Label>\n    </div>\n  )\n}\n"],"mappings":";;;;;;;;;AASA,SAAS,YAAY,GAA+E;CAClG,OAAO,CACL;EAAE,OAAO,EAAE,8BAA8B;EAAG,aAAa,EAAE,oCAAoC;EAAG,OAAO;CAAS,GAClH;EAAE,OAAO,EAAE,8BAA8B;EAAG,aAAa,EAAE,oCAAoC;EAAG,OAAO;CAAS,CACpH;AACF;;AAGA,SAAgB,sBAAsB;CACpC,MAAM,EAAE,UAAU,WAAW,kBAAkB;CAC/C,MAAM,EAAE,MAAM,cAAc;CAC5B,MAAM,SAAS,MAAM;CACrB,OACE,oBAAC,OAAD;EAAK,WAAU;EACb,UAAA,oBAAC,iBAAD;GAAiB,OAAO,EAAE,cAAc;GACtC,UAAA,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACE,oBAAC,KAAD;KAAG,IAAI;KAAQ,WAAU;KAA4C,UAAA,EAAE,wBAAwB;IAAK,CAAA,GACpG,oBAAC,YAAD;KACE,mBAAiB;KACjB,aAAY;KACZ,WAAU;KACV,OAAO,SAAS,QAAQ;KACxB,gBAAgB,UAAU;MACxB,MAAM,SAAS,iBAAiB,MAAK,cAAa,cAAc,KAAK;MACrE,IAAI,QAAQ,QAAQ,UAAU;OAAE,MAAM,QAAQ,iBAAiB;MAAO,CAAC;KACzE;KAEC,UAAA,YAAY,CAAC,CAAC,CAAC,KAAI,SAAQ,oBAAC,cAAD,EAAqC,KAAO,GAAzB,KAAK,KAAoB,CAAC;IAC/D,CAAA,CACT;;EACU,CAAA;CACd,CAAA;AAET;AAEA,SAAS,aAAa,EAAE,QAA0D;CAChF,MAAM,KAAK,MAAM;CACjB,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,oBAAC,gBAAD;GAAoB;GAAI,OAAO,KAAK;GAAO,WAAU;EAAU,CAAA,GAC/D,qBAAC,OAAD;GAAO,SAAS;GAAI,WAAU;GAA9B,UAAA,CACE,oBAAC,QAAD;IAAM,WAAU;IAAuC,UAAA,KAAK;GAAY,CAAA,GACxE,oBAAC,QAAD;IAAM,WAAU;IAA6C,UAAA,KAAK;GAAkB,CAAA,CAC/E;EACJ,CAAA,CAAA;;AAET"}

package/dist/features/comments/react/use-comments.d.ts

@@ -0,0 +1,17 @@
+import { CommentsActions, CommentsSnapshot } from "../model.js";
+import { Editor } from "@tiptap/core";
+//#region src/features/comments/react/use-comments.d.ts
+/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */
+export interface CommentsApi extends CommentsSnapshot, CommentsActions {
+  /** The thread's text was deleted (no `comment` mark left). */
+  isOrphan: (id: string) => boolean;
+}
+/**
+ * The comment threads of an editor for React: a thin hook over the comments model of the editor's surface (the host's
+ * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules); re-renders when the
+ * comments change. `editor` may change or be `undefined` (the hook is then
+ * idle: no Y.Doc observer).
+ */
+export declare function useComments(editor: Editor | undefined): CommentsApi;
+//#endregion
+//# sourceMappingURL=use-comments.d.ts.map

package/dist/features/comments/react/use-comments.js

@@ -0,0 +1,37 @@
+import { useStore } from "../../../react/use-store.js";
+import { createEditorCommentsModel } from "../model.js";
+import { useEffect, useMemo, useRef, useState } from "react";
+//#region src/features/comments/react/use-comments.ts
+/**
+* The comment threads of an editor for React: a thin hook over the comments model of the editor's surface (the host's
+* `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules); re-renders when the
+* comments change. `editor` may change or be `undefined` (the hook is then
+* idle: no Y.Doc observer).
+*/
+function useComments(editor) {
+	const latest = useRef(editor);
+	latest.current = editor;
+	const [model] = useState(() => createEditorCommentsModel(() => latest.current));
+	useEffect(() => {
+		model.refresh();
+		return () => model.dispose();
+	}, [model, editor]);
+	const snapshot = useStore(model.state);
+	return useMemo(() => ({
+		...snapshot,
+		isOrphan: (id) => !snapshot.ranges.has(id),
+		add: model.add,
+		reply: model.reply,
+		edit: model.edit,
+		setResolved: model.setResolved,
+		remove: model.remove,
+		removeReply: model.removeReply,
+		activate: model.activate,
+		startDraft: model.startDraft,
+		cancelDraft: model.cancelDraft
+	}), [snapshot, model]);
+}
+//#endregion
+export { useComments };
+
+//# sourceMappingURL=use-comments.js.map

package/dist/features/comments/react/use-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-comments.js","names":[],"sources":["../../../../src/features/comments/react/use-comments.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { useEffect, useMemo, useRef, useState } from 'react'\nimport { useStore } from '../../../react/use-store'\nimport { type CommentsActions, type CommentsSnapshot, createEditorCommentsModel } from '../model'\n\n/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */\nexport interface CommentsApi extends CommentsSnapshot, CommentsActions {\n  /** The thread's text was deleted (no `comment` mark left). */\n  isOrphan: (id: string) => boolean\n}\n\n/**\n * The comment threads of an editor for React: a thin hook over the comments model of the editor's surface (the host's\n * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules); re-renders when the\n * comments change. `editor` may change or be `undefined` (the hook is then\n * idle: no Y.Doc observer).\n */\nexport function useComments(editor: Editor | undefined): CommentsApi {\n  const latest = useRef(editor)\n  latest.current = editor\n  const [model] = useState(() => createEditorCommentsModel(() => latest.current))\n\n  // Paired attach and detach, so StrictMode's mount, cleanup, mount leaves exactly one observer.\n  useEffect(() => {\n    model.refresh()\n    return () => model.dispose()\n  }, [model, editor])\n\n  const snapshot = useStore(model.state)\n  return useMemo(() => ({\n    ...snapshot,\n    isOrphan: (id: string) => !snapshot.ranges.has(id),\n    add: model.add,\n    reply: model.reply,\n    edit: model.edit,\n    setResolved: model.setResolved,\n    remove: model.remove,\n    removeReply: model.removeReply,\n    activate: model.activate,\n    startDraft: model.startDraft,\n    cancelDraft: model.cancelDraft,\n  }), [snapshot, model])\n}\n"],"mappings":";;;;;;;;;;AAiBA,SAAgB,YAAY,QAAyC;CACnE,MAAM,SAAS,OAAO,MAAM;CAC5B,OAAO,UAAU;CACjB,MAAM,CAAC,SAAS,eAAe,gCAAgC,OAAO,OAAO,CAAC;CAG9E,gBAAgB;EACd,MAAM,QAAQ;EACd,aAAa,MAAM,QAAQ;CAC7B,GAAG,CAAC,OAAO,MAAM,CAAC;CAElB,MAAM,WAAW,SAAS,MAAM,KAAK;CACrC,OAAO,eAAe;EACpB,GAAG;EACH,WAAW,OAAe,CAAC,SAAS,OAAO,IAAI,EAAE;EACjD,KAAK,MAAM;EACX,OAAO,MAAM;EACb,MAAM,MAAM;EACZ,aAAa,MAAM;EACnB,QAAQ,MAAM;EACd,aAAa,MAAM;EACnB,UAAU,MAAM;EAChB,YAAY,MAAM;EAClB,aAAa,MAAM;CACrB,IAAI,CAAC,UAAU,KAAK,CAAC;AACvB"}

package/dist/features/comments/react.d.ts

@@ -0,0 +1,23 @@
+import { ReactFeature } from "../../react/EditorSurface.js";
+import "../../react/index.js";
+import { CommentsFeatureOptions } from "./feature.js";
+import { CommentBubble } from "./react/CommentBubble.js";
+import { CommentComposer } from "./react/CommentComposer.js";
+import { CommentsListMenu } from "./react/CommentsListMenu.js";
+import { CommentsMargin } from "./react/CommentsMargin.js";
+import { CommentsOverlay } from "./react/CommentsOverlay.js";
+import { CommentsPopover } from "./react/CommentsPopover.js";
+import { CommentThreadView } from "./react/CommentThreadView.js";
+import { CommentsToolbarButton } from "./react/CommentsToolbarButton.js";
+import { SettingsCommentsTab } from "./react/SettingsCommentsTab.js";
+import { CommentsApi, useComments } from "./react/use-comments.js";
+//#region src/features/comments/react.d.ts
+/**
+ * The React comments feature (shadcn): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's
+ * scroll container and binds the surface's `commentsOpen` state to its `open` prop. `options.model` backs the comments
+ * with the host's own model instead of the Y.Doc (no `collab` feature needed).
+ */
+export declare function commentsFeature(options?: CommentsFeatureOptions): ReactFeature;
+//#endregion
+export { CommentBubble, CommentComposer, CommentThreadView, type CommentsApi, CommentsListMenu, CommentsMargin, CommentsOverlay, CommentsPopover, CommentsToolbarButton, SettingsCommentsTab, useComments };
+//# sourceMappingURL=react.d.ts.map

package/dist/features/comments/react.js

@@ -0,0 +1,28 @@
+import { commentsFeatureCore } from "./feature.js";
+import { CommentBubble } from "./react/CommentBubble.js";
+import { CommentComposer } from "./react/CommentComposer.js";
+import { CommentThreadView } from "./react/CommentThreadView.js";
+import { useComments } from "./react/use-comments.js";
+import { CommentsPopover } from "./react/CommentsPopover.js";
+import { CommentsOverlay } from "./react/CommentsOverlay.js";
+import { CommentsListMenu } from "./react/CommentsListMenu.js";
+import { CommentsToolbarButton } from "./react/CommentsToolbarButton.js";
+import { SettingsCommentsTab } from "./react/SettingsCommentsTab.js";
+import { CommentsMargin } from "./react/CommentsMargin.js";
+//#region src/features/comments/react.ts
+/**
+* The React comments feature (shadcn): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's
+* scroll container and binds the surface's `commentsOpen` state to its `open` prop. `options.model` backs the comments
+* with the host's own model instead of the Y.Doc (no `collab` feature needed).
+*/
+function commentsFeature(options) {
+	return commentsFeatureCore({
+		toolbarButton: CommentsToolbarButton,
+		overlay: CommentsOverlay,
+		settingsTab: SettingsCommentsTab
+	}, options);
+}
+//#endregion
+export { CommentBubble, CommentComposer, CommentThreadView, CommentsListMenu, CommentsMargin, CommentsOverlay, CommentsPopover, CommentsToolbarButton, SettingsCommentsTab, commentsFeature, useComments };
+
+//# sourceMappingURL=react.js.map

package/dist/features/comments/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../../../src/features/comments/react.ts"],"sourcesContent":["import type { ReactFeature } from '../../react'\nimport { type CommentsFeatureOptions, commentsFeatureCore } from './feature'\nimport { CommentsOverlay } from './react/CommentsOverlay'\nimport { CommentsToolbarButton } from './react/CommentsToolbarButton'\nimport { SettingsCommentsTab } from './react/SettingsCommentsTab'\n\nexport { CommentBubble } from './react/CommentBubble'\nexport { CommentComposer } from './react/CommentComposer'\nexport { CommentsListMenu } from './react/CommentsListMenu'\nexport { CommentsMargin } from './react/CommentsMargin'\nexport { CommentsOverlay } from './react/CommentsOverlay'\nexport { CommentsPopover } from './react/CommentsPopover'\nexport { CommentThreadView } from './react/CommentThreadView'\nexport { CommentsToolbarButton } from './react/CommentsToolbarButton'\nexport { SettingsCommentsTab } from './react/SettingsCommentsTab'\nexport { type CommentsApi, useComments } from './react/use-comments'\n\n/**\n * The React comments feature (shadcn): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's\n * scroll container and binds the surface's `commentsOpen` state to its `open` prop. `options.model` backs the comments\n * with the host's own model instead of the Y.Doc (no `collab` feature needed).\n */\nexport function commentsFeature(options?: CommentsFeatureOptions): ReactFeature {\n  return commentsFeatureCore({\n    toolbarButton: CommentsToolbarButton,\n    overlay: CommentsOverlay,\n    settingsTab: SettingsCommentsTab,\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAsBA,SAAgB,gBAAgB,SAAgD;CAC9E,OAAO,oBAAoB;EACzB,eAAe;EACf,SAAS;EACT,aAAa;CACf,GAAG,OAAO;AACZ"}

package/dist/features/comments/schema.d.ts

@@ -0,0 +1,51 @@
+import { COMMENTS_LAYOUTS, CommentsLayout } from "../../settings/values.js";
+import { AuthorIdentity } from "../../core/feature.js";
+import "../../core/schema/mark-flags.js";
+import { AnyExtension, Mark } from "@tiptap/core";
+//#region src/features/comments/schema.d.ts
+/** Name of the `Y.Map` holding the comment threads in the Y.Doc, beside the document's 'default' XmlFragment. */
+export declare const COMMENTS_FIELD = "comments";
+/** Maximum lengths of a comment's or reply's text and of the quoted text a thread keeps of its range. */
+export declare const COMMENT_LIMITS: {
+  readonly text: 5000;
+  readonly quote: 200;
+};
+/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */
+export type CommentAuthor = AuthorIdentity;
+export interface CommentReply {
+  id: string;
+  author: CommentAuthor;
+  text: string;
+  /** ISO timestamps; `editedAt` once the author changed the text. */
+  createdAt: string;
+  editedAt?: string;
+}
+/**
+ * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`
+ * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the
+ * `comment` mark with the thread's `id`.
+ */
+export interface CommentThread {
+  id: string;
+  author: CommentAuthor;
+  text: string;
+  createdAt: string;
+  editedAt?: string;
+  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */
+  quote: string;
+  /** Resolved threads are kept, without highlight, until reopened. */
+  resolved: boolean;
+  replies: CommentReply[];
+}
+/**
+ * Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a
+ * client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of
+ * overlapping threads coexist on the same text; `inclusive: false` keeps text typed at the end of a range outside it.
+ * No Markdown form (`markdownInvisible`).
+ */
+export declare const CommentMark: Mark<any, any>;
+/** The comment mark of the document schema. */
+export declare const commentsSchemaExtensions: () => AnyExtension[];
+//#endregion
+export { COMMENTS_LAYOUTS, type CommentsLayout };
+//# sourceMappingURL=schema.d.ts.map

package/dist/features/comments/schema.js

@@ -0,0 +1,41 @@
+import { COMMENTS_LAYOUTS } from "../../settings/values.js";
+import { Mark, mergeAttributes } from "@tiptap/core";
+//#region src/features/comments/schema.ts
+/** Name of the `Y.Map` holding the comment threads in the Y.Doc, beside the document's 'default' XmlFragment. */
+const COMMENTS_FIELD = "comments";
+/** Maximum lengths of a comment's or reply's text and of the quoted text a thread keeps of its range. */
+const COMMENT_LIMITS = {
+	text: 5e3,
+	quote: 200
+};
+/**
+* Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a
+* client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of
+* overlapping threads coexist on the same text; `inclusive: false` keeps text typed at the end of a range outside it.
+* No Markdown form (`markdownInvisible`).
+*/
+const CommentMark = Mark.create({
+	name: "comment",
+	excludes: "",
+	inclusive: false,
+	markdownInvisible: true,
+	addAttributes() {
+		return { id: {
+			default: null,
+			parseHTML: (el) => el.getAttribute("data-comment-id"),
+			renderHTML: (attrs) => ({ "data-comment-id": attrs.id })
+		} };
+	},
+	parseHTML: () => [{ tag: "span[data-comment-id]" }],
+	renderHTML: ({ HTMLAttributes }) => [
+		"span",
+		mergeAttributes(HTMLAttributes, { class: "comment" }),
+		0
+	]
+});
+/** The comment mark of the document schema. */
+const commentsSchemaExtensions = () => [CommentMark];
+//#endregion
+export { COMMENTS_FIELD, COMMENTS_LAYOUTS, COMMENT_LIMITS, CommentMark, commentsSchemaExtensions };
+
+//# sourceMappingURL=schema.js.map

package/dist/features/comments/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/comments/schema.ts"],"sourcesContent":["import { type AnyExtension, Mark, mergeAttributes } from '@tiptap/core'\nimport type { AuthorIdentity } from '../../core/feature'\nimport '../../core/schema/mark-flags'\n\n// Vue-free and server-importable (`@ecsplico/editor/comments/schema`): the comment mark that anchors a thread to\n// text, the thread data model and the limits. The Y.Map store, the highlights and the UI live in the feature.\n\nexport { COMMENTS_LAYOUTS, type CommentsLayout } from '../../settings/values'\n\n/** Name of the `Y.Map` holding the comment threads in the Y.Doc, beside the document's 'default' XmlFragment. */\nexport const COMMENTS_FIELD = 'comments'\n\n/** Maximum lengths of a comment's or reply's text and of the quoted text a thread keeps of its range. */\nexport const COMMENT_LIMITS = { text: 5000, quote: 200 } as const\n\n/** Who wrote a comment or reply: the writing user's identity, copied in when writing. */\nexport type CommentAuthor = AuthorIdentity\n\nexport interface CommentReply {\n  id: string\n  author: CommentAuthor\n  text: string\n  /** ISO timestamps; `editedAt` once the author changed the text. */\n  createdAt: string\n  editedAt?: string\n}\n\n/**\n * A comment thread: the root comment plus its replies. Stored as a nested `Y.Map` in `ydoc.getMap(COMMENTS_FIELD)`\n * (replies as a nested `Y.Array`), so concurrent replies and edits of different users merge. Its text range is the\n * `comment` mark with the thread's `id`.\n */\nexport interface CommentThread {\n  id: string\n  author: CommentAuthor\n  text: string\n  createdAt: string\n  editedAt?: string\n  /** The commented text when the thread was created, cut to `COMMENT_LIMITS.quote`. */\n  quote: string\n  /** Resolved threads are kept, without highlight, until reopened. */\n  resolved: boolean\n  replies: CommentReply[]\n}\n\n/**\n * Anchors a comment thread to text (attribute `id` = the thread's id). Storage only: the visible highlight is a\n * client-side decoration driven by the thread's state (`Comments` extension). `excludes: ''` lets the marks of\n * overlapping threads coexist on the same text; `inclusive: false` keeps text typed at the end of a range outside it.\n * No Markdown form (`markdownInvisible`).\n */\nexport const CommentMark = Mark.create({\n  name: 'comment',\n  excludes: '',\n  inclusive: false,\n  markdownInvisible: true,\n  addAttributes() {\n    return {\n      id: {\n        default: null,\n        parseHTML: el => el.getAttribute('data-comment-id'),\n        renderHTML: attrs => ({ 'data-comment-id': attrs.id }),\n      },\n    }\n  },\n  parseHTML: () => [{ tag: 'span[data-comment-id]' }],\n  renderHTML: ({ HTMLAttributes }) => ['span', mergeAttributes(HTMLAttributes, { class: 'comment' }), 0],\n})\n\n/** The comment mark of the document schema. */\nexport const commentsSchemaExtensions = (): AnyExtension[] => [CommentMark]\n"],"mappings":";;;;AAUA,MAAa,iBAAiB;;AAG9B,MAAa,iBAAiB;CAAE,MAAM;CAAM,OAAO;AAAI;;;;;;;AAsCvD,MAAa,cAAc,KAAK,OAAO;CACrC,MAAM;CACN,UAAU;CACV,WAAW;CACX,mBAAmB;CACnB,gBAAgB;EACd,OAAO,EACL,IAAI;GACF,SAAS;GACT,YAAW,OAAM,GAAG,aAAa,iBAAiB;GAClD,aAAY,WAAU,EAAE,mBAAmB,MAAM,GAAG;EACtD,EACF;CACF;CACA,iBAAiB,CAAC,EAAE,KAAK,wBAAwB,CAAC;CAClD,aAAa,EAAE,qBAAqB;EAAC;EAAQ,gBAAgB,gBAAgB,EAAE,OAAO,UAAU,CAAC;EAAG;CAAC;AACvG,CAAC;;AAGD,MAAa,iCAAiD,CAAC,WAAW"}

package/dist/features/comments/shortcuts.js

@@ -0,0 +1,34 @@
+import { cancelCommentDraft, commentsAvailable, commentsKey, setActiveComment } from "./comments-plugin.js";
+import { Extension } from "@tiptap/core";
+//#region src/features/comments/shortcuts.ts
+/**
+* Mod-Shift-m toggles this editor's comments margin while the editor has focus (margin layout of a collaborative
+* editor only; otherwise the key is left to others, shown on the toolbar's „Kommentare“). Esc closes the inline
+* comments popover; it has to be an editor binding because ProseMirror marks every Esc in the editor as handled, which
+* a document listener (and the popover's own dismiss) then skips. Lower priority than ghost autocomplete, so Esc
+* dismisses a suggestion first.
+*/
+function commentsShortcuts(ctx) {
+	return Extension.create({
+		name: "commentsShortcuts",
+		addKeyboardShortcuts: () => ({
+			"Mod-Shift-m": ({ editor }) => {
+				if (ctx.settings.get().editing.commentsLayout !== "margin" || !commentsAvailable(editor)) return false;
+				ctx.ui.toggleComments();
+				return true;
+			},
+			Escape: ({ editor }) => {
+				if (ctx.settings.get().editing.commentsLayout !== "inline") return false;
+				const state = commentsKey.getState(editor.state);
+				if (state?.draft) cancelCommentDraft(editor);
+				else if (state?.active) setActiveComment(editor, null);
+				else return false;
+				return true;
+			}
+		})
+	});
+}
+//#endregion
+export { commentsShortcuts };
+
+//# sourceMappingURL=shortcuts.js.map

package/dist/features/comments/shortcuts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortcuts.js","names":[],"sources":["../../../src/features/comments/shortcuts.ts"],"sourcesContent":["import { type AnyExtension, Extension } from '@tiptap/core'\nimport type { FeatureContext } from '../../core'\nimport { cancelCommentDraft, commentsAvailable, commentsKey, setActiveComment } from './comments-plugin'\n\n/**\n * Mod-Shift-m toggles this editor's comments margin while the editor has focus (margin layout of a collaborative\n * editor only; otherwise the key is left to others, shown on the toolbar's „Kommentare“). Esc closes the inline\n * comments popover; it has to be an editor binding because ProseMirror marks every Esc in the editor as handled, which\n * a document listener (and the popover's own dismiss) then skips. Lower priority than ghost autocomplete, so Esc\n * dismisses a suggestion first.\n */\nexport function commentsShortcuts(ctx: FeatureContext): AnyExtension {\n  return Extension.create({\n    name: 'commentsShortcuts',\n    addKeyboardShortcuts: () => ({\n      'Mod-Shift-m': ({ editor }) => {\n        if (ctx.settings.get().editing.commentsLayout !== 'margin' || !commentsAvailable(editor)) return false\n        ctx.ui.toggleComments()\n        return true\n      },\n      Escape: ({ editor }) => {\n        if (ctx.settings.get().editing.commentsLayout !== 'inline') return false\n        const state = commentsKey.getState(editor.state)\n        if (state?.draft) cancelCommentDraft(editor)\n        else if (state?.active) setActiveComment(editor, null)\n        else return false\n        return true\n      },\n    }),\n  })\n}\n"],"mappings":";;;;;;;;;;AAWA,SAAgB,kBAAkB,KAAmC;CACnE,OAAO,UAAU,OAAO;EACtB,MAAM;EACN,6BAA6B;GAC3B,gBAAgB,EAAE,aAAa;IAC7B,IAAI,IAAI,SAAS,IAAI,CAAC,CAAC,QAAQ,mBAAmB,YAAY,CAAC,kBAAkB,MAAM,GAAG,OAAO;IACjG,IAAI,GAAG,eAAe;IACtB,OAAO;GACT;GACA,SAAS,EAAE,aAAa;IACtB,IAAI,IAAI,SAAS,IAAI,CAAC,CAAC,QAAQ,mBAAmB,UAAU,OAAO;IACnE,MAAM,QAAQ,YAAY,SAAS,OAAO,KAAK;IAC/C,IAAI,OAAO,OAAO,mBAAmB,MAAM;SACtC,IAAI,OAAO,QAAQ,iBAAiB,QAAQ,IAAI;SAChD,OAAO;IACZ,OAAO;GACT;EACF;CACF,CAAC;AACH"}

package/dist/features/comments/use-comments.d.ts

@@ -0,0 +1,37 @@
+import { AuthorIdentity } from "../../core/feature.js";
+import "../../core/index.js";
+import { CommentThread } from "./schema.js";
+import { CommentsActions, DocRange } from "./model.js";
+import { ComputedRef, MaybeRefOrGetter, Ref } from "vue";
+import { Editor } from "@tiptap/core";
+//#region src/features/comments/use-comments.d.ts
+/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */
+export interface CommentsStore extends CommentsActions {
+  /** Comments need a collaborative editor whose `Comments` extension has a user. */
+  available: ComputedRef<boolean>;
+  /** The user may compose a comment now: the default model needs an editable editor, a host model may allow readers. */
+  canComment: ComputedRef<boolean>;
+  user: ComputedRef<AuthorIdentity | null>;
+  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */
+  threads: Readonly<Ref<readonly CommentThread[]>>;
+  /** Current text range per thread id (threads without one are orphans). */
+  ranges: ComputedRef<ReadonlyMap<string, DocRange>>;
+  active: ComputedRef<string | null>;
+  /** Current range of the draft a new comment is being written for. */
+  draft: ComputedRef<DocRange | null>;
+  /** The draft's text as the new thread will keep it (`quote`). */
+  draftQuote: ComputedRef<string>;
+  /** Unresolved threads in document order, orphans last; resolved ones newest first. */
+  open: ComputedRef<readonly CommentThread[]>;
+  resolved: ComputedRef<readonly CommentThread[]>;
+  /** The thread's text was deleted (no `comment` mark left). */
+  isOrphan: (id: string) => boolean;
+}
+/**
+ * The comment threads of an editor as Vue refs: a thin hook over the comments model of the editor's surface (the host's
+ * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules). `editor` may be a ref or getter that changes or turns `undefined` (the hook is then idle: no Y.Doc
+ * observer). Stops with the current effect scope.
+ */
+export declare function useComments(editor: MaybeRefOrGetter<Editor | undefined>): CommentsStore;
+//#endregion
+//# sourceMappingURL=use-comments.d.ts.map

package/dist/features/comments/use-comments.js

@@ -0,0 +1,45 @@
+import { createEditorCommentsModel } from "./model.js";
+import { useStoreRef } from "../../vue/store-ref.js";
+import { computed, getCurrentScope, onScopeDispose, toRaw, toValue, watch } from "vue";
+//#region src/features/comments/use-comments.ts
+/**
+* The comment threads of an editor as Vue refs: a thin hook over the comments model of the editor's surface (the host's
+* `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules). `editor` may be a ref or getter that changes or turns `undefined` (the hook is then idle: no Y.Doc
+* observer). Stops with the current effect scope.
+*/
+function useComments(editor) {
+	const model = createEditorCommentsModel(() => {
+		const value = toValue(editor);
+		return value && toRaw(value);
+	});
+	const snapshot = useStoreRef(model.state);
+	if (getCurrentScope()) onScopeDispose(model.dispose);
+	watch(() => toValue(editor), () => model.refresh(), { immediate: true });
+	const { add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft } = model;
+	return {
+		available: computed(() => snapshot.value.available),
+		canComment: computed(() => snapshot.value.canComment),
+		user: computed(() => snapshot.value.user),
+		threads: computed(() => snapshot.value.threads),
+		ranges: computed(() => snapshot.value.ranges),
+		active: computed(() => snapshot.value.active),
+		draft: computed(() => snapshot.value.draft),
+		draftQuote: computed(() => snapshot.value.draftQuote),
+		open: computed(() => snapshot.value.open),
+		resolved: computed(() => snapshot.value.resolved),
+		isOrphan: (id) => !snapshot.value.ranges.has(id),
+		add,
+		reply,
+		edit,
+		setResolved,
+		remove,
+		removeReply,
+		activate,
+		startDraft,
+		cancelDraft
+	};
+}
+//#endregion
+export { useComments };
+
+//# sourceMappingURL=use-comments.js.map

package/dist/features/comments/use-comments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-comments.js","names":[],"sources":["../../../src/features/comments/use-comments.ts"],"sourcesContent":["import type { Editor } from '@tiptap/core'\nimport { computed, type ComputedRef, getCurrentScope, type MaybeRefOrGetter, onScopeDispose, type Ref, toRaw, toValue, watch } from 'vue'\nimport type { AuthorIdentity } from '../../core'\nimport { useStoreRef } from '../../vue/store-ref'\nimport { type CommentsActions, createEditorCommentsModel, type DocRange } from './model'\nimport type { CommentThread } from './schema'\n\n/** What `useComments` returns; layouts pass it on to `CommentThreadView`. */\nexport interface CommentsStore extends CommentsActions {\n  /** Comments need a collaborative editor whose `Comments` extension has a user. */\n  available: ComputedRef<boolean>\n  /** The user may compose a comment now: the default model needs an editable editor, a host model may allow readers. */\n  canComment: ComputedRef<boolean>\n  user: ComputedRef<AuthorIdentity | null>\n  /** Plain snapshots of all threads in the Y.Doc, replaced on every change. */\n  threads: Readonly<Ref<readonly CommentThread[]>>\n  /** Current text range per thread id (threads without one are orphans). */\n  ranges: ComputedRef<ReadonlyMap<string, DocRange>>\n  active: ComputedRef<string | null>\n  /** Current range of the draft a new comment is being written for. */\n  draft: ComputedRef<DocRange | null>\n  /** The draft's text as the new thread will keep it (`quote`). */\n  draftQuote: ComputedRef<string>\n  /** Unresolved threads in document order, orphans last; resolved ones newest first. */\n  open: ComputedRef<readonly CommentThread[]>\n  resolved: ComputedRef<readonly CommentThread[]>\n  /** The thread's text was deleted (no `comment` mark left). */\n  isOrphan: (id: string) => boolean\n}\n\n/**\n * The comment threads of an editor as Vue refs: a thin hook over the comments model of the editor's surface (the host's\n * `model` of `commentsFeature`, else `createCommentsModel`: see there for storage and rules). `editor` may be a ref or getter that changes or turns `undefined` (the hook is then idle: no Y.Doc\n * observer). Stops with the current effect scope.\n */\nexport function useComments(editor: MaybeRefOrGetter<Editor | undefined>): CommentsStore {\n  // The surface registry is keyed by the raw editor instance, not by a reactive proxy of it.\n  const model = createEditorCommentsModel(() => {\n    const value = toValue(editor)\n    return value && toRaw(value)\n  })\n  const snapshot = useStoreRef(model.state)\n  if (getCurrentScope()) onScopeDispose(model.dispose)\n  watch(() => toValue(editor), () => model.refresh(), { immediate: true })\n\n  const { add, reply, edit, setResolved, remove, removeReply, activate, startDraft, cancelDraft } = model\n  return {\n    available: computed(() => snapshot.value.available),\n    canComment: computed(() => snapshot.value.canComment),\n    user: computed(() => snapshot.value.user),\n    threads: computed(() => snapshot.value.threads),\n    ranges: computed(() => snapshot.value.ranges),\n    active: computed(() => snapshot.value.active),\n    draft: computed(() => snapshot.value.draft),\n    draftQuote: computed(() => snapshot.value.draftQuote),\n    open: computed(() => snapshot.value.open),\n    resolved: computed(() => snapshot.value.resolved),\n    isOrphan: id => !snapshot.value.ranges.has(id),\n    add,\n    reply,\n    edit,\n    setResolved,\n    remove,\n    removeReply,\n    activate,\n    startDraft,\n    cancelDraft,\n  }\n}\n"],"mappings":";;;;;;;;;AAmCA,SAAgB,YAAY,QAA6D;CAEvF,MAAM,QAAQ,gCAAgC;EAC5C,MAAM,QAAQ,QAAQ,MAAM;EAC5B,OAAO,SAAS,MAAM,KAAK;CAC7B,CAAC;CACD,MAAM,WAAW,YAAY,MAAM,KAAK;CACxC,IAAI,gBAAgB,GAAG,eAAe,MAAM,OAAO;CACnD,YAAY,QAAQ,MAAM,SAAS,MAAM,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;CAEvE,MAAM,EAAE,KAAK,OAAO,MAAM,aAAa,QAAQ,aAAa,UAAU,YAAY,gBAAgB;CAClG,OAAO;EACL,WAAW,eAAe,SAAS,MAAM,SAAS;EAClD,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,SAAS,eAAe,SAAS,MAAM,OAAO;EAC9C,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,QAAQ,eAAe,SAAS,MAAM,MAAM;EAC5C,OAAO,eAAe,SAAS,MAAM,KAAK;EAC1C,YAAY,eAAe,SAAS,MAAM,UAAU;EACpD,MAAM,eAAe,SAAS,MAAM,IAAI;EACxC,UAAU,eAAe,SAAS,MAAM,QAAQ;EAChD,WAAU,OAAM,CAAC,SAAS,MAAM,OAAO,IAAI,EAAE;EAC7C;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}

package/dist/features/comments/vue.d.ts

@@ -0,0 +1,20 @@
+import { VueFeature } from "../../vue/index.js";
+import { CommentsFeatureOptions } from "./feature.js";
+import _default from "./components/CommentBubble.vue.js";
+import _default$1 from "./components/CommentComposer.vue.js";
+import _default$3 from "./components/CommentsListMenu.vue.js";
+import _default$4 from "./components/CommentsMargin.vue.js";
+import _default$5 from "./components/CommentsPopover.vue.js";
+import { CommentsStore, useComments } from "./use-comments.js";
+import _default$2 from "./components/CommentThreadView.vue.js";
+import _default$6 from "./components/SettingsCommentsTab.vue.js";
+//#region src/features/comments/vue.d.ts
+/**
+ * The Vue comments feature (Nuxt UI): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's
+ * scroll container and binds the surface's `commentsOpen` model to its `open` prop. `options.model` backs the comments
+ * with the host's own model instead of the Y.Doc (no `collab` feature needed).
+ */
+export declare function commentsFeature(options?: CommentsFeatureOptions): VueFeature;
+//#endregion
+export { _default as CommentBubble, _default$1 as CommentComposer, _default$2 as CommentThreadView, _default$3 as CommentsListMenu, _default$4 as CommentsMargin, _default$5 as CommentsPopover, type CommentsStore, _default$6 as SettingsCommentsTab, useComments };
+//# sourceMappingURL=vue.d.ts.map

package/dist/features/comments/vue.js

@@ -0,0 +1,28 @@
+import { commentsFeatureCore } from "./feature.js";
+import { useComments } from "./use-comments.js";
+import _sfc_main from "./components/CommentBubble.js";
+import _sfc_main$1 from "./components/CommentComposer.js";
+import _sfc_main$2 from "./components/CommentThreadView.js";
+import _sfc_main$5 from "./components/CommentsPopover.js";
+import _sfc_main$7 from "./components/CommentsOverlay.js";
+import _sfc_main$3 from "./components/CommentsListMenu.js";
+import _sfc_main$8 from "./components/CommentsToolbarButton.js";
+import _sfc_main$6 from "./components/SettingsCommentsTab.js";
+import _sfc_main$4 from "./components/CommentsMargin.js";
+//#region src/features/comments/vue.ts
+/**
+* The Vue comments feature (Nuxt UI): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's
+* scroll container and binds the surface's `commentsOpen` model to its `open` prop. `options.model` backs the comments
+* with the host's own model instead of the Y.Doc (no `collab` feature needed).
+*/
+function commentsFeature(options) {
+	return commentsFeatureCore({
+		toolbarButton: _sfc_main$8,
+		overlay: _sfc_main$7,
+		settingsTab: _sfc_main$6
+	}, options);
+}
+//#endregion
+export { _sfc_main as CommentBubble, _sfc_main$1 as CommentComposer, _sfc_main$2 as CommentThreadView, _sfc_main$3 as CommentsListMenu, _sfc_main$4 as CommentsMargin, _sfc_main$5 as CommentsPopover, _sfc_main$6 as SettingsCommentsTab, commentsFeature, useComments };
+
+//# sourceMappingURL=vue.js.map

package/dist/features/comments/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":["CommentsToolbarButton","CommentsOverlay","SettingsCommentsTab"],"sources":["../../../src/features/comments/vue.ts"],"sourcesContent":["import type { Component } from 'vue'\nimport type { VueFeature } from '../../vue'\nimport CommentsOverlay from './components/CommentsOverlay.vue'\nimport CommentsToolbarButton from './components/CommentsToolbarButton.vue'\nimport SettingsCommentsTab from './components/SettingsCommentsTab.vue'\nimport { type CommentsFeatureOptions, commentsFeatureCore } from './feature'\n\nexport { default as CommentBubble } from './components/CommentBubble.vue'\nexport { default as CommentComposer } from './components/CommentComposer.vue'\nexport { default as CommentsListMenu } from './components/CommentsListMenu.vue'\nexport { default as CommentsMargin } from './components/CommentsMargin.vue'\nexport { default as CommentsPopover } from './components/CommentsPopover.vue'\nexport { default as CommentThreadView } from './components/CommentThreadView.vue'\nexport { default as SettingsCommentsTab } from './components/SettingsCommentsTab.vue'\nexport { type CommentsStore, useComments } from './use-comments'\n\n/**\n * The Vue comments feature (Nuxt UI): see `commentsFeatureCore`. The host places `CommentsMargin` beside the editor's\n * scroll container and binds the surface's `commentsOpen` model to its `open` prop. `options.model` backs the comments\n * with the host's own model instead of the Y.Doc (no `collab` feature needed).\n */\nexport function commentsFeature(options?: CommentsFeatureOptions): VueFeature {\n  return commentsFeatureCore<Component>({\n    toolbarButton: CommentsToolbarButton,\n    overlay: CommentsOverlay,\n    settingsTab: SettingsCommentsTab,\n  }, options)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AAqBA,SAAgB,gBAAgB,SAA8C;CAC5E,OAAO,oBAA+B;EACpC,eAAeA;EACf,SAASC;EACT,aAAaC;CACf,GAAG,OAAO;AACZ"}

package/dist/features/composites/ai-brief.d.ts

@@ -0,0 +1,31 @@
+import { Editor } from "@tiptap/core";
+//#region src/features/composites/ai-brief.d.ts
+/** What one Baustein tells the model: kind brief, place in the hierarchy, chrome, field values, resolved instruction and skeleton, body. */
+export interface CompositeAiBrief {
+  kind: {
+    id: string;
+    label: string;
+    purpose?: string;
+  };
+  /** Titles of the enclosing composites, outermost first (empty at document level). */
+  path: string[];
+  title: string;
+  description: string;
+  tags: string[];
+  /** Declared fields with a non-empty value, `select` values as their option label. */
+  fields: {
+    key: string;
+    label: string;
+    value: string;
+  }[];
+  /** `meta[ai.instructionsField]` when non-empty, else `ai.instructions`, else ''. */
+  instructions: string;
+  /** `ai.skeleton` with `{key}` replaced by the string value of `meta[key]` (declared fields only); '' without a skeleton. */
+  skeleton: string;
+  /** Body blocks as Markdown ('' for a body without text). */
+  body: string;
+}
+/** The brief of the composite at `pos`; null unless the node there is a composite whose kind has `ai`. */
+export declare function compositeAiBrief(editor: Editor, pos: number): CompositeAiBrief | null;
+//#endregion
+//# sourceMappingURL=ai-brief.d.ts.map

package/dist/features/composites/ai-brief.js

@@ -0,0 +1,56 @@
+import { compositeKind } from "./kinds.js";
+import { compositeKindsOf } from "./nodes.js";
+//#region src/features/composites/ai-brief.ts
+const PLACEHOLDER = /\{([\p{L}\p{N}_-]+)\}/gu;
+const isFilled = (value) => typeof value === "string" && value !== "" || typeof value === "number";
+/** The brief of the composite at `pos`; null unless the node there is a composite whose kind has `ai`. */
+function compositeAiBrief(editor, pos) {
+	const node = editor.state.doc.nodeAt(pos);
+	if (node?.type.name !== "composite" || node.childCount < 3) return null;
+	const kind = compositeKind(compositeKindsOf(editor), String(node.attrs.kind));
+	const ai = kind.ai;
+	if (!ai) return null;
+	const $pos = editor.state.doc.resolve(pos);
+	const path = [];
+	for (let depth = 1; depth <= $pos.depth; depth++) {
+		const ancestor = $pos.node(depth);
+		if (ancestor.type.name === "composite") path.push(ancestor.child(0).textContent.trim());
+	}
+	const tags = node.child(2).attrs.tags;
+	const body = Array.from({ length: node.childCount - 3 }, (_, i) => node.child(3 + i));
+	const meta = node.attrs.meta ?? {};
+	const fields = kind.fields.flatMap((field) => {
+		const raw = meta[field.key];
+		if (!isFilled(raw)) return [];
+		const value = String(raw);
+		return [{
+			key: field.key,
+			label: field.label,
+			value: field.type === "select" ? field.options?.find((option) => option.value === value)?.label ?? value : value
+		}];
+	});
+	const keys = new Set(kind.fields.map((field) => field.key));
+	const own = ai.instructionsField ? String(meta[ai.instructionsField] ?? "").trim() : "";
+	return {
+		kind: {
+			id: kind.id,
+			label: kind.label,
+			...ai.purpose && { purpose: ai.purpose }
+		},
+		path,
+		title: node.child(0).textContent,
+		description: node.child(1).textContent,
+		tags: Array.isArray(tags) ? tags.filter((tag) => typeof tag === "string") : [],
+		fields,
+		instructions: own || ai.instructions?.trim() || "",
+		skeleton: ai.skeleton?.replace(PLACEHOLDER, (match, key) => keys.has(key) && isFilled(meta[key]) ? String(meta[key]) : match) ?? "",
+		body: body.some((child) => child.textContent.trim()) ? editor.markdown.serialize({
+			type: "doc",
+			content: body.map((child) => child.toJSON())
+		}).trim() : ""
+	};
+}
+//#endregion
+export { compositeAiBrief };
+
+//# sourceMappingURL=ai-brief.js.map

package/dist/features/composites/ai-brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-brief.js","names":[],"sources":["../../../src/features/composites/ai-brief.ts"],"sourcesContent":["// Vue-free: what one Baustein tells the model (read by „Baustein füllen (KI)“, see `integrations/composite-ai`).\nimport type { Editor, JSONContent } from '@tiptap/core'\n// Types only: brings in the `editor.markdown` augmentation of `@tiptap/markdown` for contexts that do not otherwise load it.\nimport type {} from '@tiptap/markdown'\nimport { compositeKind } from './kinds'\nimport { COMPOSITE_CHROME_COUNT, compositeKindsOf } from './nodes'\n\n/** What one Baustein tells the model: kind brief, place in the hierarchy, chrome, field values, resolved instruction and skeleton, body. */\nexport interface CompositeAiBrief {\n  kind: { id: string, label: string, purpose?: string }\n  /** Titles of the enclosing composites, outermost first (empty at document level). */\n  path: string[]\n  title: string\n  description: string\n  tags: string[]\n  /** Declared fields with a non-empty value, `select` values as their option label. */\n  fields: { key: string, label: string, value: string }[]\n  /** `meta[ai.instructionsField]` when non-empty, else `ai.instructions`, else ''. */\n  instructions: string\n  /** `ai.skeleton` with `{key}` replaced by the string value of `meta[key]` (declared fields only); '' without a skeleton. */\n  skeleton: string\n  /** Body blocks as Markdown ('' for a body without text). */\n  body: string\n}\n\nconst PLACEHOLDER = /\\{([\\p{L}\\p{N}_-]+)\\}/gu\n\nconst isFilled = (value: unknown): value is string | number => (typeof value === 'string' && value !== '') || typeof value === 'number'\n\n/** The brief of the composite at `pos`; null unless the node there is a composite whose kind has `ai`. */\nexport function compositeAiBrief(editor: Editor, pos: number): CompositeAiBrief | null {\n  const node = editor.state.doc.nodeAt(pos)\n  if (node?.type.name !== 'composite' || node.childCount < COMPOSITE_CHROME_COUNT) return null\n  const kind = compositeKind(compositeKindsOf(editor), String(node.attrs.kind))\n  const ai = kind.ai\n  if (!ai) return null\n\n  const $pos = editor.state.doc.resolve(pos)\n  const path: string[] = []\n  for (let depth = 1; depth <= $pos.depth; depth++) {\n    const ancestor = $pos.node(depth)\n    if (ancestor.type.name === 'composite') path.push(ancestor.child(0).textContent.trim())\n  }\n\n  const tags: unknown = node.child(2).attrs.tags\n  const body = Array.from({ length: node.childCount - COMPOSITE_CHROME_COUNT }, (_, i) => node.child(COMPOSITE_CHROME_COUNT + i))\n  const meta: Record<string, unknown> = node.attrs.meta ?? {}\n\n  const fields = kind.fields.flatMap((field) => {\n    const raw = meta[field.key]\n    if (!isFilled(raw)) return []\n    const value = String(raw)\n    return [{ key: field.key, label: field.label, value: field.type === 'select' ? (field.options?.find(option => option.value === value)?.label ?? value) : value }]\n  })\n  const keys = new Set(kind.fields.map(field => field.key))\n  const own = ai.instructionsField ? String(meta[ai.instructionsField] ?? '').trim() : ''\n\n  return {\n    kind: { id: kind.id, label: kind.label, ...(ai.purpose && { purpose: ai.purpose }) },\n    path,\n    title: node.child(0).textContent,\n    description: node.child(1).textContent,\n    tags: Array.isArray(tags) ? tags.filter((tag): tag is string => typeof tag === 'string') : [],\n    fields,\n    instructions: own || ai.instructions?.trim() || '',\n    skeleton: ai.skeleton?.replace(PLACEHOLDER, (match, key: string) => keys.has(key) && isFilled(meta[key]) ? String(meta[key]) : match) ?? '',\n    body: body.some(child => child.textContent.trim())\n      ? editor.markdown!.serialize({ type: 'doc', content: body.map(child => child.toJSON() as JSONContent) }).trim()\n      : '',\n  }\n}\n"],"mappings":";;;AAyBA,MAAM,cAAc;AAEpB,MAAM,YAAY,UAA8C,OAAO,UAAU,YAAY,UAAU,MAAO,OAAO,UAAU;;AAG/H,SAAgB,iBAAiB,QAAgB,KAAsC;CACrF,MAAM,OAAO,OAAO,MAAM,IAAI,OAAO,GAAG;CACxC,IAAI,MAAM,KAAK,SAAS,eAAe,KAAK,aAAA,GAAqC,OAAO;CACxF,MAAM,OAAO,cAAc,iBAAiB,MAAM,GAAG,OAAO,KAAK,MAAM,IAAI,CAAC;CAC5E,MAAM,KAAK,KAAK;CAChB,IAAI,CAAC,IAAI,OAAO;CAEhB,MAAM,OAAO,OAAO,MAAM,IAAI,QAAQ,GAAG;CACzC,MAAM,OAAiB,CAAC;CACxB,KAAK,IAAI,QAAQ,GAAG,SAAS,KAAK,OAAO,SAAS;EAChD,MAAM,WAAW,KAAK,KAAK,KAAK;EAChC,IAAI,SAAS,KAAK,SAAS,aAAa,KAAK,KAAK,SAAS,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC;CACxF;CAEA,MAAM,OAAgB,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM;CAC1C,MAAM,OAAO,MAAM,KAAK,EAAE,QAAQ,KAAK,aAAA,EAAoC,IAAI,GAAG,MAAM,KAAK,MAAA,IAA+B,CAAC,CAAC;CAC9H,MAAM,OAAgC,KAAK,MAAM,QAAQ,CAAC;CAE1D,MAAM,SAAS,KAAK,OAAO,SAAS,UAAU;EAC5C,MAAM,MAAM,KAAK,MAAM;EACvB,IAAI,CAAC,SAAS,GAAG,GAAG,OAAO,CAAC;EAC5B,MAAM,QAAQ,OAAO,GAAG;EACxB,OAAO,CAAC;GAAE,KAAK,MAAM;GAAK,OAAO,MAAM;GAAO,OAAO,MAAM,SAAS,WAAY,MAAM,SAAS,MAAK,WAAU,OAAO,UAAU,KAAK,CAAC,EAAE,SAAS,QAAS;EAAM,CAAC;CAClK,CAAC;CACD,MAAM,OAAO,IAAI,IAAI,KAAK,OAAO,KAAI,UAAS,MAAM,GAAG,CAAC;CACxD,MAAM,MAAM,GAAG,oBAAoB,OAAO,KAAK,GAAG,sBAAsB,EAAE,CAAC,CAAC,KAAK,IAAI;CAErF,OAAO;EACL,MAAM;GAAE,IAAI,KAAK;GAAI,OAAO,KAAK;GAAO,GAAI,GAAG,WAAW,EAAE,SAAS,GAAG,QAAQ;EAAG;EACnF;EACA,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC;EACrB,aAAa,KAAK,MAAM,CAAC,CAAC,CAAC;EAC3B,MAAM,MAAM,QAAQ,IAAI,IAAI,KAAK,QAAQ,QAAuB,OAAO,QAAQ,QAAQ,IAAI,CAAC;EAC5F;EACA,cAAc,OAAO,GAAG,cAAc,KAAK,KAAK;EAChD,UAAU,GAAG,UAAU,QAAQ,cAAc,OAAO,QAAgB,KAAK,IAAI,GAAG,KAAK,SAAS,KAAK,IAAI,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK;EACzI,MAAM,KAAK,MAAK,UAAS,MAAM,YAAY,KAAK,CAAC,IAC7C,OAAO,SAAU,UAAU;GAAE,MAAM;GAAO,SAAS,KAAK,KAAI,UAAS,MAAM,OAAO,CAAgB;EAAE,CAAC,CAAC,CAAC,KAAK,IAC5G;CACN;AACF"}