@burdenoff/microfe-planmagnet 2026.930.23 → 2026.930.25

package/dist/planmagnet/docs/DocSuggestionsPanel.js

@@ -0,0 +1,308 @@
+import { PersonName as e } from "../people/People.js";
+import { throwOnError as t } from "../utils/mutationResult.js";
+import { ConfirmButton as n, ErrorLine as r } from "../controls/ConfirmButton.js";
+import { isConflict as i, isForbidden as a, mutationErrorMessage as o } from "../utils/graphqlErrors.js";
+import { lineDiff as s } from "../utils/lineDiff.js";
+import { DocDiffHunks as c } from "./DocDiffView.js";
+import { useState as l } from "react";
+import { FileEdit as u, Undo2 as d } from "lucide-react";
+import { gql as f } from "@apollo/client";
+import { useMutation as p, useQuery as m } from "@apollo/client/react";
+import { Fragment as h, jsx as g, jsxs as _ } from "react/jsx-runtime";
+import { Button as v, Card as y, CardContent as b, CardHeader as x, CardTitle as S, Tabs as C, TabsContent as w, TabsList as T, TabsTrigger as E } from "@burdenoff/fe-libs/ui";
+//#region src/planmagnet/docs/DocSuggestionsPanel.tsx
+var D = 10, O = "DocSuggestionsPanel", k = f`
+  query DocSuggestionsPanel(
+    $docId: ID!
+    $status: PlanmagnetDocSuggestionStatus
+    $pagination: PlanmagnetPaginationInput
+  ) {
+    planmagnetDoc(id: $docId) {
+      id
+      suggestions(status: $status, pagination: $pagination) {
+        totalCount
+        pageInfo {
+          hasNextPage
+          endCursor
+        }
+        items {
+          id
+          authorId
+          baseVersion
+          proposedTitle
+          proposedContent
+          note
+          status
+          createdAt
+          decidedAt
+          decidedBy
+        }
+      }
+    }
+  }
+`, A = f`
+  mutation PlanmagnetDecideDocSuggestionDecide($id: ID!, $accept: Boolean!) {
+    planmagnetDecideDocSuggestion(id: $id, accept: $accept) {
+      id
+      status
+    }
+  }
+`, j = f`
+  mutation PlanmagnetWithdrawDocSuggestionWithdraw($id: ID!) {
+    planmagnetWithdrawDocSuggestion(id: $id) {
+      id
+      status
+    }
+  }
+`, M = (e) => new Date(e).toLocaleString();
+function N({ suggestion: u, docTitle: f, docContent: m, revisions: y, currentUserId: b }) {
+	let [x, S] = l(!1), [C, w] = l(null), [T, E] = p(A, {
+		refetchQueries: [O, "DocDetail"],
+		awaitRefetchQueries: !0
+	}), [D, k] = p(j, {
+		refetchQueries: [O],
+		awaitRefetchQueries: !0
+	}), N = y.find((e) => e.version === u.baseVersion), P = N?.content ?? m, F = N?.title ?? f, I = s(P, u.proposedContent), L = u.proposedTitle !== null && u.proposedTitle !== F, R = u.authorId === b, z = async (e, n) => {
+		w(null);
+		try {
+			await t(e());
+		} catch (e) {
+			w(a(e) ? "Your role cannot decide this suggestion." : i(e) ? "The doc changed since this was suggested." : o(e, n));
+		}
+	};
+	return /* @__PURE__ */ _("li", {
+		className: "space-y-2 rounded-md border border-border-default p-3",
+		"data-testid": "doc-suggestion",
+		children: [
+			/* @__PURE__ */ _("div", {
+				className: "flex flex-wrap items-start justify-between gap-2",
+				children: [/* @__PURE__ */ _("div", {
+					className: "min-w-0",
+					children: [
+						/* @__PURE__ */ _("p", {
+							className: "text-sm",
+							children: [
+								/* @__PURE__ */ g("span", {
+									className: "font-medium",
+									children: /* @__PURE__ */ g(e, { id: u.authorId })
+								}),
+								" ",
+								"proposed ",
+								M(u.createdAt),
+								" against version ",
+								u.baseVersion
+							]
+						}),
+						u.note && /* @__PURE__ */ g("p", {
+							className: "mt-0.5 text-xs text-muted-foreground",
+							children: u.note
+						}),
+						u.status !== "OPEN" && /* @__PURE__ */ _("p", {
+							className: "mt-0.5 text-xs text-muted-foreground",
+							children: [
+								u.status === "ACCEPTED" ? "Accepted" : "Rejected",
+								u.decidedBy ? /* @__PURE__ */ _(h, { children: [
+									" ",
+									"by ",
+									/* @__PURE__ */ g(e, { id: u.decidedBy })
+								] }) : null,
+								u.decidedAt ? ` · ${M(u.decidedAt)}` : ""
+							]
+						})
+					]
+				}), /* @__PURE__ */ g(v, {
+					size: "sm",
+					variant: "ghost",
+					className: "h-7 shrink-0 text-xs",
+					onClick: () => S((e) => !e),
+					"aria-expanded": x,
+					children: x ? "Hide diff" : "Show diff"
+				})]
+			}),
+			C && /* @__PURE__ */ g(r, { message: C }),
+			x && /* @__PURE__ */ _("div", {
+				className: "space-y-1",
+				children: [L && /* @__PURE__ */ _("p", {
+					className: "text-xs text-muted-foreground",
+					children: [
+						"Title: ",
+						/* @__PURE__ */ g("span", {
+							className: "line-through",
+							children: F
+						}),
+						" →",
+						" ",
+						/* @__PURE__ */ g("span", {
+							className: "font-medium text-foreground",
+							children: u.proposedTitle
+						})
+					]
+				}), /* @__PURE__ */ g(c, {
+					hunks: I.hunks,
+					truncated: I.truncated,
+					emptyMessage: "No content differences.",
+					testId: `doc-suggestion-diff-${u.id}`
+				})]
+			}),
+			u.status === "OPEN" && /* @__PURE__ */ _("div", {
+				className: "flex flex-wrap justify-end gap-2 border-t border-border-default pt-2",
+				children: [
+					R && /* @__PURE__ */ g(n, {
+						label: "Withdraw",
+						icon: /* @__PURE__ */ g(d, {
+							className: "h-3.5 w-3.5",
+							"aria-hidden": "true"
+						}),
+						title: "Withdraw this suggestion?",
+						description: "It moves to Withdrawn and can no longer be accepted or rejected.",
+						confirmLabel: "Withdraw",
+						variant: "outline",
+						disabled: k.loading,
+						onConfirm: () => void z(() => D({ variables: { id: u.id } }), "The suggestion could not be withdrawn."),
+						testId: "doc-suggestion-withdraw"
+					}),
+					/* @__PURE__ */ g(v, {
+						size: "sm",
+						variant: "outline",
+						disabled: E.loading,
+						"data-testid": "doc-suggestion-reject",
+						onClick: () => void z(() => T({ variables: {
+							id: u.id,
+							accept: !1
+						} }), "The suggestion could not be rejected."),
+						children: "Reject"
+					}),
+					/* @__PURE__ */ g(v, {
+						size: "sm",
+						disabled: E.loading,
+						"data-testid": "doc-suggestion-accept",
+						onClick: () => void z(() => T({ variables: {
+							id: u.id,
+							accept: !0
+						} }), "The suggestion could not be accepted."),
+						children: "Accept"
+					})
+				]
+			})
+		]
+	});
+}
+function P({ docId: e, status: t, docTitle: n, docContent: i, revisions: o, currentUserId: s }) {
+	let [c, u] = l(!1), { data: d, loading: f, error: p, fetchMore: h } = m(k, {
+		variables: {
+			docId: e,
+			status: t,
+			pagination: { first: D }
+		},
+		skip: !e
+	}), y = d?.planmagnetDoc?.suggestions, b = y?.items ?? [], x = async () => {
+		let n = y?.pageInfo.endCursor;
+		if (n) {
+			u(!0);
+			try {
+				await h({
+					variables: {
+						docId: e,
+						status: t,
+						pagination: {
+							first: D,
+							after: n
+						}
+					},
+					updateQuery: (e, { fetchMoreResult: t }) => !e.planmagnetDoc || !t.planmagnetDoc ? e : { planmagnetDoc: {
+						...t.planmagnetDoc,
+						suggestions: {
+							...t.planmagnetDoc.suggestions,
+							items: [...e.planmagnetDoc.suggestions.items, ...t.planmagnetDoc.suggestions.items]
+						}
+					} }
+				});
+			} finally {
+				u(!1);
+			}
+		}
+	};
+	return /* @__PURE__ */ _("div", {
+		className: "space-y-2",
+		children: [
+			f && !d && /* @__PURE__ */ g("p", {
+				className: "text-sm text-muted-foreground",
+				children: "Loading…"
+			}),
+			p && /* @__PURE__ */ g(r, { message: a(p) ? "Your role cannot see this doc’s suggestions." : `Suggestions could not be loaded: ${p.message}` }),
+			y && b.length === 0 && /* @__PURE__ */ g("p", {
+				className: "text-sm text-muted-foreground",
+				children: t === "OPEN" ? "No open suggestions." : t === "ACCEPTED" ? "None accepted yet." : "None rejected yet."
+			}),
+			/* @__PURE__ */ g("ul", {
+				className: "space-y-2",
+				children: b.map((e) => /* @__PURE__ */ g(N, {
+					suggestion: e,
+					docTitle: n,
+					docContent: i,
+					revisions: o,
+					currentUserId: s
+				}, e.id))
+			}),
+			y?.pageInfo.hasNextPage && /* @__PURE__ */ g(v, {
+				size: "sm",
+				variant: "outline",
+				onClick: () => void x(),
+				disabled: c,
+				children: c ? "Loading…" : `Show more (${b.length} of ${y.totalCount})`
+			})
+		]
+	});
+}
+function F({ docId: e, docTitle: t, docContent: n, revisions: r, currentUserId: i }) {
+	let [a, o] = l("OPEN");
+	return /* @__PURE__ */ _(y, {
+		"data-testid": "doc-suggestions",
+		children: [/* @__PURE__ */ g(x, { children: /* @__PURE__ */ _(S, {
+			className: "flex items-center gap-2",
+			children: [/* @__PURE__ */ g(u, {
+				className: "h-4 w-4",
+				"aria-hidden": "true"
+			}), "Suggestions"]
+		}) }), /* @__PURE__ */ g(b, { children: /* @__PURE__ */ _(C, {
+			value: a,
+			onValueChange: (e) => o(e),
+			children: [/* @__PURE__ */ _(T, { children: [
+				/* @__PURE__ */ g(E, {
+					value: "OPEN",
+					"data-testid": "doc-suggestions-tab-open",
+					children: "Open"
+				}),
+				/* @__PURE__ */ g(E, {
+					value: "ACCEPTED",
+					"data-testid": "doc-suggestions-tab-accepted",
+					children: "Accepted"
+				}),
+				/* @__PURE__ */ g(E, {
+					value: "REJECTED",
+					"data-testid": "doc-suggestions-tab-rejected",
+					children: "Rejected"
+				})
+			] }), [
+				"OPEN",
+				"ACCEPTED",
+				"REJECTED"
+			].map((a) => /* @__PURE__ */ g(w, {
+				value: a,
+				className: "mt-3",
+				children: /* @__PURE__ */ g(P, {
+					docId: e,
+					status: a,
+					docTitle: t,
+					docContent: n,
+					revisions: r,
+					currentUserId: i
+				})
+			}, a))]
+		}) })]
+	});
+}
+//#endregion
+export { F as DocSuggestionsPanel };
+
+//# sourceMappingURL=DocSuggestionsPanel.js.map

