@burdenoff/planmagnet-fe-sdk 2026.704.3 → 2026.705.1

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,21 @@ 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;
+    /** Open another work item's detail (parent link / sub-task row click). */
+    onOpenItem?: (id: string) => void;
+    /** Start creating a sub-task under this item (the "Add sub-task" affordance). */
+    onAddSubtask?: (parent: {
+        id: string;
+        projectId: string;
+    }) => void;
     /** Extra classes on the root container. */
     className?: string;
 }
@@ -803,7 +825,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, onOpenItem, onAddSubtask, className, }: TaskDetailCoreProps): react.JSX.Element;
 
 interface TaskDetailProps extends TaskDetailCoreProps {
     /** Workspace API gateway URL (URL mode). */
@@ -862,6 +884,9 @@ interface TaskLabels {
     noTasks: string;
     noTasksFound: string;
     dropHere: string;
+    moveConfirmTitle: string;
+    moveConfirmPrompt: string;
+    moveConfirm: string;
     unassigned: string;
     assigned: string;
     overdue: string;
@@ -897,6 +922,12 @@ interface TaskLabels {
     storyPointsLabel: string;
     labelsLabel: string;
     labelsPlaceholder: string;
+    linkedRecordsLabel: string;
+    createdLabel: string;
+    updatedLabel: string;
+    parentLabel: string;
+    subtasksLabel: string;
+    addSubtask: string;
     create: string;
     creating: string;
     cancel: string;
@@ -973,6 +1004,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 +1058,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

@@ -536,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;
@@ -632,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",
@@ -702,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",
@@ -737,6 +745,12 @@ var DEFAULT_TASK_LABELS = {
   storyPointsLabel: "Story points",
   labelsLabel: "Labels",
   labelsPlaceholder: "comma, separated, labels",
+  linkedRecordsLabel: "Linked records",
+  createdLabel: "Created",
+  updatedLabel: "Updated",
+  parentLabel: "Parent",
+  subtasksLabel: "Sub-tasks",
+  addSubtask: "Add sub-task",
   create: "Create task",
   creating: "Creating\u2026",
   cancel: "Cancel",
@@ -1082,6 +1096,7 @@ function TaskBoardCore({
   projectId,
   columns = DEFAULT_BOARD_COLUMNS,
   readonly,
+  confirmMove = true,
   hideHeader,
   priority = "ALL",
   type = "ALL",
@@ -1104,6 +1119,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,
@@ -1170,7 +1186,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: [
@@ -1230,7 +1248,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({
@@ -1319,6 +1373,10 @@ function CreateTaskCore({
       projectId,
       title: title.trim(),
       type,
+      // Sub-task linkage: parentId is not an editable form field — it rides
+      // through from defaultValues (the "Add sub-task" flow) so a created work
+      // item nests under its parent.
+      ...defaultValues?.parentId ? { parentId: defaultValues.parentId } : {},
       ...hidden.has("status") ? {} : { status },
       ...hidden.has("priority") ? {} : { priority },
       ...hidden.has("description") || !description.trim() ? {} : { description: description.trim() },
@@ -2415,6 +2473,10 @@ function TaskDetailCore({
   onError: onError2,
   resolveAssignee,
   assigneeOptions,
+  linkSourceProduct,
+  renderLinkIcon,
+  onOpenItem,
+  onAddSubtask,
   className
 }) {
   const client = useApolloClient();
@@ -2428,6 +2490,25 @@ function TaskDetailCore({
     skip: !id
   });
   const item = data?.planmagnetWorkItem ?? null;
+  const { linksByItem } = useWorkItemLinks(
+    item?.workspaceId,
+    linkSourceProduct
+  );
+  const links = item ? linksByItem.get(item.id) ?? [] : [];
+  const { data: parentData } = useQuery(GET_WORK_ITEM, {
+    variables: { id: item?.parentId },
+    skip: !item?.parentId
+  });
+  const parent = parentData?.planmagnetWorkItem ?? null;
+  const { data: childData } = useQuery(LIST_WORK_ITEMS, {
+    variables: {
+      workspaceId: item?.workspaceId,
+      filter: { parentId: item?.id },
+      pagination: { first: 100 }
+    },
+    skip: !item?.id || !item?.workspaceId
+  });
+  const children = childData?.planmagnetWorkItems?.items ?? [];
   const [editing, setEditing] = useState(false);
   const [confirmingDelete, setConfirmingDelete] = useState(false);
   const [title, setTitle] = useState("");
@@ -2595,7 +2676,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 }),
@@ -2611,6 +2692,79 @@ 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
+        )) })
+      ] }),
+      parent && /* @__PURE__ */ jsxs("div", { className: "sm:col-span-2", children: [
+        /* @__PURE__ */ jsx("dt", { className: labelClass2, children: L.parentLabel }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-1", children: /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => onOpenItem?.(parent.id),
+            className: "inline-flex max-w-full items-center gap-1.5 rounded-md border border-border bg-muted/40 px-2 py-1 text-sm text-foreground hover:bg-muted",
+            children: [
+              /* @__PURE__ */ jsx(StatusIcon, { status: parent.status }),
+              /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: parent.key }),
+              /* @__PURE__ */ jsx("span", { className: "truncate", children: parent.title })
+            ]
+          }
+        ) })
+      ] }),
+      (children.length > 0 || onAddSubtask && canEdit) && /* @__PURE__ */ jsxs("div", { className: "sm:col-span-2", children: [
+        /* @__PURE__ */ jsxs("div", { className: "flex items-center justify-between", children: [
+          /* @__PURE__ */ jsxs("dt", { className: labelClass2, children: [
+            L.subtasksLabel,
+            children.length > 0 ? ` (${children.length})` : ""
+          ] }),
+          onAddSubtask && canEdit && /* @__PURE__ */ jsxs(
+            "button",
+            {
+              type: "button",
+              onClick: () => onAddSubtask({ id: item.id, projectId: item.projectId }),
+              className: "text-xs font-medium text-primary hover:underline",
+              children: [
+                "+ ",
+                L.addSubtask
+              ]
+            }
+          )
+        ] }),
+        /* @__PURE__ */ jsx("dd", { className: "mt-1 space-y-1", children: children.length === 0 ? /* @__PURE__ */ jsx("span", { className: "text-sm text-muted-foreground", children: "\u2014" }) : children.map((c) => /* @__PURE__ */ jsxs(
+          "button",
+          {
+            type: "button",
+            onClick: () => onOpenItem?.(c.id),
+            className: "flex w-full items-center gap-2 rounded-md px-2 py-1 text-left text-sm hover:bg-muted",
+            children: [
+              /* @__PURE__ */ jsx(StatusIcon, { status: c.status }),
+              /* @__PURE__ */ jsx("span", { className: "text-xs text-muted-foreground", children: c.key }),
+              /* @__PURE__ */ jsx("span", { className: "flex-1 truncate text-foreground", children: c.title })
+            ]
+          },
+          c.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: [
@@ -2818,6 +2972,7 @@ function TasksPageCore({
   hiddenFields,
   views,
   defaultView = "board",
+  confirmMove,
   resolveAssignee,
   linkSourceProduct,
   renderLinkIcon,
@@ -2842,6 +2997,7 @@ function TasksPageCore({
   const [mine, setMine] = useState(false);
   const [creating, setCreating] = useState(false);
   const [selectedId, setSelectedId] = useState(null);
+  const [createDefaults, setCreateDefaults] = useState(null);
   useEffect(() => {
     if (openItemId) setSelectedId(openItemId);
   }, [openItemId]);
@@ -2853,10 +3009,31 @@ function TasksPageCore({
     (workItem) => {
       refetchBoard();
       setCreating(false);
+      setCreateDefaults(null);
       onTaskSaved?.({ workItem, operation: "created" });
     },
     [refetchBoard, onTaskSaved]
   );
+  const handleAddSubtask = useCallback(
+    (parent) => {
+      setSelectedId(null);
+      setCreateDefaults({
+        parentId: parent.id,
+        projectId: parent.projectId,
+        type: "SUB_TASK"
+      });
+      setCreating(true);
+    },
+    []
+  );
+  const startCreate = useCallback(() => {
+    setCreateDefaults(null);
+    setCreating(true);
+  }, []);
+  const cancelCreate = useCallback(() => {
+    setCreating(false);
+    setCreateDefaults(null);
+  }, []);
   const handleUpdated = useCallback(
     (workItem) => {
       refetchBoard();
@@ -2884,8 +3061,9 @@ function TasksPageCore({
       projectId,
       assigneeOptions,
       hiddenFields,
+      defaultValues: createDefaults ?? void 0,
       onCreated: handleCreated,
-      onCancel: () => setCreating(false)
+      onCancel: cancelCreate
     }
   );
   const detailView = selectedId != null ? /* @__PURE__ */ jsx(
@@ -2896,8 +3074,12 @@ function TasksPageCore({
       hiddenFields,
       resolveAssignee,
       assigneeOptions,
+      linkSourceProduct,
+      renderLinkIcon,
       onUpdated: handleUpdated,
-      onDeleted: handleDeleted
+      onDeleted: handleDeleted,
+      onOpenItem: handleSelect,
+      onAddSubtask: handleAddSubtask
     }
   ) : null;
   const listPriority = priority === "ALL" ? void 0 : priority;
@@ -2925,7 +3107,7 @@ function TasksPageCore({
         onPriorityChange: setPriority,
         type,
         onTypeChange: setType,
-        onNewTask: () => setCreating(true),
+        onNewTask: startCreate,
         canCreate,
         mine,
         onMineChange: currentActorId ? setMine : void 0
@@ -2939,6 +3121,7 @@ function TasksPageCore({
         projectId: boardProjectId,
         columns,
         readonly,
+        confirmMove,
         hideHeader: true,
         priority,
         type,
@@ -2986,7 +3169,7 @@ function TasksPageCore({
       Modal,
       {
         open: creating,
-        onClose: () => setCreating(false),
+        onClose: cancelCreate,
         ariaLabel: "Create task",
         className: "max-w-xl",
         children: /* @__PURE__ */ jsx("div", { className: "p-2 pt-8", children: createForm })