@ecsplico/editor 3.4.0 → 3.5.1

package/dist/features/image-studio/react/store.js

@@ -0,0 +1,46 @@
+import { createImageStudioNodeCore } from "../node-core.js";
+import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+//#region src/features/image-studio/react/store.ts
+const noUnsubscribe = () => {};
+/**
+* The `ImageStudioReactStore` of one `imageStudio` node (the React wrapper of `createImageStudioNodeCore`): `state`
+* follows the node's `studio` attribute, `update` writes it back as one transaction, the rest goes to
+* `backend.images`. The core lives for as long as the component and the `editor`, `backend` and `documentId` stay the
+* same; the first render returns `undefined` (the core is built in an effect), so render the dialog once there is a store.
+*/
+function useImageStudioNodeStore(options) {
+	const { editor, backend, documentId } = options;
+	const getPos = useRef(options.getPos);
+	getPos.current = options.getPos;
+	const [core, setCore] = useState();
+	useEffect(() => {
+		const own = createImageStudioNodeCore({
+			editor,
+			backend,
+			documentId,
+			getPos: () => getPos.current()
+		});
+		setCore(own);
+		return () => {
+			own.dispose();
+			setCore(void 0);
+		};
+	}, [
+		editor,
+		backend,
+		documentId
+	]);
+	const subscribe = useCallback((listener) => core ? core.subscribe(listener) : noUnsubscribe, [core]);
+	const getSnapshot = useCallback(() => core?.get(), [core]);
+	const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+	return useMemo(() => core && snapshot ? {
+		...snapshot,
+		update: core.update,
+		generate: core.generate,
+		upload: core.upload
+	} : void 0, [core, snapshot]);
+}
+//#endregion
+export { useImageStudioNodeStore };
+
+//# sourceMappingURL=store.js.map

package/dist/features/image-studio/react/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","names":[],"sources":["../../../../src/features/image-studio/react/store.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from 'react'\nimport { createImageStudioNodeCore, type ImageStudioNodeCore, type ImageStudioNodeCoreOptions } from '../node-core'\nimport type { ImageStudioImage, ImageStudioPromptBlock, ImageStudioState } from '../state'\n\n/**\n * What the React Bild-Studio dialog drives; a host supplies it. The same contract as the Vue `ImageStudioStore`, with\n * plain values where Vue has refs: the host re-renders the dialog with a new `state` after `update`.\n *\n * The dialog applies the reducers of `../state` and hands the result to `update`; the store only persists it. The\n * store's methods never touch `state` themselves:\n * - `update` must lead to a new `state` (the dialog keeps working on its own latest value until `state` changes).\n * - `generate` produces one image from the block's `state.description`, the active Prompt-Bausteine and the active\n *   images (the host builds the prompt). When it resolves, the dialog calls `update(addGeneration(state, image, turn))`;\n *   when it rejects (and the signal was not aborted) the dialog appends a turn with `imageId: null` and the message as\n *   `problem`. An aborted generation adds nothing.\n * - `upload` stores the file and returns the image; the dialog then calls `update(addReference(state, image))`.\n * - `problem` is a problem of the store itself (the Prompt-Bausteine could not be loaded, say); the dialog shows it as a notice.\n */\nexport interface ImageStudioReactStore {\n  readonly state: ImageStudioState\n  /** The managed list of Prompt-Bausteine, loaded by the host. */\n  readonly promptBlocks: readonly ImageStudioPromptBlock[]\n  /** Called with the state after a reducer; the host persists it. */\n  update: (next: ImageStudioState) => void\n  generate: (instruction: string, signal: AbortSignal) => Promise<ImageStudioImage>\n  upload: (file: File) => Promise<ImageStudioImage>\n  readonly problem: string | undefined\n}\n\nconst noUnsubscribe = () => {}\n\n/**\n * The `ImageStudioReactStore` of one `imageStudio` node (the React wrapper of `createImageStudioNodeCore`): `state`\n * follows the node's `studio` attribute, `update` writes it back as one transaction, the rest goes to\n * `backend.images`. The core lives for as long as the component and the `editor`, `backend` and `documentId` stay the\n * same; the first render returns `undefined` (the core is built in an effect), so render the dialog once there is a store.\n */\nexport function useImageStudioNodeStore(options: ImageStudioNodeCoreOptions): ImageStudioReactStore | undefined {\n  const { editor, backend, documentId } = options\n  const getPos = useRef(options.getPos)\n  getPos.current = options.getPos\n  const [core, setCore] = useState<ImageStudioNodeCore>()\n  useEffect(() => {\n    const own = createImageStudioNodeCore({ editor, backend, documentId, getPos: () => getPos.current() })\n    setCore(own)\n    return () => {\n      own.dispose()\n      setCore(undefined)\n    }\n  }, [editor, backend, documentId])\n  const subscribe = useCallback((listener: () => void) => core ? core.subscribe(listener) : noUnsubscribe, [core])\n  const getSnapshot = useCallback(() => core?.get(), [core])\n  const snapshot = useSyncExternalStore(subscribe, getSnapshot, getSnapshot)\n  return useMemo(\n    () => core && snapshot ? { ...snapshot, update: core.update, generate: core.generate, upload: core.upload } : undefined,\n    [core, snapshot],\n  )\n}\n"],"mappings":";;;AA6BA,MAAM,sBAAsB,CAAC;;;;;;;AAQ7B,SAAgB,wBAAwB,SAAwE;CAC9G,MAAM,EAAE,QAAQ,SAAS,eAAe;CACxC,MAAM,SAAS,OAAO,QAAQ,MAAM;CACpC,OAAO,UAAU,QAAQ;CACzB,MAAM,CAAC,MAAM,WAAW,SAA8B;CACtD,gBAAgB;EACd,MAAM,MAAM,0BAA0B;GAAE;GAAQ;GAAS;GAAY,cAAc,OAAO,QAAQ;EAAE,CAAC;EACrG,QAAQ,GAAG;EACX,aAAa;GACX,IAAI,QAAQ;GACZ,QAAQ,KAAA,CAAS;EACnB;CACF,GAAG;EAAC;EAAQ;EAAS;CAAU,CAAC;CAChC,MAAM,YAAY,aAAa,aAAyB,OAAO,KAAK,UAAU,QAAQ,IAAI,eAAe,CAAC,IAAI,CAAC;CAC/G,MAAM,cAAc,kBAAkB,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC;CACzD,MAAM,WAAW,qBAAqB,WAAW,aAAa,WAAW;CACzE,OAAO,cACC,QAAQ,WAAW;EAAE,GAAG;EAAU,QAAQ,KAAK;EAAQ,UAAU,KAAK;EAAU,QAAQ,KAAK;CAAO,IAAI,KAAA,GAC9G,CAAC,MAAM,QAAQ,CACjB;AACF"}

