quoin-editor 2.0.4 → 2.1.0

package/dist/ai.cjs

@@ -2,14 +2,15 @@
 'use strict';
 
 var chunkLE5XMIFJ_cjs = require('./chunk-LE5XMIFJ.cjs');
-var chunk3HW3WRYC_cjs = require('./chunk-3HW3WRYC.cjs');
-var chunkEBSDPHPS_cjs = require('./chunk-EBSDPHPS.cjs');
-var chunk2QKFRKOP_cjs = require('./chunk-2QKFRKOP.cjs');
+var chunkCSIUXYRU_cjs = require('./chunk-CSIUXYRU.cjs');
+var chunk4UFWFV43_cjs = require('./chunk-4UFWFV43.cjs');
+var chunkN25EH2GZ_cjs = require('./chunk-N25EH2GZ.cjs');
 var chunkZWTIRGY5_cjs = require('./chunk-ZWTIRGY5.cjs');
 require('./chunk-A6PGQVTR.cjs');
-var chunkFK7EBZPX_cjs = require('./chunk-FK7EBZPX.cjs');
-require('./chunk-DJU25PFC.cjs');
-var chunkI7X7B3WD_cjs = require('./chunk-I7X7B3WD.cjs');
+require('./chunk-QFGWSFOI.cjs');
+var chunkZ5EEDCRI_cjs = require('./chunk-Z5EEDCRI.cjs');
+require('./chunk-5L2NSIHZ.cjs');
+var chunk4JDRDPLC_cjs = require('./chunk-4JDRDPLC.cjs');
 var react = require('react');
 var jsxRuntime = require('react/jsx-runtime');
 
