@burdenoff/planmagnet-fe-sdk 2026.704.2 → 2026.704.4

package/dist/index.d.ts

@@ -271,8 +271,9 @@ interface BoardColumn {
 }
 /**
  * The default, ordered board columns. Product-agnostic — no farm semantics.
- * TESTING/CANCELLED are omitted from the default board but are valid statuses;
- * callers can override via TaskBoardCoreProps.columns.
+ * Covers every TaskStatus so a task can never be "orphaned" off the board
+ * (a CANCELLED item has a home). Callers can trim/reorder via
+ * TaskBoardCoreProps.columns.
  */
 declare const DEFAULT_BOARD_COLUMNS: BoardColumn[];
 /** Priority filter options (UI order). */
@@ -432,6 +433,12 @@ interface TaskBoardCoreProps {
     columns?: BoardColumn[];
     /** Read-only mode — disables drag-to-move. */
     readonly?: boolean;
+    /**
+     * Ask for confirmation before a drag-drop moves a task to another column.
+     * Defaults to `true` — an accidental drag shouldn't silently change a task's
+     * status. Set `false` for instant, Linear-style moves.
+     */
+    confirmMove?: boolean;
     /** Hide the board's own header (title + count). */
     hideHeader?: boolean;
     /**
@@ -483,7 +490,7 @@ interface TaskBoardCoreProps {
  *   (optimistic cache update + `UPDATE_WORK_ITEM`; reverts on error). Filtering
  *   is controlled by the parent toolbar. Farm-free, semantic-token only.
  */
-declare function TaskBoardCore({ projectId, columns, readonly, hideHeader, priority, type, search, assigneeId, hiddenFields, resolveAssignee, linkSourceProduct, renderLinkIcon, onTaskClick, className, workspaceId: workspaceIdProp, }: TaskBoardCoreProps): react.JSX.Element;
+declare function TaskBoardCore({ projectId, columns, readonly, confirmMove, hideHeader, priority, type, search, assigneeId, hiddenFields, resolveAssignee, linkSourceProduct, renderLinkIcon, onTaskClick, className, workspaceId: workspaceIdProp, }: TaskBoardCoreProps): react.JSX.Element;
 
 interface TaskBoardProps extends TaskBoardCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -795,6 +802,14 @@ interface TaskDetailCoreProps {
     resolveAssignee?: ResolveAssignee;
     /** Optional host-provided member directory → renders a picker instead of a raw id field. */
     assigneeOptions?: AssigneeOption[];
+    /**
+     * Product key for cross-product entity links (e.g. "healthybowl"). When set,
+     * the read view shows this task's linked records (fields/crops/animals). Opt-in
+     * so the SDK stays farm-free.
+     */
+    linkSourceProduct?: string;
+    /** Optional host hook to render an icon per linked-entity type. */
+    renderLinkIcon?: RenderLinkIcon;
     /** Extra classes on the root container. */
     className?: string;
 }
@@ -803,7 +818,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, className, }: TaskDetailCoreProps): react.JSX.Element;
+declare function TaskDetailCore({ id, readonly, hiddenFields, hideHeader, onUpdated, onDeleted, onError, resolveAssignee, assigneeOptions, linkSourceProduct, renderLinkIcon, className, }: TaskDetailCoreProps): react.JSX.Element;
 
 interface TaskDetailProps extends TaskDetailCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -862,6 +877,9 @@ interface TaskLabels {
     noTasks: string;
     noTasksFound: string;
     dropHere: string;
+    moveConfirmTitle: string;
+    moveConfirmPrompt: string;
+    moveConfirm: string;
     unassigned: string;
     assigned: string;
     overdue: string;
@@ -897,6 +915,9 @@ interface TaskLabels {
     storyPointsLabel: string;
     labelsLabel: string;
     labelsPlaceholder: string;
+    linkedRecordsLabel: string;
+    createdLabel: string;
+    updatedLabel: string;
     create: string;
     creating: string;
     cancel: string;
@@ -973,6 +994,11 @@ interface TasksPageCoreProps {
     views?: TaskView[];
     /** Initial view. Defaults to "board". */
     defaultView?: TaskView;
+    /**
+     * Ask for confirmation before a board drag-drop moves a task. Defaults to
+     * `true`; set `false` for instant, Linear-style moves.
+     */
+    confirmMove?: boolean;
     /** Optional host hook to resolve an assignee id → display name. */
     resolveAssignee?: ResolveAssignee;
     /**
@@ -1022,7 +1048,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, resolveAssignee, linkSourceProduct, renderLinkIcon, assigneeOptions, currentActorId, 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, 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

@@ -521,6 +521,12 @@ function parseDate(iso) {
   const d = parseISO(iso);
   return isValid(d) ? d : null;
 }
+function toIsoDate(value) {
+  if (!value) return void 0;
+  const iso = /^\d{4}-\d{2}-\d{2}$/.test(value) ? `${value}T00:00:00.000Z` : value;
+  const d = new Date(iso);
+  return Number.isNaN(d.getTime()) ? void 0 : d.toISOString();
+}
 function formatDueDate(iso) {
   const d = parseDate(iso);
   if (!d) return null;
@@ -530,6 +536,10 @@ function formatDueDate(iso) {
     d.getFullYear() === now.getFullYear() ? "MMM d" : "MMM d yyyy"
   );
 }
+function formatDateFull(iso) {
+  const d = parseDate(iso);
+  return d ? format(d, "MMM d, yyyy") : null;
+}
 function isOverdue(iso, status) {
   const d = parseDate(iso);
   if (!d) return false;
@@ -626,7 +636,8 @@ var DEFAULT_BOARD_COLUMNS = [
   { status: "IN_PROGRESS", label: "In Progress" },
   { status: "IN_REVIEW", label: "In Review" },
   { status: "TESTING", label: "Testing" },
-  { status: "DONE", label: "Done" }
+  { status: "DONE", label: "Done" },
+  { status: "CANCELLED", label: "Cancelled" }
 ];
 var TASK_PRIORITIES = [
   "NONE",
@@ -696,6 +707,9 @@ var DEFAULT_TASK_LABELS = {
   noTasks: "No tasks",
   noTasksFound: "No tasks found.",
   dropHere: "Drop here",
+  moveConfirmTitle: "Move task?",
+  moveConfirmPrompt: 'Move "{task}" to {status}?',
+  moveConfirm: "Move",
   unassigned: "Unassigned",
   assigned: "Assigned",
   overdue: "{n} overdue",
@@ -731,6 +745,9 @@ var DEFAULT_TASK_LABELS = {
   storyPointsLabel: "Story points",
   labelsLabel: "Labels",
   labelsPlaceholder: "comma, separated, labels",
+  linkedRecordsLabel: "Linked records",
+  createdLabel: "Created",
+  updatedLabel: "Updated",
   create: "Create task",
   creating: "Creating\u2026",
   cancel: "Cancel",
@@ -1076,6 +1093,7 @@ function TaskBoardCore({
   projectId,
   columns = DEFAULT_BOARD_COLUMNS,
   readonly,
+  confirmMove = true,
   hideHeader,
   priority = "ALL",
   type = "ALL",
@@ -1098,6 +1116,7 @@ function TaskBoardCore({
   const [draggingId, setDraggingId] = useState(null);
   const [dragOver, setDragOver] = useState(null);
   const [moveError, setMoveError] = useState(null);
+  const [pendingMove, setPendingMove] = useState(null);
   const [updateItem] = useMutation(UPDATE_WORK_ITEM);
   const { data, loading, error } = useQuery(
     LIST_WORK_ITEMS,
@@ -1164,7 +1183,9 @@ function TaskBoardCore({
     const task = tasks.find((t) => t.id === draggingId);
     setDragOver(null);
     setDraggingId(null);
-    if (task) moveTask(task, status);
+    if (!task || task.status === status) return;
+    if (confirmMove) setPendingMove({ task, toStatus: status });
+    else moveTask(task, status);
   };
   return /* @__PURE__ */ jsxs("div", { className: cn("space-y-3", className), children: [
     !hideHeader && /* @__PURE__ */ jsxs("div", { className: "flex items-baseline justify-between", children: [
@@ -1224,7 +1245,43 @@ function TaskBoardCore({
         },
         col.status
       );
-    }) })
+    }) }),
+    /* @__PURE__ */ jsx(
+      Modal,
+      {
+        open: pendingMove != null,
+        onClose: () => setPendingMove(null),
+        ariaLabel: L.moveConfirmTitle,
+        className: "max-w-sm",
+        children: pendingMove && /* @__PURE__ */ jsxs("div", { className: "space-y-4 p-6", children: [
+          /* @__PURE__ */ jsx("h3", { className: "text-base font-semibold text-foreground", children: L.moveConfirmTitle }),
+          /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: L.moveConfirmPrompt.replace("{task}", pendingMove.task.title).replace("{status}", L.status[pendingMove.toStatus]) }),
+          /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-end gap-2", children: [
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: () => setPendingMove(null),
+                className: "rounded-md bg-muted px-4 py-2 text-sm font-medium text-muted-foreground hover:bg-muted/70",
+                children: L.cancel
+              }
+            ),
+            /* @__PURE__ */ jsx(
+              "button",
+              {
+                type: "button",
+                onClick: () => {
+                  moveTask(pendingMove.task, pendingMove.toStatus);
+                  setPendingMove(null);
+                },
+                className: "rounded-md bg-primary px-4 py-2 text-sm font-medium text-primary-foreground hover:brightness-110",
+                children: L.moveConfirm
+              }
+            )
+          ] })
+        ] })
+      }
+    )
   ] });
 }
 function TaskBoard({
@@ -1317,7 +1374,7 @@ function CreateTaskCore({
       ...hidden.has("priority") ? {} : { priority },
       ...hidden.has("description") || !description.trim() ? {} : { description: description.trim() },
       ...hidden.has("assignee") || !assigneeId.trim() ? {} : { assigneeId: assigneeId.trim() },
-      ...hidden.has("dueDate") || !dueDate.trim() ? {} : { dueDate },
+      ...hidden.has("dueDate") || !dueDate.trim() ? {} : { dueDate: toIsoDate(dueDate) },
       ...hidden.has("labels") || parsedLabels.length === 0 ? {} : { labels: parsedLabels },
       ...hidden.has("storyPoints") || parsedPoints == null || Number.isNaN(parsedPoints) ? {} : { storyPoints: parsedPoints }
     };
@@ -2409,6 +2466,8 @@ function TaskDetailCore({
   onError: onError2,
   resolveAssignee,
   assigneeOptions,
+  linkSourceProduct,
+  renderLinkIcon,
   className
 }) {
   const client = useApolloClient();
@@ -2422,6 +2481,11 @@ function TaskDetailCore({
     skip: !id
   });
   const item = data?.planmagnetWorkItem ?? null;
+  const { linksByItem } = useWorkItemLinks(
+    item?.workspaceId,
+    linkSourceProduct
+  );
+  const links = item ? linksByItem.get(item.id) ?? [] : [];
   const [editing, setEditing] = useState(false);
   const [confirmingDelete, setConfirmingDelete] = useState(false);
   const [title, setTitle] = useState("");
@@ -2474,7 +2538,7 @@ function TaskDetailCore({
       ...hidden.has("status") ? {} : { status },
       ...hidden.has("priority") ? {} : { priority },
       ...hidden.has("assignee") ? {} : { assigneeId: assigneeId.trim() },
-      ...hidden.has("dueDate") ? {} : { dueDate: dueDate || void 0 },
+      ...hidden.has("dueDate") ? {} : { dueDate: toIsoDate(dueDate) },
       ...hidden.has("labels") ? {} : { labels: parsedLabels },
       ...hidden.has("storyPoints") || parsedPoints == null || Number.isNaN(parsedPoints) ? {} : { storyPoints: parsedPoints }
     };
@@ -2589,7 +2653,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: item.dueDate ?? "\u2014" }) }),
+      !hidden.has("dueDate") && /* @__PURE__ */ jsx(Field, { label: L.dueDateLabel, children: /* @__PURE__ */ jsx("span", { className: "text-foreground", children: formatDateFull(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: labelClass2, children: L.description }),
@@ -2605,6 +2669,29 @@ function TaskDetailCore({
           },
           l
         )) })
+      ] }),
+      links.length > 0 && /* @__PURE__ */ jsxs("div", { className: "sm:col-span-2", children: [
+        /* @__PURE__ */ jsx("dt", { className: labelClass2, children: L.linkedRecordsLabel }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-1 flex flex-wrap gap-1.5", children: links.map((link) => /* @__PURE__ */ jsx(
+          LinkChip,
+          {
+            link,
+            renderIcon: renderLinkIcon
+          },
+          link.id
+        )) })
+      ] }),
+      (item.createdAt || item.updatedAt) && /* @__PURE__ */ jsxs("div", { className: "flex flex-wrap gap-x-6 gap-y-1 border-t border-border pt-3 text-xs text-muted-foreground sm:col-span-2", children: [
+        item.createdAt && /* @__PURE__ */ jsxs("span", { children: [
+          L.createdLabel,
+          " ",
+          formatDateFull(item.createdAt)
+        ] }),
+        item.updatedAt && /* @__PURE__ */ jsxs("span", { children: [
+          L.updatedLabel,
+          " ",
+          formatDateFull(item.updatedAt)
+        ] })
       ] })
     ] }) : /* @__PURE__ */ jsxs("form", { onSubmit: handleSave, className: "space-y-4", children: [
       /* @__PURE__ */ jsxs("div", { className: "space-y-1", children: [
@@ -2812,6 +2899,7 @@ function TasksPageCore({
   hiddenFields,
   views,
   defaultView = "board",
+  confirmMove,
   resolveAssignee,
   linkSourceProduct,
   renderLinkIcon,
@@ -2890,6 +2978,8 @@ function TasksPageCore({
       hiddenFields,
       resolveAssignee,
       assigneeOptions,
+      linkSourceProduct,
+      renderLinkIcon,
       onUpdated: handleUpdated,
       onDeleted: handleDeleted
     }
@@ -2933,6 +3023,7 @@ function TasksPageCore({
         projectId: boardProjectId,
         columns,
         readonly,
+        confirmMove,
         hideHeader: true,
         priority,
         type,