package/dist/features/image-studio/react.d.ts

@@ -0,0 +1,18 @@
+import { ImageStudioImage, ImageStudioPromptBlock } from "../../core/backend-types.js";
+import { ReactFeature } from "../../react/EditorSurface.js";
+import "../../react/index.js";
+import { EMPTY_IMAGE_STUDIO_STATE, ImageStudioState, ImageStudioTurn, addGeneration, addReference, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock } from "./state.js";
+import { ImageStudioNodeCore, ImageStudioNodeCoreOptions, ImageStudioNodeSnapshot, createImageStudioNodeCore } from "./node-core.js";
+import { ImageStudioReactStore, useImageStudioNodeStore } from "./react/store.js";
+import { ImageStudioDialog } from "./react/ImageStudioDialog.js";
+//#region src/features/image-studio/react.d.ts
+/**
+ * The React Bild-Studio feature (shadcn): the `imageStudio` block with its React view (picture or description
+ * placeholder, opens the studio dialog on double-click and through the block action `image-studio.open`), the `/` entry
+ * `bild-studio` and the action. Generation, upload and the Prompt-Bausteine need a backend with the `images`
+ * capability; without it the view says that generation is not set up.
+ */
+export declare function imageStudioFeature(): ReactFeature;
+//#endregion
+export { EMPTY_IMAGE_STUDIO_STATE, ImageStudioDialog, type ImageStudioImage, type ImageStudioNodeCore, type ImageStudioNodeCoreOptions, type ImageStudioNodeSnapshot, type ImageStudioPromptBlock, type ImageStudioReactStore, type ImageStudioState, type ImageStudioTurn, addGeneration, addReference, createImageStudioNodeCore, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock, useImageStudioNodeStore };
+//# sourceMappingURL=react.d.ts.map

package/dist/features/image-studio/react.js

@@ -0,0 +1,21 @@
+import { EMPTY_IMAGE_STUDIO_STATE, addGeneration, addReference, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock } from "./state.js";
+import { imageStudioFeatureCore } from "./feature.js";
+import { ImageStudioDialog } from "./react/ImageStudioDialog.js";
+import { createImageStudioNodeCore } from "./node-core.js";
+import { useImageStudioNodeStore } from "./react/store.js";
+import { ImageStudioView } from "./react/ImageStudioView.js";
+import { ReactNodeViewRenderer } from "@tiptap/react";
+//#region src/features/image-studio/react.ts
+/**
+* The React Bild-Studio feature (shadcn): the `imageStudio` block with its React view (picture or description
+* placeholder, opens the studio dialog on double-click and through the block action `image-studio.open`), the `/` entry
+* `bild-studio` and the action. Generation, upload and the Prompt-Bausteine need a backend with the `images`
+* capability; without it the view says that generation is not set up.
+*/
+function imageStudioFeature() {
+	return imageStudioFeatureCore({ nodeView: ReactNodeViewRenderer(ImageStudioView) });
+}
+//#endregion
+export { EMPTY_IMAGE_STUDIO_STATE, ImageStudioDialog, addGeneration, addReference, createImageStudioNodeCore, imageStudioFeature, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock, useImageStudioNodeStore };
+
+//# sourceMappingURL=react.js.map

package/dist/features/image-studio/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","names":[],"sources":["../../../src/features/image-studio/react.ts"],"sourcesContent":["import { ReactNodeViewRenderer } from '@tiptap/react'\nimport type { ReactFeature } from '../../react'\nimport { imageStudioFeatureCore } from './feature'\nimport { ImageStudioView } from './react/ImageStudioView'\n\nexport { ImageStudioDialog } from './react/ImageStudioDialog'\nexport { type ImageStudioReactStore, useImageStudioNodeStore } from './react/store'\nexport { createImageStudioNodeCore, type ImageStudioNodeCore, type ImageStudioNodeCoreOptions, type ImageStudioNodeSnapshot } from './node-core'\nexport {\n  addGeneration,\n  addReference,\n  EMPTY_IMAGE_STUDIO_STATE,\n  type ImageStudioImage,\n  type ImageStudioPromptBlock,\n  type ImageStudioState,\n  type ImageStudioTurn,\n  isEmptyImageStudioState,\n  normalizeImageStudioState,\n  removeImage,\n  select,\n  selectedImage,\n  setDescription,\n  toggleImage,\n  togglePromptBlock,\n} from './state'\n\n/**\n * The React Bild-Studio feature (shadcn): the `imageStudio` block with its React view (picture or description\n * placeholder, opens the studio dialog on double-click and through the block action `image-studio.open`), the `/` entry\n * `bild-studio` and the action. Generation, upload and the Prompt-Bausteine need a backend with the `images`\n * capability; without it the view says that generation is not set up.\n */\nexport function imageStudioFeature(): ReactFeature {\n  return imageStudioFeatureCore({ nodeView: ReactNodeViewRenderer(ImageStudioView) })\n}\n"],"mappings":";;;;;;;;;;;;;;AAgCA,SAAgB,qBAAmC;CACjD,OAAO,uBAAuB,EAAE,UAAU,sBAAsB,eAAe,EAAE,CAAC;AACpF"}

package/dist/features/image-studio/schema.d.ts

@@ -0,0 +1,29 @@
+import { ImageStudioState } from "./state.js";
+import { AnyExtension, Node } from "@tiptap/core";
+//#region src/features/image-studio/schema.d.ts
+/** What `insertImageStudio` takes: the description, chat and images live in `studio`, `src` follows its selected image. */
+export interface ImageStudioAttrs {
+  alt?: string;
+  studio?: ImageStudioState;
+}
+declare module '@tiptap/core' {
+  interface Commands<ReturnType> {
+    imageStudio: {
+      /** Inserts a Bild-Studio block at the selection. */
+      insertImageStudio: (attrs?: ImageStudioAttrs) => ReturnType;
+      /** Replaces the studio state of the block at `pos` and mirrors the selected image into its `src`. */
+      setImageStudioState: (pos: number, state: ImageStudioState) => ReturnType;
+    };
+  }
+}
+/** The Bild-Studio node of the document schema. */
+export declare const imageStudioSchemaExtensions: () => AnyExtension[];
+/**
+ * The Bild-Studio block: a picture whose description, Prompt-Bausteine, references, previous generations and chat live in
+ * the `studio` attribute (`ImageStudioState`); `src` mirrors the selected image. HTML: `<img data-image-studio src alt
+ * data-studio="{json}">`. Markdown: `[Bild-Studio: alt](src) <!-- {"studio":{…}} -->` on its own line, the comment left
+ * out while the studio is empty. The label is the literal `Bild-Studio` in every UI language (it is what parsing looks for).
+ */
+export declare const ImageStudioNode: Node<any, any>;
+//#endregion
+//# sourceMappingURL=schema.d.ts.map

