@burdenoff/planmagnet-fe-sdk 2026.706.3 → 2026.706.5

package/dist/index.d.ts

@@ -825,6 +825,13 @@ interface TaskDetailCoreProps {
     commentsEntityType?: string;
     /** The current actor — enables "My tasks", comment authorship + own-comment delete. */
     currentActorId?: string;
+    /** Fired when a posted comment @-mentions members (host notifies them). */
+    onMention?: (payload: {
+        mentionedIds: string[];
+        text: string;
+        entityId: string;
+        commentId: string;
+    }) => void;
     /** Extra classes on the root container. */
     className?: string;
 }
@@ -833,7 +840,7 @@ interface TaskDetailCoreProps {
  * edit. Fetches via `planmagnetWorkItem(id)`, saves via
  * `planmagnetUpdateWorkItem`. BYO-Apollo, semantic-token only, farm-free.
  */
-declare function TaskDetailCore({ id, readonly, hiddenFields, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, linkSourceProduct, renderLinkIcon, onOpenItem, onAddSubtask, commentsEntityType, currentActorId, className, }: TaskDetailCoreProps): react.JSX.Element;
+declare function TaskDetailCore({ id, readonly, hiddenFields, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, linkSourceProduct, renderLinkIcon, onOpenItem, onAddSubtask, commentsEntityType, currentActorId, onMention, className, }: TaskDetailCoreProps): react.JSX.Element;
 
 interface TaskDetailProps extends TaskDetailCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -885,6 +892,18 @@ interface TaskCommentsCoreProps {
     resolveAssignee?: ResolveAssignee;
     /** Member directory for @-mention autocomplete. Omit to disable mentions. */
     members?: AssigneeOption[];
+    /**
+     * Fired after a comment posts that @-mentions members — the host can notify
+     * them (e.g. via global-notification-svc). `mentionedIds` are workspace member
+     * ids (the SDK does not send them to the comment service; see the note in
+     * `post`). Kept generic so the SDK stays farm-free.
+     */
+    onMention?: (payload: {
+        mentionedIds: string[];
+        text: string;
+        entityId: string;
+        commentId: string;
+    }) => void;
     /** Hide the composer + delete affordances (pure read-only). */
     readonly?: boolean;
     /** Extra classes on the root container. */
@@ -899,7 +918,7 @@ interface TaskCommentsCoreProps {
  * a workspace Member gets editor on `entity-comment`); the composer fails open
  * and surfaces a graceful error if the server denies it.
  */
-declare function TaskCommentsCore({ entityType, entityId, currentActorId, resolveAssignee, members, readonly, className, }: TaskCommentsCoreProps): react.JSX.Element;
+declare function TaskCommentsCore({ entityType, entityId, currentActorId, resolveAssignee, members, onMention, readonly, className, }: TaskCommentsCoreProps): react.JSX.Element;
 
 /**
  * TaskLabels — every user-facing string the SDK renders, so a host (e.g.
@@ -1079,6 +1098,13 @@ interface TasksPageCoreProps {
      * (e.g. "planmagnet_workitem"). Omit to hide comments.
      */
     commentsEntityType?: string;
+    /** Fired when a posted comment @-mentions members (host notifies them). */
+    onMention?: (payload: {
+        mentionedIds: string[];
+        text: string;
+        entityId: string;
+        commentId: string;
+    }) => void;
     /** Host-provided translations for every UI string (English defaults otherwise). */
     labels?: PartialTaskLabels;
     /**
@@ -1111,7 +1137,7 @@ interface TasksPageCoreProps {
  * BYO-Apollo: reads the ambient `<ApolloProvider>` and takes `workspaceId` from
  * a prop or the PlanMagnetProvider context. Semantic tokens only, farm-free.
  */
-declare function TasksPageCore({ workspaceId: workspaceIdProp, projectId, boardProjectId, columns, readonly, hiddenFields, views, defaultView, confirmMove, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, commentsEntityType, labels, openItemId, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
+declare function TasksPageCore({ workspaceId: workspaceIdProp, projectId, boardProjectId, columns, readonly, hiddenFields, views, defaultView, confirmMove, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, commentsEntityType, onMention, labels, openItemId, header, onTaskSaved, createSurface, detailSurface, className, }: TasksPageCoreProps): react.JSX.Element;
 
 interface TasksPageProps extends TasksPageCoreProps {
     /** Workspace API gateway URL (URL mode). */

package/dist/index.js

@@ -565,6 +565,15 @@ function parseDate(iso) {
   const d = parseISO(iso);
   return isValid(d) ? d : null;
 }
+function parseDueDate(iso) {
+  if (!iso) return null;
+  const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(iso);
+  if (m) {
+    const d = new Date(Number(m[1]), Number(m[2]) - 1, Number(m[3]));
+    return isValid(d) ? d : null;
+  }
+  return parseDate(iso);
+}
 function toIsoDate(value) {
   if (!value) return void 0;
   const iso = /^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00.000Z` : value;
@@ -572,7 +581,7 @@ function toIsoDate(value) {
   return Number.isNaN(d.getTime()) ? void 0 : d.toISOString();
 }
 function formatDueDate(iso) {
-  const d = parseDate(iso);
+  const d = parseDueDate(iso);
   if (!d) return null;
   const now = /* @__PURE__ */ new Date();
   return format(
@@ -580,12 +589,16 @@ function formatDueDate(iso) {
     d.getFullYear() === now.getFullYear() ? "MMM d" : "MMM d yyyy"
   );
 }
+function formatDueDateFull(iso) {
+  const d = parseDueDate(iso);
+  return d ? format(d, "MMM d, yyyy") : null;
+}
 function formatDateFull(iso) {
   const d = parseDate(iso);
   return d ? format(d, "MMM d, yyyy") : null;
 }
 function isOverdue(iso, status) {
-  const d = parseDate(iso);
+  const d = parseDueDate(iso);
   if (!d) return false;
   if (status && CLOSED_STATUSES.has(status)) return false;
   return startOfDay(d).getTime() < startOfDay(/* @__PURE__ */ new Date()).getTime();
@@ -2091,7 +2104,7 @@ function TaskTimelineCore({
     const od = [];
     const ud = [];
     for (const t of tasks) {
-      const d = parseDate(t.dueDate);
+      const d = parseDueDate(t.dueDate);
       if (!d) {
         ud.push(t);
         continue;
@@ -2622,6 +2635,7 @@ function TaskCommentsCore({
   currentActorId,
   resolveAssignee,
   members,
+  onMention,
   readonly,
   className
 }) {
@@ -2673,35 +2687,33 @@ function TaskCommentsCore({
   const authorName = (id) => id === currentActorId ? L.you : resolveAssignee?.(id)?.name ?? void 0;
   const post = async ({ text, mentionUserIds }, parentCommentId) => {
     setError(null);
-    const base = {
-      entityType,
-      entityId,
-      content: { text },
-      contentType: "TEXT",
-      ...parentCommentId ? { parentCommentId } : {}
-    };
-    const create = (withMentions) => createComment({
-      variables: {
-        input: withMentions && mentionUserIds.length ? { ...base, mentionUserIds } : base
-      }
-    });
     try {
-      await create(true);
-    } catch (err) {
-      if (mentionUserIds.length) {
-        try {
-          await create(false);
-        } catch (err2) {
-          setError(L.failedToComment);
-          throw err2;
+      const res = await createComment({
+        variables: {
+          input: {
+            entityType,
+            entityId,
+            content: { text },
+            contentType: "TEXT",
+            ...parentCommentId ? { parentCommentId } : {}
+          }
         }
-      } else {
-        setError(L.failedToComment);
-        throw err;
+      });
+      await refetch();
+      setReplyingTo(null);
+      const toNotify = mentionUserIds.filter((id) => id !== currentActorId);
+      if (toNotify.length && onMention) {
+        onMention({
+          mentionedIds: toNotify,
+          text,
+          entityId,
+          commentId: res.data?.createEntityComment?.id ?? ""
+        });
       }
+    } catch (err) {
+      setError(L.failedToComment);
+      throw err;
     }
-    await refetch();
-    setReplyingTo(null);
   };
   const handleDelete = async (id) => {
     setError(null);
@@ -2821,6 +2833,7 @@ function TaskDetailCore({
   onAddSubtask,
   commentsEntityType,
   currentActorId,
+  onMention,
   className
 }) {
   const client = useApolloClient();
@@ -3021,7 +3034,7 @@ function TaskDetailCore({
           ),
           /* @__PURE__ */ jsx("span", { className: "text-foreground", children: resolveAssignee?.(item.assigneeId)?.name ?? L.assigned })
         ] }) : /* @__PURE__ */ jsx("span", { className: "text-muted-foreground", children: L.unassigned }) }),
-        !hidden.has("dueDate") && /* @__PURE__ */ jsx(Field, { label: L.dueDateLabel, children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: formatDateFull(item.dueDate) ?? "\u2014" }) }),
+        !hidden.has("dueDate") && /* @__PURE__ */ jsx(Field, { label: L.dueDateLabel, children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: formatDueDateFull(item.dueDate) ?? "\u2014" }) }),
         !hidden.has("storyPoints") && /* @__PURE__ */ jsx(Field, { label: L.storyPointsLabel, children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: item.storyPoints ?? 0 }) }),
         !hidden.has("description") && /* @__PURE__ */ jsxs("div", { className: "sm:col-span-2", children: [
           /* @__PURE__ */ jsx("dt", { className: labelClass3, children: L.description }),
@@ -3122,7 +3135,8 @@ function TaskDetailCore({
           entityId: item.id,
           currentActorId,
           resolveAssignee,
-          members: assigneeOptions
+          members: assigneeOptions,
+          onMention
         }
       ) })
     ] }) : /* @__PURE__ */ jsxs("form", { onSubmit: handleSave, className: "space-y-4", children: [
@@ -3338,6 +3352,7 @@ function TasksPageCore({
   assigneeOptions,
   currentActorId,
   commentsEntityType,
+  onMention,
   labels,
   openItemId,
   header,
@@ -3441,7 +3456,8 @@ function TasksPageCore({
       onOpenItem: handleSelect,
       onAddSubtask: handleAddSubtask,
       commentsEntityType,
-      currentActorId
+      currentActorId,
+      onMention
     }
   ) : null;
   const listPriority = priority === "ALL" ? void 0 : priority;