@bendyline/docblocks-react 2.6.1 → 2.7.0

package/dist/AiEditorAssistant-M4LI2CRY.js

@@ -0,0 +1,771 @@
+import {
+  AiDiagramDialog
+} from "./chunk-OINKNX26.js";
+import {
+  useConfirmDialog
+} from "./chunk-6B7G33D5.js";
+import {
+  useMenuKeyboard
+} from "./chunk-MRUK56JS.js";
+import {
+  AI_INSTRUCTION_CHARACTERS,
+  AI_REVIEW_DOCUMENT_CHARACTERS,
+  AI_REWRITE_SELECTION_CHARACTERS,
+  applyAiReviewFinding,
+  buildDraftContinuation,
+  buildDraftRequest,
+  buildReviewRequest,
+  findUniqueExcerpt,
+  parseAiReviewResponse,
+  sanitizeGeneratedMarkdown
+} from "./chunk-5OZBGIIT.js";
+import {
+  unavailableSentence,
+  useAiStatus
+} from "./chunk-K4I3NJFL.js";
+import {
+  Dialog
+} from "./chunk-56KO2LYN.js";
+
+// src/Ai/AiEditorAssistant.tsx
+import { useCallback, useEffect as useEffect2, useMemo, useRef, useState as useState2 } from "react";
+import { createPortal } from "react-dom";
+import {
+  useEditorContext,
+  useEditorContextMenuItems
+} from "@bendyline/squisq-editor-react";
+
+// src/Ai/AiGenerationStatus.tsx
+import { useEffect, useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+var LABELS = {
+  starting: "Waiting for model\u2026",
+  queued: "Waiting for an available model\u2026",
+  loading_model: "Loading model\u2026",
+  prefill: "Processing input (prefill)\u2026",
+  reasoning: "Thinking\u2026",
+  generating: "Writing\u2026"
+};
+function duration(milliseconds) {
+  const seconds = Math.max(0, Math.floor(milliseconds / 1e3));
+  return seconds < 60 ? `${seconds}s` : `${Math.floor(seconds / 60)}m ${String(seconds % 60).padStart(2, "0")}s`;
+}
+function AiGenerationStatus({
+  state,
+  characters
+}) {
+  const [now, setNow] = useState(Date.now);
+  useEffect(() => {
+    const timer = setInterval(() => setNow(Date.now()), 1e3);
+    return () => clearInterval(timer);
+  }, []);
+  const progress = state.progress;
+  const label = progress ? LABELS[progress.phase] : "Waiting for response\u2026";
+  const percent = progress?.phase === "prefill" ? progress.percent : null;
+  const details = [`${duration(now - state.startedAt)} elapsed`];
+  if (progress?.outputTokens != null) {
+    details.push(`${progress.outputTokens.toLocaleString()} tokens generated`);
+  } else if (characters > 0) {
+    details.push(`${characters.toLocaleString()} characters received`);
+  }
+  if (progress?.tokensPerSecond != null) {
+    details.push(`${progress.tokensPerSecond.toFixed(1)} tokens/s`);
+  }
+  if (now - state.lastActivityAt >= 15e3) {
+    details.push(
+      progress || characters > 0 ? `Last update ${duration(now - state.lastActivityAt)} ago` : "No progress updates received"
+    );
+  }
+  return /* @__PURE__ */ jsxs("div", { className: "db-ai-generation-status", children: [
+    /* @__PURE__ */ jsxs("p", { className: "db-ai-progress", role: "status", children: [
+      /* @__PURE__ */ jsx("span", { className: "db-ai-spinner", "aria-hidden": "true" }),
+      label,
+      percent != null ? ` ${Math.floor(percent)}%` : ""
+    ] }),
+    percent != null && /* @__PURE__ */ jsx("progress", { "aria-label": label.replace("\u2026", ""), max: 100, value: percent }),
+    /* @__PURE__ */ jsx("p", { className: "db-ai-note", "aria-live": "off", children: details.join(" \xB7 ") })
+  ] });
+}
+
+// src/Ai/draft-capacity.ts
+import { AI_WIRE_LIMITS } from "@bendyline/docblocks/host";
+function estimateTokens(text) {
+  return Math.ceil(new TextEncoder().encode(text).length / 3);
+}
+function draftCapacityNotice(request, model, expectedOutput = "") {
+  const characters = request.messages.reduce((sum, message) => sum + message.content.length, 0);
+  if (characters > AI_WIRE_LIMITS.promptCharacters) {
+    return {
+      blocked: true,
+      message: "The source and draft together exceed the request size this app can send. Your draft is preserved. Work on a smaller section, or copy the draft before closing."
+    };
+  }
+  const capacity = model?.contextWindow;
+  if (!capacity || capacity <= 0) return null;
+  const input = request.messages.reduce(
+    (sum, message) => sum + estimateTokens(message.content) + 8,
+    0
+  );
+  const reserve = Math.min(4096, Math.floor(capacity / 4));
+  if (input + estimateTokens(expectedOutput) + reserve <= capacity) return null;
+  return {
+    blocked: false,
+    message: `This request may exceed ${model.label}'s reported ${capacity.toLocaleString()}-token context. Input, thinking, and the draft share that space. This is a size estimate, not an exact token count; local runtime limits may be smaller. For a complete result, use a smaller selection or choose a model with more context in Settings.`
+  };
+}
+
+// src/Ai/AiEditorAssistant.tsx
+import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+function AiToolbarControl({
+  ai,
+  readOnly = false,
+  openPanel,
+  onOpenPanel
+}) {
+  const {
+    activeView,
+    editorMode,
+    getSelection,
+    insertBlockAfterCursor,
+    layoutMode,
+    markdownSource,
+    replaceSelection,
+    selectionVersion
+  } = useEditorContext();
+  const status = useAiStatus(ai);
+  const [menuOpen, setMenuOpen] = useState2(false);
+  const [draftMode, setDraftMode] = useState2(null);
+  const [capturedSelection, setCapturedSelection] = useState2(null);
+  const [diagramSelection, setDiagramSelection] = useState2(null);
+  const rootRef = useRef(null);
+  const { menuRef, triggerRef, handleMenuKeyDown, handleTriggerKeyDown, closeMenu } = useMenuKeyboard(menuOpen, setMenuOpen);
+  void activeView;
+  void selectionVersion;
+  const selection = getSelection();
+  useEffect2(() => {
+    if (!menuOpen) return;
+    const onPointerDown = (event) => {
+      if (rootRef.current && !rootRef.current.contains(event.target)) setMenuOpen(false);
+    };
+    document.addEventListener("pointerdown", onPointerDown);
+    return () => document.removeEventListener("pointerdown", onPointerDown);
+  }, [menuOpen]);
+  const ready = status?.kind === "ready" && status.model !== null;
+  const openDiagram = () => {
+    const current = getSelection();
+    if (!current) return;
+    setDiagramSelection(current);
+    closeMenu(false);
+  };
+  const contextMenuItems = editorMode === "markdown" && ready && !readOnly ? [
+    {
+      id: "docblocks-ai-diagram",
+      label: "Diagram this\u2026",
+      group: "ai",
+      when: "selection",
+      disabled: (context) => !context.editable,
+      onSelect: openDiagram
+    }
+  ] : [];
+  useEditorContextMenuItems(contextMenuItems);
+  if (editorMode !== "markdown" || status?.kind === "unavailable" && status.reason === "opt-out") {
+    return null;
+  }
+  const editableSelection = !readOnly && ready ? selection : null;
+  const canCompose = editableSelection?.empty === true;
+  const canRewrite = editableSelection?.empty === false && (editableSelection.markdown ?? editableSelection.text).length <= AI_REWRITE_SELECTION_CHARACTERS;
+  const openDraft = (mode) => {
+    const current = getSelection();
+    if (!current) return;
+    setCapturedSelection(current);
+    setDraftMode(mode);
+    closeMenu(false);
+  };
+  const closeDraft = () => {
+    setDraftMode(null);
+    setCapturedSelection(null);
+  };
+  return /* @__PURE__ */ jsxs2(Fragment, { children: [
+    /* @__PURE__ */ jsxs2("div", { className: "db-toolbar-menu db-ai-toolbar", ref: rootRef, children: [
+      /* @__PURE__ */ jsx2(
+        "button",
+        {
+          ref: triggerRef,
+          type: "button",
+          className: `squisq-toolbar-button db-ai-toolbar-trigger${openPanel ? " squisq-toolbar-button--active" : ""}`,
+          onClick: () => setMenuOpen((open) => !open),
+          onKeyDown: handleTriggerKeyDown,
+          "aria-label": "AI actions",
+          "aria-haspopup": "menu",
+          "aria-expanded": menuOpen,
+          "data-tooltip": "AI actions",
+          children: /* @__PURE__ */ jsx2(SparklesGlyph, {})
+        }
+      ),
+      menuOpen && /* @__PURE__ */ jsxs2(
+        "div",
+        {
+          ref: menuRef,
+          className: "db-toolbar-menu-dropdown db-ai-toolbar-menu",
+          role: "menu",
+          "aria-label": "AI actions",
+          onKeyDown: handleMenuKeyDown,
+          children: [
+            !ready && /* @__PURE__ */ jsx2("div", { className: "db-ai-toolbar-status", role: "status", children: unavailableSentence(status) }),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-toolbar-menu-item",
+                disabled: !canCompose,
+                onClick: () => openDraft("compose"),
+                children: "Add content\u2026"
+              }
+            ),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-toolbar-menu-item",
+                disabled: !canRewrite,
+                onClick: () => openDraft("rewrite"),
+                children: "Rewrite selection\u2026"
+              }
+            ),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-toolbar-menu-item",
+                disabled: !ready || readOnly,
+                onClick: () => {
+                  closeMenu(false);
+                  onOpenPanel("review");
+                },
+                children: openPanel === "review" ? "Show document review" : "Review document\u2026"
+              }
+            ),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-toolbar-menu-item",
+                disabled: !ready || readOnly || layoutMode !== "document",
+                onClick: () => {
+                  closeMenu(false);
+                  onOpenPanel("illustrate");
+                },
+                children: openPanel === "illustrate" ? "Show illustrations" : "Illustrate document\u2026"
+              }
+            ),
+            /* @__PURE__ */ jsx2(
+              "button",
+              {
+                type: "button",
+                role: "menuitem",
+                tabIndex: -1,
+                className: "db-toolbar-menu-item",
+                disabled: !editableSelection,
+                onClick: openDiagram,
+                children: "Insert diagram\u2026"
+              }
+            ),
+            ready && !selection && /* @__PURE__ */ jsx2("div", { className: "db-ai-toolbar-status", children: "Switch to Write or Source to edit with AI." }),
+            ready && selection && !selection.empty && !canRewrite && /* @__PURE__ */ jsx2("div", { className: "db-ai-toolbar-status", children: "The selection is too long to rewrite." }),
+            ready && layoutMode !== "document" && /* @__PURE__ */ jsx2("div", { className: "db-ai-toolbar-status", children: "Switch to the Document layout to illustrate." })
+          ]
+        }
+      )
+    ] }),
+    draftMode && capturedSelection && /* @__PURE__ */ jsx2(
+      AiDraftDialog,
+      {
+        ai,
+        model: status?.kind === "ready" ? status.model : null,
+        mode: draftMode,
+        documentSource: markdownSource,
+        capturedSelection,
+        getSelection,
+        replaceSelection,
+        onClose: closeDraft
+      }
+    ),
+    diagramSelection && /* @__PURE__ */ jsx2(
+      AiDiagramDialog,
+      {
+        ai,
+        documentSource: markdownSource,
+        capturedSelection: diagramSelection,
+        getSelection,
+        insertBlockAfterCursor,
+        onClose: () => setDiagramSelection(null)
+      }
+    )
+  ] });
+}
+function AiDraftDialog({
+  ai,
+  model,
+  mode,
+  documentSource,
+  capturedSelection,
+  getSelection,
+  replaceSelection,
+  onClose
+}) {
+  const defaultInstructions = mode === "compose" ? "Add a concise introduction for this document." : "Improve clarity and flow while preserving the meaning and voice.";
+  const [instructions, setInstructions] = useState2("");
+  const [draft, setDraft] = useState2(null);
+  const generatedDraftRef = useRef("");
+  const carriedEditsRef = useRef(false);
+  const [originalRequest, setOriginalRequest] = useState2(null);
+  const [incomplete, setIncomplete] = useState2(false);
+  const [prefixCharacters, setPrefixCharacters] = useState2(0);
+  const [running, setRunning] = useState2(false);
+  const [generation, setGeneration] = useState2(null);
+  const [error, setError] = useState2(null);
+  const [finishNote, setFinishNote] = useState2(null);
+  const promptRef = useRef(null);
+  const handleRef = useRef(null);
+  const requestRef = useRef(0);
+  const { confirm: confirmAction, confirmDialog } = useConfirmDialog();
+  const selectedMarkdown = capturedSelection.markdown ?? capturedSelection.text;
+  const draftRequest = useMemo(
+    () => ({
+      ...buildDraftRequest({
+        mode,
+        instructions: instructions.trim() || defaultInstructions,
+        documentSource,
+        selectedText: selectedMarkdown
+      }),
+      ...model ? { model: model.id } : {}
+    }),
+    [mode, instructions, defaultInstructions, documentSource, selectedMarkdown, model]
+  );
+  const continuationRequest = originalRequest && draft ? buildDraftContinuation({ ...originalRequest, ...model ? { model: model.id } : {} }, draft) : null;
+  const capacity = draftCapacityNotice(
+    incomplete && continuationRequest ? continuationRequest : draftRequest,
+    model,
+    incomplete || mode === "compose" ? "" : selectedMarkdown
+  );
+  useEffect2(
+    () => () => {
+      requestRef.current += 1;
+      handleRef.current?.cancel();
+    },
+    []
+  );
+  const start = useCallback(
+    (request, prefix = "") => {
+      const requestId = ++requestRef.current;
+      handleRef.current?.cancel();
+      generatedDraftRef.current = prefix;
+      setDraft(prefix);
+      setPrefixCharacters(prefix.length);
+      setError(null);
+      setFinishNote(null);
+      setIncomplete(false);
+      setRunning(true);
+      const startedAt = Date.now();
+      setGeneration({ progress: null, startedAt, lastActivityAt: startedAt });
+      const handle = ai.chat(request, (event) => {
+        if (requestRef.current !== requestId) return;
+        if (event.kind === "progress") {
+          setGeneration(
+            (current) => current && {
+              ...current,
+              progress: event.progress,
+              lastActivityAt: Date.now()
+            }
+          );
+          return;
+        }
+        if (event.kind === "delta") {
+          generatedDraftRef.current += event.text;
+          setDraft(generatedDraftRef.current);
+          setGeneration(
+            (current) => current && {
+              ...current,
+              lastActivityAt: Date.now(),
+              progress: {
+                phase: "generating",
+                percent: null,
+                outputTokens: current.progress?.outputTokens ?? null,
+                tokensPerSecond: current.progress?.tokensPerSecond ?? null
+              }
+            }
+          );
+          return;
+        }
+        setRunning(false);
+        if (event.kind === "error") {
+          setError(event.error.message);
+          setIncomplete(Boolean(generatedDraftRef.current.trim()));
+          return;
+        }
+        const emptyContinuation = Boolean(prefix) && !event.completion.text.trim();
+        const finished = event.completion.finishReason === "stop" && !emptyContinuation;
+        generatedDraftRef.current = prefix || !finished ? prefix + event.completion.text : sanitizeGeneratedMarkdown(event.completion.text);
+        setDraft(generatedDraftRef.current);
+        setIncomplete(!finished && Boolean(generatedDraftRef.current.trim()));
+        if (event.completion.finishReason === "cancelled") {
+          setFinishNote("Generation stopped. The draft may be incomplete.");
+        }
+        if (event.completion.finishReason === "length") {
+          setFinishNote(
+            generatedDraftRef.current.trim() ? "Draft incomplete: the model reached a limit. Continue the draft to request the rest. If this repeats, use a smaller selection or a model with more context. Your draft and original document are preserved." : "The model reached a limit before producing a draft. Try a smaller selection or a model with more context. Your original document is unchanged."
+          );
+        }
+        if (emptyContinuation && event.completion.finishReason === "stop") {
+          setFinishNote(
+            "The model returned no additional text. Your draft is preserved and may still be incomplete. Try a smaller selection or a model with more context."
+          );
+        }
+      });
+      handleRef.current = handle;
+    },
+    [ai]
+  );
+  const generate = useCallback(async () => {
+    if (running || draftCapacityNotice(draftRequest, model)?.blocked) return;
+    const previousRequest = requestRef.current;
+    if (draft !== null && (carriedEditsRef.current || draft !== generatedDraftRef.current)) {
+      const accepted = await confirmAction({
+        title: "Regenerate AI draft",
+        message: "This will remove all edits you have made. Continue?",
+        confirmLabel: "Continue",
+        destructive: true
+      });
+      if (!accepted || requestRef.current !== previousRequest) return;
+    }
+    carriedEditsRef.current = false;
+    setOriginalRequest(draftRequest);
+    start(draftRequest);
+  }, [running, draftRequest, model, draft, confirmAction, start]);
+  const continueDraft = () => {
+    if (running || !incomplete || !draft || !continuationRequest || capacity?.blocked) return;
+    carriedEditsRef.current || (carriedEditsRef.current = draft !== generatedDraftRef.current);
+    start(continuationRequest, draft);
+  };
+  const stop = useCallback(() => handleRef.current?.cancel(), []);
+  const apply = useCallback(async () => {
+    if (running) return;
+    const replacement = sanitizeGeneratedMarkdown(draft ?? "");
+    if (!replacement) return;
+    if (incomplete) {
+      const previousRequest = requestRef.current;
+      const accepted = await confirmAction({
+        title: "Use incomplete AI draft?",
+        message: mode === "rewrite" ? "This draft did not finish. Replacing the selection may remove content that has not been rewritten. Use it only if you have reviewed and completed it yourself." : "This draft did not finish. Use it only if you have reviewed and completed it yourself.",
+        confirmLabel: mode === "rewrite" ? "Replace anyway" : "Insert anyway",
+        destructive: mode === "rewrite"
+      });
+      if (!accepted || requestRef.current !== previousRequest) return;
+    }
+    const current = getSelection();
+    if (!current || current.view !== capturedSelection.view) {
+      setError("Return to the original editor view and try again.");
+      return;
+    }
+    if (mode === "compose" && !current.empty) {
+      setError("The cursor selection changed. Close this dialog and choose Add content again.");
+      return;
+    }
+    if (mode === "rewrite" && (current.empty || current.text !== capturedSelection.text || (current.markdown ?? current.text) !== selectedMarkdown)) {
+      setError("The selected text changed. Close this dialog and select it again.");
+      return;
+    }
+    if (!replaceSelection(replacement)) {
+      setError("DocBlocks could not apply the draft in the current editor view.");
+      return;
+    }
+    onClose();
+  }, [
+    capturedSelection,
+    selectedMarkdown,
+    draft,
+    getSelection,
+    mode,
+    onClose,
+    replaceSelection,
+    running,
+    incomplete,
+    confirmAction
+  ]);
+  const dialog = /* @__PURE__ */ jsxs2(
+    Dialog,
+    {
+      title: mode === "compose" ? "Add content with AI" : "Rewrite with AI",
+      onClose,
+      size: "wide",
+      closeOnBackdrop: !running,
+      initialFocusRef: promptRef,
+      className: "db-ai-draft-dialog",
+      bodyClassName: "db-ai-draft-body",
+      footerClassName: "db-ai-draft-footer",
+      footer: /* @__PURE__ */ jsxs2(Fragment, { children: [
+        (running || finishNote || error || capacity) && /* @__PURE__ */ jsxs2("div", { className: "db-ai-footer-status", children: [
+          running && generation && /* @__PURE__ */ jsx2(
+            AiGenerationStatus,
+            {
+              state: generation,
+              characters: Math.max(0, (draft?.length ?? 0) - prefixCharacters)
+            }
+          ),
+          finishNote && /* @__PURE__ */ jsx2("p", { className: "db-ai-note", children: finishNote }),
+          !running && capacity && /* @__PURE__ */ jsx2("p", { className: "db-ai-note", role: "status", children: capacity.message }),
+          error && /* @__PURE__ */ jsx2("p", { className: "db-ai-error", role: "alert", children: error })
+        ] }),
+        /* @__PURE__ */ jsxs2("div", { className: "db-ai-draft-actions", children: [
+          /* @__PURE__ */ jsx2("button", { type: "button", onClick: onClose, children: "Cancel" }),
+          running ? /* @__PURE__ */ jsx2("button", { type: "button", className: "db-ai-secondary-action", onClick: stop, children: "Stop" }) : draft !== null ? /* @__PURE__ */ jsxs2(Fragment, { children: [
+            /* @__PURE__ */ jsx2("button", { type: "button", className: "db-ai-secondary-action", onClick: generate, children: "Regenerate" }),
+            incomplete && draft.trim() && /* @__PURE__ */ jsx2("button", { type: "button", disabled: capacity?.blocked, onClick: continueDraft, children: "Continue draft" })
+          ] }) : null,
+          /* @__PURE__ */ jsx2("button", { type: "button", disabled: !draft?.trim() || running, onClick: apply, children: mode === "compose" ? "Insert" : "Replace selection" })
+        ] })
+      ] }),
+      children: [
+        /* @__PURE__ */ jsxs2("label", { className: "db-ai-field", children: [
+          /* @__PURE__ */ jsx2("span", { children: mode === "compose" ? "What should be added?" : "How should this be rewritten?" }),
+          /* @__PURE__ */ jsx2(
+            "textarea",
+            {
+              ref: promptRef,
+              value: instructions,
+              maxLength: AI_INSTRUCTION_CHARACTERS,
+              rows: 2,
+              placeholder: defaultInstructions,
+              onChange: (event) => setInstructions(event.currentTarget.value)
+            }
+          )
+        ] }),
+        mode === "rewrite" && /* @__PURE__ */ jsxs2("div", { className: "db-ai-selection-preview", children: [
+          /* @__PURE__ */ jsx2("span", { children: "Selected text" }),
+          /* @__PURE__ */ jsx2("blockquote", { tabIndex: 0, "aria-label": "Selected text", children: capturedSelection.text })
+        ] }),
+        draft === null ? /* @__PURE__ */ jsx2("div", { className: "db-ai-draft-start", children: /* @__PURE__ */ jsx2("button", { type: "button", onClick: generate, disabled: capacity?.blocked, children: capacity && !capacity.blocked ? "Generate anyway" : "Generate" }) }) : /* @__PURE__ */ jsxs2(Fragment, { children: [
+          /* @__PURE__ */ jsxs2("label", { className: "db-ai-field db-ai-draft-field", children: [
+            /* @__PURE__ */ jsx2("span", { children: "AI draft" }),
+            /* @__PURE__ */ jsx2(
+              "textarea",
+              {
+                className: "db-ai-draft-output",
+                value: draft,
+                rows: 10,
+                placeholder: running ? "The draft will appear here." : "",
+                "aria-busy": running,
+                readOnly: running,
+                onChange: (event) => setDraft(event.currentTarget.value)
+              }
+            )
+          ] }),
+          /* @__PURE__ */ jsx2("p", { className: "db-ai-disclaimer", children: "Review and edit AI-generated content before adding it." })
+        ] })
+      ]
+    }
+  );
+  const dialogs = /* @__PURE__ */ jsxs2(Fragment, { children: [
+    dialog,
+    confirmDialog
+  ] });
+  return typeof document === "undefined" ? dialogs : createPortal(dialogs, document.body);
+}
+function AiReviewPanel({ ai, onClose }) {
+  const { markdownSource, replaceAll } = useEditorContext();
+  const [phase, setPhase] = useState2("idle");
+  const [findings, setFindings] = useState2([]);
+  const [reviewedSource, setReviewedSource] = useState2(null);
+  const [resolvedIds, setResolvedIds] = useState2(() => /* @__PURE__ */ new Set());
+  const [error, setError] = useState2(null);
+  const [applyErrorId, setApplyErrorId] = useState2(null);
+  const handleRef = useRef(null);
+  const requestRef = useRef(0);
+  const startedRef = useRef(false);
+  const cancelReview = useCallback(() => {
+    requestRef.current += 1;
+    handleRef.current?.cancel();
+    handleRef.current = null;
+    setPhase("idle");
+  }, []);
+  const runReview = useCallback(() => {
+    if (!markdownSource.trim()) {
+      setFindings([]);
+      setReviewedSource(markdownSource);
+      setResolvedIds(/* @__PURE__ */ new Set());
+      setError(null);
+      setPhase("ready");
+      return;
+    }
+    if (markdownSource.length > AI_REVIEW_DOCUMENT_CHARACTERS) {
+      setError("This document is too long for one AI review pass. Review a shorter document.");
+      setPhase("error");
+      return;
+    }
+    handleRef.current?.cancel();
+    const requestId = ++requestRef.current;
+    const source = markdownSource;
+    setPhase("running");
+    setFindings([]);
+    setResolvedIds(/* @__PURE__ */ new Set());
+    setApplyErrorId(null);
+    setError(null);
+    const handle = ai.chat(buildReviewRequest(source), (event) => {
+      if (requestRef.current !== requestId || event.kind === "delta" || event.kind === "progress")
+        return;
+      handleRef.current = null;
+      if (event.kind === "error") {
+        setError(event.error.message);
+        setPhase("error");
+        return;
+      }
+      const parsed = parseAiReviewResponse(event.completion.text);
+      if (!parsed) {
+        setError("The AI returned a review DocBlocks could not read. Try reviewing again.");
+        setPhase("error");
+        return;
+      }
+      setFindings(parsed);
+      setReviewedSource(source);
+      setPhase("ready");
+    });
+    handleRef.current = handle;
+  }, [ai, markdownSource]);
+  useEffect2(() => {
+    if (startedRef.current) return;
+    startedRef.current = true;
+    runReview();
+  }, [runReview]);
+  useEffect2(
+    () => () => {
+      requestRef.current += 1;
+      handleRef.current?.cancel();
+      handleRef.current = null;
+      startedRef.current = false;
+    },
+    []
+  );
+  const applyFinding = useCallback(
+    (finding) => {
+      const next = applyAiReviewFinding(markdownSource, finding);
+      if (next === null) {
+        setApplyErrorId(finding.id);
+        return;
+      }
+      replaceAll(next);
+      setReviewedSource(next);
+      setApplyErrorId(null);
+      setResolvedIds((current) => /* @__PURE__ */ new Set([...current, finding.id]));
+    },
+    [markdownSource, replaceAll]
+  );
+  const dismissFinding = useCallback((id) => {
+    setApplyErrorId((current) => current === id ? null : current);
+    setResolvedIds((current) => /* @__PURE__ */ new Set([...current, id]));
+  }, []);
+  const visibleFindings = findings.filter((finding) => !resolvedIds.has(finding.id));
+  const documentChanged = reviewedSource !== null && markdownSource !== reviewedSource;
+  return /* @__PURE__ */ jsxs2("aside", { className: "db-ai-review-panel", "aria-label": "AI document review", children: [
+    /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-header", children: [
+      /* @__PURE__ */ jsxs2("div", { children: [
+        /* @__PURE__ */ jsx2("h2", { children: "AI review" }),
+        phase === "ready" && /* @__PURE__ */ jsxs2("span", { className: "db-ai-review-count", children: [
+          visibleFindings.length,
+          " ",
+          visibleFindings.length === 1 ? "finding" : "findings"
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx2(
+        "button",
+        {
+          type: "button",
+          className: "db-ai-review-close",
+          onClick: onClose,
+          "aria-label": "Close AI review",
+          children: "\xD7"
+        }
+      )
+    ] }),
+    /* @__PURE__ */ jsx2("div", { className: "db-ai-review-actions", children: phase === "running" ? /* @__PURE__ */ jsx2("button", { type: "button", onClick: cancelReview, children: "Stop review" }) : /* @__PURE__ */ jsx2("button", { type: "button", onClick: runReview, children: phase === "idle" ? "Review document" : "Review again" }) }),
+    phase === "running" && /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-empty", role: "status", children: [
+      /* @__PURE__ */ jsx2("span", { className: "db-ai-spinner", "aria-hidden": "true" }),
+      " Reviewing this document\u2026"
+    ] }),
+    phase === "error" && error && /* @__PURE__ */ jsx2("div", { className: "db-ai-review-empty db-ai-error", role: "alert", children: error }),
+    documentChanged && phase === "ready" && /* @__PURE__ */ jsx2("div", { className: "db-ai-review-stale", role: "status", children: "The document changed after this review. Suggestions are applied only when their original text still matches exactly." }),
+    phase === "ready" && visibleFindings.length === 0 && /* @__PURE__ */ jsx2("div", { className: "db-ai-review-empty", children: findings.length === 0 ? "Nothing to report." : "All findings have been handled." }),
+    /* @__PURE__ */ jsx2("ol", { className: "db-ai-review-list", children: visibleFindings.map((finding) => {
+      const canApply = finding.replacement !== null && findUniqueExcerpt(markdownSource, finding.originalText) !== null;
+      return /* @__PURE__ */ jsxs2("li", { className: "db-ai-review-finding", children: [
+        /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-finding-meta", children: [
+          /* @__PURE__ */ jsx2(
+            "span",
+            {
+              className: `db-ai-review-severity db-ai-review-severity--${finding.severity}`,
+              children: finding.severity
+            }
+          ),
+          /* @__PURE__ */ jsx2("span", { children: finding.category })
+        ] }),
+        /* @__PURE__ */ jsx2("h3", { children: finding.message }),
+        finding.rationale && /* @__PURE__ */ jsx2("p", { children: finding.rationale }),
+        /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-excerpt", children: [
+          /* @__PURE__ */ jsx2("span", { children: "Current text" }),
+          /* @__PURE__ */ jsx2("blockquote", { children: finding.originalText })
+        ] }),
+        finding.replacement !== null && /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-excerpt db-ai-review-excerpt--replacement", children: [
+          /* @__PURE__ */ jsx2("span", { children: "Suggested" }),
+          /* @__PURE__ */ jsx2("blockquote", { children: finding.replacement })
+        ] }),
+        applyErrorId === finding.id && /* @__PURE__ */ jsx2("p", { className: "db-ai-error", role: "alert", children: "This text no longer has one exact match. Review the document again before applying it." }),
+        /* @__PURE__ */ jsxs2("div", { className: "db-ai-review-finding-actions", children: [
+          /* @__PURE__ */ jsx2("button", { type: "button", onClick: () => dismissFinding(finding.id), children: "Dismiss" }),
+          finding.replacement !== null && /* @__PURE__ */ jsx2(
+            "button",
+            {
+              type: "button",
+              disabled: !canApply,
+              title: canApply ? void 0 : "The reviewed text no longer has one exact match",
+              onClick: () => applyFinding(finding),
+              children: "Apply"
+            }
+          )
+        ] })
+      ] }, finding.id);
+    }) }),
+    /* @__PURE__ */ jsx2("p", { className: "db-ai-review-disclaimer", children: "AI suggestions can be wrong. Review each change." })
+  ] });
+}
+function SparklesGlyph() {
+  return /* @__PURE__ */ jsxs2(
+    "svg",
+    {
+      viewBox: "0 0 18 18",
+      width: "18",
+      height: "18",
+      fill: "none",
+      stroke: "currentColor",
+      strokeWidth: "1.35",
+      strokeLinecap: "round",
+      strokeLinejoin: "round",
+      "aria-hidden": "true",
+      children: [
+        /* @__PURE__ */ jsx2("path", { d: "M7.2 2.2c.45 2.2 1.75 3.5 3.95 3.95-2.2.45-3.5 1.75-3.95 3.95-.45-2.2-1.75-3.5-3.95-3.95C5.45 5.7 6.75 4.4 7.2 2.2Z" }),
+        /* @__PURE__ */ jsx2("path", { d: "M13.1 9.2c.3 1.45 1.15 2.3 2.6 2.6-1.45.3-2.3 1.15-2.6 2.6-.3-1.45-1.15-2.3-2.6-2.6 1.45-.3 2.3-1.15 2.6-2.6Z" })
+      ]
+    }
+  );
+}
+export {
+  AiDraftDialog,
+  AiReviewPanel,
+  AiToolbarControl
+};