package/dist/features/image-studio/schema.js

@@ -0,0 +1,86 @@
+import { TEXT_ABILITIES } from "../../core/schema/abilities.js";
+import { attrComment, mediaTokenizer } from "../media/schema.js";
+import { EMPTY_IMAGE_STUDIO_STATE, isEmptyImageStudioState, normalizeImageStudioState, selectedImage } from "./state.js";
+import { Node, mergeAttributes } from "@tiptap/core";
+//#region src/features/image-studio/schema.ts
+/** The Bild-Studio node of the document schema. */
+const imageStudioSchemaExtensions = () => [ImageStudioNode];
+/** The `src` a block shows for `studio`: the url of its selected image, `null` without one. */
+const srcOf = (studio) => selectedImage(studio)?.url ?? null;
+function parseStudioJson(json) {
+	if (!json) return void 0;
+	try {
+		return JSON.parse(json);
+	} catch {
+		return;
+	}
+}
+/**
+* The Bild-Studio block: a picture whose description, Prompt-Bausteine, references, previous generations and chat live in
+* the `studio` attribute (`ImageStudioState`); `src` mirrors the selected image. HTML: `<img data-image-studio src alt
+* data-studio="{json}">`. Markdown: `[Bild-Studio: alt](src) <!-- {"studio":{…}} -->` on its own line, the comment left
+* out while the studio is empty. The label is the literal `Bild-Studio` in every UI language (it is what parsing looks for).
+*/
+const ImageStudioNode = Node.create({
+	name: "imageStudio",
+	group: "block",
+	atom: true,
+	draggable: true,
+	editorBlock: true,
+	abilities: { revokes: TEXT_ABILITIES },
+	addAttributes: () => ({
+		src: { default: null },
+		alt: { default: "" },
+		studio: {
+			default: EMPTY_IMAGE_STUDIO_STATE,
+			parseHTML: (el) => normalizeImageStudioState(parseStudioJson(el.getAttribute("data-studio"))),
+			renderHTML: (attrs) => ({ "data-studio": JSON.stringify(attrs.studio) })
+		}
+	}),
+	parseHTML: () => [{
+		tag: "img[data-image-studio]",
+		priority: 100
+	}],
+	renderHTML: ({ HTMLAttributes }) => ["img", mergeAttributes(HTMLAttributes, { "data-image-studio": "" })],
+	markdownTokenizer: mediaTokenizer("imageStudio", "Bild-Studio"),
+	parseMarkdown: (token, helpers) => helpers.createNode("imageStudio", {
+		src: token.href || null,
+		alt: token.title ?? "",
+		studio: normalizeImageStudioState(token.attrs?.studio)
+	}),
+	renderMarkdown: (node) => {
+		const alt = typeof node.attrs?.alt === "string" ? node.attrs.alt : "";
+		const studio = normalizeImageStudioState(node.attrs?.studio);
+		return `[${alt ? `Bild-Studio: ${alt.replace(/[[\]\\]/g, "\\$&")}` : "Bild-Studio"}](${typeof node.attrs?.src === "string" ? node.attrs.src : ""})${attrComment({ studio: isEmptyImageStudioState(studio) ? void 0 : studio })}`;
+	},
+	addCommands() {
+		return {
+			insertImageStudio: (attrs) => ({ commands }) => {
+				const studio = normalizeImageStudioState(attrs?.studio);
+				return commands.insertContent({
+					type: this.name,
+					attrs: {
+						src: srcOf(studio),
+						alt: attrs?.alt ?? "",
+						studio
+					}
+				});
+			},
+			setImageStudioState: (pos, state) => ({ tr, dispatch }) => {
+				const node = tr.doc.nodeAt(pos);
+				if (node?.type.name !== this.name) return false;
+				const studio = normalizeImageStudioState(state);
+				if (dispatch) tr.setNodeMarkup(pos, void 0, {
+					...node.attrs,
+					studio,
+					src: srcOf(studio)
+				});
+				return true;
+			}
+		};
+	}
+});
+//#endregion
+export { ImageStudioNode, imageStudioSchemaExtensions };
+
+//# sourceMappingURL=schema.js.map