@@ -110,30 +111,30 @@ function closeStreaming(markdown) {
 // src/extensions/ai/ai-target.ts
 function targetOfBlocks(state, ids) {
   const { doc, schema } = state;
-  const first = chunkI7X7B3WD_cjs.blockById(doc, ids[0]);
-  const last = chunkI7X7B3WD_cjs.blockById(doc, ids[ids.length - 1]);
+  const first = chunk4JDRDPLC_cjs.blockById(doc, ids[0]);
+  const last = chunk4JDRDPLC_cjs.blockById(doc, ids[ids.length - 1]);
   if (first === void 0 || last === void 0) return null;
-  const start = chunkFK7EBZPX_cjs.primaryRegion(schema, first);
-  const end = chunkFK7EBZPX_cjs.primaryRegion(schema, last);
+  const start = chunkZ5EEDCRI_cjs.primaryRegion(schema, first);
+  const end = chunkZ5EEDCRI_cjs.primaryRegion(schema, last);
   if (start === null || end === null) return null;
   const from = { block: first.id, region: start, offset: 0 };
-  return { from, to: { block: last.id, region: end, offset: chunkFK7EBZPX_cjs.regionLength(last, end) }, selected: ids.length > 1 };
+  return { from, to: { block: last.id, region: end, offset: chunkZ5EEDCRI_cjs.regionLength(last, end) }, selected: ids.length > 1 };
 }
 function targetOfSelection(state) {
   const { doc, selection } = state;
   if (selection === null) return null;
-  if (selection.kind !== "text") return targetOfBlocks(state, chunkFK7EBZPX_cjs.selectedBlockIds(doc, selection));
-  const { from, to } = chunkFK7EBZPX_cjs.orderedRange(doc, selection.anchor, selection.head);
-  if (chunkFK7EBZPX_cjs.comparePos(doc, from, to) !== 0) return { from, to, selected: true };
+  if (selection.kind !== "text") return targetOfBlocks(state, chunkZ5EEDCRI_cjs.selectedBlockIds(doc, selection));
+  const { from, to } = chunkZ5EEDCRI_cjs.orderedRange(doc, selection.anchor, selection.head);
+  if (chunkZ5EEDCRI_cjs.comparePos(doc, from, to) !== 0) return { from, to, selected: true };
   const block = doc.blocks[doc.index.get(from.block)];
   const whole = { block: from.block, region: from.region };
-  return { from: { ...whole, offset: 0 }, to: { ...whole, offset: chunkFK7EBZPX_cjs.regionLength(block, from.region) }, selected: false };
+  return { from: { ...whole, offset: 0 }, to: { ...whole, offset: chunkZ5EEDCRI_cjs.regionLength(block, from.region) }, selected: false };
 }
 function nearestKept(tr, target) {
   const { doc } = tr.before;
   const first = doc.index.get(target.from.block) ?? 0;
   const last = doc.index.get(target.to.block) ?? first;
-  const kept = (block) => block && chunkI7X7B3WD_cjs.blockById(tr.doc, block.id);
+  const kept = (block) => block && chunk4JDRDPLC_cjs.blockById(tr.doc, block.id);
   for (let step = 1; first - step >= 0 || last + step < doc.blocks.length; step++) {
     const found = kept(doc.blocks[first - step]) ?? kept(doc.blocks[last + step]);
     if (found) return found;
@@ -142,10 +143,10 @@ function nearestKept(tr, target) {
 }
 function edgeOf(tr, target) {
   const point = tr.mapPos(target.from, -1);
-  const block = chunkI7X7B3WD_cjs.blockById(tr.doc, point.block) ?? nearestKept(tr, target);
+  const block = chunk4JDRDPLC_cjs.blockById(tr.doc, point.block) ?? nearestKept(tr, target);
   if (block === void 0) return null;
-  const region = chunkFK7EBZPX_cjs.primaryRegion(tr.before.schema, block) ?? "";
-  const length = region === "" ? 0 : chunkFK7EBZPX_cjs.regionLength(block, region);
+  const region = chunkZ5EEDCRI_cjs.primaryRegion(tr.before.schema, block) ?? "";
+  const length = region === "" ? 0 : chunkZ5EEDCRI_cjs.regionLength(block, region);
   const offset = block.id === point.block ? Math.min(point.offset, length) : length;
   const after = offset > 0 || length === 0;
   const at = { block: block.id, region, offset: after ? length : 0 };
@@ -157,31 +158,33 @@ function mapTarget(tr, target) {
   const from = tr.mapPos(target.from, inside);
   const mapped2 = tr.mapPos(target.to, -inside);
   if (!tr.doc.index.has(from.block) || !tr.doc.index.has(mapped2.block)) return edgeOf(tr, target);
-  const to = chunkFK7EBZPX_cjs.comparePos(tr.doc, from, mapped2) > 0 ? from : mapped2;
+  const to = chunkZ5EEDCRI_cjs.comparePos(tr.doc, from, mapped2) > 0 ? from : mapped2;
   return from === target.from && to === target.to ? target : { ...target, from, to };
 }
-var targetGone = (doc, target) => target.lost !== void 0 || target.selected && chunkFK7EBZPX_cjs.comparePos(doc, target.from, target.to) === 0;
+var targetGone = (doc, target) => target.lost !== void 0 || target.selected && chunkZ5EEDCRI_cjs.comparePos(doc, target.from, target.to) === 0;
 function targetRanges(state, { from, to }) {
   const { doc, schema } = state;
   const start = doc.index.get(from.block);
   const end = doc.index.get(to.block);
   return doc.blocks.slice(start, end + 1).flatMap((block, i) => {
-    const region = i === 0 ? from.region : block.id === to.block ? to.region : chunkFK7EBZPX_cjs.primaryRegion(schema, block);
+    const region = i === 0 ? from.region : block.id === to.block ? to.region : chunkZ5EEDCRI_cjs.primaryRegion(schema, block);
     if (region === null || !Object.hasOwn(block.regions, region)) return [];
     const left = i === 0 ? from.offset : 0;
-    const right = block.id === to.block ? to.offset : chunkFK7EBZPX_cjs.regionLength(block, region);
+    const right = block.id === to.block ? to.offset : chunkZ5EEDCRI_cjs.regionLength(block, region);
     return right > left ? [{ block: block.id, region, from: left, to: right }] : [];
   });
 }
 
 // src/extensions/ai/ai-plugin.ts
-var aiKey = chunkFK7EBZPX_cjs.createPluginKey("ai");
+var aiKey = chunkZ5EEDCRI_cjs.createPluginKey("ai");
 var AI = "ai";
 var IDLE = { target: null, menu: null, ghost: null, held: [] };
-var aiState = (state) => chunkFK7EBZPX_cjs.getPluginState(state, aiKey);
-var aiTransaction = (state, act2) => new chunkFK7EBZPX_cjs.Transaction(state).setMeta(AI, act2).setMeta("addToHistory", false);
-function written(ghost, key, phase, output) {
-  return ghost.key !== key ? ghost : { ...ghost, phase, output, shown: closeStreaming(output) };
+var aiState = (state) => chunkZ5EEDCRI_cjs.getPluginState(state, aiKey);
+var aiTransaction = (state, act2) => new chunkZ5EEDCRI_cjs.Transaction(state).setMeta(AI, act2).setMeta("addToHistory", false);
+function written(ghost, key, phase, output, failure) {
+  if (ghost.key !== key) return ghost;
+  const next = { ...ghost, phase, output, shown: closeStreaming(output) };
+  return failure === void 0 ? next : { ...next, failure };
 }
 function act(value, action) {
   switch (action.type) {
@@ -197,8 +200,8 @@ function act(value, action) {
     case "end": {
       const { ghost } = value;
       if (ghost === null || ghost.phase !== "streaming") return value;
-      const phase = action.type === "end" ? action.phase : "streaming";
-      return { ...value, ghost: written(ghost, action.key, phase, action.output) };
+      if (action.type === "stream") return { ...value, ghost: written(ghost, action.key, "streaming", action.output) };
+      return { ...value, ghost: written(ghost, action.key, action.phase, action.output, action.failure) };
     }
     case "discard":
       return { ...value, target: null, menu: null, ghost: null };
@@ -211,8 +214,8 @@ function caretBlock(state) {
   return selection?.kind === "text" ? selection.head.block : null;
 }
 function hasText(state, id) {
-  const block = chunkI7X7B3WD_cjs.blockById(state.doc, id);
-  return block !== void 0 && Object.keys(block.regions).some((region) => chunkFK7EBZPX_cjs.regionLength(block, region) > 0);
+  const block = chunk4JDRDPLC_cjs.blockById(state.doc, id);
+  return block !== void 0 && Object.keys(block.regions).some((region) => chunkZ5EEDCRI_cjs.regionLength(block, region) > 0);
 }
 function heldText(tr, value, before, after) {
   if (!tr.docChanged) return value.held;
@@ -257,6 +260,20 @@ function aiDecorations(state) {
   return decorations;
 }
 
+// src/extensions/ai/ai-failure.ts
+function attempt(call) {
+  try {
+    return call();
+  } catch {
+    return void 0;
+  }
+}
+function failureOf(error, { describeError, isRetryable }) {
+  const reason = describeError && attempt(() => describeError(error));
+  const retryable = attempt(() => isRetryable?.(error)) !== false;
+  return typeof reason === "string" && reason.trim() !== "" ? { reason, retryable } : { retryable };
+}
+
 // src/extensions/ai/ai-actions.ts
 var MENU_ACTIONS = [
   "continue",
@@ -280,8 +297,16 @@ var links = /* @__PURE__ */ new WeakMap();
 function linkOf(editor) {
   let link = links.get(editor);
   if (link === void 0) {
-    link = { mounts: 0, run: null, last: null, report: (error) => console.error(error), ended: () => {
-    }, stopWatching: null };
+    link = {
+      mounts: 0,
+      run: null,
+      last: null,
+      report: (error) => console.error(error),
+      failure: () => ({ retryable: true }),
+      ended: () => {
+      },
+      stopWatching: null
+    };
     links.set(editor, link);
   }
   return link;
@@ -310,13 +335,13 @@ function aroundSelection(text, start, end, limit = CONTEXT_LIMIT) {
 }
 var WHITESPACE_ENTITY = /(?<!\\)&#(32|9);/g;
 var plain = (markdown) => markdown.replace(WHITESPACE_ENTITY, (_, code) => code === "32" ? " " : "	");
-var markdownOf = (state, blocks) => chunkFK7EBZPX_cjs.toMarkdown(blocks, { schema: state.schema, comments: false });
+var markdownOf = (state, blocks) => chunkZ5EEDCRI_cjs.toMarkdown(blocks, { schema: state.schema, comments: false });
 function rangeMarkdown(state, from, to) {
-  const slice = chunkFK7EBZPX_cjs.sliceFromSelection({ ...state, selection: chunkFK7EBZPX_cjs.textSelection(from, to) }, chunkI7X7B3WD_cjs.createBlockCodec(state.schema));
+  const slice = chunkZ5EEDCRI_cjs.sliceFromSelection({ ...state, selection: chunkZ5EEDCRI_cjs.textSelection(from, to) }, chunk4JDRDPLC_cjs.createBlockCodec(state.schema));
   return slice === null ? "" : markdownOf(state, slice.blocks).replace(/\n$/, "");
 }
 function documentContext(state, target, selection) {
-  const blocks = chunkI7X7B3WD_cjs.createBlockCodec(state.schema).blocksFromDoc(state.doc);
+  const blocks = chunk4JDRDPLC_cjs.createBlockCodec(state.schema).blocksFromDoc(state.doc);
   const full = plain(markdownOf(state, blocks));
   if (full.length <= CONTEXT_LIMIT) return full;
   const index = state.doc.index.get(target.from.block) ?? 0;
@@ -355,9 +380,9 @@ function endRun(link, ended = false) {
 var send = (editor, act2) => editor.dispatch(aiTransaction(editor.state, act2));
 async function read(editor, link, run, stream, request) {
   const live = () => link.run === run && link.mounts > 0;
-  const end = (phase) => {
+  const end = (phase, failure) => {
     endRun(link, true);
-    send(editor, { type: "end", key: run.key, phase, output: run.output });
+    send(editor, { type: "end", key: run.key, phase, output: run.output, ...failure && { failure } });
   };
   const draw = () => {
     run.cancelFrame = null;
@@ -376,8 +401,8 @@ async function read(editor, link, run, stream, request) {
     link.ended("done", run.output);
   } catch (error) {
     if (!live()) return;
-    end("error");
-    link.report(chunkEBSDPHPS_cjs.toError(error));
+    end("error", link.failure(error));
+    link.report(chunk4UFWFV43_cjs.toError(error));
   }
 }
 function startStream(editor, link, stream, request, replace) {
@@ -474,7 +499,7 @@ function aiSlashItems(labels, stream) {
       title: labels.askAi,
       description: labels.askAiDescription,
       group: "ai",
-      icon: chunkEBSDPHPS_cjs.Sparkles,
+      icon: chunk4UFWFV43_cjs.Sparkles,
       keywords: KEYWORDS,
       run: ({ controller }) => void openFor(controller)
     },
@@ -482,7 +507,7 @@ function aiSlashItems(labels, stream) {
       id: "ai-continue",
       title: labels.actions.continue,
       group: "ai",
-      icon: chunkEBSDPHPS_cjs.PenLine,
+      icon: chunk4UFWFV43_cjs.PenLine,
       keywords: [...KEYWORDS, "continue"],
       run: ({ controller }) => {
         if (openFor(controller)) askFrom({ controller, stream}, "continue");
@@ -493,14 +518,14 @@ function aiSlashItems(labels, stream) {
 var aiBubbleItem = (labels) => ({
   id: "ai",
   title: labels.askAi,
-  icon: chunkEBSDPHPS_cjs.Sparkles,
+  icon: chunk4UFWFV43_cjs.Sparkles,
   available: (state) => aiState(state).ghost === null,
   run: (controller) => void openFor(controller)
 });
 var aiBlockMenuItem = (labels) => ({
   id: "ai",
   label: labels.askAi,
-  icon: chunkEBSDPHPS_cjs.Sparkles,
+  icon: chunk4UFWFV43_cjs.Sparkles,
   available: (state, blockIds) => targetOfBlocks(state, blockIds) !== null,
   run: (controller, blockIds) => {
     const target = targetOfBlocks(controller.editor.state, blockIds);
@@ -549,25 +574,25 @@ var resolveAiLabels = (overrides) => chunkZWTIRGY5_cjs.mergeLabels(englishAiLabe
 var openOnSpace = (state, dispatch) => {
   const { selection, doc } = state;
   const ai = aiState(state);
-  if (selection?.kind !== "text" || !chunkFK7EBZPX_cjs.isCollapsed(selection) || ai.menu !== null || ai.ghost !== null) return false;
+  if (selection?.kind !== "text" || !chunkZ5EEDCRI_cjs.isCollapsed(selection) || ai.menu !== null || ai.ghost !== null) return false;
   const { head } = selection;
   const block = doc.blocks[doc.index.get(head.block)];
   const paragraph = block.type === "MARKDOWN" && block.attrs.kind === "paragraph";
-  if (!paragraph || chunkFK7EBZPX_cjs.regionLength(block, head.region) > 0 || ai.held.includes(block.id)) return false;
+  if (!paragraph || chunkZ5EEDCRI_cjs.regionLength(block, head.region) > 0 || ai.held.includes(block.id)) return false;
   dispatch?.(aiTransaction(state, { type: "open", target: { from: head, to: head, selected: false }, fromSpace: true }));
   return true;
 };
 
 // src/extensions/ai/ai-accept.ts
-var isParagraph = (block) => block?.type === "MARKDOWN" && chunkI7X7B3WD_cjs.parseLine(String(block.data.markdown ?? "")).kind === "paragraph";
+var isParagraph = (block) => block?.type === "MARKDOWN" && chunk4JDRDPLC_cjs.parseLine(String(block.data.markdown ?? "")).kind === "paragraph";
 var DISCARD = { type: "discard" };
 function insertBeside(tr, schema, target, pieces, makeId) {
   const index = tr.doc.index.get(target.to.block);
-  const at = target.lost?.after ? chunkFK7EBZPX_cjs.descendantsEnd(tr.doc, index) : index;
-  const fresh = chunkFK7EBZPX_cjs.freshBlocks(pieces, tr.doc.blocks[index].indent, makeId);
-  tr.step(chunkFK7EBZPX_cjs.insertBlocksStep(at, fresh));
-  chunkFK7EBZPX_cjs.capIndents(tr, at, at + fresh.length);
-  tr.setSelection(chunkFK7EBZPX_cjs.endOf(tr.doc, schema, fresh[fresh.length - 1].id));
+  const at = target.lost?.after ? chunkZ5EEDCRI_cjs.descendantsEnd(tr.doc, index) : index;
+  const fresh = chunkZ5EEDCRI_cjs.freshBlocks(pieces, tr.doc.blocks[index].indent, makeId);
+  tr.step(chunkZ5EEDCRI_cjs.insertBlocksStep(at, fresh));
+  chunkZ5EEDCRI_cjs.capIndents(tr, at, at + fresh.length);
+  tr.setSelection(chunkZ5EEDCRI_cjs.endOf(tr.doc, schema, fresh[fresh.length - 1].id));
 }
 function acceptAnswer(editor) {
   const { state } = editor;
@@ -575,7 +600,7 @@ function acceptAnswer(editor) {
   if (target === null || ghost === null || ghost.phase === "streaming" || ghost.phase === "error") return null;
   const { codec } = editor;
   const makeId = codec.context.newId;
-  const blocks = chunkI7X7B3WD_cjs.fromMarkdown(ghost.output, { newId: makeId });
+  const blocks = chunk4JDRDPLC_cjs.fromMarkdown(ghost.output, { newId: makeId });
   const pieces = blocks.flatMap((block) => codec.toEngineBlocks(block));
   const tr = editor.createTransaction().setOrigin("ai").setMeta(AI, DISCARD);
   const gone = targetGone(state.doc, target);
@@ -585,12 +610,12 @@ function acceptAnswer(editor) {
     const { schema } = state;
     const open = { openStart: isParagraph(blocks[0]), openEnd: isParagraph(blocks[blocks.length - 1]) };
     if (ghost.replace || gone) {
-      const caret = ghost.replace && !gone ? chunkFK7EBZPX_cjs.deleteRange(tr, schema, target.from, target.to, makeId) : target.to;
-      chunkFK7EBZPX_cjs.pasteAtCaret(tr, schema, caret, open, pieces, makeId);
+      const caret = ghost.replace && !gone ? chunkZ5EEDCRI_cjs.deleteRange(tr, schema, target.from, target.to, makeId) : target.to;
+      chunkZ5EEDCRI_cjs.pasteAtCaret(tr, schema, caret, open, pieces, makeId);
     } else {
       const block = tr.doc.blocks[tr.doc.index.get(target.to.block)];
-      const end = { ...target.to, offset: chunkFK7EBZPX_cjs.regionLength(block, target.to.region) };
-      chunkFK7EBZPX_cjs.pasteAtCaret(tr, schema, end, { openStart: false, openEnd: false }, pieces, makeId);
+      const end = { ...target.to, offset: chunkZ5EEDCRI_cjs.regionLength(block, target.to.region) };
+      chunkZ5EEDCRI_cjs.pasteAtCaret(tr, schema, end, { openStart: false, openEnd: false }, pieces, makeId);
     }
   }
   editor.dispatch(tr);
@@ -603,14 +628,15 @@ function AiBar({ env, ghost, gone, barId }) {
   const content = react.useRef(null);
   const inside = react.useRef(false);
   const [next, setNext] = react.useState("");
-  const { phase } = ghost;
+  const { phase, failure } = ghost;
+  const retryable = failure?.retryable !== false;
   const focusPrimary = () => content.current?.querySelector(`[${PRIMARY}]`)?.focus();
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     const active = content.current?.ownerDocument.activeElement;
     inside.current = active == null || active === active.ownerDocument.body;
     if (inside.current) focusPrimary();
   }, []);
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     const active = content.current?.ownerDocument.activeElement;
     if (inside.current && !content.current?.contains(active ?? null)) focusPrimary();
   }, [phase, ghost.key]);
@@ -658,21 +684,24 @@ function AiBar({ env, ghost, gone, barId }) {
       children: [
         phase === "streaming" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
           /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-muted-foreground", children: labels.writing }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { ...primary, size: "sm", variant: "outline", onClick: () => stop(editor), children: labels.stop })
+          /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { ...primary, size: "sm", variant: "outline", onClick: () => stop(editor), children: labels.stop })
         ] }),
         phase === "error" && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
-          /* @__PURE__ */ jsxRuntime.jsx("p", { role: "alert", className: "text-sm text-destructive", children: labels.failed }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { ...primary, size: "sm", onClick: () => retry(editor, stream), children: labels.retry }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { size: "sm", variant: "ghost", onClick: onDiscard, children: labels.discard })
+          /* @__PURE__ */ jsxRuntime.jsxs("div", { role: "alert", className: "text-sm", children: [
+            /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-destructive", children: labels.failed }),
+            failure?.reason !== void 0 && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-xs text-muted-foreground", children: failure.reason })
+          ] }),
+          retryable && /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { ...primary, size: "sm", onClick: () => retry(editor, stream), children: labels.retry }),
+          /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { ...retryable ? {} : primary, size: "sm", variant: "ghost", onClick: onDiscard, children: labels.discard })
         ] }),
         (phase === "done" || phase === "stopped") && /* @__PURE__ */ jsxRuntime.jsxs(jsxRuntime.Fragment, { children: [
           phase === "stopped" && /* @__PURE__ */ jsxRuntime.jsx("span", { className: "text-sm text-muted-foreground", children: labels.stopped }),
           gone && /* @__PURE__ */ jsxRuntime.jsx("p", { className: "w-full text-xs text-muted-foreground", children: labels.targetGone }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { ...primary, size: "sm", onClick: onAccept, children: labels.accept }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { size: "sm", variant: "ghost", onClick: onDiscard, children: labels.discard }),
-          /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.Button, { size: "sm", variant: "ghost", onClick: () => retry(editor, stream), children: labels.retry }),
+          /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { ...primary, size: "sm", onClick: onAccept, children: labels.accept }),
+          /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { size: "sm", variant: "ghost", onClick: onDiscard, children: labels.discard }),
+          /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.Button, { size: "sm", variant: "ghost", onClick: () => retry(editor, stream), children: labels.retry }),
           /* @__PURE__ */ jsxRuntime.jsx("form", { className: "w-full", onSubmit: onFollowUp, children: /* @__PURE__ */ jsxRuntime.jsx(
-            chunkEBSDPHPS_cjs.Input,
+            chunk4UFWFV43_cjs.Input,
             {
               "aria-label": labels.followUp,
               placeholder: labels.followUp,
@@ -693,8 +722,8 @@ function AiBar({ env, ghost, gone, barId }) {
 var reader = null;
 function readerOf() {
   if (reader === null) {
-    const schema = chunkI7X7B3WD_cjs.createSchema();
-    reader = { schema, codec: chunkI7X7B3WD_cjs.createBlockCodec(schema) };
+    const schema = chunk4JDRDPLC_cjs.createSchema();
+    reader = { schema, codec: chunk4JDRDPLC_cjs.createBlockCodec(schema) };
   }
   return reader;
 }
@@ -702,16 +731,16 @@ function fillGhost(ghost, markdown) {
   const doc = ghost.ownerDocument;
   const { schema, codec } = readerOf();
   const drawn2 = [];
-  for (const block of chunkI7X7B3WD_cjs.fromMarkdown(markdown)) {
+  for (const block of chunk4JDRDPLC_cjs.fromMarkdown(markdown)) {
     for (const piece of codec.toEngineBlocks(block)) {
       const element = doc.createElement("div");
       element.className = "quoin-ai-ghost-block";
       element.dataset.kind = String(piece.attrs.kind ?? piece.type.toLowerCase());
       if (piece.attrs.level !== void 0) element.dataset.level = String(piece.attrs.level);
       if (piece.indent > 0) element.style.setProperty("--quoin-ai-indent", String(piece.indent));
-      const region = chunkFK7EBZPX_cjs.primaryRegion(schema, piece);
-      if (region === null) element.textContent = chunkFK7EBZPX_cjs.toPlainText([codec.toQuoin(piece)], { schema });
-      else chunk2QKFRKOP_cjs.renderInline(element, piece.regions[region], []);
+      const region = chunkZ5EEDCRI_cjs.primaryRegion(schema, piece);
+      if (region === null) element.textContent = chunkZ5EEDCRI_cjs.toPlainText([codec.toQuoin(piece)], { schema });
+      else chunkN25EH2GZ_cjs.renderInline(element, piece.regions[region], []);
       drawn2.push(element);
     }
   }
@@ -788,7 +817,7 @@ function clipAside(layer, text, areas, scale) {
 function useGhostPlace(controller, layer, block, region) {
   const placeNow = react.useRef(() => {
   });
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     const root = controller.root;
     const element = layer.current;
     const view = root?.ownerDocument.defaultView;
@@ -827,7 +856,7 @@ function AiGhost({ env, ghost, target, gone, barId }) {
   const layer = react.useRef(null);
   const drawn2 = react.useRef(null);
   const place2 = useGhostPlace(env.controller, layer, target.to.block, target.to.region);
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     const element = drawn2.current;
     if (element === null) return;
     element.setAttribute("inert", "");
@@ -841,7 +870,7 @@ function AiGhost({ env, ghost, target, gone, barId }) {
 }
 function useTargetAnchor(controller, target) {
   const latest = react.useRef(target);
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     latest.current = target;
   });
   return react.useMemo(() => {
@@ -850,8 +879,8 @@ function useTargetAnchor(controller, target) {
       return { block: to.block, region: to.region, from: to.offset, to: to.offset };
     };
     return {
-      current: chunkEBSDPHPS_cjs.virtualAnchor(
-        () => chunkEBSDPHPS_cjs.rangeRect(controller, end()),
+      current: chunk4UFWFV43_cjs.virtualAnchor(
+        () => chunk4UFWFV43_cjs.rangeRect(controller, end()),
         () => controller.registry.get(end().block, end().region)
       )
     };
@@ -905,7 +934,7 @@ function AiMenu({ env, target, fromSpace }) {
   };
   const fieldLabel = asking === "tone" ? labels.tonePrompt : asking === "translate" ? labels.translatePrompt : labels.prompt;
   return /* @__PURE__ */ jsxRuntime.jsxs(
-    chunkEBSDPHPS_cjs.Popover,
+    chunk4UFWFV43_cjs.Popover,
     {
       open: true,
       modal: false,
@@ -913,9 +942,9 @@ function AiMenu({ env, target, fromSpace }) {
         if (!next) closeMenu(controller.editor);
       },
       children: [
-        /* @__PURE__ */ jsxRuntime.jsx(chunkEBSDPHPS_cjs.PopoverAnchor, { virtualRef: anchor }),
+        /* @__PURE__ */ jsxRuntime.jsx(chunk4UFWFV43_cjs.PopoverAnchor, { virtualRef: anchor }),
         /* @__PURE__ */ jsxRuntime.jsxs(
-          chunkEBSDPHPS_cjs.PopoverContent,
+          chunk4UFWFV43_cjs.PopoverContent,
           {
             "aria-label": labels.askAi,
             side: "bottom",
@@ -932,7 +961,7 @@ function AiMenu({ env, target, fromSpace }) {
             },
             children: [
               /* @__PURE__ */ jsxRuntime.jsx(
-                chunkEBSDPHPS_cjs.Input,
+                chunk4UFWFV43_cjs.Input,
                 {
                   ref: field,
                   role: "combobox",
@@ -950,13 +979,13 @@ function AiMenu({ env, target, fromSpace }) {
                   onKeyDown
                 }
               ),
-              choices.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("ul", { id: `${id}-list`, role: "listbox", "aria-label": labels.menu, className: "mt-1 max-h-72 overflow-y-auto", children: choices.map((choice, index) => /* @__PURE__ */ jsxRuntime.jsx(
+              choices.length > 0 && /* @__PURE__ */ jsxRuntime.jsx("ul", { id: `${id}-list`, role: "listbox", "aria-label": labels.menu, className: "mt-1 max-h-72 list-none overflow-y-auto", children: choices.map((choice, index) => /* @__PURE__ */ jsxRuntime.jsx(
                 "li",
                 {
                   id: optionId(index),
                   role: "option",
                   "aria-selected": index === current,
-                  className: chunkEBSDPHPS_cjs.cn(chunkEBSDPHPS_cjs.MENU_ITEM, index === current && "bg-accent text-accent-foreground"),
+                  className: chunk4UFWFV43_cjs.cn(chunk4UFWFV43_cjs.MENU_ITEM, index === current && "bg-accent text-accent-foreground"),
                   onMouseDown: (event) => event.preventDefault(),
                   onClick: () => choose(choice),
                   children: choice.label
@@ -974,17 +1003,17 @@ var goneOf = (state) => {
   const { target, ghost } = aiState(state);
   return target !== null && ghost !== null && targetGone(state.doc, target);
 };
-var plainText = (markdown) => chunkFK7EBZPX_cjs.toPlainText(chunkI7X7B3WD_cjs.fromMarkdown(markdown));
+var plainText = (markdown) => chunkZ5EEDCRI_cjs.toPlainText(chunk4JDRDPLC_cjs.fromMarkdown(markdown));
 function AiOverlay({ controller, stream, labels }) {
-  const { onError } = chunkEBSDPHPS_cjs.useQuoin();
+  const { onError } = chunk4UFWFV43_cjs.useQuoin();
   const link = linkOf(controller.editor);
-  chunk2QKFRKOP_cjs.useIsomorphicLayoutEffect(() => {
+  chunkN25EH2GZ_cjs.useIsomorphicLayoutEffect(() => {
     link.report = onError;
     link.ended = (phase, output) => controller.announce((phase === "done" ? labels.written : labels.halted)(plainText(output)));
   }, [link, onError, controller, labels]);
-  const value = chunk2QKFRKOP_cjs.useEditorState(controller, aiState);
-  const gone = chunk2QKFRKOP_cjs.useEditorState(controller, goneOf);
-  const readOnly = chunk2QKFRKOP_cjs.useReadOnly(controller);
+  const value = chunkN25EH2GZ_cjs.useEditorState(controller, aiState);
+  const gone = chunkN25EH2GZ_cjs.useEditorState(controller, goneOf);
+  const readOnly = chunkN25EH2GZ_cjs.useReadOnly(controller);
   const env = react.useMemo(() => ({ controller, stream, labels }), [controller, stream, labels]);
   const barId = react.useId();
   const showing = value.ghost !== null;
@@ -1003,7 +1032,7 @@ function AiOverlay({ controller, stream, labels }) {
     const root = controller.root;
     if (!root) return;
     let away = true;
-    return chunk3HW3WRYC_cjs.watchCanvasFocus(controller, root.ownerDocument, (inside, node) => {
+    return chunkCSIUXYRU_cjs.watchCanvasFocus(controller, root.ownerDocument, (inside, node) => {
       if (!inside) away = true;
       else if (root.contains(node)) {
         if (away) noteFocus(controller.editor);
@@ -1039,7 +1068,7 @@ function aiExtension(options) {
     blockMenuItems: [aiBlockMenuItem(labels)],
     overlays: [Overlay]
   };
-  return chunkFK7EBZPX_cjs.defineExtension({
+  return chunkZ5EEDCRI_cjs.defineExtension({
     name: "ai",
     plugins: [aiPlugin],
     decorations: aiDecorations,
@@ -1047,6 +1076,7 @@ function aiExtension(options) {
     // One watcher per editor however many views mount it, and the stream ends with the last of them.
     onMount(editor) {
       const link = linkOf(editor);
+      link.failure = (error) => failureOf(error, options);
       if (link.mounts++ === 0) link.stopWatching = watchGhost(editor, link);
       return () => {
         if (--link.mounts > 0) return;

package/dist/ai.d.cts

@@ -8,6 +8,13 @@ type AiOptions = {
     stream: AiStream;
     /** Every string AI actions show or speak, English by default. A key left out stays English. */
     labels?: Partial<AiLabels>;
+    /**
+     * The reason a failed answer shows under `labels.failed`, given what the stream threw or rejected with. Nothing is
+     * shown for an error it returns undefined for, so an error it was not written for stays out of the bar.
+     */
+    describeError?: (error: unknown) => string | undefined;
+    /** Whether a failed answer is worth asking for again: false leaves Discard alone in the bar. Defaults to always. */
+    isRetryable?: (error: unknown) => boolean;
 };
 /**
  * AI actions on the host's model: the AI menu, opened from the slash menu, the toolbar, the block menu or a Space on

package/dist/ai.d.ts

@@ -8,6 +8,13 @@ type AiOptions = {
     stream: AiStream;
     /** Every string AI actions show or speak, English by default. A key left out stays English. */
     labels?: Partial<AiLabels>;
+    /**
+     * The reason a failed answer shows under `labels.failed`, given what the stream threw or rejected with. Nothing is
+     * shown for an error it returns undefined for, so an error it was not written for stays out of the bar.
+     */
+    describeError?: (error: unknown) => string | undefined;
+    /** Whether a failed answer is worth asking for again: false leaves Discard alone in the bar. Defaults to always. */
+    isRetryable?: (error: unknown) => boolean;
 };
 /**
  * AI actions on the host's model: the AI menu, opened from the slash menu, the toolbar, the block menu or a Space on