package/dist/planmagnet/docs/DocSuggestionsPanel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocSuggestionsPanel.js","names":[],"sources":["../../../src/planmagnet/docs/DocSuggestionsPanel.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { gql } from '@apollo/client';\nimport { useMutation, useQuery } from '@apollo/client/react';\nimport {\n  Button,\n  Card,\n  CardContent,\n  CardHeader,\n  CardTitle,\n  Tabs,\n  TabsContent,\n  TabsList,\n  TabsTrigger,\n} from '@burdenoff/fe-libs/ui';\nimport { FileEdit, Undo2 } from 'lucide-react';\nimport { PersonName } from '../people/People';\nimport { ConfirmButton, ErrorLine } from '../controls/ConfirmButton';\nimport { throwOnError } from '../utils/mutationResult';\nimport { isConflict, isForbidden, mutationErrorMessage } from '../utils/graphqlErrors';\nimport { lineDiff } from '../utils/lineDiff';\nimport { DocDiffHunks } from './DocDiffView';\n\n/**\n * Proposed edits against a doc (CWF-18 §2) that have not been applied: Open / Accepted / Rejected, each its own\n * tab and its own (paginated) `planmagnetDoc.suggestions(status: …)` read — Withdrawn ones are never shown here,\n * matching the three tabs this panel was scoped to (a withdrawn suggestion is, by design, gone from view — its\n * author already said it no longer applies).\n *\n * The diff preview is computed HERE, client-side (`lineDiff`): `planmagnetDocRevisionDiff` only compares two\n * already-saved revisions, and a suggestion's `proposedContent` was never saved as one — so the base side comes\n * from whichever loaded `PlanmagnetDocRevision` matches `baseVersion` (falling back to the live doc when the\n * suggestion is against the CURRENT version, which has no revision row of its own yet).\n *\n * Accept/Reject are shown to every viewer (the resolver is the real gate, same \"show it, let the server refuse\n * it\" house rule as every other write-tier control in this MFE) except Withdraw, which IS client-gated to the\n * suggestion's own author — `planmagnetWithdrawDocSuggestion`'s own schema doc says it is author-only, refused\n * NOT_FOUND (not FORBIDDEN) for anyone else, so showing it to a non-author would just be a button that always\n * fails.\n */\n\nconst PAGE = 10;\nconst SUGGESTION_QUERY_NAME = 'DocSuggestionsPanel';\n\nconst DOC_SUGGESTIONS = gql`\n  query DocSuggestionsPanel(\n    $docId: ID!\n    $status: PlanmagnetDocSuggestionStatus\n    $pagination: PlanmagnetPaginationInput\n  ) {\n    planmagnetDoc(id: $docId) {\n      id\n      suggestions(status: $status, pagination: $pagination) {\n        totalCount\n        pageInfo {\n          hasNextPage\n          endCursor\n        }\n        items {\n          id\n          authorId\n          baseVersion\n          proposedTitle\n          proposedContent\n          note\n          status\n          createdAt\n          decidedAt\n          decidedBy\n        }\n      }\n    }\n  }\n`;\n\nconst DECIDE = gql`\n  mutation PlanmagnetDecideDocSuggestionDecide($id: ID!, $accept: Boolean!) {\n    planmagnetDecideDocSuggestion(id: $id, accept: $accept) {\n      id\n      status\n    }\n  }\n`;\n\nconst WITHDRAW = gql`\n  mutation PlanmagnetWithdrawDocSuggestionWithdraw($id: ID!) {\n    planmagnetWithdrawDocSuggestion(id: $id) {\n      id\n      status\n    }\n  }\n`;\n\ntype SuggestionStatus = 'OPEN' | 'ACCEPTED' | 'REJECTED';\n\ninterface Suggestion {\n  id: string;\n  authorId: string;\n  baseVersion: number;\n  proposedTitle: string | null;\n  proposedContent: string;\n  note: string | null;\n  status: 'OPEN' | 'ACCEPTED' | 'REJECTED' | 'WITHDRAWN';\n  createdAt: string;\n  decidedAt: string | null;\n  decidedBy: string | null;\n}\n\nexport interface DocRevisionForDiff {\n  version: number;\n  title: string;\n  content: string;\n}\n\nconst when = (iso: string) => new Date(iso).toLocaleString();\n\nfunction SuggestionRow({\n  suggestion,\n  docTitle,\n  docContent,\n  revisions,\n  currentUserId,\n}: {\n  suggestion: Suggestion;\n  docTitle: string;\n  docContent: string;\n  revisions: readonly DocRevisionForDiff[];\n  currentUserId: string | undefined;\n}) {\n  const [showDiff, setShowDiff] = useState(false);\n  const [error, setError] = useState<string | null>(null);\n  const decideRefetch = {\n    refetchQueries: [SUGGESTION_QUERY_NAME, 'DocDetail'],\n    awaitRefetchQueries: true,\n  };\n  const [decide, decideState] = useMutation(DECIDE, decideRefetch);\n  const [withdraw, withdrawState] = useMutation(WITHDRAW, {\n    refetchQueries: [SUGGESTION_QUERY_NAME],\n    awaitRefetchQueries: true,\n  });\n\n  // The suggestion's base version: a saved revision when the doc has moved on since, otherwise the live doc\n  // itself (a suggestion against the CURRENT version has no PlanmagnetDocRevision row yet — only a save creates\n  // one).\n  const baseRevision = revisions.find((r) => r.version === suggestion.baseVersion);\n  const baseContent = baseRevision?.content ?? docContent;\n  const baseTitle = baseRevision?.title ?? docTitle;\n  const diff = lineDiff(baseContent, suggestion.proposedContent);\n  const titleChanged = suggestion.proposedTitle !== null && suggestion.proposedTitle !== baseTitle;\n  const mine = suggestion.authorId === currentUserId;\n\n  const act = async (action: () => Promise<{ error?: unknown }>, fallback: string) => {\n    setError(null);\n    try {\n      await throwOnError(action());\n    } catch (e) {\n      setError(\n        isForbidden(e)\n          ? 'Your role cannot decide this suggestion.'\n          : isConflict(e)\n            ? 'The doc changed since this was suggested.'\n            : mutationErrorMessage(e, fallback)\n      );\n    }\n  };\n\n  return (\n    <li\n      className=\"space-y-2 rounded-md border border-border-default p-3\"\n      data-testid=\"doc-suggestion\"\n    >\n      <div className=\"flex flex-wrap items-start justify-between gap-2\">\n        <div className=\"min-w-0\">\n          <p className=\"text-sm\">\n            <span className=\"font-medium\">\n              <PersonName id={suggestion.authorId} />\n            </span>{' '}\n            proposed {when(suggestion.createdAt)} against version {suggestion.baseVersion}\n          </p>\n          {suggestion.note && (\n            <p className=\"mt-0.5 text-xs text-muted-foreground\">{suggestion.note}</p>\n          )}\n          {suggestion.status !== 'OPEN' && (\n            <p className=\"mt-0.5 text-xs text-muted-foreground\">\n              {suggestion.status === 'ACCEPTED' ? 'Accepted' : 'Rejected'}\n              {suggestion.decidedBy ? (\n                <>\n                  {' '}\n                  by <PersonName id={suggestion.decidedBy} />\n                </>\n              ) : null}\n              {suggestion.decidedAt ? ` · ${when(suggestion.decidedAt)}` : ''}\n            </p>\n          )}\n        </div>\n        <Button\n          size=\"sm\"\n          variant=\"ghost\"\n          className=\"h-7 shrink-0 text-xs\"\n          onClick={() => setShowDiff((v) => !v)}\n          aria-expanded={showDiff}\n        >\n          {showDiff ? 'Hide diff' : 'Show diff'}\n        </Button>\n      </div>\n      {error && <ErrorLine message={error} />}\n      {showDiff && (\n        <div className=\"space-y-1\">\n          {titleChanged && (\n            <p className=\"text-xs text-muted-foreground\">\n              Title: <span className=\"line-through\">{baseTitle}</span> →{' '}\n              <span className=\"font-medium text-foreground\">{suggestion.proposedTitle}</span>\n            </p>\n          )}\n          <DocDiffHunks\n            hunks={diff.hunks}\n            truncated={diff.truncated}\n            emptyMessage=\"No content differences.\"\n            testId={`doc-suggestion-diff-${suggestion.id}`}\n          />\n        </div>\n      )}\n      {suggestion.status === 'OPEN' && (\n        <div className=\"flex flex-wrap justify-end gap-2 border-t border-border-default pt-2\">\n          {mine && (\n            <ConfirmButton\n              label=\"Withdraw\"\n              icon={<Undo2 className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />}\n              title=\"Withdraw this suggestion?\"\n              description=\"It moves to Withdrawn and can no longer be accepted or rejected.\"\n              confirmLabel=\"Withdraw\"\n              variant=\"outline\"\n              disabled={withdrawState.loading}\n              onConfirm={() =>\n                void act(\n                  () => withdraw({ variables: { id: suggestion.id } }),\n                  'The suggestion could not be withdrawn.'\n                )\n              }\n              testId=\"doc-suggestion-withdraw\"\n            />\n          )}\n          <Button\n            size=\"sm\"\n            variant=\"outline\"\n            disabled={decideState.loading}\n            data-testid=\"doc-suggestion-reject\"\n            onClick={() =>\n              void act(\n                () => decide({ variables: { id: suggestion.id, accept: false } }),\n                'The suggestion could not be rejected.'\n              )\n            }\n          >\n            Reject\n          </Button>\n          <Button\n            size=\"sm\"\n            disabled={decideState.loading}\n            data-testid=\"doc-suggestion-accept\"\n            onClick={() =>\n              void act(\n                () => decide({ variables: { id: suggestion.id, accept: true } }),\n                'The suggestion could not be accepted.'\n              )\n            }\n          >\n            Accept\n          </Button>\n        </div>\n      )}\n    </li>\n  );\n}\n\nfunction SuggestionList({\n  docId,\n  status,\n  docTitle,\n  docContent,\n  revisions,\n  currentUserId,\n}: {\n  docId: string;\n  status: SuggestionStatus;\n  docTitle: string;\n  docContent: string;\n  revisions: readonly DocRevisionForDiff[];\n  currentUserId: string | undefined;\n}) {\n  const [loadingMore, setLoadingMore] = useState(false);\n  const { data, loading, error, fetchMore } = useQuery<{\n    planmagnetDoc: {\n      id: string;\n      suggestions: {\n        totalCount: number;\n        pageInfo: { hasNextPage: boolean; endCursor: string | null };\n        items: Suggestion[];\n      };\n    } | null;\n  }>(DOC_SUGGESTIONS, {\n    variables: { docId, status, pagination: { first: PAGE } },\n    skip: !docId,\n  });\n\n  const list = data?.planmagnetDoc?.suggestions;\n  const items = list?.items ?? [];\n\n  const loadMore = async () => {\n    const after = list?.pageInfo.endCursor;\n    if (!after) return;\n    setLoadingMore(true);\n    try {\n      await fetchMore({\n        variables: { docId, status, pagination: { first: PAGE, after } },\n        updateQuery: (prev, { fetchMoreResult }) => {\n          if (!prev.planmagnetDoc || !fetchMoreResult.planmagnetDoc) return prev;\n          return {\n            planmagnetDoc: {\n              ...fetchMoreResult.planmagnetDoc,\n              suggestions: {\n                ...fetchMoreResult.planmagnetDoc.suggestions,\n                items: [\n                  ...prev.planmagnetDoc.suggestions.items,\n                  ...fetchMoreResult.planmagnetDoc.suggestions.items,\n                ],\n              },\n            },\n          };\n        },\n      });\n    } finally {\n      setLoadingMore(false);\n    }\n  };\n\n  return (\n    <div className=\"space-y-2\">\n      {loading && !data && <p className=\"text-sm text-muted-foreground\">Loading…</p>}\n      {error && (\n        <ErrorLine\n          message={\n            isForbidden(error)\n              ? 'Your role cannot see this doc’s suggestions.'\n              : `Suggestions could not be loaded: ${error.message}`\n          }\n        />\n      )}\n      {list && items.length === 0 && (\n        <p className=\"text-sm text-muted-foreground\">\n          {status === 'OPEN'\n            ? 'No open suggestions.'\n            : status === 'ACCEPTED'\n              ? 'None accepted yet.'\n              : 'None rejected yet.'}\n        </p>\n      )}\n      <ul className=\"space-y-2\">\n        {items.map((s) => (\n          <SuggestionRow\n            key={s.id}\n            suggestion={s}\n            docTitle={docTitle}\n            docContent={docContent}\n            revisions={revisions}\n            currentUserId={currentUserId}\n          />\n        ))}\n      </ul>\n      {list?.pageInfo.hasNextPage && (\n        <Button size=\"sm\" variant=\"outline\" onClick={() => void loadMore()} disabled={loadingMore}>\n          {loadingMore ? 'Loading…' : `Show more (${items.length} of ${list.totalCount})`}\n        </Button>\n      )}\n    </div>\n  );\n}\n\nexport function DocSuggestionsPanel({\n  docId,\n  docTitle,\n  docContent,\n  revisions,\n  currentUserId,\n}: {\n  docId: string;\n  docTitle: string;\n  docContent: string;\n  revisions: readonly DocRevisionForDiff[];\n  currentUserId: string | undefined;\n}) {\n  const [tab, setTab] = useState<SuggestionStatus>('OPEN');\n  return (\n    <Card data-testid=\"doc-suggestions\">\n      <CardHeader>\n        <CardTitle className=\"flex items-center gap-2\">\n          <FileEdit className=\"h-4 w-4\" aria-hidden=\"true\" />\n          Suggestions\n        </CardTitle>\n      </CardHeader>\n      <CardContent>\n        <Tabs value={tab} onValueChange={(v) => setTab(v as SuggestionStatus)}>\n          <TabsList>\n            <TabsTrigger value=\"OPEN\" data-testid=\"doc-suggestions-tab-open\">\n              Open\n            </TabsTrigger>\n            <TabsTrigger value=\"ACCEPTED\" data-testid=\"doc-suggestions-tab-accepted\">\n              Accepted\n            </TabsTrigger>\n            <TabsTrigger value=\"REJECTED\" data-testid=\"doc-suggestions-tab-rejected\">\n              Rejected\n            </TabsTrigger>\n          </TabsList>\n          {(['OPEN', 'ACCEPTED', 'REJECTED'] as const).map((status) => (\n            <TabsContent key={status} value={status} className=\"mt-3\">\n              <SuggestionList\n                docId={docId}\n                status={status}\n                docTitle={docTitle}\n                docContent={docContent}\n                revisions={revisions}\n                currentUserId={currentUserId}\n              />\n            </TabsContent>\n          ))}\n        </Tabs>\n      </CardContent>\n    </Card>\n  );\n}\n"],"mappings":"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"}

package/dist/planmagnet/docs/DocVersionCompare.d.ts

@@ -0,0 +1,7 @@
+export declare function DocVersionCompare({ docId, versions, }: {
+    docId: string;
+    versions: readonly {
+        version: number;
+    }[];
+}): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=DocVersionCompare.d.ts.map

package/dist/planmagnet/docs/DocVersionCompare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocVersionCompare.d.ts","sourceRoot":"","sources":["../../../src/planmagnet/docs/DocVersionCompare.tsx"],"names":[],"mappings":"AAwCA,wBAAgB,iBAAiB,CAAC,EAChC,KAAK,EACL,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,SAAS;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C,2CAwGA"}

package/dist/planmagnet/docs/DocVersionCompare.js

@@ -0,0 +1,105 @@
+import { ErrorLine as e } from "../controls/ConfirmButton.js";
+import { isForbidden as t } from "../utils/graphqlErrors.js";
+import { DocDiffHunks as n } from "./DocDiffView.js";
+import { useState as r } from "react";
+import { GitCompare as i } from "lucide-react";
+import { gql as a } from "@apollo/client";
+import { useLazyQuery as o } from "@apollo/client/react";
+import { Fragment as s, jsx as c, jsxs as l } from "react/jsx-runtime";
+import { Button as u } from "@burdenoff/fe-libs/ui";
+//#region src/planmagnet/docs/DocVersionCompare.tsx
+var d = a`
+  query PlanmagnetDocRevisionDiffPanel($docId: ID!, $fromVersion: Int!, $toVersion: Int) {
+    planmagnetDocRevisionDiff(docId: $docId, fromVersion: $fromVersion, toVersion: $toVersion) {
+      docId
+      fromVersion
+      toVersion
+      truncated
+      hunks {
+        kind
+        text
+      }
+    }
+  }
+`;
+function f({ docId: a, versions: f }) {
+	let p = [...f].sort((e, t) => t.version - e.version), [m, h] = r(""), [g, _] = r(""), [v, y] = o(d), b = () => {
+		m && v({ variables: {
+			docId: a,
+			fromVersion: Number(m),
+			toVersion: g ? Number(g) : void 0
+		} });
+	}, x = y.data?.planmagnetDocRevisionDiff ?? null;
+	return /* @__PURE__ */ l("div", {
+		className: "space-y-3 border-t border-border-default pt-3",
+		"data-testid": "doc-version-compare",
+		children: [/* @__PURE__ */ l("p", {
+			className: "flex items-center gap-1 text-xs font-medium text-muted-foreground",
+			children: [/* @__PURE__ */ c(i, {
+				className: "h-3.5 w-3.5",
+				"aria-hidden": "true"
+			}), "Compare versions"]
+		}), p.length < 2 ? /* @__PURE__ */ c("p", {
+			className: "text-xs text-muted-foreground",
+			children: "Needs at least two versions to compare."
+		}) : /* @__PURE__ */ l(s, { children: [
+			/* @__PURE__ */ l("div", {
+				className: "grid grid-cols-2 gap-2",
+				children: [/* @__PURE__ */ l("div", { children: [/* @__PURE__ */ c("label", {
+					htmlFor: "doc-diff-from",
+					className: "text-xs font-medium",
+					children: "From"
+				}), /* @__PURE__ */ l("select", {
+					id: "doc-diff-from",
+					className: "mt-1 w-full rounded-md border border-input bg-background px-2 py-1.5 text-sm",
+					value: m,
+					onChange: (e) => {
+						let t = e.target.value;
+						h(t), _((e) => e === t ? "" : e);
+					},
+					children: [/* @__PURE__ */ c("option", {
+						value: "",
+						children: "Select a version"
+					}), p.map((e) => /* @__PURE__ */ l("option", {
+						value: e.version,
+						children: ["Version ", e.version]
+					}, e.version))]
+				})] }), /* @__PURE__ */ l("div", { children: [/* @__PURE__ */ c("label", {
+					htmlFor: "doc-diff-to",
+					className: "text-xs font-medium",
+					children: "To"
+				}), /* @__PURE__ */ l("select", {
+					id: "doc-diff-to",
+					className: "mt-1 w-full rounded-md border border-input bg-background px-2 py-1.5 text-sm",
+					value: g,
+					onChange: (e) => _(e.target.value),
+					children: [/* @__PURE__ */ c("option", {
+						value: "",
+						children: "Current"
+					}), p.filter((e) => String(e.version) !== m).map((e) => /* @__PURE__ */ l("option", {
+						value: e.version,
+						children: ["Version ", e.version]
+					}, e.version))]
+				})] })]
+			}),
+			/* @__PURE__ */ c(u, {
+				size: "sm",
+				variant: "outline",
+				onClick: b,
+				disabled: !m || y.loading,
+				"data-testid": "doc-version-compare-run",
+				children: y.loading ? "Comparing…" : "Compare"
+			}),
+			y.error && /* @__PURE__ */ c(e, { message: t(y.error) ? "Your role cannot compare versions of this doc." : `The comparison could not be loaded: ${y.error.message}` }),
+			x && /* @__PURE__ */ c(n, {
+				hunks: x.hunks,
+				truncated: x.truncated,
+				testId: "doc-version-diff"
+			})
+		] })]
+	});
+}
+//#endregion
+export { f as DocVersionCompare };
+
+//# sourceMappingURL=DocVersionCompare.js.map

package/dist/planmagnet/docs/DocVersionCompare.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DocVersionCompare.js","names":[],"sources":["../../../src/planmagnet/docs/DocVersionCompare.tsx"],"sourcesContent":["import { useState } from 'react';\nimport { gql } from '@apollo/client';\nimport { useLazyQuery } from '@apollo/client/react';\nimport { Button } from '@burdenoff/fe-libs/ui';\nimport { GitCompare } from 'lucide-react';\nimport { ErrorLine } from '../controls/ConfirmButton';\nimport { isForbidden } from '../utils/graphqlErrors';\nimport { DocDiffHunks, type DocDiffHunkLike } from './DocDiffView';\n\n/**\n * Version compare in the doc's history panel (CWF-18 §3): pick two SAVED versions and diff them through the\n * server's `planmagnetDocRevisionDiff` (line-based, bounded, same hunk shape `DocDiffHunks` already renders for\n * a suggestion preview). \"To\" left as \"Current\" diffs against the doc's live version, matching the query's own\n * \"omit toVersion = against current\" contract.\n */\n\nconst DOC_REVISION_DIFF = gql`\n  query PlanmagnetDocRevisionDiffPanel($docId: ID!, $fromVersion: Int!, $toVersion: Int) {\n    planmagnetDocRevisionDiff(docId: $docId, fromVersion: $fromVersion, toVersion: $toVersion) {\n      docId\n      fromVersion\n      toVersion\n      truncated\n      hunks {\n        kind\n        text\n      }\n    }\n  }\n`;\n\ninterface RevisionDiffData {\n  planmagnetDocRevisionDiff: {\n    fromVersion: number;\n    toVersion: number;\n    truncated: boolean;\n    hunks: DocDiffHunkLike[];\n  };\n}\n\nexport function DocVersionCompare({\n  docId,\n  versions,\n}: {\n  docId: string;\n  versions: readonly { version: number }[];\n}) {\n  const sorted = [...versions].sort((a, b) => b.version - a.version);\n  const [fromVersion, setFromVersion] = useState('');\n  const [toVersion, setToVersion] = useState('');\n  const [runDiff, diffState] = useLazyQuery<RevisionDiffData>(DOC_REVISION_DIFF);\n\n  const compare = () => {\n    if (!fromVersion) return;\n    void runDiff({\n      variables: {\n        docId,\n        fromVersion: Number(fromVersion),\n        toVersion: toVersion ? Number(toVersion) : undefined,\n      },\n    });\n  };\n\n  const diff = diffState.data?.planmagnetDocRevisionDiff ?? null;\n\n  return (\n    <div\n      className=\"space-y-3 border-t border-border-default pt-3\"\n      data-testid=\"doc-version-compare\"\n    >\n      <p className=\"flex items-center gap-1 text-xs font-medium text-muted-foreground\">\n        <GitCompare className=\"h-3.5 w-3.5\" aria-hidden=\"true\" />\n        Compare versions\n      </p>\n      {sorted.length < 2 ? (\n        <p className=\"text-xs text-muted-foreground\">Needs at least two versions to compare.</p>\n      ) : (\n        <>\n          <div className=\"grid grid-cols-2 gap-2\">\n            <div>\n              <label htmlFor=\"doc-diff-from\" className=\"text-xs font-medium\">\n                From\n              </label>\n              <select\n                id=\"doc-diff-from\"\n                className=\"mt-1 w-full rounded-md border border-input bg-background px-2 py-1.5 text-sm\"\n                value={fromVersion}\n                onChange={(e) => {\n                  const next = e.target.value;\n                  setFromVersion(next);\n                  // Same \"To\" cannot equal \"From\" rule RoadmapVersionsPanel's compare section uses: picking a\n                  // version as \"From\" that is already selected as \"To\" silently falls the visible \"To\" back to\n                  // \"Current\" — reset the state to match what a Compare click would actually send.\n                  setToVersion((prevTo) => (prevTo === next ? '' : prevTo));\n                }}\n              >\n                <option value=\"\">Select a version</option>\n                {sorted.map((v) => (\n                  <option key={v.version} value={v.version}>\n                    Version {v.version}\n                  </option>\n                ))}\n              </select>\n            </div>\n            <div>\n              <label htmlFor=\"doc-diff-to\" className=\"text-xs font-medium\">\n                To\n              </label>\n              <select\n                id=\"doc-diff-to\"\n                className=\"mt-1 w-full rounded-md border border-input bg-background px-2 py-1.5 text-sm\"\n                value={toVersion}\n                onChange={(e) => setToVersion(e.target.value)}\n              >\n                <option value=\"\">Current</option>\n                {sorted\n                  .filter((v) => String(v.version) !== fromVersion)\n                  .map((v) => (\n                    <option key={v.version} value={v.version}>\n                      Version {v.version}\n                    </option>\n                  ))}\n              </select>\n            </div>\n          </div>\n          <Button\n            size=\"sm\"\n            variant=\"outline\"\n            onClick={compare}\n            disabled={!fromVersion || diffState.loading}\n            data-testid=\"doc-version-compare-run\"\n          >\n            {diffState.loading ? 'Comparing…' : 'Compare'}\n          </Button>\n          {diffState.error && (\n            <ErrorLine\n              message={\n                isForbidden(diffState.error)\n                  ? 'Your role cannot compare versions of this doc.'\n                  : `The comparison could not be loaded: ${diffState.error.message}`\n              }\n            />\n          )}\n          {diff && (\n            <DocDiffHunks hunks={diff.hunks} truncated={diff.truncated} testId=\"doc-version-diff\" />\n          )}\n        </>\n      )}\n    </div>\n  );\n}\n"],"mappings":";;;;;;;;;;AAgBA,IAAM,IAAoB,CAAG;;;;;;;;;;;;;;AAwB7B,SAAgB,EAAkB,EAChC,UACA,eAIC;CACD,IAAM,IAAS,CAAC,GAAG,EAAS,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,QAAQ,EAC5D,CAAC,GAAa,KAAkB,EAAS,GAAG,EAC5C,CAAC,GAAW,KAAgB,EAAS,GAAG,EACxC,CAAC,GAAS,KAAa,EAA+B,EAAkB,EAExE,UAAgB;AACf,OACA,EAAQ,EACX,WAAW;GACT;GACA,aAAa,OAAO,EAAY;GAChC,WAAW,IAAY,OAAO,EAAU,GAAG,KAAA;GAC5C,EACF,CAAC;IAGE,IAAO,EAAU,MAAM,6BAA6B;AAE1D,QACE,kBAAC,OAAD;EACE,WAAU;EACV,eAAY;YAFd,CAIE,kBAAC,KAAD;GAAG,WAAU;aAAb,CACE,kBAAC,GAAD;IAAY,WAAU;IAAc,eAAY;IAAS,CAAA,EAAA,mBAEvD;MACH,EAAO,SAAS,IACf,kBAAC,KAAD;GAAG,WAAU;aAAgC;GAA2C,CAAA,GAExF,kBAAA,GAAA,EAAA,UAAA;GACE,kBAAC,OAAD;IAAK,WAAU;cAAf,CACE,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,SAAD;KAAO,SAAQ;KAAgB,WAAU;eAAsB;KAEvD,CAAA,EACR,kBAAC,UAAD;KACE,IAAG;KACH,WAAU;KACV,OAAO;KACP,WAAW,MAAM;MACf,IAAM,IAAO,EAAE,OAAO;AAKtB,MAJA,EAAe,EAAK,EAIpB,GAAc,MAAY,MAAW,IAAO,KAAK,EAAQ;;eAV7D,CAaE,kBAAC,UAAD;MAAQ,OAAM;gBAAG;MAAyB,CAAA,EACzC,EAAO,KAAK,MACX,kBAAC,UAAD;MAAwB,OAAO,EAAE;gBAAjC,CAA0C,YAC/B,EAAE,QACJ;QAFI,EAAE,QAEN,CACT,CACK;OACL,EAAA,CAAA,EACN,kBAAC,OAAD,EAAA,UAAA,CACE,kBAAC,SAAD;KAAO,SAAQ;KAAc,WAAU;eAAsB;KAErD,CAAA,EACR,kBAAC,UAAD;KACE,IAAG;KACH,WAAU;KACV,OAAO;KACP,WAAW,MAAM,EAAa,EAAE,OAAO,MAAM;eAJ/C,CAME,kBAAC,UAAD;MAAQ,OAAM;gBAAG;MAAgB,CAAA,EAChC,EACE,QAAQ,MAAM,OAAO,EAAE,QAAQ,KAAK,EAAY,CAChD,KAAK,MACJ,kBAAC,UAAD;MAAwB,OAAO,EAAE;gBAAjC,CAA0C,YAC/B,EAAE,QACJ;QAFI,EAAE,QAEN,CACT,CACG;OACL,EAAA,CAAA,CACF;;GACN,kBAAC,GAAD;IACE,MAAK;IACL,SAAQ;IACR,SAAS;IACT,UAAU,CAAC,KAAe,EAAU;IACpC,eAAY;cAEX,EAAU,UAAU,eAAe;IAC7B,CAAA;GACR,EAAU,SACT,kBAAC,GAAD,EACE,SACE,EAAY,EAAU,MAAM,GACxB,mDACA,uCAAuC,EAAU,MAAM,WAE7D,CAAA;GAEH,KACC,kBAAC,GAAD;IAAc,OAAO,EAAK;IAAO,WAAW,EAAK;IAAW,QAAO;IAAqB,CAAA;GAEzF,EAAA,CAAA,CAED"}

package/dist/planmagnet/hooks/usePresence.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Live presence + typing on one target (CWF-24): who else is here, and who of them is typing right now.
+ *
+ * Heartbeat every 15 s while the tab is visible (paused while hidden — no point telling the server "still here"
+ * from a backgrounded tab, and it would only cost quota for nothing anyone can see), an explicit
+ * `planmagnetPresenceLeave` on unmount or when the target itself changes (closing this view, not merely going
+ * idle — same distinction the mutation's own doc comment draws), and a typing heartbeat `notifyTyping()` callers
+ * fire on every keystroke, throttled here to at most one per 5 s so a whole paragraph does not turn into a burst
+ * of writes (the server also rate-limits to one heartbeat per 5s per actor+target, so this throttle is a client-
+ * side courtesy, not the actual gate). There is no explicit "stopped typing" call — `PlanmagnetPresenceEntry.typing`
+ * already goes stale 8 s after the last `typing: true` heartbeat (see that field's own schema doc comment), so a
+ * caller that stops typing simply stops calling `notifyTyping()` and the flag lapses on its own.
+ *
+ * The live list comes from `planmagnetPresence`, kept fresh by `planmagnetOnPresenceChanged` — a THIN event (kind
+ * + actorId only, CWF-24's own house rule against ever trusting a real-time payload as data) that triggers a
+ * re-read under the caller's own permissions, same discipline `useLiveRefresh` uses elsewhere in this MFE. If the
+ * subscription errors (including the expected "no SSE transport" case in a standalone/Storybook build — see
+ * `useLiveRefresh`'s note on `PlanMagnetProvider`), this degrades to a 30 s poll rather than going silent.
+ *
+ * Heartbeat/leave/typing calls are fire-and-forget: presence is a nice-to-have, never something a refusal here
+ * should surface as a page error, so failures are swallowed rather than thrown (mirroring how `useLiveRefresh`
+ * treats a degraded subscription as expected, not exceptional).
+ */
+export type PlanmagnetPresenceTargetType = 'WORK_ITEM' | 'DOC' | 'ROADMAP' | 'PROJECT';
+export interface PresenceOther {
+    actorId: string;
+    lastSeenAt: string;
+    typing: boolean;
+}
+export interface UsePresenceResult {
+    /** Other actors present on this target within the last 30 s — the caller (self) is already excluded. */
+    others: PresenceOther[];
+    /** Ids of OTHER actors currently typing (fresh within the last 8 s, per the server) — self excluded. */
+    typingActorIds: string[];
+    /** Call on every keystroke in a composer for this target; throttled internally to one heartbeat per 5 s. */
+    notifyTyping: () => void;
+}
+export declare function usePresence(targetType: PlanmagnetPresenceTargetType, targetId: string | null | undefined): UsePresenceResult;
+//# sourceMappingURL=usePresence.d.ts.map

package/dist/planmagnet/hooks/usePresence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePresence.d.ts","sourceRoot":"","sources":["../../../src/planmagnet/hooks/usePresence.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,MAAM,MAAM,4BAA4B,GAAG,WAAW,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,wGAAwG;IACxG,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,wGAAwG;IACxG,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,4GAA4G;IAC5G,YAAY,EAAE,MAAM,IAAI,CAAC;CAC1B;AA2DD,wBAAgB,WAAW,CACzB,UAAU,EAAE,4BAA4B,EACxC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAClC,iBAAiB,CAwGnB"}