package/dist/features/image-studio/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../../src/features/image-studio/schema.ts"],"sourcesContent":["import { type AnyExtension, mergeAttributes, Node } from '@tiptap/core'\nimport { TEXT_ABILITIES } from '../../core/schema'\nimport { attrComment, mediaTokenizer } from '../media/schema'\nimport { EMPTY_IMAGE_STUDIO_STATE, type ImageStudioState, isEmptyImageStudioState, normalizeImageStudioState, selectedImage } from './state'\n\n// Vue-free and server-importable (`@ecsplico/editor/image-studio/schema`): the stored document may contain the node, so\n// the server schema has it. The client adds the node view and the dialog.\n\n/** What `insertImageStudio` takes: the description, chat and images live in `studio`, `src` follows its selected image. */\nexport interface ImageStudioAttrs {\n  alt?: string\n  studio?: ImageStudioState\n}\n\ndeclare module '@tiptap/core' {\n  interface Commands<ReturnType> {\n    imageStudio: {\n      /** Inserts a Bild-Studio block at the selection. */\n      insertImageStudio: (attrs?: ImageStudioAttrs) => ReturnType\n      /** Replaces the studio state of the block at `pos` and mirrors the selected image into its `src`. */\n      setImageStudioState: (pos: number, state: ImageStudioState) => ReturnType\n    }\n  }\n}\n\n/** The Bild-Studio node of the document schema. */\nexport const imageStudioSchemaExtensions = (): AnyExtension[] => [ImageStudioNode]\n\n/** The `src` a block shows for `studio`: the url of its selected image, `null` without one. */\nconst srcOf = (studio: ImageStudioState): string | null => selectedImage(studio)?.url ?? null\n\nfunction parseStudioJson(json: string | null): unknown {\n  if (!json) return undefined\n  try {\n    return JSON.parse(json)\n  }\n  catch {\n    return undefined\n  }\n}\n\n/**\n * The Bild-Studio block: a picture whose description, Prompt-Bausteine, references, previous generations and chat live in\n * the `studio` attribute (`ImageStudioState`); `src` mirrors the selected image. HTML: `<img data-image-studio src alt\n * data-studio=\"{json}\">`. Markdown: `[Bild-Studio: alt](src) <!-- {\"studio\":{…}} -->` on its own line, the comment left\n * out while the studio is empty. The label is the literal `Bild-Studio` in every UI language (it is what parsing looks for).\n */\nexport const ImageStudioNode = Node.create({\n  name: 'imageStudio',\n  group: 'block',\n  atom: true,\n  draggable: true,\n  editorBlock: true,\n  // A picture block holds no text: nothing text-related applies inside it.\n  abilities: { revokes: TEXT_ABILITIES },\n  addAttributes: () => ({\n    src: { default: null },\n    alt: { default: '' },\n    studio: {\n      default: EMPTY_IMAGE_STUDIO_STATE,\n      parseHTML: el => normalizeImageStudioState(parseStudioJson(el.getAttribute('data-studio'))),\n      renderHTML: attrs => ({ 'data-studio': JSON.stringify(attrs.studio) }),\n    },\n  }),\n  // Before the stock image rule, which also matches an `<img src>`.\n  parseHTML: () => [{ tag: 'img[data-image-studio]', priority: 100 }],\n  renderHTML: ({ HTMLAttributes }) => ['img', mergeAttributes(HTMLAttributes, { 'data-image-studio': '' })],\n  markdownTokenizer: mediaTokenizer('imageStudio', 'Bild-Studio'),\n  parseMarkdown: (token, helpers) => helpers.createNode('imageStudio', {\n    src: token.href || null,\n    alt: token.title ?? '',\n    studio: normalizeImageStudioState(token.attrs?.studio),\n  }),\n  renderMarkdown: (node) => {\n    const alt = typeof node.attrs?.alt === 'string' ? node.attrs.alt : ''\n    const studio = normalizeImageStudioState(node.attrs?.studio)\n    const label = alt ? `Bild-Studio: ${alt.replace(/[[\\]\\\\]/g, '\\\\$&')}` : 'Bild-Studio'\n    const src = typeof node.attrs?.src === 'string' ? node.attrs.src : ''\n    return `[${label}](${src})${attrComment({ studio: isEmptyImageStudioState(studio) ? undefined : studio })}`\n  },\n  addCommands() {\n    return {\n      insertImageStudio: attrs => ({ commands }) => {\n        const studio = normalizeImageStudioState(attrs?.studio)\n        return commands.insertContent({ type: this.name, attrs: { src: srcOf(studio), alt: attrs?.alt ?? '', studio } })\n      },\n      setImageStudioState: (pos, state) => ({ tr, dispatch }) => {\n        const node = tr.doc.nodeAt(pos)\n        if (node?.type.name !== this.name) return false\n        const studio = normalizeImageStudioState(state)\n        if (dispatch) tr.setNodeMarkup(pos, undefined, { ...node.attrs, studio, src: srcOf(studio) })\n        return true\n      },\n    }\n  },\n})\n"],"mappings":";;;;;;AA0BA,MAAa,oCAAoD,CAAC,eAAe;;AAGjF,MAAM,SAAS,WAA4C,cAAc,MAAM,CAAC,EAAE,OAAO;AAEzF,SAAS,gBAAgB,MAA8B;CACrD,IAAI,CAAC,MAAM,OAAO,KAAA;CAClB,IAAI;EACF,OAAO,KAAK,MAAM,IAAI;CACxB,QACM;EACJ;CACF;AACF;;;;;;;AAQA,MAAa,kBAAkB,KAAK,OAAO;CACzC,MAAM;CACN,OAAO;CACP,MAAM;CACN,WAAW;CACX,aAAa;CAEb,WAAW,EAAE,SAAS,eAAe;CACrC,sBAAsB;EACpB,KAAK,EAAE,SAAS,KAAK;EACrB,KAAK,EAAE,SAAS,GAAG;EACnB,QAAQ;GACN,SAAS;GACT,YAAW,OAAM,0BAA0B,gBAAgB,GAAG,aAAa,aAAa,CAAC,CAAC;GAC1F,aAAY,WAAU,EAAE,eAAe,KAAK,UAAU,MAAM,MAAM,EAAE;EACtE;CACF;CAEA,iBAAiB,CAAC;EAAE,KAAK;EAA0B,UAAU;CAAI,CAAC;CAClE,aAAa,EAAE,qBAAqB,CAAC,OAAO,gBAAgB,gBAAgB,EAAE,qBAAqB,GAAG,CAAC,CAAC;CACxG,mBAAmB,eAAe,eAAe,aAAa;CAC9D,gBAAgB,OAAO,YAAY,QAAQ,WAAW,eAAe;EACnE,KAAK,MAAM,QAAQ;EACnB,KAAK,MAAM,SAAS;EACpB,QAAQ,0BAA0B,MAAM,OAAO,MAAM;CACvD,CAAC;CACD,iBAAiB,SAAS;EACxB,MAAM,MAAM,OAAO,KAAK,OAAO,QAAQ,WAAW,KAAK,MAAM,MAAM;EACnE,MAAM,SAAS,0BAA0B,KAAK,OAAO,MAAM;EAG3D,OAAO,IAFO,MAAM,gBAAgB,IAAI,QAAQ,YAAY,MAAM,MAAM,cAEvD,IADL,OAAO,KAAK,OAAO,QAAQ,WAAW,KAAK,MAAM,MAAM,GAC1C,GAAG,YAAY,EAAE,QAAQ,wBAAwB,MAAM,IAAI,KAAA,IAAY,OAAO,CAAC;CAC1G;CACA,cAAc;EACZ,OAAO;GACL,oBAAmB,WAAU,EAAE,eAAe;IAC5C,MAAM,SAAS,0BAA0B,OAAO,MAAM;IACtD,OAAO,SAAS,cAAc;KAAE,MAAM,KAAK;KAAM,OAAO;MAAE,KAAK,MAAM,MAAM;MAAG,KAAK,OAAO,OAAO;MAAI;KAAO;IAAE,CAAC;GACjH;GACA,sBAAsB,KAAK,WAAW,EAAE,IAAI,eAAe;IACzD,MAAM,OAAO,GAAG,IAAI,OAAO,GAAG;IAC9B,IAAI,MAAM,KAAK,SAAS,KAAK,MAAM,OAAO;IAC1C,MAAM,SAAS,0BAA0B,KAAK;IAC9C,IAAI,UAAU,GAAG,cAAc,KAAK,KAAA,GAAW;KAAE,GAAG,KAAK;KAAO;KAAQ,KAAK,MAAM,MAAM;IAAE,CAAC;IAC5F,OAAO;GACT;EACF;CACF;AACF,CAAC"}

package/dist/features/image-studio/state.d.ts

