@burdenoff/planmagnet-fe-sdk 2026.704.4 → 2026.705.1

package/dist/index.d.ts

@@ -810,6 +810,13 @@ interface TaskDetailCoreProps {
     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;
 }
@@ -818,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, linkSourceProduct, renderLinkIcon, 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). */
@@ -918,6 +925,9 @@ interface TaskLabels {
     linkedRecordsLabel: string;
     createdLabel: string;
     updatedLabel: string;
+    parentLabel: string;
+    subtasksLabel: string;
+    addSubtask: string;
     create: string;
     creating: string;
     cancel: string;

package/dist/index.js

@@ -748,6 +748,9 @@ var DEFAULT_TASK_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",
@@ -1370,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() },
@@ -2468,6 +2475,8 @@ function TaskDetailCore({
   assigneeOptions,
   linkSourceProduct,
   renderLinkIcon,
+  onOpenItem,
+  onAddSubtask,
   className
 }) {
   const client = useApolloClient();
@@ -2486,6 +2495,20 @@ function TaskDetailCore({
     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("");
@@ -2681,6 +2704,56 @@ function TaskDetailCore({
           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,
@@ -2924,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]);
@@ -2935,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();
@@ -2966,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(
@@ -2981,7 +3077,9 @@ function TasksPageCore({
       linkSourceProduct,
       renderLinkIcon,
       onUpdated: handleUpdated,
-      onDeleted: handleDeleted
+      onDeleted: handleDeleted,
+      onOpenItem: handleSelect,
+      onAddSubtask: handleAddSubtask
     }
   ) : null;
   const listPriority = priority === "ALL" ? void 0 : priority;
@@ -3009,7 +3107,7 @@ function TasksPageCore({
         onPriorityChange: setPriority,
         type,
         onTypeChange: setType,
-        onNewTask: () => setCreating(true),
+        onNewTask: startCreate,
         canCreate,
         mine,
         onMineChange: currentActorId ? setMine : void 0
@@ -3071,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 })