@burdenoff/planmagnet-fe-sdk 2026.706.4 → 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
 }) {
@@ -2671,10 +2685,10 @@ function TaskCommentsCore({
     DELETE_ENTITY_COMMENT
   );
   const authorName = (id) => id === currentActorId ? L.you : resolveAssignee?.(id)?.name ?? void 0;
-  const post = async ({ text }, parentCommentId) => {
+  const post = async ({ text, mentionUserIds }, parentCommentId) => {
     setError(null);
     try {
-      await createComment({
+      const res = await createComment({
         variables: {
           input: {
             entityType,
@@ -2687,6 +2701,15 @@ function TaskCommentsCore({
       });
       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;
@@ -2810,6 +2833,7 @@ function TaskDetailCore({
   onAddSubtask,
   commentsEntityType,
   currentActorId,
+  onMention,
   className
 }) {
   const client = useApolloClient();
@@ -3010,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 }),
@@ -3111,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: [
@@ -3327,6 +3352,7 @@ function TasksPageCore({
   assigneeOptions,
   currentActorId,
   commentsEntityType,
+  onMention,
   labels,
   openItemId,
   header,
@@ -3430,7 +3456,8 @@ function TasksPageCore({
       onOpenItem: handleSelect,
       onAddSubtask: handleAddSubtask,
       commentsEntityType,
-      currentActorId
+      currentActorId,
+      onMention
     }
   ) : null;
   const listPriority = priority === "ALL" ? void 0 : priority;