@@ -0,0 +1,52 @@
+import { ImageStudioImage, ImageStudioPromptBlock } from "../../core/backend-types.js";
+//#region src/features/image-studio/state.d.ts
+/** One chat turn: the instruction and the generation it produced (or the problem). */
+export interface ImageStudioTurn {
+  id: string;
+  instruction: string;
+  imageId: string | null;
+  createdAt: string;
+  problem?: string;
+}
+export interface ImageStudioState {
+  /** The text describing the image; '' shows the placeholder. */
+  description: string;
+  /** Active Prompt-Bausteine, by host id. */
+  promptBlockIds: string[];
+  /** Uploaded or picked references. */
+  references: ImageStudioImage[];
+  /** Previous generations; an active one goes into the next generation as a reference. */
+  generations: ImageStudioImage[];
+  /** Id of the generation (or reference) that is the block's image. */
+  selected: string | null;
+  /** The chat log: instruction → generation. */
+  turns: ImageStudioTurn[];
+}
+/** The state of a block that has no description, no images and no chat yet. */
+export declare const EMPTY_IMAGE_STUDIO_STATE: ImageStudioState;
+/** The image that is the block's image (a generation or a reference), if the selection still points at one. */
+export declare function selectedImage(state: ImageStudioState): ImageStudioImage | undefined;
+export declare function setDescription(state: ImageStudioState, description: string): ImageStudioState;
+/** Adds the Prompt-Baustein `id` to the active ones, or removes it when it is active. */
+export declare function togglePromptBlock(state: ImageStudioState, id: string): ImageStudioState;
+/** Flips `active` of the reference or generation `id`; an unknown id changes nothing. */
+export declare function toggleImage(state: ImageStudioState, id: string): ImageStudioState;
+/** Makes the reference or generation `id` the block's image; `null` clears the choice. An unknown id changes nothing. */
+export declare function select(state: ImageStudioState, id: string | null): ImageStudioState;
+/** Drops the image `id` from the block (references and generations); the selection goes with it, the chat log keeps its turns. */
+export declare function removeImage(state: ImageStudioState, id: string): ImageStudioState;
+/** Appends a reference; one with the same id is replaced where it stands. */
+export declare function addReference(state: ImageStudioState, image: ImageStudioImage): ImageStudioState;
+/** A chat generate means "this is the picture now": appends the image and its turn (pointing at the image) and selects it. */
+export declare function addGeneration(state: ImageStudioState, image: ImageStudioImage, turn: ImageStudioTurn): ImageStudioState;
+/**
+ * The state `value` stands for, for parsed attributes and stored JSON: a missing field, a wrong type or an entry without
+ * an id falls back to the empty value of that field, and a `selected` that points at no image becomes `null`. A valid
+ * state comes back unchanged (as a copy).
+ */
+export declare function normalizeImageStudioState(value: unknown): ImageStudioState;
+/** Whether `state` holds nothing: no description, Prompt-Baustein, image, selection or chat turn. */
+export declare function isEmptyImageStudioState(state: ImageStudioState): boolean;
+//#endregion
+export type { ImageStudioImage, ImageStudioPromptBlock };
+//# sourceMappingURL=state.d.ts.map

package/dist/features/image-studio/state.js

@@ -0,0 +1,147 @@
+import { z } from "zod";
+//#region src/features/image-studio/state.ts
+/**
+* The Bild-Studio's state: what a block holds about its picture. Host-agnostic
+* JSON; image ids are opaque to the library (a host uses its own asset ids).
+*/
+/** The state of a block that has no description, no images and no chat yet. */
+const EMPTY_IMAGE_STUDIO_STATE = {
+	description: "",
+	promptBlockIds: [],
+	references: [],
+	generations: [],
+	selected: null,
+	turns: []
+};
+const hasImage = (state, id) => state.references.some((image) => image.id === id) || state.generations.some((image) => image.id === id);
+const toggled = (images, id) => images.map((image) => ({
+	...image,
+	active: image.id === id ? !image.active : image.active
+}));
+/** The image that is the block's image (a generation or a reference), if the selection still points at one. */
+function selectedImage(state) {
+	if (state.selected === null) return void 0;
+	return state.generations.find((image) => image.id === state.selected) ?? state.references.find((image) => image.id === state.selected);
+}
+function setDescription(state, description) {
+	return {
+		...state,
+		description
+	};
+}
+/** Adds the Prompt-Baustein `id` to the active ones, or removes it when it is active. */
+function togglePromptBlock(state, id) {
+	const active = state.promptBlockIds.includes(id);
+	return {
+		...state,
+		promptBlockIds: active ? state.promptBlockIds.filter((other) => other !== id) : [...state.promptBlockIds, id]
+	};
+}
+/** Flips `active` of the reference or generation `id`; an unknown id changes nothing. */
+function toggleImage(state, id) {
+	return {
+		...state,
+		references: toggled(state.references, id),
+		generations: toggled(state.generations, id)
+	};
+}
+/** Makes the reference or generation `id` the block's image; `null` clears the choice. An unknown id changes nothing. */
+function select(state, id) {
+	return {
+		...state,
+		selected: id === null || hasImage(state, id) ? id : state.selected
+	};
+}
+/** Drops the image `id` from the block (references and generations); the selection goes with it, the chat log keeps its turns. */
+function removeImage(state, id) {
+	return {
+		...state,
+		references: state.references.filter((image) => image.id !== id),
+		generations: state.generations.filter((image) => image.id !== id),
+		selected: state.selected === id ? null : state.selected
+	};
+}
+/** Appends a reference; one with the same id is replaced where it stands. */
+function addReference(state, image) {
+	const known = state.references.some((other) => other.id === image.id);
+	return {
+		...state,
+		references: known ? state.references.map((other) => other.id === image.id ? { ...image } : other) : [...state.references, { ...image }]
+	};
+}
+/** A chat generate means "this is the picture now": appends the image and its turn (pointing at the image) and selects it. */
+function addGeneration(state, image, turn) {
+	return {
+		...state,
+		generations: [...state.generations, { ...image }],
+		turns: [...state.turns, {
+			...turn,
+			imageId: image.id
+		}],
+		selected: image.id
+	};
+}
+const Fields = z.record(z.string(), z.unknown());
+const textOf = (value) => typeof value === "string" ? value : "";
+const idOf = (value) => typeof value === "string" && value !== "" ? value : null;
+/** The entries of the array `value` that `parse` accepts (it answers `null` for a refused one); a non-array has none. */
+function entriesOf(value, parse) {
+	return Array.isArray(value) ? value.flatMap((entry) => parse(entry) ?? []) : [];
+}
+function imageOf(entry) {
+	const fields = Fields.safeParse(entry);
+	const id = fields.success ? idOf(fields.data.id) : null;
+	if (!fields.success || id === null) return null;
+	return {
+		id,
+		url: textOf(fields.data.url),
+		title: textOf(fields.data.title),
+		active: fields.data.active === true
+	};
+}
+function turnOf(entry) {
+	const fields = Fields.safeParse(entry);
+	const id = fields.success ? idOf(fields.data.id) : null;
+	if (!fields.success || id === null) return null;
+	const turn = {
+		id,
+		instruction: textOf(fields.data.instruction),
+		imageId: idOf(fields.data.imageId),
+		createdAt: textOf(fields.data.createdAt)
+	};
+	const problem = idOf(fields.data.problem);
+	return problem === null ? turn : {
+		...turn,
+		problem
+	};
+}
+/**
+* The state `value` stands for, for parsed attributes and stored JSON: a missing field, a wrong type or an entry without
+* an id falls back to the empty value of that field, and a `selected` that points at no image becomes `null`. A valid
+* state comes back unchanged (as a copy).
+*/
+function normalizeImageStudioState(value) {
+	const fields = Fields.safeParse(value);
+	const data = fields.success ? fields.data : {};
+	const state = {
+		description: textOf(data.description),
+		promptBlockIds: entriesOf(data.promptBlockIds, idOf),
+		references: entriesOf(data.references, imageOf),
+		generations: entriesOf(data.generations, imageOf),
+		selected: null,
+		turns: entriesOf(data.turns, turnOf)
+	};
+	const selected = idOf(data.selected);
+	return {
+		...state,
+		selected: selected !== null && hasImage(state, selected) ? selected : null
+	};
+}
+/** Whether `state` holds nothing: no description, Prompt-Baustein, image, selection or chat turn. */
+function isEmptyImageStudioState(state) {
+	return state.description === "" && state.promptBlockIds.length === 0 && state.references.length === 0 && state.generations.length === 0 && state.selected === null && state.turns.length === 0;
+}
+//#endregion
+export { EMPTY_IMAGE_STUDIO_STATE, addGeneration, addReference, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock };
+
+//# sourceMappingURL=state.js.map

package/dist/features/image-studio/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":[],"sources":["../../../src/features/image-studio/state.ts"],"sourcesContent":["/**\n * The Bild-Studio's state: what a block holds about its picture. Host-agnostic\n * JSON; image ids are opaque to the library (a host uses its own asset ids).\n */\n\nimport { z } from 'zod'\nimport type { ImageStudioImage, ImageStudioPromptBlock } from '../../core/backend-types'\n\n// `ImageStudioImage` and `ImageStudioPromptBlock` are wire types of `EditorBackend.images`, so they live in\n// `core/backend-types.ts` (core never imports a feature); this module is their feature-side entry.\nexport type { ImageStudioImage, ImageStudioPromptBlock }\n\n/** One chat turn: the instruction and the generation it produced (or the problem). */\nexport interface ImageStudioTurn {\n  id: string\n  instruction: string\n  imageId: string | null\n  createdAt: string\n  problem?: string\n}\n\nexport interface ImageStudioState {\n  /** The text describing the image; '' shows the placeholder. */\n  description: string\n  /** Active Prompt-Bausteine, by host id. */\n  promptBlockIds: string[]\n  /** Uploaded or picked references. */\n  references: ImageStudioImage[]\n  /** Previous generations; an active one goes into the next generation as a reference. */\n  generations: ImageStudioImage[]\n  /** Id of the generation (or reference) that is the block's image. */\n  selected: string | null\n  /** The chat log: instruction → generation. */\n  turns: ImageStudioTurn[]\n}\n\n/** The state of a block that has no description, no images and no chat yet. */\nexport const EMPTY_IMAGE_STUDIO_STATE: ImageStudioState = {\n  description: '',\n  promptBlockIds: [],\n  references: [],\n  generations: [],\n  selected: null,\n  turns: [],\n}\n\n// Reducers: pure, each returns a new state and never touches its argument. The host owns the files behind the images.\n\nconst hasImage = (state: ImageStudioState, id: string): boolean =>\n  state.references.some(image => image.id === id) || state.generations.some(image => image.id === id)\n\nconst toggled = (images: readonly ImageStudioImage[], id: string): ImageStudioImage[] =>\n  images.map(image => ({ ...image, active: image.id === id ? !image.active : image.active }))\n\n/** The image that is the block's image (a generation or a reference), if the selection still points at one. */\nexport function selectedImage(state: ImageStudioState): ImageStudioImage | undefined {\n  if (state.selected === null) return undefined\n  return state.generations.find(image => image.id === state.selected) ?? state.references.find(image => image.id === state.selected)\n}\n\nexport function setDescription(state: ImageStudioState, description: string): ImageStudioState {\n  return { ...state, description }\n}\n\n/** Adds the Prompt-Baustein `id` to the active ones, or removes it when it is active. */\nexport function togglePromptBlock(state: ImageStudioState, id: string): ImageStudioState {\n  const active = state.promptBlockIds.includes(id)\n  return { ...state, promptBlockIds: active ? state.promptBlockIds.filter(other => other !== id) : [...state.promptBlockIds, id] }\n}\n\n/** Flips `active` of the reference or generation `id`; an unknown id changes nothing. */\nexport function toggleImage(state: ImageStudioState, id: string): ImageStudioState {\n  return { ...state, references: toggled(state.references, id), generations: toggled(state.generations, id) }\n}\n\n/** Makes the reference or generation `id` the block's image; `null` clears the choice. An unknown id changes nothing. */\nexport function select(state: ImageStudioState, id: string | null): ImageStudioState {\n  return { ...state, selected: id === null || hasImage(state, id) ? id : state.selected }\n}\n\n/** Drops the image `id` from the block (references and generations); the selection goes with it, the chat log keeps its turns. */\nexport function removeImage(state: ImageStudioState, id: string): ImageStudioState {\n  return {\n    ...state,\n    references: state.references.filter(image => image.id !== id),\n    generations: state.generations.filter(image => image.id !== id),\n    selected: state.selected === id ? null : state.selected,\n  }\n}\n\n/** Appends a reference; one with the same id is replaced where it stands. */\nexport function addReference(state: ImageStudioState, image: ImageStudioImage): ImageStudioState {\n  const known = state.references.some(other => other.id === image.id)\n  return { ...state, references: known ? state.references.map(other => other.id === image.id ? { ...image } : other) : [...state.references, { ...image }] }\n}\n\n/** A chat generate means \"this is the picture now\": appends the image and its turn (pointing at the image) and selects it. */\nexport function addGeneration(state: ImageStudioState, image: ImageStudioImage, turn: ImageStudioTurn): ImageStudioState {\n  return {\n    ...state,\n    generations: [...state.generations, { ...image }],\n    turns: [...state.turns, { ...turn, imageId: image.id }],\n    selected: image.id,\n  }\n}\n\n// Parsing: stored attributes and JSON from other tools are untrusted, a missing or mistyped field falls back to its empty value.\n// Fields are read one by one from a record: a zod object would reject an entry for a missing key, where this one defaults it.\nconst Fields = z.record(z.string(), z.unknown())\n\nconst textOf = (value: unknown): string => typeof value === 'string' ? value : ''\nconst idOf = (value: unknown): string | null => typeof value === 'string' && value !== '' ? value : null\n\n/** The entries of the array `value` that `parse` accepts (it answers `null` for a refused one); a non-array has none. */\nfunction entriesOf<T>(value: unknown, parse: (entry: unknown) => T | null): T[] {\n  return Array.isArray(value) ? value.flatMap((entry: unknown) => parse(entry) ?? []) : []\n}\n\nfunction imageOf(entry: unknown): ImageStudioImage | null {\n  const fields = Fields.safeParse(entry)\n  const id = fields.success ? idOf(fields.data.id) : null\n  if (!fields.success || id === null) return null\n  return { id, url: textOf(fields.data.url), title: textOf(fields.data.title), active: fields.data.active === true }\n}\n\nfunction turnOf(entry: unknown): ImageStudioTurn | null {\n  const fields = Fields.safeParse(entry)\n  const id = fields.success ? idOf(fields.data.id) : null\n  if (!fields.success || id === null) return null\n  const turn: ImageStudioTurn = { id, instruction: textOf(fields.data.instruction), imageId: idOf(fields.data.imageId), createdAt: textOf(fields.data.createdAt) }\n  const problem = idOf(fields.data.problem)\n  return problem === null ? turn : { ...turn, problem }\n}\n\n/**\n * The state `value` stands for, for parsed attributes and stored JSON: a missing field, a wrong type or an entry without\n * an id falls back to the empty value of that field, and a `selected` that points at no image becomes `null`. A valid\n * state comes back unchanged (as a copy).\n */\nexport function normalizeImageStudioState(value: unknown): ImageStudioState {\n  const fields = Fields.safeParse(value)\n  const data = fields.success ? fields.data : {}\n  const state: ImageStudioState = {\n    description: textOf(data.description),\n    promptBlockIds: entriesOf(data.promptBlockIds, idOf),\n    references: entriesOf(data.references, imageOf),\n    generations: entriesOf(data.generations, imageOf),\n    selected: null,\n    turns: entriesOf(data.turns, turnOf),\n  }\n  const selected = idOf(data.selected)\n  return { ...state, selected: selected !== null && hasImage(state, selected) ? selected : null }\n}\n\n/** Whether `state` holds nothing: no description, Prompt-Baustein, image, selection or chat turn. */\nexport function isEmptyImageStudioState(state: ImageStudioState): boolean {\n  return state.description === '' && state.promptBlockIds.length === 0 && state.references.length === 0 && state.generations.length === 0\n    && state.selected === null && state.turns.length === 0\n}\n\n"],"mappings":"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"}

package/dist/features/image-studio/store.d.ts

@@ -0,0 +1,29 @@
+import { ImageStudioImage, ImageStudioPromptBlock } from "../../core/backend-types.js";
+import { ImageStudioState } from "./state.js";
+import { Ref } from "vue";
+//#region src/features/image-studio/store.d.ts
+/**
+ * What the Bild-Studio dialog drives; a host supplies it (the node view builds one over the node's `studio` attribute and
+ * `EditorBackend.images`, an app with its own image store builds its own).
+ *
+ * The dialog applies the reducers of `./state` and hands the result to `update`; the store only persists it. The
+ * store's methods never touch `state` themselves:
+ * - `generate` produces one image from the block's `state.description`, the active Prompt-Bausteine and the active
+ *   images (the host builds the prompt). When it resolves, the dialog calls `update(addGeneration(state, image, turn))`;
+ *   when it rejects (and the signal was not aborted) the dialog appends a turn with `imageId: null` and the message as
+ *   `problem`. An aborted generation adds nothing.
+ * - `upload` stores the file and returns the image; the dialog then calls `update(addReference(state, image))`.
+ * - `problem` is a problem of the store itself (the Prompt-Bausteine could not be loaded, say); the dialog shows it as a notice.
+ */
+export interface ImageStudioStore {
+  readonly state: Ref<ImageStudioState>;
+  /** The managed list of Prompt-Bausteine, loaded by the host. */
+  readonly promptBlocks: Ref<readonly ImageStudioPromptBlock[]>;
+  /** Called with the state after a reducer; the host persists it. */
+  update: (next: ImageStudioState) => void;
+  generate: (instruction: string, signal: AbortSignal) => Promise<ImageStudioImage>;
+  upload: (file: File) => Promise<ImageStudioImage>;
+  readonly problem: Ref<string | undefined>;
+}
+//#endregion
+//# sourceMappingURL=store.d.ts.map

package/dist/features/image-studio/vue.d.ts

@@ -0,0 +1,17 @@
+import { ImageStudioImage, ImageStudioPromptBlock } from "../../core/backend-types.js";
+import { VueFeature } from "../../vue/index.js";
+import { EMPTY_IMAGE_STUDIO_STATE, ImageStudioState, ImageStudioTurn, addGeneration, addReference, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock } from "./state.js";
+import { ImageStudioStore } from "./store.js";
+import _default from "./components/ImageStudioDialog.vue.js";
+import { ImageStudioNodeStore, ImageStudioNodeStoreOptions, createImageStudioNodeStore } from "./node-store.js";
+//#region src/features/image-studio/vue.d.ts
+/**
+ * The Vue Bild-Studio feature: the `imageStudio` block with its Vue view (picture or description placeholder, opens the
+ * studio dialog on double-click and through the block action `image-studio.open`), the `/` entry `bild-studio` and the
+ * action. Generation, upload and the Prompt-Bausteine need a backend with the `images` capability; without it the view
+ * says that generation is not set up.
+ */
+export declare function imageStudioFeature(): VueFeature;
+//#endregion
+export { EMPTY_IMAGE_STUDIO_STATE, _default as ImageStudioDialog, type ImageStudioImage, type ImageStudioNodeStore, type ImageStudioNodeStoreOptions, type ImageStudioPromptBlock, type ImageStudioState, type ImageStudioStore, type ImageStudioTurn, addGeneration, addReference, createImageStudioNodeStore, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock };
+//# sourceMappingURL=vue.d.ts.map

package/dist/features/image-studio/vue.js

@@ -0,0 +1,20 @@
+import { EMPTY_IMAGE_STUDIO_STATE, addGeneration, addReference, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock } from "./state.js";
+import { imageStudioFeatureCore } from "./feature.js";
+import { createImageStudioNodeStore } from "./node-store.js";
+import _sfc_main from "./components/ImageStudioDialog.js";
+import _sfc_main$1 from "./components/ImageStudioView.js";
+import { VueNodeViewRenderer } from "@tiptap/vue-3";
+//#region src/features/image-studio/vue.ts
+/**
+* The Vue Bild-Studio feature: the `imageStudio` block with its Vue view (picture or description placeholder, opens the
+* studio dialog on double-click and through the block action `image-studio.open`), the `/` entry `bild-studio` and the
+* action. Generation, upload and the Prompt-Bausteine need a backend with the `images` capability; without it the view
+* says that generation is not set up.
+*/
+function imageStudioFeature() {
+	return imageStudioFeatureCore({ nodeView: VueNodeViewRenderer(_sfc_main$1) });
+}
+//#endregion
+export { EMPTY_IMAGE_STUDIO_STATE, _sfc_main as ImageStudioDialog, addGeneration, addReference, createImageStudioNodeStore, imageStudioFeature, isEmptyImageStudioState, normalizeImageStudioState, removeImage, select, selectedImage, setDescription, toggleImage, togglePromptBlock };
+
+//# sourceMappingURL=vue.js.map

package/dist/features/image-studio/vue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vue.js","names":["ImageStudioView"],"sources":["../../../src/features/image-studio/vue.ts"],"sourcesContent":["import { VueNodeViewRenderer } from '@tiptap/vue-3'\nimport type { VueFeature } from '../../vue'\nimport ImageStudioView from './components/ImageStudioView.vue'\nimport { imageStudioFeatureCore } from './feature'\n\nexport { default as ImageStudioDialog } from './components/ImageStudioDialog.vue'\nexport { createImageStudioNodeStore, type ImageStudioNodeStore, type ImageStudioNodeStoreOptions } from './node-store'\nexport {\n  addGeneration,\n  addReference,\n  EMPTY_IMAGE_STUDIO_STATE,\n  type ImageStudioImage,\n  type ImageStudioPromptBlock,\n  type ImageStudioState,\n  type ImageStudioTurn,\n  isEmptyImageStudioState,\n  normalizeImageStudioState,\n  removeImage,\n  select,\n  selectedImage,\n  setDescription,\n  toggleImage,\n  togglePromptBlock,\n} from './state'\nexport type { ImageStudioStore } from './store'\n\n/**\n * The Vue Bild-Studio feature: the `imageStudio` block with its Vue view (picture or description placeholder, opens the\n * studio dialog on double-click and through the block action `image-studio.open`), the `/` entry `bild-studio` and the\n * action. Generation, upload and the Prompt-Bausteine need a backend with the `images` capability; without it the view\n * says that generation is not set up.\n */\nexport function imageStudioFeature(): VueFeature {\n  return imageStudioFeatureCore({ nodeView: VueNodeViewRenderer(ImageStudioView) })\n}\n"],"mappings":";;;;;;;;;;;;;AAgCA,SAAgB,qBAAiC;CAC/C,OAAO,uBAAuB,EAAE,UAAU,oBAAoBA,WAAe,EAAE,CAAC;AAClF"}

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

@@ -1,5 +1,5 @@
 import { ASSET_DOCUMENT_ID, ASSET_NAME, AssetManifest, AssetRecord, SCRATCH_DOCUMENT_ID, assetRefOf, assetUrl } from "./assets.js";
-import { AnyExtension, Node } from "@tiptap/core";
+import { AnyExtension, MarkdownTokenizer, Node } from "@tiptap/core";
 //#region src/features/media/schema.d.ts
 /** The media nodes (image, audio, video, file) of the document schema. */
 export declare const mediaSchemaExtensions: () => AnyExtension[];
@@ -9,6 +9,10 @@ export declare const mediaSchemaExtensions: () => AnyExtension[];
  * token), a plain image keeps the stock inline parse.
  */
 export declare const ImageNode: Node<import("@tiptap/extension-image").ImageOptions, any>;
+/** ` <!-- {"hash":"…"} -->` for the attributes that are set (empty string when none); `>` and the line separators U+2028/U+2029 (which `.` does not match) are escaped so the JSON can neither end the comment nor break the line. Shared with the other block features that keep attributes in a trailing comment. */
+export declare function attrComment(attrs: Record<string, unknown>): string;
+/** Block tokenizer for `[<label>: title](src)` lines of one media node; `labels` are the accepted labels (regex alternatives). */
+export declare function mediaTokenizer(name: string, labels: string): MarkdownTokenizer;
 export type MediaKind = 'image' | 'audio' | 'video' | 'file';
 /** Uploadable MIME types → file extension on disk and media kind. `<uuid>.<ext>` asset names derive from this. */
 export declare const MEDIA_TYPES: Readonly<Record<string, {

package/dist/features/media/schema.js

@@ -58,10 +58,10 @@ const ImageNode = Image.extend({
 });
 const ATTR_COMMENT_PATTERN = "(?: <!-- (\\{.*?\\}) -->)?[ \\t]*(?:\\n|$)";
 const IMAGE_BLOCK_PATTERN = `^!\\[([^\\]\\n]*)\\]\\(([^)\\s]*)(?: "([^"\\n]*)")?\\) <!-- (\\{.*?\\}) -->[ \\t]*(?:\\n|$)`;
-/** ` <!-- {"hash":"…"} -->` for the attributes that are set (empty string when none); `>` is escaped so the JSON cannot end the comment. */
+/** ` <!-- {"hash":"…"} -->` for the attributes that are set (empty string when none); `>` and the line separators U+2028/U+2029 (which `.` does not match) are escaped so the JSON can neither end the comment nor break the line. Shared with the other block features that keep attributes in a trailing comment. */
 function attrComment(attrs) {
 	const set = Object.fromEntries(Object.entries(attrs).filter(([, value]) => value !== null && value !== void 0 && value !== "" && value !== 0));
-	return Object.keys(set).length ? ` <!-- ${JSON.stringify(set).replace(/>/g, "\\u003e")} -->` : "";
+	return Object.keys(set).length ? ` <!-- ${JSON.stringify(set).replace(/[>\u2028\u2029]/g, (char) => `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`)} -->` : "";
 }
 /** The attributes of an `attrComment`; empty for a missing or malformed one. */
 function parseAttrComment(json) {
@@ -304,6 +304,6 @@ const FileNode = Node.create({
 	}
 });
 //#endregion
-export { ASSET_DOCUMENT_ID, ASSET_NAME, AudioNode, FileNode, ImageNode, MAX_MEDIA_BYTES, MEDIA_TYPES, SCRATCH_DOCUMENT_ID, VideoNode, acceptFor, assetRefOf, assetUrl, mediaKindOf, mediaMime, mediaSchemaExtensions };
+export { ASSET_DOCUMENT_ID, ASSET_NAME, AudioNode, FileNode, ImageNode, MAX_MEDIA_BYTES, MEDIA_TYPES, SCRATCH_DOCUMENT_ID, VideoNode, acceptFor, assetRefOf, assetUrl, attrComment, mediaKindOf, mediaMime, mediaSchemaExtensions, mediaTokenizer };
 
 //# sourceMappingURL=schema.js.map